Apache HTTP Server 2.4 版本
說明 | 用於處理及提供 HTTP 要求主體的篩選器 |
---|---|
狀態 | 基礎 |
模組識別 | request_module |
原始檔 | mod_request.c |
相容性 | 可用於 Apache 2.3 及更新版本 |
說明 | 保留要求主體而非將其移除,最多到指定的尺寸為止,供篩選器例如 mod_include 可能使用。 |
---|---|
語法 | KeptBodySize 最大尺寸(單位:位元組) |
預設值 | KeptBodySize 0 |
環境 | 目錄 |
狀態 | 基礎 |
模組 | mod_request |
正常情況下,要求處理程式例如靜態檔案的預設處理程式會在要求處理程式不需要要求主體時移除要求主體。因此,篩選器例如 mod_include 在將其他網址包含為子要求時僅限於執行 GET
要求,即使原始要求是 POST
要求,因為當篩選器處理作業進行中時,已移除的要求主體不再可用。
當這個指令的值大於零時,本來會移除要求主體的要求處理程式會將要求主體保留供篩選器使用,最多到指定的尺寸為止。以 mod_include 篩選器為例,嘗試對靜態 shtml 檔案進行 POST
要求會導致任何子要求都是 POST
要求,而非像之前一樣是 GET
要求。
這個功能讓您可以將複雜的網頁和網頁應用程式分割成個別的小組成,並利用 mod_include
將組成與其周圍的網頁結構整合在一起。這些組成可以是 CGI 程式、腳本語言,或使用 mod_proxy
將其從另一個伺服器反向代理到 URL 空間中的網址。
請注意: 每個已擱置的要求都必須擱置在暫時 RAM 中,直至要求完成。因此,應小心確保伺服器上有足夠的 RAM 來支援預期負載。此指令的使用應限制在 URL 空間特定部分中只要的地方,並使用夠大到足以容納要求本文的最低可能值。
如果客戶端發送的要求大小超過此指令分配的最大大小,則伺服器將傳回 413 要求實體太大
。