diff options
Diffstat (limited to 'docs/manual/mod/mod_log_debug.xml.fr')
| -rw-r--r-- | docs/manual/mod/mod_log_debug.xml.fr | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_log_debug.xml.fr b/docs/manual/mod/mod_log_debug.xml.fr new file mode 100644 index 0000000000..953327c37c --- /dev/null +++ b/docs/manual/mod/mod_log_debug.xml.fr @@ -0,0 +1,148 @@ +<?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 : 1723522 --> +<!-- French translation : Lucien GENTIS --> +<!-- $LastChangedRevision: 2016010901 $ --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_log_debug.xml.meta"> + +<name>mod_log_debug</name> +<description>Possibilité de journalisation supplémentaire à des fins de +débogage</description> +<status>Experimental</status> +<sourcefile>mod_log_debug.c</sourcefile> +<identifier>log_debug_module</identifier> +<compatibility>Disponible depuis la version 2.3.14 d'Apache</compatibility> + +<section id="examples"><title>Exemples</title> + + <ol> + <li> + Enregistre un message après le traitement d'une requête pour + /foo/* : + + <highlight language="config"> +<Location "/foo/"> + LogMessage "/foo/ has been requested" +</Location> + </highlight> + </li> + + <li> + Enregistre un message si une requête pour /foo/* est traitée + dans une sous-requête : + <highlight language="config"> +<Location "/foo/"> + LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}" +</Location> + </highlight> + + Le branchement (hook) par défaut log_transaction n'est pas + exécuté pour les sous-requêtes ; nous devons donc en utiliser un + autre. + </li> + + + <li> + Enregistre un message si un client IPv6 est à l'origine d'un + dépassement de délai pour une requête : + <highlight language="config"> + LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408" + </highlight> + Notez l'emplacement des guillemets pour l'argument + <code>expr=</code>. + </li> + + <li> + Enregistre la valeur de la variable d'environnement de requête + "X-Foo" à chaque étape du traitement : + <highlight language="config"> +<Location "/"> + LogMessage "%{reqenv:X-Foo}" hook=all +</Location> + </highlight> + En association avec les repères de temps en microsecondes du journal des erreurs, + <code>hook=all</code> permet aussi de déterminer la durée d'exécution des + différentes phases du traitement de la requête. + </li> + + </ol> +</section> + +<directivesynopsis> +<name>LogMessage</name> +<description>Enregistre des messages personnalisés dans le journal des +erreurs</description> +<syntax>LogMessage <var>message</var> +[hook=<var>hook</var>] [expr=<var>expression</var>] +</syntax> +<default>Non défini</default> +<contextlist><context>directory</context> +</contextlist> + +<usage> + <p>Cette directive permet d'enregistrer un message personnalisé dans + le journal des erreurs. Ce message peut utiliser des variables et + des fonctions dans la <a href="../expr.html">syntaxe ap_expr</a>. + D'éventuelles références à des en-têtes HTTP dans l'expression + rationnelle n'entraîneront pas l'ajout des noms d'en-tête + correspondants à l'en-tête Vary. + Les messages sont enregistrés au loglevel info.</p> + + <p>Le branchement (hook) précise la phase du traitement de la + requête avant laquelle le message sera enregistré. Les branchements + suivants sont supportés :</p> + + <table border="1" style="zebra"> + <columnspec><column width="1"/></columnspec> + <tr><th>Nom</th></tr> + <tr><td><code>translate_name</code></td></tr> + <tr><td><code>type_checker</code></td></tr> + <tr><td><code>quick_handler</code></td></tr> + <tr><td><code>map_to_storage</code></td></tr> + <tr><td><code>check_access</code></td></tr> + <tr><td><code>check_access_ex</code></td></tr> + <tr><td><code>insert_filter</code></td></tr> + <tr><td><code>check_authn</code></td></tr> + <tr><td><code>check_authz</code></td></tr> + <tr><td><code>fixups</code></td></tr> + <tr><td><code>handler</code></td></tr> + <tr><td><code>log_transaction</code></td></tr> + </table> + + <p>Le branchement par défaut est <code>log_transaction</code>. La + valeur spéciale <code>all</code> est aussi supportée ; dans ce cas, + le message sera enregistré à chaque phase. Tous les branchements ne + sont pas exécutés pour chaque requête.</p> + + <p>L'expression optionnelle permet de restreindre l'enregistrement + du message en fonction d'une certaine condition. La syntaxe de + l'expression est décrite dans la <a + href="../expr.html">documentation ap_expr</a>. D'éventuelles + références à des en-têtes HTTP dans l'expression + rationnelle n'entraîneront pas l'ajout des noms d'en-tête + correspondants à l'en-tête Vary.</p> + +</usage> + +</directivesynopsis> + +</modulesynopsis> |