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 2017/05/27 13:03:34 UTC
svn commit: r1796392 - in /httpd/httpd/branches/2.4.x/docs/manual/mod:
core.xml.fr mod_authz_dbd.xml.fr mod_info.xml.fr
Author: lgentis
Date: Sat May 27 13:03:34 2017
New Revision: 1796392
URL: http://svn.apache.org/viewvc?rev=1796392&view=rev
Log:
XML updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_authz_dbd.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_info.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr?rev=1796392&r1=1796391&r2=1796392&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr [utf-8] Sat May 27 13:03:34 2017
@@ -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: 1787736:1796151 (outdated) -->
+<!-- English Revision: 1796151 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -1128,6 +1128,8 @@ requête à l'exécution</description>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
+<compatibility>Les conditions imbriquées sont supportées à partir de la version
+2.4.26 du serveur HTTP Apache</compatibility>
<usage>
<p>La section <directive type="section">Else</directive> applique
@@ -1175,6 +1177,8 @@ type="section">ElseIf</directive> préc�
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
+<compatibility>Les conditions imbriquées sont supportées à partir de la version
+2.4.26 du serveur HTTP Apache</compatibility>
<usage>
<p>La section <directive type="section">ElseIf</directive> applique
@@ -2343,6 +2347,8 @@ host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
+<compatibility>Les conditions imbriquées sont supportées à partir de la version
+2.4.26 du serveur HTTP Apache</compatibility>
<usage>
<p>La directive <directive type="section">If</directive> évalue une
@@ -2373,15 +2379,6 @@ host</context>
directives qui supportent le <a
href="directive-dict.html#Context">contexte de répertoire</a>.</p>
- <note><title>Ce n'est pas un langage de scripting</title>
- Le nom de cette directive peut sembler très familier aux programmeurs et
- administrateurs, mais il ne doit pas être confondu avec son homonyme des langages de
- scripting. A ce titre, l'implémentation actuelle n'envisage pas la
- possibilité d'imbriquer une section <directive type="section">If</directive>
- dans une autre (la section <directive type="section">If</directive> qui se
- trouve à l'intérieure de l'autre serait ignorée).
- </note>
-
<note type="warning">
Certain variables, such as <code>CONTENT_TYPE</code> and other
response headers, are set after <If> conditions have already
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_authz_dbd.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_authz_dbd.xml.fr?rev=1796392&r1=1796391&r2=1796392&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_authz_dbd.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_authz_dbd.xml.fr [utf-8] Sat May 27 13:03:34 2017
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?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: 1673563:1796297 (outdated) -->
+<!-- English Revision: 1796297 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,29 +25,29 @@
<modulesynopsis metafile="mod_authz_dbd.xml.meta">
<name>mod_authz_dbd</name>
-<description>Autorisation en groupe et reconnaissance d'identité avec base
+<description>Autorisation en groupe et reconnaissance d'identité avec base
SQL</description>
<status>Extension</status>
<sourcefile>mod_authz_dbd.c</sourcefile>
<identifier>authz_dbd_module</identifier>
-<compatibility>Disponible dans les versions 2.4 et supérieures
+<compatibility>Disponible dans les versions 2.4 et supérieures
d'Apache</compatibility>
<summary>
- <p>Ce module fournit des fonctionnalités d'autorisation permettant
- d'accorder ou de refuser aux utilisateurs authentifiés l'accès à
- certaines zones du site web en fonction de leur appartenance à tel
+ <p>Ce module fournit des fonctionnalités d'autorisation permettant
+ d'accorder ou de refuser aux utilisateurs authentifiés l'accès à
+ certaines zones du site web en fonction de leur appartenance à tel
ou tel groupe. Les modules <module>mod_authz_groupfile</module> et
- <module>mod_authz_dbm</module> fournissent une fonctionnalité
- similaire, mais ici le module interroge une base de données SQL pour
- déterminer si un utilisateur appartient ou non à tel ou tel groupe.</p>
- <p>Ce module propose également des fonctionnalités de connexion
- utilisateur s'appuyant sur une base de données, ce qui peut se révéler
- particulièrement utile lorsque le module est utilisé conjointement avec
+ <module>mod_authz_dbm</module> fournissent une fonctionnalité
+ similaire, mais ici le module interroge une base de données SQL pour
+ déterminer si un utilisateur appartient ou non à tel ou tel groupe.</p>
+ <p>Ce module propose également des fonctionnalités de connexion
+ utilisateur s'appuyant sur une base de données, ce qui peut se révéler
+ particulièrement utile lorsque le module est utilisé conjointement avec
<module>mod_authn_dbd</module>.</p>
- <p>Ce module s'appuie sur <module>mod_dbd</module> pour spécifier le
- pilote de la base de données sous-jacente et les paramètres de
- connexion, et gérer les connexions à la base de données.</p>
+ <p>Ce module s'appuie sur <module>mod_dbd</module> pour spécifier le
+ pilote de la base de données sous-jacente et les paramètres de
+ connexion, et gérer les connexions à la base de données.</p>
</summary>
<seealso><directive module="mod_authz_core">Require</directive></seealso>
@@ -62,7 +62,7 @@ d'Apache</compatibility>
<p>Les directives <directive
module="mod_authz_core">Require</directive> d'Apache permettent,
au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
- est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute
+ est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute
les types d'autorisation <code>dbd-group</code>,
<code>dbd-login</code> et <code>dbd-logout</code>.</p>
@@ -71,36 +71,36 @@ d'Apache</compatibility>
<section id="reqgroup"><title>Require dbd-group</title>
- <p>Cette directive permet de spécifier à quel groupe un utilisateur
- doit appartenir pour obtenir l'autorisation d'accès.</p>
+ <p>Cette directive permet de spécifier à quel groupe un utilisateur
+ doit appartenir pour obtenir l'autorisation d'accès.</p>
<highlight language="config">
- Require dbd-group team
- AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
+Require dbd-group team
+AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
</highlight>
</section>
<section id="reqlogin"><title>Require dbd-login</title>
- <p>Cette directive permet de spécifier une requête à exécuter pour
- indiquer que l'utilisateur s'est authentifié.</p>
+ <p>Cette directive permet de spécifier une requête à exécuter pour
+ indiquer que l'utilisateur s'est authentifié.</p>
<highlight language="config">
- Require dbd-login
- AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
+Require dbd-login
+AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
</highlight>
</section>
<section id="reqlogout"><title>Require dbd-logout</title>
- <p>Cette directive permet de spécifier une requête à exécuter pour
- indiquer que l'utilisateur s'est déconnecté.</p>
+ <p>Cette directive permet de spécifier une requête à exécuter pour
+ indiquer que l'utilisateur s'est déconnecté.</p>
<highlight language="config">
- Require dbd-logout
- AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
+Require dbd-logout
+AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
</highlight>
</section>
@@ -108,36 +108,36 @@ d'Apache</compatibility>
</section>
<section id="login">
-<title>Reconnaissance d'identité s'appuyant sur une base de données</title>
+<title>Reconnaissance d'identité s'appuyant sur une base de données</title>
<p>
-Outre sa fonction d'autorisation standard consistant à vérifier
-l'appartenance à des groupes, ce module permet aussi de gérer des
-sessions utilisateur côté serveur grâce à sa fonctionnalité de connexion utilisateur
-en s'appuyant sur une base de données. En particulier, il peut mettre à
-jour le statut de session de l'utilisateur dans la base de données
-chaque fois que celui-ci visite certaines URLs (sous réserve bien
+Outre sa fonction d'autorisation standard consistant à vérifier
+l'appartenance à des groupes, ce module permet aussi de gérer des
+sessions utilisateur côté serveur grâce à sa fonctionnalité de connexion utilisateur
+en s'appuyant sur une base de données. En particulier, il peut mettre à
+jour le statut de session de l'utilisateur dans la base de données
+chaque fois que celui-ci visite certaines URLs (sous réserve bien
entendu que l'utilisateur fournissent les informations de connexion
-nécessaires).</p>
+nécessaires).</p>
<p>Pour cela, il faut definir deux directives <directive
-module="mod_authz_core">Require</directive> spéciales : <code>Require
-dbd-login</code> et <code>Require dbd-logout</code>. Pour les détails de
+module="mod_authz_core">Require</directive> spéciales : <code>Require
+dbd-login</code> et <code>Require dbd-logout</code>. Pour les détails de
leur utilisation, voir l'exemple de configuration ci-dessous.</p>
</section>
<section id="client">
-<title>Reconnaissance d'identité côté client</title>
-<p>Certains administrateurs peuvent vouloir implémenter une gestion de
-session côté client fonctionnant de concert avec les fonctionnalités de
-connexion/déconnexion des utilisateurs côté serveur offertes par ce module, en
-définissant ou en annulant par exemple un cookie HTTP ou un jeton
-similaire lorsqu'un utilisateur se connecte ou se déconnecte.</p>
-
-<p>Pour supporter une telle intégration, <module>mod_authz_dbd</module> exporte
-un programme à déclenchement optionnel (hook) qui sera lancé chaque fois
-que le statut d'un utilisateur sera mis à jour dans la base de données.
+<title>Reconnaissance d'identité côté client</title>
+<p>Certains administrateurs peuvent vouloir implémenter une gestion de
+session côté client fonctionnant de concert avec les fonctionnalités de
+connexion/déconnexion des utilisateurs côté serveur offertes par ce module, en
+définissant ou en annulant par exemple un cookie HTTP ou un jeton
+similaire lorsqu'un utilisateur se connecte ou se déconnecte.</p>
+
+<p>Pour supporter une telle intégration, <module>mod_authz_dbd</module> exporte
+un programme à déclenchement optionnel (hook) qui sera lancé chaque fois
+que le statut d'un utilisateur sera mis à jour dans la base de données.
D'autres modules de gestion de session pourront alors utiliser ce
-programme pour implémenter des fonctions permettant d'ouvrir et de
-fermer des sessions côté client.</p>
+programme pour implémenter des fonctions permettant d'ouvrir et de
+fermer des sessions côté client.</p>
</section>
<section id="example">
@@ -159,7 +159,7 @@ DBDExptime 300
AuthName Team
AuthBasicProvider dbd
- # requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se
+ # requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se
# connecte
AuthDBDUserPWQuery \
"SELECT password FROM authn WHERE user = %s AND login = 'true'"
@@ -170,28 +170,28 @@ DBDExptime 300
# configuration de mod_authz_dbd
AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
- # lorsqu'un utilisateur échoue dans sa tentative d'authentification ou
- # d'autorisation, on l'invite à se connecter ; cette page doit
+ # lorsqu'un utilisateur échoue dans sa tentative d'authentification ou
+ # d'autorisation, on l'invite à se connecter ; cette page doit
# contenir un lien vers /team-private/login.html
ErrorDocument 401 "/login-info.html"
<Files "login.html">
- # il n'est pas nécessaire que l'utilisateur soit déjà connecté !
+ # il n'est pas nécessaire que l'utilisateur soit déjà connecté !
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
- # le processus de connexion dbd exécute une requête pour enregistrer
+ # le processus de connexion dbd exécute une requête pour enregistrer
# la connexion de l'utilisateur
Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
# redirige l'utilisateur vers la page d'origine (si elle existe)
- # après une connexion réussie
+ # après une connexion réussie
AuthzDBDLoginToReferer On
</Files>
<Files "logout.html">
- # le processus de déconnexion dbd exécute une requête pour
- # enregistrer la déconnexion de l'utilisateur
+ # le processus de déconnexion dbd exécute une requête pour
+ # enregistrer la déconnexion de l'utilisateur
Require dbd-logout
AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
</Files>
@@ -201,26 +201,26 @@ DBDExptime 300
<directivesynopsis>
<name>AuthzDBDQuery</name>
-<description>Définit la requête SQL pour l'opération requise</description>
-<syntax>AuthzDBDQuery <var>requête</var></syntax>
+<description>Définit la requête SQL pour l'opération requise</description>
+<syntax>AuthzDBDQuery <var>requête</var></syntax>
<contextlist><context>directory</context></contextlist>
<usage>
<p>La directive <directive>AuthzDBDQuery</directive> permet de
- spécifier une requête SQL à exécuter. Le but de cette requête dépend
+ spécifier une requête SQL à exécuter. Le but de cette requête dépend
de la directive <directive
module="mod_authz_core">Require</directive> en cours de
traitement.</p>
<ul>
- <li>Avec la directive <code>Require dbd-group</code>, elle spécifie
- une requête permettant de rechercher les groupes d'appartenance de
- l'utilisateur courant. Ceci correspond à la fonctionnalité standard
+ <li>Avec la directive <code>Require dbd-group</code>, elle spécifie
+ une requête permettant de rechercher les groupes d'appartenance de
+ l'utilisateur courant. Ceci correspond à la fonctionnalité standard
d'autres modules d'autorisation comme
<module>mod_authz_groupfile</module> et
<module>mod_authz_dbm</module>.
- La première colonne de chaque enregistrement renvoyé par la requête
- doit contenir une chaîne de caractères correspondant à un nom de
- groupe. La requête peut renvoyer zéro, un ou plusieurs
+ La première colonne de chaque enregistrement renvoyé par la requête
+ doit contenir une chaîne de caractères correspondant à un nom de
+ groupe. La requête peut renvoyer zéro, un ou plusieurs
enregistrements.
<highlight language="config">
Require dbd-group
@@ -228,10 +228,10 @@ AuthzDBDQuery "SELECT group FROM groups
</highlight>
</li>
<li>Avec la directive <code>Require dbd-login</code> ou
- <code>Require dbd-logout</code>, elle ne refusera jamais l'accès,
- mais au contraire exécutera une requête SQL permettant d'enregistrer
- la connexion ou la déconnexion de l'utilisateur. Ce dernier doit
- être déjà authentifié avec <module>mod_authn_dbd</module>.
+ <code>Require dbd-logout</code>, elle ne refusera jamais l'accès,
+ mais au contraire exécutera une requête SQL permettant d'enregistrer
+ la connexion ou la déconnexion de l'utilisateur. Ce dernier doit
+ être déjà authentifié avec <module>mod_authn_dbd</module>.
<highlight language="config">
Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
@@ -239,56 +239,56 @@ AuthzDBDQuery "UPDATE authn SET login =
</li>
</ul>
<p>Dans tous les cas, l'identifiant utilisateur sera transmis comme
- paramètre sous la forme d'une simple chaîne lorsque la requête SQL
- sera exécutée. Il y sera fait référence dans la requête en utilisant
- le spécificateur de format <code>%s</code>.</p>
+ paramètre sous la forme d'une simple chaîne lorsque la requête SQL
+ sera exécutée. Il y sera fait référence dans la requête en utilisant
+ le spécificateur de format <code>%s</code>.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>AuthzDBDRedirectQuery</name>
-<description>Définit une requête pour rechercher une page vers laquelle
-rediriger l'utilisateur après une connexion réussie</description>
-<syntax>AuthzDBDRedirectQuery <var>requête</var></syntax>
+<description>Définit une requête pour rechercher une page vers laquelle
+rediriger l'utilisateur après une connexion réussie</description>
+<syntax>AuthzDBDRedirectQuery <var>requête</var></syntax>
<contextlist><context>directory</context></contextlist>
<usage>
- <p>Spécifie une requête SQL optionnelle à utiliser après une
- connexion (ou une déconnexion) réussie pour rediriger l'utilisateur
- vers une URL, qui peut être spécifique à l'utilisateur.
- L'identifiant utilisateur sera transmis comme paramètre sous la
- forme d'une simple chaîne lorsque la requête SQL sera exécutée. Il y
- sera fait référence dans la requête en utilisant le spécificateur de
+ <p>Spécifie une requête SQL optionnelle à utiliser après une
+ connexion (ou une déconnexion) réussie pour rediriger l'utilisateur
+ vers une URL, qui peut être spécifique à l'utilisateur.
+ L'identifiant utilisateur sera transmis comme paramètre sous la
+ forme d'une simple chaîne lorsque la requête SQL sera exécutée. Il y
+ sera fait référence dans la requête en utilisant le spécificateur de
format <code>%s</code>.</p>
<highlight language="config">
AuthzDBDRedirectQuery "SELECT userpage FROM userpages WHERE user = %s"
</highlight>
- <p>La première colonne du premier enregistrement renvoyé par la
- requête doit contenir une chaîne de caractères correspondant à une
+ <p>La première colonne du premier enregistrement renvoyé par la
+ requête doit contenir une chaîne de caractères correspondant à une
URL vers laquelle rediriger le client. Les enregistrements suivants
- sont ignorés. Si aucun enregistrement n'est renvoyé, le client ne
- sera pas redirigé.</p>
+ sont ignorés. Si aucun enregistrement n'est renvoyé, le client ne
+ sera pas redirigé.</p>
<p>Notez que <directive>AuthzDBDLoginToReferer</directive> l'emporte
- sur cette directive si les deux sont définies.</p>
+ sur cette directive si les deux sont définies.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>AuthzDBDLoginToReferer</name>
-<description>Définit si le client doit être redirigé vers la page
-d'origine en cas de connexion ou de déconnexion réussie si un en-tête
-de requête <code>Referer</code> est présent</description>
+<description>Définit si le client doit être redirigé vers la page
+d'origine en cas de connexion ou de déconnexion réussie si un en-tête
+de requête <code>Referer</code> est présent</description>
<syntax>AuthzDBDLoginToReferer On|Off</syntax>
<default>AuthzDBDLoginToReferer Off</default>
<contextlist><context>directory</context></contextlist>
<usage>
- <p>Utilisée en conjonction avec <code>Require dbd-login</code> ou
+ <p>Utilisée en conjonction avec <code>Require dbd-login</code> ou
<code>Require dbd-logout</code>, cette directive permet de rediriger
- le client vers la page d'origine (l'URL contenue dans l'en-tête
- de requête HTTP <code>Referer</code>, s'il est présent). En
- l'absence d'en-tête <code>Referer</code>, la définition
- <code>AuthzDBDLoginToReferer On</code> sera ignorée.</p>
+ le client vers la page d'origine (l'URL contenue dans l'en-tête
+ de requête HTTP <code>Referer</code>, s'il est présent). En
+ l'absence d'en-tête <code>Referer</code>, la définition
+ <code>AuthzDBDLoginToReferer On</code> sera ignorée.</p>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_info.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_info.xml.fr?rev=1796392&r1=1796391&r2=1796392&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_info.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_info.xml.fr [utf-8] Sat May 27 13:03:34 2017
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?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: 1702020:1796131 (outdated) -->
+<!-- English Revision: 1796131 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,7 +25,7 @@
<modulesynopsis metafile="mod_info.xml.meta">
<name>mod_info</name>
-<description>Affiche une présentation complète de la configuration du
+<description>Affiche une présentation complète de la configuration du
serveur</description>
<status>Extension</status>
<sourcefile>mod_info.c</sourcefile>
@@ -33,7 +33,7 @@ serveur</description>
<summary>
<p>Pour activer <module>mod_info</module>, ajoutez les lignes
- suivantes à votre fichier <code>httpd.conf</code>.</p>
+ suivantes à votre fichier <code>httpd.conf</code>.</p>
<highlight language="config">
<Location "/server-info">
@@ -41,9 +41,9 @@ serveur</description>
</Location>
</highlight>
- <p>Il est recommandé d'utiliser <module>mod_authz_host</module> à
- l'intérieur de la section <directive type="section"
- module="core">Location</directive> afin de restreindre l'accès aux
+ <p>Il est recommandé d'utiliser <module>mod_authz_host</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>
<highlight language="config">
@@ -53,38 +53,38 @@ serveur</description>
</Location>
</highlight>
- <p>Une fois cette configuration effectuée, les informations du
- serveur sont disponibles à l'adresse
+ <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
+<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>
+ 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,
+ <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>
+ 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
+ <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>
+ <example><title>Contrôle d'accès</title>
<highlight language="config">
<Location "/server-info">
SetHandler server-info
- # Autorisation d'accès depuis le serveur lui-même
+ # Autorisation d'accès depuis le serveur lui-même
Require ip 127.0.0.1
- # Autorisation d'accès depuis une station de travail du réseau
+ # Autorisation d'accès depuis une station de travail du réseau
# local
Require ip 192.168.1.17
</Location>
@@ -92,99 +92,107 @@ serveur</description>
</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
+<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
+ 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
+ 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>
+ spécifié</dd>
<dt><code>?config</code></dt>
- <dd>Uniquement les directives de configuration, non triées
+ <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>
+ auxquels le module est attaché</dd>
<dt><code>?list</code></dt>
- <dd>Une simple liste des modules activés</dd>
+ <dd>Une simple liste des modules activés</dd>
<dt><code>?server</code></dt>
<dd>Uniquement des informations de base sur le serveur</dd>
+ <dt><code>?providers</code></dt>
+ <dd>Liste des fournisseurs disponibles sur votre serveur</dd>
</dl>
</section>
-<section id="startup"><title>Affichage de la configuration au démarrage</title>
+<section id="startup"><title>Affichage de la configuration au démarrage</title>
<p>Si la directive de configuration define
- <code>-DDUMP_CONFIG</code> est utilisée, <module>mod_info</module> va
- envoyer la configuration préinterprétée vers <code>stdout</code> au
- cours du démarrage du serveur. "Préinterprétée" signifie que
+ <code>-DDUMP_CONFIG</code> est utilisée, <module>mod_info</module> va
+ envoyer la configuration préinterprétée vers <code>stdout</code> au
+ cours du démarrage du serveur.</p>
+
+ <highlight language="sh">
+ httpd -DDUMP_CONFIG -k start
+ </highlight>
+
+ <p>"Préinterprétée" signifie que
les directives telles que <directive type="section"
module="core">IfDefine</directive> et <directive type="section"
- module="core">IfModule</directive> sont évaluées et les variables
- d'environnement remplacées par leurs valeurs. Cela ne représente
- cependant pas la configuration définitive. En particulier, les
- fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
- représentés.</p>
+ module="core">IfModule</directive> sont évaluées et les variables
+ d'environnement remplacées par leurs valeurs. Cela ne représente
+ cependant pas la configuration définitive. En particulier, les
+ fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
+ représentés.</p>
- <p>Le résultat est équivalent à celui de la requête
+ <p>Le résultat est équivalent à celui de la requête
<code>?config</code>.</p>
</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>
+ 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
+ <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" type="section">IfModule</directive> et
- <directive module="core" type="section">IfDefine</directive> ne
+ <li>Les directives qui contrôlent le fichier de configuration
+ lui-même, comme <directive module="core">Include</directive>,
+ <directive type="section" module="core">IfModule</directive> et
+ <directive type="section" 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 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"
- type="section">Directory</directive> sont affichées
+ <li>Les directives de conteneur comme <directive type="section"
+ 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" type="section"
+ déterminer le numéro de ligne de la balise fermante
+ <directive type="section" module="core"
name="Directory">/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
+ <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>
+<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>
<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
+ <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>
<highlight language="config">