开发环境专用 php-fpm Docker 镜像文档

1. 镜像概述和主要用途

本镜像为仅用于开发环境的 php-fpm Docker 镜像，设计用于与 Nginx 配合构建 Docker 开发环境。主要应用于 OpenEMR 项目及其他需要多版本 PHP 支持的开发场景，提供便捷的开发环境配置方案。

2. 核心功能和特性

• 多 PHP 版本支持：涵盖 PHP 5.6 至 PHP 8.6 的全系列版本，满足不同项目的兼容性测试需求
• 开发优化配置：预装开发常用 PHP 扩展及工具，无需额外配置
• Redis 扩展可选：提供集成 Redis 扩展的专用镜像版本（标签带 -redis 后缀）
• Nginx 无缝集成：支持与 Nginx 快速对接，构建完整的 LEMP 开发环境
• 预构建开发版本：提供 pre-build-dev-86 标签用于 PHP 8.6 开发环境的快速部署

3. 使用场景和适用范围

• 开发人员本地开发环境搭建
• 多 PHP 版本兼容性测试
• OpenEMR 项目的开发与测试环境配置
• 需要快速切换 PHP 版本的开发工作流
• 教学或演示环境中的 PHP 环境快速部署

4. 支持的标签及 Dockerfile 链接

4.1 标准版本（无 Redis 扩展）

4.2 集成 Redis 扩展版本

5. 使用方法和配置说明

5.1 独立运行示例

# 启动 PHP 8.2 版本的 php-fpm 服务
docker run -d \
  --name dev-php-fpm \
  -v /本地代码目录:/var/www/html \
  openemr/dev-php-fpm:8.2

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

创建 docker-compose.yml 文件：

version: '3.8'

services:
  php-fpm:
    image: openemr/dev-php-fpm:8.2  # 指定 PHP 版本
    volumes:
      - ./code:/var/www/html  # 挂载本地代码目录
    networks:
      - dev-network
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"  # 映射 HTTP 端口
    volumes:
      - ./code:/var/www/html  # 共享代码目录
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载 Nginx 配置
    depends_on:
      - php-fpm  # 依赖 php-fpm 服务
    networks:
      - dev-network
    restart: unless-stopped

networks:
  dev-network:
    driver: bridge

创建 Nginx 配置文件 ./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;
    }
}

启动服务：

docker-compose up -d

5.3 配置参数说明

• 代码目录挂载：通过 -v /本地代码目录:/var/www/html 将本地开发代码挂载到容器，实现实时开发
• 网络配置：通过自定义网络（如 dev-network）确保 Nginx 与 php-fpm 服务互通
• 版本切换：修改 image 字段中的标签（如 :8.2 改为 :8.3）即可切换 PHP 版本
• Redis 支持：如需使用 Redis 扩展，选择带 -redis 后缀的标签（如 :8.2-redis）

6. 注意事项

• 环境限制：本镜像仅用于开发环境，未针对生产环境进行安全加固和性能优化，禁止用于生产环境
• 扩展支持：不同 PHP 版本可能包含不同的扩展集合，具体以 Dockerfile 定义为准
• 详细文档：更多使用细节请参考官方文档：OpenEMR 开发环境文档