| 層級 | 設定項 | 預設值 | 作用範圍 | 優先級 |
|---|---|---|---|---|
| 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_timeout | 60 秒 | 等待上游回應 | 最高 (最先生效) |
PHP-FPM 的 request_terminate_timeout 預設可能被設為 30s(部分發行版預設)。當請求處理時間超過此值,FPM **直接殺掉 Worker 進程**,PHP 腳本連 register_shutdown_function 都來不及執行,自然也無法繼續跑。
; php.ini
max_execution_time = 300 ; 5 分鐘
; 或腳本內動態調整 (需未被 disable_functions 禁用)
ini_set('max_execution_time', 300);
set_time_limit(300); // 相同效果
; /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
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 秒的任務。
202 Accepted + 任務 ID。/api/task/{id} 或 WebSocket/Server-Sent Events 接收完成通知。# 1. 確認生效配置
php -i | grep max_execution_time
php-fpm -i | grep request_terminate_timeout
# 2. 測試腳本