Модуль Apache mod_request
| Описание: | Фильтры для обработки тел запросов HTTP и предоставления к ним доступа |
|---|---|
| Статус: | Базовый |
| Идентификатор модуля: | request_module |
| Исходный файл: | mod_request.c |
| Совместимость: | Доступен в Apache 2.3 и более поздних версиях |
Директива KeptBodySize
| Описание: | Сохраняет тело запроса вместо его отбрасывания, если его размер не превышает указанное максимальное значение, чтобы его могли использовать такие фильтры, как mod_include. |
|---|---|
| Синтаксис: | KeptBodySize maximum size in bytes |
| Значение по умолчанию: | KeptBodySize 0 |
| Контекст: | каталог |
| Статус: | Базовый |
| Модуль: | mod_request |
В обычных условиях обработчики запросов, например обработчик статических файлов по умолчанию, отбрасывают тело запроса, если оно не требуется обработчику. Поэтому такие фильтры, как mod_include, могут выполнять запросы GET только при включении других URL-адресов в качестве подзапросов, даже если исходный запрос был запросом POST, поскольку отброшенное тело запроса становится недоступным после начала обработки фильтрами.
Если значение этой директивы больше нуля, обработчики, которые в противном случае отбросили бы тело запроса, вместо этого сохранят его для использования фильтрами, если его размер не превышает указанное максимальное значение. В случае фильтра mod_include попытка выполнить POST для статического файла shtml приведёт к тому, что все подзапросы будут запросами POST, а не запросами GET, как раньше.
Эта функция позволяет разбивать сложные веб-страницы и веб-приложения на небольшие отдельные компоненты, а затем объединять их и окружающую структуру веб-страницы с помощью mod_include. Компонентами могут быть программы CGI, скриптовые языки или URL-адреса, перенаправленные в пространство URL-адресов с другого сервера с помощью mod_proxy.
Примечание: Каждый сохранённый запрос необходимо хранить во временной оперативной памяти до завершения запроса. Поэтому следует убедиться, что на сервере достаточно оперативной памяти для предполагаемой нагрузки. Используйте эту директиву только там, где это необходимо, в целевых частях пространства URL-адресов и задавайте минимальное значение, достаточное для хранения тела запроса.
Если размер запроса, отправленного клиентом, превышает максимальный размер, выделенный этой директивой, сервер вернёт 413 Request Entity Too Large.
См. также
- документацию mod_include
- документацию mod_auth_form
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_request.html