PHP8.1-FPM-Alpine镜像安装PCov/SSH2/Swoole扩展失败求助

核心问题分析 #

你的Docker构建失败是因为安装pcov、ssh2、swoole这几个PECL扩展时，缺少必要的系统依赖库：

• ssh2扩展需要libssh2-dev才能编译
• swoole扩展需要linux-headers支持底层系统调用
• 多个扩展同时安装时，单个扩展编译失败会导致整个命令直接退出

修复后的Dockerfile #

FROM php:8.1.9-fpm-alpine

# 更新系统并安装完整依赖
RUN apk --no-cache upgrade && \
    apk --no-cache add bash git sudo openssh libxml2-dev oniguruma-dev autoconf gcc g++ make npm freetype-dev libjpeg-turbo-dev libpng-dev libzip-dev libssh2-dev linux-headers

# PHP: Install php extensions
RUN pecl channel-update pecl.php.net

# 分开安装PECL扩展，便于排查单个扩展的问题
RUN pecl install pcov
RUN pecl install ssh2
RUN pecl install swoole

RUN docker-php-ext-configure gd --with-freetype --with-jpeg
RUN docker-php-ext-install mbstring xml pcntl gd zip sockets pdo pdo_mysql bcmath soap
RUN docker-php-ext-enable mbstring xml gd zip pcov pcntl sockets bcmath pdo pdo_mysql soap swoole

# 移除重复的扩展安装命令
# RUN docker-php-ext-install pdo pdo_mysql sockets

# 直接使用官方composer镜像复制，更可靠
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
COPY --from=spiralscout/roadrunner:2.4.2 /usr/bin/rr /usr/bin/rr

WORKDIR /app
COPY . .

RUN composer install
RUN composer require laravel/octane spiral/roadrunner

RUN npm install --global yarn
RUN yarn
RUN yarn prod

# 生产环境建议通过环境变量设置APP_KEY，而非构建时生成
# RUN php artisan key:generate
RUN php artisan octane:install --server="swoole"

CMD php artisan octane:start --server="swoole" --host="0.0.0.0"
EXPOSE 8000

额外优化建议 #

• 分开安装PECL扩展：将pecl install pcov ssh2 swoole拆分为单独的RUN命令，这样如果某个扩展安装失败，可以快速定位具体问题。
• 移除重复命令：你的Dockerfile里重复执行了docker-php-ext-install pdo pdo_mysql sockets，这完全没必要，直接删除即可。
• APP_KEY的正确处理：构建镜像时生成APP_KEY会导致镜像不可复用（所有容器都会共用同一个密钥），建议在容器启动时通过环境变量传递APP_KEY，或者在启动脚本中动态生成。

内容的提问来源于stack exchange，提问作者FreddicMatters