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

docs/manual/env.xml.fr
docs/manual/mod/mod_actions.xml.fr
docs/manual/mod/mod_include.xml.fr
docs/manual/mod/mod_lua.xml.fr
docs/manual/mod/mod_proxy_fcgi.xml.fr
docs/manual/mod/mod_proxy_scgi.xml.fr
docs/manual/programs/htcacheclean.xml.fr
docs/manual/programs/htdbm.xml.fr
docs/manual/programs/httpd.xml.fr
docs/manual/urlmapping.xml.fr

index 6e1ab9c73bf12679773fe5da4e66c11f3b95ba55..a9d66468e0dc4320eeac6abc5626a0fc3c274024 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: 1933549:1934650 (outdated) -->
+<!-- English Revision: 1934650 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
       </directivelist>
     </related>
 
+    <note>
+      <title>Alternative moderne : les expressions</title>
+      <p>De nombreux exemples d’utilisation qui nécessitaient auparavant de
+      définir et tester des variables d’environnement &mdash; par exemple les en-têtes
+      conditionnels, le contrôle d’accès et la journalisation &mdash; peuvent
+      maintenant être traités de manière plus directe en utilisant les
+      expressions <directive module="core" type="section">If</directive> avec la
+      fonction <code>reqenv</code>. Voir <a href="expr.html">Les expressions
+      dans le serveur HTTP Apache</a> pour la syntaxe des expressions et la
+      liste complète des <a href="expr.html#vars">variables</a> disponibles.</p>
+    </note>
+
     <section id="cgi-scripts">
         <title>Scripts CGI</title>
 
        caractéristiques du client. Par exemple, vous pouvez utiliser ces
         directives pour interdire l'accès depuis un navigateur particulier
        (User-Agent).
+       Pour des conditions plus complexes, <a href="expr.html"><code>Require
+       expr</code></a> fournit une alternative qui permet d’évaluer des
+       variables d’environnement en utilisant la fonction <code>reqenv</code>
+       en combinaison avec d’autres propriétés de requête.
         </p>
 
     </section>
     par la spécification de HTTP. Elles ont été plus largement adoptées et
     constituent une méthode standard pour transmettre des informations entre le
     navigateur et le serveur, et entre les processus au sein du serveur. Nous en
-    décrivons quelques unes ici&nbsp;; consultez la spécification de CGI pour
-    plus de détails.</p>
+    décrivons quelques unes ici. Pour une liste complète des variables de
+    requête disponibles dans les <a href="expr.html">expressions</a> (parmi
+    lesquelles <code>REQUEST_URI</code>, <code>REMOTE_ADDR</code>,
+    <code>SERVER_NAME</code> et de nombreuses autres), voir le document de
+    référence <a href="expr.html#vars">variables dans les expressions</a>.</p>
+
+    <p>Consultez la spécification CGI pour plus de détails à propos des
+    métavariables CGI standard.</p>
 
     <section id="query-string">
         <title>QUERY_STRING</title>
     <section id="path-info">
         <title>PATH_INFO</title>
 
-        <p>La variable <code>PATH_INFO</code> est définie avec toute valeur qui
+        <p>La variable <glossary ref="pathinfo">PATH_INFO</glossary> est définie avec toute valeur qui
        apparaît après une ressource correspondante à la fin de l'URL,
        <code>QUERY_STRING</code> non comprise. Tout paraît plus clair avec un
        exemple&nbsp;:</p>
    <section id="suppress-error-charset">
        <title>suppress-error-charset</title>
 
-    <p><em>Disponible dans les versions postérieures à 2.0.54</em></p>
-
     <p>Quand Apache httpd génère une redirection en réponse à une requête client,
     la réponse inclut un texte destiné à être affiché au cas où le client ne
     suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
     propos des variables REDIRECT_ dans le contexte des documents d'erreur, voir
     <a href="custom-error.html">Réponses aux erreurs personnalisées</a>.</p>
 
+    <p>Ce renommage est particulièrement pertinent lorsqu’on utilise le drapeau
+    <a href="rewrite/flags.html#flag_e">[E] flag</a> de
+    <module>mod_rewrite</module> pour définir des variables, car les réécritures
+    dans un contexte de répertoire déclenchent toujours une redirection interne.
+    Voir cette section pour des exemples et des solutions de contournement.</p>
+
    </section>
 
   <section id="examples">
