granicus.if.org Git - apache/blob - docs/manual/mod/mod_ratelimit.xml.fr

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1833875 -->
   5 <!-- French translation : Lucien GENTIS -->
   6
   7 <!--
   8  Licensed to the Apache Software Foundation (ASF) under one or more
   9  contributor license agreements.  See the NOTICE file distributed with
  10  this work for additional information regarding copyright ownership.
  11  The ASF licenses this file to You under the Apache License, Version 2.0
  12  (the "License"); you may not use this file except in compliance with
  13  the License.  You may obtain a copy of the License at
  14
  15      http://www.apache.org/licenses/LICENSE-2.0
  16
  17  Unless required by applicable law or agreed to in writing, software
  18  distributed under the License is distributed on an "AS IS" BASIS,
  19  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  See the License for the specific language governing permissions and
  21  limitations under the License.
  22 -->
  23
  24 <!--<modulesynopsis> is the root tag and must surround all other tags.
  25 The sequence of tags is important and must be followed in order for
  26 the document to validate. -->
  27
  28 <modulesynopsis metafile="mod_ratelimit.xml.meta">
  29 <name>mod_ratelimit</name>
  30 <description>Limitation de la bande passante pour les clients</description>
  31 <status>Extension</status>
  32 <sourcefile>mod_ratelimit.c</sourcefile>
  33 <identifier>ratelimit_module</identifier>
  34 <compatibility>
  35     <code>rate-initial-burst</code> est disponible à partir de la version 2.4.24
  36     du serveur HTTP Apache. La limitation de bande passante pour les contenus
  37     mandatés ne fonctionne pas correctement jusqu'à la version 2.4.33.
  38 </compatibility>
  39
  40 <summary>
  41
  42 <p>Ce module fournit un filtre <code>RATE_LIMIT</code> pour limiter la
  43 bande passante des clients. Cette contrainte s'applique à chaque réponse HTTP au
  44 moment où elle est envoyée au client ; elle n'affecte pas les autres échanges
  45 entre le client et le serveur. La variable d'environnement
  46 <code>rate-limit</code> permet de spécifier, en kb/s, le débit de la
  47 connexion à simuler.</p>
  48
  49 <p>Optionnellement, il est possible, via la variable d'environnement
  50 <code>rate-initial-burst</code>, de définir une quantité de données en
  51 kOctets à transmettre à pleine vitesse avant de limiter la bande passante à la
  52 valeur voulue.</p>
  53
  54 <example><title>Exemple de configuration</title>
  55 <highlight language="config">
  56 &lt;Location "/downloads"&gt;
  57     SetOutputFilter RATE_LIMIT
  58     SetEnv rate-limit 400
  59     SetEnv rate-initial-burst 512
  60 &lt;/Location&gt;
  61 </highlight>
  62
  63 <note type="warning">
  64 Si la valeur affectée à <code>rate-limit</code> dépasse la valeur maximale à
  65 affecter à un entier, la limitation de bande passante sera désactivée. Si la
  66 valeur affectée à <code>rate-limit-burst</code> dépasse la valeur maximale à
  67 affecter à un entier, la transmission du burst initial sans limitation de bande
  68 passante sera désactivée.
  69 </note>
  70
  71 </example>
  72
  73 </summary>
  74
  75 </modulesynopsis>
  76