Docker中仓库安装的Composer无法识别PHP内置扩展

从两次composer diagnose的输出对比能直接定位问题：

• 通过apk add composer安装的Composer，默认调用的是Alpine仓库独立提供的PHP（路径/usr/bin/php83）
• 官方php:8.3-fpm-alpine镜像自带的PHP路径为/usr/local/bin/php，也就是你用phpinfo()查到的、已集成session/fileinfo等核心扩展的版本

这是两个完全独立的PHP环境：Alpine仓库的php83包配置文件在/etc/php83/下，默认未启用那些核心扩展，导致Composer检测不到；而官方镜像自带的PHP配置在/usr/local/etc/php，已经内置了这些扩展。

直接在官方镜像自带的PHP环境下安装Composer，弃用Alpine仓库的Composer包。修改你的Dockerfile，替换掉原有的Composer安装步骤：

修改后的Dockerfile示例 #

FROM php:8.3-fpm-alpine

WORKDIR /var/www/html
COPY --chown=www-data:www-data --chmod=644 composer.json composer.lock .

RUN apk update \
 && apk upgrade \
 && mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini" \
 && apk add --no-cache \
    libpq-dev \
    wget \
 # 安装PHP扩展的正确命令
 && docker-php-ext-configure pdo_pgsql \
    --with-pdo-pgsql=/usr/local/include/php \
 && docker-php-ext-install pdo_pgsql \
 # 用官方方式安装Composer，绑定到镜像自带的PHP
 && php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" \
 && php composer-setup.php --install-dir=/usr/local/bin --filename=composer \
 && php -r "unlink('composer-setup.php');" \
 && composer install --no-dev --optimize-autoloader \
 && rm -vrf /var/cache/apk/*

USER www-data

EXPOSE 9000
CMD ["php-fpm"]

关键修正点 #

1. 移除apk add composer，改用官方脚本安装Composer，确保它调用的是镜像自带的/usr/local/bin/php
2. 修正原Dockerfile中的错误：composer install pgsql pdo_pgsql是无效命令，PHP扩展需用docker-php-ext-install安装
3. 新增--no-dev --optimize-autoloader参数优化生产环境的依赖安装过程

构建镜像并进入容器执行composer diagnose，会看到PHP binary path显示为/usr/local/bin/php，此时Composer就能正确识别到镜像自带的所有核心扩展，composer install也不会再报扩展缺失的错误。

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