Apache 模組 mod_proxy_fcgi

範例

請記住，為使以下範例能運作，您必須啟用 mod_proxy 和 mod_proxy_fcgi。

ProxyPass "/myapp/" "fcgi://127.0.0.1:4000/"

mod_proxy_fcgi 預設會停用連線重複使用，因此在要求已完成後，連線將會由該 httpd 子行程關閉，並且不會重複使用。如果 FastCGI 應用程式能夠從 httpd 處理並行的連線，您可以選擇連線重複使用，如下列範例所示

ProxyPass "/myapp/" "fcgi://127.0.0.1:4000/" enablereuse=on

以下範例將要求 URI 傳遞為 PHP-FPM 背景程式執行的檔案系統路徑。要求 URL 會自動新增到第二個參數。fcgi:// 之後的 hostname 和 port 是 PHP-FPM 的傾聽位置。連線池/重複使用已啟用。

ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://127.0.0.1:9000/var/www/" enablereuse=on

以下範例將要求 URI 傳遞為 PHP-FPM 背景程式執行的檔案系統路徑。在此情況中，PHP-FPM 正在 unix 網域 socket (UDS) 上傾聽。需要 2.4.9 或後續版本。使用這個語法時，fcgi:// 後面的 hostname 和選用 port 會被忽略。

ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://127.0.0.1/var/www/"

平衡式閘道需要 mod_proxy_balancer 和至少一個負載平衡器演算法模組，例如 mod_lbmethod_byrequests，以及上面列出的 proxy 模組。 mod_lbmethod_byrequests 為預設值，且將用於此範例設定。

ProxyPass "/myapp/" "balancer://myappcluster/"
<Proxy "balancer://myappcluster/">
    BalancerMember "fcgi://127.0.0.1:4000"
    BalancerMember "fcgi://127.0.0.1:4001"
</Proxy>

您也可以透過建立合適的處理常式傳遞，強制要求以反向代理要求來處理。下方範例設定將使用反向代理，將 PHP 指令碼的所有要求傳遞給指定的 FastCGI 伺服器。這項功能在 Apache HTTP Server 2.4.10 及更新版本中提供。基於效能考量因素，您會希望定義一個 工作程序，代表相同的 fcgi:// 後端。這種模式的優點在於它允許伺服器對 URI 執行正常的對應至檔名對應，且會將本機檔案系統的結果傳遞至後端。當 FastCGI 是以此方式設定時，伺服器就能計算出最精確的 PATH_INFO。

<FilesMatch "\.php$">
    # Note: The only part that varies is /path/to/app.sock
    SetHandler  "proxy:unix:/path/to/app.sock|fcgi://127.0.0.1/"
</FilesMatch>

# Define a matching worker.
# The part that is matched to the SetHandler is the part that
# follows the pipe. If you need to distinguish, "localhost; can
# be anything unique.
<Proxy "fcgi://127.0.0.1/" enablereuse=on max=10>
</Proxy>

<FilesMatch ...>
    SetHandler  "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>

<FilesMatch ...>
    SetHandler  "proxy:balancer://myappcluster/"
</FilesMatch>

環境變數

除了控制 mod_proxy 行為的設定指令外，也有多個 環境變數 控制 FCGI 協定提供者

proxy-fcgi-pathinfo

當透過 ProxyPass 或 ProxyPassMatch 設定時，mod_proxy_fcgi 將不會設定 PATH_INFO 環境變數。這允許後端 FCGI 伺服器正確判斷 SCRIPT_NAME 和 Script-URI，並符合 RFC 3875 第 3.3 節。如果您需要 mod_proxy_fcgi 為 PATH_INFO 產生「最佳猜測」，請設定這個環境變數。這是針對部分 FCGI 執行中錯誤的一種解決方法。此變數可以設定為多個值，以調整最佳猜測的選取方式 (僅在 2.4.11 和後續版本中提供)

first-dot

PATH_INFO 是從 URL 中的「第一個」句點後的分隔斜線分割而來的。

last-dot

PATH_INFO 是從 URL 中的「最後一個」句點後的分隔斜線分割而來的。

full

PATH_INFO 是透過嘗試將 URL 對應至本機檔案系統計算的。

unescape

PATH_INFO 是 URL 的路徑組成部分，以未轉譯 / 已解碼顯示。

任何其他值

PATH_INFO 與 URL 的路徑組成部分相同。原本，這是唯一的 proxy-fcgi-pathinfo 選項。