index a8bb420b7fd77b2596cb451f07cb4b0486779af4..2e9d78588e707b898da8bc5eca83bff19a028827 100644 (file)
@@ -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: 1673892:1934412 (outdated) -->
+<!-- English Revision: 1934412 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -62,18 +62,18 @@ contenu particulier</description>
 <override>FileInfo</override>
 
 <usage>
-    <p>Cette directive ajoute une action qui va activer <var>script
-    cgi</var> lorsque <var>type d'action</var> est déclenché par la
-    requête. <var>script cgi</var> est un chemin URL vers une ressource
-    qui a été désignée comme script CGI à l'aide des directives
-    <directive module="mod_alias">ScriptAlias</directive> ou <directive
-    module="mod_mime">AddHandler</directive>. <var>type d'action</var>
-    peut être soit un <a href="../handler.html">gestionnaire</a>, soit
-    un <glossary ref="mime-type">type de contenu MIME</glossary>. L'URL
-    et le chemin du document correspondant sont envoyés en utilisant
-    les variables d'environnement CGI standards <code>PATH_INFO</code>
-    et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette
-    requête particulière est transmis à l'aide de la variable
+    <p>Cette directive ajoute une action qui va activer <var>script cgi</var>
+    lorsque <var>type d'action</var> est déclenché par la requête. <var>script
+    cgi</var> est un chemin URL vers une ressource qui a été désignée comme
+    script CGI à l'aide des directives <directive
+    module="mod_alias">ScriptAlias</directive> ou <directive
+    module="mod_mime">AddHandler</directive>. <var>type d'action</var> peut être
+    soit un <a href="../handler.html">gestionnaire</a>, soit un <glossary
+    ref="mime-type">type de contenu MIME</glossary>. L'URL et le chemin du
+    document correspondant sont envoyés en utilisant les variables
+    d'environnement CGI standards <glossary ref="pathinfo">PATH_INFO</glossary>
+    et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette requête
+    particulière est transmis à l'aide de la variable
     <code>REDIRECT_HANDLER</code>.</p>
 
     <example><title>Exemple : type MIME</title>
index 4c1beb45eeb0a0b883ed2b77d824694fc54af215..1fd836cb92b8ab7284bbc5ac1a7cc9f6f7ce6c3b 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933179:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -87,11 +87,11 @@ AddOutputFilter INCLUDES .shtml
 <section id="pathinfo">
     <title>PATH_INFO et SSI</title>
 
-    <p>Les fichiers traités dans le cadre des SSI n'acceptent plus par
-    défaut les requêtes avec <code>PATH_INFO</code> (les informations
-    relatives au chemin en fin de requête). La directive <directive
-    module="core">AcceptPathInfo</directive> permet de configurer le
-    serveur de façon à ce qu'il accepte ce genre de requête.</p>
+    <p>Les fichiers traités dans le cadre des SSI n'acceptent plus par défaut
+    les requêtes avec <glossary ref="pathinfo">PATH_INFO</glossary> (les
+    informations relatives au chemin en fin de requête). La directive <directive
+    module="core">AcceptPathInfo</directive> permet de configurer le serveur de
+    façon à ce qu'il accepte ce genre de requête.</p>
 </section> <!-- /pathinfo -->
 
 <section id="elements"><title>Eléments disponibles</title>
index dbfaaf8752ec3557e859368e8ae464337be5cdbc..c2930e4806ef272caaad9845e708b17068a3c4f2 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933058:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -572,7 +572,8 @@ end
           <td><code>path_info</code></td>
           <td>string</td>
           <td>non</td>
-         <td>La valeur de PATH_INFO extraite de la requête.</td>
+         <td>La valeur de <glossary ref="pathinfo">PATH_INFO</glossary>
+         extraite de la requête.</td>
         </tr>
         <tr>
           <td><code>port</code></td>
index 72f347fb2c39c7a7310397590273ebf49da1fd58..057b9d43d30c19046a3ac5de182aadb83abd85b6 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933506:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
 <!-- French translation : Lucien GENTIS -->
 
 <!--
@@ -183,22 +183,21 @@ ProxyPass "/myapp/" "balancer://myappcluster/"
     </highlight>
     </example>
 
