wunderio/silta-php-fpm

php-fpm-silta 镜像文档

镜像概述

本镜像是专为Silta项目设计的PHP-FPM容器，基于官方PHP-FPM镜像构建，旨在为Silta项目提供高效的PHP FastCGI进程管理服务。该镜像优化了PHP请求处理流程，支持与Web服务器集成，适用于Silta项目的开发、测试及生产环境部署。

核心功能与特性

• PHP-FPM进程管理：支持动态、静态及按需（ondemand）进程池配置，可根据应用负载自动调整进程数量，优化资源利用率。
• Web服务器集成：与Nginx等Web服务器无缝对接，通过FastCGI协议高效处理PHP请求，提升应用响应性能。
• Silta项目适配：预配置Silta项目所需的基础PHP扩展及环境变量，简化项目部署流程，减少配置复杂度。
• 灵活配置机制：支持通过环境变量或挂载配置文件自定义PHP.ini、php-fpm.conf及进程池配置（如[***]
• 轻量级设计：基于精简基础镜像构建，降低资源占用，提升容器启动速度。

使用场景与适用范围

• Silta项目开发环境：用于本地开发调试PHP代码，模拟生产环境PHP-FPM运行状态。
• 测试环境部署：在CI/CD流程中作为测试节点，验证PHP应用在模拟生产环境下的功能与性能。
• 生产环境运行：作为Silta项目PHP应用的生产级FastCGI服务，配合Web服务器提供稳定的线上服务。

使用方法与配置说明

基础运行命令（docker run）

bash
docker run -d \
  --name silta-php-fpm \
  -v /path/to/silta-project:/var/www/html \
  -e PHP_FPM_PM=dynamic \
  -e PHP_FPM_MAX_CHILDREN=50 \
  -e PHP_INI_MEMORY_LIMIT=256M \
  silta/php-fpm

Docker Compose配置示例

yaml
version: '3.8'
services:
  php-fpm:
    image: silta/php-fpm
    volumes:
      - ./silta-project:/var/www/html:ro  # 项目代码目录（只读挂载）
      - ./custom-php.ini:/usr/local/etc/php/php.ini  # 自定义PHP配置
      - ./www.conf:/usr/local/etc/php-fpm.d/www.conf  # 自定义进程池配置
    environment:
      - PHP_FPM_PM=dynamic
      - PHP_FPM_START_SERVERS=8
      - PHP_FPM_MIN_SPARE_SERVERS=4
      - PHP_FPM_MAX_SPARE_SERVERS=12
      - PHP_INI_UPLOAD_MAX_FILESIZE=10M
    restart: unless-stopped
    networks:
      - silta-network

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx-silta.conf:/etc/nginx/conf.d/default.conf
      - ./silta-project:/var/www/html:ro
    depends_on:
      - php-fpm
    networks:
      - silta-network

networks:
  silta-network:

环境变量配置说明

配置文件挂载

如需深度自定义配置，可通过挂载文件覆盖默认配置：

• PHP配置：挂载自定义php.ini至/usr/local/etc/php/php.ini
• PHP-FPM主配置：挂载php-fpm.conf至/usr/local/etc/php-fpm.conf
• 进程池配置：挂载www.conf至/usr/local/etc/php-fpm.d/www.conf（默认进程池配置）

注意事项

• 目录权限：确保挂载的项目目录权限正确（建议设置PHP-FPM运行用户可访问权限），避免因权限问题导致文件访问失败。
• 资源匹配：生产环境中需根据服务器资源（CPU/内存）调整max_children等进程池参数，避免资源过载或浪费。
• Web服务器配置：与Nginx集成时，需确保fastcgi_pass配置指向PHP-FPM容器（如fastcgi_pass php-fpm:9000），并正确设置SCRIPT_FILENAME等参数。