php-fpm 预装 gd、mysqli、pdo_mysql、redis、mongodb、swoole等扩展
3.3K
基于官方 php:*-fpm 构建的 PHP-FPM 镜像,预装常用扩展,开箱即用。适用于 LNMP、OpenResty/Nginx 反代、单机部署等场景。
9000/tcpAsia/Shanghai(写入 /usr/local/etc/php/conf.d/timezone.ini,无需额外设置)log_errors = On、error_log = /dev/stderr,docker logs 可直接查看 PHP 错误| 标签 | PHP 版本 | 启动参数调优 | 容器内运行用户 |
|---|---|---|---|
latest | 8.3.36 | ✅ 支持环境变量调整 FPM 进程参数 | root |
8.3 | 8.3.36 | ❌ 需挂载 www.conf | www-data |
7.3 | 7.3.33 | ❌ 需挂载 www.conf | www-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
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
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
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_children | 50 | pm.max_children |
start_servers | 5 | pm.start_servers |
min_spare_servers | 5 | pm.min_spare_servers |
max_spare_servers | 20 | pm.max_spare_servers |
max_requests | 1024 | pm.max_requests |
status_path | /status | pm.status_path(FPM 状态页路径) |
ERRORS | 空(关闭) | 设为 1 打开 display_errors |
TZ | Asia/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;
}
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.inilog_errors、error_log 两行时,可安全使用 :ro 只读挂载;缺这两行时 entrypoint 会尝试追加,只读挂载会报权限错误(不影响启动,但日志会有噪音)docker restart php-fpm 生效(PHP 不热加载 ini)默认只有一个 [www] 池(listen = 9000)。主配置已 include=/usr/local/etc/php-fpm.d/*.conf,因此把新的 pool 配置以 .conf 放进该目录即可,容器无需重建。
⚠️ 三条铁律:
.conf 结尾,[pool名] 不能重复listen 不能与 [www] 的 9000 冲突/usr/local/etc/php-fpm.d/,会覆盖 docker.conf/www.conf 导致启动失败;请逐个文件挂载/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;
}
}
压测过、峰值明确的接口用 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要给够。
[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 挂载到宿主机同名路径并让两边路径一致。
[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 实现降权。
[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)
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
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.iniAsia/Shanghai,-e TZ= 只影响系统时区latest 的 FPM worker 以 root 运行,挂载宿主机目录一般无权限问题;8.3/7.3 的 worker 为 www-data,注意宿主机目录属主--memory、--cpus 等资源限制Content type
Image
Digest
sha256:32ef88628…
Size
238.7 MB
Last updated
16 days ago
docker pull lushirong/php-fpm