Swoole 4 在 CentOS 7 上稳定运行需确保 PHP ≥ 7.2、gcc/g++/make/autoconf/pcre-devel/php-devel 齐全、phpize 可用、OpenSSL 已启用；推荐 PECL 一键安装（pecl install swoole），或源码编译时指定 --with-php-config 和 --enable-openssl；务必在正确 php.ini 中添加 extension=swoole（PECL）或 extension=swoole.so（源码），并用 php -m 和 php --ri swoole 双重验证。
要在 CentOS 上稳定运行 Swoole 4，关键不是“装上就行”，而是让底层依赖、编译链路和 PHP 运行环境三者严丝合缝。版本错一位、路径漏一个、配置写错文件，都可能导致 Class 'Swoole\Http\Server' not found 或 php -m 看不见 swoole。
确认基础环境与依赖版本
CentOS 7 是当前最稳妥的选择（CentOS 8+ 已停止维护，不建议用于生产）。必须检查以下四项：
-
PHP 版本 ≥ 7.2：Swoole 4.8+ 不兼容 PHP 7.1 及更低版本，执行
php -v验证；若为源码安装的 PHP，请确保php-config可用（常位于/usr/local/bin/php-config或/www/server/php/XX/bin/php-config） -
开发工具齐全：
gcc、g++、make、autoconf、pcre-devel缺一不可，执行：yum install -y gcc gcc-c++ make autoconf pcre-devel -
phpize 必须可用：运行
which phpize；若提示未找到，需安装php-devel（CentOS）：yum install -y php-devel -
OpenSSL 支持开启：Swoole 的 HTTPS、HTTP/2、WebSocket wss 全部依赖它，验证命令：
php -r "echo extension_loaded('openssl') ? 'yes' : 'no';"—— 输出yes才算达标
选择安装方式并执行
推荐优先使用 PECL（适合快速上线），源码编译仅在需启用特定特性（如 --enable-async-redis）或调试时采用：
CentOS Linux 7.9.2009
下载
CentOS Linux 7.9.2009是传统CentOS Linux 7的最后主要版本，也是很多企业历史服务器中仍可能遇到的系统版本。它以稳定、兼容RHEL 7生态、文档丰富和软件支持广泛著称，曾长期用于Web服务、数据库、虚拟化节点和企业内部业务系统。不过CentOS Linux 7已于2024年6月30日停止维护，现在继续使用会面临安全补丁缺失风险。该版本更适合旧业务迁移、历史环境恢复或离
-
PECL 安装（一行命令，自动适配）：
pecl install swoole
过程中按回车接受默认选项；成功后会提示 “You should addextension=swooleto php.ini” —— 注意是swoole（无 .so），这是 PECL 2.0+ 的标准写法 -
源码编译（可控性强，推荐指定路径）：
① 下载稳定版（如 v4.8.13）：cd /tmp && wget https://github.com/swoole/swoole-src/archive/refs/tags/v4.8.13.tar.gz && tar -xzf v4.8.13.tar.gz && cd swoole-src-4.8.13
② 显式调用 phpize（避免路径冲突）：/usr/bin/phpize或/www/server/php/74/bin/phpize（依实际路径调整）
③ configure 时务必指定--with-php-config并启用关键特性：./configure --with-php-config=/usr/bin/php-config --enable-openssl --enable-http2
④ 编译安装：make -j$(nproc) && sudo make install
启用扩展并精准验证
很多问题出在“改了错的 php.ini”。务必分清 CLI 和 Web（FPM）环境：
- 查 CLI 当前加载的配置：
php --ini | grep "Loaded Configuration File"
典型路径如/etc/php.d/zzz-swoole.ini或/etc/php-cli/php.ini - 在该文件末尾添加（注意：PECL 写
extension=swoole，源码编译写extension=swoole.so） - 重启对应服务：
CLI 无需重启；FPM 用户执行：systemctl restart php-fpm或service php74-fpm restart（依 PHP 版本调整） - 双重验证：
•php -m | grep swoole（输出 swoole 表示已加载）
•php --ri swoole（查看详细信息，含 coroutine、openssl、http2 是否 enabled）
常见卡点与绕过方案
运维中最容易反复踩坑的地方：
-
“phpize: Cannot find config.m4”：说明没在源码根目录执行，或下载的是 GitHub ZIP 解压后多了一层目录（如
swoole-src-4.8.13/swoole-src-4.8.13/），cd 进最内层再试 -
“configure: error: Cannot find php-config”：
--with-php-config路径错误，用find / -name php-config 2>/dev/null精确定位 -
“SSL operation failed” 报错：即使 openssl 扩展已启用，也可能是编译时未加
--enable-openssl，需重新 configure + make clean + make -
Web 页面不生效但 CLI 正常：90% 是改了 CLI 的 php.ini，却没改 FPM 对应的配置（通常在
/etc/php-fpm.d/www.conf中指定php_admin_value[extension]或单独的 ini 文件）
