深入解析docker-library/php项目的Dockerfile-linux.template模板

模板概述

docker-library/php项目的Dockerfile-linux.template是一个用于生成PHP Docker镜像的模板文件，它支持多种Linux发行版（主要是Alpine和Debian）以及不同PHP版本的构建。该模板通过条件判断和变量替换实现了高度可配置的Dockerfile生成。

核心功能解析

1. 基础镜像选择

模板首先基于env.from变量选择基础镜像，支持Alpine和其他Linux发行版：

FROM {{ env.from }}

对于非Alpine系统，会添加防止安装Debian PHP包的配置：

{
    echo 'Package: php*';
    echo 'Pin: release *';
    echo 'Pin-Priority: -1';
} > /etc/apt/preferences.d/no-debian-php

2. 构建依赖管理

模板定义了两种类型的依赖：

• PHPIZE_DEPS：编译PHP扩展所需的工具链
• 运行时依赖：运行PHP所需的基础包

对于Alpine系统：

ENV PHPIZE_DEPS \
    autoconf \
    dpkg-dev dpkg \
    file \
    g++ \
    gcc \
    libc-dev \
    make \
    pkgconf \
    re2c

对于Debian系统：

ENV PHPIZE_DEPS \
    autoconf \
    dpkg-dev \
    file \
    g++ \
    gcc \
    libc-dev \
    make \
    pkg-config \
    re2c

3. 特殊补丁处理

模板针对特定PHP版本和Alpine组合应用了必要的补丁：

• PHP 8.1在Alpine上的构建问题（#11678和#14834）
• ZTS构建在Alpine 3.22+上的问题（#18743）

{{ if need_patch_11678 then ( -}}
# 应用11678和14834补丁
curl -fL 'https://github.com/php/php-src/commit/577b8ae4226368e66fee7a9b9c58f9e2428372fc.patch?full_index=1' -o 11678.patch;
{{ ) end -}}

4. PHP配置选项

模板根据不同的构建变体（cli、fpm、apache、zts）配置不同的编译选项：

./configure \
    --build="$gnuArch" \
    --with-config-file-path="$PHP_INI_DIR" \
    --with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \
    --enable-option-checking=fatal \
    --with-mhash \
    --with-pic \
    --enable-mbstring \
    --enable-mysqlnd \
    --with-password-argon2 \
    --with-sodium=shared \
    --with-pdo-sqlite=/usr \
    --with-sqlite3=/usr \
    --with-curl \
    --with-iconv{{ if is_alpine then "=/usr" else "" end }} \
    --with-openssl \
    --with-readline \
    --with-zlib

5. 变体特定配置

根据不同的PHP运行模式（Apache、FPM、CLI、ZTS）添加特定配置：

• Apache：启用apxs2支持
• FPM：配置运行用户和组
• ZTS：启用ZTS支持并禁用Zend信号
• CLI：启用phpdbg和embed支持

构建优化

模板包含多项构建优化措施：

1. 安全编译选项：

   ENV PHP_CFLAGS="-fstack-protector-strong -fpic -fpie -O2 -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64"
   ENV PHP_CPPFLAGS="$PHP_CFLAGS"
   ENV PHP_LDFLAGS="-Wl,-O1 -pie"
   

2. 符号剥离（非调试构建）：

   find /usr/local -type f -perm '/0111' -exec strip --strip-all '{}' || :
   

3. 清理构建依赖：

   • Alpine：apk del --no-network .build-deps
   • Debian：apt-get purge -y --auto-remove

使用建议

1. 选择合适的基础镜像：Alpine镜像更小，但某些扩展可能需要额外处理；Debian镜像更稳定。

2. 注意特殊补丁：特别是使用PHP 8.1在Alpine上构建时，确保相关补丁已应用。

3. 考虑运行模式：根据实际使用场景选择apache、fpm、cli或zts变体。

4. 调试构建：设置DOCKER_PHP_ENABLE_DEBUG=1可以保留调试符号。

这个模板展示了如何构建一个高度优化的PHP Docker镜像，同时处理了不同Linux发行版和PHP版本间的兼容性问题，是学习Dockerfile高级技巧的优秀范例。