Devilbox PHP-FPM镜像文档

镜像概述和主要用途

Devilbox PHP-FPM镜像是Devilbox开发环境生态的重要组成部分，基于PHP官方FPM（FastCGI Process Manager）实现，提供从PHP 5.6到8.4的多个稳定版本支持。该镜像旨在为开发、测试及本地运行环境提供轻量、灵活且预配置优化的PHP运行环境，便于快速搭建与应用程序版本匹配的PHP FPM服务，尤其适合需要在多PHP版本间切换测试的开发场景。

核心功能和特性

• 多版本支持：覆盖PHP 5.6、7.0、7.1、7.2、7.3、7.4、8.0、8.1、8.2、8.3、8.4共11个版本，满足不同PHP应用的版本需求。
• FPM预配置：内置优化的FPM进程管理参数，默认配置适合开发环境的资源占用与性能平衡。
• 兼容性设计：与Devilbox其他组件（如Nginx、Apache、数据库服务等）无缝集成，支持完整的LAMP/LNMP开发环境搭建。
• 灵活配置：支持通过环境变量或配置文件挂载自定义PHP.ini设置、FPM配置参数，满足个性化需求。
• 轻量级基础：基于官方PHP镜像构建，保持较小镜像体积，同时包含开发环境常用扩展（如mysqli、pdo_mysql、gd等）。

使用场景和适用范围

适用场景

• PHP应用本地开发：为开发者提供与生产环境隔离的PHP运行环境，避免本地环境配置冲突。
• 多版本兼容性测试：测试PHP应用在不同PHP版本下的运行情况，排查版本兼容性问题。
• 快速原型验证：快速启动特定PHP版本的FPM服务，验证PHP脚本或小型应用的运行效果。
• Devilbox环境集成：作为Devilbox开发栈的一部分，与Nginx、数据库等组件协同工作，构建完整的Web开发环境。

适用范围

• 个人开发者本地PHP开发环境搭建
• 团队协作开发中的统一PHP环境配置
• CI/CD流程中的PHP版本测试环节
• 教学或演示环境中的PHP运行实例部署

详细使用方法和配置说明

获取镜像

通过Docker Hub拉取指定版本的镜像，标签为PHP版本号（如5.6、7.4、8.4等）：

docker pull devilbox/php-fpm:8.4  # 拉取PHP 8.4版本
docker pull devilbox/php-fpm:7.2  # 拉取PHP 7.2版本

基本运行示例

运行PHP-FPM容器并挂载本地PHP应用目录：

# 运行PHP 8.4 FPM，挂载当前目录下的PHP应用到容器内默认文档根目录
docker run -d \
  --name devilbox-php-fpm-8.4 \
  -v /path/to/your/php/app:/var/www/html \  # 挂载本地PHP应用目录
  -p 9000:9000 \  # 暴露FPM默认端口（可选，通常与Nginx通过容器网络通信）
  devilbox/php-fpm:8.4

与Nginx配合使用（Docker Compose示例）

通过docker-compose.yml配置Nginx与PHP-FPM联动，实现完整Web服务：

version: '3'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - /path/to/nginx/conf.d:/etc/nginx/conf.d  # Nginx站点配置
      - /path/to/your/php/app:/var/www/html     # 共享PHP应用目录
    depends_on:
      - php-fpm
    networks:
      - dev-network

  php-fpm:
    image: devilbox/php-fpm:8.4
    volumes:
      - /path/to/your/php/app:/var/www/html     # 与Nginx共享应用目录
    networks:
      - dev-network

networks:
  dev-network:

Nginx站点配置示例（保存到/path/to/nginx/conf.d/default.conf）：

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

配置参数说明

环境变量

可通过-e参数设置环境变量调整PHP-FPM行为：

• PHP_INI_SCAN_DIR：自定义PHP配置文件扫描目录，默认包含/etc/php/{version}/fpm/conf.d，可添加额外目录（如/etc/php/custom.d）以加载自定义*.ini文件。
• PHP_FPM_USER：运行FPM进程的用户ID（UID），默认使用1000（普通用户），可根据宿主机用户ID调整以解决文件权限问题。
• PHP_FPM_GROUP：运行FPM进程的用户组ID（GID），默认与PHP_FPM_USER一致。

示例：指定自定义用户ID运行FPM

docker run -d \
  --name devilbox-php-fpm-8.4 \
  -e PHP_FPM_USER=1001 \
  -e PHP_FPM_GROUP=1001 \
  -v /path/to/php/app:/var/www/html \
  devilbox/php-fpm:8.4

配置文件挂载

通过挂载自定义配置文件覆盖默认FPM或PHP配置：

• PHP.ini配置：挂载文件到/etc/php/{version}/fpm/php.ini（如/local/php.ini:/etc/php/8.4/fpm/php.ini）
• FPM配置：挂载文件到/etc/php/{version}/fpm/php-fpm.conf或/etc/php/{version}/fpm/pool.d/[***]（FPM池配置）

示例：挂载自定义PHP.ini和FPM池配置

docker run -d \
  --name devilbox-php-fpm-8.4 \
  -v /local/php.ini:/etc/php/8.4/fpm/php.ini \
  -v /local/[***] \
  -v /path/to/php/app:/var/www/html \
  devilbox/php-fpm:8.4

注意事项

• 该镜像主要面向开发和测试环境，生产环境使用前建议根据实际需求调整安全配置（如禁用不必要的PHP扩展、限制FPM进程数等）。
• 不同PHP版本的扩展支持存在差异，使用时需确认目标PHP版本是否包含应用所需扩展，可通过docker exec -it <container> php -m查看已安装扩展。
• 与Nginx等Web服务器配合时，需确保两者共享同一应用目录（通过-v挂载相同宿主机路径），并配置正确的FastCGI参数。