PHP析构方法__destruct()的注释必须准确反映其非即时触发、无参数、不返回值、不可靠执行等特性，并显式声明@return void及提醒调用parent::__destruct()。
PHP析构方法的注释写法要匹配实际行为
PHP 的 __destruct() 方法不是“一定会在对象销毁时立即执行”，它的触发时机依赖于引用计数归零或脚本结束，所以注释里不能写“对象销毁时自动调用”这种绝对化描述，否则会误导使用者对生命周期的理解。
@return void 注释不是可选的，而是必须显式声明
PHPStan、Psalm 和现代 IDE（如 PHPStorm）会依据 PHPDoc 推断类型。如果漏掉 @return void，工具可能误判该方法有返回值，进而报错或影响自动补全。尤其在启用了严格模式的项目中，这点很关键。
-
__destruct()永远不接受参数，也不应写@param - 不能写
@return string或省略@return行 - 推荐完整写法：
/** * 清理临时文件和数据库连接 * @return void */
别在 __destruct() 里做阻塞或不可靠操作
注释里最好提醒后续维护者：这个方法不适合发 HTTP 请求、写日志到远程服务、或依赖当前请求上下文（比如 $_SERVER 可能已失效）。因为析构时机不确定，且错误不会被抛出到常规流程中。
- 常见陷阱：在
__destruct()中调用file_put_contents()写日志，但脚本已切换工作目录或权限丢失 - 更安全的做法是把清理逻辑抽成普通方法，在明确时机手动调用
- 注释中可加一句：
// 注意：此方法可能在脚本终止前异步触发，避免依赖运行时环境
继承链中的析构调用顺序容易被忽略
子类定义了 __destruct() 但没手动调用 parent::__destruct()，父类的清理逻辑就会静默丢失——而 PHP 不像构造函数那样强制要求显式调用父级。注释里值得点明这一点。
立即学习“PHP免费学习笔记（深入）”；
- 如果父类析构函数有关键清理动作，子类注释应包含：
// 注意：需确保 parent::__destruct() 被调用 - PHP 7.4+ 支持在子类中省略显式调用（自动触发），但低版本不兼容，注释要覆盖兼容性场景
- 最稳妥写法仍是显式调用，并在注释中标注意图：
/** * 关闭 socket 连接 * @return void */ public function __destruct() { $this->socket?->close(); parent::__destruct(); // 确保父类资源释放 }
实际写注释时，最容易被跳过的其实是「析构不一定发生」和「父类调用非自动」这两点。很多人只当它是“反向构造函数”，结果在线上环境踩出资源泄漏或静默失败。
