如何在Alpine 3.6的PHP 7.2-FPM Docker镜像中安装PHP Soap扩展？

我之前在Alpine镜像里折腾PHP扩展时也碰到过一模一样的问题，这个configure: error: xml2-config not found错误其实很好解决——根源就是Alpine系统默认没装libxml2的开发依赖包，而编译Soap扩展刚好需要这个包里的xml2-config工具。

下面是针对php:7.2-fpm-alpine3.6镜像的完整解决方案：

方法一：通过Dockerfile固化安装步骤（推荐正式环境用） #

把这段命令加到你的Dockerfile中即可：

# 安装编译Soap扩展必需的依赖包
RUN apk add --no-cache libxml2-dev \
    # 用官方工具安装Soap扩展
    && docker-php-ext-install soap \
    # 清理开发依赖包，减小镜像体积
    && apk del libxml2-dev

关键步骤解释： #

• apk add --no-cache libxml2-dev：Alpine里的开发工具包都带-dev后缀，这个包就是提供xml2-config的核心依赖
• docker-php-ext-install soap：官方镜像自带的扩展安装命令，会自动处理编译、配置到PHP环境的全流程
• apk del libxml2-dev：扩展安装完成后，开发包就没用了，删掉它能大幅缩小镜像大小

方法二：进入运行中的容器临时安装（仅测试场景用） #

如果只是临时验证功能，你可以进入容器执行以下命令：

# 先装依赖
apk add --no-cache libxml2-dev
# 安装Soap扩展
docker-php-ext-install soap
# 重启PHP-FPM使扩展生效（根据容器内的PHP-FPM版本调整命令）
php-fpm7.2 -t && php-fpm7.2 -s reload

注意：这种临时安装的配置在容器重启后会丢失，正式环境一定要用Dockerfile固化操作。

另外要提醒一句：Alpine的包管理工具是apk，和Debian/Ubuntu系的apt-get不一样，别搞混了，这也是很多新手踩坑的点。

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