PHP最新版如何部署Swoole_PHP最新版Swoole部署异步【扩展】-php教程-PHP中文网

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最新版如何部署swoole_php最新版swoole部署异步【扩展】

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，根本看不出是编译问题。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

正确 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 运行机制决定的。

查 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 标志，否则这些调用依然同步阻塞。