Module Apache mod_request

KeptBodySize Directive

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 GET 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 POST, 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.

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 POST pour un fichier shtml statique se traduira par des sous-requ�tes POST, et non par des sous-requ�tes GET comme avant.

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 mod_include. 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 mod_proxy.

Note : 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.

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 413 Request Entity Too Large.

Voir aussi

• la documentation de mod_include
• la documentation de mod_auth_form