PHP Docker Images — era-cloud/php

基于 Docker 官方 php 镜像 构建的增强镜像，内置 swoole / swow / thread（ZTS + swoole 线程模式） 及 redis 增强（igbinary/msgpack/lz4/zstd），扩展安装全面采用 PIE（PECL 已弃用并下线）。

提供 ghcr.io 与国内 Aliyun ACR 双镜像源。

镜像源

# ghcr.io
docker pull ghcr.io/era-cloud/php:8.5-swoole

# 国内 Aliyun ACR
docker pull crpi-ae6l51vlbqurnd6c.cn-chengdu.personal.cr.aliyuncs.com/eracloud/php:8.5-swoole

版本矩阵

PHP	cli	zts	swoole	swow	thread
8.5 (8.5.9)	✅	✅	✅	✅	✅
8.4 (8.4.24)	✅	✅	✅	✅	✅
8.3 (8.3.33)	✅	✅	✅	✅	✅
8.2 (8.2.33)	✅	✅	✅	✅	✅

每个版本支持发行版：trixie / bookworm / alpine3.24 / alpine3.23（共 80 个变体）。

变体说明：

• cli — 标准 CLI（默认）
• zts — PHP 线程安全（ZTS）
• swoole — 内置 Swoole 扩展
• swow — 内置 Swow 扩展
• thread — ZTS PHP + Swoole 线程模式（--enable-swoole-thread，单进程多线程）

镜像 Tag 矩阵

镜像大小与安全扫描（CRITICAL/HIGH）由 CI 自动更新（每次推送快照 + 每 8 小时安全扫描）。

cli

tag	PHP	发行版	构建时间	镜像大小	拉取大小	安全扫描 CRITICAL/HIGH
latest	8.5	trixie	2026-08-28T08:18:56Z	507.2 MB	161.9 MB	13/39
8.5-cli-trixie	8.5	trixie	2026-08-28T08:18:56Z	507.2 MB	161.9 MB	13/39
8.5-cli-alpine3.24	8.5	alpine3.24	2026-08-28T08:07:31Z	89 MB	35.6 MB	0/0
8.5-cli-alpine3.23	8.5	alpine3.23	2026-08-28T08:09:42Z	88.9 MB	35.5 MB	0/0
8.5-cli-bookworm	8.5	bookworm	2026-08-28T08:07:19Z	501.7 MB	161.4 MB	15/59
8.4-cli-alpine3.24	8.4	alpine3.24	2026-08-28T08:18:17Z	79.7 MB	34.6 MB	0/0
8.4-cli-alpine3.23	8.4	alpine3.23	2026-08-28T08:30:08Z	79.6 MB	34.5 MB	0/0
8.4-cli-trixie	8.4	trixie	2026-08-28T08:15:26Z	493.4 MB	160 MB	13/39
8.4-cli-bookworm	8.4	bookworm	2026-08-28T08:18:17Z	487.8 MB	159.5 MB	15/59
8.3-cli-alpine3.24	8.3	alpine3.24	2026-08-28T08:15:43Z	77.1 MB	32.4 MB	0/0
8.3-cli-alpine3.23	8.3	alpine3.23	2026-08-28T08:24:15Z	77 MB	32.3 MB	0/0
8.3-cli-trixie	8.3	trixie	2026-08-28T08:06:39Z	488.1 MB	157.1 MB	13/39
8.3-cli-bookworm	8.3	bookworm	2026-08-28T08:27:25Z	482.5 MB	156.5 MB	15/59
8.2-cli-alpine3.24	8.2	alpine3.24	2026-08-28T08:42:50Z	74.6 MB	31.9 MB	0/0
8.2-cli-alpine3.23	8.2	alpine3.23	2026-08-28T08:38:55Z	74.5 MB	31.8 MB	0/0
8.2-cli-trixie	8.2	trixie	2026-08-28T08:28:25Z	484.5 MB	156.4 MB	13/39
8.2-cli-bookworm	8.2	bookworm	2026-08-28T08:35:43Z	478.9 MB	155.9 MB	15/59

zts

