1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>mod_info - Serveur Apache HTTP</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
12 <script src="../style/scripts/prettify.js" type="text/javascript">
15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
17 <div id="page-header">
18 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
19 <p class="apache">Serveur Apache HTTP Version 2.5</p>
20 <img alt="" src="../images/feather.gif" /></div>
21 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
23 <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.5</a> > <a href="./">Modules</a></div>
24 <div id="page-content">
25 <div id="preamble"><h1>Module Apache mod_info</h1>
27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> |
28 <a href="../fr/mod/mod_info.html" title="Français"> fr </a> |
29 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
30 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
32 <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
34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr>
36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table>
39 <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes
40 suivantes à votre fichier <code>httpd.conf</code>.</p>
42 <pre class="prettyprint lang-config">
43 <Location /server-info>
44 SetHandler server-info
49 <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> à
50 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
51 informations de configuration de votre serveur :</p>
53 <pre class="prettyprint lang-config">
54 <Location /server-info>
55 SetHandler server-info
56 Require host example.com
61 <p>Une fois cette configuration effectuée, les informations du
62 serveur sont disponibles à l'adresse
63 <code>http://votre-serveur.com/infos-serveur</code>.</p>
65 <div id="quickview"><h3 class="directives">Directives</h3>
67 <li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#startup">Affichage de la configuration au démarrage</a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
75 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
76 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
78 <h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2>
79 <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa
80 fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
81 fichiers de configuration, y compris les fichiers de configuration
82 des répertoires (par exemple <code>.htaccess</code>). Ceci peut
83 avoir des répercutions en matière de sécurité pour votre site.</p>
85 <p>En particulier, l'utilisation de ce module peut conduire à la
86 divulgation d'informations sensibles à partir des directives de
87 configuration d'autres modules Apache comme des chemins systèmes,
88 des couples nom d'utilisateur/mot de passe, des noms de bases de
89 données, etc... C'est pourquoi ce module ne doit être utilisé
90 <strong>que</strong> dans un environnement sous contrôle et toujours
91 avec les plus grandes précautions.</p>
93 <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour
94 restreindre l'accès aux informations de configuration de votre
97 <div class="example"><h3>Contrôle d'accès</h3><pre class="prettyprint lang-config">
98 <Location /server-info>
99 SetHandler server-info
101 # Autorisation d'accès depuis le serveur lui-même
103 # Autorisation d'accès depuis une station de travail du réseau
105 Allow from 192.168.1.17
109 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
110 <div class="section">
111 <h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2>
112 <p>Par défaut, les informations affichées comprennent une liste de
113 tous les modules activés, et pour chaque module, une description des
114 directives qu'il accepte, les branchements (hooks) qu'il
115 implémente, ainsi que les directives concernées dans la
116 configuration courante.</p>
118 <p>Il est possible d'afficher d'autres vues de la configuration en
119 ajoutant un argument à la requête <code>infos-serveur</code>. Par
120 exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
121 affichera toutes les directives de configuration.</p>
124 <dt><code>?<module-name></code></dt>
125 <dd>Uniquement les informations relatives au module
127 <dt><code>?config</code></dt>
128 <dd>Uniquement les directives de configuration, non triées
130 <dt><code>?hooks</code></dt>
131 <dd>Uniquement la liste des branchements (hooks)
132 auxquels le module est attaché</dd>
133 <dt><code>?list</code></dt>
134 <dd>Une simple liste des modules activés</dd>
135 <dt><code>?server</code></dt>
136 <dd>Uniquement des informations de base sur le serveur</dd>
138 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
139 <div class="section">
140 <h2><a name="startup" id="startup">Affichage de la configuration au démarrage</a></h2>
141 <p>Si la directive de configuration define
142 <code>-DDUMP_CONFIG</code> est utilisée, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va
143 envoyer la configuration préinterprétée vers <code>stdout</code> au
144 cours du démarrage du serveur. "Préinterprétée" signifie que
145 les directives telles que <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> sont évaluées et les variables
146 d'environnement remplacées par leurs valeurs. Cela ne représente
147 cependant pas la configuration définitive. En particulier, les
148 fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
151 <p>Le résultat est équivalent à celui de la requête
152 <code>?config</code>.</p>
154 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
155 <div class="section">
156 <h2><a name="limitations" id="limitations">Limitations connues</a></h2>
157 <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de
158 la configuration interprétée, et non du fichier de configuration
159 original. La manière dont l'arbre de configuration interprété est
160 créé induit quelques limitations :</p>
162 <li>Les directives qui sont traitées immédiatement sans être
163 enregistrées dans l'arbre de configuration interprété ne sont pas
164 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>
165 <li>Les directives qui contrôlent le fichier de configuration
166 lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>,
167 <code class="directive"><a href="../mod/core.html#<ifmodule>"><IfModule></a></code> et
168 <code class="directive"><a href="../mod/core.html#<ifdefine>"><IfDefine></a></code> ne sont pas
169 prises en compte, mais les directives de configuration incluses le
171 <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
172 considéré comme une fonctionnalité).</li>
173 <li>Les directives de configuration des fichiers
174 <code>.htaccess</code> ne sont pas prises en compte (car elles ne
175 font pas partie de la configuration permanente du serveur).</li>
176 <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#<directory>"><Directory></a></code> sont affichées
177 normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de
178 déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#</directory>"></Directory></a></code>.</li>
179 <li>Les directives générées par des modules tiers comme
180 <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
181 prises en compte.</li>
184 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
185 <div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
186 <table class="directive">
187 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
188 module affichées par le gestionnaire server-info</td></tr>
189 <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>
190 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
191 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
192 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
194 <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
195 en tant qu'<strong>Information supplémentaire</strong> interprétée
196 en HTML pour le module <var>nom-module</var>. Exemple :</p>
198 <pre class="prettyprint lang-config">
199 AddModuleInfo mod_deflate.c 'See <a \
200 href="http://www.apache.org/docs/trunk/mod/mod_deflate.html">\
201 http://www.apache.org/docs/trunk/mod/mod_deflate.html</a>'
207 <div class="bottomlang">
208 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> |
209 <a href="../fr/mod/mod_info.html" title="Français"> fr </a> |
210 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
211 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
212 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
213 <script type="text/javascript"><!--//--><![CDATA[//><!--
214 var comments_shortname = 'httpd';
215 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_info.html';
217 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
218 d.write('<div id="comments_thread"><\/div>');
219 var s = d.createElement('script');
220 s.type = 'text/javascript';
222 s.src = 'https://c.apaste.info/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
223 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
226 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
228 })(window, document);
229 //--><!]]></script></div><div id="footer">
230 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
231 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
232 if (typeof(prettyPrint) !== 'undefined') {