dwchiang/nginx-php-fpm

dwchiang/nginx-php-fpm

镜像概述和主要用途

dwchiang/nginx-php-fpm是一个合并了nginx与php-fpm的Docker镜像，基于Debian/Alpine系统构建，专为现代PHP应用、云原生设计打造，适用于AWS Fargate、Amazon ECS/EKS等云平台，同时支持amd64/arm64架构（如AWS Graviton）。该镜像由AWS Community Hero Ernest Chiang与Irvine Chang共同开发，旨在简化Laravel框架及其他PHP应用的云原生部署流程。

核心功能和特性

关键指标

• Docker镜像版本：!Docker Image Version (latest semver)
• 许可证：!GitHub
• Docker拉取量：!Docker Pulls
• Docker星标：!Docker Stars
• GitHub星标：!GitHub Repo stars
• GitHub分支：!GitHub forks

核心特性

• 多架构支持：amd64、arm64
• 多PHP版本支持：8.4、8.3、8.2、8.1、8.0、7.4、7.3、7.2
• 多OS版本支持：bookworm、bullseye、buster、alpine3.20至alpine3.13（基于PHP和Nginx官方镜像的OS版本）
• 多Nginx版本支持：1.27.1、1.27.0、1.26.2、1.26.0、1.25.4、1.25.3、1.25.2、1.24.0、1.22.1、1.21.6、1.21.1、1.20.2、1.20.1
• 进程管理：使用supervisord管理nginx和php-fpm进程
• 最小化扩展：默认加载最小化PHP扩展，便于按需扩展
• 入口脚本：支持在/docker-entrypoint.d/目录中运行自定义脚本
• 性能优化：针对云原生环境优化，提供多版本性能对比报告

使用场景和适用范围

• Laravel框架部署：专为Laravel应用的现代化云原生部署设计
• PHP应用现代化：适用于各类PHP应用的容器化改造，支持从PHP 7.2到8.4的多版本兼容
• 云平台部署：完美适配AWS Fargate、Amazon ECS/EKS等云服务，支持Graviton（arm64）架构
• 多环境兼容：可在本地开发环境、私有云或公有云平台中一致运行
• 性能敏感场景：提供详细性能分析报告，帮助优化高并发PHP应用

详细使用方法和配置说明

快速参考

性能分析报告

• Laravel PHP8/PHP7 Debian/Alpine容器性能对比
  测试页面：默认首页（数值越高越好）

• nginx-php-fpm PHP性能测试（2024Q3）- PHP8/PHP7 Debian/Alpine
  预览：nginx-php-fpm的RPS（phpinfo）性能测试（数值越高越好）

• nginx-php-fpm PHP性能测试（2024Q1）- PHP8/PHP7 Debian/Alpine
  预览：nginx-php-fpm的RPS（phpinfo）性能测试（数值越高越好）

维护与支持

• 维护者：Ernest Chiang、Irvine Chang
• 问题反馈：https://github.com/dwchiang/nginx-php-fpm/issues
• 源码地址：https://github.com/dwchiang/nginx-php-fpm
• 镜像仓库：AWS ECR Public、https://hub.docker.com/r/dwchiang/nginx-php-fpm
• 性能测试文档：https://github.com/dwchiang/nginx-php-fpm/blob/master/docs/Benchmark.md
• 维护文档：https://github.com/dwchiang/nginx-php-fpm/blob/master/docs/Maintenance.md

支持的镜像标签

• 完整标签列表（含历史标签）：https://github.com/dwchiang/nginx-php-fpm/blob/master/docs/Tags.md
• 标签规则变更：2021年7月25日起调整标签命名规则，详情参见标签文档
• 版本维护策略：
  • 2023年4月27日起，仅维护每个PHP分支的最新版本
  • 2023年9月8日起，仅构建PHP、OS和Nginx组合的最近5个版本以减少存储占用

快速开始

创建如下Dockerfile，将应用代码复制到容器中：

dockerfile
FROM dwchiang/nginx-php-fpm:latest

COPY your_app /var/www/html/public

注意：应用可能需要安装额外PHP扩展，详见下文"第二部分：应用镜像"说明。

实践指南

• https://github.com/dwchiang/laravel-on-aws-ecs-workshops

镜像结构说明

该镜像采用"两部分分离"设计，便于灵活扩展：

第一部分：基础镜像

基础镜像合并了官方https://hub.docker.com/_/php%E5%92%8Chttps://hub.docker.com/_/nginx%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%EF%BC%9A

• 使用supervisord管理进程
• 预配置nginx基础配置

关键文件路径：

• 静态文件目录：/usr/share/nginx/html
• PHP应用目录：/var/www/html（入口文件建议放在/var/www/html/public）
• Nginx配置目录：/etc/nginx/conf.d/（可挂载自定义配置文件）
• Supervisor配置目录：/etc/supervisor/conf.d/（可添加自定义进程配置）
• 入口脚本目录：/docker-entrypoint.d/（存放启动时执行的脚本，需设置可执行权限）

基础镜像Dockerfile位置：

• Debian系列：Dockerfiles/buster等
• Alpine系列：Dockerfiles/alpine*

第二部分：应用镜像（自定义）

用户需基于基础镜像构建应用镜像，包含：

• 安装应用所需的PHP扩展
• 配置php.ini
• 复制应用代码

参考Dockerfile示例（项目中提供）：

• Laravel应用：Dockerfile-8.5.23-laravel-buster（Debian）、Dockerfile-8.5.23-laravel-alpine3.14（Alpine）等
• PHPInfo测试：Dockerfile-8.5.23-phpinfo-buster、Dockerfile-8.5.23-phpinfo-alpine3.14等

注：应用镜像需用户自行构建，项目不提供预构建的应用镜像。

许可协议

• 本镜像包含的软件许可信息：nginx、PHP、https://github.com/laravel/laravel
• 基础镜像可能包含其他软件，其许可信息可参考：
  • https://github.com/docker-library/repo-info/tree/master/repos/nginx
  • https://github.com/docker-library/repo-info/tree/master/repos/php
• 使用本镜像需确保遵守所有包含软件的许可协议。

Star历史

![Star History Chart]([***]