云服务器安装Swoole首选PECL方式，需确保php与pecl路径一致、手动添加extension=swoole.so到正确php.ini，并重启php-fpm；验证须用curl测试本地HTTP服务是否可达。
云服务器上装 Swoole，首选 PECL 安装
绝大多数云服务器（阿里云、腾讯云、华为云等）用的是标准 Linux 发行版（CentOS/Ubuntu），PHP 环境通常由宝塔、AMH 或手动编译部署。这种环境下，pecl install swoole 是最稳、最快、最省心的方式——它自动适配当前 PHP 版本和 ABI，不用操心 phpize 路径、php-config 位置或 OpenSSL 依赖是否对得上。
- 执行前先确认：运行
which php和which pecl，确保两者指向同一 PHP 实例（比如都在/www/server/php/81/bin/下）；否则会装到错版本里 - 如果提示
command not found: pecl，说明 PHP 编译时没带--with-pear，或系统未安装php-pear包（Ubuntu：运行sudo apt install php-pear；CentOS：运行yum install php-pear） - PECL 安装后，
swoole.so默认写入 PHP 扩展目录（如/usr/lib/php/20220829/），但不会自动加extension=swoole.so到php.ini——这步必须手动补上
手动编译安装：只在需要定制参数时才选
当你明确要启用 --enable-http2、--enable-openssl、--enable-mysqlnd 等特性，或云服务器上存在多 PHP 版本共存（比如同时跑 PHP 7.4 和 8.2），就必须走源码编译。这时最容易翻车的不是命令本身，而是路径错配。
- 务必用
which php-config查准路径，别直接抄网上的/usr/bin/php-config——宝塔用户常见路径是/www/server/php/82/bin/php-config -
./configure后若报错error: Please specify --with-openssl-dir=，说明系统 OpenSSL 开发头文件缺失：Ubuntu 执行sudo apt install libssl-dev，CentOS 执行yum install openssl-devel -
make install成功后，输出的Installing shared extensions:行末尾才是真实扩展路径，例如/www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/，这个路径必须和php -i | grep "extension_dir"输出一致，否则extension=swoole.so会静默失效
装完不生效？90% 是配置没落进正确的 php.ini
云服务器上 PHP 配置常被拆成多个文件，php -m 显示已加载，但 phpinfo() 里没有 Swoole，大概率是扩展加到了错误的配置文件里。
- 运行
php --ini，看 Loaded Configuration File 是哪个（如/www/server/php/82/etc/php.ini），别只改/etc/php.ini - 有些环境（如 Ubuntu + Ondrej PPA 源）会把扩展单独放在
/etc/php/8.2/cli/conf.d/20-swoole.ini，这时只需新建该文件，内容只写一行：extension=swoole.so - 改完配置必须重启对应服务：CLI 模式下只需重开终端；Web 模式（Apache/Nginx）必须重启
php-fpm进程，不是重启 Web 服务器本身
验证是否真可用：别只信 php -m
php -m | grep swoole 只说明扩展被加载了，不代表能正常工作。云服务器常因 SELinux、防火墙或内核参数限制，导致 Swoole 的 TCP/UDP 监听、定时器、协程调度异常。
- 快速验证：运行一个最小 HTTP 服务
php -r "\$s = new Swoole\Http\Server('0.0.0.0', 9501); \$s->on('request', fn(\$r,\$rs) => \$rs->end('ok')); \$s->start();"，然后curl http://127.0.0.1:9501，通了才算真可用 - 如果连本地都 curl 不通，检查
systemctl status php-fpm是否在运行，以及云安全组是否放行了目标端口（如 9501） - 遇到
ERROR swListenPort_create(:224): bind(9501) failed. Error: Permission denied[13]，说明非 root 用户无法绑定低端口（
云环境的“透明性”反而容易掩盖路径、权限、配置分层这些细节，装 Swoole 不难，难的是确认它真的在你预期的 PHP 实例里、以你预期的方式跑着。
