HUB
Sign inSign up

lushirong/php-fpm

By lushirong

•Updated 16 days ago

php-fpm 预装 gd、mysqli、pdo_mysql、redis、mongodb、swoole等扩展

Image
0

3.3K

lushirong/php-fpm repository overview

⁠lushirong/php-fpm

基于官方 php:*-fpm 构建的 PHP-FPM 镜像,预装常用扩展,开箱即用。适用于 LNMP、OpenResty/Nginx 反代、单机部署等场景。

  • 维护者:Lu Shirong [email protected]⁠
  • FastCGI 监听:9000/tcp
  • 时区:Asia/Shanghai(写入 /usr/local/etc/php/conf.d/timezone.ini,无需额外设置)
  • 日志:log_errors = On、error_log = /dev/stderr,docker logs 可直接查看 PHP 错误

⁠标签说明

标签PHP 版本启动参数调优容器内运行用户
latest8.3.36✅ 支持环境变量调整 FPM 进程参数root
8.38.3.36❌ 需挂载 www.confwww-data
7.37.3.33❌ 需挂载 www.confwww-data

latest 与 8.3 的 PHP 版本、扩展完全一致,唯一差别是 entrypoint:latest 允许在启动时用环境变量调整 FPM 进程参数,8.3 保持固定配置,适合直接挂载自定义 www.conf。

⁠已安装扩展

8.3 / latest

bcmath、bz2、calendar、event、exif、gd、gettext、imagick、mcrypt、mongodb、mysqli、opcache、pdo_mysql、redis、shmop、snmp、soap、sockets、swoole、sysvmsg、sysvsem、sysvshm、xsl、zip

7.3(额外含 ftp、geoip、recode、wddx,无 mongodb)

bcmath、bz2、calendar、event、exif、ftp、gd、geoip、gettext、imagick、mcrypt、mysqli、pdo_mysql、redis、shmop、snmp、soap、sockets、swoole、sysvmsg、sysvsem、sysvshm、wddx、xsl、zip

⁠快速开始

⁠latest(支持环境变量调参)
docker run --name php-fpm \
  --network=host \
  --restart=always \
  -d \
  -v /root/openresty/html:/usr/local/openresty/nginx/html \
  -e TZ=Asia/Shanghai \
  -e max_children=50 \
  -e start_servers=5 \
  -e min_spare_servers=5 \
  -e max_spare_servers=20 \
  -e max_requests=1024 \
  lushirong/php-fpm:latest
⁠8.3(固定配置,PHP 版本与 latest 相同)
docker run --name php-fpm \
  --network=host \
  --restart=always \
  -d \
  -v /root/openresty/html:/usr/local/openresty/nginx/html \
  -v /opt/php-fpm/docker-vars.ini:/usr/local/etc/php/conf.d/docker-vars.ini \
  -v /opt/php-fpm/www.conf:/usr/local/etc/php-fpm.d/www.conf:ro \
  -e TZ=Asia/Shanghai \
  lushirong/php-fpm:8.3
⁠7.3(兼容老项目)
docker run --name php-fpm \
  --network=host \
  --restart=always \
  -d \
  -v /root/openresty/html:/usr/local/openresty/nginx/html \
  -v /opt/php-fpm/docker-vars.ini:/usr/local/etc/php/conf.d/docker-vars.ini \
  -v /opt/php-fpm/www.conf:/usr/local/etc/php-fpm.d/www.conf:ro \
  -e TZ=Asia/Shanghai \
  lushirong/php-fpm:7.3

不用 host 网络时,把 --network=host 换成 -p 9000:9000。

⁠环境变量(仅 latest)

变量默认值对应配置
max_children50pm.max_children
start_servers5pm.start_servers
min_spare_servers5pm.min_spare_servers
max_spare_servers20pm.max_spare_servers
max_requests1024pm.max_requests
status_path/statuspm.status_path(FPM 状态页路径)
ERRORS空(关闭)设为 1 打开 display_errors
TZAsia/Shanghai容器系统时区(PHP 时区固定 Asia/Shanghai)

