You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2010/12/01 17:54:54 UTC
svn commit: r1041078 - in /httpd/httpd/trunk/docs/manual: dns-caveats.xml.fr
howto/ssi.xml.fr mod/core.xml.fr mod/mod_env.xml.fr mod/mod_setenvif.xml.fr
sections.xml.fr
Author: lgentis
Date: Wed Dec 1 16:54:54 2010
New Revision: 1041078
URL: http://svn.apache.org/viewvc?rev=1041078&view=rev
Log:
Updates.
Modified:
httpd/httpd/trunk/docs/manual/dns-caveats.xml.fr
httpd/httpd/trunk/docs/manual/howto/ssi.xml.fr
httpd/httpd/trunk/docs/manual/mod/core.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_env.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml.fr
httpd/httpd/trunk/docs/manual/sections.xml.fr
Modified: httpd/httpd/trunk/docs/manual/dns-caveats.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/dns-caveats.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/dns-caveats.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/dns-caveats.xml.fr Wed Dec 1 16:54:54 2010
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision : 1030181 -->
+<!-- English Revision : 1040785 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -118,20 +118,21 @@
</VirtualHost>
</example>
- <p>Supposons que vous avez assigné 192.0.2.1 à
+ <p>Supposons que vous ayez assigné 192.0.2.1 à
<code>www.example1.dom</code> et 192.0.2.2 à <code>www.example2.dom</code>. En
- outre, supposons que <code>example2.dom</code> gère son propre DNS. Avec
- cette configuration, <code>example2.dom</code> sera en mesure de
- détourner tout trafic destiné à <code>example1.dom</code>. Pour y
- parvenir, tout ce qu'ils ont à faire consiste à assigner 192.0.2.1 à
- <code>www.example2.dom</code>. Comme ils gèrent leur propre DNS, vous ne
+ outre, supposons que <code>example1.dom</code> gère son propre DNS. Avec
+ cette configuration, <code>example1.dom</code> sera en mesure de
+ détourner tout trafic destiné à <code>example2.dom</code>. Pour y
+ parvenir, tout ce qu'ils ont à faire consiste à
+ assigner 192.0.2.2 à
+ <code>www.example1.dom</code>. Comme ils gèrent leur propre DNS, vous ne
pouvez pas les empêcher de faire pointer l'enregistrement
- <code>www.example2.dom</code> vers l'adresse qu'ils veulent.</p>
+ <code>www.example1.dom</code> vers l'adresse qu'ils veulent.</p>
- <p>Les requêtes à destination de 192.0.2.1 (y compris toutes celles
+ <p>Les requêtes à destination de 192.0.2.2 (y compris toutes celles
où l'utilisateur à tapé une URL de la forme
- <code>http://www.example1.dom/quelquepart</code>), seront toutes servies
- par le serveur virtuel <code>example2.dom</code>. Une meilleur
+ <code>http://www.example2.dom/quelquepart</code>), seront toutes servies
+ par le serveur virtuel <code>example1.dom</code>. Une meilleur
compréhension de la raison pour laquelle ceci peut se produire
nécessite une discussion plus approfondie à propos de la manière
dont httpd associe les requêtes entrantes aux différents serveurs
Modified: httpd/httpd/trunk/docs/manual/howto/ssi.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/howto/ssi.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/howto/ssi.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/howto/ssi.xml.fr Wed Dec 1 16:54:54 2010
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 659902 -->
+<!-- English Revision : 1041023 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -377,15 +377,6 @@ HTML préexistants.</p>
définir des variables, et de les utiliser dans des comparaisons et
des conditions.</p>
-<section id="caveat"><title>Mise en garde</title>
-
- <p>La plupart des fonctionnalités décrites dans cet article ne sont
- disponibles que si vous utilisez la version 1.2 ou supérieure
- d'Apache. Bien entendu, si ce n'est pas le cas, vous devez faire une
- mise à jour immédiatement, et même plus tôt. Allez-y. Faites-le
- maintenant. Nous attendrons.</p>
-</section>
-
<section id="variables"><title>Définition de variables</title>
<p>Avec l'élément <code>set</code>, vous pouvez définir des
Modified: httpd/httpd/trunk/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml.fr Wed Dec 1 16:54:54 2010
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1039603 -->
+<!-- English Revision : 1040808 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -605,8 +605,8 @@ DESACTIVÉS à partir des ve
<directivesynopsis type="section">
<name>Directory</name>
<description>Regroupe un ensemble de directives qui ne s'appliquent
-qu'au répertoire concerné du système de fichiers et à ses
-sous-répertoires</description>
+qu'au répertoire concerné du système de fichiers, à ses
+sous-répertoires, et à leur contenu.</description>
<syntax><Directory <var>chemin répertoire</var>>
... </Directory></syntax>
<contextlist><context>server config</context><context>virtual
@@ -616,8 +616,9 @@ host</context>
<usage>
<p>Les balises <directive type="section">Directory</directive> et
<code></Directory></code> permettent de regrouper un ensemble
- de directives qui ne s'appliquent qu'au répertoire précisé
- et à ses sous-répertoires. Toute directive
+ de directives qui ne s'appliquent qu'au répertoire précisé,
+ à ses sous-répertoires, et aux fichiers situés dans ces
+ sous-répertoires. Toute directive
autorisée dans un contexte de répertoire peut être utilisée.
<var>chemin répertoire</var> est soit le chemin absolu d'un
répertoire, soit une chaîne de caractères avec caractères génériques
@@ -757,7 +758,7 @@ combinent entre elles à la r&eacu
<directivesynopsis type="section">
<name>DirectoryMatch</name>
-<description>Regroupe des directives qui s'appliquent à des répertoires
+<description>Regroupe des directives qui s'appliquent au contenu de répertoires
du système de fichiers correspondant à une expression rationnelle</description>
<syntax><DirectoryMatch <var>regex</var>>
... </DirectoryMatch></syntax>
@@ -769,7 +770,7 @@ du système de fichiers correspond
<p>Les balises <directive type="section">DirectoryMatch</directive>
et <code></DirectoryMatch></code> permettent de regrouper un
ensemble de directives qui ne s'appliqueront qu'au répertoire
- précisé, comme pour la section <directive
+ précisé (et aux fichiers qu'il contient), comme pour la section <directive
module="core" type="section">Directory</directive>. Cependant, le
répertoire est précisé sous la forme d'une <glossary
ref="regex">expression rationnelle</glossary>. Par exemple :</p>
@@ -2522,6 +2523,38 @@ host</context>
plusieurs URLs peuvent correspondre au même répertoire du système de
fichiers, un tel contrôle d'accès pourrait être contourné.</p>
+ <p>Les directives que contient cette section seront appliquées aux
+ requêtes si la partie chemin de l'URL satisfait à l'un au moins de
+ ces critères :
+ <ul>
+ <li>Le chemin spécifié correspond exactement à la partie chemin de
+ l'URL.
+ </li>
+ <li>Le chemin spécifié, qui se termine par un slash, est un
+ préfixe de la partie chemin de l'URL (traité comme une racine du
+ contexte).
+ </li>
+ <li>Le chemin spécifié, si on lui ajoute un slash de fin, est un
+ préfixe de la partie chemin de l'URL (aussi traité comme une racine du
+ contexte).
+ </li>
+ </ul>
+ Dans l'exemple ci-dessous, où aucun slash de fin n'est utilisé, les
+ directives contenues dans la section s'appliqueront à /private1,
+ /private1/ et /private1/file.txt, mais pas à /private1other.
+ <example>
+ <Location /private1>
+ ...
+ </example>
+ De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les
+ directives contenues dans la section s'appliqueront à /private2/ et
+ à /private2/file.txt, mais pas à /private2other.
+ <example>
+ <Location /private2<em>/</em>>
+ ...
+ </example>
+ </p>
+
<note><title>Quand utiliser la section <directive
type="section">Location</directive></title>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_env.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_env.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_env.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_env.xml.fr Wed Dec 1 16:54:54 2010
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 420990 -->
+<!-- English Revision : 1040517 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -31,13 +31,17 @@ pages SSI</description>
<sourcefile>mod_env.c</sourcefile>
<identifier>env_module</identifier>
<summary>
- <p>Ce module permet de contrôler l'environnement transmis aux
- scripts CGI et aux pages SSI. Les variables d'environnement peuvent
+ <p>Ce module permet de contrôler les variables d'environnement
+ internes utilisées par divers modules du serveur HTTP Apache. Ces
+ variables sont aussi accessibles aux scripts CGI en tant que
+ variables d'environnement système natives, et disponibles dans les
+ pages SSI. Les variables d'environnement peuvent
être transmises depuis le shell qui a lancé le processus
<program>httpd</program>. Elles peuvent également être définies ou
supprimées au cours du processus de configuration.</p>
</summary>
<seealso><a href="../env.html">Variables d'environnement</a></seealso>
+<seealso><directive module="mod_setenvif">SetEnvIf</directive></seealso>
<directivesynopsis>
<name>PassEnv</name>
@@ -50,9 +54,12 @@ shell</description>
<override>FileInfo</override>
<usage>
- <p>Spécifie une ou plusieurs variables d'environnement à transmettre
- aux scripts CGI et aux pages SSI depuis l'environnement du shell qui
- a lancé le processus <program>httpd</program>.</p>
+ <p>Cette directive permet de spécifier quelles variables
+ d'environnement système natives doivent être disponibles en tant que
+ variables d'environnement internes pour les modules du serveur HTTP
+ Apache, et propagées vers les scripts CGI et les pages SSI. Leurs
+ valeurs sont issues de l'environnement natif de l'OS associé au
+ shell qui a invoqué le processus <program>httpd</program>.</p>
<example><title>Exemple</title>
PassEnv LD_LIBRARY_PATH
@@ -69,13 +76,27 @@ shell</description>
<override>FileInfo</override>
<usage>
- <p>Définit une variable d'environnement, cette dernière étant
- ensuite transmise aux scripts CGI et aux pages SSI.</p>
+ <p>Définit une variable d'environnement interne, cette dernière étant
+ ensuite disponible pour les modules du serveur HTTP Apache et
+ transmise aux scripts CGI et aux pages SSI.</p>
<example><title>Exemple</title>
SetEnv SPECIAL_PATH /foo/bin
</example>
+ <note><p>Les variables d'environnement internes définies par cette
+ directive le sont <em>après</em> l'exécution de la plupart des
+ directives du traitement initial des requêtes, comme les contrôles
+ d'accès et la mise en correspondance des URIs avec les noms de
+ fichiers. Si la variable d'environnement est sensée intervenir au
+ cours de cette phase initiale du traitement, par exemple pour la
+ directive <directive module="mod_rewrite">RewriteRule</directive>,
+ vous devez plutôt utiliser la directive <directive
+ module="mod_setenvif"> SetEnvIf</directive> pour définir cette
+ variable.</p>
+ </note>
+
</usage>
+<seealso><a href="../env.html">Variables d'environnement</a></seealso>
</directivesynopsis>
<directivesynopsis>
@@ -88,7 +109,7 @@ shell</description>
<override>FileInfo</override>
<usage>
- <p>Supprime une ou plusieurs variables d'environnement parmi celles
+ <p>Supprime une ou plusieurs variables d'environnement internes parmi celles
qui sont transmises aux scripts CGI et aux pages SSI.</p>
<example><title>Exemple</title>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml.fr Wed Dec 1 16:54:54 2010
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1037510 -->
+<!-- English Revision : 1040517 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -34,11 +34,12 @@ de caractéristiques de la requ&ec
<summary>
<p>Le module <module>mod_setenvif</module> vous permet de définir
- des variables d'environnement en fonction du fait que telle ou telle
+ des variables d'environnement internes en fonction du fait que telle ou telle
caractéristique de la requête correspond ou non aux expressions
rationnelles que vous spécifiez. Ces variables d'environnement
peuvent être utilisées par d'autres parties du serveur pour prendre
- des décisions quant aux actions à entreprendre.</p>
+ des décisions quant aux actions à entreprendre, et pour déterminer
+ si les scripts CGI et les pages SSI doivent pouvoir y accéder.</p>
<p>Les directives sont interprétées selon l'ordre dans lequel elles
apparaîssent dans les fichiers de configuration. Ainsi, des
@@ -269,7 +270,7 @@ serveur HTTP Apache</a> pour des exemple
<directivesynopsis>
<name>SetEnvIfExpr</name>
-<description>Définit des variables d'environnement en fonction d'une expression</description>
+<description>Définit des variables d'environnement en fonction d'une expression ap_expr</description>
<syntax>SetEnvIfExpr <em>expr
[!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax>
@@ -294,11 +295,12 @@ serveur HTTP Apache</a> pour des exemple
<code>iso_delivered</code> est définie chaque fois que notre
application tente de l'envoyer via <code>X-Sendfile</code>.</p>
- <p>Pour un exemple plus utile, voir le cas de
- <code>Referer</code> pour un site comportant plusieurs domaines :</p>
+ <p>Il pourrait être plus utile de définir une variable rfc1918 si
+ l'adresse IP distante est une adresse privée au sens de la RFC 1918
+ :</p>
<example>
- SetEnvIfExpr "${HTTP_REFERER} in { 'www.example.com','example.com','w2.example3.org' }" intra_site_referral
+ SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
</example>
</usage>
Modified: httpd/httpd/trunk/docs/manual/sections.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/sections.xml.fr?rev=1041078&r1=1041077&r2=1041078&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/sections.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/sections.xml.fr Wed Dec 1 16:54:54 2010
@@ -3,7 +3,7 @@
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 955184:1040808 (outdated) -->
+<!-- English Revision: 1040808 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -170,7 +170,8 @@ ainsi que leurs équivalents accep
appliquent des directives à certaines parties du système de fichiers.
Les directives contenues dans une section <directive
type="section" module="core">Directory</directive> s'appliquent au répertoire
-précisé, ainsi qu'à tous ses sous-répertoires.
+précisé, ainsi qu'à tous ses sous-répertoires et aux fichiers que ces
+derniers contiennent.
Le même effet peut être obtenu en utilisant les <a
href="howto/htaccess.html">fichiers .htaccess</a>. Par exemple, avec la
configuration suivante, l'indexation sera activée pour le répertoire
@@ -233,7 +234,7 @@ En particulier, l'interdiction s'appliqu
toute requête commençant par la chaîne de caractères <code>/private</code>.</p>
<example>
-<Location /private><br />
+<LocationMatch ^/private><br />
Order Allow,Deny<br />
Deny from all<br />
</Location>