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 2013/09/21 16:23:51 UTC
svn commit: r1525240 - in /httpd/httpd/branches/2.4.x/docs/manual:
index.xml.fr mod/mod_filter.xml.fr mod/mod_headers.xml.fr
mod/mod_ldap.xml.fr mod/mod_log_config.xml.fr mod/mod_logio.xml.fr
mod/mod_lua.xml.fr mod/mod_macro.xml.fr
Author: lgentis
Date: Sat Sep 21 14:23:50 2013
New Revision: 1525240
URL: http://svn.apache.org/r1525240
Log:
Updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/index.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_headers.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ldap.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_log_config.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_logio.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_macro.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/index.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/index.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/index.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/index.xml.fr Sat Sep 21 14:23:50 2013
@@ -3,7 +3,7 @@
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1516165:1524238 (outdated) -->
+<!-- English Revision : 1524238 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -40,8 +40,7 @@
<page href="install.html">Compilation et installation</page>
<page href="invoking.html">Démarrage</page>
<page href="stopping.html">Arrêt ou redémarrage</page>
- <page href="mod/directives.html">Directives de configuration à l'exécution</page>
- <page href="mod/quickreference.html">Référence rapide des directives</page>
+ <page href="mod/quickreference.html">Directives de configuration à l'exécution</page>
<page href="mod/">Modules</page>
<page href="mpm.html">Modules multi-processus (MPMs)</page>
<page href="filter.html">Filtres</page>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1421892:1523325 (outdated) -->
+<!-- English Revision : 1523325 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -454,12 +454,20 @@ Apache</a>, pour une référ
deux arguments, elle s'applique à un <var>nom filtre</var> pour
<em>tout</em> fournisseur qu'il actionne.</p>
+ <p>Les drapeaux spécifiés sont fusionnés avec les drapeaux que les
+ fournisseurs sous-jacents ont éventuellement enregistrés avec
+ <module>mod_filter</module>. Par exemple, un filtre peut avoir
+ spécifié en interne un drapeau équivalent à <code>change=yes</code>,
+ mais une configuration particulière du module peut le surcharger
+ en spécifiant <code>change=no</code>.
+ </p>
+
<p><var>drapeaux protocole</var> peut contenir un ou plusieurs
drapeaux parmi les suivants :</p>
<dl>
- <dt><code>change=yes</code></dt>
- <dd>Le filtre modifie le contenu, y compris éventuellement sa
+ <dt><code>change=yes|no</code></dt>
+ <dd>Indique si le filtre doit modifier le contenu, y compris éventuellement sa
taille</dd>
<dt><code>change=1:1</code></dt>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_headers.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_headers.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_headers.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_headers.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1418937:1523271 (outdated) -->
+<!-- English Revision : 1523271 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -271,6 +271,10 @@ Header merge Cache-Control no-store env=
<dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec
le même nom.</dd>
+ <dt><code>setifempty</code></dt>
+ <dd>L'en-tête est défini, mais seulement s'il n'existe
+ aucun en-tête avec le même nom.</dd>
+
<dt><code>unset</code></dt>
<dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
possèdent le même nom, ils seront tous supprimés. L'argument
@@ -325,7 +329,7 @@ Header merge Cache-Control no-store env=
<directivesynopsis>
<name>Header</name>
<description>Configure les en-têtes d'une réponse HTTP</description>
-<syntax>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|unset
+<syntax>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|unset|note
<var>en-tête</var> [<var>valeur</var>] [<var>remplacement</var>]
[early|env=[!]<var>variable</var>]|expr=<var>expression</var>]
</syntax>
@@ -430,10 +434,22 @@ Header merge Cache-Control no-store env=
le même nom. L'argument <var>valeur</var> peut être une chaîne de
formatage.</dd>
+ <dt><code>setifempty</code></dt>
+ <dd>L'en-tête est défini, mais seulement s'il n'existe
+ aucun en-tête avec le même nom.</dd>
+
<dt><code>unset</code></dt>
<dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
possèdent le même nom, ils seront tous supprimés. L'argument
<var>value</var> ne doit pas apparaître.</dd>
+
+ <dt><code>note</code></dt>
+ <dd>La valeur de l'<var>en-tête</var> considéré est copiée dans une
+ note interne dont le nom est spécifié via l'argument
+ <var>valeur</var>. Ceci permet d'enregistrer la valeur d'un en-tête
+ envoyé par un programme CGI ou une ressource mandatée, même s'il
+ est prévu de l'effacer.</dd>
+
</dl>
<p>Cet argument est suivi d'un nom d'<var>en-tête</var> qui peut se
@@ -472,23 +488,23 @@ Header merge Cache-Control no-store env=
<tr><td><code>%l</code></td>
<td>La charge courante du serveur. Ce sont les valeurs fournies
- par <code>getloadavg()</code> qui représentent la charge
+ par <code>getloadavg()</code> qui représentent la charge
courante, ainsi que la charge moyenne pendant les cinq et les
- quinze dernières minutes. Chaque valeur est précédée de
- <code>l=</code> et séparée des autres par un slash
+ quinze dernières minutes. Chaque valeur est précédée de
+ <code>l=</code> et séparée des autres par un slash
<code>/</code>.
</td></tr>
<tr><td><code>%i</code></td>
- <td>Le pourcentage de disponibilité de httpd (0 à 100) basé sur
+ <td>Le pourcentage de disponibilité de httpd (0 à 100) basé sur
le nombre de threads et de processus disponibles. La valeur est
- précédée de <code>i=</code>.
+ précédée de <code>i=</code>.
</td></tr>
<tr><td><code>%b</code></td>
- <td>Le pourcentage d'utilisation de httpd (0 à 100) basé sur
+ <td>Le pourcentage d'utilisation de httpd (0 à 100) basé sur
le nombre de threads et de processus disponibles. La valeur est
- précédée de <code>b=</code>.
+ précédée de <code>b=</code>.
</td></tr>
<tr><td><code>%{NOM_VARIABLE}e</code></td>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ldap.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ldap.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ldap.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ldap.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1452868:1523263 (outdated) -->
+<!-- English Revision : 1523263 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -556,7 +556,7 @@ LDAP.</description>
<name>LDAPReferrals</name>
<description>Active la redirection vers des serveurs alternatifs au
cours des requêtes vers le serveur LDAP.</description>
-<syntax>LDAPReferrals <var>On|Off</var></syntax>
+<syntax>LDAPReferrals <var>On|Off|default</var></syntax>
<default>LDAPReferrals On</default>
<contextlist><context>directory</context><context>.htaccess</context></contextlist>
<override>AuthConfig</override>
@@ -565,15 +565,36 @@ cours des requêtes vers le serveur
<p>Certains serveurs LDAP partagent leur annuaire en plusieurs
domaines et utilisent le système des redirections (referrals) pour
aiguiller un client lorsque les limites d'un domaine doivent être
- franchies. En définissant <code>LDAPReferrals On</code>, les
- redirections seront prises en compte (et bien entendu, en
- définissant <code>LDAPReferrals Off</code>, les redirections seront
- ignorées). La directive <code>LDAPReferralHopLimit</code> complète
- cette directive en définissant le nombre maximum de redirections à
- suivre avant l'abandon de la requête LDAP. Lorsque le traitement des
- redirections est activé, les données d'identification du client
- seront fournies, via un appel (callback) de réidentification, à tout
- serveur LDAP qui en fera la demande.</p>
+ franchies. Ce processus est similaire à une redirection HTTP. Les
+ bibliothèques client LDAP ne respectent pas forcément ces
+ redirections par défaut. Cette directive permet de configurer
+ explicitement les redirections LDAP dans le SDK sous-jacent.</p>
+
+ <p>La directive <directive>LDAPReferrals</directive> accepte les
+ valeurs suivantes :</p>
+
+ <dl>
+ <dt>"on"</dt>
+ <dd> <p>Avec la valeur "on", la prise en compte des redirections
+ LDAP par le SDK sous-jacent est activée, la directive
+ <directive>LDAPReferralHopLimit</directive> permet de surcharger la
+ "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.</p></dd>
+ <dt>"off"</dt>
+ <dd> <p>Avec la valeur "off", la prise en compte des redirections
+ LDAP par le SDK sous-jacent est complètement désactivée.</p></dd>
+ <dt>"default"</dt>
+ <dd> <p>Avec la valeur "default", la prise en compte des redirections
+ LDAP par le SDK sous-jacent n'est pas modifiée, la directive
+ <directive>LDAPReferralHopLimit</directive> ne permet pas de surcharger la
+ "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.</p></dd>
+ </dl>
+
+ <p>La directive <code>LDAPReferralHopLimit</code> travaille en
+ conjonction avec cette directive pour limiter le nombre de
+ redirections à suivre pour achever le traitement de la requête LDAP.
+ Lorsque le processus de redirection est activé par la valeur "On",
+ les données d'authentification du client sont transmises via un
+ "rebind callback" à tout serveur LDAP qui en fait la demande.</p>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_log_config.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_log_config.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_log_config.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_log_config.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1510844:1523269 (outdated) -->
+<!-- English Revision : 1523269 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,7 +25,7 @@
<modulesynopsis metafile="mod_log_config.xml.meta">
<name>mod_log_config</name>
-<description>Journalisation des requêtes envoyées au
+<description>Journalisation des requêtes envoyées au
serveur</description>
<status>Base</status>
<sourcefile>mod_log_config.c</sourcefile>
@@ -33,19 +33,19 @@ serveur</description>
<summary>
<p>Ce module apporte une grande souplesse dans la journalisation des
- requêtes des clients. Les journaux sont écrits sous un format
- personnalisable, et peuvent être enregistrés directement dans un
- fichier, ou redirigés vers un programme externe. La journalisation
- conditionnelle est supportée, si bien que des requêtes individuelles
- peuvent être incluses ou exclues des journaux en fonction de leur
- caractéristiques.</p>
+ requêtes des clients. Les journaux sont écrits sous un format
+ personnalisable, et peuvent être enregistrés directement dans un
+ fichier, ou redirigés vers un programme externe. La journalisation
+ conditionnelle est supportée, si bien que des requêtes individuelles
+ peuvent être incluses ou exclues des journaux en fonction de leur
+ caractéristiques.</p>
<p>Ce module fournit trois directives : <directive
- module="mod_log_config">TransferLog</directive> crée un fichier
+ module="mod_log_config">TransferLog</directive> crée un fichier
journal, <directive module="mod_log_config">LogFormat</directive>
- définit un format personnalisé, et <directive module="mod_log_config"
- >CustomLog</directive> définit un fichier journal et un format en
- une seule étape. Pour journaliser les requêtes dans plusieurs
+ définit un format personnalisé, et <directive module="mod_log_config"
+ >CustomLog</directive> définit un fichier journal et un format en
+ une seule étape. Pour journaliser les requêtes dans plusieurs
fichiers, vous pouvez utiliser plusieurs fois les directives
<directive>TransferLog</directive> et
<directive>CustomLog</directive> dans chaque serveur.</p>
@@ -53,27 +53,27 @@ serveur</description>
<seealso><a href="../logs.html">Les fichiers journaux
d'Apache</a></seealso>
-<section id="formats"><title>Formats de journaux personnalisés</title>
+<section id="formats"><title>Formats de journaux personnalisés</title>
<p>L'argument format des directives <directive
module="mod_log_config">LogFormat</directive> et <directive
- module="mod_log_config">CustomLog</directive> est une chaîne de
- caractères. Cette chaîne définit le format de la journalisation des
- requêtes dans le fichier journal. Elle peut contenir des caractères
- littéraux qui seront reproduits dans le fichier journal, et les
- caractères de contrôle de style C "\n" et "\t" représentant
+ module="mod_log_config">CustomLog</directive> est une chaîne de
+ caractères. Cette chaîne définit le format de la journalisation des
+ requêtes dans le fichier journal. Elle peut contenir des caractères
+ littéraux qui seront reproduits dans le fichier journal, et les
+ caractères de contrôle de style C "\n" et "\t" représentant
respectivement une nouvelle ligne et une tabulation. Les guillemets
- et les anti-slashes littéraux doivent être échappés à l'aide
+ et les anti-slashes littéraux doivent être échappés à l'aide
d'anti-slashes.</p>
- <p>Les caractéristiques de la requête en elle-même sont journalisées
- en insérant des directives "<code>%</code>" dans la chaîne de
- format, celles-ci étant remplacées dans le fichier journal par
+ <p>Les caractéristiques de la requête en elle-même sont journalisées
+ en insérant des directives "<code>%</code>" dans la chaîne de
+ format, celles-ci étant remplacées dans le fichier journal par
certaines valeurs comme suit :</p>
<table border="1" style="zebra">
<columnspec><column width=".2"/><column width=".8"/></columnspec>
- <tr><th>Chaîne de format</th>
+ <tr><th>Chaîne de format</th>
<th>Description</th></tr>
<tr><td><code>%%</code></td>
@@ -91,21 +91,21 @@ d'Apache</a></seealso>
<td>L'adresse IP locale</td></tr>
<tr><td><code>%B</code></td>
- <td>La taille de la réponse en octets, en excluant les en-têtes
+ <td>La taille de la réponse en octets, en excluant les en-têtes
HTTP.</td></tr>
<tr><td><code>%b</code></td>
- <td>La taille de la réponse en octets, en excluant les en-têtes
- HTTP. Au format CLF , c'est à dire un '<code>-</code>' à la
- place d'un 0 lorsqu'aucun octet n'est renvoyé.</td></tr>
+ <td>La taille de la réponse en octets, en excluant les en-têtes
+ HTTP. Au format CLF , c'est à dire un '<code>-</code>' à la
+ place d'un 0 lorsqu'aucun octet n'est renvoyé.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}C</code></td>
- <td>Le contenu du cookie <var>NOMVAR</var> dans la requête
- envoyée au serveur. Seuls les cookies version 0 sont pleinement
- supportés.</td></tr>
+ <td>Le contenu du cookie <var>NOMVAR</var> dans la requête
+ envoyée au serveur. Seuls les cookies version 0 sont pleinement
+ supportés.</td></tr>
<tr><td><code>%D</code></td>
- <td>Le temps mis à servir la requête, en
+ <td>Le temps mis à servir la requête, en
microsecondes.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}e</code></td>
@@ -117,110 +117,110 @@ d'Apache</a></seealso>
<tr><td><code>%h</code></td>
<td>Serveur distant. Contiendra l'adresse IP si la directive
- <directive module="core">HostnameLookups</directive> est définie
- à <code>Off</code>, ce qui est sa valeur par défaut. Si cette
- adresse IP n'est enregistrée que pour certains serveurs, vous
- avez probablement défini des directives de contrôle d'accès qui
+ <directive module="core">HostnameLookups</directive> est définie
+ à <code>Off</code>, ce qui est sa valeur par défaut. Si cette
+ adresse IP n'est enregistrée que pour certains serveurs, vous
+ avez probablement défini des directives de contrôle d'accès qui
mentionnent ces derniers par leurs noms. Voir la <a
href="mod_authz_host.html#reqhost">documentation de Require
host</a>.</td></tr>
<tr><td><code>%H</code></td>
- <td>Le protocole de la requête</td></tr>
+ <td>Le protocole de la requête</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}i</code></td>
- <td>Le contenu des lignes d'en-tête
- <code><var>NOMVAR</var>:</code> dans la requête envoyée au
- serveur. Ces en-têtes sont ajoutés par d'autres modules (par
- exemple <module>mod_headers</module>). Si vous êtes intéressé
- par ce qu'était l'en-tête de la requête avant d'être modifié
+ <td>Le contenu des lignes d'en-tête
+ <code><var>NOMVAR</var>:</code> dans la requête envoyée au
+ serveur. Ces en-têtes sont ajoutés par d'autres modules (par
+ exemple <module>mod_headers</module>). Si vous êtes intéressé
+ par ce qu'était l'en-tête de la requête avant d'être modifié
par la plupart des modules, utilisez
- <module>mod_setenvif</module> pour copier l'en-tête dans une
+ <module>mod_setenvif</module> pour copier l'en-tête dans une
variable d'environnement interne et journaliser sa valeur via
- le champ <code>%{<var>VARNAME</var>}e</code> décrit plus haut.
+ le champ <code>%{<var>VARNAME</var>}e</code> décrit plus haut.
</td></tr>
<tr><td><code>%k</code></td>
- <td>Nombre de requêtes persistantes en cours pour cette
+ <td>Nombre de requêtes persistantes en cours pour cette
connexion. Interessant si la directive <directive
- module="core">KeepAlive</directive> est utilisée ; par exemple,
- '1' signifie la première requête après la requête initiale, '2'
+ module="core">KeepAlive</directive> est utilisée ; par exemple,
+ '1' signifie la première requête après la requête initiale, '2'
la seconde, etc... ; autrement, il s'agit toujours de 0
- (indiquant la requête initiale).</td></tr>
+ (indiquant la requête initiale).</td></tr>
<tr><td><code>%l</code></td>
<td>Le nom de connexion distant (en provenance d'identd, si
disponible). Affiche un tiret, sauf si
- <module>mod_ident</module> est présent et si <directive
- module="mod_ident">IdentityCheck</directive> est Ã
+ <module>mod_ident</module> est présent et si <directive
+ module="mod_ident">IdentityCheck</directive> est à
<code>On</code>.</td></tr>
<tr><td><code>%L</code></td>
- <td>L'identifiant du message de journalisation de la requête
+ <td>L'identifiant du message de journalisation de la requête
dans le journal des erreurs (ou '-' si aucun message n'a
- été enregistré dans le journal des erreurs pour cette requête)</td></tr>
+ été enregistré dans le journal des erreurs pour cette requête)</td></tr>
<tr><td><code>%m</code></td>
- <td>La méthode de la requête</td></tr>
+ <td>La méthode de la requête</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}n</code></td>
<td>Le contenu de la note <var>NOMVAR</var> en provenance d'un
autre module.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}o</code></td>
- <td>Le contenu de la ligne d'en-tête
- <code><var>NOMVAR</var>:</code> de la réponse.</td></tr>
+ <td>Le contenu de la ligne d'en-tête
+ <code><var>NOMVAR</var>:</code> de la réponse.</td></tr>
<tr><td><code>%p</code></td>
- <td>Le port canonique du serveur servant la requête</td></tr>
+ <td>Le port canonique du serveur servant la requête</td></tr>
<tr><td><code>%{<var>format</var>}p</code></td>
- <td>Le port canonique du serveur servant la requête ou le
- véritable port du serveur ou le véritable port du client. les
+ <td>Le port canonique du serveur servant la requête ou le
+ véritable port du serveur ou le véritable port du client. les
formats valides sont <code>canonical</code>, <code>local</code>,
ou <code>remote</code>.
</td></tr>
<tr><td><code>%P</code></td>
- <td>Le numéro de processus du processus enfant qui a servi la
- requête.</td></tr>
+ <td>Le numéro de processus du processus enfant qui a servi la
+ requête.</td></tr>
<tr><td><code>%{<var>format</var>}P</code></td>
- <td>Le numéro de processus ou le numéro de thread du processus
- enfant qui a servi la requête. Les formats valides sont
+ <td>Le numéro de processus ou le numéro de thread du processus
+ enfant qui a servi la requête. Les formats valides sont
<code>pid</code>, <code>tid</code>, et <code>hextid</code>.
- <code>hextid</code> nécessite APR version 1.2.0 ou supérieure.
+ <code>hextid</code> nécessite APR version 1.2.0 ou supérieure.
</td></tr>
<tr><td><code>%q</code></td>
- <td>La chaîne d'arguments (préfixée par un <code>?</code> si une
- chaîne d'arguments existe, sinon une chaîne vide)</td></tr>
+ <td>La chaîne d'arguments (préfixée par un <code>?</code> si une
+ chaîne d'arguments existe, sinon une chaîne vide)</td></tr>
<tr><td><code>%r</code></td>
- <td>La première ligne de la requête</td></tr>
+ <td>La première ligne de la requête</td></tr>
<tr><td><code>%R</code></td>
- <td>Le gestionnaire qui génère la réponse (s'il y en a un).</td></tr>
+ <td>Le gestionnaire qui génère la réponse (s'il y en a un).</td></tr>
<tr><td><code>%s</code></td>
- <td>Statut. Pour les requêtes redirigées en interne, il s'agit
- du statut de la requête *originale* --- <code>%>s</code> pour
- la dernière.</td></tr>
+ <td>Statut. Pour les requêtes redirigées en interne, il s'agit
+ du statut de la requête *originale* --- <code>%>s</code> pour
+ la dernière.</td></tr>
<tr><td><code>%t</code></td>
- <td>Date à laquelle la requête a été reçue (au format anglais
+ <td>Date à laquelle la requête a été reçue (au format anglais
standard)</td></tr>
<tr><td><code>%{<var>format</var>}t</code></td>
- <td>La date, sous la forme spécifiée par format, qui devrait
- être au format étendu <code>strftime(3)</code> (éventuellement
- localisé). Si le format commence par <code>begin:</code> (valeur
- par défaut), la date est extraite au début du traitement de la
- requête ; s'il commence par <code>end:</code>, la date
- correspond au moment où l'entrée du journal est inscrite, par
- conséquent vers la fin du traitement de la requête. Hormis les
- formats supportés par <code>strftime(3)</code>, les formats
+ <td>La date, sous la forme spécifiée par format, qui devrait
+ être au format étendu <code>strftime(3)</code> (éventuellement
+ localisé). Si le format commence par <code>begin:</code> (valeur
+ par défaut), la date est extraite au début du traitement de la
+ requête ; s'il commence par <code>end:</code>, la date
+ correspond au moment où l'entrée du journal est inscrite, par
+ conséquent vers la fin du traitement de la requête. Hormis les
+ formats supportés par <code>strftime(3)</code>, les formats
suivants sont aussi disponibles :
<table>
<tr><td><code>sec</code></td><td>nombre de secondes depuis Epoch</td></tr>
@@ -229,125 +229,132 @@ d'Apache</a></seealso>
<tr><td><code>msec_frac</code></td><td>fraction de milliseconde</td></tr>
<tr><td><code>usec_frac</code></td><td>fraction de microseconde</td></tr>
</table>
- Ces symboles ne peuvent pas être combinés entre eux ou avec un
- formatage <code>strftime(3)</code> dans la même chaîne de
+ Ces symboles ne peuvent pas être combinés entre eux ou avec un
+ formatage <code>strftime(3)</code> dans la même chaîne de
format. Par contre, vous pouvez utiliser plusieurs symboles
<code>%{<var>format</var>}t</code>.</td></tr>
<tr><td><code>%T</code></td>
- <td>Le temps mis pour servir la requête, en secondes.</td></tr>
+ <td>Le temps mis pour servir la requête, en secondes.</td></tr>
<tr><td><code>%u</code></td>
- <td>L'utilisateur distant (en provenance d'auth ; peut être faux
+ <td>L'utilisateur distant (en provenance d'auth ; peut être faux
si le statut de retour (<code>%s</code>) est 401).</td></tr>
<tr><td><code>%U</code></td>
- <td>Le chemin de la requête, à l'exclusion de toute chaîne
+ <td>Le chemin de la requête, à l'exclusion de toute chaîne
d'arguments.</td></tr>
<tr><td><code>%v</code></td>
- <td>Le nom canonique du serveur qui a servi la requête, défini
+ <td>Le nom canonique du serveur qui a servi la requête, défini
par la directive <directive
module="core">ServerName</directive>.</td></tr>
<tr><td><code>%V</code></td>
- <td>La nom du serveur en tenant compte de la définition de la
+ <td>La nom du serveur en tenant compte de la définition de la
directive <directive module="core"
>UseCanonicalName</directive>.</td></tr>
<tr><td><code>%X</code></td>
- <td>Statut de la connexion lorsque la réponse a été renvoyée
+ <td>Statut de la connexion lorsque la réponse a été renvoyée
:
<table>
<columnspec><column width=".2"/><column width=".6"/></columnspec>
<tr><td><code>X</code> =</td>
- <td>connexion abandonnée avant l'envoi de la réponse.</td></tr>
+ <td>connexion abandonnée avant l'envoi de la réponse.</td></tr>
<tr><td><code>+</code> =</td>
- <td>la connexion peut rester ouverte après l'envoi de la
- réponse.</td></tr>
+ <td>la connexion peut rester ouverte après l'envoi de la
+ réponse.</td></tr>
<tr><td><code>-</code> = </td>
- <td>la connexion sera fermée après l'envoi de la
- réponse.</td></tr>
+ <td>la connexion sera fermée après l'envoi de la
+ réponse.</td></tr>
</table>
</td></tr>
<tr><td><code>%I</code></td>
- <td>Le nombre d'octets reçus, en comptant la requête et les
- en-têtes, ne peut être nul. Nécessite l'activation de
+ <td>Le nombre d'octets reçus, en comptant la requête et les
+ en-têtes, ne peut être nul. Nécessite l'activation de
<module>mod_logio</module>.</td></tr>
<tr><td><code>%O</code></td>
- <td>Nombre d'octets envoyés, y compris les en-têtes, ne peut
- être nul. Nécessite l'activation de
+ <td>Nombre d'octets envoyés, y compris les en-têtes, ne peut
+ être nul. Nécessite l'activation de
<module>mod_logio</module>.</td></tr>
+ <tr><td><code>%S</code></td>
+ <td>Nombre d'octets transmis (en émission et réception), y
+ compris corps et en-têtes de requête. Ce nombre ne peut pas être
+ nul, et il correspond à la combinaison des formats %I et %O.
+ <module>mod_logio</module> doit être chargé pour pouvoir
+ utiliser ce format.</td></tr>
+
</table>
<section id="modifiers"><title>Modificateurs</title>
<p>Il est possible de restreindre l'enregistrement de certains
- éléments
- en fonction du code de statut de la réponse, en insérant une liste
- de codes de statut séparés par des virgules immédiatement après le
- caractère "%". Par exemple, <code>"%400,501{User-agent}i"</code>
- n'enregistrera l'en-tête <code>User-agent</code> que dans le cas
+ éléments
+ en fonction du code de statut de la réponse, en insérant une liste
+ de codes de statut séparés par des virgules immédiatement après le
+ caractère "%". Par exemple, <code>"%400,501{User-agent}i"</code>
+ n'enregistrera l'en-tête <code>User-agent</code> que dans le cas
d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la
- chaîne littérale <code>"-"</code> qui sera enregistrée. La liste
- de codes peut être précédée d'un "<code>!</code>" pour inverser la
+ chaîne littérale <code>"-"</code> qui sera enregistrée. La liste
+ de codes peut être précédée d'un "<code>!</code>" pour inverser la
condition : <code>"%!200,304,302{Referer}i"</code> enregistre
- l'en-tête <code>Referer</code> pour toutes les requêtes qui
- <em>ne</em> renvoient <em>pas</em> un des trois codes spécifiés.</p>
+ l'en-tête <code>Referer</code> pour toutes les requêtes qui
+ <em>ne</em> renvoient <em>pas</em> un des trois codes spécifiés.</p>
- <p>Les modificateurs "<" et ">" peuvent être utilisés pour
- les requêtes qui ont été redirigées en interne afin de choisir si
- c'est respectivement la requête originale ou finale qui doit être
- consultée. Par défaut, les directives <code>%s, %U, %T, %D,</code>
- et <code>%r</code> consultent la requête originale, alors que
- toutes les autres consultent la requête finale. Ainsi, par
+ <p>Les modificateurs "<" et ">" peuvent être utilisés pour
+ les requêtes qui ont été redirigées en interne afin de choisir si
+ c'est respectivement la requête originale ou finale qui doit être
+ consultée. Par défaut, les directives <code>%s, %U, %T, %D,</code>
+ et <code>%r</code> consultent la requête originale, alors que
+ toutes les autres consultent la requête finale. Ainsi, par
exemple, on peut utiliser <code>%>s</code> pour enregistrer le
- statut final de la requête, et <code>%<u</code> pour
- enregistrer l'utilisateur authentifié à l'origine pour une requête
- redirigée en interne vers une ressource sans authentification.</p>
+ statut final de la requête, et <code>%<u</code> pour
+ enregistrer l'utilisateur authentifié à l'origine pour une requête
+ redirigée en interne vers une ressource sans authentification.</p>
</section>
<section id="format-notes"><title>Quelques Notes</title>
- <p>Pour des raisons de sécurité, à partir de la version 2.0.46,
- les caractères non imprimables et autres caractères spéciaux dans
+ <p>Pour des raisons de sécurité, à partir de la version 2.0.46,
+ les caractères non imprimables et autres caractères spéciaux dans
les directives <code>%r</code>, <code>%i</code> et <code>%o</code>
- doivent être échappés à l'aide des séquences
+ doivent être échappés à l'aide des séquences
<code>\x<var>hh</var></code>,
- où <var>hh</var> est le code hexadécimal du caractère spécial.
- Comme exceptions à cette règle, les caractères <code>"</code> et
- <code>\</code> doivent être échappés par un anti-slash, et tous
- les "blancs" doivent être écrits selon leur notation de style C
+ où <var>hh</var> est le code hexadécimal du caractère spécial.
+ Comme exceptions à cette règle, les caractères <code>"</code> et
+ <code>\</code> doivent être échappés par un anti-slash, et tous
+ les "blancs" doivent être écrits selon leur notation de style C
(<code>\n</code>, <code>\t</code>, etc...). Avant la version
- 2.0.46, aucun échappement n'était effectué sur ces chaînes, et il
- fallait être très prudent lors de l'exploitation des journaux
+ 2.0.46, aucun échappement n'était effectué sur ces chaînes, et il
+ fallait être très prudent lors de l'exploitation des journaux
bruts.</p>
- <p>A la différence de la version 1.3, dans httpd 2.0, les chaînes
- de format <code>%b</code> et <code>%B</code> ne représentent pas
- le nombre d'octets envoyés au client, mais simplement la taille en
- octets de la réponse HTTP (les deux étant différents, par exemple,
- si la connexion est abandonnée, ou si SSL est utilisé). Le format
+ <p>A la différence de la version 1.3, dans httpd 2.0, les chaînes
+ de format <code>%b</code> et <code>%B</code> ne représentent pas
+ le nombre d'octets envoyés au client, mais simplement la taille en
+ octets de la réponse HTTP (les deux étant différents, par exemple,
+ si la connexion est abandonnée, ou si SSL est utilisé). Le format
<code>%O</code> fourni par <module>mod_logio</module>,
- enregistrera le nombre réel d'octets envoyés sur le réseau.</p>
+ enregistrera le nombre réel d'octets envoyés sur le réseau.</p>
- <p>Note : <module>mod_cache</module> est implémenté en tant que
+ <p>Note : <module>mod_cache</module> est implémenté en tant que
gestionnaire basique et non en tant que gestionnaire standard.
- C'est pourquoi la chaîne de format <code>%R</code> ne renverra pas
- d'information à propos du gestionnaire lorsqu'une mise en cache de
+ C'est pourquoi la chaîne de format <code>%R</code> ne renverra pas
+ d'information à propos du gestionnaire lorsqu'une mise en cache de
contenu entre en jeu.</p>
</section>
<section id="examples"><title>Exemples</title>
- <p>Quelques chaînes de format couramment utilisées :</p>
+ <p>Quelques chaînes de format couramment utilisées :</p>
<dl>
<dt>Format de journal courant (CLF)</dt>
@@ -356,12 +363,12 @@ d'Apache</a></seealso>
<dt>Format de journal courant avec un serveur virtuel</dt>
<dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd>
- <dt>Format de journal NCSA étandu/combiné</dt>
+ <dt>Format de journal NCSA étandu/combiné</dt>
<dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\""</code></dd>
<dt>Format de journal de la page qui contient le lien vers la
- page concernée (Referer)</dt>
+ page concernée (Referer)</dt>
<dd><code>"%{Referer}i -> %U"</code></dd>
<dt>Format de journal de l'agent (Navigateur)</dt>
@@ -370,7 +377,7 @@ d'Apache</a></seealso>
<p>Vous pouvez utiliser plusieurs fois la directive
<code>%{format}t</code> pour construire un format de temps
- utilisant les symboles de format étendus tels que
+ utilisant les symboles de format étendus tels que
<code>msec_frac</code> :</p>
<dl>
<dt>Format de temps prenant en compte les milisecondes</dt>
@@ -381,62 +388,62 @@ d'Apache</a></seealso>
</section>
</section>
-<section id="security"><title>Considérations concernant la
-sécurité</title>
+<section id="security"><title>Considérations concernant la
+sécurité</title>
<p>Voir le document <a
- href="../misc/security_tips.html#serverroot">conseils à matière de
- sécurité</a> pour plus de détails sur les raisons pour lesquelles
- votre sécurité pourrait être compromise, si le répertoire où sont
- stockés les fichiers journaux sont inscriptibles par tout autre
- utilisateur que celui qui démarre le serveur.</p>
+ href="../misc/security_tips.html#serverroot">conseils à matière de
+ sécurité</a> pour plus de détails sur les raisons pour lesquelles
+ votre sécurité pourrait être compromise, si le répertoire où sont
+ stockés les fichiers journaux sont inscriptibles par tout autre
+ utilisateur que celui qui démarre le serveur.</p>
</section>
<directivesynopsis>
<name>BufferedLogs</name>
-<description>Enregistre les entrées du journal dans un tampon en mémoire
-avant de les écrire sur disque</description>
+<description>Enregistre les entrées du journal dans un tampon en mémoire
+avant de les écrire sur disque</description>
<syntax>BufferedLogs On|Off</syntax>
<default>BufferedLogs Off</default>
<contextlist><context>server config</context></contextlist>
<usage>
- <p>Lorsque la directive <directive>BufferedLogs</directive> est Ã
- "on", <module>mod_log_config</module> stocke de nombreuses entrées
- du journal en mémoire, et les écrit d'un seul bloc sur disque,
- plutôt que de les écrire après chaque requête. Sur certains
- systèmes, ceci peut améliorer l'efficacité des accès disque, et par
- conséquent les performances. La directive ne peut être définie
- qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas être
- définie au niveau d'un serveur virtuel.</p>
+ <p>Lorsque la directive <directive>BufferedLogs</directive> est à
+ "on", <module>mod_log_config</module> stocke de nombreuses entrées
+ du journal en mémoire, et les écrit d'un seul bloc sur disque,
+ plutôt que de les écrire après chaque requête. Sur certains
+ systèmes, ceci peut améliorer l'efficacité des accès disque, et par
+ conséquent les performances. La directive ne peut être définie
+ qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas être
+ définie au niveau d'un serveur virtuel.</p>
- <note>Cette directive doit être utilisée avec
- précautions car un crash peut provoquer la perte de données de
+ <note>Cette directive doit être utilisée avec
+ précautions car un crash peut provoquer la perte de données de
journalisation.</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CookieLog</name>
-<description>Définit le nom du fichier pour la journalisation des
+<description>Définit le nom du fichier pour la journalisation des
cookies</description>
<syntax>CookieLog <var>nom-fichier</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Cette directive est obsolète.</compatibility>
+<compatibility>Cette directive est obsolète.</compatibility>
<usage>
- <p>La directive <directive>CookieLog</directive> permet de définir
+ <p>La directive <directive>CookieLog</directive> permet de définir
le nom du fichier pour la journalisation des cookies. Le nom du
- fichier est relatif au répertoire défini par la directive <directive
- module="core">ServerRoot</directive>. Cette directive n'est présente
- qu'à des fins de compatibilité avec with <code>mod_cookies</code>,
- et est obsolète.</p>
+ fichier est relatif au répertoire défini par la directive <directive
+ module="core">ServerRoot</directive>. Cette directive n'est présente
+ qu'à des fins de compatibilité avec with <code>mod_cookies</code>,
+ et est obsolète.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CustomLog</name>
-<description>Définit le nom et le format du fichier
+<description>Définit le nom et le format du fichier
journal</description>
<syntax>CustomLog <var>fichier</var>|<var>pipe</var>
<var>format</var>|<var>alias</var>
@@ -446,80 +453,80 @@ expr=<var>expression</var>]</syntax>
</contextlist>
<usage>
- <p>La directive <directive>CustomLog</directive> permet de contrôler
- la journalisation des requêtes destinées au serveur. Un format de
- journal est spécifié, et la journalisation peut s'effectuer de
- manière conditionnelle en fonction des caractéristiques de la
- requête en utilisant des variables d'environnement.</p>
+ <p>La directive <directive>CustomLog</directive> permet de contrôler
+ la journalisation des requêtes destinées au serveur. Un format de
+ journal est spécifié, et la journalisation peut s'effectuer de
+ manière conditionnelle en fonction des caractéristiques de la
+ requête en utilisant des variables d'environnement.</p>
- <p>Le premier argument, qui spécifie l'emplacement où les journaux
- seront écrits, accepte deux types de valeurs :</p>
+ <p>Le premier argument, qui spécifie l'emplacement où les journaux
+ seront écrits, accepte deux types de valeurs :</p>
<dl>
<dt><var>fichier</var></dt>
- <dd>Un nom de fichier, relatif au répertoire défini par la
+ <dd>Un nom de fichier, relatif au répertoire défini par la
directive <directive module="core">ServerRoot</directive>.</dd>
<dt><var>pipe</var></dt>
- <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un
+ <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un
programme qui recevra les informations de la journalisation sur
- son entrée standard. Voir les notes à propos de la <a
- href="../logs.html#piped">journalisation redirigée</a> pour plus
+ son entrée standard. Voir les notes à propos de la <a
+ href="../logs.html#piped">journalisation redirigée</a> pour plus
d'informations.
- <note type="warning"><title>Sécurité :</title>
- <p>Si les journaux sont redirigés vers un programme, ce dernier
- s'exécutera sous l'utilisateur qui a démarré
+ <note type="warning"><title>Sécurité :</title>
+ <p>Si les journaux sont redirigés vers un programme, ce dernier
+ s'exécutera sous l'utilisateur qui a démarré
<program>httpd</program>. Ce sera l'utilisateur root si le serveur
- a été démarré par root ; vérifiez que le programme est
- sécurisé.</p>
+ a été démarré par root ; vérifiez que le programme est
+ sécurisé.</p>
</note>
<note type="warning"><title>Note</title>
- <p>Lors de la spécification d'un chemin de fichier sur les
+ <p>Lors de la spécification d'un chemin de fichier sur les
plate-formes non-Unix, il faut prendre soin de ne pas oublier
- que seuls les slashes directs doivent être utilisés, même si la
- plate-forme autorise l'emploi d'anti-slashes. D'une manière
- générale, c'est une bonne idée que de n'utiliser que des slashes
+ que seuls les slashes directs doivent être utilisés, même si la
+ plate-forme autorise l'emploi d'anti-slashes. D'une manière
+ générale, c'est une bonne idée que de n'utiliser que des slashes
directs dans les fichiers de configuration.</p>
</note></dd>
</dl>
- <p>Le second argument permet de définir ce qui va être écrit dans le
- fichier journal. Il peut contenir soit un <var>alias</var> prédéfini
+ <p>Le second argument permet de définir ce qui va être écrit dans le
+ fichier journal. Il peut contenir soit un <var>alias</var> prédéfini
par une directive <directive
- module="mod_log_config">LogFormat</directive>, soit une chaîne de
- <var>format</var> explicite comme décrit dans la section <a
+ module="mod_log_config">LogFormat</directive>, soit une chaîne de
+ <var>format</var> explicite comme décrit dans la section <a
href="#formats">formats de journaux</a>.</p>
<p>Par exemple, les deux blocs de directives suivants produisent le
- même effet :</p>
+ même effet :</p>
<highlight language="config">
-# Journal personnalisé avec alias de format
+# Journal personnalisé avec alias de format
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
-# Journal personnalisé avec chaîne de format explicite
+# Journal personnalisé avec chaîne de format explicite
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
</highlight>
- <p>Le troisième argument est optionnel et permet de contrôler si une
- requête doit être ou non journalisée. Dans le cas d'une clause
- '<code>env=!<var>nom</var></code>', la condition peut être la
- présence ou l'absence d'une variable particulière dans
+ <p>Le troisième argument est optionnel et permet de contrôler si une
+ requête doit être ou non journalisée. Dans le cas d'une clause
+ '<code>env=!<var>nom</var></code>', la condition peut être la
+ présence ou l'absence d'une variable particulière dans
l'<a href="../env.html">environnement du serveur</a>. Dans le cas
d'une clause 'expr=<var>expression</var>', la condition consiste
- en une <a href="../expr.html">expression</a> booléenne
- quelconque. Si la condition n'est pas vérifiée, la requête ne sera
- pas journalisée. 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>
+ en une <a href="../expr.html">expression</a> booléenne
+ quelconque. Si la condition n'est pas vérifiée, la requête ne sera
+ pas journalisée. 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>
- <p>Les variables d'environnement peuvent être définies au niveau de
- chaque requête en utilisant les modules
+ <p>Les variables d'environnement peuvent être définies au niveau de
+ chaque requête en utilisant les modules
<module>mod_setenvif</module> et/ou <module>mod_rewrite</module>.
- Par exemple, si vous voulez enregistrer les requêtes pour toutes les
- images GIF sur votre serveur dans un fichier journal séparé, et pas
+ Par exemple, si vous voulez enregistrer les requêtes pour toutes les
+ images GIF sur votre serveur dans un fichier journal séparé, et pas
dans votre journal principal, vous pouvez utiliser :</p>
<highlight language="config">
@@ -540,7 +547,7 @@ CustomLog referer.log referer env=!local
<directivesynopsis>
<name>LogFormat</name>
-<description>Décrit un format utilisable dans un fichier
+<description>Décrit un format utilisable dans un fichier
journal</description>
<syntax>LogFormat <var>format</var>|<var>alias</var>
[<var>alias</var>]</syntax>
@@ -549,36 +556,36 @@ journal</description>
</contextlist>
<usage>
- <p>Cette directive permet de spécifier le format du fichier journal
- des accès.</p>
+ <p>Cette directive permet de spécifier le format du fichier journal
+ des accès.</p>
- <p>La directive <directive>LogFormat</directive> se présente sous
- deux formes. Sous la première forme, qui ne possède qu'un seul
- argument, la directive définit le format qui sera utilisé dans les
- journaux spécifiés par les directives
- <directive>TransferLog</directive> ultérieures. L'argument unique
- peut contenir un <var>format</var> explicite comme décrit dans la
- section <a href="#formats">formats de journaux personnalisés</a>
+ <p>La directive <directive>LogFormat</directive> se présente sous
+ deux formes. Sous la première forme, qui ne possède qu'un seul
+ argument, la directive définit le format qui sera utilisé dans les
+ journaux spécifiés par les directives
+ <directive>TransferLog</directive> ultérieures. L'argument unique
+ peut contenir un <var>format</var> explicite comme décrit dans la
+ section <a href="#formats">formats de journaux personnalisés</a>
ci-dessus. Il peut aussi contenir un <var>alias</var> faisant
- référence à un format de journal prédéfini par une directive
- <directive>LogFormat</directive> comme décrit plus loin.</p>
+ référence à un format de journal prédéfini par une directive
+ <directive>LogFormat</directive> comme décrit plus loin.</p>
<p>Sous sa seconde forme, la directive
<directive>LogFormat</directive> associe un <var>format</var>
- explicite à un <var>alias</var>. Cet <var>alias</var> peut
+ explicite à un <var>alias</var>. Cet <var>alias</var> peut
ensuite s'utiliser dans les directives
<directive>LogFormat</directive> ou <directive
- module="mod_log_config">CustomLog</directive> ultérieures, ce qui
- évite d'avoir à répéter l'ensemble de la chaîne de format. Une
- directive <directive>LogFormat</directive> qui définit un alias
- <strong>ne fait rien d'autre</strong> -- c'est à dire qu'<em>elle ne
- fait que</em> définir l'alias, elle n'applique pas le format et n'en
- fait pas le format par défaut. Par conséquent, elle n'affecte pas
+ module="mod_log_config">CustomLog</directive> ultérieures, ce qui
+ évite d'avoir à répéter l'ensemble de la chaîne de format. Une
+ directive <directive>LogFormat</directive> qui définit un alias
+ <strong>ne fait rien d'autre</strong> -- c'est à dire qu'<em>elle ne
+ fait que</em> définir l'alias, elle n'applique pas le format et n'en
+ fait pas le format par défaut. Par conséquent, elle n'affecte pas
les directives <directive
- module="mod_log_config">TransferLog</directive> ultérieures. En
+ module="mod_log_config">TransferLog</directive> ultérieures. En
outre, la directive <directive>LogFormat</directive> ne peut pas
- utiliser un alias pour en définir un autre. Notez que l'alias ne
- doit pas contenir de caractère pourcent (<code>%</code>).</p>
+ utiliser un alias pour en définir un autre. Notez que l'alias ne
+ doit pas contenir de caractère pourcent (<code>%</code>).</p>
<example><title>Exemple</title>
<highlight language="config">
@@ -591,21 +598,21 @@ journal</description>
<directivesynopsis>
<name>TransferLog</name>
-<description>Spécifie l'emplacement d'un fichier journal</description>
+<description>Spécifie l'emplacement d'un fichier journal</description>
<syntax>TransferLog <var>fichier</var>|<var>pipe</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive possède exactement les mêmes arguments et produit
- les mêmes effets que la directive <directive
- module="mod_log_config">CustomLog</directive>, Ã l'exception qu'elle
- ne permet pas de spécifier un format de journal explicite ou la
- journalisation conditionnelle des requêtes. En l'occurrence, le
- format de journal est déterminé par la dernière définition d'une
+ <p>Cette directive possède exactement les mêmes arguments et produit
+ les mêmes effets que la directive <directive
+ module="mod_log_config">CustomLog</directive>, à l'exception qu'elle
+ ne permet pas de spécifier un format de journal explicite ou la
+ journalisation conditionnelle des requêtes. En l'occurrence, le
+ format de journal est déterminé par la dernière définition d'une
directive <directive module="mod_log_config">LogFormat</directive>
- qui ne définit pas d'alias. Si aucun format particulier n'a été
- spécifié, c'est le Common Log Format qui sera utilisé.</p>
+ qui ne définit pas d'alias. Si aucun format particulier n'a été
+ spécifié, c'est le Common Log Format qui sera utilisé.</p>
<example><title>Exemple</title>
<highlight language="config">
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_logio.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_logio.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_logio.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_logio.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 630289:1523269 (outdated) -->
+<!-- English Revision : 1523269 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -69,13 +69,18 @@ d'Apache</a></seealso>
<tr><th>Chaîne de Format</th>
<th>Description</th></tr>
- <tr><td><code>%...I</code></td>
+ <tr><td><code>%I</code></td>
<td>Octets reçus, en-têtes et corps de requête inclus ; ne peut
pas être nul.</td></tr>
- <tr><td><code>%...O</code></td>
+ <tr><td><code>%O</code></td>
<td>Octets envoyés, en-têtes inclus ; ne peut
pas être nul.</td></tr>
+
+ <tr><td><code>%S</code></td>
+ <td>Nombre d'octets transmis (en émission et réception), y
+ compris corps et en-têtes de requête. Ce nombre ne peut pas être
+ nul, et il correspond à la combinaison des formats %I et %O.</td></tr>
</table>
<p>En général, cette fonctionnalité s'utilise comme suit :</p>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1498182:1523974 (outdated) -->
+<!-- English Revision : 1523974 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -289,10 +289,12 @@ ou la définition de types MIME :
</tr>
<tr>
<td>Journalisation</td>
- <td>aucune</td>
+ <td><directive module="mod_lua">LuaHookLog</directive></td>
<td>Lorsqu'une requête a été traitée, plusieurs phases de
journalisation interviennent, et enregistrent leurs résultats
- dans les fichiers d'erreur ou d'accès.</td>
+ dans les fichiers d'erreur ou d'accès. Mod_lua peut
+ s'intercaler au départ de ce processus et ainsi contrôler la
+ journalisation.</td>
</tr>
</table>
@@ -1037,7 +1039,7 @@ r:rmdir(dir) -- Supprime un réper
</highlight>
<highlight language="lua">
-r:touch([mtime]) -- Définit la date de modification d'un fichier à la date courante ou à la valeur optionnelle mtime en msec.
+r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à la valeur optionnelle mtime en msec.
</highlight>
<highlight language="lua">
@@ -1061,6 +1063,48 @@ end
r.date_parse_rfc(string) -- Interprète une chaîne date/heure et renvoie l'équivalent en secondes depuis epoche.
</highlight>
+<highlight language="lua">
+r:getcookie(key) -- Obtient un cookie HTTP
+</highlight>
+
+<highlight language="lua">
+r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple :
+r:setcookie("foo", "bar and stuff", false, os.time() + 86400)
+</highlight>
+
+<highlight language="lua">
+r:wsupgrade() -- Met à jour une connexion vers les WebSockets si possible (et si demandé) :
+if r:wsupgrade() then -- si la mise à jour est possible :
+ r:wswrite("Bienvenue dans les websockets!") -- écrit quelque chose à l'intention du client
+ r:wsclose() -- Au revoir !
+end
+</highlight>
+
+<highlight language="lua">
+r:wsread() -- Lit un cadre de websocket depuis une connexion vers websocket mise à jour (voir ci-dessus) :
+
+local line, isFinal = r:wsread() -- isFinal indique s'il s'agit du cadre final.
+ -- dans le cas contraire, on peut lire les cadres suivants
+r:wswrite("Vous avez écrit : " .. line)
+</highlight>
+
+<highlight language="lua">
+r:wswrite(line) -- écrit un cadre vers un client WebSocket :
+r:wswrite("Bonjour le Monde !")
+</highlight>
+
+<highlight language="lua">
+r:wsclose() -- ferme une requête WebSocket et l'achève pour httpd :
+
+if r:wsupgrade() then
+ r:wswrite("Ecrire quelque chose : ")
+ local line = r:wsread() or "nothing"
+ r:wswrite("Vous avez écrit : " .. line);
+ r:wswrite("Au revoir !")
+ r:wsclose()
+end
+</highlight>
+
</section>
<section id="logging"><title>Fonctions de journalisation</title>
@@ -1590,6 +1634,61 @@ traitement de la requête</descript
</directivesynopsis>
<directivesynopsis>
+<name>LuaHookLog</name>
+<description>Permet une insertion dans la phase de journalisation du
+traitement d'une requête</description>
+<syntax>LuaHookLog /path/to/lua/script.lua log_function_name</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>All</override>
+<usage>
+<p>
+ Ce dispositif d'insertion simple permet d'exécuter une fonction
+ lorsque httpd entre dans la phase de journalisation du traitement
+ d'une requête. Vous pouvez ainsi ajouter des données à vos propres
+ entrées de journalisation, manipuler les entrées du journal standard
+ avant leur enregistrement ou empêcher l'enregistrement d'une entrée
+ dans le journal. Pour empêcher l'enregistrement normal des entrées
+ du journal, renvoyez simplement <code>apache2.DONE</code> dans votre
+ gestionnaire de journalisation, ou au contraire, renvoyez
+ <code>apache2.OK</code> pour que httpd effectue une journalisation
+ normale.
+</p>
+<p>Exemple :</p>
+<highlight language="config">
+LuaHookLog /path/to/script.lua logger
+</highlight>
+<highlight language="lua">
+-- /path/to/script.lua --
+function logger(r)
+ -- on joue à pile ou face :
+ -- Si on obtient 1, on écrit dans notre propre journal Lua et on dit
+ -- à httpd de ne pas enregistrer d'entrée dans le journal standard..
+ -- Si on obtient 2, on nettoie un peu les données avant que httpd ne
+ -- les enregistre dans le journal standard.
+
+ if math.random(1,2) == 1 then
+ -- On effectue notre propre journalisation et le journal
+ -- standard n'est pas alimenté
+ local f = io.open("/foo/secret.log", "a")
+ if f then
+ f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n")
+ f:close()
+ end
+ return apache2.DONE -- On dit à httpd de ne rien enregistrer
+ --dans le journal standard
+ else
+ r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données
+ return apache2.OK -- et httpd doit alors les enregistrer.
+ end
+end
+</highlight>
+</usage>
+</directivesynopsis>
+
+
+<directivesynopsis>
<name>LuaHookMapToStorage</name>
<description>Fournit un point d'entrée pour la phase map_to_storage du
traitement de la requête</description>
@@ -1845,6 +1944,134 @@ end
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>LuaInputFilter</name>
+<description>Fournit une fonction Lua pour le filtrage en entrée</description>
+<syntax>LuaInputFilter filter_name /path/to/lua/script.lua function_name</syntax>
+<contextlist><context>server config</context> </contextlist>
+<compatibility>Disponible depuis la version 2.5.0 du serveur HTTP
+Apache</compatibility>
+
+<usage>
+<p>Cette directive permet d'ajouter un filtre en entrée sous la forme
+d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
+entrée fonctionnent comme des sous-routines, intervenant dans un premier
+temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
+paquet de données doit être transmis à la chaîne, et éventuellement
+produisant toute donnée à ajouter aux données en entrée. La variable
+globale <code>bucket</code> contient les paquets de données tels qu'ils
+sont transmis au script Lua :
+</p>
+
+<highlight language="config">
+LuaInputFilter myInputFilter /www/filter.lua input_filter
+<FilesMatch "\.lua>
+ SetInputFilter myInputFilter
+</FilesMatch>
+</highlight>
+<highlight language="lua">
+--[[
+ Exemple de filtre en entrée qui convertit toutes les données POST en
+ majuscules.
+]]--
+function input_filter(r)
+ print("luaInputFilter called") -- debug print
+ coroutine.yield() -- Yield and wait for buckets
+ while bucket do -- For each bucket, do...
+ local output = string.upper(bucket) -- Convertit toutes les données POST en majuscules
+ coroutine.yield(output) -- Envoie les données traitées à la chaîne
+ end
+ -- plus aucune donnée à traiter.
+ coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin
+end
+</highlight>
+<p>
+Le filtre en entrée peut interdire ou sauter un filtre s'il est
+considéré comme indésirable :
+</p>
+<highlight language="lua">
+function input_filter(r)
+ if not good then
+ return -- Empêche tout simplement le filtrage et transmet le contenu original
+ end
+ coroutine.yield() -- attend des paquets de données
+ ... -- insert les filtres ici
+end
+</highlight>
+<p>
+Voir "<a href="#modifying_buckets">Modification de contenu avec les
+filtres Lua</a>" pour plus de détails.
+</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>LuaOutputFilter</name>
+<description>Fournit une fonction Lua pour le filtrage de contenu en
+sortie</description>
+<syntax>LuaOutputFilter filter_name /path/to/lua/script.lua function_name</syntax>
+<contextlist><context>server config</context> </contextlist>
+<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
+Apache</compatibility>
+
+<usage>
+<p>>Cette directive permet d'ajouter un filtre en sortie sous la forme
+d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
+entrée fonctionnent comme des sous-routines, intervenant dans un premier
+temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
+paquet de données doit être transmis à la chaîne, et éventuellement
+produisant toute donnée à ajouter aux données en sortie. La variable
+globale <code>bucket</code> contient les paquets de données tels qu'ils
+sont transmis au script Lua :
+</p>
+
+<highlight language="config">
+LuaOutputFilter myOutputFilter /www/filter.lua output_filter
+<FilesMatch "\.lua>
+ SetOutputFilter myOutputFilter
+</FilesMatch>
+</highlight>
+<highlight language="lua">
+--[[
+ Exemple de filtre en sortie qui échappe toutes les entités HTML en
+ sortie
+]]--
+function output_filter(r)
+ coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie, puis attend des paquets de données à traiter
+ while bucket do -- Pour chaque paquet, faire ...
+ local output = r:escape_html(bucket) -- Echappe les données en sortie
+ coroutine.yield(output) -- Envoie les données traitées à la chaîne
+ end
+ -- plus aucune donnée à traiter.
+end
+</highlight>
+<p>
+Comme les filres en entrée, le filtre en sortie peut interdire ou sauter un filtre s'il est
+considéré comme indésirable :
+</p>
+<highlight language="lua">
+function output_filter(r)
+ if not r.content_type:match("text/html") then
+ return -- Empêche tout simplement le filtrage et transmet le contenu original
+ end
+ coroutine.yield() -- attend des paquets de données
+ ... -- insert les filtres ici
+end
+</highlight>
+<note><title>Les filtres Lua avec <module>mod_filter</module></title>
+<p>Lorsqu'on utilise un filtre Lua comme fournisseur sous-jacent via la
+directive <directive module="mod_filter">FilterProvider</directive>, le
+filtrage ne fonctionnera que si <var>filter-name</var> est identique à
+<var>provider-name</var>.
+</p> </note>
+
+<p>
+Voir "<a href="#modifying_buckets">Modification de contenu avec les
+filtres Lua</a>" pour plus de détails.
+</p>
+
+</usage>
+</directivesynopsis>
</modulesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_macro.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_macro.xml.fr?rev=1525240&r1=1525239&r2=1525240&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_macro.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_macro.xml.fr Sat Sep 21 14:23:50 2013
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1516274:1524241 (outdated) -->
+<!-- English Revision: 1524241 -->
<!-- French translation: Fabien Coelho -->
<!-- Updated by Lucien Gentis -->