<?xml-stylesheet type="text/xsl" href="style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1836060:1933506 (outdated) -->
+<!-- English Revision: 1933506 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<dl>
<dt>Mise en cache HTTP à trois états RFC2616</dt>
- <dd><module>mod_cache</module> et son module de fournisseur
- <module>mod_cache_disk</module> proposent une mise en cache
- intelligente de niveau HTTP. Le contenu proprement dit est
- stocké dans le cache, et mod_cache vise à respecter tous les
- en-têtes HTTP, ainsi que les options qui contrôlent la mise en
- cache du contenu comme décrit dans la <a
- href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
- 13 de la RFC2616</a>. <module>mod_cache</module> peut gérer des
- configurations de mise en cache simples, mais aussi complexes
- comme dans les cas où vous avez à faire à des contenus mandatés,
- à des contenus locaux dynamiques, ou lorsque vous avez besoin
- d'accélérer l'accès aux fichiers locaux situés sur disque
- supposé lent.
- </dd>
+ <dd><module>mod_cache</module> et son module de fournisseur
+ <module>mod_cache_disk</module> proposent une mise en cache intelligente
+ de niveau HTTP. Le contenu proprement dit est stocké dans le cache, et
+ mod_cache vise à respecter tous les en-têtes HTTP, ainsi que les options
+ qui contrôlent la mise en cache du contenu comme décrit dans <rfc
+ section="13">2616</rfc>. <module>mod_cache</module> peut gérer des
+ configurations de mise en cache simples, mais aussi complexes comme dans
+ les cas où vous avez à faire à des contenus mandatés, à des contenus
+ locaux dynamiques, ou lorsque vous avez besoin d'accélérer l'accès aux
+ fichiers locaux situés sur disque supposé lent. </dd>
<dt>Mise en cache d'objets partagés de forme clé/valeur à deux
états</dt>
</related>
<p>Le module <module>mod_cache</module> permet de tirer avantage du
- mécanisme de mise en cache en ligne faisant partie
- intégrante du protocole HTTP, et décrit dans la <a
- href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">section
- 13 de la RFC2616</a>.</p>
+ mécanisme de mise en cache en ligne faisant partie intégrante du protocole
+ HTTP, et décrit dans la <rfc section="13">2616</rfc>.</p>
<p>A la différence d'un cache simple clé/valeur à deux états où le
contenu est supprimé lorsqu'il est périmé, un cache HTTP comporte un
</dd>
</dl>
- <p>Le fonctionnement détaillé d'un cache HTTP est décrit dans la <a
- href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
- 13 de la RFC2616</a>.</p>
+ <p>Le fonctionnement détaillé d'un cache HTTP est décrit dans la <rfc
+ section="13">2616</rfc>.</p>
<section>
<title>Interaction avec le serveur</title>
<section>
<title>Que peut-on mettre en cache ?</title>
- <p>La liste complète des conditions nécessaires pour qu'une
- réponse puisse être enregistrée dans un cache HTTP est fournie
- dans la <a
- href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13.4">section
- 13.4 Response Cacheability de la RFC2616</a>, et peut se résumer
+ <p>La liste complète des conditions nécessaires pour qu'une réponse puisse
+ être enregistrée dans un cache HTTP est fournie dans la <rfc
+ section="13.4">2616</rfc> (Response Cacheability), et peut se résumer
ainsi :</p>
<ol>
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1932308:1933189 (outdated) -->
+<!-- English Revision: 1933189 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
média, mais autorisant tout autre type de média en dernier ressort :</p>
<example>
- Accept-Language: fr; q=1.0, en; q=0.5<br />
- Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
+<highlight language="config">
+Accept-Language: fr; q=1.0, en; q=0.5
+Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
+</highlight>
</example>
<p>httpd prend en charge la négociation de contenu « server driven » (telle qu'elle
de correspondances.</p>
<example>
- URI: foo<br />
-<br />
- URI: foo.en.html<br />
- Content-type: text/html<br />
- Content-language: en<br />
-<br />
- URI: foo.fr.de.html<br />
- Content-type: text/html;charset=iso-8859-2<br />
- Content-language: fr, de<br />
+<highlight language="config">
+URI: foo
+
+URI: foo.en.html
+Content-type: text/html
+Content-language: en
+
+URI: foo.fr.de.html
+Content-type: text/html;charset=iso-8859-2
+Content-language: fr, de
+</highlight>
</example>
<p>Notez aussi qu'un fichier de correspondances de types prend le pas sur
correspondances de types sans avoir à le renommer :</p>
<example>
- URI: foo<br />
-<br />
- URI: foo.html<br />
- Content-type: text/html<br />
- Content-language: en<br />
-<br />
- URI: foo.fr.html<br />
- Content-type: text/html<br />
- Content-language: fr<br />
+<highlight language="config">
+URI: foo
+
+URI: foo.html
+Content-type: text/html
+Content-language: en
+
+URI: foo.fr.html
+Content-type: text/html
+Content-language: fr
+</highlight>
</example>
<p>Si les variantes possèdent des qualités de source différentes, elles
comme pour cette image (disponible en JPEG, GIF ou ASCII-art) :</p>
<example>
- URI: foo<br />
-<br />
- URI: foo.jpeg<br />
- Content-type: image/jpeg; qs=0.8<br />
-<br />
- URI: foo.gif<br />
- Content-type: image/gif; qs=0.5<br />
-<br />
- URI: foo.txt<br />
- Content-type: text/plain; qs=0.01<br />
+<highlight language="config">
+URI: foo
+
+URI: foo.jpeg
+Content-type: image/jpeg; qs=0.8
+
+URI: foo.gif
+Content-type: image/gif; qs=0.5
+
+URI: foo.txt
+Content-type: text/plain; qs=0.01
+</highlight>
</example>
<p>Les valeurs de qs peuvent varier de 0.000 à 1.000. Notez que toute
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1199481:1933189 (outdated) -->
+<!-- English Revision: 1933189 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
en tant que module DSO <code>mod_foo.so</code> :</p>
<example>
-$ ./configure --prefix=/chemin/vers/installation --enable-foo<br />
+<highlight language="sh">
+$ ./configure --prefix=/path/to/install --enable-foo
$ make install
+</highlight>
</example>
</li>
fichier <code>httpd.conf</code>.</p>
<example>
-$ ./configure --enable-mods-shared=all<br />
+<highlight language="sh">
+$ ./configure --enable-mods-shared=all
$ make install
+</highlight>
</example>
<p>L'argument <code>most</code> de l'option
<code>--enable-load-all-modules</code>.</p>
<example>
-$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br />
+<highlight language="sh">
+$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules
$ make install
+</highlight>
</example>
</li>
d'Apache httpd à l'aide du programme <program>apxs</program> :
<example>
-$ cd /chemin/vers/module_tiers<br />
+<highlight language="sh">
+$ cd /path/to/3rdparty
$ apxs -cia mod_foo.c
+</highlight>
</example>
</li>
</ol>
<?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: 1932384:1933549 (outdated) -->
+<!-- English Revision: 1933549 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
les scripts CGI et les pages SSI
se voient affectés un ensemble de variables
d'environnement contenant des méta-informations à propos de la requête
- comme préconisé dans la
- <a href="http://www.ietf.org/rfc/rfc3875">spécification
- sur les CGIs</a>.</p>
+ comme préconisé dans la spécification
+ sur les CGIs (<rfc>3875</rfc>).</p>
</section>
<section id="caveats">
<section id="cgi">
<title>Variables d’environnement de CGI</title>
- <p>La <a
- href="https://datatracker.ietf.org/doc/html/rfc3875#section-4.1"
- >spécification de CGI</a> définit un certain nombre de variables
- d’environnement qui s’ajoutent à celles définies par la spécification de
- HTTP. Elles ont été plus largement adoptées et constituent une méthode
- standard pour transmettre des informations entre le navigateur et le
- serveur, et entre les processus au sein du serveur. Nous en décrivons
- quelques unes ici ; consultez la spécification de CGI pour plus de détails.</p>
+ <p>La spécification sur les CGIs (<rfc section="4.1">3875</rfc>) définit un
+ certain nombre de variables d’environnement qui s’ajoutent à celles définies
+ par la spécification de HTTP. Elles ont été plus largement adoptées et
+ constituent une méthode standard pour transmettre des informations entre le
+ navigateur et le serveur, et entre les processus au sein du serveur. Nous en
+ décrivons quelques unes ici ; consultez la spécification de CGI pour
+ plus de détails.</p>
<section id="query-string">
<title>QUERY_STRING</title>
</section>
</section>
+ <section id="redirect-vars"><title>Variables REDIRECT_</title>
+
+ <p>Lorsqu’une redirection interne se produit — provoquée par une directive
+ <directive module="core">ErrorDocument</directive>, par
+ <module>mod_rewrite</module>, par une directive <directive
+ module="mod_dir">FallbackResource</directive> ou par tout autre mécanisme de
+ redirection interne — les variables d’environnement de la requête originelle
+ sont transmises à la cible de la redirection avec le préfixe
+ <code>REDIRECT_</code>.</p>
+
+ <p>Deux variables supplémentaires sont toujours définies :</p>
+
+ <dl>
+ <dt><code>REDIRECT_URL</code></dt>
+ <dd>Le chemin URL de la requête originelle avant la redirection interne.
+ Cette variable n’est pas définie par un quelconque module spécifique, mais
+ par le cœur du serveur.</dd>
+
+ <dt><code>REDIRECT_STATUS</code></dt>
+ <dd>Le code d’état HTTP qui a déclenché la redirection. Pour les
+ documents d’erreur, il s’agit du code d’état d’erreur (par exemple 404).
+ Pour les redirections internes de <module>mod_rewrite</module> ou de la
+ directive <directive module="mod_dir">FallbackResource</directive>, il
+ s’agit en général du code d’état 200.</dd>
+ </dl>
+
+ <p>Par exemple, si la valeur de <code>REQUEST_URI</code> était
+ <code>/original/chemin</code> et qu’une redirection interne envoyait la
+ requête à <code>/handler.php</code>, la cible de la redirection verrait
+ <code>REDIRECT_URL=/original/path</code> et
+ <code>REQUEST_URI=/handler.php</code>.</p>
+
+ <p>Ces variables sont disponibles pour les scripts CGI, les pages SSI et
+ dans les <a href="expr.html">expressions</a>. Pour plus d’informations à
+ propos des variables REDIRECT_ dans le contexte des documents d’erreur, voir
+ <a href="custom-error.html">Réponses aux erreurs personnalisées</a>.</p>
+
+ </section>
<section id="examples">
<title>Exemples</title>
précédentes, tout caractère non valable dans les noms d'en-têtes
était tout simplement remplacé par un caractère '_', ce qui
pouvait exposer à des attaques de type cross-site-scripting via
- injection d'en-têtes (voir <a
- href="http://events.ccc.de/congress/2007/Fahrplan/events/2212.en.html">Bogues
- du Web inhabituelles</a>, planche 19/20).</p>
+ injection d'en-têtes.</p>
<p>Si vous devez prendre en charge un client qui envoie des en-têtes non
conformes et si ceux-ci ne peuvent pas être corrigés, il existe
<?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: 1922246:1933179 (outdated) -->
+<!-- English Revision: 1933179 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<?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: 1865402:1933179 (outdated) -->
+<!-- English Revision: 1933179 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1883045:1933179 (outdated) -->
+<!-- English Revision: 1933179 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
href="http://perldoc.perl.org/perlre.html">page de manuel des
expressions rationnelles Perl</a>, et l'ouvrage <a
href="https://www.oreilly.com/library/view/mastering-regular-expressions/0596528124/">Mastering
-Regular Expressions, by Jeffrey Friedl</a> (la troisième édition date
+Regular Expressions, par Jeffrey Friedl</a> (la troisième édition date
de 2006, mais la syntaxe des expressions rationnelles n'a pas vraiment
changé, et cet ouvrage reste la référence en la matière).</p>
projects / thirdparty / apache / httpd.git / commitdiff
