Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Docker Images for PHP

PHP-FPM

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 -S content-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)的首字符
  • 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/libcrypto3 3.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 后重新生成各版本 Dockerfile

check-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

PHPCompatibility PHPCompatibility Current Version 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

Extensions

需要其它库、需要编译时开启或需要注意的扩展:

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]]
---
JIS-mapped Japanese font [--enable-gd-jis-conv]
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]
  1. 需要/推荐与 PHP 一起编译。
  2. 一般不推荐用于 Web。
  3. PHP 编译时默认激活,但可以配置所需库的路径。
  4. Windows 需要 OpenSSL:libeay32.dll libssh2.dll ssleay32.dll。如果是 OpenSSL 1.1 及以上需要: libcrypto-*.dll libssl-*.dll。
  5. 系统中可能已经存在(相似)库。
  6. MySQL 8 需要设置 my.cnf: default_authentication_plugin=mysql_native_password。
  7. pcntl 建议只用于 CLI。仅 Unix 支持。
  8. readline 用于 CGI / CLI。Windows 从 PHP 7.1 开始默认启用。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages