wayofdev/php-base

PHP 基础 Docker 镜像

docker-php-base 项目是一个用于创建和维护 PHP Docker 镜像的系统。它使用 Ansible 生成多个 PHP 版本（7.4、8.0、8.1、8.2、8.3、8.4）和类型（CLI、FPM、Supervisord）的 Dockerfile，基于 Alpine Linux 构建。该项目通过 GitHub Actions 实现自动化构建流程，创建支持 AMD64 和 ARM64 的多架构镜像，并使用 https://github.com/goss-org/goss 进行测试。镜像预装多种 PHP 扩展，设计为 PHP 应用在开发和生产环境中的基础镜像。

🚀 核心功能与特性

• 多 PHP 版本支持：兼容 PHP 7.4、8.0、8.1、8.2、8.3 和 8.4。
• 多种运行类型：提供 CLI、FPM 和 Supervisord 三种配置。
• 轻量级 Alpine 基础：基于 Alpine Linux 构建，镜像体积更小。
• 丰富预装扩展：内置多种常用 PHP 扩展，满足大多数应用需求。
• 可定制配置：PHP 和 OPcache 设置可轻松调整。
• 多架构支持：同时支持 AMD64 和 ARM64 架构。
• 自动化 CI/CD：利用 GitHub Actions 实现持续集成和交付。
• 全面测试：使用 dgoss 进行 Docker 镜像的 thorough 测试。
• Ansible 驱动的 Dockerfile 生成：通过 Ansible 实现灵活且可维护的 Dockerfile 生成。
• 安全聚焦：包含 Docker Scout 扫描以检查漏洞。

🛠 技术栈

• Ansible：用于生成 Dockerfile 和配置文件。
• Docker：容器化基础技术。
• GitHub Actions：自动化构建、测试和发布的 CI/CD 流水线。
• dgoss：Docker 镜像测试工具。
• Alpine Linux：镜像的基础操作系统。
• PHP：核心语言，支持 7.4、8.0、8.1、8.2、8.3、8.4 版本。

📦 预装 PHP 扩展

镜像内置多种 PHP 扩展，如下表所示：

🚀 使用方法

PHP 基础镜像可从 Docker Hub 和 GitHub Container Registry 获取。

拉取镜像

Docker Hub

bash
docker pull wayofdev/php-base:8.3-fpm-alpine-latest

GitHub Container Registry

bash
docker pull ghcr.io/wayofdev/docker-php-base:8.3-fpm-alpine-latest

将 8.3-fpm-alpine-latest 替换为所需的 PHP 版本、类型和标签。

可用镜像变体

镜像支持以下组合：

• PHP 版本：8.1、8.2、8.3、8.4
• 类型：cli、fpm、supervisord
• 架构：amd64、arm64

示例

bash
# PHP 8.1 CLI
docker pull wayofdev/php-base:8.1-cli-alpine-latest

# PHP 8.2 FPM
docker pull wayofdev/php-base:8.2-fpm-alpine-latest

# PHP 8.3 Supervisord
docker pull wayofdev/php-base:8.3-supervisord-alpine-latest

完整标签列表可参考 https://hub.docker.com/r/wayofdev/php-base/tags 或 https://github.com/wayofdev/docker-php-base/pkgs/container/docker-php-base%E3%80%82

在 Dockerfile 中使用

将此镜像作为基础构建自定义镜像：

dockerfile
# 从 Docker Hub
FROM wayofdev/php-base:8.3-fpm-alpine-latest

# 或从 GitHub Container Registry
# FROM ghcr.io/wayofdev/docker-php-base:8.3-fpm-alpine-latest

# 此处添加自定义 Dockerfile 指令
# ...

🔨 开发指南

项目使用一系列工具进行开发和测试，Makefile 提供了简化开发流程的命令。

环境要求

• Docker
• Make
• Ansible
• goss 和 dgoss（用于测试）

搭建开发环境

克隆仓库：

bash
git clone git@github.com:wayofdev/docker-php-base.git && \
cd docker-php-base

生成 Dockerfile

使用 Ansible 从 Jinja 模板生成可分发的 Dockerfile：

bash
make generate

构建镜像

• 构建默认镜像：

  bash
  make build
  

  默认构建 Makefile 中 IMAGE_TEMPLATE 变量指定的镜像（默认值为 8.3-fpm-alpine）。

• 构建特定镜像：

  bash
  make build IMAGE_TEMPLATE="8.3-fpm-alpine"
  

  将 8.3-fpm-alpine 替换为所需的 PHP 版本、类型和操作系统。

• 构建所有镜像：

  bash
  make build IMAGE_TEMPLATE="8.1-cli-alpine"
  make build IMAGE_TEMPLATE="8.1-fpm-alpine"
  make build IMAGE_TEMPLATE="8.1-supervisord-alpine"
  make build IMAGE_TEMPLATE="8.2-cli-alpine"
  make build IMAGE_TEMPLATE="8.2-fpm-alpine"
  make build IMAGE_TEMPLATE="8.2-supervisord-alpine"
  make build IMAGE_TEMPLATE="8.3-cli-alpine"
  make build IMAGE_TEMPLATE="8.3-fpm-alpine"
  make build IMAGE_TEMPLATE="8.3-supervisord-alpine"
  make build IMAGE_TEMPLATE="8.4-cli-alpine"
  make build IMAGE_TEMPLATE="8.4-fpm-alpine"
  make build IMAGE_TEMPLATE="8.4-supervisord-alpine"
  

🔧 配置说明

项目使用 Ansible 生成 Dockerfile 和配置。可通过修改 src/group_vars/base.yml 文件调整 PHP 扩展和设置。

PHP .ini 默认设置

在 group_vars/base.yml 中可调整以下 PHP 和 OPcache 设置：

yaml
settings_opcache_ini:
  php_opcache_enable: 1
  php_opcache_enable_cli: 1

settings_php_ini:
  php_timezone: "UTC"
  php_post_max_size: "16M"
  php_memory_limit: "256M"

PHP 扩展配置

通过修改 group_vars/base.yml 中的扩展列表启用或禁用 PHP 扩展：

yaml
ext_native_enabled:
  - intl
  - pcntl
  - sockets
  - pdo_mysql
  - pdo_pgsql
  - OPcache
  - zip
  - bcmath
  - exif
  - gd

ext_pecl_enabled:
  - redis
  - memcached
  - decimal
  - amqp
  - yaml
  - grpc
  - protobuf

添加扩展到列表或从列表中移除即可。修改后需重新生成 Dockerfile：

bash
make generate

🧪 测试

项目使用 https://github.com/aelsabbahy/goss/tree/master/extras/dgoss 测试 Docker 镜像。

运行测试

• 测试默认镜像：

  bash
  make test
  

  测试 IMAGE_TEMPLATE 变量指定的镜像（默认 8.3-fpm-alpine）。

• 测试特定镜像：

  bash
  make test IMAGE_TEMPLATE="8.3-fpm-alpine"
  

  将 8.3-fpm-alpine 替换为目标镜像。

• 测试所有镜像：

  bash
  make test IMAGE_TEMPLATE="8.1-cli-alpine"
  make test IMAGE_TEMPLATE="8.1-fpm-alpine"
  make test IMAGE_TEMPLATE="8.1-supervisord-alpine"
  make test IMAGE_TEMPLATE="8.2-cli-alpine"
  make test IMAGE_TEMPLATE="8.2-fpm-alpine"
  make test IMAGE_TEMPLATE="8.2-supervisord-alpine"
  make test IMAGE_TEMPLATE="8.3-cli-alpine"
  make test IMAGE_TEMPLATE="8.3-fpm-alpine"
  make test IMAGE_TEMPLATE="8.3-supervisord-alpine"
  make test IMAGE_TEMPLATE="8.4-cli-alpine"
  make test IMAGE_TEMPLATE="8.4-fpm-alpine"
  make test IMAGE_TEMPLATE="8.4-supervisord-alpine"
  

测试配置

测试配置通过为每个镜像变体生成的 goss.yaml 文件定义，包括：

• 文件存在性和权限检查
• 进程检查
• 端口可用性
• 包安装验证
• 命令输出检查
• PHP 扩展可用性验证

测试流程

运行 make test 时执行以下步骤：

1. 构建指定 Docker 镜像（若未构建）。
2. dgoss 对容器运行 goss.yaml 中定义的测试。
3. 控制台显示测试结果。

🔒 安全策略

项目有专门的https://github.com/wayofdev/docker-php-base/blob/master/.github/SECURITY.md%E3%80%82

🙌 贡献指南

感谢考虑为 wayofdev 社区贡献！我们欢迎各种形式的贡献：

• 🤔 https://github.com/wayofdev/docker-php-base/issues/new?assignees=&labels=type%3A+enhancement&projects=&template=2-feature-request.yml&title=%5BFeature%5D%3A+
• 🐛 https://github.com/wayofdev/docker-php-base/issues/new?assignees=&labels=type%3A+documentation%2Ctype%3A+maintenance&projects=&template=1-bug-report.yml&title=%5BBug%5D%3A+
• 📖 https://github.com/wayofdev/docker-php-base/issues/new?assignees=&labels=type%3A+documentation%2Ctype%3A+maintenance&projects=&template=4-docs-bug-report.yml&title=%5BDocs%5D%3A+
• 👨‍💻 https://github.com/wayofdev/docker-php-base/blob/master/.github/CONTRIBUTING.md

贡献前请查阅贡献指南。