萬盛學電腦網

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

PHP-FPM (FastCGI) 執行逾時設定完整指南:max_execution_time、request_terminate_timeout、Nginx proxy_read_timeout

三層逾時機制

層級設定項預設值作用範圍優先級
PHP 腳本max_execution_time (php.ini / ini_set / set_time_limit)30 秒單腳本 CPU 時間最低
PHP-FPM 池request_terminate_timeout (php-fpm.conf / www.conf)0 (關閉)單請求牆鐘時間中
Nginx 反向代理proxy_read_timeout / proxy_send_timeout / proxy_connect_timeout60 秒等待上游回應最高 (最先生效)

常見誤區:為何 set_time_limit(0) 不生效?

PHP-FPM 的 request_terminate_timeout 預設可能被設為 30s(部分發行版預設)。當請求處理時間超過此值,FPM **直接殺掉 Worker 進程**,PHP 腳本連 register_shutdown_function 都來不及執行,自然也無法繼續跑。

正確配置步驟

1. PHP 端 (php.ini / .user.ini / 代碼)

; php.ini
max_execution_time = 300 ; 5 分鐘

; 或腳本內動態調整 (需未被 disable_functions 禁用)
ini_set('max_execution_time', 300);
set_time_limit(300); // 相同效果

2. PHP-FPM 端 (www.conf)

; /etc/php/8.1/fpm/pool.d/www.conf
; 0 表示關閉,由 PHP 端 max_execution_time 控制
; 若需 FPM 層面保護,設為比 PHP 端大的值 (如 360s)
request_terminate_timeout = 360s

; 另一相關參數:請求緩衝
request_slowlog_timeout = 10s
slowlog = /var/log/php-fpm/$pool-slow.log

3. Nginx 端 (nginx.conf / site.conf)

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    # 這三個必須 >= FPM request_terminate_timeout
    fastcgi_read_timeout  360s;
    fastcgi_send_timeout  360s;
    fastcgi_connect_timeout 60s;
    
    # 傳遞真實 IP
    fastcgi_param REMOTE_ADDR $remote_addr;
    include fastcgi_params;
}

長時間任務的正確架構

不要在 HTTP 請求中直接跑超過 30 秒的任務。

  1. 立即回應:控制器驗證參數 → 寫入任務佇列 (Redis List, RabbitMQ, database queue) → 回傳 202 Accepted + 任務 ID。
  2. 背景消費:Worker 進程 (Supervisor + PHP CLI、Laravel Queue Worker、Golang Service) 消費佇列,執行匯出、報表、推播等。
  3. 輪詢/推播狀態:前端輪詢 /api/task/{id} 或 WebSocket/Server-Sent Events 接收完成通知。
  4. 檔案下載:任務完成生成檔案存至物件儲存 (S3/MinIO) 或本地快取目錄,回傳簽名 URL 供前端下載。

除錯檢查清單

# 1. 確認生效配置
php -i | grep max_execution_time
php-fpm -i | grep request_terminate_timeout

# 2. 測試腳本
copyright © 萬盛學電腦網 all rights reserved