You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jo...@apache.org on 2017/01/31 09:52:09 UTC
svn commit: r1781045 [19/50] - in
/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat: ./ build/ docs/man/
docs/manual/ docs/manual/developer/ docs/manual/faq/ docs/manual/howto/
docs/manual/misc/ docs/manual/mod/ docs/manual/platform/
docs/manual/program...
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_lua.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_lua.xml.fr?rev=1781045&r1=1781044&r2=1781045&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_lua.xml.fr [iso-8859-1] (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_lua.xml.fr [utf-8] Tue Jan 31 09:52:02 2017
@@ -1,7 +1,7 @@
<?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: 1741841 -->
+<!-- English Revision: 1780218 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -26,37 +26,37 @@
<name>mod_lua</name>
-<description>Fournit des points d'entrée Lua dans différentes parties du
-traitement des requêtes httpd</description>
+<description>Fournit des points d'entr�e Lua dans diff�rentes parties du
+traitement des requ�tes httpd</description>
<status>Experimental</status>
<sourcefile>mod_lua.c</sourcefile>
<identifier>lua_module</identifier>
-<compatibility>versions 2.3 et supérieures</compatibility>
+<compatibility>versions 2.3 et sup�rieures</compatibility>
<summary>
<p>Ce module permet d'ajouter au serveur des extensions sous forme de
-scripts écrits dans le langage de programmation Lua.
+scripts �crits dans le langage de programmation Lua.
<module>mod_lua</module> fournit de nombreuses extensions
(hooks) disponibles avec les modules natifs du serveur HTTP Apache,
-comme les associations de requêtes à des fichiers, la génération de
-réponses dynamiques, le contrôle d'accès, l'authentification et
+comme les associations de requ�tes � des fichiers, la g�n�ration de
+r�ponses dynamiques, le contr�le d'acc�s, l'authentification et
l'autorisation.</p>
-<p>Vous trouverez davantage d'informations à propos du langage de
+<p>Vous trouverez davantage d'informations � propos du langage de
programmation Lua sur <a href="http://www.lua.org/">le site web de
Lua</a>.</p>
-<note><code>mod_lua</code> est encore au stade expérimental. Son mode
-d'utilisation et son comportement pourront changer à tout moment jusqu'à
-ce qu'il passe au stade stable, et ce même entre deux versions stables
-2.4.x. N'oublez pas de consulter le fichier CHANGES avant toute mise à
+<note><code>mod_lua</code> est encore au stade exp�rimental. Son mode
+d'utilisation et son comportement pourront changer � tout moment jusqu'�
+ce qu'il passe au stade stable, et ce m�me entre deux versions stables
+2.4.x. N'oublez pas de consulter le fichier CHANGES avant toute mise �
jour.</note>
<note type="warning"><title>Avertissement</title>
-<p>Ce module possède une grande capacité d'action sur le fonctrionnement
-de httpd, ce qui lui confère une grande puissance, mais peut aussi
-induire un risque de sécurité. Il est déconseillé d'utiliser ce module
-sur un serveur partagé avec des utilisateurs auxquels vous ne pouvez pas
+<p>Ce module poss�de une grande capacit� d'action sur le fonctrionnement
+de httpd, ce qui lui conf�re une grande puissance, mais peut aussi
+induire un risque de s�curit�. Il est d�conseill� d'utiliser ce module
+sur un serveur partag� avec des utilisateurs auxquels vous ne pouvez pas
accorder une confiance absolue, car il peut permettre de modifier le
fonctionnement interne de httpd.</p>
</note>
@@ -72,8 +72,8 @@ fonctionnement interne de httpd.</p>
</highlight>
<p>
-<code>mod_lua</code> fournit un gestionnaire nommé
-<code>lua-script</code> qui peut être utilisé avec une directive
+<code>mod_lua</code> fournit un gestionnaire nomm�
+<code>lua-script</code> qui peut �tre utilis� avec une directive
<directive module="mod_mime">AddHandler</directive> ou <directive
module="core">SetHandler</directive> :</p>
@@ -84,26 +84,26 @@ module="core">SetHandler</directive> :</
</highlight>
<p>
-Ceci aura pour effet de faire traiter les requêtes pour les fichiers
+Ceci aura pour effet de faire traiter les requ�tes pour les fichiers
dont l'extension est <code>.lua</code> par <code>mod_lua</code> en
invoquant cette fonction de <code>gestion</code> de fichier.
</p>
-<p>Pour plus de détails, voir la directive
+<p>Pour plus de d�tails, voir la directive
<directive>LuaMapHandler</directive>.
</p>
</section>
<section id="writinghandlers"><title>Ecrire des gestionnaires</title>
<p>Dans l'API du serveur HTTP Apache, un gestionnaire est une sorte de
-point d'accroche (hook) spécifique responsable de la génération de la
-réponse. <module>mod_proxy</module>, <module>mod_cgi</module> et
+point d'accroche (hook) sp�cifique responsable de la g�n�ration de la
+r�ponse. <module>mod_proxy</module>, <module>mod_cgi</module> et
<module>mod_status</module> sont des exemples de modules comportant un
gestionnaire.</p>
-<p><code>mod_lua</code> cherche toujours à invoquer une fonction Lua pour le
-gestionnaire, plutôt que de simplement évaluer le corps d'un script dans
-le style de CGI. Une fonction de gestionnaire se présente comme suit :</p>
+<p><code>mod_lua</code> cherche toujours � invoquer une fonction Lua pour le
+gestionnaire, plut�t que de simplement �valuer le corps d'un script dans
+le style de CGI. Une fonction de gestionnaire se pr�sente comme suit :</p>
<highlight language="lua">
@@ -113,9 +113,9 @@ le style de CGI. Une fonction de gestion
require "string"
--[[
- Il s'agit du nom de méthode par défaut pour les gestionnaires Lua ;
+ Il s'agit du nom de m�thode par d�faut pour les gestionnaires Lua ;
voir les noms de fonctions optionnels dans la directive
- LuaMapHandler pour choisir un point d'entrée différent.
+ LuaMapHandler pour choisir un point d'entr�e diff�rent.
--]]
function handle(r)
r.content_type = "text/plain"
@@ -132,7 +132,7 @@ function handle(r)
end
else
elseif r.method == 'PUT' then
--- message d'erreur personnalisé
+-- message d'erreur personnalis�
r:puts("Unsupported HTTP method " .. r.method)
r.status = 405
return apache2.OK
@@ -145,13 +145,13 @@ end
</highlight>
<p>
-Ce gestionnaire se contente d'afficher les arguments codés d'un uri ou
+Ce gestionnaire se contente d'afficher les arguments cod�s d'un uri ou
d'un formulaire dans un page au format texte.
</p>
<p>
-Cela signifie que vous pouvez (et êtes encouragé à) avoir plusieurs
-gestionnaires (ou points d'entrée, ou filtres) dans le même script.
+Cela signifie que vous pouvez (et �tes encourag� �) avoir plusieurs
+gestionnaires (ou points d'entr�e, ou filtres) dans le m�me script.
</p>
</section>
@@ -159,27 +159,27 @@ gestionnaires (ou points d'entrée, ou
<title>Ecriture de fournisseurs d'autorisation</title>
<p><module>mod_authz_core</module> fournit une interface d'autorisation
-de haut niveau bien plus facile à utiliser que dans les hooks
+de haut niveau bien plus facile � utiliser que dans les hooks
correspondants. Le premier argument de la directive <directive
-module="mod_authz_core">Require</directive> permet de spécifier le
-fournisseur d'autorisation à utiliser. Pour chaque directive <directive
+module="mod_authz_core">Require</directive> permet de sp�cifier le
+fournisseur d'autorisation � utiliser. Pour chaque directive <directive
module="mod_authz_core">Require</directive>,
<module>mod_authz_core</module> appellera le fournisseur d'autorisation
-spécifié, le reste de la ligne constituant les paramètres. Le
-fournisseur considéré va alors vérifier les autorisations et fournir le
-résultat dans une valeur de retour.</p>
-
-<p>En général, le fournisseur authz est appelé avant l'authentification.
-S'il doit connaître le nom d'utilisateur authentifié (ou si
-l'utilisateur est appelé à être authentifié), le fournisseur doit
+sp�cifi�, le reste de la ligne constituant les param�tres. Le
+fournisseur consid�r� va alors v�rifier les autorisations et fournir le
+r�sultat dans une valeur de retour.</p>
+
+<p>En g�n�ral, le fournisseur authz est appel� avant l'authentification.
+S'il doit conna�tre le nom d'utilisateur authentifi� (ou si
+l'utilisateur est appel� � �tre authentifi�), le fournisseur doit
renvoyer <code>apache2.AUTHZ_DENIED_NO_USER</code>, ce qui va
-déclancher le processus d'authentification et un deuxième appel du
+d�clancher le processus d'authentification et un deuxi�me appel du
fournisseur authz.</p>
<p>La fonction du fournisseur authz ci-dessous accepte deux arguments,
-une adresse IP et un nom d'utilisateur. Elle autorise l'accès dans le
-cas où la requête provient de l'adresse IP spécifiée, ou si
-l'utilisateur authentifié correspond au second argument :</p>
+une adresse IP et un nom d'utilisateur. Elle autorise l'acc�s dans le
+cas o� la requ�te provient de l'adresse IP sp�cifi�e, ou si
+l'utilisateur authentifi� correspond au second argument :</p>
<highlight language="lua">
<strong>authz_provider.lua</strong><br/>
@@ -213,11 +213,11 @@ LuaAuthzProvider foo authz_provider.lua
<section id="writinghooks"><title>Ecriture de fonctions d'accroche
(hooks)</title>
-<p>Les fonctions d'accroche déterminent la manière dont les modules (et
-les scripts Lua) participent au traitement des requêtes. Chaque type
-d'accroche proposé par le serveur a un rôle spécifique, comme
-l'association de requêtes au système de fichiers, le contrôle d'accès,
-ou la définition de types MIME : </p>
+<p>Les fonctions d'accroche d�terminent la mani�re dont les modules (et
+les scripts Lua) participent au traitement des requ�tes. Chaque type
+d'accroche propos� par le serveur a un r�le sp�cifique, comme
+l'association de requ�tes au syst�me de fichiers, le contr�le d'acc�s,
+ou la d�finition de types MIME : </p>
<table border="1" style="zebra">
<tr>
@@ -228,92 +228,92 @@ ou la définition de types MIME : </p>
<tr>
<td>Gestionnaire rapide</td>
<td><directive module="mod_lua">LuaQuickHandler</directive></td>
- <td>Il s'agit de la première accroche appelée lorsqu'une requête
- a été associée à un serveur ou un serveur virtuel.</td>
+ <td>Il s'agit de la premi�re accroche appel�e lorsqu'une requ�te
+ a �t� associ�e � un serveur ou un serveur virtuel.</td>
</tr>
<tr>
<td>Phase de traduction</td>
<td><directive module="mod_lua">LuaHookTranslateName</directive></td>
- <td>Cette phase traduit l'URI de la requête en nom de fichier
- sur le système. Ce sont des modules comme
+ <td>Cette phase traduit l'URI de la requ�te en nom de fichier
+ sur le syst�me. Ce sont des modules comme
<module>mod_alias</module> et <module>mod_rewrite</module> qui
interviennent au cours de cette phase.</td>
</tr>
<tr>
<td>Choix du lieu de stockage de la ressource</td>
<td><directive module="mod_lua">LuaHookMapToStorage</directive></td>
- <td>Cette phase définit le lieu de stockage de la ressource :
- physique, en cache ou externe/mandaté. Elle est assurée par les
+ <td>Cette phase d�finit le lieu de stockage de la ressource :
+ physique, en cache ou externe/mandat�. Elle est assur�e par les
modules de mandat ou de mise en cache.</td>
</tr>
<tr>
- <td>Autorisation d'accès</td>
+ <td>Autorisation d'acc�s</td>
<td><directive module="mod_lua">LuaHookAccessChecker</directive></td>
- <td>Cette phase vérifie si un client a l'autorisation d'accès à
- la ressource. Elle s'exécute avant l'authentification de
- l'utisateur ; il faut donc être prudent.
+ <td>Cette phase v�rifie si un client a l'autorisation d'acc�s �
+ la ressource. Elle s'ex�cute avant l'authentification de
+ l'utisateur ; il faut donc �tre prudent.
</td>
</tr>
<tr>
- <td>Vérification de l'identifiant utilisateur</td>
+ <td>V�rification de l'identifiant utilisateur</td>
<td><directive module="mod_lua">LuaHookCheckUserID</directive></td>
- <td>Cette phase vérifie l'identifiant de l'utilisateur ayant
- fait l'objet d'une négociation.</td>
+ <td>Cette phase v�rifie l'identifiant de l'utilisateur ayant
+ fait l'objet d'une n�gociation.</td>
</tr>
<tr>
- <td>Vérification de l'autorisation d'accès</td>
+ <td>V�rification de l'autorisation d'acc�s</td>
<td><directive module="mod_lua">LuaHookAuthChecker</directive>
ou
<directive module="mod_lua">LuaAuthzProvider</directive></td>
- <td>Cette phase vérifie l'autorisation d'accès d'un utilisateur
- en fonction des ses paramètres de connexion, comme
+ <td>Cette phase v�rifie l'autorisation d'acc�s d'un utilisateur
+ en fonction des ses param�tres de connexion, comme
l'identifiant, le certificat, etc...
</td>
</tr>
<tr>
- <td>Vérification du type de la ressource</td>
+ <td>V�rification du type de la ressource</td>
<td><directive module="mod_lua">LuaHookTypeChecker</directive></td>
- <td>Cette phase assigne un type de contenu et un gestionnaire à
+ <td>Cette phase assigne un type de contenu et un gestionnaire �
la ressource.</td>
</tr>
<tr>
- <td>Derniers réglages</td>
+ <td>Derniers r�glages</td>
<td><directive module="mod_lua">LuaHookFixups</directive></td>
- <td>C'est la dernière phase avant l'activation des gestionnaires
- de contenu. Toute modification de dernière minute à la requête
- doit être effectuée ici.</td>
+ <td>C'est la derni�re phase avant l'activation des gestionnaires
+ de contenu. Toute modification de derni�re minute � la requ�te
+ doit �tre effectu�e ici.</td>
</tr>
<tr>
<td>Gestionnaire de contenu</td>
<td>fichiers fx. <code>.lua</code> ou directive <directive module="mod_lua">LuaMapHandler</directive></td>
- <td>C'est durant cette phase que le contenu est traité. Les
- fichiers sont lus, interprétés, certains sont exécutés, et le
- résultat obtenu est envoyé au client.</td>
+ <td>C'est durant cette phase que le contenu est trait�. Les
+ fichiers sont lus, interpr�t�s, certains sont ex�cut�s, et le
+ r�sultat obtenu est envoy� au client.</td>
</tr>
<tr>
<td>Journalisation</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. Mod_lua peut
- s'intercaler au départ de ce processus et ainsi contrôler la
+ <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. Mod_lua peut
+ s'intercaler au d�part de ce processus et ainsi contr�ler la
journalisation.</td>
</tr>
</table>
-<p>Les fonctions d'accroche reçoivent l'objet de la requête comme seul
-argument (sauf LuaAuthzProvider qui reçoit aussi des arguments en
+<p>Les fonctions d'accroche re�oivent l'objet de la requ�te comme seul
+argument (sauf LuaAuthzProvider qui re�oit aussi des arguments en
provenance de la directive Require). Elles peuvent renvoyer une valeur,
-selon la fonction, mais il s'agit en général d'un
-code d'état HTTP ou des valeurs OK, DONE, ou DECLINED,
-que vous pouvez écrire dans Lua sous la forme <code>apache2.OK</code>,
+selon la fonction, mais il s'agit en g�n�ral d'un
+code d'�tat HTTP ou des valeurs OK, DONE, ou DECLINED,
+que vous pouvez �crire dans Lua sous la forme <code>apache2.OK</code>,
<code>apache2.DONE</code>, ou <code>apache2.DECLINED</code>.</p>
<highlight language="lua">
<strong>translate_name.lua</strong><br/>
--- exemple d'accroche qui réécrit un URI en chemin du système de fichiers.
+-- exemple d'accroche qui r��crit un URI en chemin du syst�me de fichiers.
require 'apache2'
@@ -322,7 +322,7 @@ function translate_name(r)
r.filename = r.document_root .. "/find_me.txt"
return apache2.OK
end
- -- on ne gère pas cette URL et on donne sa chance à un autre module
+ -- on ne g�re pas cette URL et on donne sa chance � un autre module
return apache2.DECLINED
end
</highlight>
@@ -330,13 +330,13 @@ end
<highlight language="lua">
<strong>translate_name2.lua</strong><br/>
---[[ exemple d'accroche qui réécrit un URI vers un autre URI. Il renvoie
- un apache2.DECLINED pour permettre à un autre interpréteur d'URL de
+--[[ exemple d'accroche qui r��crit un URI vers un autre URI. Il renvoie
+ un apache2.DECLINED pour permettre � un autre interpr�teur d'URL de
travailler sur la substitution, y compris l'accroche translate_name
de base dont les tables de correspondances se basent sur DocumentRoot.
Note: utilisez le drapeau early/late de la directive pour
- l'exécuter avant ou après mod_alias.
+ l'ex�cuter avant ou apr�s mod_alias.
--]]
require 'apache2'
@@ -351,18 +351,18 @@ end
</highlight>
</section>
-<section id="datastructures"><title>Structures de données</title>
+<section id="datastructures"><title>Structures de donn�es</title>
<dl>
<dt>request_rec</dt>
<dd>
- <p>request_rec est considérée en tant que donnée utilisateur.
- Elle possède une métatable qui vous permet d'accomplir des
- choses intéressantes. Pour la plus grande partie, elle possède
- les mêmes champs que la structure request_rec, la
- plupart d'entre eux étant accessibles en lecture et écriture (le
- contenu des champs de la table peut être modifié, mais les
- champs eux-mêmes ne peuvent pas être établis en tant que tables
+ <p>request_rec est consid�r�e en tant que donn�e utilisateur.
+ Elle poss�de une m�tatable qui vous permet d'accomplir des
+ choses int�ressantes. Pour la plus grande partie, elle poss�de
+ les m�mes champs que la structure request_rec, la
+ plupart d'entre eux �tant accessibles en lecture et �criture (le
+ contenu des champs de la table peut �tre modifi�, mais les
+ champs eux-m�mes ne peuvent pas �tre �tablis en tant que tables
distinctes).</p>
<table border="1" style="zebra">
@@ -377,68 +377,68 @@ end
<td><code>allowoverrides</code></td>
<td>string</td>
<td>non</td>
- <td>L'option AllowOverride s'applique à la requête courante.</td>
+ <td>L'option AllowOverride s'applique � la requ�te courante.</td>
</tr>
<tr>
<td><code>ap_auth_type</code></td>
<td>string</td>
<td>non</td>
- <td>Ce champ contient le type d'authentification effectuée
+ <td>Ce champ contient le type d'authentification effectu�e
(par exemple <code>basic</code>)</td>
</tr>
<tr>
<td><code>args</code></td>
<td>string</td>
<td>oui</td>
- <td>La chaîne de paramètres de la requête (par exemple
+ <td>La cha�ne de param�tres de la requ�te (par exemple
<code>foo=bar&name=johnsmith</code>)</td>
</tr>
<tr>
<td><code>assbackwards</code></td>
<td>boolean</td>
<td>non</td>
- <td>contient true s'il s'agit d'une requête de style HTTP/0.9
- (par exemple <code>GET /foo</code> (sans champs d'en-tête) )</td>
+ <td>contient true s'il s'agit d'une requ�te de style HTTP/0.9
+ (par exemple <code>GET /foo</code> (sans champs d'en-t�te) )</td>
</tr>
<tr>
<td><code>auth_name</code></td>
<td>string</td>
<td>non</td>
- <td>La chaîne d'identification utilisée pour la vérification
- de l'autorisation d'accès (si elle est disponible).</td>
+ <td>La cha�ne d'identification utilis�e pour la v�rification
+ de l'autorisation d'acc�s (si elle est disponible).</td>
</tr>
<tr>
<td><code>banner</code></td>
<td>string</td>
<td>non</td>
- <td>La bannière du serveur, par exemple <code>Apache HTTP
+ <td>La banni�re du serveur, par exemple <code>Apache HTTP
Server/2.4.3 openssl/0.9.8c</code></td>
</tr>
<tr>
<td><code>basic_auth_pw</code></td>
<td>string</td>
<td>non</td>
- <td>Le mot de passe pour l'authentification de base envoyé
- avec la requête, s'il existe</td>
+ <td>Le mot de passe pour l'authentification de base envoy�
+ avec la requ�te, s'il existe</td>
</tr>
<tr>
<td><code>canonical_filename</code></td>
<td>string</td>
<td>non</td>
- <td>Le nom de fichier canonique de la requête</td>
+ <td>Le nom de fichier canonique de la requ�te</td>
</tr>
<tr>
<td><code>content_encoding</code></td>
<td>string</td>
<td>non</td>
- <td>Le type de codage du contenu de la requête courante</td>
+ <td>Le type de codage du contenu de la requ�te courante</td>
</tr>
<tr>
<td><code>content_type</code></td>
<td>string</td>
<td>oui</td>
- <td>Le type de contenu de la requête courante, tel qu'il a été
- déterminé au cours de la phase type_check (par exemple
+ <td>Le type de contenu de la requ�te courante, tel qu'il a �t�
+ d�termin� au cours de la phase type_check (par exemple
<code>image/gif</code> ou <code>text/html</code>)</td>
</tr>
@@ -465,33 +465,33 @@ end
<td><code>err_headers_out</code></td>
<td>table</td>
<td>non</td>
- <td>L'en-tête MIME de l'environnement pour la réponse, écrit
- même en cas d'erreur et conservé pendant les redirections
+ <td>L'en-t�te MIME de l'environnement pour la r�ponse, �crit
+ m�me en cas d'erreur et conserv� pendant les redirections
internes</td>
</tr>
<tr>
<td><code>filename</code></td>
<td>string</td>
<td>oui</td>
- <td>Le nom de fichier correspondant à la requête, par exemple
- /www/example.com/foo.txt. Il peut être modifié au cours des
+ <td>Le nom de fichier correspondant � la requ�te, par exemple
+ /www/example.com/foo.txt. Il peut �tre modifi� au cours des
phases translate-name ou map-to-storage du traitement de la
- requête pour permettre au gestionnaire par défaut (ou aux
+ requ�te pour permettre au gestionnaire par d�faut (ou aux
gestionnaires de script) de servir une version du fichier
- autre que celle demandée.</td>
+ autre que celle demand�e.</td>
</tr>
<tr>
<td><code>handler</code></td>
<td>string</td>
<td>oui</td>
<td>Le nom du <a href="../handler.html">gestionnaire</a> qui
- doit traiter la requête, par exemple <code>lua-script</code>
- si elle doit être traitée par mod_lua. Cette valeur est en
- général définie via les directives <directive
+ doit traiter la requ�te, par exemple <code>lua-script</code>
+ si elle doit �tre trait�e par mod_lua. Cette valeur est en
+ g�n�ral d�finie via les directives <directive
module="mod_mime">AddHandler</directive> ou <directive
- module="core">SetHandler</directive>, mais peut aussi l'être
- via mod_lua pour permettre à un autre gestionnaire de traiter
- une requête spécifique qui ne serait pas traitée par défaut
+ module="core">SetHandler</directive>, mais peut aussi l'�tre
+ via mod_lua pour permettre � un autre gestionnaire de traiter
+ une requ�te sp�cifique qui ne serait pas trait�e par d�faut
par ce dernier.
</td>
</tr>
@@ -499,108 +499,108 @@ end
<td><code>headers_in</code></td>
<td>table</td>
<td>oui</td>
- <td>Les en-têtes MIME de l'environnement de la requête. Il
- s'agit des en-têtes comme <code>Host, User-Agent,
+ <td>Les en-t�tes MIME de l'environnement de la requ�te. Il
+ s'agit des en-t�tes comme <code>Host, User-Agent,
Referer</code>, etc...</td>
</tr>
<tr>
<td><code>headers_out</code></td>
<td>table</td>
<td>oui</td>
- <td>Les en-têtes MIME de l'environnement de la réponse.</td>
+ <td>Les en-t�tes MIME de l'environnement de la r�ponse.</td>
</tr>
<tr>
<td><code>hostname</code></td>
<td>string</td>
<td>non</td>
- <td>Le nom d'hôte, tel que défini par l'en-tête
+ <td>Le nom d'h�te, tel que d�fini par l'en-t�te
<code>Host:</code> ou par un URI complet.</td>
</tr>
<tr>
<td><code>is_https</code></td>
<td>boolean</td>
<td>non</td>
- <td>Indique si la requête à été faite via HTTPS</td>
+ <td>Indique si la requ�te � �t� faite via HTTPS</td>
</tr>
<tr>
<td><code>is_initial_req</code></td>
<td>boolean</td>
<td>non</td>
- <td>Indique si la requête courante est la requête initiale ou
- une sous-requête.</td>
+ <td>Indique si la requ�te courante est la requ�te initiale ou
+ une sous-requ�te.</td>
</tr>
<tr>
<td><code>limit_req_body</code></td>
<td>number</td>
<td>non</td>
- <td>La taille maximale du corps de la requête, ou 0 si aucune
+ <td>La taille maximale du corps de la requ�te, ou 0 si aucune
limite.</td>
</tr>
<tr>
<td><code>log_id</code></td>
<td>string</td>
<td>non</td>
- <td>L'identifiant de la requête dans les journaux d'accès ou
+ <td>L'identifiant de la requ�te dans les journaux d'acc�s ou
d'erreur.</td>
</tr>
<tr>
<td><code>method</code></td>
<td>string</td>
<td>non</td>
- <td>La méthode de la requête, par exemple <code>GET</code> ou
+ <td>La m�thode de la requ�te, par exemple <code>GET</code> ou
<code>POST</code>.</td>
</tr>
<tr>
<td><code>notes</code></td>
<td>table</td>
<td>oui</td>
- <td>Une liste de notes qui peuvent être transmises d'un module
- à l'autre.</td>
+ <td>Une liste de notes qui peuvent �tre transmises d'un module
+ � l'autre.</td>
</tr>
<tr>
<td><code>options</code></td>
<td>string</td>
<td>non</td>
- <td>La valeur de la directive Options pour la requête
+ <td>La valeur de la directive Options pour la requ�te
courante.</td>
</tr>
<tr>
<td><code>path_info</code></td>
<td>string</td>
<td>non</td>
- <td>La valeur de PATH_INFO extraite de la requête.</td>
+ <td>La valeur de PATH_INFO extraite de la requ�te.</td>
</tr>
<tr>
<td><code>port</code></td>
<td>number</td>
<td>non</td>
- <td>Le port du serveur utilisé par la requête.</td>
+ <td>Le port du serveur utilis� par la requ�te.</td>
</tr>
<tr>
<td><code>protocol</code></td>
<td>string</td>
<td>non</td>
- <td>Le protocole utilisé, par exemple <code>HTTP/1.1</code></td>
+ <td>Le protocole utilis�, par exemple <code>HTTP/1.1</code></td>
</tr>
<tr>
<td><code>proxyreq</code></td>
<td>string</td>
<td>oui</td>
- <td>Indique s'il s'agit d'une requête mandatée ou non. Cette
- valeur est en général définie au cours de la phase
- post_read_request/translate_name du traitement de la requête.</td>
+ <td>Indique s'il s'agit d'une requ�te mandat�e ou non. Cette
+ valeur est en g�n�ral d�finie au cours de la phase
+ post_read_request/translate_name du traitement de la requ�te.</td>
</tr>
<tr>
<td><code>range</code></td>
<td>string</td>
<td>non</td>
- <td>Le contenu de l'en-tête <code>Range:</code>.</td>
+ <td>Le contenu de l'en-t�te <code>Range:</code>.</td>
</tr>
<tr>
<td><code>remaining</code></td>
<td>number</td>
<td>non</td>
- <td>Le nombre d'octets du corps de la requête restant à lire.</td>
+ <td>Le nombre d'octets du corps de la requ�te restant � lire.</td>
</tr>
<tr>
<td><code>server_built</code></td>
@@ -612,82 +612,82 @@ end
<td><code>server_name</code></td>
<td>string</td>
<td>non</td>
- <td>Le nom du serveur pour cette requête.</td>
+ <td>Le nom du serveur pour cette requ�te.</td>
</tr>
<tr>
<td><code>some_auth_required</code></td>
<td>boolean</td>
<td>non</td>
- <td>Indique si une autorisation est/était requise pour cette
- requête.</td>
+ <td>Indique si une autorisation est/�tait requise pour cette
+ requ�te.</td>
</tr>
<tr>
<td><code>subprocess_env</code></td>
<td>table</td>
<td>oui</td>
- <td>Le jeu de variables d'environnement pour cette requête.</td>
+ <td>Le jeu de variables d'environnement pour cette requ�te.</td>
</tr>
<tr>
<td><code>started</code></td>
<td>number</td>
<td>non</td>
- <td>Le moment où le serveur a été (re)démarré, en secondes
+ <td>Le moment o� le serveur a �t� (re)d�marr�, en secondes
depuis epoch (1er janvier 1970)</td>
</tr>
<tr>
<td><code>status</code></td>
<td>number</td>
<td>oui</td>
- <td>Le code de retour (courant) pour cette requête, par
+ <td>Le code de retour (courant) pour cette requ�te, par
exemple <code>200</code> ou <code>404</code>.</td>
</tr>
<tr>
<td><code>the_request</code></td>
<td>string</td>
<td>non</td>
- <td>La chaîne de la requête telle qu'elle a été envoyée par le
+ <td>La cha�ne de la requ�te telle qu'elle a �t� envoy�e par le
client, par exemple <code>GET /foo/bar HTTP/1.1</code>.</td>
</tr>
<tr>
<td><code>unparsed_uri</code></td>
<td>string</td>
<td>non</td>
- <td>La partie URI non interprétée de la requête</td>
+ <td>La partie URI non interpr�t�e de la requ�te</td>
</tr>
<tr>
<td><code>uri</code></td>
<td>string</td>
<td>oui</td>
- <td>L'URI après interprétation par httpd</td>
+ <td>L'URI apr�s interpr�tation par httpd</td>
</tr>
<tr>
<td><code>user</code></td>
<td>string</td>
<td>oui</td>
- <td>Si une authentification a été effectuée, nom de
- l'utilisateur authentifié.</td>
+ <td>Si une authentification a �t� effectu�e, nom de
+ l'utilisateur authentifi�.</td>
</tr>
<tr>
<td><code>useragent_ip</code></td>
<td>string</td>
<td>non</td>
- <td>L'adresse IP de l'agent qui a envoyé la requête</td>
+ <td>L'adresse IP de l'agent qui a envoy� la requ�te</td>
</tr>
</table>
</dd>
</dl>
</section>
-<section id="functions"><title>Méthodes de l'objet request_rec</title>
+<section id="functions"><title>M�thodes de l'objet request_rec</title>
-<p>L'objet request_rec possède (au minimum) les méthodes suivantes :</p>
+<p>L'objet request_rec poss�de (au minimum) les m�thodes suivantes :</p>
<highlight language="lua">
r:flush() -- vide le tampon de sortie
- -- Renvoie true si le vidage a été effectué avec succès,
+ -- Renvoie true si le vidage a �t� effectu� avec succ�s,
-- false dans le cas contraire.
-while nous_avons_des_données_à_envoyer do
- r:puts("Bla bla bla\n") -- envoi des données à envoyer vers le tampon
+while nous_avons_des_donn�es_�_envoyer do
+ r:puts("Bla bla bla\n") -- envoi des donn�es � envoyer vers le tampon
r:flush() -- vidage du tampon (envoi au client)
r.usleep(500000) -- mise en attente pendant 0.5 secondes et bouclage
end
@@ -696,12 +696,12 @@ end
<highlight language="lua">
r:addoutputfilter(name|function) -- ajoute un filtre en sortie
-r:addoutputfilter("fooFilter") -- insère le filtre fooFilter dans le flux de sortie
+r:addoutputfilter("fooFilter") -- ins�re le filtre fooFilter dans le flux de sortie
</highlight>
<highlight language="lua">
r:sendfile(filename) -- envoie un fichier entier au client en utilisant sendfile s'il est
- -- supporté par la plateforme :
+ -- support� par la plateforme :
if use_sendfile_thing then
r:sendfile("/var/www/large_file.img")
@@ -710,9 +710,9 @@ end
<highlight language="lua">
r:parseargs() -- renvoie deux tables : une table standard de couples
- -- clé/valeur pour les données GET simples,
- -- et une autre pour les données
- -- multivaluées (par exemple foo=1&foo=2&foo=3) :
+ -- cl�/valeur pour les donn�es GET simples,
+ -- et une autre pour les donn�es
+ -- multivalu�es (par exemple foo=1&foo=2&foo=3) :
local GET, GETMULTI = r:parseargs()
r:puts("Votre nom est : " .. GET['name'] or "Unknown")
@@ -720,13 +720,13 @@ r:puts("Votre nom est : " .. GET['name']
<highlight language="lua">
-r:parsebody()([sizeLimit]) -- interprète le corps de la
- -- requête en tant que POST et renvoie
+r:parsebody()([sizeLimit]) -- interpr�te le corps de la
+ -- requ�te en tant que POST et renvoie
-- deux tables lua, comme r:parseargs(). Un
- -- nombre optionnel peut être fourni
- -- pour spécifier le nombre maximal
- -- d'octets à interpréter. La
- -- valeur par défaut est 8192.
+ -- nombre optionnel peut �tre fourni
+ -- pour sp�cifier le nombre maximal
+ -- d'octets � interpr�ter. La
+ -- valeur par d�faut est 8192.
local POST, POSTMULTI = r:parsebody(1024*1024)
r:puts("Votre nom est : " .. POST['name'] or "Unknown")
@@ -734,63 +734,63 @@ r:puts("Votre nom est : " .. POST['name'
<highlight language="lua">
-r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la réponse
+r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la r�ponse
</highlight>
<highlight language="lua">
-r:write("une simple chaîne") -- affichage dans le corps de la réponse
+r:write("une simple cha�ne") -- affichage dans le corps de la r�ponse
</highlight>
<highlight language="lua">
-r:escape_html("<html>test</html>") -- Echappe le code HTML et renvoie le résultat
+r:escape_html("<html>test</html>") -- Echappe le code HTML et renvoie le r�sultat
</highlight>
<highlight language="lua">
-r:base64_encode(string) -- Encode une chaîne à l'aide du standard de codage Base64.
+r:base64_encode(string) -- Encode une cha�ne � l'aide du standard de codage Base64.
local encoded = r:base64_encode("This is a test") -- returns VGhpcyBpcyBhIHRlc3Q=
</highlight>
<highlight language="lua">
-r:base64_decode(string) -- Décode une chaîne codée en Base64.
+r:base64_decode(string) -- D�code une cha�ne cod�e en Base64.
local decoded = r:base64_decode("VGhpcyBpcyBhIHRlc3Q=") -- returns 'This is a test'
</highlight>
<highlight language="lua">
-r:md5(string) -- Calcule et renvoie le condensé MD5 d'une chaîne en mode binaire (binary safe).
+r:md5(string) -- Calcule et renvoie le condens� MD5 d'une cha�ne en mode binaire (binary safe).
local hash = r:md5("This is a test") -- returns ce114e4501d2f4e2dcea3e17b546f339
</highlight>
<highlight language="lua">
-r:sha1(string) -- Calcule et renvoie le condensé SHA1 d'une chaîne en mode binaire (binary safe).
+r:sha1(string) -- Calcule et renvoie le condens� SHA1 d'une cha�ne en mode binaire (binary safe).
local hash = r:sha1("This is a test") -- returns a54d88e06612d820bc3be72877c74f257b561b19
</highlight>
<highlight language="lua">
-r:escape(string) -- Echappe une chaîne de type URL.
+r:escape(string) -- Echappe une cha�ne de type URL.
local url = "http://foo.bar/1 2 3 & 4 + 5"
local escaped = r:escape(url) -- renvoie 'http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5'
</highlight>
<highlight language="lua">
-r:unescape(string) -- Déséchappe une chaîne de type URL.
+r:unescape(string) -- D�s�chappe une cha�ne de type URL.
local url = "http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5"
local unescaped = r:unescape(url) -- renvoie 'http://foo.bar/1 2 3 & 4 + 5'
</highlight>
<highlight language="lua">
-r:construct_url(string) -- Construit une URL à partir d'un URI
+r:construct_url(string) -- Construit une URL � partir d'un URI
local url = r:construct_url(r.uri)
</highlight>
<highlight language="lua">
-r.mpm_query(number) -- Interroge le serveur à propos de son module MPM via la requête ap_mpm_query.
+r.mpm_query(number) -- Interroge le serveur � propos de son module MPM via la requ�te ap_mpm_query.
local mpm = r.mpm_query(14)
if mpm == 1 then
@@ -799,110 +799,110 @@ end
</highlight>
<highlight language="lua">
-r:expr(string) -- Evalue une chaîne de type <a href="../expr.html">expr</a>.
+r:expr(string) -- Evalue une cha�ne de type <a href="../expr.html">expr</a>.
if r:expr("%{HTTP_HOST} =~ /^www/") then
- r:puts("Ce nom d'hôte commence par www")
+ r:puts("Ce nom d'h�te commence par www")
end
</highlight>
<highlight language="lua">
-r:scoreboard_process(a) -- Interroge le serveur à propos du
- -- processus à la position <code>a</code>.
+r:scoreboard_process(a) -- Interroge le serveur � propos du
+ -- processus � la position <code>a</code>.
local process = r:scoreboard_process(1)
r:puts("Le serveur 1 a comme PID " .. process.pid)
</highlight>
<highlight language="lua">
-r:scoreboard_worker(a, b) -- Interroge le serveur à propos du
+r:scoreboard_worker(a, b) -- Interroge le serveur � propos du
-- thread <code>b</code>, dans le processus <code>a</code>.
local thread = r:scoreboard_worker(1, 1)
r:puts("L'ID du thread 1 du serveur 1 est " .. thread.tid .. " et son
-état est " .. thread.status)
+�tat est " .. thread.status)
</highlight>
<highlight language="lua">
-r:clock() -- Renvoie l'heure courante avec une précision d'une microseconde.
+r:clock() -- Renvoie l'heure courante avec une pr�cision d'une microseconde.
</highlight>
<highlight language="lua">
-r:requestbody(filename) -- Lit et renvoie le corps d'une requête.
- -- Si 'filename' est spécifié, le
- -- corps de requête n'est pas
- -- renvoyé, mais sauvegardé dans
+r:requestbody(filename) -- Lit et renvoie le corps d'une requ�te.
+ -- Si 'filename' est sp�cifi�, le
+ -- corps de requ�te n'est pas
+ -- renvoy�, mais sauvegard� dans
-- le fichier correspondant.
local input = r:requestbody()
-r:puts("Vous m'avez envoyé le corps de requête suivant :\n")
+r:puts("Vous m'avez envoy� le corps de requ�te suivant :\n")
r:puts(input)
</highlight>
<highlight language="lua">
-r:add_input_filter(filter_name) -- Ajoute le filtre en entrée 'filter_name'.
+r:add_input_filter(filter_name) -- Ajoute le filtre en entr�e 'filter_name'.
</highlight>
<highlight language="lua">
-r:module_info(module_name) -- Interroge le serveur à propos d'un module.
+r:module_info(module_name) -- Interroge le serveur � propos d'un module.
local mod = r.module_info("mod_lua.c")
if mod then
for k, v in pairs(mod.commands) do
r:puts( ("%s: %s\n"):format(k,v)) -- affiche toutes les directives
- -- implémentées par ce module.
+ -- impl�ment�es par ce module.
end
end
</highlight>
<highlight language="lua">
-r:loaded_modules() -- Renvoie une liste des modules chargés par httpd.
+r:loaded_modules() -- Renvoie une liste des modules charg�s par httpd.
for k, module in pairs(r:loaded_modules()) do
- r:puts("J'ai chargé le module " .. module .. "\n")
+ r:puts("J'ai charg� le module " .. module .. "\n")
end
</highlight>
<highlight language="lua">
-r:runtime_dir_relative(filename) -- Génère le nom d'un fichier run-time
- -- (par exemple la mémoire partagée
- -- "file") relativement au répertoire de run-time.
+r:runtime_dir_relative(filename) -- G�n�re le nom d'un fichier run-time
+ -- (par exemple la m�moire partag�e
+ -- "file") relativement au r�pertoire de run-time.
</highlight>
<highlight language="lua">
-r:server_info() -- Renvoie une table contenant des informations à
+r:server_info() -- Renvoie une table contenant des informations �
-- propos du serveur, comme le nom de
- -- l'exécutable httpd, le module mpm utilisé, etc...
+ -- l'ex�cutable httpd, le module mpm utilis�, etc...
</highlight>
<highlight language="lua">
-r:set_document_root(file_path) -- Définit la racine des documents
- -- pour la requête à file_path.
+r:set_document_root(file_path) -- D�finit la racine des documents
+ -- pour la requ�te � file_path.
</highlight>
<highlight language="lua">
-r:add_version_component(component_string) -- Ajoute un élément à
- -- la bannière du serveur.
+r:add_version_component(component_string) -- Ajoute un �l�ment �
+ -- la banni�re du serveur.
</highlight>
<highlight language="lua">
-r:set_context_info(prefix, docroot) -- Définit le préfixe et la
- -- racine des documents du contexte pour une requête.
+r:set_context_info(prefix, docroot) -- D�finit le pr�fixe et la
+ -- racine des documents du contexte pour une requ�te.
</highlight>
<highlight language="lua">
-r:os_escape_path(file_path) -- Convertit un chemin du système de
- -- fichiers en URL indépendamment du système d'exploitation.
+r:os_escape_path(file_path) -- Convertit un chemin du syst�me de
+ -- fichiers en URL ind�pendamment du syst�me d'exploitation.
</highlight>
<highlight language="lua">
-r:escape_logitem(string) -- Echappe une chaîne pour journalisation.
+r:escape_logitem(string) -- Echappe une cha�ne pour journalisation.
</highlight>
<highlight language="lua">
-r.strcmp_match(string, pattern) -- Vérifie si 'string' correspond à
+r.strcmp_match(string, pattern) -- V�rifie si 'string' correspond �
-- 'pattern' via la fonction strcmp_match (GLOBs). Par exemple, est-ce que
- -- 'www.example.com' correspond à '*.example.com' ?
+ -- 'www.example.com' correspond � '*.example.com' ?
local match = r.strcmp_match("foobar.com", "foo*.com")
if match then
@@ -911,134 +911,134 @@ end
</highlight>
<highlight language="lua">
-r:set_keepalive() -- Définit l'état de persistance d'une requête.
+r:set_keepalive() -- D�finit l'�tat de persistance d'une requ�te.
-- Renvoie true dans la mesure du possible, false dans le cas contraire.
</highlight>
<highlight language="lua">
-r:make_etag() -- Génère et renvoie le etag pour la requête courante.
+r:make_etag() -- G�n�re et renvoie le etag pour la requ�te courante.
</highlight>
<highlight language="lua">
-r:send_interim_response(clear) -- Renvoie une réponse d'intérim (1xx) au
- -- client. Si 'clear' est vrai, les en-têtes disponibles
- -- seront envoyés et effacés.
+r:send_interim_response(clear) -- Renvoie une r�ponse d'int�rim (1xx) au
+ -- client. Si 'clear' est vrai, les en-t�tes disponibles
+ -- seront envoy�s et effac�s.
</highlight>
<highlight language="lua">
-r:custom_response(status_code, string) -- Génère et définit une réponse
- -- personnalisée pour un code d'état particulier.
- -- Le fonctionnement est très proche de celui de la directive ErrorDocument.
+r:custom_response(status_code, string) -- G�n�re et d�finit une r�ponse
+ -- personnalis�e pour un code d'�tat particulier.
+ -- Le fonctionnement est tr�s proche de celui de la directive ErrorDocument.
r:custom_response(404, "Baleted!")
</highlight>
<highlight language="lua">
-r.exists_config_define(string) -- Vérifie si une définition de configuration existe.
+r.exists_config_define(string) -- V�rifie si une d�finition de configuration existe.
if r.exists_config_define("FOO") then
- r:puts("httpd a probablement été lancé avec l'option -DFOO, ou FOO a
- été défini dans la configuration")
+ r:puts("httpd a probablement �t� lanc� avec l'option -DFOO, ou FOO a
+ �t� d�fini dans la configuration")
end
</highlight>
<highlight language="lua">
-r:state_query(string) -- Interroge le serveur à propos de son état.
+r:state_query(string) -- Interroge le serveur � propos de son �tat.
</highlight>
<highlight language="lua">
-r:stat(filename [,wanted]) -- Exécute stat() sur un fichier, et renvoie une table contenant
- -- des informations à propos de ce fichier.
+r:stat(filename [,wanted]) -- Ex�cute stat() sur un fichier, et renvoie une table contenant
+ -- des informations � propos de ce fichier.
local info = r:stat("/var/www/foo.txt")
if info then
- r:puts("Ce fichier existe et a été modifié pour la dernière fois à : " .. info.modified)
+ r:puts("Ce fichier existe et a �t� modifi� pour la derni�re fois � : " .. info.modified)
end
</highlight>
<highlight language="lua">
-r:regex(string, pattern [,flags]) -- Exécute une recherche à base d'expression rationnelle
- -- sur une chaîne, et renvoie les éventuelles correspondances trouvées.
+r:regex(string, pattern [,flags]) -- Ex�cute une recherche � base d'expression rationnelle
+ -- sur une cha�ne, et renvoie les �ventuelles correspondances trouv�es.
local matches = r:regex("foo bar baz", [[foo (\w+) (\S*)]])
if matches then
r:puts("L'expression rationnelle correspond et le dernier mot
- capturé ($2) est : " .. matches[2])
+ captur� ($2) est : " .. matches[2])
end
--- Exemple avec insensibilité à la casse :
+-- Exemple avec insensibilit� � la casse :
local matches = r:regex("FOO bar BAz", [[(foo) bar]], 1)
--- les drapeaux peuvent être une combibaison bit à bit de :
--- 0x01: insensibilité à la casse
+-- les drapeaux peuvent �tre une combibaison bit � bit de :
+-- 0x01: insensibilit� � la casse
-- 0x02: recherche multiligne
</highlight>
<highlight language="lua">
-r.usleep(microsecondes) -- Interrompt l'exécution du script pendant le nombre de microsecondes spécifié.
+r.usleep(microsecondes) -- Interrompt l'ex�cution du script pendant le nombre de microsecondes sp�cifi�.
</highlight>
<highlight language="lua">
-r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une base de données et renvoie une classe database.
- -- Voir '<a href="#databases">Connectivité aux bases de données</a>'
- -- pour plus de détails.
+r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion � une base de donn�es et renvoie une classe database.
+ -- Voir '<a href="#databases">Connectivit� aux bases de donn�es</a>'
+ -- pour plus de d�tails.
</highlight>
<highlight language="lua">
-r:ivm_set("key", value) -- Défini une variable Inter-VM avec une valeur spécifique.
- -- Ces valeurs sont conservées même si la VM est
- -- arrêtée ou non utilisée, et ne doivent donc être
- -- utilisées que si MaxConnectionsPerChild > 0.
- -- Les valeurs peuvent être de type number, string
- -- ou boolean et sont stockées séparément pour
+r:ivm_set("key", value) -- D�fini une variable Inter-VM avec une valeur sp�cifique.
+ -- Ces valeurs sont conserv�es m�me si la VM est
+ -- arr�t�e ou non utilis�e, et ne doivent donc �tre
+ -- utilis�es que si MaxConnectionsPerChild > 0.
+ -- Les valeurs peuvent �tre de type number, string
+ -- ou boolean et sont stock�es s�par�ment pour
-- chaque processus (elles ne seront donc pas d'une
- -- grande utilité si l'on utilise le mpm prefork).
+ -- grande utilit� si l'on utilise le mpm prefork).
-r:ivm_get("key") -- Lit le contenu d'une variable définie via ivm_set. Renvoie
+r:ivm_get("key") -- Lit le contenu d'une variable d�finie via ivm_set. Renvoie
-- le contenu de la variable si elle existe, ou nil
-- dans le cas contraire.
--- Voici un exemple de lecture/écriture qui sauvegarde une variable
+-- Voici un exemple de lecture/�criture qui sauvegarde une variable
-- globale en dehors de la VM :
function handle(r)
- -- La première VM qui effectue l'appel suivant n'obtiendra aucune
- -- valeur, et devra la créer
+ -- La premi�re VM qui effectue l'appel suivant n'obtiendra aucune
+ -- valeur, et devra la cr�er
local foo = r:ivm_get("cached_data")
if not foo then
foo = do_some_calcs() -- simulation de valeurs de retour
- r:ivm_set("cached_data", foo) -- définition globale de la variable
+ r:ivm_set("cached_data", foo) -- d�finition globale de la variable
end
- r:puts("La donnée en cache est : ", foo)
+ r:puts("La donn�e en cache est : ", foo)
end
</highlight>
<highlight language="lua">
-r:htpassword(string [,algorithm [,cost]]) -- Génère un hash de mot de passe à partir d'une chaîne.
- -- algorithm: 0 = APMD5 (défaut), 1 = SHA, 2 = BCRYPT, 3 = CRYPT.
- -- cost: ne s'utilise qu'avec l'algorythme BCRYPT (défaut = 5).
+r:htpassword(string [,algorithm [,cost]]) -- G�n�re un hash de mot de passe � partir d'une cha�ne.
+ -- algorithm: 0 = APMD5 (d�faut), 1 = SHA, 2 = BCRYPT, 3 = CRYPT.
+ -- cost: ne s'utilise qu'avec l'algorythme BCRYPT (d�faut = 5).
</highlight>
<highlight language="lua">
-r:mkdir(dir [,mode]) -- Crée un répertoire et définit son mode via le paramètre optionnel mode.
+r:mkdir(dir [,mode]) -- Cr�e un r�pertoire et d�finit son mode via le param�tre optionnel mode.
</highlight>
<highlight language="lua">
-r:mkrdir(dir [,mode]) -- Crée des répertoires de manière récursive et définit
- -- leur mode via le paramètre optionnel mode.
+r:mkrdir(dir [,mode]) -- Cr�e des r�pertoires de mani�re r�cursive et d�finit
+ -- leur mode via le param�tre optionnel mode.
</highlight>
<highlight language="lua">
-r:rmdir(dir) -- Supprime un répertoire.
+r:rmdir(dir) -- Supprime un r�pertoire.
</highlight>
<highlight language="lua">
-r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à
+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">
-r:get_direntries(dir) -- Renvoie une table contenant toutes les entrées de répertoires.
+r:get_direntries(dir) -- Renvoie une table contenant toutes les entr�es de r�pertoires.
--- Renvoie un chemin sous forme éclatée en chemin, fichier, extension
+-- Renvoie un chemin sous forme �clat�e en chemin, fichier, extension
function handle(r)
local dir = r.context_document_root
for _, f in ipairs(r:get_direntries(dir)) do
@@ -1053,7 +1053,7 @@ end
</highlight>
<highlight language="lua">
-r.date_parse_rfc(string) -- Interprète une chaîne date/heure et renvoie l'équivalent en secondes depuis epoche.
+r.date_parse_rfc(string) -- Interpr�te une cha�ne date/heure et renvoie l'�quivalent en secondes depuis epoche.
</highlight>
<highlight language="lua">
@@ -1061,38 +1061,38 @@ r:getcookie(key) -- Obtient un cookie HT
</highlight>
<highlight language="lua">
-r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple :
+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: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) :
+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)
+r:wswrite("Vous avez �crit : " .. line)
</highlight>
<highlight language="lua">
-r:wswrite(line) -- écrit un cadre vers un client WebSocket :
+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 :
+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("Vous avez �crit : " .. line);
r:wswrite("Au revoir !")
r:wsclose()
end
@@ -1104,7 +1104,7 @@ end
<highlight language="lua">
-- exemples de messages de journalisation
r:trace1("Ceci est un message de journalisation de niveau
- trace") -- les niveaux valides vont de trace1 à trace8
+ trace") -- les niveaux valides vont de trace1 � trace8
r:debug("Ceci est un message de journalisation de niveau debug")
r:info("Ceci est un message de journalisation de niveau info")
r:notice("Ceci est un message de journalisation de niveau notice")
@@ -1118,91 +1118,91 @@ end
</section>
<section id="apache2"><title>Paquet apache2</title>
-<p>Le paquet nommé <code>apache2</code> est fourni avec (au minimum) le
+<p>Le paquet nomm� <code>apache2</code> est fourni avec (au minimum) le
contenu suivant :</p>
<dl>
<dt>apache2.OK</dt>
<dd>Constante interne OK. Les gestionnaires renverront cette valeur
- s'ils ont traité la requête.</dd>
+ s'ils ont trait� la requ�te.</dd>
<dt>apache2.DECLINED</dt>
<dd>Constante interne DECLINED. Les gestionnaires renverront cette
- valeur s'ils n'ont pas l'intention de traiter la requête.</dd>
+ valeur s'ils n'ont pas l'intention de traiter la requ�te.</dd>
<dt>apache2.DONE</dt>
<dd>Constante interne DONE.</dd>
<dt>apache2.version</dt>
- <dd>Chaîne contenant la version du serveur HTTP Apache</dd>
+ <dd>Cha�ne contenant la version du serveur HTTP Apache</dd>
<dt>apache2.HTTP_MOVED_TEMPORARILY</dt>
- <dd>Code d'état HTTP</dd>
+ <dd>Code d'�tat HTTP</dd>
<dt>apache2.PROXYREQ_NONE, apache2.PROXYREQ_PROXY, apache2.PROXYREQ_REVERSE, apache2.PROXYREQ_RESPONSE</dt>
- <dd>Constantes internes utilisées par <module>mod_proxy</module></dd>
+ <dd>Constantes internes utilis�es par <module>mod_proxy</module></dd>
<dt>apache2.AUTHZ_DENIED, apache2.AUTHZ_GRANTED, apache2.AUTHZ_NEUTRAL, apache2.AUTHZ_GENERAL_ERROR, apache2.AUTHZ_DENIED_NO_USER</dt>
- <dd>constantes internes utilisées par <module>mod_authz_core</module></dd>
+ <dd>constantes internes utilis�es par <module>mod_authz_core</module></dd>
</dl>
-<p>Les autres codes d'état HTTP ne sont pas encore implémentés.</p>
+<p>Les autres codes d'�tat HTTP ne sont pas encore impl�ment�s.</p>
</section>
<section id="modifying_buckets">
<title>Modification de contenu avec les filtres lua</title>
<p>
- Les fonctions de filtrage implémentées via les directives <directive
+ Les fonctions de filtrage impl�ment�es via les directives <directive
module="mod_lua">LuaInputFilter</directive> ou <directive
- module="mod_lua">LuaOutputFilter</directive> sont conçues comme des
- fonctions de 3ème phase non blocantes utilisant des sous-routines
- pour suspendre et reprendre l'exécution d'une fonction lorsque des
- paquets de données sont envoyés à la chaîne de filtrage. La
+ module="mod_lua">LuaOutputFilter</directive> sont con�ues comme des
+ fonctions de 3�me phase non blocantes utilisant des sous-routines
+ pour suspendre et reprendre l'ex�cution d'une fonction lorsque des
+ paquets de donn�es sont envoy�s � la cha�ne de filtrage. La
structure de base d'une telle fonction est :
</p>
<highlight language="lua">
function filter(r)
- -- Nous indiquons tout d'abord que nous sommes prêts à recevoir des
- -- blocs de données.
- -- Avant ceci, nous pouvons définir notre environnement, tester
- -- certaines conditions, et, si nous le jugeons nécessaire, refuser le
- -- filtrage d'une requête :
+ -- Nous indiquons tout d'abord que nous sommes pr�ts � recevoir des
+ -- blocs de donn�es.
+ -- Avant ceci, nous pouvons d�finir notre environnement, tester
+ -- certaines conditions, et, si nous le jugeons n�cessaire, refuser le
+ -- filtrage d'une requ�te :
if something_bad then
- return -- Le filtrage est sauté
+ return -- Le filtrage est saut�
end
- -- Sans se préoccuper des données que nous devons éventuellement ajouter, un arrêt est réalisé ici.
- -- Noter que les filtres de sortie sont les seuls capables d'ajouter des éléments au début des données.
- -- Les filtres en entrée peuvent ajouter des éléments à la fin des données au stade final.
+ -- Sans se pr�occuper des donn�es que nous devons �ventuellement ajouter, un arr�t est r�alis� ici.
+ -- Noter que les filtres de sortie sont les seuls capables d'ajouter des �l�ments au d�but des donn�es.
+ -- Les filtres en entr�e peuvent ajouter des �l�ments � la fin des donn�es au stade final.
coroutine.yield([optional header to be prepended to the content])
- -- Après cet arrêt, nous allons recevoir d'autres blocs de données, un par un ;
- -- nous pouvons les traiter comme il nous plaît et procéder à la réponse.
- -- Ces blocs sont conservés dans la variable globale 'bucket', nous réalisons donc
- -- une boucle pour vérifier que 'bucket' n'est pas vide :
+ -- Apr�s cet arr�t, nous allons recevoir d'autres blocs de donn�es, un par un ;
+ -- nous pouvons les traiter comme il nous pla�t et proc�der � la r�ponse.
+ -- Ces blocs sont conserv�s dans la variable globale 'bucket', nous r�alisons donc
+ -- une boucle pour v�rifier que 'bucket' n'est pas vide :
while bucket ~= nil do
local output = mangle(bucket) -- Do some stuff to the content
coroutine.yield(output) -- Return our new content to the filter chain
end
- -- Une fois les blocs de données épuisés, 'bucket' est positionné à une valeur vide ('nil'),
- -- ce qui va nous faire sortir de cette boucle et nous amener à l'étape suivante.
- -- On peut ajouter ce qu'on veut à la fin des données à cette étape, qui constitue le dernier
- -- arrêt. Les filtres d'entrée comme de sortie peuvent servir à ajouter des éléments à la fin
- -- des données à cette étape.
+ -- Une fois les blocs de donn�es �puis�s, 'bucket' est positionn� � une valeur vide ('nil'),
+ -- ce qui va nous faire sortir de cette boucle et nous amener � l'�tape suivante.
+ -- On peut ajouter ce qu'on veut � la fin des donn�es � cette �tape, qui constitue le dernier
+ -- arr�t. Les filtres d'entr�e comme de sortie peuvent servir � ajouter des �l�ments � la fin
+ -- des donn�es � cette �tape.
coroutine.yield([optional footer to be appended to the content])
end
</highlight>
</section>
<section id="databases">
- <title>Connectivité aux bases de données</title>
- <p>Mod_lua implémente une fonctionnalité basique de connexion aux
-bases de données permettant d'envoyer des requêtes ou d'exécuter des
-commandes auprès des moteurs de base de données les plus courants
+ <title>Connectivit� aux bases de donn�es</title>
+ <p>Mod_lua impl�mente une fonctionnalit� basique de connexion aux
+bases de donn�es permettant d'envoyer des requ�tes ou d'ex�cuter des
+commandes aupr�s des moteurs de base de donn�es les plus courants
(mySQL, PostgreSQL, FreeTDS, ODBC, SQLite, Oracle), ainsi que mod_dbd.
</p>
- <p>L'exemple suivant montre comment se connecter à une base de
-données et extraire des informations d'une table :</p>
+ <p>L'exemple suivant montre comment se connecter � une base de
+donn�es et extraire des informations d'une table :</p>
<highlight language="lua">
function handle(r)
- -- connexion à la base de données
+ -- connexion � la base de donn�es
local database, err = r:dbacquire("mysql", "server=localhost,user=someuser,pass=somepass,dbname=mydb")
if not err then
- -- Sélection de certaines informations
+ -- S�lection de certaines informations
local results, err = database:select(r, "SELECT `name`, `age` FROM `people` WHERE 1")
if not err then
local rows = results(0) -- extrait tous les enregistrements en mode synchrone
@@ -1214,86 +1214,86 @@ function handle(r)
end
database:close()
else
- r:puts("Connexion à la base de données impossible : " .. err)
+ r:puts("Connexion � la base de donn�es impossible : " .. err)
end
end
</highlight>
<p>
- Pour utiliser <module>mod_dbd</module>, spécifiez
-<code>mod_dbd</code> comme type de base de données, ou laissez le champ
+ Pour utiliser <module>mod_dbd</module>, sp�cifiez
+<code>mod_dbd</code> comme type de base de donn�es, ou laissez le champ
vide :
</p>
<highlight language="lua">
local database = r:dbacquire("mod_dbd")
</highlight>
<section id="database_object">
- <title>L'objet database et ses méthodes</title>
- <p>L'objet database renvoyé par <code>dbacquire</code> possède
-les méthodes suivantes :</p>
- <p><strong>Sélection normale et requête vers une base de données
+ <title>L'objet database et ses m�thodes</title>
+ <p>L'objet database renvoy� par <code>dbacquire</code> poss�de
+les m�thodes suivantes :</p>
+ <p><strong>S�lection normale et requ�te vers une base de donn�es
:</strong></p>
<highlight language="lua">
--- Exécution d'une requête et renvoie du nombre d'enregistrements
-affectés :
+-- Ex�cution d'une requ�te et renvoie du nombre d'enregistrements
+affect�s :
local affected, errmsg = database:query(r, "DELETE FROM `tbl` WHERE 1")
--- Exécution d'une requête et renvoie du résultat qui peut être utilisé
+-- Ex�cution d'une requ�te et renvoie du r�sultat qui peut �tre utilis�
en mode synchrone ou asynchrone :
local result, errmsg = database:select(r, "SELECT * FROM `people` WHERE 1")
</highlight>
- <p><strong>Utilisation de requêtes préparées (recommandé) :</strong></p>
+ <p><strong>Utilisation de requ�tes pr�par�es (recommand�) :</strong></p>
<highlight language="lua">
--- Création et exécution d'une requête préparée :
+-- Cr�ation et ex�cution d'une requ�te pr�par�e :
local statement, errmsg = database:prepare(r, "DELETE FROM `tbl` WHERE `age` > %u")
if not errmsg then
- local result, errmsg = statement:query(20) -- exécute la requête pour age > 20
+ local result, errmsg = statement:query(20) -- ex�cute la requ�te pour age > 20
end
--- Extrait une requête préparée depuis une directive DBDPrepareSQL :
+-- Extrait une requ�te pr�par�e depuis une directive DBDPrepareSQL :
local statement, errmsg = database:prepared(r, "someTag")
if not errmsg then
- local result, errmsg = statement:select("John Doe", 123) -- injecte les valeurs "John Doe" et 123 dans la requête
+ local result, errmsg = statement:select("John Doe", 123) -- injecte les valeurs "John Doe" et 123 dans la requ�te
end
</highlight>
- <p><strong>Echappement de valeurs, fermeture de la base données,
+ <p><strong>Echappement de valeurs, fermeture de la base donn�es,
etc...</strong></p>
<highlight language="lua">
--- Echappe une valeur pour pouvoir l'utiliser dans une requête :
+-- Echappe une valeur pour pouvoir l'utiliser dans une requ�te :
local escaped = database:escape(r, [["'|blabla]])
--- Ferme une base de données et libère les liens vers cette dernière :
+-- Ferme une base de donn�es et lib�re les liens vers cette derni�re :
database:close()
--- Vérifie si une connexion à une base de données est en service et
-opérationnelle :
+-- V�rifie si une connexion � une base de donn�es est en service et
+op�rationnelle :
local connected = database:active()
</highlight>
</section>
<section id="result_sets">
- <title>Travail avec les jeux d'enregistrements renvoyés par les requêtes</title>
- <p>Les jeux d'enregistrements renvoyés par <code>db:select</code> ou par des
-requêtes préparées créées par <code>db:prepare</code> permettent de
-sélectionner des enregistrements en mode synchrone ou
-asynchrone, selon le nombre d'enregistrements spécifié :<br/>
- <code>result(0)</code> sélectionne tous les enregistrements en mode
+ <title>Travail avec les jeux d'enregistrements renvoy�s par les requ�tes</title>
+ <p>Les jeux d'enregistrements renvoy�s par <code>db:select</code> ou par des
+requ�tes pr�par�es cr��es par <code>db:prepare</code> permettent de
+s�lectionner des enregistrements en mode synchrone ou
+asynchrone, selon le nombre d'enregistrements sp�cifi� :<br/>
+ <code>result(0)</code> s�lectionne tous les enregistrements en mode
synchrone en renvoyant une table d'enregistrements.<br/>
- <code>result(-1)</code> sélectionne le prochain enregistrement disponible en
+ <code>result(-1)</code> s�lectionne le prochain enregistrement disponible en
mode asynchrone.<br/>
- <code>result(N)</code> sélectionne l'enregistrement numéro
+ <code>result(N)</code> s�lectionne l'enregistrement num�ro
<code>N</code> en mode asynchrone.
</p>
<highlight language="lua">
--- extrait un jeu d'enregistrements via une requête régulière :
+-- extrait un jeu d'enregistrements via une requ�te r�guli�re :
local result, err = db:select(r, "SELECT * FROM `tbl` WHERE 1")
-local rows = result(0) -- sélectionne tous les enregistrements en mode synchrone
-local row = result(-1) -- sélectionne le prochain enregistrement disponible en mode asynchrone
-local row = result(1234) -- sélectionne l'enregistrement 1234 en mode asynchrone
+local rows = result(0) -- s�lectionne tous les enregistrements en mode synchrone
+local row = result(-1) -- s�lectionne le prochain enregistrement disponible en mode asynchrone
+local row = result(1234) -- s�lectionne l'enregistrement 1234 en mode asynchrone
local row = result(-1, true) -- Lit l'enregistrement suivant en utilisant les noms d'enregistrements comme index.
</highlight>
<p>Il est possible de construire une fonction qui renvoie une
-fonction itérative permettant de traiter tous les enregistrement en mode
+fonction it�rative permettant de traiter tous les enregistrement en mode
synchrone ou asynchrone selon la valeur de l'argument async :
</p>
<highlight language="lua">
@@ -1313,7 +1313,7 @@ end
local statement, err = db:prepare(r, "SELECT * FROM `tbl` WHERE `age` > %u")
if not err then
- -- sélectionne des enregistrements en mode asynchrone :
+ -- s�lectionne des enregistrements en mode asynchrone :
local result, err = statement:select(20)
if not err then
for index, row in rows(result, true) do
@@ -1321,7 +1321,7 @@ if not err then
end
end
- -- sélectionne des enregistrements en mode synchrone :
+ -- s�lectionne des enregistrements en mode synchrone :
local result, err = statement:select(20)
if not err then
for index, row in rows(result, false) do
@@ -1332,37 +1332,37 @@ end
</highlight>
</section>
<section id="closing_databases">
- <title>Fermeture d'une connexion à une base de données</title>
+ <title>Fermeture d'une connexion � une base de donn�es</title>
- <p>Lorsqu'elles ne sont plus utilisées, les connexions aux bases de
-données doivent être fermées avec <code>database:close()</code>. Si vous
-ne les fermez pas manuellement, mod_lua les fermera peut-être en tant
-que résidus collectés, mais si ce n'est pas le cas, vous pouvez finir
-pas avoir trop de connexions vers la base de données inutilisées. Les
+ <p>Lorsqu'elles ne sont plus utilis�es, les connexions aux bases de
+donn�es doivent �tre ferm�es avec <code>database:close()</code>. Si vous
+ne les fermez pas manuellement, mod_lua les fermera peut-�tre en tant
+que r�sidus collect�s, mais si ce n'est pas le cas, vous pouvez finir
+pas avoir trop de connexions vers la base de donn�es inutilis�es. Les
deux mesures suivantes sont pratiquement identiques :
</p>
<highlight language="lua">
--- Méthode 1 : fermeture manuelle de la connexion
+-- M�thode 1 : fermeture manuelle de la connexion
local database = r:dbacquire("mod_dbd")
database:close() -- c'est tout
--- Méthode 2 : on laisse le collecteur de résidus la fermer
+-- M�thode 2 : on laisse le collecteur de r�sidus la fermer
local database = r:dbacquire("mod_dbd")
database = nil -- on coupe le lien
-collectgarbage() -- fermeture de la connexion par le collecteur de résidus
+collectgarbage() -- fermeture de la connexion par le collecteur de r�sidus
</highlight>
</section>
<section id="database_caveat">
- <title>Précautions à prendre lorsque l'on travaille avec les bases
-de données</title>
+ <title>Pr�cautions � prendre lorsque l'on travaille avec les bases
+de donn�es</title>
<p>Bien que les fonctions <code>query</code> et <code>run</code>
-soient toujours disponibles, il est recommandé d'utiliser des requêtes
-préparées chaque fois que possible, afin d'une part d'optimiser les
+soient toujours disponibles, il est recommand� d'utiliser des requ�tes
+pr�par�es chaque fois que possible, afin d'une part d'optimiser les
performances (si votre connexion reste longtemps en vie), et d'autre part
minimiser le risque d'attaques par injection SQL. Les fonctions
-<code>run</code> et <code>query</code> ne doivent être utilisées que
-lorsque la requête ne contient pas de variables (requête statique). Dans
-le cas des requêtes dynamiques, utilisez <code>db:prepare</code> ou
+<code>run</code> et <code>query</code> ne doivent �tre utilis�es que
+lorsque la requ�te ne contient pas de variables (requ�te statique). Dans
+le cas des requ�tes dynamiques, utilisez <code>db:prepare</code> ou
<code>db:prepared</code>.
</p>
</section>
@@ -1371,26 +1371,26 @@ le cas des requêtes dynamiques, utili
<directivesynopsis>
<name>LuaRoot</name>
-<description>Spécifie le chemin de base pour la résolution des chemins
+<description>Sp�cifie le chemin de base pour la r�solution des chemins
relatifs dans les directives de mod_lua</description>
-<syntax>LuaRoot /chemin/vers/un/répertoire</syntax>
+<syntax>LuaRoot /chemin/vers/un/r�pertoire</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
- <p>Cette directive permet de spécifier le chemin de base qui sera
- utilisé pour évaluer tous les chemins relatifs dans mod_lua. En
- l'absence de cette directive, les chemins relatifs sont résolus par
- rapport au répertoire de travail courant, ce qui ne sera pas
- toujours approprié pour un serveur.</p>
+ <p>Cette directive permet de sp�cifier le chemin de base qui sera
+ utilis� pour �valuer tous les chemins relatifs dans mod_lua. En
+ l'absence de cette directive, les chemins relatifs sont r�solus par
+ rapport au r�pertoire de travail courant, ce qui ne sera pas
+ toujours appropri� pour un serveur.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LuaScope</name>
-<description>Une valeur parmi once, request, conn, thread -- la valeur par défaut est once</description>
+<description>Une valeur parmi once, request, conn, thread -- la valeur par d�faut est once</description>
<syntax>LuaScope once|request|conn|thread|server [min] [max]</syntax>
<default>LuaScope once</default>
<contextlist><context>server config</context><context>virtual host</context>
@@ -1399,44 +1399,44 @@ relatifs dans les directives de mod_lua<
<override>All</override>
<usage>
- <p>Cette directive permet de spécifier la durée de vie de
- l'interpréteur Lua qui sera utilisé dans ce "répertoire". La valeur
- par défaut est "once".</p>
+ <p>Cette directive permet de sp�cifier la dur�e de vie de
+ l'interpr�teur Lua qui sera utilis� dans ce "r�pertoire". La valeur
+ par d�faut est "once".</p>
<dl>
- <dt>once:</dt> <dd>utilise l'interpréteur une fois.</dd>
+ <dt>once:</dt> <dd>utilise l'interpr�teur une fois.</dd>
- <dt>request:</dt> <dd>utilise l'interpréteur pour traiter tout ce
- qui est basé sur le même fichier dans la requête, et qui se trouve
- aussi dans la portée de la requête.</dd>
-
- <dt>conn:</dt> <dd>idem request, mais attaché à connection_rec</dd>
-
- <dt>thread:</dt> <dd>Utilise l'interpréteur pendant toute la durée
- de vie du thread qui traite la requête (disponible seulement avec
- les MPMs threadés).</dd>
-
- <dt>server:</dt> <dd>Le comportement est ici différent, car la
- portée du serveur présente une durée de vie assez longue, et
- plusieurs threads vont partager le même server_rec. Pour gérer tout
- ceci, les états lua du serveur sont stockés dans une liste de ressources
+ <dt>request:</dt> <dd>utilise l'interpr�teur pour traiter tout ce
+ qui est bas� sur le m�me fichier dans la requ�te, et qui se trouve
+ aussi dans la port�e de la requ�te.</dd>
+
+ <dt>conn:</dt> <dd>idem request, mais attach� � connection_rec</dd>
+
+ <dt>thread:</dt> <dd>Utilise l'interpr�teur pendant toute la dur�e
+ de vie du thread qui traite la requ�te (disponible seulement avec
+ les MPMs thread�s).</dd>
+
+ <dt>server:</dt> <dd>Le comportement est ici diff�rent, car la
+ port�e du serveur pr�sente une dur�e de vie assez longue, et
+ plusieurs threads vont partager le m�me server_rec. Pour g�rer tout
+ ceci, les �tats lua du serveur sont stock�s dans une liste de ressources
apr. Les arguments <code>min</code> et <code>max</code> permettent
- de spécifier les nombres minimaux et maximaux d'états lua à stocker
+ de sp�cifier les nombres minimaux et maximaux d'�tats lua � stocker
dans la liste.</dd>
</dl>
- <p>En général, les portées <code>thread</code> et <code>server</code>
- sont 2 à 3 fois plus rapides que les autres, car elles n'ont pas besoin
- de régénérer de nouveaux états Lua à chaque requête (comme c'est le
- cas avec le MPM event, où même les connexions persistantes utilisent un
- nouveau thread pour chaque requête). Si vous pensez que vos scripts
- n'auront pas de problème s'il réutilisent un état, alors les portées
- <code>thread</code> ou <code>server</code> doivent être utilisées car
- elles présenteront de meilleures performances. Alors que la portée
- <code>thread</code> fournira les réponses les plus rapides, la portée
- <code>server</code> utilisera moins de mémoire car les états sont
- rassemblés dans des jeux, permettant par exemple à 1000 threads de
- partager 100 états Lua, ne nécessitant ainsi que 10% de la mémoire
- requise par la portée <code>thread</code>.
+ <p>En g�n�ral, les port�es <code>thread</code> et <code>server</code>
+ sont 2 � 3 fois plus rapides que les autres, car elles n'ont pas besoin
+ de r�g�n�rer de nouveaux �tats Lua � chaque requ�te (comme c'est le
+ cas avec le MPM event, o� m�me les connexions persistantes utilisent un
+ nouveau thread pour chaque requ�te). Si vous pensez que vos scripts
+ n'auront pas de probl�me s'il r�utilisent un �tat, alors les port�es
+ <code>thread</code> ou <code>server</code> doivent �tre utilis�es car
+ elles pr�senteront de meilleures performances. Alors que la port�e
+ <code>thread</code> fournira les r�ponses les plus rapides, la port�e
+ <code>server</code> utilisera moins de m�moire car les �tats sont
+ rassembl�s dans des jeux, permettant par exemple � 1000 threads de
+ partager 100 �tats Lua, ne n�cessitant ainsi que 10% de la m�moire
+ requise par la port�e <code>thread</code>.
</p>
</usage>
</directivesynopsis>
@@ -1451,12 +1451,12 @@ relatifs dans les directives de mod_lua<
</contextlist>
<override>All</override>
<usage>
- <p>Cette directive permet de faire correspondre un modèle d'uri avec
- une fonction de gestionnaire située dans un fichier spécifique. Elle
+ <p>Cette directive permet de faire correspondre un mod�le d'uri avec
+ une fonction de gestionnaire situ�e dans un fichier sp�cifique. Elle
utilise les expressions rationnelles PCRE pour mettre en
correspondance l'uri, et supporte les groupes de correspondance
d'interpolation dans le chemin du fichier et le nom de la fonction.
- Prenez garde aux problèmes de sécurité en écrivant vos expressions
+ Prenez garde aux probl�mes de s�curit� en �crivant vos expressions
rationnelles.</p>
<example><title>Exemples :</title>
<highlight language="config">
@@ -1466,27 +1466,27 @@ relatifs dans les directives de mod_lua<
<p>Cette directive va faire correspondre des uri comme
/photos/show?id=9 au fichier /scripts/photos.lua, et invoquera la
fonction de gestionnaire handle_show au niveau de la vm lua
- après chargement de ce fichier.</p>
+ apr�s chargement de ce fichier.</p>
<highlight language="config">
LuaMapHandler "/bingo" "/scripts/wombat.lua"
</highlight>
<p>Cette directive invoquera la fonction "handle" qui est la
- valeur par défaut si aucun nom de fonction spécifique n'est
- spécifié.</p>
+ valeur par d�faut si aucun nom de fonction sp�cifique n'est
+ sp�cifi�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LuaPackagePath</name>
-<description>Ajoute un répertoire au package.path de lua</description>
+<description>Ajoute un r�pertoire au package.path de lua</description>
<syntax>LuaPackagePath /chemin/vers/include/?.lua</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
- <usage><p>Cette directive permet d'ajouter un chemin à la liste des
- chemins de recherche du module lua. Elle suit les mêmes conventions
+ <usage><p>Cette directive permet d'ajouter un chemin � la liste des
+ chemins de recherche du module lua. Elle suit les m�mes conventions
que lua. Ceci modifie le package.path dans les vms lua.</p>
<example><title>Exemples :</title>
@@ -1500,7 +1500,7 @@ LuaPackagePath "/scripts/lib/?/init.lua"
<directivesynopsis>
<name>LuaPackageCPath</name>
-<description>Ajoute un répertoire au package.cpath de lua</description>
+<description>Ajoute un r�pertoire au package.cpath de lua</description>
<syntax>LuaPackageCPath /chemin/vers/include/?.soa</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
@@ -1508,8 +1508,8 @@ LuaPackagePath "/scripts/lib/?/init.lua"
<override>All</override>
<usage>
- <p>Cette directive permet d'ajouter un chemin à la liste des chemins
- de recherche des bibliothèques partagées de lua. Ceci modifie le
+ <p>Cette directive permet d'ajouter un chemin � la liste des chemins
+ de recherche des biblioth�ques partag�es de lua. Ceci modifie le
package.cpath dans les vms lua.</p>
</usage>
@@ -1517,7 +1517,7 @@ LuaPackagePath "/scripts/lib/?/init.lua"
<directivesynopsis>
<name>LuaCodeCache</name>
-<description>Configure le cache de code compilé.</description>
+<description>Configure le cache de code compil�.</description>
<syntax>LuaCodeCache stat|forever|never</syntax>
<default>LuaCodeCache stat</default>
<contextlist>
@@ -1527,18 +1527,18 @@ LuaPackagePath "/scripts/lib/?/init.lua"
<override>All</override>
<usage><p>
- Cette directive permet de définir le comportement du cache de code
- en mémoire. La valeur par défaut est stat ; dans ce cas, le script
- du niveau le plus haut (et pas les scripts inclus) est vérifié à
- chaque fois que ce fichier est nécessaire, et est rechargé si la
- date de modification est plus récente que celle du script déjà
- chargé. Les autres valeurs permettent respectivement de garder le
- fichier en cache perpétuellement (forever - jamais vérifié ni
- remplacé), ou de ne jamais le mettre en cache (never).</p>
+ Cette directive permet de d�finir le comportement du cache de code
+ en m�moire. La valeur par d�faut est stat ; dans ce cas, le script
+ du niveau le plus haut (et pas les scripts inclus) est v�rifi� �
+ chaque fois que ce fichier est n�cessaire, et est recharg� si la
+ date de modification est plus r�cente que celle du script d�j�
+ charg�. Les autres valeurs permettent respectivement de garder le
+ fichier en cache perp�tuellement (forever - jamais v�rifi� ni
+ remplac�), ou de ne jamais le mettre en cache (never).</p>
- <p>En général, les valeurs stat et forever sont utilisées pour un
+ <p>En g�n�ral, les valeurs stat et forever sont utilis�es pour un
serveur en production, et les valeurs stat ou never pour un serveur
- en développement.</p>
+ en d�veloppement.</p>
<example><title>Exemples :</title>
<highlight language="config">
@@ -1553,29 +1553,29 @@ LuaCodeCache never
<directivesynopsis>
<name>LuaHookTranslateName</name>
-<description>Fournit un point d'entrée à la phase du nom de
-traduction du traitement de la requête</description>
+<description>Fournit un point d'entr�e � la phase du nom de
+traduction du traitement de la requ�te</description>
<syntax>LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early|late]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<override>All</override>
-<compatibility>Le troisième argument optionnel est disponible depuis la
+<compatibility>Le troisi�me argument optionnel est disponible depuis la
version 2.3.15 du serveur HTTP Apache.</compatibility>
<usage><p>
- Cette directive permet d'ajouter un point d'entrée (à
- APR_HOOK_MIDDLE) à la phase du nom de traduction du traitement de la
- requête. La fonction hook accepte un seul argument, le request_rec,
- et doit renvoyer un code d'état qui est soit un code d'erreur HTTP,
- ou une constante définie dans le module apache2 : apache2.OK,
+ Cette directive permet d'ajouter un point d'entr�e (�
+ APR_HOOK_MIDDLE) � la phase du nom de traduction du traitement de la
+ requ�te. La fonction hook accepte un seul argument, le request_rec,
+ et doit renvoyer un code d'�tat qui est soit un code d'erreur HTTP,
+ ou une constante d�finie dans le module apache2 : apache2.OK,
apache2.DECLINED, ou apache2.DONE.</p>
- <p>Pour ceux qui ne sont pas familiers avec les points d'entrée
- (hook), en gros, chaque hook sera invoqué jusqu'à ce que l'un
+ <p>Pour ceux qui ne sont pas familiers avec les points d'entr�e
+ (hook), en gros, chaque hook sera invoqu� jusqu'� ce que l'un
d'entre eux renvoie apache2.OK. Si un hook n'effectuer pas la
traduction, il doit juste renvoyer apache2.DECLINED. Si le
- traitement de la requête doit être interrompu, la valeur renvoyée
- doit être apache2.DONE.</p>
+ traitement de la requ�te doit �tre interrompu, la valeur renvoy�e
+ doit �tre apache2.DONE.</p>
<p>Exemple :</p>
@@ -1597,21 +1597,21 @@ function silly_mapper(r)
end
</highlight>
- <note><title>Contexte</title><p>Cette directive ne peut être
- utilisée ni à l'intérieur d'une section <directive type="section"
+ <note><title>Contexte</title><p>Cette directive ne peut �tre
+ utilis�e ni � l'int�rieur d'une section <directive type="section"
module="core">Directory</directive> ou <directive type="section"
module="core">Files</directive>, ni dans un fichier htaccess.</p></note>
<note><title>Ordonnancement</title><p>Les arguments optionnels
- "early" ou "late" permettent de contrôler le moment auquel ce script
- s'exécute par rapport aux autres modules.</p></note>
+ "early" ou "late" permettent de contr�ler le moment auquel ce script
+ s'ex�cute par rapport aux autres modules.</p></note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LuaHookFixups</name>
-<description>Fournit un point d'entrée pour la phase de correction du
-traitement de la requête</description>
+<description>Fournit un point d'entr�e pour la phase de correction du
+traitement de la requ�te</description>
<syntax>LuaHookFixups /chemin/vers/lua/script.lua hook_function_name</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
@@ -1619,7 +1619,7 @@ traitement de la requête</description
<override>All</override>
<usage>
<p>
[... 516 lines stripped ...]