Docker PHP-FPM 镜像文档

概述

PHP-FPM（FastCGI Process Manager）是PHP FastCGI的替代实现，具备额外功能，适用于各种规模的网站，尤其适合高流量站点。它提供了比传统FastCGI更强大的进程管理能力和更多增强特性，可满足不同场景下的PHP应用部署需求。

核心功能和特性

PHP-FPM包含以下关键特性：

• 自适应进程生成（新增）
• 基本统计功能（类似Apache的mod_status）（新增）
• 高级进程管理，支持优雅停止/启动
• 支持使用不同uid/gid/chroot/环境和不同php.ini启动工作进程（替代safe_mode）
• 标准输出（stdout）和标准错误（stderr）日志记录
• 紧急重启机制，以防意外的操作码缓存损坏
• 加速上传支持
• "慢日志"（slowlog）支持
• FastCGI增强功能，如fastcgi_finish_request()函数 - 用于完成请求并刷新所有数据后继续执行耗时操作（如视频转换、统计处理等）
• 以及更多功能...

尽管最初并非为虚拟主机（大量池）设计，但它可适应任何使用模式。

参考链接：PHP-FPM 官方文档

使用场景和适用范围

适用于需要部署PHP应用的各种场景，包括：

• 个人博客和小型网站
• 企业门户网站
• 高流量电商平台
• 需要高效PHP进程管理的Web应用

使用方法

基本部署命令

docker create --name=php-fpm  \
  -v /etc/localtime:/etc/localtime:ro \
  -v <本地webroot路径>:/www \
  -v <本地fpm配置路径>:/etc/php5/fpm.d \
  -v <本地fpm日志路径>:/var/log/php5 \
  -e DOCKUID=<用户ID，默认：10001> \
  -e DOCKGID=<组ID，默认：10001> \
  -e DOCKMAIL=<邮件地址> \
  -e DOCKRELAY=<SMTP中继服务器> \
  -e DOCKMAILDOMAIN=<邮件发件域名> \
  -p 9000:9000 digrouz/docker-phpfpm

参数说明

• -v /etc/localtime:/etc/localtime:ro：挂载本地时间，确保容器内时间与主机一致
• -v <本地webroot路径>:/www：挂载网站根目录
• -v <本地fpm配置路径>:/etc/php5/fpm.d：挂载PHP-FPM配置文件目录
• -v <本地fpm日志路径>:/var/log/php5：挂载PHP-FPM日志目录
• -p 9000:9000：映射PHP-FPM默认端口

环境变量配置

启动容器时，可通过以下环境变量调整PHP-FPM实例配置：

DOCKUID

• 是否必填：否
• 默认值：10001
• 说明：指定运行应用的用户ID

DOCKGID

• 是否必填：否
• 默认值：10001
• 说明：指定运行应用的组ID

DOCKRELAY

• 是否必填：否
• 说明：指定用于发送邮件的SMTP中继服务器，不需要邮件通知可忽略

DOCKMAIL

• 是否必填：否
• 说明：指定发送邮件时使用的邮箱地址，不需要邮件通知可忽略

DOCKMAILDOMAIN

• 是否必填：否
• 说明：指定邮件显示的发件域名，用于用户认证，不需要邮件通知可忽略

参考链接

• PHP-FPM 官方安装文档