trafex/php-nginx

Docker PHP-FPM 8.4 & Nginx 1.26 on Alpine Linux

镜像概述和主要用途

基于Alpine Linux构建的Docker镜像，集成PHP-FPM 8.4和Nginx 1.26，旨在提供一个遵循最佳实践的示例容器，用于运行Nginx和PHP-FPM服务。该镜像设计简洁，易于理解和根据实际需求进行调整，适用于需要轻量级Web服务环境的场景。

项目仓库：https://github.com/TrafeX/docker-php-nginx

!Docker Pulls !nginx 1.26 !php 8.4 !License MIT

核心功能和特性

• 基于轻量级且安全的Alpine Linux发行版构建
• 多平台支持：AMD4、ARMv6、ARMv7、ARM64
• 极小的Docker镜像体积（约40MB）
• 使用PHP 8.4以获得最佳性能、低CPU占用和内存占用
• 优化支持100个并发用户（即限制并发请求处理PHP文件）
• 采用PHP-FPM的on-demand进程管理器，仅在有流量时使用资源
• Nginx、PHP-FPM和supervisord服务均以非特权用户（nobody）运行，增强安全性
• 所有服务日志重定向至Docker容器输出（可通过docker logs -f <容器名称>查看）
• 遵循KISS原则（保持简单），便于理解和调整以满足需求

使用场景和适用范围

• PHP应用程序的开发和测试环境搭建
• 小型到中型PHP Web应用的生产部署
• 需要轻量级、高性能Web服务环境的场景
• 需要自定义Nginx和PHP配置的应用场景
• 资源受限环境下的Web服务部署

使用方法

基本运行

启动Docker容器：

bash
docker run -p 80:8080 trafex/php-nginx

访问测试：

• PHP信息页：http://localhost
• 静态HTML测试页：http://localhost/test.html

挂载自定义代码

挂载本地代码库至容器，由PHP-FPM和Nginx提供服务：

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

版本控制说明

• 主要或次要更新会作为https://github.com/TrafeX/docker-php-nginx/releases%E5%8F%91%E5%B8%83%EF%BC%8C%E5%B9%B6%E9%99%84%E5%B8%A6%E5%8F%98%E6%9B%B4%E6%97%A5%E5%BF%97
• latest标签每周自动更新，包含Alpine Linux的最新补丁

配置说明

默认配置文件位于镜像的config/目录下，包含Nginx、PHP和PHP-FPM的配置。可通过挂载自定义配置文件覆盖默认配置。

Nginx配置

挂载自定义Nginx服务器配置：

bash
docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" trafex/php-nginx

PHP配置

挂载自定义PHP配置（.ini文件）：

bash
docker run -v "`pwd`/php-setting.ini:/etc/php84/conf.d/settings.ini" trafex/php-nginx

PHP-FPM配置

挂载自定义PHP-FPM配置：

bash
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php84/php-fpm.d/server.conf" trafex/php-nginx

注意：-v参数需要绝对路径，示例中使用pwd获取当前目录的绝对路径。

Docker部署方案示例

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  php-nginx:
    image: trafex/php-nginx
    ports:
      - "80:8080"
    volumes:
      - ./my-codebase:/var/www/html  # 挂载本地代码
      #- ./nginx-server.conf:/etc/nginx/conf.d/server.conf  # 可选：自定义Nginx配置
      #- ./php-setting.ini:/etc/php84/conf.d/settings.ini    # 可选：自定义PHP配置
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

文档和示例

以下示例可帮助根据具体需求修改容器：

• https://github.com/TrafeX/docker-php-nginx/blob/master/docs/xdebug-support.md
• https://github.com/TrafeX/docker-php-nginx/blob/master/docs/composer-support.md
• https://github.com/TrafeX/docker-php-nginx/blob/master/docs/real-ip-behind-load***.md
• https://github.com/TrafeX/docker-php-nginx/blob/master/docs/sending-emails.md