comrada/php-fpm

PHP-FPM配置镜像（Nginx兼容版）

镜像概述和主要用途

本镜像提供了一个简单的PHP-FPM配置环境，专为与Nginx Web服务器配合工作设计。基于官方PHP-FPM镜像优化，简化了配置流程，可直接作为Nginx的后端FastCGI服务，处理PHP脚本请求，适用于快速搭建Nginx+PHP-FPM架构的Web应用环境。

核心功能和特性

• 简单配置：预配置基础PHP-FPM参数，无需复杂自定义即可快速使用
• Nginx兼容：支持与Nginx通过FastCGI协议标准通信，适配Nginx反向代理配置
• 基础扩展：包含PHP运行所需的核心扩展（如mysqli、json、mbstring等）
• 轻量级：基于官方PHP-FPM镜像精简构建，保持较小镜像体积和高效运行

使用场景和适用范围

• 开发环境快速搭建：适合开发者本地快速部署Nginx+PHP-FPM开发环境
• 小型Web项目部署：适用于个人博客、小型企业网站等PHP应用的轻量部署
• 学习与测试：用于学习Nginx与PHP-FPM协同工作原理的测试环境
• 原型验证：快速验证PHP应用在Nginx+PHP-FPM架构下的运行效果

使用方法和配置说明

基本使用（Docker Run）

bash
# 启动PHP-FPM容器，暴露9000端口（FastCGI默认端口），挂载应用代码目录
docker run -d \
  --name php-fpm-simple \
  -v /path/to/your/php/app:/var/www/html \  # 挂载本地PHP应用代码到容器内默认工作目录
  -p 9000:9000 \  # 映射FastCGI端口（如使用Docker网络可不暴露主机端口）
  [镜像名称]

与Nginx配合使用

1. Nginx配置示例（nginx.conf片段）

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/html;  # 需与PHP-FPM容器内代码目录一致

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass php-fpm-simple:9000;  # PHP-FPM容器名称或IP:端口
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

2. Docker Compose示例（推荐）

yaml
version: '3'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # 挂载Nginx配置文件
      - ./php-app:/var/www/html  # 共享PHP应用代码目录
    depends_on:
      - php-fpm

  php-fpm:
    image: [镜像名称]
    volumes:
      - ./php-app:/var/www/html  # 与Nginx共享PHP应用代码目录
    # 无需暴露端口，通过Docker网络内部通信

配置自定义

• PHP配置修改：如需自定义php.ini参数，可通过挂载本地php.ini文件到容器内/usr/local/etc/php/php.ini路径
• FPM配置修改：如需调整php-fpm.conf或[***]
• 扩展安装：如需额外PHP扩展，可基于本镜像构建新镜像，通过docker-php-ext-install命令安装

注意事项

• 确保Nginx容器与PHP-FPM容器可通过网络通信（推荐使用Docker Compose同一网络或手动创建桥接网络）
• 挂载的PHP应用目录在Nginx和PHP-FPM容器中路径需保持一致，避免文件访问权限问题
• 生产环境使用时建议添加用户权限配置，限制容器运行用户，增强安全性