FastCGI SAF 參數

除非另有明確說明，否則 FastCGI 外掛程式 SAF「auth-fastcgi」、「responder-fastcgi」和「filter-fastcgi」均可接受下列參數：

請注意，參數 chroot、user、group 和 nice 僅適用於 UNIX 平台。這些參數在 Windows 平台上會被忽略。

• app-path - (可選擇) 處理請求的 FastCGI 應用程式路徑。此功能取決於 bind-path 參數的值，如下所示：

  1. 如果僅指定 app-path，則外掛程式將建立 FastCGI 應用程式，用於偵聽由外掛程式建立的 UNIX 網域通訊端。但是，僅 UNIX 平台接受此參數。在 Windows 上，會記錄一則錯誤訊息。

  2. 如果同時指定 app-path 和 bind-path，則外掛程式將啟動指定的 FastCGI 應用程式程序，並將其連結至指定的 bind-path。

  3. 如果僅指定 bind-path，則會將 FastCGI 應用程序視為遠端執行。因此，外掛程式將不會啟動 FastCGI 應用程式程序。

  4. 如果「app-path」和「bind-path」均未指定，則外掛程式將記錄一則錯誤訊息。

• app-args — (可選擇) 當成引數傳送至 FastCGI 應用程式程序的值。您可使用多個 app-args 參數。使用多個 app-args 參數的格式為 app-args="value" app-args="value" ..。

• bind-path - (可選擇) 可以是 Unix 網域通訊端名稱或「host:port」形式。「app-path」參數的說明解釋了「bind-path」參數的用法。請注意，Unix 網域通訊端名稱僅適用於 UNIX 平台。在 Windows 平台上，必須將 bind-path 指定為「host:port」。

• min-procs - (可選擇) 用於指定要建立的 FastCGI 應用程式程序最小整數值。預設為 1。

• max-procs - (可選擇) 用於指定可建立的 FastCGI 應用程式程序最大整數值。此整數值必須等於或大於 min-procs 值。預設為 1。

• chroot - (可選擇) 用於設定 chroot FastCGI 伺服器應用程式程序的根目錄。預設為 Web Server 的根目錄。

• user - (可選擇) 指定 FastCGI 應用程式執行時所用之身份的使用者 ID。預設為 Web Server 的使用者 ID。

• group - (可選擇) FastCGI 應用程式將在指定的群組下執行。預設為 Web Server 的群組。

• nice - (可選擇) 指定 FastCGI 應用程式程序的 nice/priority 值。

• listen-queue - (可選擇) 用於指定通訊端的偵聽佇列大小整數值。此參數的預設值為 256。

• app-env - (可選擇) 當成環境變數傳送至 FastCGI 應用程式程序的成對值。您可使用多個「app-env」參數。使用多個 app-env 參數的格式為 app-env="name=value" app-env="name=value"....。

• reuse-connection - (可選擇) 一個布林值，用於確定是否重複使用與 FastCGI 應用程式的連線。False (0、false、no) 代表每次處理請求後需+H242關閉與 FastCGI 應用程式的連線。+H248True (1、true、yes) 代表新請求可重複使用現有連線。預設為 false。另請參閱 connection-timeout。

• connection-timeout - (可選擇) 如果將「reuse-connection」設定為 True，則此值可指定池儲存的連線的逾時值 (以秒為單位)。如果連線閒置長達指定的時間長度，外掛程式將關閉此連線。此參數的預設值為 5 秒。另請參閱 reuse-connection。

• resp-timeout - (可選擇) 代表 FastCGI 伺服器回應逾時的整數值 (以秒為單位)。如果在指定的時間內沒有來自 FastCGI 應用程式的回應，將捨棄此請求。此參數的預設值為 5 分鐘。

• restart-interval - (可選擇) 值為一個整數，代表重新啟動 FastCGI 應用程式的時間間隔 (以分鐘為單位)。此參數的預設值為 60 分鐘 (1 小時)。如果將此參數的值設定為零，將不會強制 FastCGI 應用程式重新啟動。

• req-retry - (可選擇) 值為一個整數，代表 FastCGI 應用程式拒絕請求時，外掛程式應重新傳送請求的次數。此參數的預設值為零。

error-fastcgi 伺服器應用程式功能 (SAF) 接受下列參數：

• error-url - 指定在發生失敗或錯誤情況時，要顯示的頁面、URI 或 URL。此參數的值可以是絕對路徑、文件根的相對路徑、URL 或 URI。

• error-reason - (可選擇) 代表 FastCGI 協定錯誤的字串。發生任何外掛程式錯誤時，此字串可區分要顯示的錯誤 URL。