萬盛學電腦網

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

解決 IIS + FastCGI PHP 請求逾時:RequestTimeout 與 ActivityTimeout 設定

前言

在 IIS 6+FastCGI 環境執行 PHP 時,長時間執行的腳本常遇到「The FastCGI process exceeded configured request timeout」錯誤。本文說明透過修改 `fcgiext.ini` 解決逾時問題的完整步驟。

錯誤類型與對應參數

錯誤訊息相關參數說明
FastCGI process exceeded configured request timeoutRequestTimeout單一請求允許的最大執行秒數
FastCGI process exceeded configured activity timeoutActivityTimeout進程無回應的最大秒數(含網路等待)

設定檔位置與修改

檔案位置

C:\WINDOWS\system32\inetsrv\fcgiext.ini

完整設定範例

[Types]
php=PHP

[PHP]
ExePath=C:\PHP\php-cgi.exe
InstanceMaxRequests=10000
EnvironmentVars=PHP_FCGI_MAX_REQUESTS:10000
RequestTimeout=500
ActivityTimeout=900

參數詳細說明

RequestTimeout(請求逾時)

  • 預設: 90 秒
  • 建議: 300-600 秒(視腳本複雜度)
  • 控制單一 HTTP 請求的最大處理時間
  • 超過此時間 IIS 會強制終止 FastCGI 進程

ActivityTimeout(活動逾時)

  • 預設: 30 秒
  • 建議: 300-900 秒
  • 控制 FastCGI 進程「無任何活動」的最大容忍時間
  • 包含:等待資料庫查詢、外部 API 呼叫、檔案 I/O 等待

InstanceMaxRequests / PHP_FCGI_MAX_REQUESTS

  • 單一 `php-cgi.exe` 進程處理請求數上限
  • 達到上限後自動回收重啟,防止記憶體洩漏
  • 建議值:5000-10000

PHP 端同步設定

在 `php.ini` 中同步調整:

; php.ini
max_execution_time = 300      ; 對應 RequestTimeout
max_input_time = 300          ; 輸入資料處理時間
memory_limit = 256M           ; 視需求調整

; 確保 FastCGI 環境變數一致
; PHP_FCGI_MAX_REQUESTS=10000 (在 fcgiext.ini 已設定)

IIS 7+ / IIS 10 現代設定方式

新版 IIS 使用 `applicationHost.config` 或網站 `web.config`:

web.config 範例

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <fastCgi>
            <application fullPath="C:\PHP\php-cgi.exe" 
                         requestTimeout="00:10:00" 
                         activityTimeout="00:15:00"
                         instanceMaxRequests="10000">
                <environmentVariables>
                    <environmentVariable name="PHP_FCGI_MAX_REQUESTS" value="10000" />
                </environmentVariables>
            </application>
        </fastCgi>
        
        <handlers>
            <add name="PHP_via_FastCGI" 
                 path="*.php" 
                 verb="*" 
                 modules="FastCgiModule" 
                 scriptProcessor="C:\PHP\php-cgi.exe" 
                 resourceType="Either" />
        </handlers>
    </system.webServer>
</configuration>

驗證設定生效

<?php
// test_timeout.php
// 測試長時間執行腳本
ini_set('max_execution_time', 600);

echo "開始測試: " . date('H:i:s') . "<br>";
sleep(120); // 睡眠 2 分鐘
echo "結束測試: " . date('H:i:s') . "<br>";
echo "若看到此訊息,逾時設定已生效";
?>

常見問題排查

現象可能原因解決方向
修改後仍逾時未重啟 IIS執行 `iisreset` 或重啟網站
修改後仍逾時php.ini max_execution_time 較小同步調整 php.ini 設定
500 錯誤fcgiext.ini 格式錯誤檢查編碼為 ANSI/UTF-8 無 BOM,語法正確
記憶體耗盡長時間腳本累積記憶體調高 memory_limit、分批處理、加入 gc_collect_cycles()

生產環境建議

  • 將長時間任務移至**背景工作佇列**(如 Gearman、Redis Queue、RabbitMQ)
  • Web 請求僅觸發任務並回傳任務 ID,前端輪詢狀態
  • 設定合理的逾時值,避免資源被長佔用
  • 監控 FastCGI 進程數與記憶體使用
copyright © 萬盛學電腦網 all rights reserved