⚠️ 参数需满足 min_spare_servers ≤ start_servers ≤ max_spare_servers ≤ max_children,否则 php-fpm 启动失败。

⚠️ 环境变量只作用于 [www] 池;自定义 pool 需要在各自的 .conf 里写死参数(见「多 Pool 配置」)。

⚠️ FPM 状态页默认只在容器内 9000 端口提供 /status,需要 Nginx 侧转发才能外部访问:

location = /status {
    allow 127.0.0.1;
    deny all;
    fastcgi_pass 127.0.0.1:9000;
    include fastcgi_params;
    fastcgi_param SCRIPT_NAME /status;
}

⁠自定义 PHP 配置:挂载 docker-vars.ini

镜像内 /usr/local/etc/php/conf.d/ 下的 .ini 大多由扩展安装产生,唯一适合放自定义指令的是 docker-vars.ini(entrypoint 会自动维护该文件)。把它从宿主机挂载进容器,就能在不准备整份 php.ini 的情况下追加/覆盖任意 PHP 配置:

; /opt/php-fpm/docker-vars.ini
log_errors = On
error_log = /dev/stderr

memory_limit = 512M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
date.timezone = Asia/Shanghai
-v /opt/php-fpm/docker-vars.ini:/usr/local/etc/php/conf.d/docker-vars.ini

说明:

  • 文件名以 docker- 开头,加载顺序早于 zz-*.ini;如需强制覆盖,可另挂 zz-custom.ini
  • 挂载文件里保留 log_errors、error_log 两行时,可安全使用 :ro 只读挂载;缺这两行时 entrypoint 会尝试追加,只读挂载会报权限错误(不影响启动,但日志会有噪音)
  • 修改后 docker restart php-fpm 生效(PHP 不热加载 ini)

⁠多 Pool 配置

