PHP 8.4 原生不支持协程，协程功能完全依赖 Swoole 等外部扩展，而 Swoole 5.1.x 目前仅官方支持至 PHP 8.3，尚未兼容 PHP 8.4。
PHP 8.4 原生不支持协程，也没有内置的 coroutine 关键字或运行时协程调度器。所谓“PHP 8.4 协程”实际是混淆了语言版本与扩展能力——协程功能完全依赖外部扩展（如 Swoole、OpenSwoole），且这些扩展目前尚未正式兼容 PHP 8.4（截至 2024 年中，Swoole 5.1.x 仅官方支持到 PHP 8.3）。
如果你看到“PHP 8.4 + 协程”的提法，大概率是误传、测试分支尝试，或把 JIT 编译优化误解为协程支持。
为什么 PHP 8.4 不能直接用 go 或 co::run
go 或 co::run
PHP 核心仍是同步阻塞模型，所有 I/O（文件、网络、数据库）默认会挂起整个进程。协程需要：
- 用户态栈切换能力（PHP 不提供
setjmp/longjmp或ucontext封装） - 非阻塞 I/O 底层支持（需 epoll/kqueue/iocp，PHP 标准流不暴露控制权）
- 运行时调度器（PHP 解释器本身无事件循环）
这些全部由 Swoole 等扩展在 C 层实现，PHP 层只是调用其封装好的接口。
立即学习“PHP免费学习笔记（深入）”；
Swoole 协程在 PHP 8.3 下的典型用法（PHP 8.4 尚不可用）
当前稳定组合是 PHP 8.3 + Swoole 5.1.x。以下代码在 PHP 8.4 上会报错：Call to undefined function Swoole\Coroutine\run()（除非你手动编译了未发布的适配分支）。
use Swoole\Coroutine;
<p>Coroutine\run(function () {
$result = Coroutine\HTTP\Client::get('<a href="https://www.php.cn/link/5f69e19efaba426d62faeab93c308f5c">https://www.php.cn/link/5f69e19efaba426d62faeab93c308f5c</a>');
echo $result['body'];
});关键点：
-
Coroutine\run()是协程调度入口，必须显式启动 - 所有 Swoole 提供的协程 API（如
Co\Http\Client、Co\MySQL）只能在协程上下文中调用 - 普通
file_get_contents()、curl_exec()仍会阻塞，不能混用
PHP 8.4 中试图启用协程的常见错误现象
开发者常踩的坑包括：
- 升级 PHP 到 8.4 后，原有 Swoole 协程代码直接报
Class 'Swoole\Coroutine' not found—— 因扩展未加载或版本不兼容 - 强行用
dl()加载旧版 so 文件，触发Segmentation fault（PHP 8.4 ABI 变更） - 误以为
fibers（PHP 8.1+ 的纤程）等价于协程：它不自动拦截 I/O，无法替代 Swoole 的异步能力
注意：Fiber 是协作式用户态线程，但没有内置事件循环和非阻塞驱动，不能用于高并发网络服务。
现在该怎么做？
如果你必须基于 PHP 8.4 开发高性能服务：
- 暂缓升级，继续用 PHP 8.3 + Swoole 5.1.x（这是当前唯一生产就绪的组合）
- 关注 Swoole 官方仓库 的
php84分支进展，但不要在生产环境试用 alpha/beta 版本 - 避免把
Fiber当协程用：它适合复杂状态机或轻量任务拆分，而非替代Co\MySQL::query()
真正的协程支持不是加个语法糖就能落地的事——它卡在扩展兼容性、I/O 驱动、调度策略三个硬环节上，而 PHP 核心团队明确表示短期内不会介入。
