php 8.1 下必须选用 swoole 5.0 而非 4.8，因后者不支持 php 8.1 的 zend_object 布局与只读类检查，协程实际不可用且易崩溃；swoole 5.0 要求显式启用协程钩子，推荐使用独立 swoole-cli 二进制包。
PHP 8.1 安装 Swoole 4.8 和 5.0 不是“版本选高就行”的问题，而是运行模型、协程行为、接口语义三者根本不同的切换——装错一个，服务可能启动失败、协程泄漏、或静默降级为同步阻塞。
PHP 8.1 下 Swoole 4.8 仍可编译但已不被官方支持
Swoole 4.8 最终版（v4.8.15）发布于 2023 年底，其源码未适配 PHP 8.1 的 zend_object 内存布局变更与只读类（readonly）语法检查。虽然部分用户能用 phpize && make && make install 强行编译通过，但会出现：
- 加载扩展后
php --ri swoole显示coroutine => disabled（协程实际不可用） - 调用
Swoole\Coroutine::create()时触发Segmentation fault (core dumped)（ABI 不兼容导致内存越界） - 使用
pdo_mysql在协程中执行查询，连接池不生效，Too many connections错误频发
根本原因：Swoole 4.8 的 C 层对象结构体字段偏移量与 PHP 8.1 的 Zend 引擎对齐规则冲突，不是加个 -DZEND_ENABLE_STATIC_ROOT 就能绕过的。
Swoole 5.0 要求 PHP 8.1+ 且必须启用协程钩子
Swoole 5.0 是为 PHP 8.1+ 从头设计的，它把协程能力下沉为运行时必需项，而非可选特性。安装后必须显式开启钩子，否则所有 I/O 仍是同步的：
- 必须在入口文件顶部加
Swoole\Runtime::enableCoroutine(true)或配置php.ini中swoole.enable_coroutine = 1 - 若用
Co\run()启动，需确保未提前加载任何非协程安全的扩展（如newrelic、datadog） -
php --ri swoole输出中必须同时出现coroutine => enabled和hook => enabled才算真正就绪
漏掉钩子启用，Swoole\Coroutine\Http\Client 会退化成阻塞调用，QPS 直接跌回 FPM 水平。
安装方式本身已分裂：swoole-cli 成为独立可执行体
Swoole 5.0 开始提供 swoole-cli —— 它不是 PHP 扩展，而是一个裁剪版 PHP 解释器 + Swoole 运行时的二进制包：
- 下载
swoole-cli-v5.0.0-linux-x64.tar.xz解压后直接运行./swoole-cli -v，无需php.ini配置或扩展安装 -
swoole-cli自带精简版扩展集（不含gd、imap等），但默认启用全部协程钩子，开箱即用 - 旧式
pecl install swoole方式安装的仍是扩展模式，适用于需复用现有 PHP 环境（如宝塔、Docker PHP-FPM 基础镜像）的场景
二者不能混用：swoole-cli 下无法 extension= 加载传统扩展，而传统扩展模式下也无法调用 swoole-cli 特有 API（如 Co\Trace 上下文透传）。
最易被忽略的一点：Swoole 5.0 的 Co\Http\Server 默认关闭 keepalive，而 4.8 是默认开启的。如果没在 set() 中显式配置 'open_http2_protocol' => true 或 'http_compression' => true，HTTP/1.1 的长连接会被悄悄断开，前端看到大量 ERR_CONNECTION_CLOSED。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
