justintime50/nginx-php

Nginx/PHP-FPM Docker镜像

一个轻量级、生产就绪的Nginx/PHP-FPM组合Docker镜像。

!https://github.com/Justintime50/nginx-php-docker/workflows/build/badge.svg !https://img.shields.io/docker/image-size/justintime50/nginx-php !https://img.shields.io/docker/pulls/justintime50/nginx-php !https://img.shields.io/github/license/justintime50/nginx-php-docker

核心功能和特性

以下功能无需任何配置即可开箱即用：

• bcmatch已安装，用于数学/货币功能
• composer已安装，用于管理PHP依赖
• gd已安装，用于图像处理
• intl已安装，提供国际化和本地化支持
• msmtp已安装并配置（见config/msmtprc），默认可发送邮件至Mailtrap
  • 日志位于/var/log/msmtp.log
• mysql_pdo已安装，作为数据库连接驱动
• Nginx作为Web服务器和反向代理
  • 日志位于/var/log/nginx/
• npm和node已安装，用于Node依赖管理和脚本运行
• PHP-FPM/OPcache提供浏览器和CLI环境下的高性能
• Redis扩展已安装，用于缓存
• supervisord已安装，用于进程管理（从镜像版本32开始）
  • 默认启动php-fpm和nginx
  • 额外的supervisord配置文件可放置于/etc/supervisord/conf.d/*.conf
  • 日志位于/var/log/supervisord.log
• zip已安装，支持需要压缩功能的场景（如Laravel、CSV/Excel处理）

平台支持

从镜像版本8开始，支持以下架构：

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

安装

dockerfile
# Dockerfile
FROM docker.xuanyuan.run/justintime50/nginx-php:latest

# docker-compose
image: docker.xuanyuan.run/justintime50/nginx-php:latest

使用方法

sh
docker compose up -d

容器启动后，在浏览器中访问http://localhost:8888。

原生PHP和HTML

将PHP或HTML网站文件放入容器内的/var/www/html/public目录即可开始使用。可通过docker-compose的卷挂载或Dockerfile的复制命令实现。若使用HTML而非PHP，需移除index.php文件，使index.html优先加载。

Laravel框架

将Laravel项目根目录挂载至容器的/var/www/html，确保Laravel的public目录与Nginx的服务目录对应。

Docker标签说明

镜像标签格式为PHP_VERSION-IMAGE_VERSION，例如8.2-16表示使用PHP 8.2版本和第16版镜像（包含Nginx配置、Dockerfile等）。

PHP版本支持

• 8.4 - 使用PHP 8.4 Alpine最新版本（从镜像版本21开始支持）
• 8.3 - 使用PHP 8.3 Alpine最新版本（从镜像版本18开始支持）
• 8.2 - 使用PHP 8.2 Alpine最新版本（从镜像版本12开始支持）
• 8.1 - 使用PHP 8.1 Alpine最新版本（从镜像版本9开始支持）
• 8.0 - 已弃用 使用PHP 8.0 Alpine最新版本（镜像版本19起停止支持）
• 7.4 - 已弃用 使用PHP 7.4 Alpine最新版本（镜像版本19起停止支持）

独立标签

• latest - 使用镜像的最新发布版（主分支），包含所有默认配置
• dev - 镜像的测试分支，请勿用于生产环境

开发相关

注意：Alpine Linux不保留旧版本软件包。本镜像固定主版本号以保持灵活性，未来构建可能需根据软件包可用性调整。

sh
# 测试Nginx配置
nginx -T

发布流程

发布时，创建新的GitHub标签/发布版本，使用整数递增（如4、5、6等）。为简化标签管理，不使用语义化版本。

添加新PHP版本时，需更新GitHub Workflow文件中的版本列表。

构建新版本

本镜像支持通过官方PHP-FPM Alpinehttps://hub.docker.com/_/php%E4%B8%AD%E7%9A%84%E7%89%88%E6%9C%AC%E5%8F%B7%E6%9B%BF%E6%8D%A2PHP%E7%89%88%E6%9C%AC%E3%80%82

自动构建

GitHub Actions在每次新发布时自动构建并推送支持的标签至Docker Hub；对主分支的任何推送会自动构建latest标签。强烈建议使用版本化标签，避免latest标签可能引入的变更。

手动构建

sh
docker build -t justintime50/nginx-php:8.0-7 --build-arg PHP_VERSION=8.0 .

sudo docker push justintime50/nginx-php:8.0-7

msmtp（邮件客户端）

msmtp默认配置支持Mailtrap，生产环境可取消注释并使用Gmail模板。启动容器后，可通过以下命令测试邮件发送：

sh
# 直接使用msmtp发送邮件
echo -e "Subject: Test email from msmtp\r\n\r\nThis is a test email direct from msmtp" |msmtp --debug --from *** -t ***

# 通过PHP发送邮件（路由至msmtp）
php -r "mail('***','Test email from PHP', 'This is a test email from PHP');"