-    <p>Vous pouvez aussi forcer le traitement d'une requête en tant que
-    requête de mandataire inverse en créant un court-circuiteur de
-    gestionnaire approprié. Dans l'exemple ci-dessous, toutes les
-    requêtes pour des scripts PHP seront transmises au serveur FastCGI
-    spécifié par mandat inverse. Cette fonctionnalité est disponible à
-    partir de la version 2.4.10 du serveur HTTP Apache. Pour des raisons
-    de performances, il est recommandé de définir un <a
-    href="mod_proxy.html#workers">worker (configuration d'un
-    mandataire)</a> représentant le même serveur fcgi:// d'arrière-plan.
-    Avec cette configuration, il est possible d'effectuer une
-    correspondance directe entre l'URI et le chemin du fichier sur le
-    serveur, et le chemin local du fichier sera alors transmis au serveur
-    d'arrière-plan. Lorsque FastCGI est configuré ainsi, le serveur est
-    en mesure de calculer le PATH_INFO le plus approprié.
-      </p>
-       <example><title>Mandataire via un gestionnaire</title>
+    <p>Vous pouvez aussi forcer le traitement d'une requête en tant que requête
+    de mandataire inverse en créant un court-circuiteur de gestionnaire
+    approprié. Dans l'exemple ci-dessous, toutes les requêtes pour des scripts
+    PHP seront transmises au serveur FastCGI spécifié par mandat inverse. Cette
+    fonctionnalité est disponible à partir de la version 2.4.10 du serveur HTTP
+    Apache. Pour des raisons de performances, il est recommandé de définir un <a
+    href="mod_proxy.html#workers">worker (configuration d'un mandataire)</a>
+    représentant le même serveur fcgi:// d'arrière-plan.  Avec cette
+    configuration, il est possible d'effectuer une correspondance directe entre
+    l'URI et le chemin du fichier sur le serveur, et le chemin local du fichier
+    sera alors transmis au serveur d'arrière-plan. Lorsque FastCGI est configuré
+    ainsi, le serveur est en mesure de calculer le <glossary
+    ref="pathinfo">PATH_INFO</glossary> le plus approprié.
+    </p>
+  <example><title>Mandataire via un gestionnaire</title>
       <highlight language="config">
 &lt;FilesMatch "\.php$"&gt;
     # Note : la seule partie variable est /path/to/app.sock
index fa1fcb78127edf1ccf4a1f05ba6f167fd469b991..e585ff101c2649d0c570682cc2f100c287a8cc21 100644 (file)
@@ -1,10 +1,8 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933179:1934245 (outdated) -->
+<!-- English Revision: 1934245 -->
 <!-- French translation : Lucien GENTIS -->
-<!-- $LastChangedRevision: 2016071301 $ -->
-
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
@@ -88,19 +86,19 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/"
     contrôler le fournisseur de protocole SCGI :</p>
     <dl>
         <dt>proxy-scgi-pathinfo</dt>
-        <dd>Par défaut, <module>mod_proxy_scgi</module> ne créera ni
-       exportera jamais la variable d'environnement
-       <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan
-       de déterminer correctement <var>SCRIPT_NAME</var> et
-       <var>Script-URI</var>, et d'être en conformité avec la section
-       3.3 de la RFC 3875. Si au contraire vous souhaitez que
-       <module>mod_proxy_scgi</module> génère une estimation la plus
-       précise possible de <var>PATH_INFO</var>, définissez cette
-       variable d'environnement. La variable doit être définie avant
-       que la directive <directive module="mod_env">SetEnv</directive> ne soit
-       effective. Il est possible d'utiliser à la place la directive
-       <directive module="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf
-       Request_URI . proxy-scgi-pathinfo</code>
+       <dd>Par défaut, <module>mod_proxy_scgi</module> ne créera ni exportera
+       jamais la variable d'environnement <var><glossary
+       ref="pathinfo">PATH_INFO</glossary></var>. Cela permet au serveur SCGI
+       d'arrière-plan de déterminer correctement <var>SCRIPT_NAME</var> et
+       <var>Script-URI</var>, et d'être en conformité avec la section 3.3 de la
+       RFC 3875. Si au contraire vous souhaitez que
+       <module>mod_proxy_scgi</module> génère une estimation la plus précise
+       possible de <var>PATH_INFO</var>, définissez cette variable
+       d'environnement. La variable doit être définie avant que la directive
+       <directive module="mod_env">SetEnv</directive> ne soit effective. Il est
+       possible d'utiliser à la place la directive <directive
+       module="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf Request_URI
+       . proxy-scgi-pathinfo</code>
        </dd>
     </dl>
 </section>
index e47dde2ae01f55a1c19e76e7293ec9b5cd5d7d2a..fdb8951043ad8fdaa2bbbc0bf897492397b2c0a2 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: 1933179:1933949 (outdated) -->
+<!-- English Revision: 1933949 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
     <code>1</code>.</p>
 </section>
 
+<section id="files"><title>Fichiers</title>
+
+<p>Le répertoire racine du cache est spécifié en tant qu’argument de la ligne de
+commande et doit correspondre à la directive <code>CacheRoot</code> de la
+configuration globale du serveur.</p>
+
+<dl>
+<dt><var>chemin</var></dt>
+<dd>Le répertoire racine du cache sur disque à nettoyer.</dd>
+</dl>
+
+</section>
+
 </manualpage>
index 4ad4afc623717d8f26d36b8b434f7b93cc8e6de9..63c00d6399767709c7ff0becbcf53fe82abd4d69 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:1934521 (outdated) -->
+<!-- English Revision: 1934521 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -362,4 +362,18 @@ passe</title>
     octets et ne doivent pas contenir de caractère <code>:</code>.</p>
 </section>
 
+<section id="files"><title>Fichiers</title>
+
+<p>Le chemin du fichier de mots de passe DBM est spécifié en tant qu’argument de la ligne de
+commande et peut correspondre à n’importe quel emplacement du système de
+fichiers.</p>
+
+<dl>
+<dt><var>nom-fichier</var></dt>
+<dd>Le fichier au format DBM contenant les noms d’utilisateur et les mots de
+passe.</dd>
+</dl>
+
+</section>
+
 </manualpage>
index 9c0bb4860519c081e80ece03090283dc0a20047b..86acde4bd2f1865482b52307c1d71f493fe967b0 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 -->
 
@@ -237,4 +237,29 @@ afficher des informations à propos de la configuration :</p>
 </dl>
 </section>
 
+<section id="files"><title>Fichier</title>
+
+<p>Les chemins par défaut listés ci-après peuvent être modifiés à la compilation
+ou à l’aide de différents arguments de ligne de commande et directives de
+configuration. Consulter votre installation locale pour les emplacements réels.</p>
+
+<dl>
+<dt><code>/usr/local/apache2/conf/httpd.conf</code></dt>
+<dd>Fichier de configuration globale du serveur.</dd>
+
+<dt><code>/usr/local/apache2/conf/mime.types</code></dt>
+<dd>Correspondances de types MIME par défaut.</dd>
+
+<dt><code>/usr/local/apache2/logs/error_log</code></dt>
+<dd>Fichier du journal des erreurs.</dd>
+
+<dt><code>/usr/local/apache2/logs/access_log</code></dt>
+<dd>Fichier du journal des accès</dd>
+
+<dt><code>/usr/local/apache2/logs/httpd.pid</code></dt>
+<dd>Fichier contenant l’ID du processus du démon en cours d’exécution.</dd>
+</dl>
+
+</section>
+
 </manualpage>
index a9c3805a451409feefd4ab88412e0944986ccb4c..e6cc09fba14d8633d1edb5c7f42f0f11650935e4 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: 1755981:1934093 (outdated) -->
+<!-- English Revision: 1934093 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
 <section id="documentroot"><title>Racine des documents (DocumentRoot)</title>
 
     <p>La méthode par défaut de httpd pour déterminer quel fichier servir pour
-    une requête donnée, consiste à extraire le chemin du fichier de la requête
-    (la partie de l'URL qui suit le nom d'hôte et le port), puis de l'ajouter
-    à la fin de la valeur de la directive
-    <directive module="core">DocumentRoot</directive> définie dans vos fichiers
-    de configuration.
-    Ainsi, les fichiers et répertoires
-    situés en dessous de <directive module="core">DocumentRoot</directive>
-    constituent l'arborescence de base des documents qui seront visibles
-    depuis le web.</p>
+    une requête donnée, consiste à extraire le <a
+    href="directive-dict.html#Syntax">chemin de la requête</a> (la partie de
+    l'URL qui suit le nom d'hôte et le port), puis de l'ajouter à la fin de la
+    valeur de la directive <directive module="core">DocumentRoot</directive>
+    définie dans vos fichiers de configuration.  Ainsi, les fichiers et
+    répertoires situés en dessous de <directive
+    module="core">DocumentRoot</directive> constituent l'arborescence de base
+    des documents qui seront visibles depuis le web.</p>
 
     <p>Par exemple, si la directive
     <directive module="core">DocumentRoot</directive> contient