]> git.ipfire.org Git - thirdparty/apache/httpd.git/commitdiff
fr doc XML files updates.
authorLucien Gentis <lgentis@apache.org>
Wed, 3 Jun 2026 15:45:42 +0000 (15:45 +0000)
committerLucien Gentis <lgentis@apache.org>
Wed, 3 Jun 2026 15:45:42 +0000 (15:45 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934930 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/content-negotiation.xml.fr
docs/manual/expr.xml.fr
docs/manual/programs/apachectl.xml.fr
docs/manual/programs/htpasswd.xml.fr
docs/manual/sections.xml.fr

index f5d2c6396ef3e6466c84fb98d51ff6eb8e878524..48a920fe10d7681823a546466f3539dc60bdd58c 100644 (file)
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1933189:1933739 (outdated) -->
+<!-- English Revision: 1933739 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
index af66c2ced1a5e6d60f9f2f135199d5d51ae141b9..0046f584b58efc38ebb646187ac342a1ed72336a 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision: 1926342:1934599 (outdated) -->
+<!-- English Revision: 1934599 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -78,6 +78,7 @@
 <seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
 <seealso><directive module="mod_log_debug">LogMessage</directive></seealso>
 <seealso><module>mod_include</module></seealso>
+<seealso><a href="env.html">Variables d’environnement dans Apache httpd</a></seealso>
 
   <section id="grammar">
     <title>Syntaxe en Forme de Backus-Naur</title>
@@ -212,6 +213,13 @@ DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
     la phase d'authentification. Par conséquent, la variable
     <code>%{REMOTE_USER}</code> ne sera pas encore définie à ce stade.</p>
 
+    <p>Pour des informations à propos de la définition et de la manipulation des
+    variables d’environnement de requête (en utilisant <directive
+    module="mod_env">SetEnv</directive>, <directive
+    module="mod_setenvif">SetEnvIf</directive>, le drapeau <code>[E=...]</code>
+    de <module>mod_rewrite</module>'s et d’autres directives), voir <a
+    href="env.html">Variables d’environnement dans Apache httpd</a>.</p>
+
     <p>Les variables suivantes contiennent la valeur de l'en-tête de
     requête HTTP correspondant. La <a href="#functions">fonction</a>
     <code>req</code> permet d'extraire les valeurs des autres
@@ -248,7 +256,10 @@ DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
     <tr><td><code>REQUEST_SCHEME</code></td>
         <td>Le protocole associé à l'URI de la requête</td></tr>
     <tr><td><code>REQUEST_URI</code></td>
-        <td>La partie chemin de l'URI de la requête</td></tr>
+       <td>La partie chemin de l'URI de la requête en excluant la chaîne de
+       paramètres. Notez que cette variable diffère de la variable
+       d’environnement CGI de même nom qui, quant à elle, inclut la chaîne de
+       paramètres.</td></tr>
     <tr><td><code>DOCUMENT_URI</code></td>
         <td>Idem <code>REQUEST_URI</code></td></tr>
     <tr><td><code>REQUEST_FILENAME</code></td>
@@ -268,7 +279,7 @@ DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
         <td>Le nom d'utilisateur du propriétaire du script.</td></tr>
     <tr><td><code>SCRIPT_GROUP</code></td>
         <td>Le nom du groupe auquel appartient le script.</td></tr>
-    <tr><td><code>PATH_INFO</code></td>
+    <tr><td><glossary ref="pathinfo">PATH_INFO</glossary></td>
         <td>L'information relative au nom de chemin située en fin, voir
        la directive <directive module="core">AcceptPathInfo</directive></td></tr>
     <tr><td><code>QUERY_STRING</code></td>
@@ -671,6 +682,12 @@ DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
     l'expression a été utilisée.
     </note>
 
+    <p>La fonction <code>reqenv</code> permet de tester les <a
+    href="env.html#special">variables d’environnement à utilisation spéciale</a>
+    (telles que <code>no-gzip</code>, <code>nokeepalive</code>, etc.), ainsi que
+    toute variable définie à l’aide de <a href="env.html#setting">SetEnv,
+    SetEnvIf ou mod_rewrite</a>.</p>
+
     <p>Lorsque les fonctions <code>req</code> ou <code>http</code> sont
     utilisées, le nom d'en-tête sera automatiquement ajouté à l'en-tête
     Vary de la réponse HTTP, sauf spécification contraire pour la
index b5a0b32a660be811a174dfe26234fe82a2232612..61ac43bb440df60b7398242e1737d6e035432d07 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933136:1933949 (outdated) -->
+<!-- English Revision: 1933949 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -170,4 +170,19 @@ directives appropriées, puis utiliser la commande de démarrage normale
 
 </section>
 
+<section id="files"><title>Fichiers</title>
+
+<p>Les chemins de fichiers listés ci-après peuvent être modifiés à la
+compilation. Consultez votre installation locale pour les emplacements réels.</p>
+
+<dl>
+<dt><code>/usr/local/apache2/bin/envvars</code></dt>
+<dd>Fichier de définitions de variables d’environnement alimenté au démarrage.</dd>
+
+<dt><code>/usr/local/apache2/bin/httpd</code></dt>
+<dd>Le binaire httpd invoqué par apachectl.</dd>
+</dl>
+
+</section>
+
 </manualpage>
index bdf84315a83742d51aef62a52845d89e0780fbae..86f9716a13c023ecafb96c055d3bd0580ce7ed07 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='UTF-8' ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933136:1933949 (outdated) -->
+<!-- English Revision: 1933949 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -37,7 +37,7 @@ l'authentification de base</title>
     fichier d'entrée dans le but de le mettre à jour, il renvoie un code
     d'erreur et n'effectue aucune modification.</p>
 
-    <p>Il est possible de limiter l'accès aux ressources du serveur HTTP
+<p>Il est possible de limiter l'accès aux ressources du serveur HTTP
     Apache aux seuls utilisateurs présents dans les fichiers créés par
     <program>htpasswd</program>. Ce programme ne sait gérer les noms
     d'utilisateurs et mots de passe que s'ils sont stockés dans des
@@ -336,4 +336,18 @@ support/SHA1.</seealso>
     <code>apr-util</code> limite le nombre de passes à 17.</p>
 </section>
 
+<section id="files"><title>Fichiers</title>
+
+<p>Le chemin du fichier des mots de passe est spécifié en tant qu’argument de la
+ligne de commande et il peut correspondre à n’importe quel emplacement du
+système de fichiers.</p>
+
+<dl>
+<dt><var>fichier des mots de passe</var></dt>
+<dd>Le fichier plat contenant les noms utilisateur et les mots de passe. Il peut
+contenir des lignes vides et des lignes de commentaire commençant par un  (<code>#</code>).</dd>
+</dl>
+
+</section>
+
 </manualpage>
index 5037368be169272869d3cf80ea8ab98839ce017b..bebf155276e7521d87a006936d79f6f1b4d0a17b 100644 (file)
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1905716:1933722 (outdated) -->
+<!-- English Revision: 1933722 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -236,16 +236,33 @@ toute requête commençant par la chaîne de caractères <code>/private</code>.<
 <p>Le conteneur <directive type="section" module="core">Location</directive>
 n'a pas besoin de faire référence à un élément du système de fichiers.
 À ce titre, l'exemple suivant montre comment faire correspondre une URL
-particulière à un gestionnaire interne du serveur HTTP Apache fourni par le module
+particulière à un gestionnaire interne fourni par le module
 <module>mod_status</module>.
 Il n'est pas nécessaire de trouver un fichier nommé <code>server-status</code>
 dans le système de fichiers.</p>
 
 <highlight language="config">
+# Un URL vers un gestionnaire interne :
 &lt;Location "/server-status"&gt;
     SetHandler server-status
 &lt;/Location&gt;
+
+# Un chemin d’URL vers un dorsal de mandataire inverse :
+&lt;Location "/app"&gt;
+    ProxyPass "http://backend.example.com/"
+    ProxyPassReverse "http://backend.example.com/"
+&lt;/Location&gt;
+
+# Interdire l’accès à un chemin d’URL sans tenir compte de ce qui le traite :
+&lt;Location "/private"&gt;
+    Require all denied
+&lt;/Location&gt;
 </highlight>
+
+<p>Étant donné que la section <directive type="section"
+module="core">Location</directive> opère sur des URLs, et non sur des chemins du
+système de fichiers, il s'agit du conteneur approprié pour la configuration du
+mandataire et les points de terminaison fournis par les modules.</p>
 </section>
 
 <section id="overlapping-webspace"><title>Espace web imbriqué</title>
@@ -530,14 +547,22 @@ sont interprétées.</p>
     de configuration.</li>
     <li>Les sections <directive
     type="section" module="core">Directory</directive> (groupe 1 ci-dessus)
-    sont traitées dans l'ordre du répertoire le plus court vers le plus long.
+    sont traitées dans l'ordre du répertoire le plus court vers le plus long
+    (sans tenir compte de leur ordre d’apparition dans le fichier de
+    configuration).
     Par exemple, <code>&lt;Directory "/var/web/dir"&gt;</code> sera
     traitée avant <code>&lt;Directory
     "/var/web/dir/subdir"&gt;</code>.</li>
-    <li>Si plusieurs sections <directive
-    type="section" module="core">Directory</directive> s'appliquent au même
-    répertoire, elles sont traitées selon l'ordre dans lequel elles
-    apparaissent dans le fichier de configuration.</li>
+    <li>Si plusieurs sections <directive type="section"
+    module="core">Directory</directive> s'appliquent au même répertoire, elles
+    sont traitées selon l'ordre dans lequel elles apparaissent dans le fichier
+    de configuration. La même règle s’applique lorsque plusieurs sections
+    <directive type="section" module="core">DirectoryMatch</directive>,
+    <directive type="section" module="core">Files</directive>, <directive
+    type="section" module="core">FilesMatch</directive>, <directive
+    type="section" module="core">Location</directive> ou <directive
+    type="section" module="core">LocationMatch</directive> ciblent à la même
+    ressource.</li>
     <li>Les sections de configuration incluses à laide de la directive <directive
     module="core">Include</directive> sont traitées comme si elles se
     trouvaient réellement dans le fichier qui les inclut à la position de la
@@ -547,7 +572,13 @@ sont interprétées.</p>
     module="core">VirtualHost</directive>
     sont appliquées <em>après</em> les sections correspondantes situées en
     dehors de la définition du serveur virtuel, ce qui permet au serveur virtuel
-    de prévaloir sur la configuration du serveur global.</li>
+    de prévaloir sur la configuration du serveur global. Notez qu’à la
+    différence des autres types de section, un seul <directive type="section"
+    module="core">serveur virtuel</directive> est sélectionné pour une requête
+    — les directives de plusieurs serveurs virtuels correspondants ne sont
+    jamais fusionnées. Voir <a href="vhosts/details.html">Correspondance des
+    serveurs virtuels</a> pour des détails à propos de la manière dont les
+    serveurs virtuels sont sélectionnés.</li>
     <li>Quand la requête est servie par le module <module>mod_proxy</module>,
     le conteneur <directive module="mod_proxy" type="section">Proxy</directive>
     prend la place du conteneur <directive module="core"
@@ -561,9 +592,27 @@ sont interprétées.</p>
         </li>
         <li>Lorsqu'une section <directive type="section" module="core"
        >If</directive> est utilisée dans un fichier <code>.htaccess</code>, les
-       directives incluses dans un répertoire parent seront fusionnées
-       <em>après</em> les directives non-incluses dans un sous-répertoire.
+       directives incluses dans un "directory" parent seront fusionnées
+       <em>après</em> les directives non-incluses dans un "directory" enfant.
        </li>
+       <li><note type="warning"><title>Avertissement : une directive
+       &lt;Limit&gt; au sein d’une section &lt;Location&gt; peut accorder un
+       accès silencieusement</title>
+        <p>Utiliser la directive <directive type="section"
+       module="core">Limit</directive> au sein d’une section <directive
+       type="section" module="core">Location</directive> pour restreindre
+       la liste des méthodes HTTP autorisées peut donner des résultats
+       inattendus. Pour les méthodes non spécifiées par la directive <directive
+       type="section" module="core">Limit</directive>, la section <directive
+       type="section" module="core">Location</directive> hôte est traitée comme
+       n’imposant aucune condition d’autorisation, ce qui a effectivement pour
+       effet d’accorder l’accès et outrepasse toute éventuelle restriction
+       d’une section <directive type="section"
+       module="core">Directory</directive> qui, autrement, aurait dû s’appliquer.
+       C’est pourquoi il est préférable d’utiliser la directive <directive
+       type="section" module="core">LimitExcept</directive> ou de définir les
+       autorisations sans restriction sur les méthodes.</p>
+        </note></li>
     </ul>
 
        <note><title>Note technique</title>