php-fpm (FastCGI Process Manager) 是 PHP 生產環境最主流的運行模式。正確掌握其啟動參數與關鍵配置,能顯著提升服務穩定性與效能。本文整理了常用啟動命令、核心配置項說明及常見問題排查方案。
/usr/local/php/sbin/php-fpm # 主程式
/usr/local/php/etc/php-fpm.conf # 主配置檔
/usr/local/php/etc/php.ini # PHP 配置檔
/usr/local/php/var/run/php-fpm.pid # PID 檔(預設)
/usr/local/php/var/log/php-fpm.log # 錯誤日誌(預設)
| 操作 | 命令 | 說明 |
|---|---|---|
| 測試配置 | php-fpm -t |
僅檢查語法,不啟動。可指定配置:-c php.ini -y php-fpm.conf -t |
| 前台啟動 | php-fpm |
前台運行,適合容器/調試。加 -D 可後台守護進程模式(預設即為守護)。 |
| 指定配置啟動 | php-fpm -c /path/php.ini -y /path/php-fpm.conf |
明確指定 php.ini 與 php-fpm.conf 路徑。 |
| 優雅關閉 | kill -INT `cat /usr/local/php/var/run/php-fpm.pid` |
發送 SIGINT,等待當前請求處理完畢再退出。 |
| 優雅重啟 | kill -USR2 `cat /usr/local/php/var/run/php-fpm.pid` |
發送 SIGUSR2,平滑重載配置與工作進程,零停機。 |
pm = dynamic # static | dynamic | ondemand
pm.max_children = 50 # 靜態模式固定進程數 / 動態模式最大進程數
pm.start_servers = 10 # 動態模式啟動時創建的進程數
pm.min_spare_servers = 5 # 動態模式最小空閒進程數
pm.max_spare_servers = 20 # 動態模式最大空閒進程數
pm.max_requests = 1000 # 每個子進程處理請求數達到後重生(防記憶體洩漏),0 為不限制
選型建議:
static:專用高併發服務器,記憶體充足,避免動態調度開銷。dynamic:通用場景,根據負載自動伸縮。ondemand:低流量站點,無請求時不創建進程,節省記憶體。listen = 127.0.0.1:9000 # TCP 監聽,Nginx 配置 fastcgi_pass 127.0.0.1:9000
; listen = /var/run/php-fpm.sock # Unix Socket,本機通訊效能更高
listen.backlog = -1 # 內核監聽隊列長度,-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
rlimit_files = 10240 # 進程最大打開文件數,建議調大
rlimit_core = 0 # 核心轉儲大小,0 禁用
request_terminate_timeout = 30s # 單請求最大執行時間,0 為不限制(防卡死)
request_slowlog_timeout = 5s # 超過此時間記錄慢日誌
slowlog = /usr/local/php/var/log/slow.log
error_log = /usr/local/php/var/log/php-fpm.log
log_level = notice # alert | error | warning | notice | debug
catch_workers_output = yes # 將 stdout/stderr 重導向至 error_log
; access.log 格式可自定義
access.log = /usr/local/php/var/log/access.log
access.format = "%R - %u %t \"%m %r%Q%q\" %s %f %{mili}d %{kilo}M %C%%"
emergency_restart_threshold = 10 # 10 個子進程在
emergency_restart_interval = 1m # 1 分鐘內因 SIGSEGV/SIGBUS 退出,則主進程優雅重啟
現象:長時間運行的腳本(如 file_get_contents 抓取遠程資源)導致所有 worker 忙碌,Nginx 返回 502。
原因:php.ini 的 max_execution_time 在 CLI/FASTCGI 模式下不生效,真正生效的是 request_terminate_timeout。預設為 0(無限制)。
解決:
request_terminate_timeout = 30sstream_context_create(['http' => ['timeout' => 10]])現象:高併發時頻繁出現 502,日誌顯示進程頻繁重生。
原因:pm.max_requests = 1000 導致進程頻繁回收重建,若請求隊列處理不當,新進程未就緒時請求失敗。
解決:
20000 或 0(配合定期 reload)。kill -USR2 重啟。request_slowlog_timeout = 2s
slowlog = /var/log/php-fpm/$pool.slow.log
執行 tail -f /var/log/php-fpm/www.slow.log 即可即時查看慢請求堆疊,常見:
catch_workers_output = yes,確保 var_dump、echo 等輸出進入錯誤日誌。pm.status_path = /status、ping.path = /ping,配合監控系統(Prometheus、Zabbix)採集指標。php-fpm -t 驗證配置語法,納入 CI/CD 流程。pm.max_children:可用記憶體 / 單進程平均記憶體,預留 20% 緩衝。