comrada/nginx

Nginx-PHP-FPM 配置镜像

镜像概述

本Docker镜像提供预配置的Nginx环境，专为与PHP-FPM服务配合工作设计。基于官方Nginx镜像构建，内置针对PHP应用的优化配置，旨在简化Nginx与PHP-FPM的集成流程，帮助用户快速部署支持PHP的Web应用。

核心功能与特性

• 预配置PHP处理规则：已设置Nginx对.php文件的解析规则，自动将PHP请求转发至PHP-FPM服务
• 优化FastCGI参数：包含常用FastCGI配置（如fastcgi_param SCRIPT_FILENAME等），确保PHP脚本正确执行
• 简化集成流程：无需手动编写Nginx配置文件，开箱即可与PHP-FPM服务配合使用
• 轻量级基础：基于官方Nginx镜像，保持较小镜像体积，同时确保稳定性

使用场景

• 开发环境快速搭建：本地开发PHP应用时，快速部署Nginx+PHP-FPM运行环境
• 小型PHP应用部署：个人博客、简单CMS系统等轻量级PHP应用的生产环境部署
• 教学/演示环境：需要快速展示PHP应用运行效果的场景

使用方法

前提条件

• 已安装Docker Engine
• 已部署PHP-FPM服务（可通过Docker容器或本地服务运行）

基本使用（Docker Run）

通过以下命令启动Nginx容器，并连接至已运行的PHP-FPM容器：

bash
docker run -d \
  --name nginx-php \
  -p 80:80 \
  --link php-fpm:php-fpm \  # 连接PHP-FPM容器（假设PHP-FPM容器名为php-fpm）
  -v /path/to/your/php/app:/usr/share/nginx/html \  # 挂载PHP应用代码目录
  [镜像名称]

Docker Compose配置示例

创建docker-compose.yml文件，定义Nginx与PHP-FPM服务：

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/[镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./php-app:/usr/share/nginx/html  # 本地PHP应用目录
    depends_on:
      - php-fpm

  php-fpm:
    image: docker.xuanyuan.run/php:fpm  # 使用官方PHP-FPM镜像
    volumes:
      - ./php-app:/usr/share/nginx/html  # 共享应用代码目录

启动服务：

bash
docker-compose up -d

自定义配置

如需修改Nginx配置，可通过挂载自定义配置文件覆盖默认设置：

bash
docker run -d \
  --name nginx-php \
  -p 80:80 \
  --link php-fpm:php-fpm \
  -v /path/to/your/php/app:/usr/share/nginx/html \
  -v /path/to/custom/nginx.conf:/etc/nginx/conf.d/default.conf \  # 挂载自定义Nginx配置
  [镜像名称]

默认配置说明

• Nginx监听端口：80
• Web根目录：/usr/share/nginx/html
• PHP-FPM连接地址：通过环境变量PHP_FPM_HOST指定（默认值：php-fpm）
• PHP-FPM端口：通过环境变量PHP_FPM_PORT指定（默认值：9000）

环境变量