LNMP | php-fpm.conf 优化与容量规划（static / dynamic 调优实战）

适用环境：军哥 LNMP（/usr/local/php/）、Nginx + PHP-FPM + MySQL。
目标：让 PHP-FPM 既不因并发不足产生 502/504，也不因进程过多导致内存吃紧或 OOM。

一、两种进程管理模式

老版本里 dynamic 也叫 apache-like，请以配置文件注释为准。

二、关键参数释义

• pm.max_children：static 下的固定进程数（dynamic 下是上限）。
• pm.start_servers：启动时的子进程数（dynamic）。
• pm.min_spare_servers：最小空闲进程数（dynamic）。
• pm.max_spare_servers：最大空闲进程数（dynamic）。
• pm.process_idle_timeout：空闲进程回收超时，建议 10–30s。
• pm.max_requests：每个子进程处理多少请求后重启，用于缓解内存泄漏（常见 500–5000）。

三、容量规划方法（快速可落地）

1. 测算单个 PHP 子进程内存占用：在业务低峰压一次接口，同时执行

   ps -o rss,cmd -C php-fpm | awk '{sum+=$1} END{print sum/NR/1024 " MB"}'

   得到 avg_child_mem（例如 40–80MB）。

2. 给 PHP 预留可用内存：php_mem_budget = 总内存 × 目标比例 - 其他服务保留。
   • 示例：4GB 机器，给 PHP 预留 2.2GB，Nginx/MySQL/系统保留 1.8GB。
3. 计算最大进程：

   pm.max_children = floor( php_mem_budget / avg_child_mem )

   示例：2200MB / 50MB ≈ 44，取 40–44。

4. dynamic 推荐初值（经验法则）：
   • pm.start_servers ≈ 0.2 × pm.max_children
   • pm.min_spare_servers ≈ 0.1–0.2 × pm.max_children
   • pm.max_spare_servers ≈ 0.4–0.6 × pm.max_children

注意：开启 opcache 会显著降低平均内存与 CPU 抖动；大并发上传/图片处理会临时抬升单进程内存，请留安全余量（10–20%）。

四、可直接使用的配置模板（军哥 LNMP）

编辑：/usr/local/php/etc/php-fpm.conf

; ====== 基础与日志 ======
error_log = /app/logs/php-fpm.log
log_level  = error
events.mechanism = epoll

; 监听与权限（与 Nginx 用户一致）
listen = 127.0.0.1:9000
; 或者：listen = /dev/shm/php-fpm.sock
; listen.owner = www
; listen.group = www
; listen.mode  = 0660

; ====== 进程管理 ======
pm = dynamic
pm.max_children = 52              ; 上限（由容量规划得出）
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 25
pm.process_idle_timeout = 20s
pm.max_requests = 2048

; ====== 慢日志 ======
slowlog = /app/logs/$pool.log.slow
request_slowlog_timeout = 10s

; ====== 资源限制 ======
rlimit_files = 32768
request_terminate_timeout = 100s

; 仅示例变化部分
pm = static
pm.max_children = 40      ; 固定进程数（容量规划计算值）
pm.max_requests = 2000
pm.process_idle_timeout = 0s

你文中的示例参数（如 pm.max_children = 52、pm.start_servers = 5 等）是合理起点，但请按上文计算法结合同机内存与业务压力调整。

五、应用与验证

# 1) 语法自检
/usr/local/php/sbin/php-fpm -t

# 2) 平滑重载（推荐）
/usr/local/php/sbin/php-fpm -y /usr/local/php/etc/php-fpm.conf -t
kill -USR2 $(cat /usr/local/php/var/run/php-fpm.pid)  2>/dev/null || systemctl reload php-fpm

# 3) 查看进程与监听
ss -lntp | grep php-fpm
ps -ef | grep php-fpm

Nginx 配合（片段）：

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass 127.0.0.1:9000;  # 或 unix:/dev/shm/php-fpm.sock
    fastcgi_connect_timeout 60;
    fastcgi_send_timeout 180;
    fastcgi_read_timeout 180;
}

六、常见问题与排错

七、调优建议清单

• 开启 opcache（opcache.enable=1，opcache.memory_consumption=128–256）。
• 静态资源走 Nginx，PHP 勿做文件直传；上传用分片或异步后端。
• 压测找“拐点”：逐步提高并发，观察 QPS、P95 延迟与 RSS/CPU 曲线。
• 记录基线：变更前后保留 nginx access_log、php-fpm.log、系统监控。

附：你给出的示例参数说明（对照）

/usr/local/php/etc/php-fpm.conf

error_log = /app/logs/php-fpm.log
log_level  = error
events.mechanism = epoll

listen.owner = www
listen.group = www

pm.max_children = 52
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 25

pm.process_idle_timeout = 20s
pm.max_requests = 2048

slowlog = /app/logs/$pool.log.slow
rlimit_files = 32768
request_terminate_timeout = 100s
request_slowlog_timeout = 10s

查看进程：

ps -ef | grep fpm

FAQ