tag	PHP	发行版	构建时间	镜像大小	拉取大小	安全扫描 CRITICAL/HIGH
8.5-zts-alpine3.24	8.5	alpine3.24	2026-08-28T08:10:06Z	114.4 MB	41.3 MB	0/0
8.5-zts-alpine3.23	8.5	alpine3.23	2026-08-28T08:07:10Z	114.3 MB	41.2 MB	0/0
8.5-zts-trixie	8.5	trixie	2026-08-28T08:27:29Z	507.2 MB	162 MB	13/39
8.5-zts-bookworm	8.5	bookworm	2026-08-28T08:07:30Z	501.7 MB	161.4 MB	15/59
8.4-zts-alpine3.24	8.4	alpine3.24	2026-08-28T08:31:47Z	99 MB	39.4 MB	0/0
8.4-zts-alpine3.23	8.4	alpine3.23	2026-08-28T08:09:12Z	98.9 MB	39.3 MB	0/0
8.4-zts-trixie	8.4	trixie	2026-08-28T08:06:53Z	493.6 MB	160.1 MB	13/39
8.4-zts-bookworm	8.4	bookworm	2026-08-28T08:16:18Z	488 MB	159.5 MB	15/59
8.3-zts-alpine3.24	8.3	alpine3.24	2026-08-28T08:19:41Z	93.6 MB	36.4 MB	0/0
8.3-zts-alpine3.23	8.3	alpine3.23	2026-08-28T08:20:02Z	93.5 MB	36.3 MB	0/0
8.3-zts-trixie	8.3	trixie	2026-08-28T08:07:02Z	488.2 MB	157.2 MB	13/39
8.3-zts-bookworm	8.3	bookworm	2026-08-28T08:29:33Z	482.6 MB	156.6 MB	15/59
8.2-zts-alpine3.24	8.2	alpine3.24	2026-08-28T08:38:52Z	90 MB	35.8 MB	0/0
8.2-zts-alpine3.23	8.2	alpine3.23	2026-08-28T08:38:30Z	89.9 MB	35.7 MB	0/0
8.2-zts-trixie	8.2	trixie	2026-08-28T08:06:41Z	484.6 MB	156.5 MB	13/39
8.2-zts-bookworm	8.2	bookworm	2026-08-28T08:42:03Z	479 MB	156 MB	15/59

swoole

tag	PHP	发行版	构建时间	镜像大小	拉取大小	安全扫描 CRITICAL/HIGH
8.5-swoole-alpine3.24	8.5	alpine3.24	2026-08-28T08:26:54Z	116.2 MB	43.9 MB	0/0
8.5-swoole-alpine3.23	8.5	alpine3.23	2026-08-28T08:10:13Z	116 MB	43.8 MB	0/0
8.5-swoole-trixie	8.5	trixie	2026-08-28T08:11:04Z	538.8 MB	174.9 MB	13/41
8.5-swoole-bookworm	8.5	bookworm	2026-08-28T08:16:38Z	497 MB	160.5 MB	16/59
8.4-swoole-alpine3.24	8.4	alpine3.24	2026-08-28T08:22:59Z	106.7 MB	42.8 MB	0/0
8.4-swoole-alpine3.23	8.4	alpine3.23	2026-08-28T08:30:45Z	106.5 MB	42.7 MB	0/0
8.4-swoole-trixie	8.4	trixie	2026-08-28T08:35:17Z	529.2 MB	173.8 MB	13/41
8.4-swoole-bookworm	8.4	bookworm	2026-08-28T08:25:11Z	487.4 MB	159.5 MB	16/59
8.3-swoole-alpine3.24	8.3	alpine3.24	2026-08-28T08:31:28Z	103.9 MB	40.6 MB	0/0
8.3-swoole-alpine3.23	8.3	alpine3.23	2026-08-28T08:11:40Z	103.7 MB	40.5 MB	0/0
8.3-swoole-trixie	8.3	trixie	2026-08-28T08:28:13Z	526.4 MB	171.6 MB	13/41
8.3-swoole-bookworm	8.3	bookworm	2026-08-28T08:27:11Z	484.7 MB	157.3 MB	16/59
8.2-swoole-alpine3.24	8.2	alpine3.24	2026-08-28T08:49:14Z	101.3 MB	40.1 MB	0/0
8.2-swoole-alpine3.23	8.2	alpine3.23	2026-08-28T08:42:56Z	101.1 MB	39.9 MB	0/0
8.2-swoole-trixie	8.2	trixie	2026-08-28T08:09:17Z	523.9 MB	171 MB	13/41
8.2-swoole-bookworm	8.2	bookworm	2026-08-28T08:42:57Z	482.1 MB	156.7 MB	16/59

