萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

php-fpm 啟動參數與核心配置詳解

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,平滑重載配置與工作進程,零停機。

三、php-fpm.conf 核心配置項深度解析

1. 進程管理模式

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:低流量站點,無請求時不創建進程,節省記憶體。

2. 監聽與通訊

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 模式下忽略

3. 進程身份與資源限制

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

4. 日誌與除錯

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%%"

5. 緊急重啟機制

emergency_restart_threshold = 10  # 10 個子進程在
emergency_restart_interval = 1m   # 1 分鐘內因 SIGSEGV/SIGBUS 退出,則主進程優雅重啟

四、常見問題與解決方案

1. request_terminate_timeout 導致 502 Bad Gateway

現象:長時間運行的腳本(如 file_get_contents 抓取遠程資源)導致所有 worker 忙碌,Nginx 返回 502。

原因:php.ini 的 max_execution_time 在 CLI/FASTCGI 模式下不生效,真正生效的是 request_terminate_timeout。預設為 0(無限制)。

解決:

  • 設定合理超時:request_terminate_timeout = 30s
  • 在腳本層面為外部請求加超時:stream_context_create(['http' => ['timeout' => 10]])
  • 異步化長任務:使用佇列 + Worker 處理,HTTP 請求秒級返回。

2. pm.max_requests 過小引發間歇性 502

現象:高併發時頻繁出現 502,日誌顯示進程頻繁重生。

原因:pm.max_requests = 1000 導致進程頻繁回收重建,若請求隊列處理不當,新進程未就緒時請求失敗。

解決:

  • 根據記憶體洩漏情況調大,如 20000 或 0(配合定期 reload)。
  • 監控記憶體增長趨勢,若無明顯洩漏可設為 0,由外部腳本定時 kill -USR2 重啟。

3. 善用慢日誌定位效能瓶頸

request_slowlog_timeout = 2s
slowlog = /var/log/php-fpm/$pool.slow.log

執行 tail -f /var/log/php-fpm/www.slow.log 即可即時查看慢請求堆疊,常見:

  • 資料庫查詢過慢(缺索引、鎖等待)
  • 外部 API 呼叫阻塞
  • 大量文件 I/O 或序列化操作

五、生產環境建議清單

  1. 啟用 catch_workers_output = yes,確保 var_dump、echo 等輸出進入錯誤日誌。
  2. 設定 pm.status_path = /status、ping.path = /ping,配合監控系統(Prometheus、Zabbix)採集指標。
  3. 使用 Unix Socket 替代 TCP,減少協議開銷(需 Nginx 與 PHP-FPM 同機)。
  4. 定期執行 php-fpm -t 驗證配置語法,納入 CI/CD 流程。
  5. 根據服務器記憶體計算 pm.max_children:可用記憶體 / 單進程平均記憶體,預留 20% 緩衝。
copyright © 萬盛學電腦網 all rights reserved