Return-Path: X-Original-To: apmail-httpd-cvs-archive@www.apache.org Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 1229011932 for ; Sun, 18 May 2014 15:25:56 +0000 (UTC) Received: (qmail 3184 invoked by uid 500); 18 May 2014 15:00:49 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 77020 invoked by uid 500); 18 May 2014 14:35:49 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 72980 invoked by uid 99); 18 May 2014 14:20:58 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 18 May 2014 14:20:58 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 18 May 2014 14:20:56 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 02139238889B; Sun, 18 May 2014 14:20:32 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1595622 - in /httpd/httpd/branches/2.4.x/docs/manual/mod: mod_include.xml.fr mod_lua.xml.fr Date: Sun, 18 May 2014 14:20:31 -0000 To: cvs@httpd.apache.org From: lgentis@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140518142032.02139238889B@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: lgentis Date: Sun May 18 14:20:31 2014 New Revision: 1595622 URL: http://svn.apache.org/r1595622 Log: XML updates. Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.fr httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.fr?rev=1595622&r1=1595621&r2=1595622&view=diff ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.fr (original) +++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.fr Sun May 18 14:20:31 2014 @@ -1,7 +1,7 @@ - + @@ -156,7 +156,7 @@ AddOutputFilter INCLUDES .shtml module="mod_include">SSIUndefinedEcho.

- <!--#config errmsg="[Valeur non définie]" --> + <!--#config echomsg="[Valeur non définie]" --> Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr?rev=1595622&r1=1595621&r2=1595622&view=diff ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr (original) +++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_lua.xml.fr Sun May 18 14:20:31 2014 @@ -1,7 +1,7 @@ - + @@ -74,8 +74,8 @@ fonctionnement interne de httpd.

mod_lua fournit un gestionnaire nommé lua-script qui peut être utilisé avec une directive -SetHandler ou AddHandler :

+AddHandler ou SetHandler :

