pecl install是最稳的swoole安装方式，因它自动下载源码、检测依赖、调用phpize编译并写入配置；需提前安装libnghttp2-dev、libssl-dev、zlib1g-dev等系统库，装后须验证swoole.so存在、extension启用及coroutine是否开启。
pecl install 是目前最稳的方法，前提是容器里已装好编译依赖和系统级库（比如 nghttp2、openssl-dev 等），而不是靠 docker-php-ext-install 硬套——后者对 Swoole 这类带协程、HTTP/2、异步 DNS 依赖的扩展容易卡在编译阶段。
为什么 pecl install 更稳
它会自动下载源码、检测依赖、调用 phpize 和 make 编译，并写入 extension=swoole.so 到配置目录。相比手动解压 + docker-php-ext-install，省去路径错位、/usr/src/php 缺失、扩展名大小写不一致等常见断点。
-
pecl install自动处理swoole的子模块开关（如coroutine、openssl、http2），你只需按提示选 y/n - 失败时错误信息更直接（比如
error: nghttp2.h not found），能准确定位缺的是系统库而非 PHP 扩展 - 支持指定版本安装：
pecl install swoole-5.1.4，避免默认装最新版引发兼容问题
必须提前装的系统依赖有哪些
不同基础镜像差异大，但以下三项几乎必装（以 php:8.2-cli Debian 镜像为例）：
-
apt-get update && apt-get install -y libnghttp2-dev libssl-dev zlib1g-dev—— HTTP/2 和 TLS 支持依赖 -
apt-get install -y build-essential autoconf automake—— 编译工具链，pecl install内部要用 - 如果启用 MySQL 协程客户端，还得加
default-libmysqlclient-dev；PostgreSQL 则要libpq-dev
漏掉 libnghttp2-dev 会导致编译报 #error "Enable http2 support, require nghttp2 library."；只装 nghttp2 二进制包（非 -dev）也不行——头文件 nghttp2.h 必须存在。
pecl install 后还要做哪些事
装完不等于能用。常见遗漏点：
- 确认
swoole.so已生成：ls /usr/local/lib/php/extensions/*/swoole.so；若没找到，说明编译失败但pecl没报错（罕见，多因权限或磁盘满） - 检查是否启用：
php -r "echo extension_loaded('swoole') ? 'yes' : 'no';"；返回no很可能是docker-php-ext-enable swoole没运行，或者.ini文件被其他配置覆盖 - 若启动时报
Unable to load dynamic library 'swoole.so' - libnghttp2.so.14: cannot open shared object file，执行ldconfig刷新动态库缓存（Debian/Ubuntu 系统） -
php --ri swoole输出中coroutine => enabled才算真正启用了协程——这是 Swoole 性能关键，不是默认开启的
别踩这些坑
实际操作中最容易翻车的几个点：
- 用
alpine镜像却照搬 Debian 的apt-get命令：Alpine 要用apk add，且包名不同（如nghttp2-dev、openssl-dev） - 在
php-fpm镜像里用pecl install后忘记重启 FPM 进程：kill -USR2 1或service php-fpm reload，否则新扩展不生效 - 挂载本地代码进容器后，
server.php监听127.0.0.1:9501—— 容器内 localhost ≠ 宿主机，必须改0.0.0.0:9501并配EXPOSE+-p - PHP 版本和 Swoole 版本不匹配：比如 PHP 8.3 装了 Swoole 4.10 就会编译失败，查 官方兼容表 比硬试快得多
真正麻烦的从来不是“怎么装”，而是装完发现 coroutine 关着、http2 不可用、或 sendfile 因内核版本被禁——这些得靠 php --ri swoole 逐项核对，不能只看 php -m | grep swoole。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
