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_log_config - 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="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 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.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_log_config</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_log_config.html" title="Fran�ais"> fr </a> | 29<a href="/ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 30<a href="/ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 31<a href="/tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 32</div> 33<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation des requ�tes envoy�es au 34serveur</td></tr> 35<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> 36<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>log_config_module</td></tr> 37<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_log_config.c</td></tr></table> 38<h3>Sommaire</h3> 39 40 <p>Ce module apporte une grande souplesse dans la journalisation des 41 requ�tes des clients. Les journaux sont �crits sous un format 42 personnalisable, et peuvent �tre enregistr�s directement dans un 43 fichier, ou redirig�s vers un programme externe. La journalisation 44 conditionnelle est support�e, si bien que des requ�tes individuelles 45 peuvent �tre incluses ou exclues des journaux en fonction de leur 46 caract�ristiques.</p> 47 48 <p>Ce module fournit trois directives : <code class="directive"><a href="#transferlog">TransferLog</a></code> cr�e un fichier 49 journal, <code class="directive"><a href="#logformat">LogFormat</a></code> 50 d�finit un format personnalis�, et <code class="directive"><a href="#customlog">CustomLog</a></code> d�finit un fichier journal et un format en 51 une seule �tape. Pour journaliser les requ�tes dans plusieurs 52 fichiers, vous pouvez utiliser plusieurs fois les directives 53 <code class="directive">TransferLog</code> et 54 <code class="directive">CustomLog</code> dans chaque serveur.</p> 55</div> 56<div id="quickview"><h3 class="directives">Directives</h3> 57<ul id="toc"> 58<li><img alt="" src="/images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> 59<li><img alt="" src="/images/down.gif" /> <a href="#customlog">CustomLog</a></li> 60<li><img alt="" src="/images/down.gif" /> <a href="#logformat">LogFormat</a></li> 61<li><img alt="" src="/images/down.gif" /> <a href="#transferlog">TransferLog</a></li> 62</ul> 63<h3>Sujets</h3> 64<ul id="topics"> 65<li><img alt="" src="/images/down.gif" /> <a href="#formats">Formats de journaux personnalis�s</a></li> 66<li><img alt="" src="/images/down.gif" /> <a href="#security">Consid�rations concernant la 67s�curit�</a></li> 68</ul><h3>Voir aussi</h3> 69<ul class="seealso"> 70<li><a href="/logs.html">Les fichiers journaux 71d'Apache</a></li> 72</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 73<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 74<div class="section"> 75<h2><a name="formats" id="formats">Formats de journaux personnalis�s</a></h2> 76 77 <p>L'argument format des directives <code class="directive"><a href="#logformat">LogFormat</a></code> et <code class="directive"><a href="#customlog">CustomLog</a></code> est une cha�ne de 78 caract�res. Cette cha�ne d�finit le format de la journalisation des 79 requ�tes dans le fichier journal. Elle peut contenir des caract�res 80 litt�raux qui seront reproduits dans le fichier journal, et les 81 caract�res de contr�le de style C "\n" et "\t" repr�sentant 82 respectivement une nouvelle ligne et une tabulation. Les guillemets 83 et les anti-slashes litt�raux doivent �tre �chapp�s � l'aide 84 d'anti-slashes.</p> 85 86 <p>Les caract�ristiques de la requ�te en elle-m�me sont journalis�es 87 en ins�rant des directives "<code>%</code>" dans la cha�ne de 88 format, celles-ci �tant remplac�es dans le fichier journal par 89 certaines valeurs comme suit :</p> 90 91 <table class="bordered"><tr class="header"><th>Cha�ne de format</th> 92 <th>Description</th></tr> 93<tr><td><code>%%</code></td> 94 <td>Le signe "pourcentage"</td></tr> 95<tr class="odd"><td><code>%a</code></td> 96 <td>L'adresse IP distante (voir le module 97 <code class="module"><a href="/mod/mod_remoteip.html">mod_remoteip</a></code>).</td></tr> 98<tr><td><code>%{c}a</code></td> 99 <td>Adresse IP distante de la connexion(voir le module 100 <code class="module"><a href="/mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr> 101<tr class="odd"><td><code>%A</code></td> 102 <td>L'adresse IP locale</td></tr> 103<tr><td><code>%B</code></td> 104 <td>La taille de la r�ponse en octets, en excluant les en-t�tes 105 HTTP.</td></tr> 106<tr class="odd"><td><code>%b</code></td> 107 <td>La taille de la r�ponse en octets, en excluant les en-t�tes 108 HTTP. Au format CLF , c'est � dire un '<code>-</code>' � la 109 place d'un 0 lorsqu'aucun octet n'est renvoy�.</td></tr> 110<tr><td><code>%{<var>NOMVAR</var>}C</code></td> 111 <td>Le contenu du cookie <var>NOMVAR</var> dans la requ�te 112 envoy�e au serveur. Seuls les cookies version 0 sont pleinement 113 support�s.</td></tr> 114<tr class="odd"><td><code>%D</code></td> 115 <td>Le temps mis � servir la requ�te, en 116 microsecondes.</td></tr> 117<tr><td><code>%{<var>NOMVAR</var>}e</code></td> 118 <td>Le contenu de la variable d'environnement 119 <var>NOMVAR</var></td></tr> 120<tr class="odd"><td><code>%f</code></td> 121 <td>Nom de fichier</td></tr> 122<tr><td><code>%h</code></td> 123 <td>Serveur distant. Contiendra l'adresse IP si la directive 124 <code class="directive"><a href="/mod/core.html#hostnamelookups">HostnameLookups</a></code> est d�finie 125 � <code>Off</code>, ce qui est sa valeur par d�faut. Si cette 126 adresse IP n'est enregistr�e que pour certains serveurs, vous 127 avez probablement d�fini des directives de contr�le d'acc�s qui 128 mentionnent ces derniers par leurs noms. Voir la <a href="mod_authz_host.html#reqhost">documentation de Require 129 host</a>.</td></tr> 130<tr class="odd"><td><code>%H</code></td> 131 <td>Le protocole de la requ�te</td></tr> 132<tr><td><code>%{<var>NOMVAR</var>}i</code></td> 133 <td>Le contenu des lignes d'en-t�te 134 <code><var>NOMVAR</var>:</code> dans la requ�te envoy�e au 135 serveur. Ces en-t�tes sont ajout�s par d'autres modules (par 136 exemple <code class="module"><a href="/mod/mod_headers.html">mod_headers</a></code>). Si vous �tes int�ress� 137 par ce qu'�tait l'en-t�te de la requ�te avant d'�tre modifi� 138 par la plupart des modules, utilisez 139 <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> pour copier l'en-t�te dans une 140 variable d'environnement interne et journaliser sa valeur via 141 le champ <code>%{<var>VARNAME</var>}e</code> d�crit plus haut. 142 143 </td></tr> 144<tr class="odd"><td><code>%k</code></td> 145 <td>Nombre de requ�tes persistantes en cours pour cette 146 connexion. Interessant si la directive <code class="directive"><a href="/mod/core.html#keepalive">KeepAlive</a></code> est utilis�e ; par exemple, 147 '1' signifie la premi�re requ�te apr�s la requ�te initiale, '2' 148 la seconde, etc... ; autrement, il s'agit toujours de 0 149 (indiquant la requ�te initiale).</td></tr> 150<tr><td><code>%l</code></td> 151 <td>Le nom de connexion distant (en provenance d'identd, si 152 disponible). Affiche un tiret, sauf si 153 <code class="module"><a href="/mod/mod_ident.html">mod_ident</a></code> est pr�sent et si <code class="directive"><a href="/mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est � 154 <code>On</code>.</td></tr> 155<tr class="odd"><td><code>%L</code></td> 156 <td>L'identifiant du message de journalisation de la requ�te 157 dans le journal des erreurs (ou '-' si aucun message n'a 158 �t� enregistr� dans le journal des erreurs pour cette requ�te)</td></tr> 159<tr><td><code>%m</code></td> 160 <td>La m�thode de la requ�te</td></tr> 161<tr class="odd"><td><code>%{<var>NOMVAR</var>}n</code></td> 162 <td>Le contenu de la note <var>NOMVAR</var> en provenance d'un 163 autre module.</td></tr> 164<tr><td><code>%{<var>NOMVAR</var>}o</code></td> 165 <td>Le contenu de la ligne d'en-t�te 166 <code><var>NOMVAR</var>:</code> de la r�ponse.</td></tr> 167<tr class="odd"><td><code>%p</code></td> 168 <td>Le port canonique du serveur servant la requ�te</td></tr> 169<tr><td><code>%{<var>format</var>}p</code></td> 170 <td>Le port canonique du serveur servant la requ�te ou le 171 v�ritable port du serveur ou le v�ritable port du client. les 172 formats valides sont <code>canonical</code>, <code>local</code>, 173 ou <code>remote</code>. 174 </td></tr> 175<tr class="odd"><td><code>%P</code></td> 176 <td>Le num�ro de processus du processus enfant qui a servi la 177 requ�te.</td></tr> 178<tr><td><code>%{<var>format</var>}P</code></td> 179 <td>Le num�ro de processus ou le num�ro de thread du processus 180 enfant qui a servi la requ�te. Les formats valides sont 181 <code>pid</code>, <code>tid</code>, et <code>hextid</code>. 182 <code>hextid</code> n�cessite APR version 1.2.0 ou sup�rieure. 183 </td></tr> 184<tr class="odd"><td><code>%q</code></td> 185 <td>La cha�ne d'arguments (pr�fix�e par un <code>?</code> si une 186 cha�ne d'arguments existe, sinon une cha�ne vide)</td></tr> 187<tr><td><code>%r</code></td> 188 <td>La premi�re ligne de la requ�te</td></tr> 189<tr class="odd"><td><code>%R</code></td> 190 <td>Le gestionnaire qui g�n�re la r�ponse (s'il y en a un).</td></tr> 191<tr><td><code>%s</code></td> 192 <td>Statut. Pour les requ�tes redirig�es en interne, il s'agit 193 du statut de la requ�te *originale* --- <code>%>s</code> pour 194 la derni�re.</td></tr> 195<tr class="odd"><td><code>%t</code></td> 196 <td>Date � laquelle la requ�te a �t� re�ue (au format anglais 197 standard)</td></tr> 198<tr><td><code>%{<var>format</var>}t</code></td> 199 <td>La date, sous la forme sp�cifi�e par format, qui devrait 200 �tre au format �tendu <code>strftime(3)</code> (�ventuellement 201 localis�). Si le format commence par <code>begin:</code> (valeur 202 par d�faut), la date est extraite au d�but du traitement de la 203 requ�te ; s'il commence par <code>end:</code>, la date 204 correspond au moment o� l'entr�e du journal est inscrite, par 205 cons�quent vers la fin du traitement de la requ�te. Hormis les 206 formats support�s par <code>strftime(3)</code>, les formats 207 suivants sont aussi disponibles : 208 <table> 209 <tr><td><code>sec</code></td><td>nombre de secondes depuis Epoch</td></tr> 210 <tr><td><code>msec</code></td><td>nombre de millisecondes depuis Epoch</td></tr> 211 <tr><td><code>usec</code></td><td>nombre de microsecondes depuis Epoch</td></tr> 212 <tr><td><code>msec_frac</code></td><td>fraction de milliseconde</td></tr> 213 <tr><td><code>usec_frac</code></td><td>fraction de microseconde</td></tr> 214 </table> 215 Ces symboles ne peuvent pas �tre combin�s entre eux ou avec un 216 formatage <code>strftime(3)</code> dans la m�me cha�ne de 217 format. Par contre, vous pouvez utiliser plusieurs symboles 218 <code>%{<var>format</var>}t</code>.</td></tr> 219<tr class="odd"><td><code>%T</code></td> 220 <td>Le temps mis pour servir la requ�te, en secondes.</td></tr> 221<tr><td><code>%u</code></td> 222 <td>L'utilisateur distant (en provenance d'auth ; peut �tre faux 223 si le statut de retour (<code>%s</code>) est 401).</td></tr> 224<tr class="odd"><td><code>%U</code></td> 225 <td>Le chemin de la requ�te, � l'exclusion de toute cha�ne 226 d'arguments.</td></tr> 227<tr><td><code>%v</code></td> 228 <td>Le nom canonique du serveur qui a servi la requ�te, d�fini 229 par la directive <code class="directive"><a href="/mod/core.html#servername">ServerName</a></code>.</td></tr> 230<tr class="odd"><td><code>%V</code></td> 231 <td>La nom du serveur en tenant compte de la d�finition de la 232 directive <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</td></tr> 233<tr><td><code>%X</code></td> 234 <td>Statut de la connexion lorsque la r�ponse a �t� renvoy�e 235 : 236 237 <table> 238 239 <tr><td><code>X</code> =</td> 240 <td>connexion abandonn�e avant l'envoi de la r�ponse.</td></tr> 241 <tr><td><code>+</code> =</td> 242 <td>la connexion peut rester ouverte apr�s l'envoi de la 243 r�ponse.</td></tr> 244 <tr><td><code>-</code> = </td> 245 <td>la connexion sera ferm�e apr�s l'envoi de la 246 r�ponse.</td></tr> 247 </table> 248 249 </td></tr> 250<tr class="odd"><td><code>%I</code></td> 251 <td>Le nombre d'octets re�us, en comptant la requ�te et les 252 en-t�tes, ne peut �tre nul. N�cessite l'activation de 253 <code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code>.</td></tr> 254<tr><td><code>%O</code></td> 255 <td>Nombre d'octets envoy�s, y compris les en-t�tes, ne peut 256 �tre nul. N�cessite l'activation de 257 <code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code>.</td></tr> 258<tr class="odd"><td><code>%S</code></td> 259 <td>Nombre d'octets transmis (en �mission et r�ception), y 260 compris corps et en-t�tes de requ�te. Ce nombre ne peut pas �tre 261 nul, et il correspond � la combinaison des formats %I et %O. 262 <code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code> doit �tre charg� pour pouvoir 263 utiliser ce format.</td></tr> 264</table> 265 266 <h3><a name="modifiers" id="modifiers">Modificateurs</a></h3> 267 268 <p>Il est possible de restreindre l'enregistrement de certains 269 �l�ments 270 en fonction du code de statut de la r�ponse, en ins�rant une liste 271 de codes de statut s�par�s par des virgules imm�diatement apr�s le 272 caract�re "%". Par exemple, <code>"%400,501{User-agent}i"</code> 273 n'enregistrera l'en-t�te <code>User-agent</code> que dans le cas 274 d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la 275 cha�ne litt�rale <code>"-"</code> qui sera enregistr�e. La liste 276 de codes peut �tre pr�c�d�e d'un "<code>!</code>" pour inverser la 277 condition : <code>"%!200,304,302{Referer}i"</code> enregistre 278 l'en-t�te <code>Referer</code> pour toutes les requ�tes qui 279 <em>ne</em> renvoient <em>pas</em> un des trois codes sp�cifi�s.</p> 280 281 <p>Les modificateurs "<" et ">" peuvent �tre utilis�s pour 282 les requ�tes qui ont �t� redirig�es en interne afin de choisir si 283 c'est respectivement la requ�te originale ou finale qui doit �tre 284 consult�e. Par d�faut, les directives <code>%s, %U, %T, %D,</code> 285 et <code>%r</code> consultent la requ�te originale, alors que 286 toutes les autres consultent la requ�te finale. Ainsi, par 287 exemple, on peut utiliser <code>%>s</code> pour enregistrer le 288 statut final de la requ�te, et <code>%<u</code> pour 289 enregistrer l'utilisateur authentifi� � l'origine pour une requ�te 290 redirig�e en interne vers une ressource sans authentification.</p> 291 292 293 294 <h3><a name="format-notes" id="format-notes">Quelques Notes</a></h3> 295 296 <p>Pour des raisons de s�curit�, � partir de la version 2.0.46, 297 les caract�res non imprimables et autres caract�res sp�ciaux dans 298 les directives <code>%r</code>, <code>%i</code> et <code>%o</code> 299 doivent �tre �chapp�s � l'aide des s�quences 300 <code>\x<var>hh</var></code>, 301 o� <var>hh</var> est le code hexad�cimal du caract�re sp�cial. 302 Comme exceptions � cette r�gle, les caract�res <code>"</code> et 303 <code>\</code> doivent �tre �chapp�s par un anti-slash, et tous 304 les "blancs" doivent �tre �crits selon leur notation de style C 305 (<code>\n</code>, <code>\t</code>, etc...). Avant la version 306 2.0.46, aucun �chappement n'�tait effectu� sur ces cha�nes, et il 307 fallait �tre tr�s prudent lors de l'exploitation des journaux 308 bruts.</p> 309 310 <p>A la diff�rence de la version 1.3, dans httpd 2.0, les cha�nes 311 de format <code>%b</code> et <code>%B</code> ne repr�sentent pas 312 le nombre d'octets envoy�s au client, mais simplement la taille en 313 octets de la r�ponse HTTP (les deux �tant diff�rents, par exemple, 314 si la connexion est abandonn�e, ou si SSL est utilis�). Le format 315 <code>%O</code> fourni par <code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code>, 316 enregistrera le nombre r�el d'octets envoy�s sur le r�seau.</p> 317 318 <p>Note : <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> est impl�ment� en tant que 319 gestionnaire basique et non en tant que gestionnaire standard. 320 C'est pourquoi la cha�ne de format <code>%R</code> ne renverra pas 321 d'information � propos du gestionnaire lorsqu'une mise en cache de 322 contenu entre en jeu.</p> 323 324 325 326 <h3><a name="examples" id="examples">Exemples</a></h3> 327 328 <p>Quelques cha�nes de format couramment utilis�es :</p> 329 330 <dl> 331 <dt>Format de journal courant (CLF)</dt> 332 <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd> 333 334 <dt>Format de journal courant avec un serveur virtuel</dt> 335 <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> 336 337 <dt>Format de journal NCSA �tandu/combin�</dt> 338 <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" 339 \"%{User-agent}i\""</code></dd> 340 341 <dt>Format de journal de la page qui contient le lien vers la 342 page concern�e (Referer)</dt> 343 <dd><code>"%{Referer}i -> %U"</code></dd> 344 345 <dt>Format de journal de l'agent (Navigateur)</dt> 346 <dd><code>"%{User-agent}i"</code></dd> 347 </dl> 348 349 <p>Vous pouvez utiliser plusieurs fois la directive 350 <code>%{format}t</code> pour construire un format de temps 351 utilisant les symboles de format �tendus tels que 352 <code>msec_frac</code> :</p> 353 <dl> 354<dt>Format de temps prenant en compte les milisecondes</dt> 355<dd><code>"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"</code></dd> 356 357 </dl> 358 359 360</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 361<div class="section"> 362<h2><a name="security" id="security">Consid�rations concernant la 363s�curit�</a></h2> 364 <p>Voir le document <a href="/misc/security_tips.html#serverroot">conseils � mati�re de 365 s�curit�</a> pour plus de d�tails sur les raisons pour lesquelles 366 votre s�curit� pourrait �tre compromise, si le r�pertoire o� sont 367 stock�s les fichiers journaux sont inscriptibles par tout autre 368 utilisateur que celui qui d�marre le serveur.</p> 369</div> 370<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 371<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">Directive</a></h2> 372<table class="directive"> 373<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les entr�es du journal dans un tampon en m�moire 374avant de les �crire sur disque</td></tr> 375<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferedLogs On|Off</code></td></tr> 376<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>BufferedLogs Off</code></td></tr> 377<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 378<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 379<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> 380</table> 381 <p>Lorsque la directive <code class="directive">BufferedLogs</code> est � 382 "on", <code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code> stocke de nombreuses entr�es 383 du journal en m�moire, et les �crit d'un seul bloc sur disque, 384 plut�t que de les �crire apr�s chaque requ�te. Sur certains 385 syst�mes, ceci peut am�liorer l'efficacit� des acc�s disque, et par 386 cons�quent les performances. La directive ne peut �tre d�finie 387 qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas �tre 388 d�finie au niveau d'un serveur virtuel.</p> 389 390 <div class="note">Cette directive doit �tre utilis�e avec 391 pr�cautions car un crash peut provoquer la perte de donn�es de 392 journalisation.</div> 393 394</div> 395<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 396<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">Directive</a></h2> 397<table class="directive"> 398<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nom et le format du fichier 399journal</td></tr> 400<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CustomLog <var>fichier</var>|<var>pipe</var> 401<var>format</var>|<var>alias</var> 402[env=[!]<var>variable-environnement</var>| 403expr=<var>expression</var>]</code></td></tr> 404<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 405<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 406<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> 407</table> 408 <p>La directive <code class="directive">CustomLog</code> permet de contr�ler 409 la journalisation des requ�tes destin�es au serveur. Un format de 410 journal est sp�cifi�, et la journalisation peut s'effectuer de 411 mani�re conditionnelle en fonction des caract�ristiques de la 412 requ�te en utilisant des variables d'environnement.</p> 413 414 <p>Le premier argument, qui sp�cifie l'emplacement o� les journaux 415 seront �crits, accepte deux types de valeurs :</p> 416 417 <dl> 418 <dt><var>fichier</var></dt> 419 <dd>Un nom de fichier, relatif au r�pertoire d�fini par la 420 directive <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>.</dd> 421 422 <dt><var>pipe</var></dt> 423 <dd>Le caract�re pipe "<code>|</code>", suivi du chemin vers un 424 programme qui recevra les informations de la journalisation sur 425 son entr�e standard. Voir les notes � propos de la <a href="/logs.html#piped">journalisation redirig�e</a> pour plus 426 d'informations. 427 428 <div class="warning"><h3>S�curit� :</h3> 429 <p>Si les journaux sont redirig�s vers un programme, ce dernier 430 s'ex�cutera sous l'utilisateur qui a d�marr� 431 <code class="program"><a href="/programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur 432 a �t� d�marr� par root ; v�rifiez que le programme est 433 s�curis�.</p> 434 </div> 435 <div class="warning"><h3>Note</h3> 436 <p>Lors de la sp�cification d'un chemin de fichier sur les 437 plate-formes non-Unix, il faut prendre soin de ne pas oublier 438 que seuls les slashes directs doivent �tre utilis�s, m�me si la 439 plate-forme autorise l'emploi d'anti-slashes. D'une mani�re 440 g�n�rale, c'est une bonne id�e que de n'utiliser que des slashes 441 directs dans les fichiers de configuration.</p> 442 </div></dd> 443 </dl> 444 445 <p>Le second argument permet de d�finir ce qui va �tre �crit dans le 446 fichier journal. Il peut contenir soit un <var>alias</var> pr�d�fini 447 par une directive <code class="directive"><a href="#logformat">LogFormat</a></code>, soit une cha�ne de 448 <var>format</var> explicite comme d�crit dans la section <a href="#formats">formats de journaux</a>.</p> 449 450 <p>Par exemple, les deux blocs de directives suivants produisent le 451 m�me effet :</p> 452 453 <pre class="prettyprint lang-config"># Journal personnalis� avec alias de format 454LogFormat "%h %l %u %t \"%r\" %>s %b" common 455CustomLog logs/access_log common 456 457# Journal personnalis� avec cha�ne de format explicite 458CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"</pre> 459 460 461 <p>Le troisi�me argument est optionnel et permet de contr�ler si une 462 requ�te doit �tre ou non journalis�e. Dans le cas d'une clause 463 '<code>env=!<var>nom</var></code>', la condition peut �tre la 464 pr�sence ou l'absence d'une variable particuli�re dans 465 l'<a href="/env.html">environnement du serveur</a>. Dans le cas 466 d'une clause 'expr=<var>expression</var>', la condition consiste 467 en une <a href="/expr.html">expression</a> bool�enne 468 quelconque. Si la condition n'est pas v�rifi�e, la requ�te ne sera 469 pas journalis�e. D'�ventuelles r�f�rences � des en-t�tes HTTP dans 470 l'expression rationnelle n'entra�neront pas l'ajout des noms 471 d'en-t�te correspondants � l'en-t�te Vary.</p> 472 473 <p>Les variables d'environnement peuvent �tre d�finies au niveau de 474 chaque requ�te en utilisant les modules 475 <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> et/ou <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. 476 Par exemple, si vous voulez enregistrer les requ�tes pour toutes les 477 images GIF sur votre serveur dans un fichier journal s�par�, et pas 478 dans votre journal principal, vous pouvez utiliser :</p> 479 480 <pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image 481CustomLog gif-requests.log common env=gif-image 482CustomLog nongif-requests.log common env=!gif-image</pre> 483 484 485 <p>Ou, pour reproduire le comportement de l'ancienne directive 486 RefererIgnore, vous pouvez utiliser :</p> 487 488 <pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer 489CustomLog referer.log referer env=!localreferer</pre> 490 491 492</div> 493<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 494<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">Directive</a></h2> 495<table class="directive"> 496<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�crit un format utilisable dans un fichier 497journal</td></tr> 498<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogFormat <var>format</var>|<var>alias</var> 499[<var>alias</var>]</code></td></tr> 500<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> 501<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 502<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 503<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> 504</table> 505 <p>Cette directive permet de sp�cifier le format du fichier journal 506 des acc�s.</p> 507 508 <p>La directive <code class="directive">LogFormat</code> se pr�sente sous 509 deux formes. Sous la premi�re forme, qui ne poss�de qu'un seul 510 argument, la directive d�finit le format qui sera utilis� dans les 511 journaux sp�cifi�s par les directives 512 <code class="directive">TransferLog</code> ult�rieures. L'argument unique 513 peut contenir un <var>format</var> explicite comme d�crit dans la 514 section <a href="#formats">formats de journaux personnalis�s</a> 515 ci-dessus. Il peut aussi contenir un <var>alias</var> faisant 516 r�f�rence � un format de journal pr�d�fini par une directive 517 <code class="directive">LogFormat</code> comme d�crit plus loin.</p> 518 519 <p>Sous sa seconde forme, la directive 520 <code class="directive">LogFormat</code> associe un <var>format</var> 521 explicite � un <var>alias</var>. Cet <var>alias</var> peut 522 ensuite s'utiliser dans les directives 523 <code class="directive">LogFormat</code> ou <code class="directive"><a href="#customlog">CustomLog</a></code> ult�rieures, ce qui 524 �vite d'avoir � r�p�ter l'ensemble de la cha�ne de format. Une 525 directive <code class="directive">LogFormat</code> qui d�finit un alias 526 <strong>ne fait rien d'autre</strong> -- c'est � dire qu'<em>elle ne 527 fait que</em> d�finir l'alias, elle n'applique pas le format et n'en 528 fait pas le format par d�faut. Par cons�quent, elle n'affecte pas 529 les directives <code class="directive"><a href="#transferlog">TransferLog</a></code> ult�rieures. En 530 outre, la directive <code class="directive">LogFormat</code> ne peut pas 531 utiliser un alias pour en d�finir un autre. Notez que l'alias ne 532 doit pas contenir de caract�re pourcent (<code>%</code>).</p> 533 534 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun</pre> 535</div> 536 537 538</div> 539<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 540<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">Directive</a></h2> 541<table class="directive"> 542<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie l'emplacement d'un fichier journal</td></tr> 543<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TransferLog <var>fichier</var>|<var>pipe</var></code></td></tr> 544<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 545<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 546<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> 547</table> 548 <p>Cette directive poss�de exactement les m�mes arguments et produit 549 les m�mes effets que la directive <code class="directive"><a href="#customlog">CustomLog</a></code>, � l'exception qu'elle 550 ne permet pas de sp�cifier un format de journal explicite ou la 551 journalisation conditionnelle des requ�tes. En l'occurrence, le 552 format de journal est d�termin� par la derni�re d�finition d'une 553 directive <code class="directive"><a href="#logformat">LogFormat</a></code> 554 qui ne d�finit pas d'alias. Si aucun format particulier n'a �t� 555 sp�cifi�, c'est le Common Log Format qui sera utilis�.</p> 556 557 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" 558TransferLog logs/access_log</pre> 559</div> 560 561</div> 562</div> 563<div class="bottomlang"> 564<p><span>Langues Disponibles: </span><a href="/en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | 565<a href="/fr/mod/mod_log_config.html" title="Fran�ais"> fr </a> | 566<a href="/ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 567<a href="/ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 568<a href="/tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 569</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> 570<script type="text/javascript"><!--//--><![CDATA[//><!-- 571var comments_shortname = 'httpd'; 572var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; 573(function(w, d) { 574 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 575 d.write('<div id="comments_thread"><\/div>'); 576 var s = d.createElement('script'); 577 s.type = 'text/javascript'; 578 s.async = true; 579 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 580 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 581 } 582 else { 583 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 584 } 585})(window, document); 586//--><!]]></script></div><div id="footer"> 587<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> 588<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[//><!-- 589if (typeof(prettyPrint) !== 'undefined') { 590 prettyPrint(); 591} 592//--><!]]></script> 593</body></html>