不能直接同步swoole.so文件，因其强依赖服务器PHP版本、编译参数、系统架构及libc版本，版本或配置稍有差异即报undefined symbol或加载失败；必须在目标服务器用pecl install swoole或源码编译重装，并分别配置CLI与FPM的php.ini后重启对应服务。
本地装好 Swoole 扩展，不代表服务器上也有——PHP 扩展必须在目标服务器环境里单独安装，不能通过复制文件、同步代码或上传 php.ini 配置直接生效。
为什么不能直接同步扩展文件（swoole.so）？
扩展是编译产物，强依赖：
• 服务器上的 PHP 版本（如 php -v 输出的 8.1.27 vs 本地 8.2.12）
• PHP 的编译参数（是否启用 --enable-mysqlnd、--with-openssl 等）
• 系统架构（x86_64 vs aarch64）和 libc 版本
• php-config 路径与 ABI 兼容性
哪怕只差一个小版本，swoole.so 加载时大概率报错：undefined symbol: php_json_decode_ex 或直接 Failed loading /path/to/swoole.so: Cannot load module
服务器上必须重装，但可以标准化流程
避免每次手动敲命令出错，推荐用可复现的安装方式：
- 用
pecl install swoole（最省事）：前提是服务器有pecl且网络通畅；注意加-f强制覆盖旧版，例如pecl install -f swoole - 源码编译（最可控）：下载与你服务器 PHP 版本匹配的 Swoole 发行版（比如 PHP 8.1 → 选
swoole-4.12.x），执行：phpize<br>./configure --with-php-config=/usr/bin/php-config<br>make && make install
注意替换/usr/bin/php-config为which php-config实际路径 - 宝塔/AMH 等面板用户：直接进「PHP 设置 → 安装扩展」点安装，自动适配当前 PHP 版本，不用管路径和参数
php.ini 配置要单独确认
本地加的 extension=swoole.so 不会自动生效到服务器，必须人工检查：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php --ini查服务器真正的配置文件路径（常见于/www/server/php/81/etc/php.ini或/etc/php/8.1/cli/php.ini） - 确认该
php.ini文件里已写入extension=swoole.so（不是注释掉，且没拼错） - 区分 CLI 和 FPM：如果跑的是
php-fpm，需重启php-fpm进程（systemctl restart php-fpm或service php8.1-fpm restart），光重启 Nginx 没用 - 验证是否加载成功：执行
php -m | grep swoole（CLI 模式）或phpinfo()页面搜索 “swoole”
真正容易被忽略的是 PHP SAPI 类型差异——你在本地用 CLI 测试成功，但线上是 FPM，结果 php-fpm 进程根本没加载扩展。务必在目标运行环境下验证，而不是只信 php -v 或本地 php -m。
