pecl命令不存在时，需先安装php-pear和对应php版本的php-devel（centos）或php-dev（ubuntu），再使用宝塔指定路径如/www/server/php/82/bin/pecl安装swoole，并同步配置cli与fpm的php.ini且重启php服务。
pecl命令不存在，先装php-pear和php-devel
宝塔面板默认不自带pecl命令，直接运行pecl install swoole会报-bash: pecl: command not found。这不是路径问题，是根本没装这个工具链。
必须先安装 PHP 的 PEAR 包管理器和开发头文件：
-
yum install -y php-pear php-devel（CentOS/RHEL/Alibaba Cloud Linux） -
apt install -y php-pear php-dev（Ubuntu/Debian）
注意：这里的php-devel或php-dev包名要跟当前 PHP 版本对齐。比如你用的是宝塔编译安装的 PHP 8.2，实际包名可能是php82w-devel（CentOS）或php8.2-dev（Ubuntu），不能只装系统默认源里的php-devel——它可能对应 PHP 7.4 或 8.0，会导致后续phpize失败。
确认pecl是否属于当前PHP版本
装完后执行which pecl，很可能返回/usr/bin/pecl，但这只是系统级的，不一定适配宝塔里那个独立安装的 PHP。宝塔每个 PHP 版本都有自己的pecl二进制，路径固定为：/www/server/php/{版本号}/bin/pecl（例如/www/server/php/82/bin/pecl）。
务必用这个路径调用，否则会因 ABI 不匹配导致扩展加载失败：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 验证版本：
/www/server/php/82/bin/php -v - 调用对应 pecl：
/www/server/php/82/bin/pecl install swoole - 别用
pecl裸命令，也别用php -d extension_dir=... -r "..."绕过——它不解决根本路径错配问题
pecl install swoole失败时常见卡点
即使pecl命令存在，安装过程也可能中断在几个典型位置：
-
No releases available for package "pecl.php.net/swoole"：说明 PEAR 通道缓存损坏或 DNS 解析失败。执行pear clear-cache && pear update-channels && pear upgrade后再试 - 卡在
downloading swoole-*.tgz不动：服务器无法访问pecl.php.net（常见于内网、防火墙拦截或国内 DNS 污染）。此时改用wget https://pecl.php.net/get/swoole-5.1.6.tgz手动下载，再解压编译 - 编译报错
gcc version too old：Swoole 5.x 要求 GCC ≥ 4.8。宝塔 CentOS 系统若仍用 GCC 4.4，必须升级：yum install centos-release-scl && yum install devtoolset-9-gcc*，然后启用：scl enable devtoolset-9 bash
装完swoole.so但php -m看不到？检查两套php.ini
宝塔里 PHP-FPM 和 CLI 是两套独立配置，extension=swoole.so必须同时写入：
- CLI 配置：
/www/server/php/82/etc/php.ini - FPM 配置：
/www/server/php/82/etc/php-fpm.d/www.conf中找php_admin_value[extension]行追加，或直接在php.ini末尾加
加完别只点「重载配置」——必须点「重启 PHP」，否则swoole.so不会被重新加载。验证分两路跑：
- CLI：
/www/server/php/82/bin/php --ri swoole - Web：
/www/server/php/82/bin/php -r "print_r(get_extension_funcs('swoole'));"或建 info.php 访问
漏掉任一环节，都会出现「命令行有、网页没」或反之的现象，这是宝塔多环境配置最常被忽略的细节。
