ernestas/php

通用PHP-FPM容器镜像文档

镜像概述

本镜像为通用PHP-FPM容器，旨在提供灵活、可定制的PHP FastCGI进程管理器环境，支持多种PHP稳定版本，适用于各类PHP应用（如Web应用、API服务等）的部署与运行。通过简化配置流程和扩展管理，可快速集成到开发或生产环境中，满足不同场景下的PHP服务需求。

核心功能与特性

多版本PHP支持

支持PHP 7.4、8.0、8.1、8.2等稳定版本，可通过镜像标签指定具体版本（如:8.2），满足不同应用的兼容性要求。

灵活配置管理

支持通过环境变量或挂载配置文件（php.ini、www.conf）自定义PHP运行参数，可调整内存限制、执行时间、错误日志、FPM进程池等关键配置。

扩展管理能力

内置常用PHP扩展（mysqli、pdo_mysql、gd、curl等），并支持通过环境变量按需安装额外扩展（如redis、memcached、xdebug），满足框架及应用的依赖需求。

兼容性强

可与Nginx、Apache等主流Web服务器无缝集成，支持FastCGI协议通信，适配经典LNMP/LAMP架构及现代微服务架构中的PHP服务部署。

轻量与性能优化

基于精简基础镜像构建，减少镜像体积；默认启用性能优化参数，支持动态调整FPM进程管理模式（动态/静态/按需）以适配不同负载场景。

使用场景与适用范围

• 开发环境：快速搭建本地PHP开发环境，支持多版本切换与扩展测试。
• 生产环境部署：部署各类PHP应用，如内容管理系统（WordPress、Drupal）、PHP框架应用（Laravel、Symfony）、自定义API服务等。
• 微服务架构：作为微服务架构中的PHP服务节点，与数据库、缓存等服务协同工作。
• CI/CD流程：集成到持续集成/部署流程，作为PHP应用的运行环境执行测试或部署任务。

详细使用方法

基础使用（Docker Run）

1. 拉取镜像

bash
docker pull universal-php-fpm:<php-version>  # 例如: docker pull universal-php-fpm:8.2

2. 启动基础容器

bash
docker run -d \
  --name php-fpm-app \
  -v /本地/php应用目录:/var/www/html \  # 挂载PHP应用代码
  -p 9000:9000 \  # 映射FPM默认端口（FastCGI通信）
  universal-php-fpm:8.2

自定义配置

1. 挂载php.ini配置

bash
docker run -d \
  --name php-fpm-custom-ini \
  -v /本地/php应用目录:/var/www/html \
  -v /本地/custom/php.ini:/usr/local/etc/php/php.ini \  # 挂载自定义php.ini
  universal-php-fpm:8.2

2. 调整FPM进程池配置

bash
docker run -d \
  --name php-fpm-pool-config \
  -v /本地/php应用目录:/var/www/html \
  -v /本地/custom/www.conf:/usr/local/etc/php-fpm.d/www.conf \  # 挂载FPM进程池配置
  universal-php-fpm:8.2

安装额外扩展

通过PHP_EXTENSIONS环境变量指定需安装的扩展（逗号分隔）：

bash
docker run -d \
  --name php-fpm-with-extensions \
  -v /本地/php应用目录:/var/www/html \
  -e PHP_EXTENSIONS="redis,memcached,xdebug" \  # 安装redis、memcached、xdebug扩展
  universal-php-fpm:8.2

与Nginx配合使用（LNMP架构示例）

1. 创建docker-compose.yml

yaml
version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # Nginx配置目录
      - ./php-app:/var/www/html  # 共享PHP应用代码
    depends_on:
      - php-fpm

  php-fpm:
    image: universal-php-fpm:8.2
    volumes:
      - ./php-app:/var/www/html
    environment:
      - PHP_MEMORY_LIMIT=256M  # 自定义PHP内存限制
      - PHP_MAX_EXECUTION_TIME=60  # 自定义最大执行时间
      - FPM_MAX_CHILDREN=10  # 调整FPM最大进程数

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

nginx
server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    index index.php index.html;

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

3. 启动服务

bash
docker-compose up -d

环境变量说明

注意事项

• 生产环境建议使用特定版本标签（如:8.2），避免使用:latest以确保版本稳定性。
• 敏感配置（如数据库凭证）建议通过环境变量或secrets管理，避免硬编码到配置文件。
• 定期更新镜像以获取安全补丁及性能优化。
• 高并发场景需根据服务器资源调整FPM_MAX_CHILDREN等进程池参数，避免资源耗尽。