mirror of
https://github.com/apache/httpd.git
synced 2025-11-03 17:53:20 +03:00
f1c43293f4
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1335588 13f79535-47bb-0310-9956-ffa450edef68
886 lines
45 KiB
Plaintext
886 lines
45 KiB
Plaintext
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
This file is generated from xml source: DO NOT EDIT
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
-->
|
||
<title>mod_lua - Serveur Apache HTTP</title>
|
||
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
|
||
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
|
||
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
|
||
<script src="../style/scripts/prettify.js" type="text/javascript">
|
||
</script>
|
||
|
||
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
|
||
<body>
|
||
<div id="page-header">
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
|
||
<p class="apache">Serveur Apache HTTP Version 2.5</p>
|
||
<img alt="" src="../images/feather.gif" /></div>
|
||
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
|
||
<div id="path">
|
||
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
|
||
<div id="page-content">
|
||
<div id="preamble"><h1>Module Apache mod_lua</h1>
|
||
<div class="toplang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_lua.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_lua.html" title="Fran<61>ais"> fr </a></p>
|
||
</div>
|
||
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des points d'entr<74>e Lua dans diff<66>rentes parties du
|
||
traitement des requ<71>tes httpd</td></tr>
|
||
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>lua_module</td></tr>
|
||
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_lua.c</td></tr>
|
||
<tr><th><a href="module-dict.html#Compatibility">Compatibilit<69>:</a></th><td>versions 2.3 et sup<75>rieures</td></tr></table>
|
||
<h3>Sommaire</h3>
|
||
|
||
<p>Ce module permet d'ajouter au serveur des extensions sous forme de
|
||
scripts <20>crits dans le langage de programmation Lua.
|
||
<code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> fournit de nombreuses extensions
|
||
(hooks) disponibles avec les modules natifs du serveur HTTP Apache,
|
||
comme les associations de requ<71>tes <20> des fichiers, la g<>n<EFBFBD>ration de
|
||
r<EFBFBD>ponses dynamiques, le contr<74>le d'acc<63>s, l'authentification et
|
||
l'autorisation.</p>
|
||
|
||
<p>Vous trouverez davantage d'informations <20> propos du langage de
|
||
programmation Lua sur <a href="http://www.lua.org/">le site web de
|
||
Lua</a>.</p>
|
||
|
||
<div class="note"><code>mod_lua</code> est encore au stade exp<78>rimental. Son mode
|
||
d'utilisation et son comportement pourront changer <20> tout moment jusqu'<27>
|
||
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 <20>
|
||
jour.</div>
|
||
|
||
</div>
|
||
<div id="quickview"><h3 class="directives">Directives</h3>
|
||
<ul id="toc">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luacodecache">LuaCodeCache</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookaccesschecker">LuaHookAccessChecker</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookauthchecker">LuaHookAuthChecker</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookcheckuserid">LuaHookCheckUserID</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookfixups">LuaHookFixups</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookinsertfilter">LuaHookInsertFilter</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahookmaptostorage">LuaHookMapToStorage</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahooktranslatename">LuaHookTranslateName</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luahooktypechecker">LuaHookTypeChecker</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luainherit">LuaInherit</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luamaphandler">LuaMapHandler</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luapackagecpath">LuaPackageCPath</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luapackagepath">LuaPackagePath</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luaquickhandler">LuaQuickHandler</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luaroot">LuaRoot</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#luascope">LuaScope</a></li>
|
||
</ul>
|
||
<h3>Sujets</h3>
|
||
<ul id="topics">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#basicconf">Configuration de base</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#writinghandlers">Ecrire des gestionnaires</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#writinghooks">Ecriture de fonctions d'accroche
|
||
(hooks)</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#datastructures">Structures de donn<6E>es</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#logging">Fonctions de journalisation</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#apache2">Paquet apache2</a></li>
|
||
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="basicconf" id="basicconf">Configuration de base</a></h2>
|
||
|
||
<p>La directive de base pour le chargement du module est</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
LoadModule lua_module modules/mod_lua.so
|
||
</pre>
|
||
|
||
|
||
<p>
|
||
<code>mod_lua</code> fournit un gestionnaire nomm<6D>
|
||
<code>lua-script</code> qui peut <20>tre utilis<69> avec une directive
|
||
<code>AddHandler</code> :</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
AddHandler lua-script .lua
|
||
</pre>
|
||
|
||
|
||
<p>
|
||
Ceci aura pour effet de faire traiter les requ<71>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
|
||
<code class="directive">LuaMapHandler</code>.
|
||
</p>
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="writinghandlers" id="writinghandlers">Ecrire des gestionnaires</a></h2>
|
||
<p>Dans l'API du serveur HTTP Apache, un gestionnaire est une sorte de
|
||
point d'accroche (hook) sp<73>cifique responsable de la g<>n<EFBFBD>ration de la
|
||
r<EFBFBD>ponse. <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> et
|
||
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code> sont des exemples de modules comportant un
|
||
gestionnaire.</p>
|
||
|
||
<p><code>mod_lua</code> cherche toujours <20> invoquer une fonction Lua pour le
|
||
gestionnaire, plut<75>t que de simplement <20>valuer le corps d'un script dans
|
||
le style de CGI. Une fonction de gestionnaire se pr<70>sente comme suit :</p>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
<strong>example.lua</strong>
|
||
-- exemple de gestionnaire
|
||
|
||
require "string"
|
||
|
||
--[[
|
||
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<74>e diff<66>rent.
|
||
--]]
|
||
function handle(r)
|
||
r.content_type = "text/plain"
|
||
r:puts("Hello Lua World!\n")
|
||
|
||
if r.method == 'GET' then
|
||
for k, v in pairs( r:parseargs() ) do
|
||
r:puts( string.format("%s: %s", k, v) )
|
||
end
|
||
elseif r.method == 'POST' then
|
||
for k, v in pairs( r:parsebody() ) do
|
||
r:puts( string.format("%s: %s", k, v) )
|
||
end
|
||
else
|
||
r:puts("unknown HTTP method " .. r.method)
|
||
end
|
||
end
|
||
</pre>
|
||
|
||
|
||
<p>
|
||
Ce gestionnaire se contente d'afficher les arguments cod<6F>s d'un uri ou
|
||
d'un formulaire dans un page au format texte.
|
||
</p>
|
||
|
||
<p>
|
||
Cela signifie que vous pouvez (et <20>tes encourag<61> <20>) avoir plusieurs
|
||
gestionnaires (ou points d'entr<74>e, ou filtres) dans le m<>me script.
|
||
</p>
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="writinghooks" id="writinghooks">Ecriture de fonctions d'accroche
|
||
(hooks)</a></h2>
|
||
|
||
<p>Les fonctions d'accroche d<>terminent la mani<6E>re dont les modules (et
|
||
les scripts Lua) participent au traitement des requ<71>tes. Chaque type
|
||
d'accroche propos<6F> par le serveur a un r<>le sp<73>cifique, comme
|
||
l'association de requ<71>tes au syst<73>me de fichiers, le contr<74>le d'acc<63>s,
|
||
ou la d<>finition de types MIME. Il existe aussi des accroches <20> usage
|
||
g<EFBFBD>n<EFBFBD>ral qui s'ex<65>cutent simplement <20> des moments opportuns du cycle
|
||
de vie de la requ<71>te.</p>
|
||
|
||
<p>Les fonctions d'accroche acceptent l'objet de la requ<71>te comme seul
|
||
et unique argument. Elles peuvent renvoyer une valeur, selon la
|
||
fonction, mais il s'agit en g<>n<EFBFBD>ral d'un
|
||
code d'<27>tat HTTP ou des valeurs OK, DONE, ou DECLINED,
|
||
que vous pouvez <20>crire dans lua sous la forme <code>apache2.OK</code>,
|
||
<code>apache2.DONE</code>, ou <code>apache2.DECLINED</code>.</p>
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
<strong>translate_name.lua</strong>
|
||
-- exemple d'accroche qui r<><72>crit un URI en chemin du syst<73>me de
|
||
fichiers.
|
||
|
||
require 'apache2'
|
||
|
||
function translate_name(r)
|
||
if r.uri == "/translate-name" then
|
||
r.filename = r.document_root .. "/find_me.txt"
|
||
return apache2.OK
|
||
end
|
||
-- on ne g<>re pas cette URL et on donne sa chance <20> un autre module
|
||
return apache2.DECLINED
|
||
end
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
<strong>translate_name2.lua</strong>
|
||
--[[ exemple d'accroche qui r<><72>crit un URI vers un autre URI. Il renvoie
|
||
un apache2.DECLINED pour permettre <20> un autre interpr<70>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: actuellement, il est impossible de pr<70>voir si cette action
|
||
s'ex<65>cute avant ou apr<70>s mod_alias.
|
||
--]]
|
||
|
||
require 'apache2'
|
||
|
||
function translate_name(r)
|
||
if r.uri == "/translate-name" then
|
||
r.uri = "/find_me.txt"
|
||
return apache2.DECLINED
|
||
end
|
||
return apache2.DECLINED
|
||
end
|
||
</pre>
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="datastructures" id="datastructures">Structures de donn<6E>es</a></h2>
|
||
|
||
<dl>
|
||
<dt>request_rec</dt>
|
||
<dd>
|
||
<p>request_rec est consid<69>r<EFBFBD>e en tant que donn<6E>e utilisateur.
|
||
Elle poss<73>de une m<>tatable qui vous permet d'accomplir des
|
||
choses int<6E>ressantes. Pour la plus grande partie, elle poss<73>de
|
||
les m<>mes champs que la structure request_rec (voir httpd.h en
|
||
attendant que cette documentation soit plus compl<70>te), la
|
||
plupart d'entre eux <20>tant accessibles en lecture et <20>criture (le
|
||
contenu des champs de la table peut <20>tre modifi<66>, mais les
|
||
champs eux-m<>mes ne peuvent pas <20>tre <20>tablis en tant que tables
|
||
distinctes).</p>
|
||
|
||
<table class="bordered">
|
||
|
||
<tr>
|
||
<th><strong>Nom</strong></th>
|
||
<th><strong>Type Lua</strong></th>
|
||
<th><strong>Modifiable</strong></th>
|
||
</tr>
|
||
<tr>
|
||
<td><code>ap_auth_type</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>args</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>assbackwards</code></td>
|
||
<td>boolean</td>
|
||
<td>non</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>canonical_filename</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>content_encoding</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>content_type</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td><code>document_root</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>err_headers_out</code></td>
|
||
<td>table</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>filename</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>handler</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>headers_in</code></td>
|
||
<td>table</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>headers_out</code></td>
|
||
<td>table</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>hostname</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>method</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>notes</code></td>
|
||
<td>table</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>path_info</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>protocol</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>proxyreq</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>range</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>subprocess_env</code></td>
|
||
<td>table</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>status</code></td>
|
||
<td>number</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>the_request</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>unparsed_uri</code></td>
|
||
<td>string</td>
|
||
<td>non</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>uri</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>user</code></td>
|
||
<td>string</td>
|
||
<td>oui</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<p>La structure request_rec poss<73>de (au minimum) les m<>thodes
|
||
suivantes :</p>
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
r:addoutputfilter(name|function) -- ajoute un filtre en sortie
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
r:parseargs() -- returns a lua table containing the request's query string arguments
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
r:parsebody() -- parse the request body as a POST and return a lua table
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la r<>ponse
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
r:write("une simple cha<68>ne") -- affichage dans le
|
||
corps de la r<>ponse
|
||
</pre>
|
||
|
||
</dd>
|
||
</dl>
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="logging" id="logging">Fonctions de journalisation</a></h2>
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
-- exemples de messages de journalisation
|
||
r:trace1("Ceci est un message de journalisation de niveau
|
||
trace") -- les niveaux valides vont de trace1 <20> trace8 <br />
|
||
r:debug("Ceci est un message de journalisation de niveau debug")<br />
|
||
r:info("Ceci est un message de journalisation de niveau info")<br />
|
||
r:notice("Ceci est un message de journalisation de niveau notice")<br />
|
||
r:warn("Ceci est un message de journalisation de niveau warn")<br />
|
||
r:err("Ceci est un message de journalisation de niveau err")<br />
|
||
r:alert("Ceci est un message de journalisation de niveau alert")<br />
|
||
r:crit("Ceci est un message de journalisation de niveau crit")<br />
|
||
r:emerg("Ceci est un message de journalisation de niveau emerg")<br />
|
||
</pre>
|
||
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="apache2" id="apache2">Paquet apache2</a></h2>
|
||
<p>Le paquet nomm<6D> <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<69> la requ<71>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<71>te.</dd>
|
||
<dt>apache2.DONE</dt>
|
||
<dd>Constante interne DONE.</dd>
|
||
<dt>apache2.version</dt>
|
||
<dd>Cha<68>ne contenant la version du serveur HTTP Apache</dd>
|
||
<dt>apache2.HTTP_MOVED_TEMPORARILY</dt>
|
||
<dd>Code d'<27>tat HTTP</dd>
|
||
<dt>apache2.PROXYREQ_NONE, apache2.PROXYREQ_PROXY, apache2.PROXYREQ_REVERSE, apache2.PROXYREQ_RESPONSE</dt>
|
||
<dd>Constantes internes utilis<69>es par <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd>
|
||
</dl>
|
||
<p>Les autres codes d'<27>tat HTTP ne sont pas encore impl<70>ment<6E>s.</p>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaCodeCache" id="LuaCodeCache">LuaCodeCache</a> <a name="luacodecache" id="luacodecache">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure le cache de code compil<69>.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaCodeCache stat|forever|never</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>LuaCodeCache stat</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><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<66> <20>
|
||
chaque fois que ce fichier est n<>cessaire, et est recharg<72> si la
|
||
date de modification est plus r<>cente que celle du script d<>j<EFBFBD>
|
||
charg<72>. Les autres valeurs permettent respectivement de garder le
|
||
fichier en cache perp<72>tuellement (forever - jamais v<>rifi<66> ni
|
||
remplac<61>), ou de ne jamais le mettre en cache (never).</p>
|
||
|
||
<p>En g<>n<EFBFBD>ral, les valeurs stat et forever sont utilis<69>es pour un
|
||
serveur en production, et les valeurs stat ou never pour un serveur
|
||
en d<>veloppement.</p>
|
||
|
||
<div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">
|
||
LuaCodeCache stat
|
||
LuaCodeCache forever
|
||
LuaCodeCache never
|
||
</pre>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookAccessChecker" id="LuaHookAccessChecker">LuaHookAccessChecker</a> <a name="luahookaccesschecker" id="luahookaccesschecker">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase access_checker du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAccessChecker /chemin/vers/lua/script.lua hook_function_name [early|late]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Le troisi<73>me argument optionnel est disponible depuis la
|
||
version 2.3.15 du serveur HTTP Apache.</td></tr>
|
||
</table>
|
||
<p>Ajoute votre fonction d'accroche <20> la phase access_checker. Une
|
||
fonction d'accroche access checker renvoie en g<>n<EFBFBD>ral OK, DECLINED, ou
|
||
HTTP_FORBIDDEN.</p>
|
||
<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
|
||
"early" ou "late" permettent de contr<74>ler le moment auquel ce script
|
||
s'ex<65>cute par rapport aux autres modules.</p></div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookAuthChecker" id="LuaHookAuthChecker">LuaHookAuthChecker</a> <a name="luahookauthchecker" id="luahookauthchecker">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase auth_checker du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAuthChecker /chemin/vers/lua/script.lua hook_function_name [early|late]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Le troisi<73>me argument optionnel est disponible depuis la
|
||
version 2.3.15 du serveur HTTP Apache.</td></tr>
|
||
</table>
|
||
<p>Invoque une fonction lua au cours de la phase auth_checker du
|
||
traitement de la requ<71>te. Cette directive peut s'utiliser pour
|
||
impl<EFBFBD>menter une v<>rification arbitraire de l'authentification et de
|
||
l'autorisation. Voici un exemple tr<74>s simple :
|
||
</p>
|
||
<pre class="prettyprint lang-lua">
|
||
require 'apache2'
|
||
|
||
-- fonction d'accroche authcheck fictive
|
||
-- Si la requ<71>te ne contient aucune donn<6E>e d'authentification, l'en-t<>te
|
||
-- de la r<>ponse est d<>fini et un code 401 est renvoy<6F> afin de demander au
|
||
-- navigateur d'effectuer une authentification basique. Si la requ<71>te
|
||
-- comporte des donn<6E>es d'authentification, elles ne sont pas vraiment
|
||
-- consult<6C>es, mais on admet la prise en compte de l'utilisateur 'foo' et
|
||
-- on la valide. On v<>rifie ensuite si l'utilisateur est bien 'foo' et on
|
||
-- accepte la requ<71>te.
|
||
function authcheck_hook(r)
|
||
|
||
-- recherche des informations d'authentification
|
||
auth = r.headers_in['Authorization']
|
||
if auth ~= nil then
|
||
-- d<>finition d'un utilisateur par d<>faut
|
||
r.user = 'foo'
|
||
end
|
||
|
||
if r.user == nil then
|
||
r:debug("authcheck: user is nil, returning 401")
|
||
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
|
||
return 401
|
||
elseif r.user == "foo" then
|
||
r:debug('user foo: OK')
|
||
else
|
||
r:debug("authcheck: user='" .. r.user .. "'")
|
||
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
|
||
return 401
|
||
end
|
||
return apache2.OK
|
||
end
|
||
</pre>
|
||
|
||
<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
|
||
"early" ou "late" permettent de contr<74>ler le moment auquel ce script
|
||
s'ex<65>cute par rapport aux autres modules.</p></div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookCheckUserID" id="LuaHookCheckUserID">LuaHookCheckUserID</a> <a name="luahookcheckuserid" id="luahookcheckuserid">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase check_user_id du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookCheckUserID /chemin/vers/lua/script.lua hook_function_name [early|late]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Le troisi<73>me argument optionnel est disponible depuis la
|
||
version 2.3.15 du serveur HTTP Apache.</td></tr>
|
||
</table><p>...</p>
|
||
<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
|
||
"early" ou "late" permettent de contr<74>ler le moment auquel ce script
|
||
s'ex<65>cute par rapport aux autres modules.</p></div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookFixups" id="LuaHookFixups">LuaHookFixups</a> <a name="luahookfixups" id="luahookfixups">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase de correction du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookFixups /chemin/vers/lua/script.lua hook_function_name</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table>
|
||
<p>
|
||
Idem LuaHookTranslateName, mais s'ex<65>cute durant la phase de
|
||
correction.
|
||
</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookInsertFilter" id="LuaHookInsertFilter">LuaHookInsertFilter</a> <a name="luahookinsertfilter" id="luahookinsertfilter">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase insert_filter du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookInsertFilter /chemin/vers/lua/script.lua hook_function_name</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><p>Non encore impl<70>ment<6E></p>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookMapToStorage" id="LuaHookMapToStorage">LuaHookMapToStorage</a> <a name="luahookmaptostorage" id="luahookmaptostorage">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase map_to_storage du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookMapToStorage /chemin/vers/lua/script.lua hook_function_name</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><p>...</p>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookTranslateName" id="LuaHookTranslateName">LuaHookTranslateName</a> <a name="luahooktranslatename" id="luahooktranslatename">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e <20> la phase du nom de
|
||
traduction du traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early|late]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Le troisi<73>me argument optionnel est disponible depuis la
|
||
version 2.3.15 du serveur HTTP Apache.</td></tr>
|
||
</table><p>
|
||
Cette directive permet d'ajouter un point d'entr<74>e (<28>
|
||
APR_HOOK_MIDDLE) <20> la phase du nom de traduction du traitement de la
|
||
requ<71>te. La fonction hook accepte un seul argument, le request_rec,
|
||
et doit renvoyer un code d'<27>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<74>e
|
||
(hook), en gros, chaque hook sera invoqu<71> jusqu'<27> 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<71>te doit <20>tre interrompu, la valeur renvoy<6F>e
|
||
doit <20>tre apache2.DONE.</p>
|
||
|
||
<p>Exemple :</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
# httpd.conf
|
||
LuaHookTranslateName /scripts/conf/hooks.lua silly_mapper
|
||
</pre>
|
||
|
||
|
||
<pre class="prettyprint lang-lua">
|
||
-- /scripts/conf/hooks.lua --
|
||
require "apache2"
|
||
function silly_mapper(r)
|
||
if r.uri == "/" then
|
||
r.filename = "/var/www/home.lua"
|
||
return apache2.OK
|
||
else
|
||
return apache2.DECLINED
|
||
end
|
||
end
|
||
</pre>
|
||
|
||
|
||
<div class="note"><h3>Contexte</h3><p>Cette directive ne peut <20>tre
|
||
utilis<69>e ni <20> l'int<6E>rieur d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ni dans un fichier htaccess.</p></div>
|
||
|
||
<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
|
||
"early" ou "late" permettent de contr<74>ler le moment auquel ce script
|
||
s'ex<65>cute par rapport aux autres modules.</p></div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaHookTypeChecker" id="LuaHookTypeChecker">LuaHookTypeChecker</a> <a name="luahooktypechecker" id="luahooktypechecker">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la phase type_checker du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTypeChecker /chemin/vers/lua/script.lua hook_function_name</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><p>...</p>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaInherit" id="LuaInherit">LuaInherit</a> <a name="luainherit" id="luainherit">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contr<74>le la mani<6E>re dont les sections de configuration
|
||
parentes sont fusionn<6E>es dans les enfants</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaInherit none|parent-first|parent-last</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>LuaInherit parent-first</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Versions 2.4.0 et sup<75>rieures</td></tr>
|
||
</table><p>Par d<>faut, si des directives LuaHook* se trouvent dans
|
||
des sections de configuration Directory ou Location qui se
|
||
chevauchent, les scripts
|
||
d<>finis dans les sections les plus sp<73>cifiques s'ex<65>cutent
|
||
<em>apr<70>s</em> ceux d<>finis dans les sections plus g<>n<EFBFBD>riques
|
||
(LuaInherit parent-first). Vous pouvez inverser cet ordre, ou faire
|
||
en sorte que le contexte parent ne s'applique pas du tout.</p>
|
||
|
||
<p>Jusqu'aux versions 2.3.x, le comportement par d<>faut consistait <20>
|
||
ignorer les directives LuaHook* situ<74>es dans les sections de
|
||
configuration parentes.</p>
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaMapHandler" id="LuaMapHandler">LuaMapHandler</a> <a name="luamaphandler" id="luamaphandler">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance un chemin avec un gestionnaire lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaMapHandler modele-uri /chemin/vers/lua/script.lua
|
||
[nom-fonction]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de faire correspondre un mod<6F>le d'uri avec
|
||
une fonction de gestionnaire situ<74>e dans un fichier sp<73>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<62>mes de s<>curit<69> en <20>crivant vos expressions
|
||
rationnelles.</p>
|
||
<div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">
|
||
LuaMapHandler /(\w+)/(\w+) /scripts/$1.lua handle_$2
|
||
</pre>
|
||
</div>
|
||
<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<70>s chargement de ce fichier.</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
LuaMapHandler /bingo /scripts/wombat.lua
|
||
</pre>
|
||
|
||
<p>Cette directive invoquera la fonction "handle" qui est la
|
||
valeur par d<>faut si aucun nom de fonction sp<73>cifique n'est
|
||
sp<73>cifi<66>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaPackageCPath" id="LuaPackageCPath">LuaPackageCPath</a> <a name="luapackagecpath" id="luapackagecpath">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un r<>pertoire au package.cpath de lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackageCPath /chemin/vers/include/?.soa</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table>
|
||
<p>Cette directive permet d'ajouter un chemin <20> la liste des chemins
|
||
de recherche des biblioth<74>ques partag<61>es de lua. Ceci modifie le
|
||
package.cpath dans les vms lua.</p>
|
||
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaPackagePath" id="LuaPackagePath">LuaPackagePath</a> <a name="luapackagepath" id="luapackagepath">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un r<>pertoire au package.path de lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackagePath /chemin/vers/include/?.lua</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><p>Cette directive permet d'ajouter un chemin <20> 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>
|
||
|
||
<div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">
|
||
LuaPackagePath /scripts/lib/?.lua
|
||
LuaPackagePath /scripts/lib/?/init.lua
|
||
</pre>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaQuickHandler" id="LuaQuickHandler">LuaQuickHandler</a> <a name="luaquickhandler" id="luaquickhandler">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entr<74>e pour la gestion rapide du
|
||
traitement de la requ<71>te</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code /></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table><p>...</p>
|
||
<div class="note"><h3>Contexte</h3><p>Cette directive ne peut <20>tre
|
||
utilis<69>e ni <20> l'int<6E>rieur d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ni dans un fichier htaccess.</p></div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaRoot" id="LuaRoot">LuaRoot</a> <a name="luaroot" id="luaroot">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie le chemin de base pour la r<>solution des chemins
|
||
relatifs dans les directives de mod_lua</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaRoot /chemin/vers/un/r<>pertoire</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de sp<73>cifier le chemin de base qui sera
|
||
utilis<69> pour <20>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<72> pour un serveur.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="LuaScope" id="LuaScope">LuaScope</a> <a name="luascope" id="luascope">Directive</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Une valeur parmi once, request, conn, server -- la valeur
|
||
par d<>faut est once</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaScope once|request|conn|server [max|min max]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>LuaScope once</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
|
||
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Exp<78>rimental</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de sp<73>cifier la dur<75>e de vie de
|
||
l'interpr<70>teur Lua qui sera utilis<69> dans ce "r<>pertoire". La valeur
|
||
par d<>faut est "once".</p>
|
||
|
||
<dl>
|
||
<dt>once:</dt> <dd>utilise l'interpr<70>teur une fois.</dd>
|
||
|
||
<dt>request:</dt> <dd>utilise l'interpr<70>teur pour traiter tout ce
|
||
qui est bas<61> sur le m<>me fichier dans la requ<71>te, et qui se trouve
|
||
aussi dans la port<72>e de la requ<71>te.</dd>
|
||
|
||
<dt>conn:</dt> <dd>idem request, mais attach<63> <20> connection_rec</dd>
|
||
|
||
<dt>server:</dt> <dd>Le comportement est ici diff<66>rent, car la
|
||
port<72>e du serveur pr<70>sente une dur<75>e de vie assez longue, et
|
||
plusieurs threads vont partager le m<>me server_rec. Pour g<>rer tout
|
||
ceci, les interpr<70>teurs sont stock<63>s dans une liste de ressources
|
||
apr. Les arguments min et max ont <20>t<EFBFBD> pr<70>vus pour sp<73>cifier une
|
||
taille de jeu, mais sont inutilis<69>s pour le moment.</dd>
|
||
</dl>
|
||
|
||
</div>
|
||
</div>
|
||
<div class="bottomlang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_lua.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_lua.html" title="Fran<61>ais"> fr </a></p>
|
||
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>This section is experimental!</strong><br />Comments placed here should not be expected
|
||
to last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div>
|
||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
var lang = 'fr';
|
||
var disqus_shortname = 'httpd';
|
||
var disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
|
||
if (disqus_identifier.indexOf("httpd.apache.org") == -1) {
|
||
document.write('<div id="disqus_thread">\n</div>');
|
||
(function() {
|
||
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
|
||
dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
|
||
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
|
||
})();
|
||
} else {
|
||
document.write("Comments have been disabled for offline viewing.");
|
||
}
|
||
//--><!]]></script></div><div id="footer">
|
||
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
if (typeof(prettyPrint) !== undefined) {
|
||
prettyPrint();
|
||
}
|
||
//--><!]]></script>
|
||
</body></html> |