PHP-FPM 托管服务镜像文档

镜像概述

本镜像基于PHP FastCGI进程管理器（PHP-FPM）构建，专为托管PHP Web应用服务设计。PHP-FPM作为高效的PHP请求处理工具，通过FastCGI协议与Web服务器（如Nginx、Apache）协同工作，能够动态管理PHP进程，提升PHP应用的并发处理能力和资源利用率，是搭建高性能PHP Web服务的理想基础组件。

核心功能与特性

• 高效请求处理：采用PHP-FPM进程管理机制，支持动态调整进程数量，可根据负载自动扩展，优化PHP应用响应速度。
• 轻量级设计：基于官方PHP基础镜像精简构建，减少不必要组件，降低镜像体积和资源占用。
• 灵活集成能力：无缝适配主流Web服务器（Nginx、Apache等），通过FastCGI协议实现PHP请求的转发与处理。
• 可配置进程参数：支持通过环境变量或配置文件调整进程管理参数（如最大进程数、空闲超时等），满足不同场景的性能需求。
• 多环境支持：提供开发与生产环境适配能力，支持本地调试、CI/CD集成及生产环境稳定运行，确保应用环境一致性。

使用场景与适用范围

• PHP Web应用部署：适用于搭建各类PHP应用，包括博客系统（WordPress）、内容管理系统（Drupal）、框架应用（Laravel、Symfony）等。
• 开发与生产环境：支持本地开发调试、自动化部署流程集成及生产环境长期运行，适配从开发到上线的全流程需求。
• 高并发PHP服务：针对需要处理大量PHP请求的场景（如电商平台、企业官网），提供可靠的性能支撑。

使用方法与配置说明

基本运行（docker run）

通过以下命令快速启动容器，挂载本地PHP应用代码并运行：

docker run -d \
  --name php-fpm-service \
  -v /path/to/local/php/app:/var/www/html \  # 挂载本地PHP应用代码至容器内默认目录
  -e PHP_FPM_MAX_CHILDREN=50 \              # 配置PHP-FPM最大子进程数
  -e PHP_FPM_USER=www-data \                # 指定运行用户
  php-fpm:latest                            # 镜像名称及标签（具体版本通过标签指定，如php-fpm:8.2）

与Nginx集成（docker-compose示例）

PHP-FPM需配合Web服务器处理HTTP请求，以下为与Nginx协同工作的docker-compose.yml配置示例：

version: '3'

services:
  nginx:
    image: nginx:latest
    ports:
      - "80:80"  # 暴露Web服务端口
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载Nginx配置
      - ./php-app:/var/www/html           # 共享PHP应用代码（与php-fpm容器一致）
    depends_on:
      - php-fpm  # 依赖php-fpm服务

  php-fpm:
    image: php-fpm:latest
    volumes:
      - ./php-app:/var/www/html  # 挂载PHP应用代码
    environment:
      - PHP_FPM_MAX_CHILDREN=30        # 最大子进程数
      - PHP_FPM_START_SERVERS=5        # 初始启动进程数
      - PHP_FPM_MAX_REQUESTS=1000      # 单个进程最大处理请求数

Nginx配置示例（./nginx/conf.d/default.conf）

server {
    listen 80;
    server_name localhost;
    root /var/www/html;  # 应用代码根目录（需与php-fpm容器挂载路径一致）
    index index.php index.html;

    # PHP请求处理配置
    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;  # 连接php-fpm容器（服务名:默认端口）
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;  # 引入FastCGI默认参数
    }
}

环境变量配置

支持通过环境变量调整核心配置，常用参数如下：

数据持久化与配置挂载

为确保应用代码和配置持久化，建议挂载本地目录至容器关键路径：

docker run -d \
  --name php-fpm-persistent \
  -v /local/app:/var/www/html \          # 挂载PHP应用代码
  -v /local/php-config:/usr/local/etc/php \  # 挂载自定义PHP配置（如php.ini）
  -v /local/logs:/var/log/php-fpm \      # 挂载日志目录（可选）
  php-fpm:latest

说明：挂载/usr/local/etc/php目录可自定义PHP配置（如php.ini、php-fpm.conf），覆盖默认配置。