mirror of
https://github.com/apache/httpd.git
synced 2025-11-03 17:53:20 +03:00
ae6b0541d5
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1780462 13f79535-47bb-0310-9956-ffa450edef68
95 lines
4.4 KiB
Plaintext
95 lines
4.4 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision : 772682 -->
|
|
<!-- French translation : Lucien GENTIS -->
|
|
<!-- $LastChangedRevision: 2009050301 $ -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_request.xml.meta">
|
|
|
|
<name>mod_request</name>
|
|
<description>Filtres permettant de traiter et de mettre à disposition
|
|
les corps de requêtes HTTP</description>
|
|
<status>Base</status>
|
|
<sourcefile>mod_request.c</sourcefile>
|
|
<identifier>request_module</identifier>
|
|
<compatibility>Disponible depuis la version 2.3 d'Apache</compatibility>
|
|
|
|
<directivesynopsis>
|
|
<name>KeptBodySize</name>
|
|
<description>Conserve le corps de la requête à concurrence de la taille
|
|
maximale spécifiée, pour une utilisation éventuelle par des filtres
|
|
comme mod_include.</description>
|
|
<syntax>KeptBodySize <var>taille maximale en octets</var></syntax>
|
|
<default>KeptBodySize 0</default>
|
|
<contextlist><context>directory</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>Dans une situation normale, les gestionnaires de requête tels que
|
|
le gestionnaire par défaut des fichiers statiques suppriment le
|
|
corps de la requête s'il n'est pas nécessaire au gestionnaire de
|
|
requête. Il en résulte que les filtres comme mod_include sont
|
|
limités à des requêtes <code>GET</code> lors de l'inclusion d'autres
|
|
URLs en tant que sous-requêtes, et ceci même si la requête originale
|
|
était une requête <code>POST</code>, car le corps de la requête a
|
|
été supprimé et n'est donc plus disponible une fois le traitement du
|
|
filtre mis en oeuvre.</p>
|
|
|
|
<p>Lorsque l'argument de cette directive a une valeur supérieure à
|
|
zéro, les gestionnaires de requête qui suppriment habituellement les
|
|
corps de requête vont alors conserver ces corps de requête, à
|
|
concurrence de la taille maximale spécifiée, pour être
|
|
éventuellement utilisés par des filtres. Dans le cas du filtre
|
|
mod_include, une tentative de requête <code>POST</code> pour un
|
|
fichier shtml statique se traduira par des sous-requêtes
|
|
<code>POST</code>, et non par des sous-requêtes <code>GET</code>
|
|
comme avant.</p>
|
|
|
|
<p>Cette fonctionnalité permet de découper des pages web complexes
|
|
et des applications web en petits éléments individuels, et de
|
|
combiner ces éléments avec la structure de la page web sous-jacente
|
|
en utilisant <module>mod_include</module>. Les éléments peuvent se
|
|
présenter sous la forme de programmes CGI, de langages de scripts,
|
|
ou d'URLs issues d'un mandataire inverse dans l'espace d'URL d'un
|
|
autre serveur en utilisant <module>mod_proxy</module>.</p>
|
|
|
|
<p><strong>Note :</strong> Chaque requête dont le corps est ainsi
|
|
conservé doit être enregistrée temporairement en mémoire vive
|
|
jusqu'à la fin du traitement de la requête. Il faut donc s'assurer
|
|
que la mémoire RAM du serveur est suffisante pour pouvoir supporter
|
|
la charge induite. L'utilisation de cette directive doit être
|
|
limitée à certaines portions de votre espace d'URL bien précises qui
|
|
le nécessitent, et en spécifiant comme taille maximale une valeur la
|
|
plus petite possible, mais tout de même suffisante pour un corps de
|
|
requête.</p>
|
|
|
|
<p>Si la taille de la requête envoyée par le client dépasse la taille
|
|
maximale autorisée par cette directive, le serveur renverra l'erreur
|
|
<code>413 Request Entity Too Large</code>.</p>
|
|
|
|
</usage>
|
|
|
|
<seealso>la documentation de <a href="mod_include.html">mod_include</a></seealso>
|
|
<seealso>la documentation de <a href="mod_auth_form.html">mod_auth_form</a></seealso>
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|