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
7      -->
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.min.js" type="text/javascript">
13</script>
14
15<link href="/images/favicon.ico" rel="shortcut icon" /></head>
16<body>
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.4</p>
20<img alt="" src="/images/feather.gif" /></div>
21<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
22<div id="path">
23<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Modules</a></div>
24<div id="page-content">
25<div id="preamble"><h1>Module Apache mod_info</h1>
26<div class="toplang">
27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
28<a href="/fr/mod/mod_info.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
29<a href="/ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
30<a href="/ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
31</div>
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
33serveur</td></tr>
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>
37<h3>Sommaire</h3>
38
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>
41
42    <pre class="prettyprint lang-config">&lt;Location /server-info&gt;
43    SetHandler server-info
44&lt;/Location&gt;</pre>
45
46
47    <p>Il est recommand� d'utiliser <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> �
48    l'int�rieur de la section <code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code> afin de restreindre l'acc�s aux
49    informations de configuration de votre serveur :</p>
50
51    <pre class="prettyprint lang-config">&lt;Location /server-info&gt;
52    SetHandler server-info
53    Require host example.com
54&lt;/Location&gt;</pre>
55
56
57    <p>Une fois cette configuration effectu�e, les informations du
58    serveur sont disponibles � l'adresse
59    <code>http://votre-serveur.com/infos-serveur</code>.</p>
60</div>
61<div id="quickview"><h3 class="directives">Directives</h3>
62<ul id="toc">
63<li><img alt="" src="/images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
64</ul>
65<h3>Sujets</h3>
66<ul id="topics">
67<li><img alt="" src="/images/down.gif" /> <a href="#security">Probl�mes li�s � la s�curit�</a></li>
68<li><img alt="" src="/images/down.gif" /> <a href="#queries">Filtrage des informations affich�es</a></li>
69<li><img alt="" src="/images/down.gif" /> <a href="#startup">Affichage de la configuration au d�marrage</a></li>
70<li><img alt="" src="/images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
71</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
72<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
73<div class="section">
74<h2><a name="security" id="security">Probl�mes li�s � la s�curit�</a></h2>
75    <p>Une fois <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> charg� dans le serveur, sa
76    fonctionnalit� de gestionnaire est disponible dans <em>tous</em> les
77    fichiers de configuration, y compris les fichiers de configuration
78    des r�pertoires (par exemple <code>.htaccess</code>). Ceci peut
79    avoir des r�percutions en mati�re de s�curit� pour votre site.</p>
80
81    <p>En particulier, l'utilisation de ce module peut conduire � la
82    divulgation d'informations sensibles � partir des directives de
83    configuration d'autres modules Apache comme des chemins syst�mes,
84    des couples nom d'utilisateur/mot de passe, des noms de bases de
85    donn�es, etc... C'est pourquoi ce module ne doit �tre utilis�
86    <strong>que</strong> dans un environnement sous contr�le et toujours
87    avec les plus grandes pr�cautions.</p>
88
89    <p>Il est recommand� d'utiliser <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> pour
90    restreindre l'acc�s aux informations de configuration de votre
91    serveur.</p>
92
93    <div class="example"><h3>Contr�le d'acc�s</h3><pre class="prettyprint lang-config">&lt;Location /server-info&gt;
94    SetHandler server-info
95    Order allow,deny
96    # Autorisation d'acc�s depuis le serveur lui-m�me
97    Allow from 127.0.0.1
98    # Autorisation d'acc�s depuis une station de travail du r�seau
99# local
100    Allow from 192.168.1.17
101&lt;/Location&gt;</pre>
102</div>
103</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
104<div class="section">
105<h2><a name="queries" id="queries">Filtrage des informations affich�es</a></h2>
106    <p>Par d�faut, les informations affich�es comprennent une liste de
107    tous les modules activ�s, et pour chaque module, une description des
108    directives qu'il accepte, les branchements (hooks) qu'il
109    impl�mente, ainsi que les directives concern�es dans la
110    configuration courante.</p>
111
112    <p>Il est possible d'afficher d'autres vues de la configuration en
113    ajoutant un argument � la requ�te <code>infos-serveur</code>. Par
114    exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
115    affichera toutes les directives de configuration.</p>
116
117    <dl>
118        <dt><code>?&lt;module-name&gt;</code></dt>
119            <dd>Uniquement les informations relatives au module
120	    sp�cifi�</dd>
121        <dt><code>?config</code></dt>
122            <dd>Uniquement les directives de configuration, non tri�es
123	    par module</dd>
124        <dt><code>?hooks</code></dt>
125            <dd>Uniquement la liste des branchements (hooks)
126	    auxquels le module est attach�</dd>
127        <dt><code>?list</code></dt>
128            <dd>Une simple liste des modules activ�s</dd>
129        <dt><code>?server</code></dt>
130            <dd>Uniquement des informations de base sur le serveur</dd>
131    </dl>
132</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
133<div class="section">
134<h2><a name="startup" id="startup">Affichage de la configuration au d�marrage</a></h2>
135    <p>Si la directive de configuration define
136    <code>-DDUMP_CONFIG</code> est utilis�e, <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> va
137    envoyer la configuration pr�interpr�t�e vers <code>stdout</code> au
138    cours du d�marrage du serveur. "Pr�interpr�t�e" signifie que
139    les directives telles que <code class="directive"><a href="/mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="/mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> sont �valu�es et les variables
140    d'environnement remplac�es par leurs valeurs. Cela ne repr�sente
141    cependant pas la configuration d�finitive. En particulier, les
142    fusions ou �crasementsde d�finitions en cas de directives multiples ne sont pas
143    repr�sent�s.</p>
144
145    <p>Le r�sultat est �quivalent � celui de la requ�te
146    <code>?config</code>.</p>
147    
148</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
149<div class="section">
150<h2><a name="limitations" id="limitations">Limitations connues</a></h2>
151    <p><code class="module"><a href="/mod/mod_info.html">mod_info</a></code> tire ses informations de
152    la configuration interpr�t�e, et non du fichier de configuration
153    original. La mani�re dont l'arbre de configuration interpr�t� est
154    cr�� induit quelques limitations :</p>
155    <ul>
156      <li>Les directives qui sont trait�es imm�diatement sans �tre
157      enregistr�es dans l'arbre de configuration interpr�t� ne sont pas
158      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>
159      <li>Les directives qui contr�lent le fichier de configuration
160      lui-m�me, comme <code class="directive"><a href="/mod/core.html#include">Include</a></code>,
161      <code class="directive"><a href="/mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> et
162      <code class="directive"><a href="/mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> ne
163      sont pas prises en compte, mais les directives de configuration
164      incluses le sont.</li>
165      <li>Les commentaires ne sont pas pris en compte (Ce qui peut �tre
166      consid�r� comme une fonctionnalit�).</li>
167      <li>Les directives de configuration des fichiers
168      <code>.htaccess</code> ne sont pas prises en compte (car elles ne
169      font pas partie de la configuration permanente du serveur).</li>
170      <li>Les directives de conteneur comme <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> sont affich�es
171      normalement, mais <code class="module"><a href="/mod/mod_info.html">mod_info</a></code> est incapable de
172      d�terminer le num�ro de ligne de la balise fermante
173      <code class="directive"><a href="/mod/core.html#directory">&lt;/Directory&gt;</a></code>.</li>
174      <li>Les directives g�n�r�es par des modules tiers comme
175      <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas �tre
176      prises en compte.</li>
177    </ul>
178</div>
179<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
180<div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
181<table class="directive">
182<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des donn�es suppl�mentaires aux informations de
183module affich�es par le gestionnaire server-info</td></tr>
184<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>
185<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
186<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
187<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
188</table>
189    <p>Cette directive permet d'afficher le contenu de <var>cha�ne</var>
190    en tant qu'<strong>Information suppl�mentaire</strong> interpr�t�e
191    en HTML pour le module <var>nom-module</var>. Exemple :</p>
192
193    <pre class="prettyprint lang-config">AddModuleInfo mod_deflate.c 'See &lt;a \
194    href="http://httpd.apache.org/docs/2.4/mod/mod_deflate.html"&gt;\
195    http://httpd.apache.org/docs/2.4/mod/mod_deflate.html</a>;'</pre>
196
197
198</div>
199</div>
200<div class="bottomlang">
201<p><span>Langues Disponibles: </span><a href="/en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
202<a href="/fr/mod/mod_info.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
203<a href="/ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
204<a href="/ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
205</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&amp;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>
206<script type="text/javascript"><!--//--><![CDATA[//><!--
207var comments_shortname = 'httpd';
208var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_info.html';
209(function(w, d) {
210    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
211        d.write('<div id="comments_thread"><\/div>');
212        var s = d.createElement('script');
213        s.type = 'text/javascript';
214        s.async = true;
215        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
216        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
217    }
218    else { 
219        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
220    }
221})(window, document);
222//--><!]]></script></div><div id="footer">
223<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
224<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[//><!--
225if (typeof(prettyPrint) !== 'undefined') {
226    prettyPrint();
227}
228//--><!]]></script>
229</body></html>