默认只有一个 [www] 池(listen = 9000)。主配置已 include=/usr/local/etc/php-fpm.d/*.conf,因此把新的 pool 配置以 .conf 放进该目录即可,容器无需重建。

⚠️ 三条铁律:

  1. 文件名必须以 .conf 结尾,[pool名] 不能重复
  2. listen 不能与 [www] 的 9000 冲突
  3. 不要挂载整个目录到 /usr/local/etc/php-fpm.d/,会覆盖 docker.conf/www.conf 导致启动失败;请逐个文件挂载
⁠场景 1:多站点独立进程池(不同资源配额)

/opt/php-fpm/pool.d/api.conf:

[api]
user = root
group = root
listen = 127.0.0.1:9001
listen.backlog = 511
pm = dynamic
pm.max_children = 30
pm.start_servers = 5
pm.min_spare_servers = 3
pm.max_spare_servers = 10
pm.max_requests = 1000
request_terminate_timeout = 60s
request_slowlog_timeout = 5s
slowlog = /proc/self/fd/2
php_admin_value[memory_limit] = 512M
php_admin_value[upload_max_filesize] = 64M
php_admin_value[post_max_size] = 64M

/opt/php-fpm/pool.d/admin.conf(后台站点,小池 + 按需启动):

[admin]
user = root
group = root
listen = 127.0.0.1:9002
pm = ondemand
pm.max_children = 5
pm.process_idle_timeout = 30s
pm.max_requests = 500
php_admin_value[memory_limit] = 256M

挂载:

-v /opt/php-fpm/pool.d/api.conf:/usr/local/etc/php-fpm.d/api.conf:ro \
-v /opt/php-fpm/pool.d/admin.conf:/usr/local/etc/php-fpm.d/admin.conf:ro

Nginx 按站点分流:

upstream php_api   { server 127.0.0.1:9001; }
upstream php_admin { server 127.0.0.1:9002; }

server {
    server_name api.example.com;
    location ~ \.php$ {
        fastcgi_pass php_api;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

server {
    server_name admin.example.com;
    location ~ \.php$ {
        fastcgi_pass php_admin;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
⁠场景 2:高并发接口池(static 固定进程)

压测过、峰值明确的接口用 static,避免动态扩缩容抖动:

[api-high]
user = root
group = root
listen = 127.0.0.1:9003
pm = static
pm.max_children = 50
pm.max_requests = 2000
request_terminate_timeout = 30s
php_admin_value[memory_limit] = 256M
php_admin_value[opcache.validate_timestamps] = 0

pm = static 会常驻 50 个进程,单进程按 30–50MB 估算,注意容器 --memory 要给够。

⁠场景 3:Unix Socket(同机 Nginx 性能更优)
[www]
user = root
group = root
listen = /run/php-fpm/www.sock
listen.owner = root
listen.group = root
listen.mode = 0660
pm = dynamic
pm.max_children = 50

Nginx 侧:

fastcgi_pass unix:/run/php-fpm/www.sock;

⚠️ 宿主机上的 Nginx 无法直接访问容器内 socket。要么 Nginx 也在容器里并共享该目录,要么把 /run/php-fpm 挂载到宿主机同名路径并让两边路径一致。

⁠场景 4:按用户隔离(多租户)
[tenant-a]
user = www-data
group = www-data
listen = 127.0.0.1:9011
php_admin_value[open_basedir] = /var/www/tenant-a:/tmp
php_admin_value[upload_tmp_dir] = /tmp

user 必须是容器内已存在的用户;latest 默认把 [www] 改成 root,新 pool 可自行指定 www-data 实现降权。

⁠场景 5:每池独立日志与慢日志
[api]
...
access.log = /proc/self/fd/2
access.format = "%R - %u %t \"%m %r%Q%q\" %s %f %{mili}d %{kilo}M %C%%"
slowlog = /proc/self/fd/2
request_slowlog_timeout = 3s

写到 /proc/self/fd/2 即 stderr,docker logs php-fpm 可直接看到,配合 request_slowlog_timeout 定位慢请求调用栈。

⁠验证
docker exec php-fpm php-fpm -t                 # 配置语法检查
docker exec php-fpm php-fpm -tt                # 打印最终生效配置
docker exec php-fpm ps aux | grep 'pool '      # 各池进程
curl http://127.0.0.1:9001/status?full          # 单池状态(需该池配置 status_path)

⁠docker-compose 示例

services:
  php-fpm:
    image: lushirong/php-fpm:latest
    container_name: php-fpm
    restart: always
    network_mode: host
    environment:
      TZ: Asia/Shanghai
      max_children: 50
      start_servers: 5
      min_spare_servers: 5
      max_spare_servers: 20
      max_requests: 1024
    volumes:
      - /root/openresty/html:/usr/local/openresty/nginx/html
      - /opt/php-fpm/docker-vars.ini:/usr/local/etc/php/conf.d/docker-vars.ini
      - /opt/php-fpm/pool.d/api.conf:/usr/local/etc/php-fpm.d/api.conf:ro
      - /opt/php-fpm/pool.d/admin.conf:/usr/local/etc/php-fpm.d/admin.conf:ro

⁠配合 Nginx / OpenResty

location ~ \.php$ {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include        fastcgi_params;
    fastcgi_read_timeout 60s;
}

--network=host 时直接用 127.0.0.1:9000;否则用容器 IP 或 compose 服务名。

⁠验证

docker exec php-fpm php -v              # PHP 版本
docker exec php-fpm php -m              # 已装扩展
docker exec php-fpm php -i | grep memory_limit   # 自定义配置是否生效
docker exec php-fpm grep -E '^pm\.' /usr/local/etc/php-fpm.d/www.conf
docker logs php-fpm                     # 启动与错误日志

⁠说明

  • 镜像不内置 php.ini,使用官方默认 + conf.d 片段;自定义配置建议统一写在挂载的 docker-vars.ini
  • 容器内 PHP 时区固定 Asia/Shanghai,-e TZ= 只影响系统时区
  • latest 的 FPM worker 以 root 运行,挂载宿主机目录一般无权限问题;8.3/7.3 的 worker 为 www-data,注意宿主机目录属主
  • 生产环境可加 --memory、--cpus 等资源限制

Tag summary

Content type

Image

Digest

sha256:32ef88628…

Size

238.7 MB

Last updated

16 days ago

docker pull lushirong/php-fpm