PHPDocker.io 基础镜像

镜像概述和主要用途

PHPDocker.io 基础镜像是用于 PHPDocker.io 生成环境的基础镜像仓库，提供当前受支持 PHP 版本的容器镜像。镜像每日构建（通过 GitHub Actions 工作流），以获取最新的基础镜像变更及可用 PHP 版本更新。

核心功能和特性

支持的架构

• linux/amd64
• linux/arm64
• linux/arm/v7

OS 基础镜像与 PHP 包源

所有镜像均使用 Ubuntu LTS 版本作为基础镜像（PHP 5.6 除外，使用 Debian Jessie）。对于这些基础 OS 镜像，PHP 包来源于第三方源 Ondřej Surý（Debian *** PHP 维护者，Ubuntu 中所有 PHP 包的源头）。

多数情况下，会用 Ondřej 的 PHP 包覆盖 Ubuntu 原生包，以确保始终获取最新版本。例如，Ubuntu 20.04 原生包含 PHP 7.4.3，但仍会安装 Ondřej 的包，确保每次都能获取 PHP 7.4 的最新版本。Ubuntu 仅回溯安全修复，不一定包含后续补丁版本的 bug 修复。

镜像类型

针对每个 PHP 次要版本（MAJOR.MINOR），提供 cli 和 fpm 两种变体。两者除 fpm 变体包含 php-fpm 且默认命令为 php-fpm 外，其余完全一致。

镜像未定义 ENTRYPOINT，而是定义了 CMD，以便用户自定义 entrypoint 在运行 CMD 前执行前置操作。

关于 swoole 变体的说明

部分镜像曾提供 swoole 变体，现已逐步淘汰。早期因无法通过 apt 可靠安装该扩展，需从源码编译；目前 swoole 已作为 apt 包可用，用户可直接安装。

内置 PHP 扩展

包含以下基础扩展，满足现代 PHP 应用需求（如 composer、symfony/* 库等依赖）：

• apcu & apcu-bc
• curl
• json（8.0 起为 PHP 核心组件）
• mbstring
• opcache
• readline
• xml
• zip

Composer

所有镜像默认使用 Composer v2。若需回退至 v1，可在 Dockerfile 中添加：

Dockerfile
COPY --from=composer:1 /usr/bin/composer /usr/bin/composer

使用场景和适用范围

适用于需要运行 PHP 应用的场景：

• cli 变体：用于命令行 PHP 应用（如脚本执行、定时任务等）。
• fpm 变体：用于 Web 应用，配合 Nginx 等 Web 服务器处理 PHP 请求。

注意：不建议在生产环境使用任何已停止支持的镜像（详见下文“可用镜像”表格说明）。

详细使用方法和配置说明

镜像拉取与运行示例

CLI 镜像

运行 PHP 命令（如查看版本）：

bash
docker run --rm phpdockerio/php:8.2-cli php -v

FPM 镜像

后台运行 PHP-FPM：

bash
docker run -d phpdockerio/php:8.2-fpm

自定义 Entrypoint

因镜像未定义 ENTRYPOINT，可自定义 entrypoint 执行前置操作后运行 CMD：

bash
docker run --rm --entrypoint "/bin/sh" phpdockerio/php:8.2-cli -c "echo '执行前置操作'; php-fpm"

可用镜像

注意事项

• 已停止支持（EOL）的 PHP 版本不受***支持，但部分仍每日构建以获取基础 OS 包的更新。
• 若基础 OS 已 EOL（如 Debian Jessie），对应 PHP 镜像的每日构建将停止；若基础 OS 未 EOL，即使 PHP 已 EOL，仍会每日构建（基础 OS 仍提供安全更新，包括 PHP 运行时）。
• 不建议在生产环境使用任何不受支持的镜像，持续构建仅为无法及时升级的遗留应用提供临时支持。
• 旧镜像保留在 Docker Hub 以支持遗留应用，但 Docker 会删除 6 个月未访问的镜像，删除后不提供恢复，用户需升级版本。