萬盛學電腦網

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

PHP-FPM 配置深度解析:核心參數調優與多進程池管理

前言

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

進程管理策略:pm

模式適用場景核心參數
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

Dynamic 模式參數詳解

pm = dynamic
pm.max_children = 50          # 最大子進程數 (關鍵:根據內存計算)
pm.start_servers = 10         # 啟動時創建的進程數
pm.min_spare_servers = 5      # 最小空閒進程數 (低於此值創建新進程)
pm.max_spare_servers = 20     # 最大空閒進程數 (超過此值殺掉多餘進程)

max_children 計算公式

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          # 返回內容

Nginx 配置聯動

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;
    }
}

調優檢查清單

  1. 確認 pm.max_children 基於實測內存佔用計算,而非猜測。
  2. 開啟 pm.max_requests (500-2000) 防第三方擴展內存洩漏。
  3. 設置 request_terminate_timeout (30s-60s) 兜底殺死卡死進程。
  4. 開啟 slowlog + request_slowlog_timeout (5s-10s) 定位慢請求。
  5. 生產環境 catch_workers_output = yes 確保錯誤不丟失。
  6. 高併發改用 Unix Socket + listen.backlog = 8192 + 內核參數 net.core.somaxconn。
  7. 定期分析 /status?full&json 監控 active/idle 進程數、請求耗時分布。

總結

PHP-FPM 配置核心在於「進程數 = 內存 / 單進程內存」的動態平衡。Dynamic 模式適合大多數場景,Static 適合極致性能,Ondemand 適合低流量。監控 /status、分析 slowlog、根據業務流量週期調整參數,是運維常態化工作。

copyright © 萬盛學電腦網 all rights reserved