Apache HTTP 服务器版本 2.4
描述 | 过滤器用于处理和提供 HTTP 请求主体 |
---|---|
状态 | 基础 |
模块标识符 | request_module |
源文件 | mod_request.c |
兼容性 | 在 Apache 2.3 及更高版本中可用 |
描述 | 保留请求主体,而不是将其丢弃到指定的最大大小,以便潜在的过滤器(如 mod_include)使用。 |
---|---|
语法 | KeptBodySize 最大字节数 |
默认值 | KeptBodySize 0 |
上下文 | 目录 |
状态 | 基础 |
模块 | mod_request |
在正常情况下,请求处理程序(例如静态文件的默认处理程序)会在请求处理程序不需要时丢弃请求主体。因此,过滤器(如 mod_include)仅限于在将其他 URL 作为子请求包含时发出 GET
请求,即使原始请求是 POST
请求,因为丢弃的请求主体在过滤器处理开始后不再可用。
当此指令的值大于零时,原本会丢弃请求主体的请求处理程序将改为将请求主体保留起来,以便过滤器使用,直到指定的最大大小。在 mod_include 过滤器的情况下,尝试将请求 POST
到静态 shtml 文件将导致所有子请求成为 POST
请求,而不是像以前那样成为 GET
请求。
此功能使您可以将复杂的网页和 Web 应用程序分解成小的独立组件,并使用 mod_include
将这些组件与周围的网页结构组合在一起。这些组件可以采用 CGI 程序、脚本语言或使用 mod_proxy
反向代理到另一个服务器的 URL 空间的 URL 的形式。
注意: 每个保留的请求都必须在临时 RAM 中保留,直到请求完成。因此,应注意确保服务器上有足够的 RAM 来支持预期的负载。此指令的使用应限于 URL 空间中需要的地方,并且使用尽可能小的值,该值仍然足够大以容纳请求主体。
如果客户端发送的请求大小超过此指令分配的最大大小,服务器将返回 413 Request Entity Too Large
。