萬盛學電腦網

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

PHP 超時控制全景圖:Web 服務器、PHP-FPM、數據庫、HTTP 客戶端多層超時配置與最佳實踐

前言

「超時」是分布式系統穩定性的基石。PHP 請求鏈路涉及 Nginx/Apache → PHP-FPM → PHP 腳本 → MySQL/Redis/HTTP API 等多層,每層都有獨立的超時機制。任一層配置不當,均會導致請求失敗、資源洩漏、甚至雪崩。本文系統梳理全鏈路超時配置、傳播機制與最佳實踐。

一、全鏈路超時層級圖


用戶瀏覽器
    │ (客戶端超時: 瀏覽器默認 300s)
    ▼
Nginx / Apache (反向代理/靜態服務)
    │ proxy_read_timeout / Timeout
    ▼
PHP-FPM (進程管理器)
    │ request_terminate_timeout / request_slowlog_timeout
    ▼
PHP 腳本執行
    │ max_execution_time / set_time_limit()
    │ default_socket_timeout (流操作)
    ▼
下游服務
    ├─ MySQL: MYSQL_OPT_CONNECT_TIMEOUT / MYSQL_OPT_READ_TIMEOUT / MAX_EXECUTION_TIME
    ├─ Redis: redis-cli --raw / phpredis read_timeout
    ├─ HTTP API: cURL CURLOPT_TIMEOUT / CURLOPT_CONNECTTIMEOUT
    └─ 外部服務: gRPC deadline, MQ TTL

二、各層核心配置詳解

1. Nginx (反向代理層)

# nginx.conf / location 塊
location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    # FastCGI 專用超時
    fastcgi_connect_timeout 5s;     # 連接 PHP-FPM 超時
    fastcgi_send_timeout 60s;       # 發送請求體超時
    fastcgi_read_timeout 300s;      # 讀取響應超時 (關鍵!需 ≥ PHP max_execution_time)
    fastcgi_buffer_size 128k;
    fastcgi_buffers 4 256k;
    fastcgi_busy_buffers_size 256k;
}

# 通用代理超時 (若 Nginx 代理其他 HTTP 服務)
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 300s;
send_timeout 60s;           # 向客戶端發送響應超時
client_body_timeout 60s;    # 讀取客戶端請求體超時
client_header_timeout 60s;  # 讀取客戶端請求頭超時
keepalive_timeout 65s;      # Keep-Alive 空閒超時

2. Apache (mod_proxy_fcgi / mod_php)

# mod_proxy_fcgi (Apache 2.4.10+)

    ProxySet timeout=300  # 總超時 (秒)

ProxyPassMatch ^/(.*\.php)$ fcgi://localhost:9000/var/www/html/$1

# mod_php (prefork)
Timeout 300  # 全局請求超時 (含請求讀取、腳本執行、響應發送)
# 或虛擬主機級

    TimeOut 300

3. PHP-FPM 池配置 (www.conf)

; 請求硬性終止超時 (強制 kill worker,防止卡死佔用槽位)
request_terminate_timeout = 300s  ; 默認 0 (不限制),生產建議 300-600s

; 慢日誌閾值 (記錄慢請求堆棧,不終止)
request_slowlog_timeout = 10s     ; 觸發慢日誌的執行時間
slowlog = /var/log/php-fpm/slow.log

; 進程管理策略
pm = dynamic
pm.max_children = 100
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30
pm.max_requests = 10000  ; 防記憶體洩漏,定期回收 worker

4. PHP 執行層 (php.ini / 運行時)

; php.ini
max_execution_time = 300      ; 腳本最大執行秒數 (CLI 默認 0 無限制)
max_input_time = 60           ; 解析 POST/GET/文件上傳數據最長秒數
memory_limit = 256M           ; 內存限制
default_socket_timeout = 60   ; 流操作 (file_get_contents, fsockopen, PDO 默認) 讀取超時

; 運行時動態調整 (僅影響當前腳本)
set_time_limit(600);          // 重置最大執行時間 (累計)
ini_set('max_execution_time', 600); // 同效
ini_set('default_socket_timeout', 10); // 修改流超時

關鍵區別: `max_execution_time` 只計算 CPU 時間 (不含系統調用、數據庫等待、sleep),而 `request_terminate_timeout` 是實時牆鐘時間。建議:FPM 設置略大於 PHP 設置 (如 FPM 300s, PHP 280s),由 PHP 先拋出 `Maximum execution time exceeded` 異常,便於捕獲日誌;FPM 作為最後防線強制回收進程。

5. MySQL 客戶端超時

