dwchiang/nginx-php-fpm
dwchiang
基于nginx-php-fpm的云原生Laravel/PHP应用镜像，支持PHP 8.4至7.x版本，适配amd64/arm64架构及Debian/Alpine系统，适用于现代应用和云原生部署。
30 次收藏下载次数: 0状态：社区镜像维护者：dwchiang仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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，将应用代码复制到容器中：
dockerfileFROM 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历史
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"