如何在Docker运行的Debian 9系统中安装指定旧版本PHP

核心原理 #

Debian 9 自带的libxml2版本为2.9.4，PHP 5.3.3及更早版本的源码默认不兼容高于2.9.0的libxml2，这是编译阶段出现相关报错的核心原因。以下方案通过修改源码兼容逻辑，无需大幅降级系统依赖即可完成安装。

可用Dockerfile示例 #

提前将对应版本的PHP源码包（如php-5.3.3.tar.gz）下载到Dockerfile同级目录，再使用以下配置：

# 基础镜像使用官方Debian 9 slim版，减小最终镜像体积
FROM debian:9-slim
# 替换为Debian 9归档源，官方原生源已停止服务
RUN sed -i 's/deb.debian.org/archive.debian.org/g' /etc/apt/sources.list && \
    sed -i 's/security.debian.org/archive.debian.org/g' /etc/apt/sources.list && \
    sed -i '/stretch-updates/d' /etc/apt/sources.list && \
    # 安装基础编译依赖和必要的系统库
    apt-get update && \
    apt-get install -y gcc make autoconf pkg-config libxml2 libxml2-dev libcurl4-openssl-dev && \
    # 导入本地提前下载的PHP源码包
    mkdir -p /opt/php-build
COPY php-5.3.3.tar.gz /opt/php-build/
RUN cd /opt/php-build && \
    tar -zxf php-5.3.3.tar.gz && \
    cd php-5.3.3 && \
    # 修改源码兼容高版本libxml2，解决编译报错
    sed -i 's/!defined(LIBXML_PARSE_HUGE)/0/g' ext/libxml/libxml.c && \
    # 配置编译参数，可根据实际需求增减扩展
    ./configure --prefix=/usr/local/php \
    --with-libdir=/lib/x86_64-linux-gnu \
    --enable-mbstring \
    --with-curl \
    --disable-xmlreader \
    --disable-xmlwriter \
    --disable-dom && \
    # 编译安装，-j参数后可填写构建机器的CPU核心数加快编译速度
    make -j2 && \
    make install && \
    # 添加PHP到全局路径
    ln -s /usr/local/php/bin/php /usr/bin/php && \
    # 清理构建缓存和无用依赖，减小镜像体积
    cd / && \
    rm -rf /opt/php-build && \
    apt-get purge -y --auto-remove gcc make autoconf pkg-config && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*
# 默认启动命令验证PHP版本
CMD ["php", "-v"]

补充说明 #

• 如果需要启用xml相关扩展，可将libxml2降级到2.8.x版本，对应安装包可从Debian 7归档源获取
• 安装早于5.3.3的PHP版本时，上述兼容补丁逻辑通用，部分极老版本编译时需要添加-std=gnu89参数到CFLAGS配置中
• 编译参数可根据实际业务需要调整，裁剪不需要的扩展可减少依赖冲突概率

构建验证命令 #

• 保存上述配置为Dockerfile，和PHP源码包放在同一目录
• 执行构建：docker build -t php-5.3-debian9 .
• 版本验证：docker run --rm php-5.3-debian9，正常会输出PHP 5.3.3的版本信息

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