compucorp/php-fpm

PHP-FPM Docker镜像文档

镜像概述

PHP-FPM（FastCGI Process Manager）Docker镜像提供基于PHP FastCGI进程管理器的运行环境，用于处理PHP应用的FastCGI请求。该镜像封装了PHP运行时和FPM进程管理组件，可与Nginx、Apache等支持FastCGI的Web服务器配合工作，实现PHP应用的高效部署与运行，支持开发环境测试和生产环境部署。

核心功能与特性

• 多版本支持：提供多种PHP版本标签（如7.4、8.0、8.1等），满足不同应用的PHP版本兼容性需求。
• 灵活进程管理：支持动态（dynamic）、静态（static）、按需（ondemand）三种进程管理模式，可通过参数调整进程数、请求限制等性能配置。
• 扩展支持：内置常用PHP扩展（如mysqli、pdo_mysql、gd、curl等），支持通过docker-php-ext-install命令安装额外扩展。
• 环境变量配置：支持通过环境变量快速调整PHP.ini参数（如内存限制、上传大小）和FPM进程配置（如最大子进程数）。
• 日志管理：默认日志输出至标准输出（STDOUT），支持通过配置文件自定义日志路径和格式，便于日志收集与分析。
• 轻量级基础：基于Alpine或Debian基础镜像构建，镜像体积小，启动速度快，资源占用低。

使用场景与适用范围

• 开发环境：本地快速搭建独立PHP-FPM环境，用于PHP应用开发调试，避免本地环境配置冲突。
• 生产环境部署：作为PHP应用的处理层，与Nginx等Web服务器配合，部署各类PHP应用（如WordPress、Laravel、Symfony、Drupal等）。
• 微服务架构：在需要分离Web服务器与PHP处理层的微服务架构中，作为独立PHP服务节点部署。
• CI/CD流程：集成至持续集成/持续部署流程，用于自动化测试、应用构建与部署验证。

使用方法与配置说明

基本使用

1. 拉取镜像

从Docker Hub拉取指定PHP版本的PHP-FPM镜像（以PHP 8.1为例）：

bash
docker pull php:8.1-fpm

2. 启动容器

基本运行命令，挂载PHP应用代码目录：

bash
docker run -d \
  --name php-fpm-app \
  -v /本地/php应用目录:/var/www/html \
  php:8.1-fpm

与Nginx配合部署示例

docker-compose配置

通过docker-compose实现Nginx+PHP-FPM联动部署，示例配置如下：

yaml
version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - /本地/php应用目录:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载Nginx配置
    depends_on:
      - php-fpm
    restart: unless-stopped

  php-fpm:
    image: php:8.1-fpm
    volumes:
      - /本地/php应用目录:/var/www/html  # 挂载PHP应用代码
    environment:
      - PHP_INI_MEMORY_LIMIT=256M       # PHP内存限制
      - PHP_FPM_PM_MAX_CHILDREN=15      # FPM最大子进程数
    restart: unless-stopped

Nginx配置示例

创建./nginx/conf.d/default.conf文件，配置Nginx转发PHP请求至PHP-FPM：

nginx
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;
    }

    # 处理静态资源
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

启动服务：

bash
docker-compose up -d

配置说明

环境变量参数

环境变量使用示例

bash
docker run -d \
  --name php-fpm-app \
  -v /本地/php应用目录:/var/www/html \
  -e PHP_INI_MEMORY_LIMIT=512M \
  -e PHP_FPM_PM=static \
  -e PHP_FPM_PM_MAX_CHILDREN=20 \
  php:8.1-fpm

PHP扩展安装

通过Dockerfile自定义扩展

如需安装额外PHP扩展，可基于官方镜像构建自定义镜像，示例Dockerfile（安装mysqli和gd扩展）：

dockerfile
FROM php:8.1-fpm

# 安装依赖包（根据扩展需求调整）
RUN apt-get update && apt-get install -y \
    libpng-dev \
    libjpeg-dev \
    && rm -rf /var/lib/apt/lists/*

# 配置并安装扩展
RUN docker-php-ext-configure gd --with-jpeg \
    && docker-php-ext-install mysqli gd

构建并运行：

bash
docker build -t my-php-fpm .
docker run -d --name my-php-app -v /本地/php应用目录:/var/www/html my-php-fpm

配置文件挂载

如需自定义PHP或FPM配置，可挂载本地配置文件至容器对应路径：

挂载示例

bash
docker run -d \
  --name php-fpm-app \
  -v /本地/php应用目录:/var/www/html \
  -v /本地/custom/php.ini:/usr/local/etc/php/php.ini \
  -v /本地/custom/www.conf:/usr/local/etc/php-fpm.d/www.conf \
  php:8.1-fpm

日志管理

PHP-FPM日志默认输出至标准输出（STDOUT），可通过Docker日志驱动（如json-file、journald）收集。如需自定义日志路径，可修改FPM池配置文件（如www.conf）中的日志参数：

ini
; 错误日志路径
error_log = /var/log/php-fpm/error.log
; 访问日志路径（需启用）
access.log = /var/log/php-fpm/access.log

挂载日志目录并启动：

bash
docker run -d \
  --name php-fpm-app \
  -v /本地/php应用目录:/var/www/html \
  -v /本地/logs:/var/log/php-fpm \
  php:8.1-fpm