PHP-FPM (FastCGI Process Manager) 是 PHP 生產環境標準運行模式。合理配置 php-fpm.conf 與池配置 www.conf,能顯著提升吞吐、穩定內存、避免 502 錯誤。本文逐項解析核心參數,提供調優建議。
; 進程管理
pid = run/php-fpm.pid # PID 文件路徑,建議開啟便於監控腳本
error_log = log/php-fpm.log # 錯誤日志路徑
log_level = notice # 日志級別:alert/error/warning/notice/debug
emergency_restart_threshold = 60 # 60 秒內
emergency_restart_interval = 60s # 若超過 60 個子進程因 SIGSEGV/SIGBUS 退出,主進程優雅重啟
process_control_timeout = 0 # 子進程等待主進程信號超時 (0=不限制)
daemonize = yes # 守護進程模式 (調試時改 no)
每個池獨立配置,可運行不同用戶、不同參數的 PHP 實例。
listen = 127.0.0.1:9000 # TCP 監聽 (Nginx 配置 fastcgi_pass 127.0.0.1:9000)
; listen = /run/php/php7.4-fpm.sock # Unix Socket (高性能、本機通信首選)
listen.backlog = 511 # 內核連接隊列長度 (-1 為系統默認)
listen.allowed_clients = 127.0.0.1 # 允許連接的客戶端 IP (any=不限制)
listen.owner = www
listen.group = www
listen.mode = 0660 # Socket 權限 (TCP 模式忽略)
user = www
group = www
| 模式 | 適用場景 | 核心參數 |
|---|---|---|
| static | 專用高負載服務器、內存充足、追求極致性能 | pm.max_children |
| dynamic | 通用場景、共享服務器、內存受限 | pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers |
| ondemand | 低流量、間歇性請求、極度節省內存 | pm.max_children, pm.process_idle_timeout |
pm = dynamic
pm.max_children = 50 # 最大子進程數 (關鍵:根據內存計算)
pm.start_servers = 10 # 啟動時創建的進程數
pm.min_spare_servers = 5 # 最小空閒進程數 (低於此值創建新進程)
pm.max_spare_servers = 20 # 最大空閒進程數 (超過此值殺掉多餘進程)
max_children = (Total_RAM - Reserved_RAM) / Avg_Process_Memory
# 例:4GB 內存,預留 1GB 給系統/DB/緩存,單進程平均 30MB
# (4096 - 1024) / 30 ≈ 100 → 設置 80-100 留有餘地
pm.max_requests = 1000 # 每個子進程處理 1000 請求後重生 (防內存洩漏,0=不限制)
request_terminate_timeout = 0 # 單請求硬超時 (0=關閉,建議 30-60s 防卡死)
request_slowlog_timeout = 10s # 慢日志觸發閾值 (0=關閉)
slowlog = log/$pool.log.slow # 慢日志路徑 (配合 request_slowlog_timeout)
rlimit_files = 1024 # 打開文件描述符限制 (ulimit -n)
rlimit_core = 0 # Core dump 大小限制 (0=禁用,unlimited=不限制)
chroot = # 啟動後 chroot 目錄 (安全增強,絕對路徑)
chdir = /var/www # 啟動後切換工作目錄
catch_workers_output = yes # 捕獲子進程 stdout/stderr 到錯誤日志 (調試必開)
pm.status_path = /status # 狀態頁面 URL (需 Nginx location 轉發)
ping.path = /ping # 健康檢查端點
ping.response = pong # 返回內容
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000; # 或 unix:/run/php/php7.4-fpm.sock
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
# 狀態頁訪問控制
location ~ ^/(status|ping)$ {
allow 127.0.0.1;
deny all;
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
}
}
pm.max_children 基於實測內存佔用計算,而非猜測。pm.max_requests (500-2000) 防第三方擴展內存洩漏。request_terminate_timeout (30s-60s) 兜底殺死卡死進程。slowlog + request_slowlog_timeout (5s-10s) 定位慢請求。catch_workers_output = yes 確保錯誤不丟失。listen.backlog = 8192 + 內核參數 net.core.somaxconn。/status?full&json 監控 active/idle 進程數、請求耗時分布。PHP-FPM 配置核心在於「進程數 = 內存 / 單進程內存」的動態平衡。Dynamic 模式適合大多數場景,Static 適合極致性能,Ondemand 適合低流量。監控 /status、分析 slowlog、根據業務流量週期調整參數,是運維常態化工作。