PHP Fiber 在析构函数中切换要注意什么

如果你在 PHP Fiber 的 __destruct() 里调用 Fiber::suspend()，先看运行时版本：PHP 8.3 及更早版本会阻止析构阶段的 Fiber 切换；PHP 8.4 起允许切换，但垃圾回收触发时可能由独立的 gc_destructor_fiber 执行析构。这个变化解决了“析构里不能做可暂停清理”的限制，却也意味着析构函数不再只是一次同步收尾。

工程上最稳的做法是：资源释放优先放在显式的 close() 或任务收尾阶段，__destruct() 只做幂等兜底。若析构确实需要暂停，必须按“可中断、可恢复、可重复调用”来设计，并保留能继续执行的 Fiber 引用。

三个先记住的结论：PHP 8.4 是行为分界；循环 GC 可能把析构放入 gc_destructor_fiber；析构暂停时对象不会立刻完成回收。

先分清 PHP 8.3 与 8.4 的分界

Fiber 本身从 PHP 8.1 提供，但析构函数是特殊执行上下文。旧版本为了避免垃圾回收重入，析构期间禁止切换 Fiber，常见表现是 Cannot switch fibers in current execution context。PHP 8.4 放开了这个限制，因此升级后同一段代码可能从“直接报错”变为“暂停后稍后继续”。

为什么会出现 gc_destructor_fiber

关键场景是：业务代码正在 Fiber 中运行，同时触发了循环垃圾回收。PHP 8.4 会让 GC 要处理的对象析构在一个独立的 gc_destructor_fiber 中执行，而不是简单地把所有析构继续塞回业务 Fiber。这样析构可以暂停；如果这个析构 Fiber 暂停，运行时会再创建一个新的 Fiber 去处理剩余析构任务。

这带来一个容易忽略的后果：析构函数暂停后，对象不会马上被视为“已经清理完”。官方手册明确说明，只有析构函数返回，或者承载它的 Fiber 被回收，对象才会完成回收。因此，析构里持有文件句柄、连接、锁或外部任务句柄时，不能把“进入 __destruct()”当作“资源已经释放”。

析构函数里暂停时，代码要能恢复

下面的示例只表达生命周期关系，不把输出当成运行截图。循环引用让对象进入 GC 队列，析构函数在清理到一半时暂停；恢复后必须从明确的状态继续，而不是重新释放一遍。

peer = $peer;
    }

    public function __destruct()
    {
        // 幂等保护：恢复或重复进入时不能二次释放外部资源。
        if ($this->closed) {
            return;
        }
        $this->closed = true;

        // PHP 8.4+ 才允许在析构执行期间切换 Fiber。
        Fiber::suspend('cleanup-paused');

        // 实际项目应在这里完成可恢复的最后一步。
        $this->peer = null;
    }
}
?>

更实际的写法是把 close() 设计成公开、显式、可重复调用的方法，正常路径先调用它；析构函数只检查状态并补漏。若必须把暂停交给调度器，要保存对应 Fiber 的引用，并记录“已开始、等待 IO、已完成”这类状态，避免 Fiber 因没有引用而提前结束。

上线前的判断清单

• 兼容范围是否包含 PHP 8.3？包含就不能依赖析构内切换。
• 清理是否能重复执行？句柄、订阅、锁和临时文件都要有完成标记。
• 暂停后谁负责恢复？没有调度器接管时，不要在析构中启动不可控的异步任务。
• 是否区分了引用计数析构、循环 GC 析构和脚本结束阶段？这三种时机的可控程度不同。

我的取舍是：Fiber 适合承载明确的异步工作流，析构只适合做最后一道保险。PHP 8.4 的放开是能力增强，不是把析构函数变成可靠的任务队列。

常见疑问

PHP 8.4 升级后，析构函数里可以随便 suspend 吗？不可以。它只是允许切换；GC 可能改用独立 Fiber，暂停会延后对象回收，异常和资源生命周期仍需由应用代码管理。

为什么析构函数暂停后还有其他析构继续执行？因为 PHP 会为剩余任务创建新的 gc_destructor_fiber。当前对象的析构没有完成，其他待处理对象仍可能继续由新的析构 Fiber 处理。