PHP 8.3/8.4 部署 Swoole 必须使用 5.1.x 系列（如 5.1.5），并启用 --enable-openssl 和 --enable-http2 编译选项，否则 swoole_http_server 等核心类不可用；需分别配置 CLI 与 FPM 的 php.ini 并启用协程 Hook。
PHP 8.3 或 8.4 环境下部署 Swoole，必须用 Swoole 5.1.x 系列，且不能跳过 OpenSSL 和 HTTP/2 编译开关——否则 swoole_http_server、swoole_websocket_server 等核心类直接不可用。
PHP 8.3+ 必须装 swoole 5.1.x，别碰 4.x
Swoole 4.8.x 是最后一个支持 PHP 7.4 的版本，它在 PHP 8.3 上编译会失败或运行时报 Segmentation fault；Swoole 5.0 开始强制要求 PHP ≥ 8.0，5.1.x（如 5.1.5）才是当前对 PHP 8.3/8.4 兼容最稳的分支。装错版本的典型表现是：php --ri swoole 显示 enabled，但 new Swoole\Http\Server 报 Class not found。
- 查当前 PHP 主版本：
/www/server/php/83/bin/php -v（宝塔路径示例，数字需按实际替换） - 确认 Swoole 版本兼容性：PHP 8.3 → 选
swoole-5.1.5；PHP 8.4 → 查官网 release 页面确认是否已支持（截至 2026 年 5 月，5.1.5 已明确标注支持 8.4） - 宝塔软件商店若没上架对应版本，别硬等——直接源码编译，这是唯一可靠路径
源码编译时 --enable-openssl 和 --enable-http2 不是可选项
漏掉这两个参数，swoole_http_server 构造函数会静默失败，swoole_websocket_server 连握手都通不过，错误日志里只显示 Connection reset by peer，根本看不出是编译问题。
- 正确 configure 命令（以 PHP 8.3 为例）：
/www/server/php/83/bin/phpize && ./configure --with-php-config=/www/server/php/83/bin/php-config --enable-openssl --enable-http2 - CentOS/RHEL 需提前装
openssl-devel；Ubuntu/Debian 必须有libssl-dev，否则 configure 会跳过 --enable-openssl 且不报错 - 编译成功后，检查输出的
Installing shared extensions:路径，例如/www/server/php/83/lib/php/extensions/no-debug-non-zts-20230831/，后面配extension=swoole.so时要确保路径一致
CLI 和 FPM 的 php.ini 必须各自加 extension=swoole.so
宝塔中 CLI 和 FPM 加载的是完全不同的配置文件，只改一个，必然出现「网页能跑，命令行报 Class not found」或反过来。这不是 bug，是 PHP 运行机制决定的。
立即学习“PHP免费学习笔记（深入）”；
- 查 CLI 实际加载的配置：
/www/server/php/83/bin/php --ini | grep "Loaded Configuration File" - 查 FPM 实际加载的配置：
ps aux | grep php-fpm | grep master | head -1然后看其启动参数，或直接查/www/server/php/83/etc/php.ini（宝塔默认路径，但以--ini输出为准） - 两个文件末尾都加：
extension=swoole.so；如果用了 opcache，重启前先执行sudo rm -f /tmp/opcache-*清缓存 - 验证不是
php -m | grep swoole，而是/www/server/php/83/bin/php --ri swoole和sudo -u www /www/server/php/83/bin/php-fpm -t后访问网页测试
装完不启用协程 Hook，等于白装
Swoole 扩展加载成功 ≠ 异步能力就绪。file_get_contents、curl_exec、MySQL 连接等默认仍是同步阻塞，必须显式开启协程 Hook 才能真正释放异步性能。
- 在入口脚本最顶部加：
Swoole\Runtime::enableCoroutine(true); - 若用 ThinkPHP + think-swoole，该设置已内置；但裸写 HTTP Server 时必须自己加，否则并发一高就卡死
- 启用后注意：所有 IO 操作（包括 Redis、PDO、file_*）都会走协程调度，旧代码里依赖同步顺序的逻辑可能出问题，需配合
go+co::sleep重写
最容易被忽略的是：Swoole 5.1.x 在 PHP 8.3+ 下，SWOOLE_HOOK_ALL 默认不包含 SWOOLE_HOOK_STREAM，如果项目里大量用 fopen 或 stream_socket_client，得手动补全 Hook 标志，否则这些调用依然同步阻塞。
