Blame docs/manual/mod/mod_request.html.en

Packit 90a5c9
Packit 90a5c9
Packit 90a5c9
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
Packit 90a5c9
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
Packit 90a5c9
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
              This file is generated from xml source: DO NOT EDIT
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
      -->
Packit 90a5c9
<title>mod_request - Apache HTTP Server Version 2.4</title>
Packit 90a5c9
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
Packit 90a5c9
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
Packit 90a5c9
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
Packit 90a5c9
<script src="../style/scripts/prettify.min.js" type="text/javascript">
Packit 90a5c9
</script>
Packit 90a5c9
Packit 90a5c9
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
Packit 90a5c9
<body>
Packit 90a5c9
Packit 90a5c9

Modules | Directives | FAQ | Glossary | Sitemap

Packit 90a5c9

Apache HTTP Server Version 2.4

Packit 90a5c9
Packit 90a5c9
<-
Packit 90a5c9
Packit 90a5c9
Apache > HTTP Server > Documentation > Version 2.4 > Modules
Packit 90a5c9
Packit 90a5c9

Apache Module mod_request

Packit 90a5c9
Packit 90a5c9

Available Languages:  en  |

Packit 90a5c9
 fr  |
Packit 90a5c9
 tr 

Packit 90a5c9
Packit 90a5c9
Description:Filters to handle and make available HTTP request bodies
Packit 90a5c9
Status:Base
Packit 90a5c9
Module Identifier:request_module
Packit 90a5c9
Source File:mod_request.c
Packit 90a5c9
Compatibility:Available in Apache 2.3 and later
Packit 90a5c9
Packit 90a5c9
Support Apache!

Directives

Packit 90a5c9
    Packit 90a5c9
  • KeptBodySize
  • Packit 90a5c9
    Packit 90a5c9

    Bugfix checklist

    See also

    Packit 90a5c9
      Packit 90a5c9
    • Comments
    • Packit 90a5c9
      Packit 90a5c9
      top
      Packit 90a5c9
      Packit 90a5c9
      Packit 90a5c9
      Description:Keep the request body instead of discarding it up to
      Packit 90a5c9
      the specified maximum size, for potential use by filters such as
      Packit 90a5c9
      mod_include.
      Packit 90a5c9
      Syntax:KeptBodySize maximum size in bytes
      Packit 90a5c9
      Default:KeptBodySize 0
      Packit 90a5c9
      Context:directory
      Packit 90a5c9
      Status:Base
      Packit 90a5c9
      Module:mod_request
      Packit 90a5c9
      Packit 90a5c9
          

      Under normal circumstances, request handlers such as the

      Packit 90a5c9
          default handler for static files will discard the request body
      Packit 90a5c9
          when it is not needed by the request handler. As a result,
      Packit 90a5c9
          filters such as mod_include are limited to making GET requests
      Packit 90a5c9
          only when including other URLs as subrequests, even if the
      Packit 90a5c9
          original request was a POST request, as the discarded
      Packit 90a5c9
          request body is no longer available once filter processing is
      Packit 90a5c9
          taking place.

      Packit 90a5c9
      Packit 90a5c9
          

      When this directive has a value greater than zero, request

      Packit 90a5c9
          handlers that would otherwise discard request bodies will
      Packit 90a5c9
          instead set the request body aside for use by filters up to
      Packit 90a5c9
          the maximum size specified. In the case of the mod_include
      Packit 90a5c9
          filter, an attempt to POST a request to the static
      Packit 90a5c9
          shtml file will cause any subrequests to be POST
      Packit 90a5c9
          requests, instead of GET requests as before.

      Packit 90a5c9
      Packit 90a5c9
          

      This feature makes it possible to break up complex web pages and

      Packit 90a5c9
          web applications into small individual components, and combine
      Packit 90a5c9
          the components and the surrounding web page structure together
      Packit 90a5c9
          using mod_include. The components can take the
      Packit 90a5c9
          form of CGI programs, scripted languages, or URLs reverse proxied
      Packit 90a5c9
          into the URL space from another server using
      Packit 90a5c9
          mod_proxy.

      Packit 90a5c9
      Packit 90a5c9
          

      Note: Each request set aside has to be set

      Packit 90a5c9
          aside in temporary RAM until the request is complete. As a result,
      Packit 90a5c9
          care should be taken to ensure sufficient RAM is available on the
      Packit 90a5c9
          server to support the intended load. Use of this directive
      Packit 90a5c9
          should be limited to where needed on targeted parts of your
      Packit 90a5c9
          URL space, and with the lowest possible value that is still big
      Packit 90a5c9
          enough to hold a request body.

      Packit 90a5c9
      Packit 90a5c9
          

      If the request size sent by the client exceeds the maximum

      Packit 90a5c9
          size allocated by this directive, the server will return
      Packit 90a5c9
          413 Request Entity Too Large.

      Packit 90a5c9
      Packit 90a5c9
      Packit 90a5c9

      See also

      Packit 90a5c9
        Packit 90a5c9
      • mod_include documentation
      • Packit 90a5c9
      • mod_auth_form documentation
      • Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9

        Available Languages:  en  |

        Packit 90a5c9
         fr  |
        Packit 90a5c9
         tr 

        Packit 90a5c9
        top

        Comments

        Notice:
        This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
        Packit 90a5c9
        <script type="text/javascript">
        Packit 90a5c9
        var comments_shortname = 'httpd';
        Packit 90a5c9
        var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_request.html';
        Packit 90a5c9
        (function(w, d) {
        Packit 90a5c9
            if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
        Packit 90a5c9
                d.write('
        <\/div>');
        Packit 90a5c9
                var s = d.createElement('script');
        Packit 90a5c9
                s.type = 'text/javascript';
        Packit 90a5c9
                s.async = true;
        Packit 90a5c9
                s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
        Packit 90a5c9
                (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
        Packit 90a5c9
            }
        Packit 90a5c9
            else { 
        Packit 90a5c9
                d.write('
        Comments are disabled for this page at the moment.<\/div>');
        Packit 90a5c9
            }
        Packit 90a5c9
        })(window, document);
        Packit 90a5c9
        //--></script>
        Packit 90a5c9

        Copyright 2018 The Apache Software Foundation.
        Licensed under the Apache License, Version 2.0.

        Packit 90a5c9

        Modules | Directives | FAQ | Glossary | Sitemap

        <script type="text/javascript">
        Packit 90a5c9
        if (typeof(prettyPrint) !== 'undefined') {
        Packit 90a5c9
            prettyPrint();
        Packit 90a5c9
        }
        Packit 90a5c9
        //--></script>
        Packit 90a5c9
        </body></html>