宝塔docker中php容器安装swoole需绕过面板，先确认容器名及php版本，下载匹配swoole源码并复制进容器/usr/src/php/ext/，安装编译依赖后执行docker-php-ext-install swoole，最后usr2平滑重启生效。
在宝塔面板管理的Docker环境中为PHP容器安装Swoole扩展，需绕过宝塔图形界面直接操作容器内部，避免因镜像基础差异导致扩展编译失败或加载异常。
确认PHP容器运行状态与基础镜像
执行 docker ps 查看正在运行的PHP容器名称（如 php74-fpm 或 bt-php-8.1），记录容器ID或名称；【必须确认该容器使用的是官方PHP镜像（如 php:8.1-fpm）或宝塔官方构建的兼容镜像，非 Alpine 系统镜像】。Alpine 镜像缺少 glibc 和完整编译工具链，会导致 swoole 编译中断或运行时报 undefined symbol: clock_gettime 错误。
进入容器验证 PHP 版本：docker exec -it 容器名 php -v，输出中需明确显示 PHP 主版本号（如 8.1.27），此版本将决定可安装的 Swoole 最高兼容版本（例如 PHP 8.1 对应 Swoole 5.0.x～5.1.x）。
准备并注入 Swoole 源码包
在宿主机任意目录（如 /www/swoole-src）执行：
下载指定版本源码：wget https://pecl.php.net/get/swoole-5.1.3.tgz（请根据上一步确认的 PHP 版本选择对应 Swoole 版本，PHP 8.1 推荐 5.1.x；PHP 8.2 请选 5.2.x）。
解压并重命名：tar zxvf swoole-5.1.3.tgz && mv swoole-5.1.3 swoole。
复制到容器扩展目录：docker cp swoole 容器名:/usr/src/php/ext/。若提示 /usr/src/php/ext 不存在，先进入容器执行 docker-php-source extract 创建该路径——这一步漏掉会导致后续 docker-php-ext-install 找不到源码目录而报错“no such file or directory”。
编译安装 Swoole 扩展
第一步：进入容器：docker exec -it 容器名 /bin/bash。
第二步：安装编译依赖（Debian/Ubuntu 基础镜像）：apt update && apt install -y autoconf gcc g++ make pkg-config libssl-dev libsodium-dev。若为 CentOS/RHEL 系统，则替换为：yum install -y autoconf gcc gcc-c++ make openssl-devel libsodium-devel。
第三步：启用 Swoole 扩展：docker-php-ext-install swoole。编译过程约 2～5 分钟，终端持续滚动日志即为正常；若卡在 “checking for swoole support…” 超过 3 分钟，大概率是缺少 libsodium-dev 或 pkg-config，需退出重装依赖。
第四步：验证安装结果：php -m | grep swoole 应返回 swoole；再执行 php --ri swoole，看到 Version => 5.1.3 及 coroutine => enabled 即表示成功。
重启PHP服务并生效扩展
退出容器后，在宿主机执行：docker kill -s USR2 容器名（向 PHP-FPM 主进程发送平滑重启信号）。不要用 docker restart，它会强制终止所有 worker 进程，可能中断正在处理的请求。
检查扩展是否加载进运行时：docker exec 容器名 php -i | grep "swoole"，输出中出现 Additional .ini files parsed => /usr/local/etc/php/conf.d/docker-php-ext-swoole.ini 即说明配置已生效。
