mirror of
https://github.com/apache/httpd.git
synced 2025-08-01 16:07:56 +00:00
2ba9c0bb20
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1806426 13f79535-47bb-0310-9956-ffa450edef68
180 lines
7.3 KiB
Plaintext
180 lines
7.3 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision : 1334024 -->
|
|
<!-- French translation : Lucien GENTIS -->
|
|
<!-- Reviewed by : Vincent Deffontaines -->
|
|
|
|
<!--
|
|
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_reqtimeout.xml.meta">
|
|
|
|
<name>mod_reqtimeout</name>
|
|
<description>Définit le délai maximum et le taux minimum de transfert des
|
|
données pour la réception des requêtes
|
|
</description>
|
|
<status>Extension</status>
|
|
<sourcefile>mod_reqtimeout.c</sourcefile>
|
|
<identifier>reqtimeout_module</identifier>
|
|
<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP Apache</compatibility>
|
|
|
|
<section id="examples"><title>Exemples</title>
|
|
|
|
<ol>
|
|
<li>
|
|
Accorde 10 secondes pour la réception des en-têtes de la requête
|
|
et 30 secondes pour la réception du corps :
|
|
|
|
<highlight language="config">
|
|
RequestReadTimeout headerinit=10 body=30
|
|
</highlight>
|
|
</li>
|
|
|
|
<li>
|
|
Accorde au moins 10 secondes pour la réception du corps de
|
|
la requête. Si le client envoie des données, augmente ce délai
|
|
d'une seconde pour chaque paquet de 1000 octets reçus, sans
|
|
limite supérieure (sauf si une limite a été
|
|
spécifiée via la directive <directive
|
|
module="core">LimitRequestBody</directive>) :
|
|
|
|
<highlight language="config">
|
|
RequestReadTimeout body=10,MinRate=1000
|
|
</highlight>
|
|
</li>
|
|
|
|
<li>
|
|
Accorde au moins 10 secondes pour la réception de de la
|
|
requête, en-têtes inclus. Si le client envoie des données, augmente ce délai
|
|
d'une seconde pour chaque paquet de 500 octets reçus, mais
|
|
n'alloue que 30 secondes pour la requête, en-têtes inclus :
|
|
|
|
<highlight language="config">
|
|
RequestReadTimeout header=10-30,MinRate=500
|
|
</highlight>
|
|
</li>
|
|
|
|
<li>
|
|
En général, un serveur doit avoir ses délais d'en-tête et de
|
|
corps configurés. Si les serveurs virtuels http et https
|
|
utilisent une configuration commune, les délais ne doivent pas
|
|
être définis trop bas :
|
|
|
|
<highlight language="config">
|
|
RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
|
|
</highlight>
|
|
</li>
|
|
|
|
</ol>
|
|
</section>
|
|
|
|
<directivesynopsis>
|
|
<name>RequestReadTimeout</name>
|
|
<description>Définit des délais maximums pour la réception des en-têtes
|
|
et corps des requêtes en provenance du client.
|
|
</description>
|
|
<syntax>RequestReadTimeout
|
|
[header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
|
|
[body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
|
|
</syntax>
|
|
<default>header=20-40,MinRate=500 body=20,MinRate=500</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
</contextlist>
|
|
<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP
|
|
Apache ; désactivée par défaut depuis la version 2.3.14.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de définir différents délais pour la
|
|
réception des en-têtes et corps des requêtes en provenance du
|
|
client. Si le client ne parvient pas à respecter ces délais, un code
|
|
d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>
|
|
|
|
<p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes
|
|
inclut le temps nécessaire à la négociation SSL initiale. Si le
|
|
navigateur du client est configuré pour demander des listes de
|
|
révocations de certificats, et si le serveur correspondant n'est pas
|
|
disponible, le délai avant lequel le navigateur va abandonner son
|
|
attente de CRL au cours de la négociation SSL initiale peut être
|
|
assez important. Par conséquent, les valeurs de délais d'en-têtes ne
|
|
doivent pas être trop basses pour les serveurs virtuels SSL. Le délai
|
|
concernant le corps inclut le temps nécessaire à la renégociation
|
|
SSL (si elle est nécessaire).</p>
|
|
|
|
<p>Lorsqu'une directive <directive
|
|
module="core">AcceptFilter</directive> est active (ce qui est en
|
|
général le cas sous Linux et FreeBSD), la socket n'est envoyée au
|
|
processus du serveur qu'après la réception du premier octet (ou de
|
|
l'ensemble de la requête si <code>httpready</code> est défini). Le
|
|
délai configuré pour les en-têtes via la directive
|
|
<code>RequestReadTimeout</code> n'entre en ligne de compte qu'une fois
|
|
la socket reçue par le processus du serveur.</p>
|
|
|
|
<p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
|
|
ou le corps) :
|
|
</p>
|
|
|
|
<ul>
|
|
|
|
<li><strong>Valeur de délai fixe</strong>:<br />
|
|
|
|
<example><var>type</var>=<var>délai</var></example>
|
|
|
|
<p>Le temps en secondes alloué pour la lecture des en-têtes ou du
|
|
corps de la requête. La valeur 0 signifie aucune limite.</p>
|
|
</li>
|
|
|
|
<li><strong>Désactivation du module pour un serveur virtuel :</strong>:<br />
|
|
|
|
<example>header=0 body=0</example>
|
|
|
|
<p>Avec cet exemple, le module <module>mod_reqtimeout</module> est
|
|
complètement désactivé.</p>
|
|
</li>
|
|
|
|
<li><strong>La valeur du délai qui est augmentée lorsque des données
|
|
sont reçues</strong> :<br />
|
|
<example>
|
|
<var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
|
|
</example>
|
|
|
|
<p>Identique à ce qui précède, mais chaque fois que des données sont
|
|
reçues, la valeur du délai est augmentée en fonction du taux-mini
|
|
spécifié (en octets par seconde).</p>
|
|
</li>
|
|
|
|
<li><strong>La valeur du délai augmente lorsque des données sont
|
|
reçues, jusqu'à une limite supérieure</strong>:<br />
|
|
<example>
|
|
<var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>
|
|
</example>
|
|
|
|
<p>Identique à ce qui précède, mais le délai n'augmentera pas au
|
|
delà de la borne supérieure du délai spécifiée.</p>
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|