<?php
$pdo = new PDO(
    "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4",
    'user', 'pass',
    [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_EMULATE_PREPARES => false,
        // 連接階段超時
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET SESSION wait_timeout=300", // 服務端空閒斷開
        // PDO 本身無連接超時選項,依賴 default_socket_timeout
    ]
);
// 原生 mysqli 可精確控制
$mysqli = mysqli_init();
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);   // 連接超時 5s
$mysqli->options(MYSQLI_OPT_READ_TIMEOUT, 30);     // 讀取超時 30s
$mysqli->real_connect('127.0.0.1', 'user', 'pass', 'test', 3306);

// SQL 執行超時 (MySQL 5.7.8+ / MariaDB 10.4.6+)
$pdo->exec("SET SESSION MAX_EXECUTION_TIME=5000"); // 毫秒,僅對 SELECT 生效

6. Redis (phpredis 擴展)

<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379, 2.5); // 連接超時 2.5s (浮點秒)
$redis->setOption(Redis::OPT_READ_TIMEOUT, 1.5); // 讀取超時 1.5s
$redis->setOption(Redis::OPT_WRITE_TIMEOUT, 1.5); // 寫入超時 (phpredis 5.3+)
// 管道/事務不單獨受此控制,需整體鏈路超時

7. HTTP 客戶端 (Guzzle / cURL)

// Guzzle 7+ (推薦)
$client = new GuzzleHttp\Client([
    'timeout' => 10.0,          // 總超時 (含連接、傳輸)
    'connect_timeout' => 2.0,   // 僅連接階段
    'http_errors' => false,     // 非 2xx 不拋異常,自行判斷
]);
$response = $client->get('https://api.example.com/data');

// 原生 cURL 精細控制
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_TIMEOUT_MS => 10000,        // 總超時毫秒
    CURLOPT_CONNECTTIMEOUT_MS => 2000,  // 連接超時毫秒
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_MAXREDIRS => 3,
    CURLOPT_NOSIGNAL => 1,              // 多線程環境必開
]);
$result = curl_exec($ch);

三、超時傳播與取消機制

理想狀態:上層超時觸發時,能取消下游進行中的操作,釋放資源。

  • Nginx → PHP-FPM: Nginx 關閉 FastCGI 連接 → PHP-FPM 收到 `SIGPIPE`/`ECONNRESET` → 觸發 `request_terminate_timeout` 邏輯殺死 Worker。但 PHP 腳本可能仍在運行 (除非註冊 `fastcgi_finish_request()` 後繼續)。
  • PHP → MySQL/Redis/HTTP: PHP 端超時拋出異常後,**無法自動取消下游已發出的查詢/請求**。下游仍在執行佔用資源,直到其自身超時或完成。
  • 解決方案:
    1. 下游服務自身配置合理超時 (MySQL `MAX_EXECUTION_TIME`、Redis `read_timeout`、HTTP 服務端超時)。
    2. 使用支援取消的客戶端 (如 Swoole 協程、ReactPHP、Guzzle Promise + cancellation token)。
    3. 引入分布式追蹤 透傳截止時間,下游主動檢查截止時間提前返回。

四、場景化配置建議

場景Nginx fastcgi_read_timeoutFPM request_terminate_timeoutPHP max_execution_time下游超時
常規 CRUD API30s60s25sDB 5s, Redis 0.5s, HTTP 3s
大文件上傳300s600s0 (CLI) / 300s調大讀寫超時
報表導出/異步任務600s1200s0 (CLI 推薦)DB 300s, 異步隊列無超時
高併發閃賣5s10s3sRedis 0.2s (Lua 腳本原子操作)
Webhook 回調10s20s8sHTTP 5s, 異步處理業務邏輯

五、監控與告警

  • 關鍵指標: 請求耗時分位 (P50/P95/P99)、超時率、慢日誌條數、FPM 活躍/閒置進程數、MySQL 慢查詢數、Redis 命令耗時。
  • 工具: Prometheus + Grafana (php-fpm-exporter, node_exporter, mysqld_exporter)、Datadog、New Relic、SkyWalking。
  • 告警規則: P99 延遲 > 閾值 5min、超時率 > 1%、FPM 進程滿載 > 80% 持續 10min。

六、總結:超時配置鐵律

  1. 層層遞減: 客戶端 > Nginx > FPM > PHP > 下游。每層預留 10-20% 緩衝。
  2. 區分連接/讀寫/總超時: 連接超時短 (1-5s),讀寫超時視業務,總超時最長。
  3. 異步化長任務: 超過 30s 的業務務必異步 (隊列 + Worker),Web 請求秒級返回。
  4. 下游自護: 每個下游服務必須有自身的超時保護,不依賴上游取消。
  5. 定期演練: 混沌工程注入延遲/超時,驗證熔斷、降級、重試、告警鏈路完整性。
copyright © 萬盛學電腦網 all rights reserved