Thank docker-library/php Alpine
Build images for php-fpm.
- alpine 3.24.4
- php
- php 8.5.12 2026-10-21
- php 8.4.27 2026-10-21
- php 7.4.33 php2shell 1.4 (e57e652)
- php 5.6.40 php2shell 1.4 (e57e652)
- php 5.4.45 php2shell 1.4 (e57e652)
- 安全补丁:
- 5.4 / 5.6 / 7.4:php2shell 1.4
enhanced-universal - 5.4 / 5.6 / 7.4:上游 CVE backports,见
patches/backports/<ver>/ - 全部版本:libxml2 2.13.9-r100(CVE-2026-86137~86144 backport),见 alpine-apk
- 5.4 / 5.6:回移 CVE-2019-11043(FPM
path_info下溢 RCE)与 CVE-2026-109618/109619(bailout 状态损坏);后者同时强制禁用 session upload progress 回调,与上游修复一致 - 7.4:
048-fix-ghsa-4w77-75f9-2c8w.patch(php -Scontent-type UAF) - 5.4 / 5.6:
030-fix-php2shell-upload-progress-crash-with-max-parts.patch,修复max_multipart_body_parts与上传进度组合导致的崩溃 - 5.4:php2shell v1.4
e57e652修正main/rfc1867.c中多余的空白跳过循环,旧版补丁会吞掉 multipart 头值(如Content-Disposition)的首字符
- 5.4 / 5.6 / 7.4:php2shell 1.4
- ext. :
- add shared : bcmath, bz2, exif, gd, gettext, gmp, mcrypt, mysql, mysqli, opcache, openssl, pdo_mysql, pdo_odbc, pdo_pgsql, pgsql, redis, sockets, sodium, timezonedb, xsl, zip
- iconv gnu libiconv 1.19
- mcrypt php 5. php 7, 8: Alternatives: Sodium/OpenSSL
- mysql php 5. php 7, 8: Alternatives: mysqli
- odbc php 7, 8: unixODBC
- openssl php 5.4/5.6: 1.0.2u(源码编译到
/usr/local/ssl1.0);php 7.4: 1.1.1w(源码编译到/usr/local/ssl1.1);php 8.4/8.5: Alpine 系统的 3.5.9(libssl3/libcrypto33.5.9-r1)。php < 8 的 php 二进制链接自编译库,Alpine 自带的 3.5.9 只供 curl 等系统组件使用 - curl 后端 php 5.4/5.6/7.4: wolfssl 5.9.4(本地仓库的 curl 8.23.0-r100);php 8.4/8.5: openssl 3.5.9(官方 curl 8.23.0-r0)
- sodium php 7, 8
- composer php 5.4/5.6: 2.2.30(版本与 sha256 固定);php 7.4/8.4/8.5: 构建时下载 latest stable,目前 2.11.2(随上游变化)
- phpcs
EOL 版本的补丁顺序为:先应用 patches/php2shell 中的 php-<ver>-enhanced-universal.patch,再按文件名顺序应用 patches/backports/<ver>/*.patch。backports 主要来自 shivammathur/php-src-backports,仅选取与本镜像已启用扩展 / SAPI 相关的 CVE;补丁更新与检查流程见下文「补丁与维护」。EOL 版本不能替代上游安全支持,条件允许时应升级到受支持版本。
./build.sh <ver-dir-name> [options] [buildx options]
<ver-dir-name> 目录名,如 5.4、5.6、7.4、8.4、8.5
-v, --ver TAG 镜像 tag,可带仓库前缀;默认使用目录名
-p, --push 推送镜像
-t, --test 运行 trivy 和 test.sh
-m, --mirrors 使用南京大学镜像源
-c, --clear 清理 buildx 缓存首次克隆后需先生成固定版本的 apk 包,否则镜像构建会在 COPY apk/x86_64 处失败:git submodule update --init --recursive && (cd apk && ./build-apk.sh)。
patches/php2shell 子模块固定在上游 v1.4-enhanced-45(e57e652);patches/backports/.upstream-tips 记录每个 EOL 版本已检查到的上游 backports tip(<版本> <SHA> <检查日期>)。
git submodule update --init --recursive # 首次克隆或子模块升级后
./check-backports.sh # 检查上游新提交是否已回移;无缺口时自动更新 .upstream-tips
./check-backports.sh --versions 5.4 --no-update
./create-dockerfile.sh # 修改 Dockerfile.template 后重新生成各版本 Dockerfilecheck-backports.sh 对每条上游新提交输出判定:
| 判定 | 含义 |
|---|---|
COVERED |
相关 hunk 已存在于本地补丁链(git apply -R 可回退) |
MISSING |
上游补丁可正向应用,本地缺失,需要回移 |
REVIEW |
文件相关但 hunk 不匹配,需人工确认 |
SKIP |
仅测试 / NEWS / 本镜像未构建的扩展或 SAPI |
其它脚本:
| 脚本 | 作用 |
|---|---|
./sync-download.sh |
预下载全部依赖到 .download/ |
./check-versions.sh |
trivy 扫描镜像 + 检查 PHP / Alpine 新版本 |
./check-layers.sh <image> [-a] |
列出镜像各层及大小 |
./test.sh <image> |
启动 FPM 容器做 HTTP / Composer / OpenSSL 冒烟测试 |
构建用的 apk 包在 Dockerfile 中按版本固定(musl-utils、zlib、libxml2、PHP 5/7 的 curl/wolfssl 等),alpine 仓库变动时构建会直接失败而不是静默升级。
PHPCompatibility
PHP CodeSniffer installed coding standards
phpcs/phpcs.sh使用目标目录或文件所在目录的 phpcs.xml,如果没有则使用phpcs目录的默认 phpcs.xml。默认 phpcs.xml 测试与php8.4的兼容性(忽略了mcrypt)。
命令行参数将覆盖 phpcs.xml 的设置。
cd phpcs
./phpcs.sh --usage
./phpcs.sh [-v|--volume list] [-p .]|<-p path/to/php-dir-or-file> [PHP CodeSniffer options]或
docker run --rm -it -v .:/www/ moremay/php:cs需要其它库、需要编译时开启或需要注意的扩展:
| PHP ext | Libs | configure |
|---|---|---|
| bcmatch | --enable-bcmath | |
| bz2 | bzip2-dev -or- libbz2-dev | --with-bz2 |
| calendar | --enable-calendar | |
| curl [1] [4] | curl libcurl3-gnutls [5] curl-dev -or- libcurl4-openssl-dev |
--with-curl[=DIR] |
| dba | detail | detail |
| dom | libxml | |
| enchant | Enchant + Glib | --with-enchant[=dir] |
| libenchant.dll glib-2.dll gmodule-2.dll | ||
| exif | --enable-exif | |
| after mbstring | php_mbstring.dll ... php_exif.dll |
|
| fileinfo | php_fileinfo.dll | |
| ftp [1] | --enable-ftp | |
| gd | --with-gd[=DIR] | |
| gd:avif | libavif-dev | >=8.1--with-avif[=DIR] |
| gd:freetype | freetype-dev -or- libfreetype-dev | <7.4 --with-freetype-dir[=DIR] >=7.4 --with-freetype[=DIR] --- <7.2 string function [--enable-gd-native-ttf] Type 1 fonts [--with-t1lib[=DIR]] --- |
| gd:jpeg | libjpeg62-turbo-dev -or- libjpeg-dev | <7.4 --with-jpeg-dir[=DIR] >=7.4 --with-jpeg[=DIR] |
| gd:png | zlib libpng-dev | <7.4 [--with-zlib-dir[=DIR]] --with-png-dir[=DIR] >=7.4 存在 libpng 和 zlib 即可 |
| gd:webp | libvpx-dev (>=7)libwebp-dev | <7 --with-vpx-dir[=DIR] >=7 --with-webp-dir[=DIR] >=7.4 --with-webp[=DIR] |
| gd:xpm | libxpm-dev | <7.4 --with-xpm-dir[=DIR] >=7.4 --with-xpm[=DIR] |
| gettext | gettext-dev* | --with-gettext[=DIR] |
| gmp | gmp-dev -or- libgmp-dev | --with-gmp |
| iconv [3] | gnu-libiconv-dev [5] | --with-iconv=DIR |
| imap [4] | detail | --with-imap[=DIR] [--with-imap-ssl[=DIR] | --with-kerberos[=DIR]] |
| intl | icu-dev | --enable-intl |
| ldap [4] | OpenLDAP | --with-ldap[=DIR] [--with-ldap-sasl[=DIR]] |
| libxml [3] | libxml2-dev | --with-libxml-dir=DIR |
| mbstring [1] | libmbfl [5] | --enable-mbstring <7.3 可指定 libmbfl: --with-libmbfl[=DIR] |
| 多字节 oniguruma-dev -or- libonig-dev | <7.4 可指定 onig: --with-onig[=DIR] | |
| mcrypt | libmcrypt-dev libltdl-dev | >=7.2 移至 PECL 库。使用 Sodium/OpenSSL |
| mysql | see myqli | 5.5 废弃, 7.0 移除 --with-mysql[=DIR] |
| mysqli [6] | mysqlnd -or- libmysqlclient-dev -or- libmariadbclient-dev-compat | --with-mysqli[=DIR] 对于 mysqlnd,5.3必须使用=mysqlnd,高版本是默认值。 |
| mysqlnd [1] | >=5.3 开始支持 | --enable-mysqlnd |
| oci8 | detail oracle | detail |
| odbc | detail | |
| openssl [1] | openssl-dev | --with-openssl[=DIR] 5.3 <1.1 7.0 >=0.9.8 7.1~8.0 [1.0.1, 3.0) 8.1 [1.0.2, 4.0) |
| pcntl [2] [7] | --enable-pcntl | |
| pcre [3] | --with-pcre-regex=DIR >=7.0.12 [--without-pcre-jit] |
|
| pdo | php_pdo.dll必须先于具体数据库加载。 | |
| pdo_dblib | MSSQL & Sybase | 移至 PECL 库 |
| pdo_firebird | Firebird / InterBase | --with-pdo-firebird[=DIR] 7.4 移至 PECL 库 |
| pdo_mysql | see mysqli | --with-pdo-mysql[=DIR] |
| pdo_oci | detail Oracle | --with-pdo-oci=instantclient,prefix,version | --with-pdo-oci[=DIR] default: $ORACLE_HOME PECL 也包含。 |
| pdo_odbc | detail | |
| pdo_pgsql | PostgreSQL | --with-pdo-pgsql[=DIR] |
| pdo_sqlite [3] | libsqlite | --with-pdo-sqlite=DIR |
| pgsql | PostgreSQL | --with-pgsql[=DIR] |
| phar | zlib bzip2 openssl | |
| posix | 不支持 Windows | |
| pspell | aspell | --with-pspell[=dir] |
| aspell-15.dll | aspell >= 0.5 | |
| readline [1] [8] | readline-dev -or- libreadline-dev | --with-readline[=DIR] |
| libedit-dev | --with-libedit[=DIR] | |
| recode | detail | --with-recode[=DIR] 7.4 移至 PECL 库 |
| shmop [2] | --enable-shmop | |
| simplexml | libxml | |
| snmp | Net-SNMP | |
| soap | libxml | --enable-soap |
| sockets | --enable-sockets | |
| sodium | libsodium | >=7.2 |
| sqlite3 | libsqlite | |
| sysvmsg [2] | --enable-sysvmsg | |
| sysvsem [2] | --enable-sysvsem | |
| sysvshm [2] | --enable-sysvshm | |
| tidy | tidyhtml-dev -or- libtidy-dev -or- libtidy5-dev -or- libtidyp-dev | --with-tidy |
| wddx | libxml expat | --enable-wddx [--with-libexpat-dir] 7.4 移至 PECL 库 |
| xml | libxml | |
| xmlreader | libxml | |
| xmlrpc | libxml | --with-xmlrpc[=DIR] |
| xmlwriter | libxml | |
| xsl | libxml libxslt-dev libxslt1-dev | --with-xsl[=DIR] |
| zip | libzip | <7.4 --enable-zip 7.4 --with-zip [--with-libzip=DIR] 所有版本可用 PECL |
| zlib [1] | zlib-dev -or- zlib1g-dev | --with-zlib[=DIR] |
- 需要/推荐与 PHP 一起编译。
- 一般不推荐用于 Web。
- PHP 编译时默认激活,但可以配置所需库的路径。
- Windows 需要 OpenSSL:libeay32.dll libssh2.dll ssleay32.dll。如果是 OpenSSL 1.1 及以上需要: libcrypto-*.dll libssl-*.dll。
- 系统中可能已经存在(相似)库。
- MySQL 8 需要设置 my.cnf:
default_authentication_plugin=mysql_native_password。 - pcntl 建议只用于 CLI。仅 Unix 支持。
- readline 用于 CGI / CLI。Windows 从 PHP 7.1 开始默认启用。