khamazaspyan/nginx-php-fpm Docker 镜像 - 轩辕镜像

Nginx PHP FPM Docker镜像文档

镜像概述

Nginx PHP FPM镜像是一个预配置的Docker镜像，集成了Nginx Web服务器与PHP-FPM（FastCGI Process Manager）解释器。该镜像旨在简化PHP应用部署流程，解决传统环境中Nginx与PHP-FPM配置复杂的问题，提供开箱即用的Web服务与PHP执行环境，适用于快速搭建PHP应用运行环境。

核心功能与特性

• 一体化部署：集成Nginx与PHP-FPM，无需手动配置两者通信，降低环境搭建复杂度
• 灵活配置：支持通过环境变量或配置文件挂载自定义Nginx虚拟主机、PHP.ini参数及PHP-FPM进程管理策略
• 多场景适配：兼容主流PHP框架（Laravel、Symfony等）及CMS系统（WordPress、Drupal等）
• 资源优化：默认配置针对性能优化，包含PHP内存限制、Nginx连接数控制等基础调优参数
• 轻量设计：基于官方基础镜像构建，镜像体积小，启动速度快，适合容器化部署

使用场景

• PHP应用部署：快速上线WordPress、Typecho等PHP网站，或Laravel、ThinkPHP等框架开发的Web应用
• 开发环境搭建：为开发团队提供统一的本地开发环境，避免"本地能跑线上不能跑"的环境差异问题
• 测试环境构建：搭建隔离的PHP应用测试环境，支持多版本PHP测试（需使用对应版本标签镜像）
• 轻量生产环境：中小型PHP应用的生产部署，减少服务器资源占用，简化运维流程

使用方法

基础部署（docker run）

通过以下命令快速启动容器，将本地PHP应用目录挂载到容器中：

bash
docker run -d \
  --name nginx-php-fpm \
  -p 80:80 \
  -v /path/to/your/php/app:/var/www/html \
  nginx-php-fpm:latest

参数说明：

• -p 80:80：映射容器80端口到主机，提供Web服务访问
• -v /path/to/your/php/app:/var/www/html：挂载本地PHP应用代码到容器Nginx默认网站根目录

Docker Compose部署

创建docker-compose.yml文件实现多容器联动（如搭配数据库）：

yaml
version: '3.8'
services:
  web:
    image: nginx-php-fpm:latest
    ports:
      - "80:80"
    volumes:
      - ./php-app:/var/www/html
      - ./nginx-conf:/etc/nginx/conf.d  # 挂载自定义Nginx配置
      - ./php-ini:/usr/local/etc/php  # 挂载自定义PHP配置
    environment:
      - PHP_MEMORY_LIMIT=256M  # 自定义PHP内存限制
      - NGINX_MAX_BODY_SIZE=20M  # 自定义Nginx最大请求体大小
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=your_password
      - MYSQL_DATABASE=php_app_db

配置说明

环境变量配置

支持通过环境变量调整基础配置，常用变量如下：

配置文件挂载

如需高级配置，可通过挂载文件覆盖默认配置：

• Nginx配置：挂载目录至/etc/nginx/conf.d，容器会自动加载该目录下的.conf文件
• PHP配置：挂载php.ini文件至/usr/local/etc/php/php.ini
• PHP-FPM配置：挂载目录至/usr/local/etc/php-fpm.d，自定义进程池配置

示例（挂载自定义配置）：

bash
docker run -d \
  --name nginx-php-fpm \
  -p 80:80 \
  -v ./php-app:/var/www/html \
  -v ./nginx-conf:/etc/nginx/conf.d \  # 自定义Nginx虚拟主机配置
  -v ./php.ini:/usr/local/etc/php/php.ini \  # 自定义PHP配置
  nginx-php-fpm:latest

注意事项

• 生产环境建议使用指定PHP版本标签（如nginx-php-fpm:8.2），避免因版本更新导致兼容性问题
• 挂载本地目录时需确保权限正确，可通过-u $(id -u):$(id -g)参数指定容器运行用户ID
• 敏感配置（如数据库密码）应通过环境变量注入，避免硬编码在配置文件中
• 高并发场景需根据服务器资源调整PHP-FPM进程数（通过php-fpm.d/[***]配置）及Nginx工作进程数