<Files *.lua> @@ -313,8 +313,7 @@ que vous pouvez écrire dans Lua s translate_name.lua
--- 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' @@ -685,7 +684,7 @@ end r:flush() -- vide le tampon de sortie -- Renvoie true si le vidage a été effectué avec succès, - false dans le cas contraire. + -- 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 @@ -701,8 +700,8 @@ r:addoutputfilter("fooFilter") -- ins&eg -r:sendfile(filename) -- envoie un fichier entier au client en -utilisant sendfile s'il est supporté par la plateforme : +r:sendfile(filename) -- envoie un fichier entier au client en utilisant sendfile s'il est + -- supporté par la plateforme : if use_sendfile_thing then r:sendfile("/var/www/large_file.img") @@ -711,8 +710,9 @@ end 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,10 +720,13 @@ r:puts("Votre nom est : " .. GET['name'] -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. +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. local POST, POSTMULTI = r:parsebody(1024*1024) r:puts("Votre nom est : " .. POST['name'] or "Unknown") @@ -735,18 +738,15 @@ r:puts("bonjour", " le monde", "!") -- a -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 -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 -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= @@ -758,15 +758,13 @@ local decoded = r:base64_decode("VGhpcyB -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 -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 @@ -792,8 +790,7 @@ local url = r:construct_url(r.uri) -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 @@ -802,8 +799,7 @@ end -r:expr(string) -- Evalue une chaîne de type expr. +r:expr(string) -- Evalue une chaîne de type expr. if r:expr("%{HTTP_HOST} =~ /^www/") then r:puts("Ce nom d'hôte commence par www") @@ -812,7 +808,7 @@ end r:scoreboard_process(a) -- Interroge le serveur à propos du -processus à la position a. + -- processus à la position a. local process = r:scoreboard_process(1) r:puts("Le serveur 1 a comme PID " .. process.pid) @@ -820,7 +816,7 @@ r:puts("Le serveur 1 a comme PID " .. pr r:scoreboard_worker(a, b) -- Interroge le serveur à propos du -thread b, dans le processus a. + -- thread b, dans le processus a. local thread = r:scoreboard_worker(1, 1) r:puts("L'ID du thread 1 du serveur 1 est " .. thread.tid .. " et son @@ -828,14 +824,15 @@ r:puts("L'ID du thread 1 du serveur 1 es -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. -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. +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") @@ -843,25 +840,23 @@ r:puts(input) -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'. -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 + r:puts( ("%s: %s\n"):format(k,v)) -- affiche toutes les directives + -- implémentées par ce module. end end -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") @@ -870,45 +865,44 @@ end 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. + -- (par exemple la mémoire partagée + -- "file") relativement au répertoire de run-time. -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... +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... -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. r:add_version_component(component_string) -- Ajoute un élément à -la bannière du serveur. + -- la bannière du serveur. r:set_context_info(prefix, docroot) -- Définit le préfixe et la -racine des documents du contexte pour une requête. + -- racine des documents du contexte pour une requête. r:os_escape_path(file_path) -- Convertit un chemin du système de -fichiers en URL indépendamment du système d'exploitation. + -- fichiers en URL indépendamment du système d'exploitation. -r:escape_logitem(string) -- Echappe une chaîne pour -journalisation. +r:escape_logitem(string) -- Echappe une chaîne pour journalisation. 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' ? + -- 'pattern' via la fonction strcmp_match (GLOBs). Par exemple, est-ce que + -- 'www.example.com' correspond à '*.example.com' ? local match = r.strcmp_match("foobar.com", "foo*.com") if match then @@ -917,33 +911,30 @@ end -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. +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. -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. 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. + -- client. Si 'clear' est vrai, les en-têtes disponibles + -- seront envoyés et effacés. 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. + -- 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!") -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 @@ -952,13 +943,12 @@ end -r:state_query(string) -- Interroge le serveur à propos de son -état. +r:state_query(string) -- Interroge le serveur à propos de son état. -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 @@ -967,9 +957,8 @@ end -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 @@ -990,10 +979,9 @@ r.usleep(microsecondes) -- Interrompt l' -r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une -base de données et renvoie une classe database. Voir 'Connectivité aux bases de données' pour plus de -détails. +r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une base de données et renvoie une classe database. + -- Voir 'Connectivité aux bases de données' + -- pour plus de détails. @@ -1034,7 +1022,8 @@ r:mkdir(dir [,mode]) -- Crée un r -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. @@ -1042,7 +1031,8 @@ r:rmdir(dir) -- Supprime un réper -r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à la valeur optionnelle mtime en msec. +r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à + -- la valeur optionnelle mtime en msec. @@ -1071,22 +1061,8 @@ r:getcookie(key) -- Obtient un cookie HT -r:setcookie{ - key = [key], - value = [value], - expires = [expiry], - secure = [boolean], - httponly = [boolean], - path = [path], - domain = [domain] -} -- Définit un cookie HTTP, par exemple : - -r:setcookie{ - key = "cookie1", - value = "HDHfa9eyffh396rt", - expires = os.time() + 86400, - secure = true -} +r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple : +r:setcookie("foo", "bar and stuff", false, os.time() + 86400) @@ -1121,7 +1097,6 @@ if r:wsupgrade() then r:wsclose() end -
Fonctions de journalisation @@ -1415,8 +1390,7 @@ relatifs dans les directives de mod_lua< LuaScope -Une valeur parmi once, request, conn, thread -- la valeur -par défaut est once +Une valeur parmi once, request, conn, thread -- la valeur par défaut est once LuaScope once|request|conn|thread|server [min] [max] LuaScope once server configvirtual host @@ -1695,7 +1669,7 @@ function logger(r) f:close() end return apache2.DONE -- On dit à httpd de ne rien enregistrer - --dans le journal standard + --dans le journal standard else r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données return apache2.OK -- et httpd doit alors les enregistrer. @@ -1740,19 +1714,19 @@ function read_file(filename) end function check_cache(r) - if r.filename:match("%.png$") then -- Only match PNG files - local file = cached_files[r.filename] -- Check cache entries + if r.filename:match("%.png$") then -- Ne concerne que les fichiers PNG + local file = cached_files[r.filename] -- Vérifie les entrées du cache if not file then - file = read_file(r.filename) -- Read file into cache + file = read_file(r.filename) -- Lit le fichier vers le cache end - if file then -- If file exists, write it out + if file then -- Si le fichier existe, on l'envoie r.status = 200 r:write(file) - r:info(("Sent %s to client from cache"):format(r.filename)) - return apache2.DONE -- skip default handler for PNG files + r:info(("%s a été envoyé au client depuis le cache"):format(r.filename)) + return apache2.DONE -- cout-circuite le gestionnaire par défaut des fichiers PNG end end - return apache2.DECLINED -- If we had nothing to do, let others serve this. + return apache2.DECLINED -- Si nous n'avons rien eu à faire, nous laissons les autres s'en charger end @@ -1993,11 +1967,11 @@ LuaInputFilter myInputFilter /www/filter majuscules. ]]-- function input_filter(r) - print("luaInputFilter called") -- debug print - coroutine.yield() -- Yield and wait for buckets - while bucket do -- For each bucket, do... + print("luaInputFilter called") -- pour débogage + coroutine.yield() -- attend des paquets de données + while bucket do -- Pour chaque paquet, faire ... local output = string.upper(bucket) -- Convertit toutes les données POST en majuscules - coroutine.yield(output) -- Envoie les données traitées à la chaîne + coroutine.yield(output) -- Envoie les données traitées à la chaîne de filtrage end -- plus aucune donnée à traiter. coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin @@ -2013,7 +1987,7 @@ function input_filter(r) return -- Empêche tout simplement le filtrage et transmet le contenu original end coroutine.yield() -- attend des paquets de données - ... -- insert les filtres ici + ... -- insert les filtres ici end

@@ -2055,7 +2029,8 @@ LuaOutputFilter myOutputFilter /www/filt sortie ]]-- function output_filter(r) - coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie, puis attend des paquets de données à traiter + coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie, + -- puis attend des paquets de données à traiter while bucket do -- Pour chaque paquet, faire ... local output = r:escape_html(bucket) -- Echappe les données en sortie coroutine.yield(output) -- Envoie les données traitées à la chaîne @@ -2073,7 +2048,7 @@ function output_filter(r) return -- Empêche tout simplement le filtrage et transmet le contenu original end coroutine.yield() -- attend des paquets de données - ... -- insert les filtres ici + ... -- insert les filtres ici end Les filtres Lua avec <module>mod_filter</module>