<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1933086:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
pour décrire les directives de httpd</a>
</dd>
+ <dt><a name="perdirectory" id="perdirectory">Contexte de répertoire</a></dt>
+ <dd>Une <glossary ref="directive">directive</glossary> est dans un contexte
+ de répertoire quand elle apparaît dans une section <directive type="section"
+ module="core">Directory</directive>, <directive type="section"
+ module="core">DirectoryMatch</directive>, <directive type="section"
+ module="core">Files</directive> ou <directive type="section"
+ module="core">FilesMatch</directive> dans les fichiers de configuration
+ principaux, ou dans un fichier <code>.htaccess</code>. Dans un contexte de
+ répertoire, les directives ne s’appliquent qu’au répertoire (ou à l’ensemble
+ de fichiers) auquel elles sont associées.<br /> Voir <a
+ href="sections.html">Sections de configuration</a>
+ </dd>
+
<dt><a name="accesscontrol" id="accesscontrol">Contrôle d'accès
(Access Control)</a></dt>
<dd>La restriction d'accès à des zones du réseau. Habituellement
(Uniform Resource Identifier)</a>
<a name="URI" id="URI">(URI)</a></dt>
<dd>Une chaîne de caractères compacte servant à identifier une ressource
- abstraite ou physique. Elle est formellement définie par la <a
- href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. Les URIs
- utilisées sur le world-wide web sont souvent appelées <glossary
- ref="url">URLs</glossary>.
+ abstraite ou physique. Elle est formellement définie par la <rfc>2396</rfc>.
+ Les URIs utilisées sur le world-wide web sont souvent appelées <glossary
+ ref="url">URLs</glossary>.
</dd>
<dt><a name="serversideincludes" id="serversideincludes">
Cette fonctionnalité a été ajoutée
à SSL lorsque sont apparues les extensions TLS, RFC 3546.<br />
Voir <a href="ssl/ssl_faq.html">la FAQ SSL</a>
- et <a href="http://www.ietf.org/rfc/rfc3546.txt">la RFC 3546</a>
+ et la <rfc>3546</rfc>
</dd>
(Common Gateway Interface)</a>
<a name="cgi" id="cgi">(CGI)</a></dt>
<dd>La définition standard d'une interface entre un serveur web et un
- programme externe pour permettre à ce dernier de traiter des requêtes.
- Il existe une <a href="http://www.ietf.org/rfc/rfc3875">RFC
- informationnelle</a> qui en couvre les spécificités.<br />
- Voir : <a href="howto/cgi.html">Contenu dynamique avec CGI</a>
+ programme externe pour permettre à ce dernier de traiter des requêtes. Il
+ existe une RFC informationnelle (<rfc>3875</rfc>) qui en couvre les
+ spécificités.<br /> Voir : <a href="howto/cgi.html">Contenu dynamique avec
+ CGI</a>
</dd>
-
-
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">
Localisation de Ressource Uniformisée
(Uniform Resource Locator)
Voir : Page de manuel : <program>apxs</program>
</dd>
+ <dt><a name="pathinfo" id="pathinfo">PATH_INFO</a></dt>
+ <dd>Les informations de chemin en fin d’URL. Par exemple, si
+ <code>/app/index.php/extra/path</code> correspond au fichier
+ <code>/app/index.php</code>, PATH_INFO contient <code>/extra/path</code>.
+ Cette valeur est transmise aux scripts CGI, à PHP et à d’autres
+ gestionnaires en tant que contexte additionnel pour la requête. La directive
+ <directive module="core">AcceptPathInfo</directive> permet de spécifier si
+ les requêtes avec informations de chemin en fin sont acceptées ou rejetées.<br />
+ Voir la <rfc section="4.1.5">3875</rfc>
+ </dd>
+
<dt><a name="plaintext" id="plaintext">Plein Texte (Plaintext)</a></dt>
<dd>Le texte non chiffré.</dd>
<a name="http" id="hhtp">(HTTP)</a></dt>
<dd>Le protocole de transmission standard utilisé sur le World Wide Web.
httpd implémente la version 1.1 du protocole, référencée comme HTTP/1.1 et
- définie par la
- <a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>.
+ définie par la <rfc>2616</rfc>.
</dd>
<dt><a name="messagedigest" id="messagedigest">Résumé de message
<variant outdated="yes">de</variant>
<variant>en</variant>
<variant>es</variant>
- <variant outdated="yes">fr</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>
<variant outdated="yes">tr</variant>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1799456:1934449 (outdated) -->
+<!-- English Revision: 1934449 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<dt><em>chemin-URL</em></dt>
- <dd>La partie de l'<em>url</em> qui suit le protocole et le nom
- d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le
- <em>chemin-URL</em> représente la ressource vue depuis le web, et est
- différente de la représentation de cette même ressource vue depuis le
- système de fichiers.</dd>
+ <dd>La partie de l'URL qui suit le protocole, le nom d'hôte et un port
+ optionnel, et précède la chaîne de paramètres — par exemple,
+ <code>/path/to/file.html</code>. <em>chemin-URL</em> représente la
+ ressource vue depuis le web, et est différente de la représentation de
+ cette même ressource vue depuis le système de fichiers.</dd>
<dt><em>chemin-fichier</em></dt>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1673656:1933506 (outdated) -->
+<!-- English Revision: 1933506 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<compatibility>Disponible depuis la version 2.3 du serveur HTTP Apache</compatibility>
<summary>
- <p>Ce module permet de convertir une réponse en <a
- href="http://tools.ietf.org/html/rfc2397">URL de type données
- RFC2397</a>.
+ <p>Ce module permet de convertir une réponse en <rfc>2397</rfc> (URL de type données.
</p>
<p>Les URLs de type données peuvent être incluses en ligne dans les
<variants>
<variant>en</variant>
- <variant outdated="yes">fr</variant>
+ <variant>fr</variant>
</variants>
</metafile>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1932739:1934445 (outdated) -->
+<!-- English Revision: 1934445 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>DavHonorMtimeHeader</name>
+<description>Permettre aux clients de définir les temps de modification des
+ressources à l’aide de l’en-tête de requête X-OC-Mtime </description>
+<syntax>DavHonorMtimeHeader on|off</syntax>
+<default>DavHonorMtimeHeader off</default>
+<contextlist><context>directory</context></contextlist>
+
+<usage>
+ <p>La directive <directive>DavHonorMtimeHeader</directive> permet d’indiquer
+ si <module>mod_dav</module> doit prendre en compte l’en-tête de requête
+ <code>X-OC-Mtime</code> lors du traitement des requêtes <code>PUT</code> et
+ <code>MKCOL</code>. Cet en-tête est utilisé par certains clients de
+ synchronisation de WebDAV pour préserver les temps de modification originaux
+ des fichiers chargés.</p>
+
+ <p>Lorsque cette directive est activée, si un client envoie une requête
+ <code>PUT</code> ou <code>MKCOL</code> comportant un en-tête
+ <code>X-OC-Mtime</code>, le serveur définira le temps de modification de la
+ ressource avec la valeur spécifiée dans cet en-tête. La valeur de l’en-tête
+ doit être un horodatage Unix (en secondes depuis l’Epoch) exprimé sous la
+ forme d’un entier décimal.</p>
+
+ <p>Si l’en-tête est présent mais mal formé (par exemple s’il contient des
+ caractères autres que des chiffres), le serveur répondra avec une erreur 400
+ Bad Request.</p>
+
+ <note type="warning">
+ <p>Activer cette directive permet aux clients de manipuler les temps de
+ modification des fichiers sur le serveur. Ne l’activez que pour des
+ emplacements où les clients sont fiables et protégez toujours l’accès avec
+ une authentification.</p>
+ </note>
+
+ <example><title>Exemple</title>
+ <highlight language="config">
+<Directory "/var/www/dav/sync">
+ Dav On
+ DavHonorMtimeHeader on
+</Directory>
+ </highlight>
+ </example>
+</usage>
+</directivesynopsis>
+
</modulesynopsis>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1911874:1934516 (outdated) -->
+<!-- English Revision: 1934516 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<summary>
<p>Le module <module>mod_deflate</module> implémente le filtre de
- sortie <code>DEFLATE</code> qui permet de comprimer la sortie de
+ sortie <code>DEFLATE</code> qui permet de compresser la sortie de
votre serveur avant de l'envoyer au client sur le réseau.</p>
</summary>
<seealso><a href="../filter.html">Les filtres</a></seealso>
données compressées par deflate. Pour plus de détails,
documentez-vous sur la famille d'attaques "BREACH".</p>
</note>
- <p>Voici un exemple simple de configuration qui permet de comprimer
+ <p>Voici un exemple simple de configuration qui permet de compresser
les types de contenu à base de texte.</p>
- <example><title>Ne comprime que certains types de documents</title>
+ <example><title>Ne compresse que certains types de documents</title>
<highlight language="config">
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
</highlight>
particuliers, vous pouvez utiliser la directive <directive
module="mod_filter">AddOutputFilterByType</directive>. Voici un exemple
où la compression n'est activée que pour les fichiers html de la
- documentation d'Apache :</p>
+ documentation d'Apache httpd:</p>
<highlight language="config">
<Directory "/your-server-root/manual">
l'aide de la directive <directive
module="mod_env">SetEnv</directive>, permet d'ignorer la
configuration de votre navigateur quant aux codages acceptés, et
- d'envoyer sans condition une sortie comprimée.
+ d'envoyer sans condition une sortie compressée.
</note>
</section>
<section id="inflate"><title>Décompression de la sortie</title>
<p>Le module <module>mod_deflate</module> fournit aussi un filtre
- permettant de décomprimer un corps de réponse comprimé par gzip.
+ permettant de décompresser un corps de réponse compressé par gzip.
Pour activer cette fonctionnalité, vous devez insérer le filtre
<code>INFLATE</code> dans la chaîne de filtrage en sortie via la
directive <directive module="core">SetOutputFilter</directive> ou
</Location>
</highlight>
- <p>Dans cet exemple, les sorties comprimées par gzip en
- provenance de example.com seront décomprimées afin de pouvoir
+ <p>Dans cet exemple, les sorties compressées par gzip en
+ provenance de example.com seront décompressées afin de pouvoir
être éventuellement traitées par d'autres filtres.
</p>
</section>
<section id="input"><title>Décompression de l'entrée</title>
<p>Le module <module>mod_deflate</module> fournit également un filtre
- permettant de décomprimer un corps de requête comprimé par gzip.
+ permettant de décompresser un corps de requête compressé par gzip.
Pour activer cette fonctionnalité, vous devez insérer le filtre
<code>DEFLATE</code> dans la chaîne de filtrage en entrée via la
directive <directive module="core">SetInputFilter</directive> ou
<p>Désormais, si une requête contient un en-tête
<code>Content-Encoding: gzip</code>, son corps sera
- automatiquement décomprimé. Peu de navigateurs sont actuellement
- en mesure de comprimer les corps de requêtes. Cependant,
+ automatiquement décompressé. Peu de navigateurs sont actuellement
+ en mesure de compresser les corps de requêtes. Cependant,
certaines applications spécialisées supportent les requêtes
- compr
imées, comme par exemple certains clients <a
- href="http://www.webdav.org">WebDAV</a>.</p>
+ compr
essées, comme par exemple certains clients <a
+ href="https://www.webdav.org">WebDAV</a>.</p>
<note type="warning"><title>Note à propos de l'en-tête
<code>Content-Length</code></title>
mandataires qu'une réponse enregistrée dans le cache ne doit être
envoyée qu'aux clients qui ont envoyé l'en-tête de requête
<code>Accept-Encoding</code> approprié. Ceci permet d'éviter l'envoi
- d'un contenu comprimé à un client qui ne sera pas en mesure
+ d'un contenu compressé à un client qui ne sera pas en mesure
de l'interpréter.</p>
<p>Si vous avez défini des exclusions spécifiques dépendant, par
Header append Vary User-Agent
</highlight>
- <p>Si votre décision de comprimer le contenu dépend d'autres
+ <p>Si votre décision de compresser le contenu dépend d'autres
informations que celles contenues dans les en-têtes de la requête
(par exemple la version HTTP), vous devez attribuer à l'en-tête
<code>Vary</code> la valeur <code>*</code>, ce qui permet d'empêcher
<directivesynopsis>
<name>DeflateBufferSize</name>
-<description>Taille du fragment que zlib devra comprimer en une seule
+<description>Taille du fragment que zlib devra compresser en une seule
fois</description>
<syntax>DeflateBufferSize <var>valeur</var></syntax>
<default>DeflateBufferSize 8096</default>
<usage>
<p>La directive <directive>DeflateBufferSize</directive> permet de
- spécifier la taille en octets du fragment que zlib devra comprimer
+ spécifier la taille en octets du fragment que zlib devra compresser
en une seule fois. Si la taille de la réponse compressée est supérieure à
celle spécifiée par cette directive, httpd passera à un mode d'encodage
fragmenté (l'en-tête HTTP <code>Transfer-Encoding</code> prend la valeur
Apache</compatibility>
<usage>
- <p>La directive
- <directive>DeflateInflateLimitRequestBody</directive> permet de
- spécifier la taille maximale d'un corps de requête décompressé. Si
- elle n'est pas définie, c'est la valeur de la directive <directive
- module="core">LimitRequestBody</directive> qui s'applique au corps
- de requête décompressé.</p>
+ <p>La directive <directive>DeflateInflateLimitRequestBody</directive> permet
+ de spécifier la taille maximale d'un corps de requête décompressé. Si elle
+ n'est pas définie, c'est la valeur de la directive <directive
+ module="core">LimitRequestBody</directive> qui s'applique au corps de
+ requête décompressé. Une valeur de <code>0</code> signifie qu’aucune limite
+ n’est imposée à la taille du corps décompressé (d’autres limites telles que
+ celles de la directive <directive module="core">LimitRequestBody</directive>
+ peuvent cependant s’appliquer).</p>
</usage>
</directivesynopsis>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1934245:1934456 (outdated) -->
+<!-- English Revision: 1934456 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>ProxyAsyncDelay</name>
+<description>Durée de sondage synchrone avant de passer le contrôle d’une
+connexion au MPM pour un traitement asynchrone</description>
+<syntax>ProxyAsyncDelay <var>time</var>[s]</syntax>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+</contextlist>
+<compatibility>Disponible à partir de la version 2.5 du serveur HTTP Apache</compatibility>
+
+<usage>
+ <p>Lorsqu’un MPM gérant les évènements est utilisé, cette directive active
+ la gestion asynchrone des connexions de mandataire. Après avoir envoyé la
+ requête au serveur dorsal, le thread de travail du mandataire attend une
+ réponse pendant la durée spécifiée par cette directive. Si le serveur dorsal
+ répond pendant ce laps de temps, la réponse est traitée de manière synchrone
+ par le même thread. Dans le cas contraire, le contrôle de la connexion est
+ passé à la boucle d’attente d’évènement asynchrone du MPM, libérant de ce
+ fait le thread de travail qui pourra alors servir d’autres requêtes.</p>
+
+ <p>Si cette directive est définie à <code>0</code>, le contrôle de la
+ connexion est immédiatement transmis à la boucle d’attente d’évènement. Si
+ elle est définie à <code>-1</code>, le traitement asynchrone est totalement
+ désactivé (toutes les connexions de mandataire restent synchrones).</p>
+
+ <p>Cette directive n’a d’effet que si le MPM prend en charge l’attente
+ de réponse (polling) — par exemple, <module>event</module>).</p>
+
+ <note><title>Quand utiliser cette directive</title>
+ <p>La gestion asynchrone des mandataires est particulièrement utile pour les
+ serveurs dorsaux lents ou les réponses en flux continu (streaming) de longue
+ durée, où le fait de bloquer un thread de travail en attente de données
+ limiterait la concurrence. Pour les serveurs dorsaux rapides qui répondent
+ dans la milliseconde, l’approche synchrone est plus efficace.</p>
+ </note>
+</usage>
+
+<seealso><directive module="mod_proxy">ProxyAsyncIdleTimeout</directive></seealso>
+<seealso><directive module="mod_proxy">ProxyTimeout</directive></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ProxyAsyncIdleTimeout</name>
+<description>Délai d’inactivité pour les connexions asynchrones de mandataire</description>
+<syntax>ProxyAsyncIdleTimeout <var>time</var>[s]</syntax>
+<default>La valeur de la directive <directive module="mod_proxy">ProxyTimeout</directive></default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+</contextlist>
+<compatibility>Disponible à partir de la version 2.5 du serveur HTTP Apache</compatibility>
+
+<usage>
+ <p>Une fois le contrôle de la connexion de mandataire transmis à la boucle
+ d’attente d’évènement asynchrone du MPM (voir la directive <directive
+ module="mod_proxy">ProxyAsyncDelay</directive>), cette directive définit la
+ durée maximale pendant laquelle la connexion peut rester inactive (aucune
+ donnée reçu du serveur dorsal) avant d’être fermée.</p>
+
+ <p>Si elle n’est pas explicitement définie, elle prend pour valeur celle du
+ paramètre <code>timeout</code> du thread de travail (si défini via
+ <directive module="mod_proxy">ProxyPass</directive> ou <directive
+ module="mod_proxy">ProxySet</directive>), celle de <directive
+ module="mod_proxy">ProxyTimeout</directive> ou en dernier recours celle de
+ la directive <directive module="core">Timeout</directive> du serveur.</p>
+
+ <p>Cette directive n’a d’effet que si la directive <directive
+ module="mod_proxy">ProxyAsyncDelay</directive> est aussi définie pour
+ activer la gestion asynchrone.</p>
+</usage>
+
+<seealso><directive module="mod_proxy">ProxyAsyncDelay</directive></seealso>
+<seealso><directive module="mod_proxy">ProxyTimeout</directive></seealso>
+</directivesynopsis>
+
</modulesynopsis>
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1933179:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
module="core">LogLevel</directive> au niveau répertoire.
</li>
- <li><module>mod_proxy_scgi</module>: certaines applications web
- ne fonctionneront plus correctement avec la nouvelle
- configuration de <code>PATH_INFO</code> qui est différente de
- celle de la version 2.2. La configuration
- précédente peut être
- restaurée en définissant la variable
- <code>proxy-scgi-pathinfo</code>.</li>
+ <li><module>mod_proxy_scgi</module> : certaines applications web ne
+ fonctionneront plus correctement avec la nouvelle configuration de
+ <glossary ref="pathinfo">PATH_INFO</glossary> qui est différente de
+ celle de la version 2.2. La configuration précédente peut être restaurée
+ en définissant la variable <code>proxy-scgi-pathinfo</code>.</li>
<li><module>mod_ssl</module>: le contrôle de révocation des
certificats basé sur les CRL doit être maintenant explicitement
projects / thirdparty / apache / httpd.git / commitdiff