thread

tag	PHP	发行版	构建时间	镜像大小	拉取大小	安全扫描 CRITICAL/HIGH
8.5-thread-alpine3.24	8.5	alpine3.24	2026-08-28T08:38:26Z	116.5 MB	44.1 MB	0/0
8.5-thread-alpine3.23	8.5	alpine3.23	2026-08-28T08:21:52Z	116.3 MB	43.9 MB	0/0
8.5-thread-trixie	8.5	trixie	2026-08-28T08:10:51Z	539 MB	175 MB	13/41
8.5-thread-bookworm	8.5	bookworm	2026-08-28T08:10:17Z	497.3 MB	160.7 MB	16/59
8.4-thread-alpine3.24	8.4	alpine3.24	2026-08-28T08:19:33Z	107 MB	43 MB	0/0
8.4-thread-alpine3.23	8.4	alpine3.23	2026-08-28T08:41:02Z	106.8 MB	42.8 MB	0/0
8.4-thread-trixie	8.4	trixie	2026-08-28T08:19:05Z	529.5 MB	173.9 MB	13/41
8.4-thread-bookworm	8.4	bookworm	2026-08-28T08:30:14Z	487.7 MB	159.6 MB	16/59
8.3-thread-alpine3.24	8.3	alpine3.24	2026-08-28T08:32:25Z	104.2 MB	40.8 MB	0/0
8.3-thread-alpine3.23	8.3	alpine3.23	2026-08-28T08:37:07Z	104 MB	40.6 MB	0/0
8.3-thread-trixie	8.3	trixie	2026-08-28T08:19:40Z	526.8 MB	171.7 MB	13/41
8.3-thread-bookworm	8.3	bookworm	2026-08-28T08:29:48Z	485 MB	157.4 MB	16/59
8.2-thread-alpine3.24	8.2	alpine3.24	2026-08-28T08:41:37Z	101.7 MB	40.2 MB	0/0
8.2-thread-alpine3.23	8.2	alpine3.23	2026-08-28T08:41:11Z	101.5 MB	40.1 MB	0/0
8.2-thread-trixie	8.2	trixie	2026-08-28T08:39:52Z	524.2 MB	171.2 MB	13/41
8.2-thread-bookworm	8.2	bookworm	2026-08-28T08:41:51Z	482.4 MB	156.8 MB	16/59

swow

tag	PHP	发行版	构建时间	镜像大小	拉取大小	安全扫描 CRITICAL/HIGH
8.5-swow-alpine3.24	8.5	alpine3.24	2026-08-28T08:42:12Z	108.6 MB	43.2 MB	0/0
8.5-swow-alpine3.23	8.5	alpine3.23	2026-08-28T08:21:02Z	108.4 MB	43 MB	0/0
8.5-swow-trixie	8.5	trixie	2026-08-28T08:08:48Z	530.5 MB	173.9 MB	13/39
8.5-swow-bookworm	8.5	bookworm	2026-08-28T08:22:40Z	488.3 MB	159.6 MB	16/59
8.4-swow-alpine3.24	8.4	alpine3.24	2026-08-28T08:36:34Z	99.2 MB	42.1 MB	0/0
8.4-swow-alpine3.23	8.4	alpine3.23	2026-08-28T08:35:35Z	99 MB	42 MB	0/0
8.4-swow-trixie	8.4	trixie	2026-08-28T08:37:52Z	521.1 MB	172.9 MB	13/39
8.4-swow-bookworm	8.4	bookworm	2026-08-28T08:17:54Z	478.8 MB	158.5 MB	16/59
8.3-swow-alpine3.24	8.3	alpine3.24	2026-08-28T08:11:28Z	96.4 MB	39.9 MB	0/0
8.3-swow-alpine3.23	8.3	alpine3.23	2026-08-28T08:10:25Z	96.2 MB	39.8 MB	0/0
8.3-swow-trixie	8.3	trixie	2026-08-28T08:30:25Z	518.3 MB	170.7 MB	13/39
8.3-swow-bookworm	8.3	bookworm	2026-08-28T08:21:25Z	476 MB	156.3 MB	16/59
8.2-swow-alpine3.24	8.2	alpine3.24	2026-08-28T08:41:14Z	93.8 MB	39.3 MB	0/0
8.2-swow-alpine3.23	8.2	alpine3.23	2026-08-28T08:43:22Z	93.6 MB	39.2 MB	0/0
8.2-swow-trixie	8.2	trixie	2026-08-28T08:19:33Z	515.7 MB	170.1 MB	13/39
8.2-swow-bookworm	8.2	bookworm	2026-08-28T08:46:18Z	473.5 MB	155.7 MB	16/59

