You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2009/10/17 00:49:19 UTC
svn commit: r826124 [4/5] - /httpd/httpd/trunk/docs/manual/mod/
Added: httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,202 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>mod_info - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_info</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_info.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du
+serveur</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table>
+<h3>Sommaire</h3>
+
+ <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes
+ suivantes à votre fichier <code>httpd.conf</code>.</p>
+
+ <div class="example"><p><code>
+ <Location /infos-serveur><br />
+ <span class="indent">
+ SetHandler server-info<br />
+ </span>
+ </Location>
+ </code></p></div>
+
+ <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> à
+ l'intérieur de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> afin de restreindre l'accès aux
+ informations de configuration de votre serveur :</p>
+
+ <div class="example"><p><code>
+ <Location /infos-serveur><br />
+ <span class="indent">
+ SetHandler server-info<br />
+ Order deny,allow<br />
+ Deny from all<br />
+ Allow from votre-entreprise.com<br />
+ </span>
+ </Location>
+ </code></p></div>
+
+ <p>Une fois cette configuration effectuée, les informations du
+ serveur sont disponibles à l'adresse
+ <code>http://votre-serveur.com/infos-serveur</code>.</p>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2>
+ <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa
+ fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
+ fichiers de configuration, y compris les fichiers de configuration
+ des répertoires (par exemple <code>.htaccess</code>). Ceci peut
+ avoir des répercutions en matière de sécurité pour votre site.</p>
+
+ <p>En particulier, l'utilisation de ce module peut conduire à la
+ divulgation d'informations sensibles à partir des directives de
+ configuration d'autres modules Apache comme des chemins systèmes,
+ des couples nom d'utilisateur/mot de passe, des noms de bases de
+ données, etc... C'est pourquoi ce module ne doit être utilisé
+ <strong>que</strong> dans un environnement sous contrôle et toujours
+ avec les plus grandes précautions.</p>
+
+ <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour
+ restreindre l'accès aux informations de configuration de votre
+ serveur.</p>
+
+ <div class="example"><h3>Contrôle d'accès</h3><p><code>
+ <Location /infos-serveur><br />
+ <span class="indent">
+ SetHandler server-info<br />
+ Order allow,deny<br />
+ # Autorisation d'accès depuis le serveur lui-même<br />
+ Allow from 127.0.0.1<br />
+ # Autorisation d'accès depuis une station de travail du réseau
+ # local<br />
+ Allow from 192.168.1.17<br />
+ </span>
+ </Location>
+ </code></p></div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2>
+ <p>Par défaut, les informations affichées comprennent une liste de
+ tous les modules activés, et pour chaque module, une description des
+ directives qu'il accepte, les branchements (hooks) qu'il
+ implémente, ainsi que les directives concernées dans la
+ configuration courante.</p>
+
+ <p>Il est possible d'afficher d'autres vues de la configuration en
+ ajoutant un argument à la requête <code>infos-serveur</code>. Par
+ exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
+ affichera toutes les directives de configuration.</p>
+
+ <dl>
+ <dt><code>?<module-name></code></dt>
+ <dd>Uniquement les informations relatives au module
+ spécifié</dd>
+ <dt><code>?config</code></dt>
+ <dd>Uniquement les directives de configuration, non triées
+ par module</dd>
+ <dt><code>?hooks</code></dt>
+ <dd>Uniquement la liste des branchements (hooks)
+ auxquels le module est attaché</dd>
+ <dt><code>?list</code></dt>
+ <dd>Une simple liste des modules activés</dd>
+ <dt><code>?server</code></dt>
+ <dd>Uniquement des informations de base sur le serveur</dd>
+ </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="limitations" id="limitations">Limitations connues</a></h2>
+ <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de
+ la configuration interprétée, et non du fichier de configuration
+ original. La manière dont l'arbre de configuration interprété est
+ créé induit quelques limitations :</p>
+ <ul>
+ <li>Les directives qui sont traitées immédiatement sans être
+ enregistrées dans l'arbre de configuration interprété ne sont pas
+ prises en compte. Celles-ci comprennent <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> et <code class="directive"><a href="../mod/mod_so.html#loadfile">LoadFile</a></code>.</li>
+ <li>Les directives qui contrôlent le fichier de configuration
+ lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>,
+ <code class="directive"><a href="../mod/core.html#<ifmodule>"><IfModule></a></code> et
+ <code class="directive"><a href="../mod/core.html#<ifdefine>"><IfDefine></a></code> ne sont pas
+ prises en compte, mais les directives de configuration incluses le
+ sont.</li>
+ <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
+ considéré comme une fonctionnalité).</li>
+ <li>Les directives de configuration des fichiers
+ <code>.htaccess</code> ne sont pas prises en compte (car elles ne
+ font pas partie de la configuration permanente du serveur).</li>
+ <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#<directory>"><Directory></a></code> sont affichées
+ normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de
+ déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#</directory>"></Directory></a></code>.</li>
+ <li>Les directives générées par des modules tiers comme
+ <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
+ prises en compte.</li>
+ </ul>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
+module affichées par le gestionnaire server-info</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>nom-module</var> <var>chaîne</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 1.3 d'Apache</td></tr>
+</table>
+ <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
+ en tant qu'<strong>Information supplémentaire</strong> interprétée
+ en HTML pour le module <var>nom-module</var>. Exemple :</p>
+
+ <div class="example"><p><code>
+ AddModuleInfo mod_deflate.c 'Voir <a \<br />
+ <span class="indent">
+ href="http://www.apache.org/docs/trunk/mod/mod_deflate.html">\<br />
+ http://www.apache.org/docs/trunk/mod/mod_deflate.html</a>'
+ </span>
+ </code></p></div>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_info.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,188 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 804977 -->
+<!-- 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_info.xml.meta">
+
+<name>mod_info</name>
+<description>Affiche une présentation complète de la configuration du
+serveur</description>
+<status>Extension</status>
+<sourcefile>mod_info.c</sourcefile>
+<identifier>info_module</identifier>
+
+<summary>
+ <p>Pour activer <module>mod_info</module>, ajoutez les lignes
+ suivantes à votre fichier <code>httpd.conf</code>.</p>
+
+ <example>
+ <Location /infos-serveur><br />
+ <indent>
+ SetHandler server-info<br />
+ </indent>
+ </Location>
+ </example>
+
+ <p>Il est recommandé d'utiliser <module>mod_access</module> à
+ l'intérieur de la section <directive type="section"
+ module="core">Location</directive> afin de restreindre l'accès aux
+ informations de configuration de votre serveur :</p>
+
+ <example>
+ <Location /infos-serveur><br />
+ <indent>
+ SetHandler server-info<br />
+ Order deny,allow<br />
+ Deny from all<br />
+ Allow from votre-entreprise.com<br />
+ </indent>
+ </Location>
+ </example>
+
+ <p>Une fois cette configuration effectuée, les informations du
+ serveur sont disponibles à l'adresse
+ <code>http://votre-serveur.com/infos-serveur</code>.</p>
+</summary>
+
+<section id="security"><title>Problèmes liés à la sécurité</title>
+ <p>Une fois <module>mod_info</module> chargé dans le serveur, sa
+ fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
+ fichiers de configuration, y compris les fichiers de configuration
+ des répertoires (par exemple <code>.htaccess</code>). Ceci peut
+ avoir des répercutions en matière de sécurité pour votre site.</p>
+
+ <p>En particulier, l'utilisation de ce module peut conduire à la
+ divulgation d'informations sensibles à partir des directives de
+ configuration d'autres modules Apache comme des chemins systèmes,
+ des couples nom d'utilisateur/mot de passe, des noms de bases de
+ données, etc... C'est pourquoi ce module ne doit être utilisé
+ <strong>que</strong> dans un environnement sous contrôle et toujours
+ avec les plus grandes précautions.</p>
+
+ <p>Il est recommandé d'utiliser <module>mod_authz_host</module> pour
+ restreindre l'accès aux informations de configuration de votre
+ serveur.</p>
+
+ <example><title>Contrôle d'accès</title>
+ <Location /infos-serveur><br />
+ <indent>
+ SetHandler server-info<br />
+ Order allow,deny<br />
+ # Autorisation d'accès depuis le serveur lui-même<br />
+ Allow from 127.0.0.1<br />
+ # Autorisation d'accès depuis une station de travail du réseau
+ # local<br />
+ Allow from 192.168.1.17<br />
+ </indent>
+ </Location>
+ </example>
+</section>
+
+<section id="queries"><title>Filtrage des informations affichées</title>
+ <p>Par défaut, les informations affichées comprennent une liste de
+ tous les modules activés, et pour chaque module, une description des
+ directives qu'il accepte, les branchements (hooks) qu'il
+ implémente, ainsi que les directives concernées dans la
+ configuration courante.</p>
+
+ <p>Il est possible d'afficher d'autres vues de la configuration en
+ ajoutant un argument à la requête <code>infos-serveur</code>. Par
+ exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
+ affichera toutes les directives de configuration.</p>
+
+ <dl>
+ <dt><code>?<module-name></code></dt>
+ <dd>Uniquement les informations relatives au module
+ spécifié</dd>
+ <dt><code>?config</code></dt>
+ <dd>Uniquement les directives de configuration, non triées
+ par module</dd>
+ <dt><code>?hooks</code></dt>
+ <dd>Uniquement la liste des branchements (hooks)
+ auxquels le module est attaché</dd>
+ <dt><code>?list</code></dt>
+ <dd>Une simple liste des modules activés</dd>
+ <dt><code>?server</code></dt>
+ <dd>Uniquement des informations de base sur le serveur</dd>
+ </dl>
+</section>
+
+<section id="limitations"><title>Limitations connues</title>
+ <p><module>mod_info</module> tire ses informations de
+ la configuration interprétée, et non du fichier de configuration
+ original. La manière dont l'arbre de configuration interprété est
+ créé induit quelques limitations :</p>
+ <ul>
+ <li>Les directives qui sont traitées immédiatement sans être
+ enregistrées dans l'arbre de configuration interprété ne sont pas
+ prises en compte. Celles-ci comprennent <directive
+ module="core">ServerRoot</directive>, <directive
+ module="mod_so">LoadModule</directive> et <directive
+ module="mod_so">LoadFile</directive>.</li>
+ <li>Les directives qui contrôlent le fichier de configuration
+ lui-même, comme <directive module="core">Include</directive>,
+ <directive module="core"><IfModule></directive> et
+ <directive module="core"><IfDefine></directive> ne sont pas
+ prises en compte, mais les directives de configuration incluses le
+ sont.</li>
+ <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
+ considéré comme une fonctionnalité).</li>
+ <li>Les directives de configuration des fichiers
+ <code>.htaccess</code> ne sont pas prises en compte (car elles ne
+ font pas partie de la configuration permanente du serveur).</li>
+ <li>Les directives de conteneur comme <directive
+ module="core"><Directory></directive> sont affichées
+ normalement, mais <module>mod_info</module> est incapable de
+ déterminer le numéro de ligne de la balise fermante <directive
+ module="core"></Directory></directive>.</li>
+ <li>Les directives générées par des modules tiers comme
+ <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
+ prises en compte.</li>
+ </ul>
+</section>
+
+<directivesynopsis>
+<name>AddModuleInfo</name>
+<description>Ajoute des données supplémentaires aux informations de
+module affichées par le gestionnaire server-info</description>
+<syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+<compatibility>Disponible depuis la version 1.3 d'Apache</compatibility>
+
+<usage>
+ <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
+ en tant qu'<strong>Information supplémentaire</strong> interprétée
+ en HTML pour le module <var>nom-module</var>. Exemple :</p>
+
+ <example>
+ AddModuleInfo mod_deflate.c 'Voir <a \<br />
+ <indent>
+ href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\<br />
+ http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>'
+ </indent>
+ </example>
+</usage>
+
+</directivesynopsis>
+</modulesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>
</variants>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html Fri Oct 16 22:49:14 2009
@@ -4,6 +4,10 @@
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: mod_negotiation.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: mod_negotiation.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en Fri Oct 16 22:49:14 2009
@@ -22,6 +22,7 @@
<div id="preamble"><h1>Apache Module mod_negotiation</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English"> en </a> |
+<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides for <a href="../content-negotiation.html">content negotiation</a></td></tr>
@@ -300,6 +301,7 @@
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English"> en </a> |
+<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
Added: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,325 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>mod_negotiation - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_negotiation</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Effectue la <a href="../content-negotiation.html">négociation de
+contenu</a></td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>negotiation_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_negotiation.c</td></tr></table>
+<h3>Sommaire</h3>
+
+ <p>La négociation de contenu, ou plus précisément la sélection de
+ contenu, est la sélection parmi plusieurs documents disponibles, du
+ document qui "colle" au plus près des possibilités du client. Pour y
+ parvenir, deux méthodes sont employées.</p>
+
+ <ul>
+ <li>Une table de correspondances de types (un fichier associé au
+ gestionnaire <code>type-map</code>) qui contient une liste
+ explicite des fichiers contenant les différentes variantes.</li>
+
+ <li>Une recherche multivues (Multiviews) (activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), où le
+ serveur effectue une recherche de correspondance de modèle de nom
+ de fichier implicite, et fait son choix parmi les résultats.</li>
+ </ul>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#forcelanguagepriority">ForceLanguagePriority</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#languagepriority">LanguagePriority</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#typemaps">Tables de correspondances de types</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#multiviews">Multivues</a></li>
+</ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
+<li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li>
+<li><a href="../content-negotiation.html">Négociation de
+contenu</a></li>
+<li><a href="../env.html">Variables d'environnement</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="typemaps" id="typemaps">Tables de correspondances de types</a></h2>
+ <p>Une table de correspondances de types possède un format similaire
+ à celui des en-têtes de messagerie RFC822. Elle contient des
+ descriptions de documents séparées par des lignes vides, toute ligne
+ commençant par un dièse ('#') étant considérée comme un
+ commentaire. Une description de document comporte plusieurs
+ enregistrements d'en-têtes ; chaque enregistrement peut être réparti
+ sur plusieurs lignes à condition que les lignes supplémentaires
+ commencent par un ou plusieurs espaces. Lors du traitement, les
+ espaces de début de ligne seront supprimés et les lignes
+ concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui
+ se termine toujours par un caractère "deux-points" ':', suivi d'une
+ valeur. Les espaces sont autorisés entre le nom d'en-tête et sa
+ valeur, ainsi qu'entre les différents éléments de la valeur. Les
+ en-têtes autorisés sont :</p>
+
+ <dl>
+ <dt><code>Content-Encoding:</code></dt>
+ <dd>Le codage du fichier. Apache ne reconnaît que les codages
+ définis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus
+ les codages <code>x-compress</code> pour les fichiers compressés
+ avec compress, et <code>x-gzip</code> pour les fichiers compressés
+ avec gzip. Le préfixe <code>x-</code> est ignoré lors des
+ comparaisons de codages.</dd>
+
+ <dt><code>Content-Language:</code></dt>
+ <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de
+ langage Internet standard (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par
+ exemple, <code>en</code> correspond à l'anglais. Si la variante
+ contient plusieurs langages, ils sont séparés par des
+ virgules.</dd>
+
+ <dt><code>Content-Length:</code></dt>
+ <dd>La taille du fichier en octets. Si cet en-tête n'est pas
+ présent, c'est la taille réelle du fichier qui est utilisée.</dd>
+
+ <dt><code>Content-Type:</code></dt>
+
+ <dd>
+ Le <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type MIME</a> du document
+ avec des paramètres optionnels. Les paramètres sont séparés du
+ type de médium ainsi qu'entre eux par un point-virgule, et
+ possèdent la syntaxe <code>nom=valeur</code>. Les paramètres
+ courants sont :
+
+ <dl>
+ <dt><code>level</code></dt>
+ <dd>un entier spécifiant la version du type de média. Pour
+ <code>text/html</code>, la valeur par défaut est 2, sinon
+ 0.</dd>
+
+ <dt><code>qs</code></dt>
+ <dd>un nombre en virgule flottante de 0.0 à 1.0, indiquant la
+ "qualité" relative de la variante courante par rapport aux
+ autres variantes disponibles, indépendamment des possibilités
+ du client. Par exemple, un fichier jpeg est en général une
+ source de qualité supérieure à un fichier ascii s'il est censé
+ représenter une image. Cependant, si la ressource représentée
+ est une image ascii, un fichier ascii possèdera une qualité
+ supérieure à un fichier jpeg. Toutes les valeurs de
+ <code>qs</code> sont donc spécifiques à une certaine
+ ressource.</dd>
+ </dl>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ Content-Type: image/jpeg; qs=0.8
+ </code></p></div>
+ </dd>
+
+ <dt><code>URI:</code></dt>
+ <dd>l'URI du fichier contenant la variante (du type de médium
+ donné, codé selon le codage de contenu donné). Cet URI est
+ considéré comme relatif au fichier de correspondances ; il doit
+ être situé sur le même serveur (!), et doit faire référence au
+ fichier auquel le client se verrait accorder l'accès s'il était
+ requis directement.</dd>
+
+ <dt><code>Body:</code></dt>
+ <dd>une nouveauté d'Apache 2.0 : le contenu réel de la ressource
+ peut être inclus dans la table de correspondances en utilisant
+ l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un
+ délimiteur pour le contenu du corps. Les lignes suivantes du
+ fichier de correspondances de types seront alors considérées comme
+ parties du corps de la ressource jusqu'à ce que le délimiteur soit
+ détecté.
+
+ <div class="example"><h3>Exemple:</h3><p><code>
+ Body:----xyz----<br />
+ <html><br />
+ <body><br />
+ <p>Contenu de la page.</p><br />
+ </body><br />
+ </html><br />
+ ----xyz----
+ </code></p></div>
+ </dd>
+ </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="multiviews" id="multiviews">Multivues</a></h2>
+ <p>Une recherche Multivues est activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le
+ serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et
+ si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt
+ le répertoire à la recherche de tous les fichiers de nom
+ <code>foo.*</code>, et simule véritablement une correspondance de
+ type qui nomme tous ces fichiers en leur assignant les mêmes type
+ de média et codage de contenu qu'ils auraient eus si le client avait
+ requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
+ fichier qui correspond le mieux au profile du client, puis renvoie
+ le document.</p>
+
+ <p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> définit si Apache doit
+ prendre en compte les fichiers qui ne comportent pas de métadonnées
+ de négociation de contenu lors du choix du fichier à servir.</p>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet la mise en cache au niveau des serveurs mandataires
+des documents dont le contenu a été négocié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheNegotiatedDocs On|Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheNegotiatedDocs Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La syntaxe a été modifiée dans la version
+2.0.</td></tr>
+</table>
+ <p>Si elle est définie à "on", cette directive permet la mise en
+ cache au niveau des serveurs mandataires des documents dont le
+ contenu a été négocié. Le processus de mise en cache sera alors plus
+ efficace, mais des clients se trouvant derrière le mandataire
+ seront alors susceptibles de se voir servir des versions de
+ documents qui ne correspondent pas forcément à leurs attentes.</p>
+
+ <p>Cette directive ne s'applique qu'aux requêtes en provenance de
+ navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de
+ la mise en cache des documents au contenu négocié, et cette
+ directive n'a aucun effet sur les réponses aux requêtes
+ HTTP/1.1.</p>
+
+ <p>Avant la version 2.0, la directive
+ <code class="directive">CacheNegotiatedDocs</code> n'acceptait aucun
+ argument ; la seule présence de la directive suffisait à la définir
+ à "on".</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a> <a name="forcelanguagepriority" id="forcelanguagepriority">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si un document acceptable unique
+n'est pas trouvé</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ForceLanguagePriority Prefer</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.30</td></tr>
+</table>
+ <p>La directive <code class="directive">ForceLanguagePriority</code> utilise
+ le langage défini par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> pour terminer
+ la négociation lorsque le serveur n'est pas en mesure de trouver une
+ solution satisfaisante unique.</p>
+
+ <p><code>ForceLanguagePriority Prefer</code> utilise la directive
+ <code>LanguagePriority</code> pour servir le résultat d'un choix
+ unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES),
+ lorsque que plusieurs choix équivalents sont disponibles. Par
+ exemple, avec les deux directives ci-dessous, si l'en-tête
+ <code>Accept-Language</code> de l'utilisateur assigne à
+ <code>en</code> et <code>de</code> une qualité de <code>.500</code>
+ (les deux langages sont également acceptables), alors c'est la
+ première variante acceptable de langue <code>en</code> qui sera
+ servie.</p>
+
+ <div class="example"><p><code>
+ LanguagePriority en fr de<br />
+ ForceLanguagePriority Prefer
+ </code></p></div>
+
+ <p><code>ForceLanguagePriority Fallback</code> utilise la directive
+ <code class="directive"><a href="#languagepriority">LanguagePriority</a></code>
+ pour servir un résultat valide, au lieu de renvoyer un résultat HTTP
+ 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
+ l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne
+ que les réponses de langage <code>es</code>, et si aucune variante
+ dans cette langue n'est trouvée, c'est la première variante de la
+ liste définie par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> qui sera servie.</p>
+
+ <div class="example"><p><code>
+ LanguagePriority en fr de<br />
+ ForceLanguagePriority Fallback
+ </code></p></div>
+
+ <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
+ peuvent être spécifiées, de façon à ce que la variante servie soit
+ la première variante qui convient définie par la directive
+ <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> si
+ plusieurs variantes sont également acceptables, ou le premier
+ document disponible si aucune variante ne convient à la liste de
+ langages acceptables fournie par le client.</p>
+
+<h3>Voir aussi</h3>
+<ul>
+<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
+</ul>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="LanguagePriority" id="LanguagePriority">LanguagePriority</a> <a name="languagepriority" id="languagepriority">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'ordre de priorité des variantes de langages pour les
+cas où le client n'a pas formulé de préférences</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>]
+...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+</table>
+ <p>La directive <code class="directive">LanguagePriority</code> permet de
+ définir, au cours du traitement d'une requête Multivues, l'ordre de
+ priorité des variantes de langages pour les cas
+ où le client n'a pas formulé de préférences. La liste énumère les
+ <var>langages-MIME</var> dans un ordre de préférences
+ décroissantes.</p>
+
+ <div class="example"><h3>Exemple:</h3><p><code>
+ LanguagePriority en fr de
+ </code></p></div>
+
+ <p>Dans le cas d'une requête pour <code>foo.html</code>, si
+ <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
+ le client n'a pas formulé de préférences, c'est le fichier
+ <code>foo.html.fr</code> qui sera renvoyé.</p>
+
+ <p>Notez que cette directive n'a d'effet que si le 'meilleur'
+ langage n'a pas pu être déterminé d'une autre manière ou si la
+ valeur de la directive <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> est
+ différente de <code>None</code>. En général, c'est le client qui
+ détermine le langage préféré, non le serveur.</p>
+
+<h3>Voir aussi</h3>
+<ul>
+<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
+</ul>
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,307 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 774533 -->
+<!-- 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_negotiation.xml.meta">
+
+<name>mod_negotiation</name>
+<description>Effectue la <a
+href="../content-negotiation.html">négociation de
+contenu</a></description>
+<status>Base</status>
+<sourcefile>mod_negotiation.c</sourcefile>
+<identifier>negotiation_module</identifier>
+
+<summary>
+ <p>La négociation de contenu, ou plus précisément la sélection de
+ contenu, est la sélection parmi plusieurs documents disponibles, du
+ document qui "colle" au plus près des possibilités du client. Pour y
+ parvenir, deux méthodes sont employées.</p>
+
+ <ul>
+ <li>Une table de correspondances de types (un fichier associé au
+ gestionnaire <code>type-map</code>) qui contient une liste
+ explicite des fichiers contenant les différentes variantes.</li>
+
+ <li>Une recherche multivues (Multiviews) (activée par l'<directive
+ module="core">Options</directive> <code>Multiviews</code>), où le
+ serveur effectue une recherche de correspondance de modèle de nom
+ de fichier implicite, et fait son choix parmi les résultats.</li>
+ </ul>
+</summary>
+<seealso><directive module="core">Options</directive></seealso>
+<seealso><module>mod_mime</module></seealso>
+<seealso><a href="../content-negotiation.html">Négociation de
+contenu</a></seealso>
+<seealso><a href="../env.html">Variables d'environnement</a></seealso>
+
+<section id="typemaps"><title>Tables de correspondances de types</title>
+ <p>Une table de correspondances de types possède un format similaire
+ à celui des en-têtes de messagerie RFC822. Elle contient des
+ descriptions de documents séparées par des lignes vides, toute ligne
+ commençant par un dièse ('#') étant considérée comme un
+ commentaire. Une description de document comporte plusieurs
+ enregistrements d'en-têtes ; chaque enregistrement peut être réparti
+ sur plusieurs lignes à condition que les lignes supplémentaires
+ commencent par un ou plusieurs espaces. Lors du traitement, les
+ espaces de début de ligne seront supprimés et les lignes
+ concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui
+ se termine toujours par un caractère "deux-points" ':', suivi d'une
+ valeur. Les espaces sont autorisés entre le nom d'en-tête et sa
+ valeur, ainsi qu'entre les différents éléments de la valeur. Les
+ en-têtes autorisés sont :</p>
+
+ <dl>
+ <dt><code>Content-Encoding:</code></dt>
+ <dd>Le codage du fichier. Apache ne reconnaît que les codages
+ définis par une directive <directive
+ module="mod_mime">AddEncoding</directive>. Sont normalement inclus
+ les codages <code>x-compress</code> pour les fichiers compressés
+ avec compress, et <code>x-gzip</code> pour les fichiers compressés
+ avec gzip. Le préfixe <code>x-</code> est ignoré lors des
+ comparaisons de codages.</dd>
+
+ <dt><code>Content-Language:</code></dt>
+ <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de
+ langage Internet standard (<a
+ href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par
+ exemple, <code>en</code> correspond à l'anglais. Si la variante
+ contient plusieurs langages, ils sont séparés par des
+ virgules.</dd>
+
+ <dt><code>Content-Length:</code></dt>
+ <dd>La taille du fichier en octets. Si cet en-tête n'est pas
+ présent, c'est la taille réelle du fichier qui est utilisée.</dd>
+
+ <dt><code>Content-Type:</code></dt>
+
+ <dd>
+ Le <glossary ref="mime-type">type MIME</glossary> du document
+ avec des paramètres optionnels. Les paramètres sont séparés du
+ type de médium ainsi qu'entre eux par un point-virgule, et
+ possèdent la syntaxe <code>nom=valeur</code>. Les paramètres
+ courants sont :
+
+ <dl>
+ <dt><code>level</code></dt>
+ <dd>un entier spécifiant la version du type de média. Pour
+ <code>text/html</code>, la valeur par défaut est 2, sinon
+ 0.</dd>
+
+ <dt><code>qs</code></dt>
+ <dd>un nombre en virgule flottante de 0.0 à 1.0, indiquant la
+ "qualité" relative de la variante courante par rapport aux
+ autres variantes disponibles, indépendamment des possibilités
+ du client. Par exemple, un fichier jpeg est en général une
+ source de qualité supérieure à un fichier ascii s'il est censé
+ représenter une image. Cependant, si la ressource représentée
+ est une image ascii, un fichier ascii possèdera une qualité
+ supérieure à un fichier jpeg. Toutes les valeurs de
+ <code>qs</code> sont donc spécifiques à une certaine
+ ressource.</dd>
+ </dl>
+
+ <example><title>Exemple</title>
+ Content-Type: image/jpeg; qs=0.8
+ </example>
+ </dd>
+
+ <dt><code>URI:</code></dt>
+ <dd>l'URI du fichier contenant la variante (du type de médium
+ donné, codé selon le codage de contenu donné). Cet URI est
+ considéré comme relatif au fichier de correspondances ; il doit
+ être situé sur le même serveur (!), et doit faire référence au
+ fichier auquel le client se verrait accorder l'accès s'il était
+ requis directement.</dd>
+
+ <dt><code>Body:</code></dt>
+ <dd>une nouveauté d'Apache 2.0 : le contenu réel de la ressource
+ peut être inclus dans la table de correspondances en utilisant
+ l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un
+ délimiteur pour le contenu du corps. Les lignes suivantes du
+ fichier de correspondances de types seront alors considérées comme
+ parties du corps de la ressource jusqu'à ce que le délimiteur soit
+ détecté.
+
+ <example><title>Exemple:</title>
+ Body:----xyz----<br />
+ <html><br />
+ <body><br />
+ <p>Contenu de la page.</p><br />
+ </body><br />
+ </html><br />
+ ----xyz----
+ </example>
+ </dd>
+ </dl>
+</section>
+
+<section id="multiviews"><title>Multivues</title>
+ <p>Une recherche Multivues est activée par l'<directive
+ module="core">Options</directive> <code>Multiviews</code>. Si le
+ serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et
+ si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt
+ le répertoire à la recherche de tous les fichiers de nom
+ <code>foo.*</code>, et simule véritablement une correspondance de
+ type qui nomme tous ces fichiers en leur assignant les mêmes type
+ de média et codage de contenu qu'ils auraient eus si le client avait
+ requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
+ fichier qui correspond le mieux au profile du client, puis renvoie
+ le document.</p>
+
+ <p>La directive <directive
+ module="mod_mime">MultiviewsMatch</directive> définit si Apache doit
+ prendre en compte les fichiers qui ne comportent pas de métadonnées
+ de négociation de contenu lors du choix du fichier à servir.</p>
+</section>
+
+<directivesynopsis>
+<name>CacheNegotiatedDocs</name>
+<description>Permet la mise en cache au niveau des serveurs mandataires
+des documents dont le contenu a été négocié</description>
+<syntax>CacheNegotiatedDocs On|Off</syntax>
+<default>CacheNegotiatedDocs Off</default>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+<compatibility>La syntaxe a été modifiée dans la version
+2.0.</compatibility>
+
+<usage>
+ <p>Si elle est définie à "on", cette directive permet la mise en
+ cache au niveau des serveurs mandataires des documents dont le
+ contenu a été négocié. Le processus de mise en cache sera alors plus
+ efficace, mais des clients se trouvant derrière le mandataire
+ seront alors susceptibles de se voir servir des versions de
+ documents qui ne correspondent pas forcément à leurs attentes.</p>
+
+ <p>Cette directive ne s'applique qu'aux requêtes en provenance de
+ navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de
+ la mise en cache des documents au contenu négocié, et cette
+ directive n'a aucun effet sur les réponses aux requêtes
+ HTTP/1.1.</p>
+
+ <p>Avant la version 2.0, la directive
+ <directive>CacheNegotiatedDocs</directive> n'acceptait aucun
+ argument ; la seule présence de la directive suffisait à la définir
+ à "on".</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ForceLanguagePriority</name>
+<description>Action à entreprendre si un document acceptable unique
+n'est pas trouvé</description>
+<syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax>
+<default>ForceLanguagePriority Prefer</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>FileInfo</override>
+<compatibility>Disponible depuis la version 2.0.30</compatibility>
+
+<usage>
+ <p>La directive <directive>ForceLanguagePriority</directive> utilise
+ le langage défini par la directive <directive
+ module="mod_negotiation">LanguagePriority</directive> pour terminer
+ la négociation lorsque le serveur n'est pas en mesure de trouver une
+ solution satisfaisante unique.</p>
+
+ <p><code>ForceLanguagePriority Prefer</code> utilise la directive
+ <code>LanguagePriority</code> pour servir le résultat d'un choix
+ unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES),
+ lorsque que plusieurs choix équivalents sont disponibles. Par
+ exemple, avec les deux directives ci-dessous, si l'en-tête
+ <code>Accept-Language</code> de l'utilisateur assigne à
+ <code>en</code> et <code>de</code> une qualité de <code>.500</code>
+ (les deux langages sont également acceptables), alors c'est la
+ première variante acceptable de langue <code>en</code> qui sera
+ servie.</p>
+
+ <example>
+ LanguagePriority en fr de<br />
+ ForceLanguagePriority Prefer
+ </example>
+
+ <p><code>ForceLanguagePriority Fallback</code> utilise la directive
+ <directive module="mod_negotiation">LanguagePriority</directive>
+ pour servir un résultat valide, au lieu de renvoyer un résultat HTTP
+ 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
+ l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne
+ que les réponses de langage <code>es</code>, et si aucune variante
+ dans cette langue n'est trouvée, c'est la première variante de la
+ liste définie par la directive <directive module="mod_negotiation"
+ >LanguagePriority</directive> qui sera servie.</p>
+
+ <example>
+ LanguagePriority en fr de<br />
+ ForceLanguagePriority Fallback
+ </example>
+
+ <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
+ peuvent être spécifiées, de façon à ce que la variante servie soit
+ la première variante qui convient définie par la directive
+ <directive module="mod_negotiation">LanguagePriority</directive> si
+ plusieurs variantes sont également acceptables, ou le premier
+ document disponible si aucune variante ne convient à la liste de
+ langages acceptables fournie par le client.</p>
+</usage>
+<seealso><directive module="mod_mime">AddLanguage</directive></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>LanguagePriority</name>
+<description>L'ordre de priorité des variantes de langages pour les
+cas où le client n'a pas formulé de préférences</description>
+<syntax>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>]
+...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>FileInfo</override>
+
+<usage>
+ <p>La directive <directive>LanguagePriority</directive> permet de
+ définir, au cours du traitement d'une requête Multivues, l'ordre de
+ priorité des variantes de langages pour les cas
+ où le client n'a pas formulé de préférences. La liste énumère les
+ <var>langages-MIME</var> dans un ordre de préférences
+ décroissantes.</p>
+
+ <example><title>Exemple:</title>
+ LanguagePriority en fr de
+ </example>
+
+ <p>Dans le cas d'une requête pour <code>foo.html</code>, si
+ <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
+ le client n'a pas formulé de préférences, c'est le fichier
+ <code>foo.html.fr</code> qui sera renvoyé.</p>
+
+ <p>Notez que cette directive n'a d'effet que si le 'meilleur'
+ langage n'a pas pu être déterminé d'une autre manière ou si la
+ valeur de la directive <directive
+ module="mod_negotiation">ForceLanguagePriority</directive> est
+ différente de <code>None</code>. En général, c'est le client qui
+ détermine le langage préféré, non le serveur.</p>
+</usage>
+<seealso><directive module="mod_mime">AddLanguage</directive></seealso>
+</directivesynopsis>
+
+</modulesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
</variants>
</metafile>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html Fri Oct 16 22:49:14 2009
@@ -3,3 +3,7 @@
URI: mod_remoteip.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+
+URI: mod_remoteip.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en Fri Oct 16 22:49:14 2009
@@ -21,7 +21,8 @@
<div id="page-content">
<div id="preamble"><h1>Apache Module mod_remoteip</h1>
<div class="toplang">
-<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a> |
+<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Replaces the apparent client remote IP address and hostname
for the request with the IP address list presented by a proxies or a load
@@ -271,7 +272,8 @@
</div>
</div>
<div class="bottomlang">
-<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a> |
+<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
Added: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,322 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>mod_remoteip - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_remoteip</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP et le nom d'hôte apparents du client
+pour la requête par l'adresse IP présentée par un mandataire ou un
+répartiteur de charge via les en-têtes de la requête.
+</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>remoteip_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_remoteip.c</td></tr></table>
+<h3>Sommaire</h3>
+
+ <p>Ce module permet de traiter l'hôte distant qui a initié la
+ requête en tant qu'hôte distant original du point de vue de httpd à
+ des fins d'autorisation et de connexion, même si cet hôte distant se
+ trouve derrière un répartiteur de charge, un serveur frontal, ou un
+ serveur mandataire.</p>
+
+ <p>Le module remplace les adresse IP et nom d'hôte apparents
+ distants (du client) pour la requête par l'adresse IP indiquée dans
+ l'en-tête de requête configuré via la directive
+ <code class="directive">RemoteIPHeader</code>.</p>
+
+ <p>Une fois remplacée comme indiqué, cette adresse IP apparente est
+ utilisée pour les fonctionnalités <code class="directive"><a href="../mod/mod_authz_host.html#require host"><Require host></a></code> et <code class="directive"><a href="../mod/mod_authz_host.html#require ip"><Require ip></a></code> de
+ <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affichée par
+ <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistrée via les directives
+ <code>%a</code> et <code>%h</code> du module
+ <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. Elle permet aussi d'identifier la
+ machine en essayant de lui attribuer une identité inetd via le
+ module <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> et en fonction de la configuration
+ de la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>.</p>
+
+ <div class="warning">Il est essentiel de n'activer cette
+ fonctionnalité que pour les requêtes en provenance des serveurs
+ intermédiaires (mandataires, etc...) auxquels le serveur peut faire
+ confiance, car il est trivial pour le client distant d'usurper
+ l'identité d'un autre client.</div>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipheader">RemoteIPHeader</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#processing">Traitement des adresses distantes</a></li>
+</ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
+<li><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></li>
+<li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
+<li><code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="processing" id="processing">Traitement des adresses distantes</a></h2>
+
+ <p>Apache identifie le client par la valeur remote_ip de la
+ connexion, et de cette valeur découlent les valeurs remote_host et
+ remote_logname de la connexion. Ces champs jouent un rôle
+ dans l'authentification, l'autorisation et la connexion, ainsi que
+ dans d'autres traitements effectués par d'autres modules
+ chargeables.</p>
+
+ <p>mod_remoteip remplace la véritable remote_ip par la remote_ip
+ indiquée par exemple par un mandataire chaque fois que le serveur
+ effectue une évaluation du client, et réinitialise les valeurs de
+ remote_host et remote_logname afin de déclencher une nouvelle
+ requête dns ou ident sur l'adresse IP distante.</p>
+
+ <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP
+ distantes séparées par des virgules, celles-ci sont traitées de la
+ droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP
+ distante courante n'est pas digne de confiance pour présenter
+ l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de
+ façon à ne contenir que cette liste d'adresses non confirmées, ou
+ bien, si toutes les adresses IP sont dignes de confiance, cet
+ en-tête est tout bonnement supprimé de la requête.</p>
+
+ <p>Lors du remplacement de l'adresse IP distante, le module stocke
+ la liste des hôtes intermédiaires dans un mémo
+ remoteip-proxy-ip-list, que l'on peut faire enregistrer par
+ <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> en utilisant le symbole de format
+ <code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit
+ stocker ceci dans un en-tête additionnel, la même valeur peut aussi
+ être enregistrée sous la forme d'un en-tête en utilisant la
+ directive <code class="directive">RemoteIPProxiesHeader</code>.</p>
+
+ <div class="note"><h3>Adresses IPv4 converties au format IPv6</h3>
+ Avec httpd, d'une manière générale, toute adresse IPv4 convertie au
+ format IPv6 est enregistrée sous sa forme IPv4.</div>
+
+ <div class="note"><h3>Adresses internes (privées)</h3>
+ Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16,
+ 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc
+ public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque
+ des mandataires internes (intranet)
+ <code class="directive">RemoteIPInternalProxy</code> sont enregistrés.</div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a> <a name="remoteipheader" id="remoteipheader">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le champ d'en-tête qui contiendra les adresses IP
+du client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPHeader</code> indique à
+ <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> de traiter la valeur de
+ l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme
+ une liste d'adresses IP clients intermédiaires, en fonction de la
+ configuration des directives
+ <code class="directive">RemoteIPInternalProxy</code> et
+ <code class="directive">RemoteIPTrustedProxy</code>. Si ces deux dernières
+ directives ne sont pas utilisées, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
+ traitera tout hôte présentant une valeur d'IP
+ <code class="directive">RemoteIPHeader</code> comme hôte de confiance.</p>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><p><code>
+ RemoteIPHeader X-Client-IP
+ </code></p></div>
+
+ <div class="example"><h3>Exemple dans le cas d'un mandataire</h3><p><code>
+ RemoteIPHeader X-Forwarded-For
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a> <a name="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPInternalProxy</code> permet
+ d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client. A la différence de la directive
+ <code class="directive">RemoteIPTrustedProxy</code>, toute adresse IP
+ présentée dans cet en-tête, y comprises les adresses intranet
+ privées, sont considérées comme dignes de confiance lorsqu'elles
+ sont indiquées par ces mandataires.</p>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><p><code>
+ RemoteIPHeader X-Client-IP<br />
+ RemoteIPTrustedProxy 10.0.2.0/24<br />
+ RemoteIPTrustedProxy passerelle.domaine-local
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a> <a name="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPInternalProxyList</code>
+ permet de spécifier un fichier parcouru au démarrage du serveur pour
+ construire une liste d'adresses (ou blocs d'adresses), auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+ sinon, toutes les lignes séparées par un caractère <code>nouvelle
+ ligne</code> ou
+ tous les éléments d'une ligne séparés par un espace sont traités de
+ la même façon qu'avec la directive
+ <code class="directive">RemoteIPInternalProxy</code>.</p>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><p><code>
+ RemoteIPHeader X-Client-IP<br />
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+ </code></p></div>
+
+ <div class="example"><h3>contenu de conf/mandataires-de-confiance.lst</h3><p><code>
+ # Nos mandataires internes de confiance<br />
+ 10.0.2.0/24 # Tout le monde dans le groupe de test<br />
+ passerelle.domaine-local # Le frontal répartiteur de charge
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a> <a name="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare le champ d'en-tête qui contiendra toutes les
+adresses IP intermédiaires</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>Nom_en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPProxiesHeader</code> permet
+ de spécifier l'en-tête dans lequel <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> va
+ collecter une liste de toutes les adresses IP clients intermédiaires
+ auxquelles on pourra faire confiance pour résoudre la véritable
+ adresse IP distante. Notez que les adresses intermédiaires
+ <code class="directive">RemoteIPTrustedProxy</code> sont enregistrées dans
+ cet en-tête, alors que toute adresse intermédiaire
+ <code class="directive">RemoteIPInternalProxy</code> est omise.</p>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ RemoteIPHeader X-Forwarded-For<br />
+ RemoteIPProxiesHeader X-Forwarded-By
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a> <a name="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPTrustedProxy</code> permet
+ d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client. A la différence de la directive
+ <code class="directive">RemoteIPInternalProxy</code>, toutes les adresses IP
+ intranet ou privées indiquées par de tels mandataires, y compris les
+ blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
+ (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
+ dignes de confiance en tant qu'adresses IP distantes, et se situent
+ à gauche dans le contenu de l'en-tête
+ <code class="directive">RemoteIPHeader</code>.</p>
+
+ <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+ charge</h3><p><code>
+ RemoteIPHeader X-Forwarded-For<br />
+ RemoteIPTrustedProxy 10.0.2.16/28<br />
+ RemoteIPTrustedProxy proxy.example.com
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a> <a name="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+ <p>La directive <code class="directive">RemoteIPTrustedProxyList</code>
+ permet de spécifier un fichier parcouru au démarrage du serveur pour
+ construire une liste d'adresses (ou blocs d'adresses), auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+ sinon, toutes les lignes séparées par un caractère nouvelle ligne ou
+ tous les éléments d'une ligne séparés par un espace sont traités de
+ la même façon qu'avec la directive
+ <code class="directive">RemoteIPTrustedProxy</code>.</p>
+
+ <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+ charge</h3><p><code>
+ RemoteIPHeader X-Forwarded-For<br />
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+ </code></p></div>
+
+ <div class="example"><h3>conf/mandataires-de-confiance.lst contents</h3><p><code>
+ # Mandataires externes identifiés<br />
+ 192.0.2.16/28 #groupe wap phone de mandataires<br />
+ proxy.isp.example.com #un FAI bien connu
+ </code></p></div>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file