openbridge/ob_php-fpm

PHP-FPM Docker镜像文档

概述

本Docker镜像提供高性能、优化的PHP-FPM容器，基于Alpine Linux构建，包含多项配置增强：Alpine Linux优化、Opcache启用、动态资源分配、监控机制及安全加固等，适用于与NGINX配合部署PHP Web应用。

核心功能与特性

• 轻量基础：基于Alpine Linux，体积小且安全
• 性能优化：默认启用Opcache，提升PHP执行效率
• 动态资源分配：根据容器CPU/内存自动调整PHP-FPM进程数及内存配置
• 监控保障：集成Monit监控PHP-FPM服务状态，自动修复权限问题
• 安全加固：标准化用户权限（www-data:82），文件权限自动维护
• 灵活配置：通过环境变量自定义文档根目录、端口、资源限制等参数

使用场景

• 需要高性能PHP运行环境的Web应用（如Laravel、WordPress等）
• 与NGINX配合构建LNMP架构的容器化部署
• 需动态调整资源以适应负载变化的生产环境
• 注重安全性和可维护性的企业级应用

构建镜像

基础构建

bash
docker build -t openbridge/ob_php-fpm .

指定Alpine版本

默认使用Alpine 3.11，可通过ALPINE_VERSION构建参数指定版本：

bash
docker build -t ob_php-fpm --build-arg ALPINE_VERSION=3.13 .

从Docker Hub拉取

Docker Hub镜像默认使用Alpine 3.13：

bash
docker pull docker.xuanyuan.run/openbridge/ob_php-fpm

运行容器

简单运行

bash
docker run -it --rm \
    -p 9000:9000 \
    -e "APP_DOCROOT=/app" \
    --name php-fpm \
    docker.xuanyuan.run/openbridge/php-fpm

使用Docker Compose

bash
docker-compose up -d  # 需确保项目中存在docker-compose.yml

配置说明

设置文档根目录（APP_DOCROOT）

默认应用根目录为/app，可通过APP_DOCROOT环境变量修改：

bash
-e "APP_DOCROOT=/html"  # 将文档根目录设为/html

重要：APP_DOCROOT需与NGINX配置中的NGINX_DOCROOT保持一致，否则可能导致文件访问错误。

Docker卷挂载

挂载Web应用文件

将主机Web应用目录挂载至容器文档根目录（只读推荐）：

bash
-v /your/webapp/path:${APP_DOCROOT}:ro  # 例如 -v /host/app:/app:ro

缓存目录优化

使用tmpfs挂载缓存目录（内存文件系统，提升性能）：

bash
-v /tmpfs:${CACHE_PREFIX}:ro  # 缓存目录路径由环境变量CACHE_PREFIX定义

环境变量

动态资源分配机制

容器启动时自动根据CPU和内存计算PHP-FPM配置，核心逻辑如下：

bash
# 动态配置核心代码（容器内自动执行）
CPU=$(grep -c ^processor /proc/cpuinfo)
TOTALMEM=$(free -m | awk '/^Mem:/{print $2}')
TOTALCPU=$((CPU > 2 ? CPU : 2))

# PHP-FPM进程数计算
PHP_START_SERVERS=${PHP_START_SERVERS:-$((TOTALCPU / 2))}
PHP_MIN_SPARE_SERVERS=${PHP_MIN_SPARE_SERVERS:-$((TOTALCPU / 2))}
PHP_MAX_SPARE_SERVERS=${PHP_MAX_SPARE_SERVERS:-$TOTALCPU}
PHP_MAX_CHILDREN=${PHP_MAX_CHILDREN:-$((TOTALCPU * 2))}

# 内存配置计算
PHP_MEMORY_LIMIT=${PHP_MEMORY_LIMIT:-$((TOTALMEM / 2))}
PHP_OPCACHE_MEMORY_CONSUMPTION=${PHP_OPCACHE_MEMORY_CONSUMPTION:-$((TOTALMEM / 6))}

PHP-FPM配置结构

镜像PHP配置文件结构如下（关键配置片段）：

bash
# /etc/php7/php-fpm.conf
[global]
include=/etc/php7/php-fpm.d/*.conf

# /etc/php7/php-fpm.d/docker.conf
[global]
error_log = {{LOG_PREFIX}}/error.log
[www]
access.log = {{LOG_PREFIX}}/access.log
clear_env = no
catch_workers_output = yes

# /etc/php7/php-fpm.d/zz-docker.conf（核心配置）
[www]
user = www-data
group = www-data
listen = [::]:{{PHP_FPM_PORT}}
pm = static
pm.max_children = {{PHP_MAX_CHILDREN}}
pm.start_servers = {{PHP_START_SERVERS}}
pm.min_spare_servers = {{PHP_MIN_SPARE_SERVERS}}
pm.max_spare_servers = {{PHP_MAX_SPARE_SERVERS}}

# /etc/php7/conf.d/50-setting.ini（PHP.ini配置）
memory_limit={{PHP_MEMORY_LIMIT}}M
upload_max_filesize={{PHP_UPLOAD_MAX_FILESIZE}}M
opcache.enable={{PHP_OPCACHE_ENABLE}}
opcache.memory_consumption={{PHP_OPCACHE_MEMORY_CONSUMPTION}}M

权限管理

用户与组

容器使用标准化用户www-data（UID=82，GID=82）：

bash
addgroup -g 82 -S www-data
adduser -u 82 -D -S -h /var/cache/php-fpm -s /sbin/nologin -G www-data www-data

权限自动维护

容器启动时自动修复文档根目录及缓存目录权限：

bash
# 权限修复逻辑（容器内自动执行）
find ${APP_DOCROOT} ! -user www-data -exec chown www-data:www-data {} \;
find ${APP_DOCROOT} ! -perm 755 -type d -exec chmod 755 {} \;
find ${APP_DOCROOT} ! -perm 644 -type f -exec chmod 644 {} \;

缓存机制

• Opcache：默认启用，内存大小由动态资源分配决定
• 缓存目录：推荐通过tmpfs挂载/var/cache（如docker-compose中配置）：

yaml
tmpfs:
  - /var/cache

日志管理

PHP-FPM日志默认输出至stdout/stderr，建议结合日志收集服务（如Amazon CloudWatch）进行集中管理，以便设置告警和监控容器活动。

监控机制

Monit监控

容器集成Monit监控PHP-FPM服务，核心监控规则：

bash
check process php-fpm with pidfile "/var/run/php-fpm.pid"
  if not exist for 10 cycles then restart
  if cpu > 90% for 5 cycles then exec "/bin/bash -c /usr/bin/pkill -INT php-fpm"
  if failed port {{PHP_FPM_PORT}} then exec "/bin/bash -c /usr/bin/pkill -INT php-fpm"

自动恢复

• PHP-FPM异常时Monit发送STOP命令，容器因CMD ["php-fpm7", "-g", "/var/run/php-fpm.pid"]会退出
• 若启动容器时使用--restart always，Docker将自动重启容器

问题反馈

如遇镜像使用问题，请通过GitHub Issue反馈。

贡献指南

欢迎贡献新功能、修复或更新，建议先通过GitHub Issue讨论大型变更，再提交Pull Request。

参考资料

• PHP-FPM进程管理：[***]
• 官方PHP Docker镜像：https://github.com/docker-library/php
• NGINX+PHP-FPM优化：[***]

许可证

本项目基于MIT许可证开源，详见LICENSE文件。