镜像标签规则

<php>[-<变体>][-<发行版>]

• 默认发行版省略：8.5、8.5-swoole
• 指定发行版：8.5-swoole-bookworm、8.5-cli-alpine3.24
• 完整版本号：8.5.9-swoole
• 阿里云镜像同规则：crpi-...aliyuncs.com/eracloud/php:8.5-swoole

快速开始

docker run

docker run --rm -it ghcr.io/era-cloud/php:8.5-swoole php -v
docker run --rm -it ghcr.io/era-cloud/php:8.5-swow php -m
docker run --rm -it ghcr.io/era-cloud/php:8.5-thread php --ri swoole

docker compose

compose.yml 包含应用服务（gateway / api，默认启动）与依赖服务（pgsql / redis / mysql / rabbit，需 --profile deps 启用）。

# 只启动应用（gateway + api）
docker compose up -d

# 应用 + 依赖（pgsql/redis/mysql/rabbit）
docker compose --profile deps up -d

# 只启动单个依赖
docker compose --profile deps up -d pgsql

# 查看调试日志
docker compose logs -f --tail 100

使用前先修改 deploy/.env（依赖服务环境变量）并准备 deploy/caddy/.env、deploy/caddy/Caddyfile。

配置

• deploy/.env — 依赖服务（pgsql/redis/mysql）的环境变量
• deploy/caddy/Caddyfile — gateway（Caddy）反向代理配置
• deploy/caddy/.env — gateway（Caddy）环境变量
• deploy/mysql/my.cnf、deploy/redis/redis.conf、deploy/rabbitmq/rabbitmq.conf — 依赖服务配置文件
• deploy/ 下 postgresql/、mysql/、redis/data/、rabbitmq/、runtime/、dist/ — 运行时数据/构建产物（compose 卷挂载）
• app-src 挂载 — api 服务将当前目录挂载到容器 /app-src，用于 hyperf/swoole 应用开发
• api 环境变量：
  • NODE — 节点名称（默认 dev）
  • XDEBUG_CONFIG — Xdebug 调试配置（client_host / start_with_request）
• 时区：容器内固定 Asia/Shanghai

特性

• 基于 Docker 官方 php 镜像构建，镜像体积小、安全、稳定
• swoole — 协程/常驻内存/高并发（8.5-thread 提供单进程多线程模式）
• swow — 协程引擎（ssl/curl/pdo-pgsql 默认启用）
• redis 增强 — igbinary/msgpack 序列化、lz4/zstd 压缩（Available serializers => php, json, igbinary, msgpack）
• 扩展安装全面采用 PIE（PECL 已移除）
• 内置 composer（含国内镜像源配置）
• 提供国内 Aliyun ACR 加速
• 镜像更新及时，不定期同步上游 Docker Official Image

构建

# 更新版本（抓取 php.net 最新版本）
./versions.sh

# 应用模板生成所有 Dockerfile
./apply-templates.sh

# 生成 stackbrew library（CI 用）
./generate-stackbrew-library.sh

• versions.json — 各版本/变体定义
• Dockerfile-linux.template — Dockerfile 模板（修改后运行 ./apply-templates.sh 重新生成）
• CI：Release（版本检查/同步）→ Build and Push（构建/测试/推送 ghcr + ACR）

维护者

• @长久同学
• @Era Cloud
• @Era Meta

fork 自 Docker "Official Image"

License

MIT