ubuntu/debian上pecl安装swoole 4仅需三步：先执行sudo apt install php-dev pkg-php-tools安装依赖，再运行sudo pecl channel-update pecl.php.net && sudo pecl install swoole自动安装，最后用sudo phpenmod swoole启用并以php -m | grep swoole验证成功。
Ubuntu/Debian 系统上用 PECL 安装 Swoole 4，其实就三步：装依赖、跑命令、启扩展。不编译、不找路径、不改权限，全程终端敲几行就能跑起来。
装好基础依赖
PECL 编译扩展需要 PHP 开发头文件和构建工具：
-
更新包列表：
sudo apt update -
安装必需组件：
sudo apt install php-dev pkg-php-tools -y
一键安装 Swoole 4
确保 PECL 渠道最新，然后直接安装（自动适配当前 PHP 版本）：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 刷新通道：
sudo pecl channel-update pecl.php.net - 安装 Swoole：
sudo pecl install swoole - 安装过程会提示是否启用某些特性（如 http2、openssl），按回车默认全部启用即可
启用并验证模块
PECL 安装后不会自动加载，需手动启用：
- 执行启用命令：
sudo phpenmod swoole（这是最可靠的方式，比手改 php.ini 更稳） - 检查是否生效：
php -m | grep swoole—— 出现swoole即成功 - 查看详细信息（含版本）：
php --ri swoole
常见问题快速处理
如果 phpenmod 报错或模块未加载，说明配置未生效：
- 确认 mods-available 下有 swoole.ini：
ls /etc/php/*/mods-available/swoole.ini - 若缺失，可手动创建：
echo "extension=swoole.so" | sudo tee /etc/php/$(php -r "echo PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION;")/mods-available/swoole.ini - 再重试
sudo phpenmod swoole
整个流程无需解压、无需 phpize、无需 configure，适合开发环境快速落地。Swoole 4.x 默认兼容 PHP 7.2–8.3，只要系统 PHP 版本在此范围内，PECL 就能自动匹配对应版本。
