Repolode
TrafeX

TrafeX/docker-php-nginx

基于 Alpine Linux 的小型 Docker 镜像,开箱即用地同时运行 PHP-FPM 8.5 与 Nginx。

Star
1,529
Fork
759
未关闭 Issue
2
最近提交
7天前

这是什么?

这是一个 Docker 镜像项目,将 PHP-FPM 8.5 与 Nginx 1.28 打包在 Alpine Linux 上,无需自行搭建 Web 服务器环境即可运行 PHP 应用。只需将代码挂载到 /var/www/html,即可直接提供服务;Nginx、PHP 和 PHP-FPM 的配置文件也可以通过挂载文件进行覆盖。

镜像体积约 40MB,支持 AMD64、ARMv6、ARMv7 和 ARM64 多个平台。PHP-FPM 采用按需启动(on-demand)的进程管理方式,只在有流量时占用资源。Nginx、PHP-FPM 和 supervisord 均以非特权用户 nobody 运行,所有服务的日志会输出到容器标准输出,可通过 docker logs 查看。

项目的定位是一个易读的示例,展示如何在容器中正确运行 Nginx 与 PHP-FPM,便于按需修改。仓库中提供了添加 Xdebug、Composer、负载均衡后获取真实客户端 IP,以及发送邮件等配置说明。

核心功能

  • 01基于 Alpine Linux 运行 PHP-FPM 8.5 与 Nginx 1.28,镜像约 40MB。
  • 02支持 AMD64、ARMv6、ARMv7 和 ARM64 平台。
  • 03PHP-FPM 按需启动进程,仅在有流量时占用资源。
  • 04Nginx、PHP-FPM 和 supervisord 以非特权用户 nobody 运行。
  • 05所有服务日志输出到容器标准输出,便于用 docker logs 查看。
  • 06可通过挂载配置文件覆盖 Nginx、PHP 和 PHP-FPM 的设置。

适用场景

  • 在容器中部署 PHP 应用,无需自建 Web 服务器镜像。
  • 在 Raspberry Pi 等低功耗 ARM 设备上运行 PHP 网站。
  • 以精简的 PHP 基础镜像为起点,定制自己的 Docker 环境。
  • 学习 Nginx 与 PHP-FPM 在容器中的配合方式。

快速上手

  1. 1

    使用 Docker 启动容器

    docker run -p 80:8080 trafex/php-nginx
  2. 2

    挂载你自己的代码,由 PHP-FPM 和 Nginx 提供服务

    docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx

使用前须知

  • 该镜像是一个极简示例,仅针对 Alpine 提供的 PHP 8.5 和 Nginx 1.28 软件包进行配置。
  • 如需自定义配置,需要将你自己的配置文件挂载到容器中。

标签

常见问题

docker-php-nginx 是什么?
基于 Alpine Linux 的小型 Docker 镜像,开箱即用地同时运行 PHP-FPM 8.5 与 Nginx。 这是一个 Docker 镜像项目,将 PHP-FPM 8.5 与 Nginx 1.28 打包在 Alpine Linux 上,无需自行搭建 Web 服务器环境即可运行 PHP 应用。只需将代码挂载到 /var/www/html,即可直接提供服务;Nginx、PHP 和 PHP-FPM 的配置文件也可以通过挂载文件进行覆盖。
docker-php-nginx 可以免费使用吗?用的什么许可证?
docker-php-nginx 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
docker-php-nginx 还在维护吗?
活跃维护中。docker-php-nginx 最近一次提交是在 2026年10月31日。
docker-php-nginx 适合用来做什么?
在容器中部署 PHP 应用,无需自建 Web 服务器镜像。 在 Raspberry Pi 等低功耗 ARM 设备上运行 PHP 网站。 以精简的 PHP 基础镜像为起点,定制自己的 Docker 环境。 学习 Nginx 与 PHP-FPM 在容器中的配合方式。
docker-php-nginx 怎么安装和运行?
使用 Docker 启动容器: docker run -p 80:8080 trafex/php-nginx 挂载你自己的代码,由 PHP-FPM 和 Nginx 提供服务: docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx
在哪里获取 docker-php-nginx?
源代码和安装说明在 GitHub 上:https://github.com/TrafeX/docker-php-nginx

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目