From 825ed1ea7a05c0dac4ace199e55ecb5b1497f829 Mon Sep 17 00:00:00 2001 From: Jeff Trawick Date: Wed, 11 Sep 2013 15:42:24 +0000 Subject: [PATCH] make docs xforms git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1521911 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/caching.html.fr | 8 +- docs/manual/mod/core.html.fr | 2 +- docs/manual/mod/directives.html.de | 1 + docs/manual/mod/directives.html.es | 1 + docs/manual/mod/directives.html.ja.utf8 | 1 + docs/manual/mod/directives.html.ko.euc-kr | 1 + docs/manual/mod/directives.html.tr.utf8 | 1 + docs/manual/mod/directives.html.zh-cn | 1 + docs/manual/mod/mod_authnz_fcgi.html.en | 8 + docs/manual/mod/mod_cache.html.fr | 15 +- docs/manual/mod/mod_deflate.html.fr | 97 +-- docs/manual/mod/mod_ldap.html.fr | 42 +- docs/manual/mod/mod_ldap.xml.meta | 2 +- docs/manual/mod/mod_lua.html.fr | 207 +++++- docs/manual/mod/mod_macro.html.fr | 2 - docs/manual/mod/mod_negotiation.html.fr | 14 +- docs/manual/mod/mod_proxy.html.fr | 26 +- docs/manual/mod/mod_rewrite.html.en | 20 +- docs/manual/mod/mod_rewrite.html.fr | 2 + docs/manual/mod/mod_rewrite.xml.fr | 2 +- docs/manual/mod/mod_rewrite.xml.meta | 2 +- docs/manual/mod/quickreference.html.de | 694 ++++++++--------- docs/manual/mod/quickreference.html.es | 692 ++++++++--------- docs/manual/mod/quickreference.html.ja.utf8 | 678 ++++++++--------- docs/manual/mod/quickreference.html.ko.euc-kr | 686 ++++++++--------- docs/manual/mod/quickreference.html.tr.utf8 | 702 +++++++++--------- docs/manual/mod/quickreference.html.zh-cn | 692 ++++++++--------- docs/manual/new_features_2_4.html.fr | 2 + docs/manual/vhosts/name-based.html.fr | 2 - 29 files changed, 2394 insertions(+), 2209 deletions(-) diff --git a/docs/manual/caching.html.fr b/docs/manual/caching.html.fr index 3474cbcbfd6..cc416b4db7d 100644 --- a/docs/manual/caching.html.fr +++ b/docs/manual/caching.html.fr @@ -25,8 +25,6 @@  fr  |  tr 

-
Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.

Ce document complète la documentation de référence des modules mod_cache, mod_cache_disk, @@ -194,6 +192,12 @@ phases d'authentification et d'autorisation du traitement au niveau du serveur, et il doit donc être utilisé avec prudence lorsque que ces phases sont importantes.

+ +

Les requêtes contenant un en-tête "Authorization" + header (par exemple dans le cas de l'authentification HTTP + basique) ne peuvent ni être mises en cache, ni servies + depuis le cache lorsque mod_cache + s'exécute dans cette phase.

Phase du gestionnaire normal
diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 89f5e2cb1b5..62cd9527b73 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -259,7 +259,7 @@ nom de chemin en fin de requ déterminé par le gestionnaire responsable de la requête. Le gestionnaire de base pour les fichiers normaux rejette par défaut les requêtes avec PATH_INFO. Les gestionnaires qui - servent des scripts, commecgi-script et isapi-handler, acceptent en général par + servent des scripts, comme cgi-script et isapi-handler, acceptent en général par défaut les requêtes avec PATH_INFO.
diff --git a/docs/manual/mod/directives.html.de b/docs/manual/mod/directives.html.de index 7775c63e186..698cc9ba92e 100644 --- a/docs/manual/mod/directives.html.de +++ b/docs/manual/mod/directives.html.de @@ -361,6 +361,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/directives.html.es b/docs/manual/mod/directives.html.es index 4e447b4781d..ae66c269661 100644 --- a/docs/manual/mod/directives.html.es +++ b/docs/manual/mod/directives.html.es @@ -364,6 +364,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/directives.html.ja.utf8 b/docs/manual/mod/directives.html.ja.utf8 index b6a53b94e1b..33123d41b3d 100644 --- a/docs/manual/mod/directives.html.ja.utf8 +++ b/docs/manual/mod/directives.html.ja.utf8 @@ -359,6 +359,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/directives.html.ko.euc-kr b/docs/manual/mod/directives.html.ko.euc-kr index 6ae2237cdc7..6e3ddad385a 100644 --- a/docs/manual/mod/directives.html.ko.euc-kr +++ b/docs/manual/mod/directives.html.ko.euc-kr @@ -359,6 +359,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/directives.html.tr.utf8 b/docs/manual/mod/directives.html.tr.utf8 index 729f59f6fe8..47e719a33c7 100644 --- a/docs/manual/mod/directives.html.tr.utf8 +++ b/docs/manual/mod/directives.html.tr.utf8 @@ -358,6 +358,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/directives.html.zh-cn b/docs/manual/mod/directives.html.zh-cn index 8616a5e34c1..5b77541577a 100644 --- a/docs/manual/mod/directives.html.zh-cn +++ b/docs/manual/mod/directives.html.zh-cn @@ -357,6 +357,7 @@
  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • diff --git a/docs/manual/mod/mod_authnz_fcgi.html.en b/docs/manual/mod/mod_authnz_fcgi.html.en index 91a382d0329..7ba616e4c26 100644 --- a/docs/manual/mod/mod_authnz_fcgi.html.en +++ b/docs/manual/mod/mod_authnz_fcgi.html.en @@ -483,6 +483,14 @@ authentication hook. to run when this module has a FastCGI authorizer configured and it fails the request. +
    DefaultUser userid
    +
    When the authorizer returns success and UserExpr + is configured and evaluates to an empty string (e.g., authorizer + didn't return a variable), this value will be used as the user + id. This is typically used when the authorizer has a concept of + guest, or unauthenticated, users and guest users are mapped to + some specific user id for logging and other purposes.
    +
    RequireBasicAuth On|Off (default Off)
    This controls whether or not Basic auth is required before passing the request to the authorizer. If required, diff --git a/docs/manual/mod/mod_cache.html.fr b/docs/manual/mod/mod_cache.html.fr index 29aea327113..08b252b6ff2 100644 --- a/docs/manual/mod/mod_cache.html.fr +++ b/docs/manual/mod/mod_cache.html.fr @@ -29,8 +29,6 @@  ja  |  ko 

    -
    Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.
    @@ -658,9 +656,8 @@ le contenu au client depuis le cacheCacheIgnoreCacheControl permet de modifier ce comportement. Avec CacheIgnoreCacheControl On, le serveur tentera de servir la ressource depuis le - cache, même si la requête contient un des en-têtes cités plus haut. - Les ressources qui requièrent une autorisation ne seront - jamais mises en cache.

    + cache, même si la requête contient un en-tête + no-cache.

           CacheIgnoreCacheControl On
@@ -1157,9 +1154,7 @@ l'ent
     de modifier ce comportement. Si
     CacheStoreNoStore est définie à On, le
     serveur tente de mettre la ressource en cache même si elle contient
-    des en-têtes ayant pour valeur no-store. Les ressources
-    nécessitant une autorisation ne sont jamais mises en
-    cache.
    
+    un en-tête no-store.
    
 
     
     
    @@ -1201,9 +1196,7 @@ marqu
     modifier ce comportement. Si
     CacheStorePrivate est définie à On, le
     serveur tentera de mettre la ressource en cache, même si elle
-    contient des en-têtes ayant pour valeur private. Les ressources
-    nécessitant une autorisation ne sont jamais mises en
-    cache.
    
+    contient un en-tête private.
    
 
     
     
    diff --git a/docs/manual/mod/mod_deflate.html.fr b/docs/manual/mod/mod_deflate.html.fr
index 87031f70169..f743dc2604d 100644
--- a/docs/manual/mod/mod_deflate.html.fr
+++ b/docs/manual/mod/mod_deflate.html.fr
@@ -29,8 +29,6 @@
  ja  |
  ko 
    
 
-
    Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.
    Description:Filtre de mise en cache HTTP conforme à la RFC 2616
    Statut:Extension
    Identificateur de Module:cache_module
    @@ -62,45 +60,29 @@ client
    top

    Exemples de configurations

    -

    Voici un exemple simple de configuration pour les - impatients.

    +

    Compression et TLS

    +

    Certaines applications web sont vulnérables à une attaque pour + vol d'informations lorsqu'une connexion TLS transporte des + données compressées par deflate. Pour plus de détails, + documentez-vous sur la famille d'attaques "BREACH".

    +
    +

    Voici un exemple simple de configuration qui permet de comprimer + les types de contenu à base de texte.

    Ne comprime que certains types de documents

    -      AddOutputFilterByType DEFLATE text/html text/plain text/xml
-
    -
    - -

    La configuration suivante, tout en produisant un contenu encore - plus comprimé, est aussi beaucoup plus compliquée. N'utilisez pas - cet exemple si vous ne comprenez pas tous les détails de la - configuration.

    - -

    Comprime tout, sauf les images

    -<Location />
-    # Insert filter
-    SetOutputFilter DEFLATE
-    
-    # Netscape 4.x a quelques problèmes ...
-    BrowserMatch ^Mozilla/4         gzip-only-text/html
-    
-    # Netscape 4.06-4.08 ont d'autres problèmes
-    BrowserMatch ^Mozilla/4\.0[678] no-gzip
-    
-    # MSIE se fait passer pour Netscape, mais ça marche
-    BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
-    # Ne pas comprimer les images
-    SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip dont-vary
-    
-    # On s'assure que les mandataires ne servent pas le mauvais
-    # contenu
-    Header append Vary User-Agent env=!dont-vary
-</Location>
-
    + AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript +
    top

    Activation de la compression

    +

    Compression et TLS

    +

    Certaines applications web sont vulnérables à une attaque pour + vol d'informations lorsqu'une connexion TLS transporte des + données compressées par deflate. Pour plus de détails, + documentez-vous sur la famille d'attaques "BREACH".

    +

    Compression de la sortie

    La compression est implémentée par le filtre DEFLATE. La @@ -108,16 +90,10 @@ client conteneur où elle est placée :

    -        SetOutputFilter DEFLATE
-
    - +SetOutputFilter DEFLATE +SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip + -

    Certains navigateurs populaires ne gèrent pas la compression de - tous les contenus, et pour résoudre ce problème, vous pouvez - définir la note gzip-only-text/html à 1 - pour ne permettre que la compression des fichiers html (voir - ci-dessous). Si vous définissez cette note à toute autre - valeur que 1, elle sera ignorée.

    Si vous voulez limiter la compression à certains types MIME particuliers, vous pouvez utiliser la directive AddOutputFilterByType. Voici un exemple @@ -131,41 +107,6 @@ client -

    Pour les navigateurs qui ont des problèmes avec la compression - de tous les types de fichiers, vous pouvez utiliser la directive - BrowserMatch pour - définir la note no-gzip, pour le navigateur - considéré, de façon à ce qu'aucune compression ne soit effectuée. - Vous pouvez combiner no-gzip avec - gzip-only-text/html afin d'obtenir le meilleur - résultat possible. Dans ce cas, la première note l'emporte sur la - deuxième. Considérons l'extrait suivant de l'exemple de configuration de la section - précédente :

    - - 
    -BrowserMatch ^Mozilla/4         gzip-only-text/html
-BrowserMatch ^Mozilla/4\.0[678] no-gzip
-BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
-
    - - -

    Tout d'abord, on recherche un en-tête User-Agent - qui signale un navigateur Netscape version 4.x. Ces versions ne - gèrent pas la compression des types de fichiers autres que - text/html. En outre, les versions 4.06, 4.07 et 4.08 - ont des problèmes avec la décompression des fichiers html. Par - conséquent, nous désactivons complètement le filtre deflate pour - ces derniers.

    - -

    La troisième directive BrowserMatch corrige l'identité - sous laquelle se présente le navigateur ; en effet, Microsoft - Internet Explorer s'identifie aussi lui-même comme "Mozilla/4", - mais par contre, il sait gérer les contenus compressés. On - recherche donc la chaîne additionnelle "MSIE" (\b - signifie "par mots entiers") dans l'en-tête - User-Agent, et si elle est trouvée, on annule les - restrictions définies auparavant.

    -

    Note

    Le filtre DEFLATE est toujours inséré après les filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les diff --git a/docs/manual/mod/mod_ldap.html.fr b/docs/manual/mod/mod_ldap.html.fr index 7145576f1cb..90e93752c23 100644 --- a/docs/manual/mod/mod_ldap.html.fr +++ b/docs/manual/mod/mod_ldap.html.fr @@ -27,6 +27,8 @@

    Langues Disponibles:  en  |  fr 

    +
    Cette traduction peut être périmée. Vérifiez la version + anglaise pour les changements récents.
    Description:Comprime le contenu avant de le servir au client
    Statut:Extension
    @@ -662,7 +664,7 @@ LDAP.
    Description:Conservation des connexions LDAP et services de mise en cache du résultat à destination des autres modules LDAP
    Statut:Extension
    - + @@ -672,15 +674,35 @@ cours des requ

    Certains serveurs LDAP partagent leur annuaire en plusieurs domaines et utilisent le système des redirections (referrals) pour aiguiller un client lorsque les limites d'un domaine doivent être - franchies. En définissant LDAPReferrals On, les - redirections seront prises en compte (et bien entendu, en - définissant LDAPReferrals Off, les redirections seront - ignorées). La directive LDAPReferralHopLimit complète - cette directive en définissant le nombre maximum de redirections à - suivre avant l'abandon de la requête LDAP. Lorsque le traitement des - redirections est activé, les données d'identification du client - seront fournies, via un appel (callback) de réidentification, à tout - serveur LDAP qui en fera la demande.

    + franchies. Ce processus est similaire à une redirection HTTP. Les + bibliothèques client LDAP ne respectent pas forcément ces + redirections par défaut. Cette directive permet de configurer + explicitement les redirections LDAP dans le SDK sous-jacent.

    + +

    La directive LDAPReferrals accepte les + valeurs suivantes :

    +
    +
    "on"
    +

    Avec la valeur "on", la prise en compte des redirections + LDAP par le SDK sous-jacent est activée, la directive + LDAPReferralHopLimit permet de surcharger la + "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.

    +
    "off"
    +

    Avec la valeur "off", la prise en compte des redirections + LDAP par le SDK sous-jacent est complètement désactivée.

    +
    "default"
    +

    Avec la valeur "default", la prise en compte des redirections + LDAP par le SDK sous-jacent n'est pas modifiée, la directive + LDAPReferralHopLimit ne permet pas de surcharger la + "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.

    +
    + +

    La directive LDAPReferralHopLimit travaille en + conjonction avec cette directive pour limiter le nombre de + redirections à suivre pour achever le traitement de la requête LDAP. + Lorsque le processus de redirection est activé par la valeur "On", + les données d'authentification du client sont transmises via un + "rebind callback" à tout serveur LDAP qui en fait la demande.

    top
    diff --git a/docs/manual/mod/mod_ldap.xml.meta b/docs/manual/mod/mod_ldap.xml.meta index 92fe318361b..c8ca8412817 100644 --- a/docs/manual/mod/mod_ldap.xml.meta +++ b/docs/manual/mod/mod_ldap.xml.meta @@ -8,6 +8,6 @@ en - fr + fr diff --git a/docs/manual/mod/mod_lua.html.fr b/docs/manual/mod/mod_lua.html.fr index 6689ea16c20..2f4546d3f07 100644 --- a/docs/manual/mod/mod_lua.html.fr +++ b/docs/manual/mod/mod_lua.html.fr @@ -72,6 +72,7 @@ fonctionnement interne de httpd.

  • LuaHookCheckUserID
  • LuaHookFixups
  • LuaHookInsertFilter
    • +
  • LuaHookLog
  • LuaHookMapToStorage
  • LuaHookTranslateName
  • LuaHookTypeChecker
    • @@ -330,10 +331,12 @@ ou la d - + + 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.
    Description:Active la redirection vers des serveurs alternatifs au cours des requêtes vers le serveur LDAP.
    Syntaxe:LDAPReferrals On|Off
    Syntaxe:LDAPReferrals On|Off|default
    Défaut:LDAPReferrals On
    Contexte:répertoire, .htaccess
    AllowOverride:AuthConfig
    JournalisationaucuneLuaHookLog 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.
    @@ -1146,6 +1149,17 @@ r.date_parse_rfc(string) -- Interpr +
    +r:getcookie(key) -- Obtient un cookie HTTP
+
    + + +
    +r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple :
+r:setcookie("foo", "bar and stuff", false, os.time() + 86400)
+
    + +
    top

    Fonctions de journalisation

    @@ -1616,6 +1630,62 @@ traitement de la requ Statut:Expérimental Module:mod_lua

    Non encore implémenté

    +
    +
    top
    +

    LuaHookLog Directive

    + + + + + + + +
    Description:Permet une insertion dans la phase de journalisation du +traitement d'une requête
    Syntaxe:LuaHookLog /path/to/lua/script.lua log_function_name
    Contexte:configuration du serveur, serveur virtuel, répertoire, .htaccess
    AllowOverride:All
    Statut:Expérimental
    Module:mod_lua
    +

    + Ce dispositif d'insertion simple permet d'exécuter une fonction + lorsque httpd entre dans la phase de journalisation du traitement + d'une requête. Vous pouvez ainsi ajouter des données à vos propres + entrées de journalisation, manipuler les entrées du journal standard + avant leur enregistrement ou empêcher l'enregistrement d'une entrée + dans le journal. Pour empêcher l'enregistrement normal des entrées + du journal, renvoyez simplement apache2.DONE dans votre + gestionnaire de journalisation, ou au contraire, renvoyez + apache2.OK pour que httpd effectue une journalisation + normale. +

    +

    Exemple :

    +
    +LuaHookLog /path/to/script.lua logger
+
    + +
    +-- /path/to/script.lua --
+function logger(r)
+    -- on joue à pile ou face :
+    -- Si on obtient 1, on écrit dans notre propre journal Lua et on dit
+    -- à httpd de ne pas enregistrer d'entrée dans le journal standard..
+    -- Si on obtient 2, on nettoie un peu les données avant que httpd ne
+    -- les enregistre dans le journal standard.
+
+    if math.random(1,2) == 1 then
+        -- On effectue notre propre journalisation et le journal
+	-- standard n'est pas alimenté
+        local f = io.open("/foo/secret.log", "a")
+        if f then
+            f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n")
+            f:close()
+        end
+        return apache2.DONE -- On dit à httpd de ne rien enregistrer
+				--dans le journal standard
+    else
+        r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données
+        return apache2.OK -- et httpd doit alors les enregistrer.
+    end
+end
+
    + +
    top

    LuaHookMapToStorage Directive

    @@ -1768,15 +1838,68 @@ parentes sont fusionn
    top

    LuaInputFilter Directive

    - + - -
    Description:Provide a Lua function for content input filtering
    Description:Fournit une fonction Lua pour le filtrage en entrée
    Syntaxe:LuaInputFilter filter_name /path/to/lua/script.lua function_name
    Contexte:configuration du serveur
    Statut:Expérimental
    Module:mod_lua
    Compatibilité:2.5.0 and later

    La documentation de cette directive - n'a pas encore t traduite. Veuillez vous reporter la version - en langue anglaise.

    +Compatibilité:Disponible depuis la version 2.5.0 du serveur HTTP +Apache + +

    Cette directive permet d'ajouter un filtre en entrée sous la forme +d'une fonction Lua. A l'instar des filtres en sorties, les filtres en +entrée fonctionnent comme des sous-routines, intervenant dans un premier +temps avant l'envoi du contenu des tampons, puis chaque fois qu'un +paquet de données doit être transmis à la chaîne, et éventuellement +produisant toute donnée à ajouter aux données en entrée. La variable +globale bucket contient les paquets de données tels qu'ils +sont transmis au script Lua : +

    + +
    +LuaInputFilter myInputFilter /www/filter.lua input_filter
+<FilesMatch "\.lua>
+  SetInputFilter myInputFilter
+</FilesMatch>
+
    + +
    +--[[
+    Exemple de filtre en entrée qui convertit toutes les données POST en
+    majuscules.
+]]--
+function input_filter(r)
+    print("luaInputFilter called") -- debug print
+    coroutine.yield() -- Yield and wait for buckets
+    while bucket do -- For each bucket, do...
+        local output = string.upper(bucket) -- Convertit toutes les données POST en majuscules
+        coroutine.yield(output) -- Envoie les données traitées à la chaîne
+    end
+    -- plus aucune donnée à traiter.
+    coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin
+end
+
    + +

    +Le filtre en entrée peut interdire ou sauter un filtre s'il est +considéré comme indésirable : +

    +
    +function input_filter(r)
+    if not good then
+        return -- Empêche tout simplement le filtrage et transmet le contenu original
+    end
+    coroutine.yield() -- attend des paquets de données
+    ... -- insert les filtres ici
+end
+
    + +

    +Voir "Modification de contenu avec les +filtres Lua" pour plus de détails. +

    + +
    top

    LuaMapHandler Directive

    @@ -1816,15 +1939,75 @@ parentes sont fusionn
    top

    LuaOutputFilter Directive

    - + - -
    Description:Provide a Lua function for content output filtering
    Description:Fournit une fonction Lua pour le filtrage de contenu en +sortie
    Syntaxe:LuaOutputFilter filter_name /path/to/lua/script.lua function_name
    Contexte:configuration du serveur
    Statut:Expérimental
    Module:mod_lua
    Compatibilité:2.5.0 and later

    La documentation de cette directive - n'a pas encore t traduite. Veuillez vous reporter la version - en langue anglaise.

    +Compatibilité:Disponible à partir de la version 2.5.0 du serveur HTTP +Apache + +

    >Cette directive permet d'ajouter un filtre en sortie sous la forme +d'une fonction Lua. A l'instar des filtres en sorties, les filtres en +entrée fonctionnent comme des sous-routines, intervenant dans un premier +temps avant l'envoi du contenu des tampons, puis chaque fois qu'un +paquet de données doit être transmis à la chaîne, et éventuellement +produisant toute donnée à ajouter aux données en sortie. La variable +globale bucket contient les paquets de données tels qu'ils +sont transmis au script Lua : +

    + +
    +LuaOutputFilter myOutputFilter /www/filter.lua output_filter
+<FilesMatch "\.lua>
+  SetOutputFilter myOutputFilter
+</FilesMatch>
+
    + +
    +--[[
+    Exemple de filtre en sortie qui échappe toutes les entités HTML en
+    sortie
+]]--
+function output_filter(r)
+    coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie, puis attend des paquets de données à traiter
+    while bucket do -- Pour chaque paquet, faire ...
+        local output = r:escape_html(bucket) -- Echappe les données en sortie
+        coroutine.yield(output) -- Envoie les données traitées à la chaîne
+    end
+    -- plus aucune donnée à traiter.
+end
+
    + +

    +Comme les filres en entrée, le filtre en sortie peut interdire ou sauter un filtre s'il est +considéré comme indésirable : +

    +
    +function output_filter(r)
+    if not r.content_type:match("text/html") then
+        return -- Empêche tout simplement le filtrage et transmet le contenu original
+    end
+    coroutine.yield() -- attend des paquets de données
+    ... -- insert les filtres ici
+end
+
    + +

    Les filtres Lua avec mod_filter

    +

    Lorsqu'on utilise un filtre Lua comme fournisseur sous-jacent via la +directive FilterProvider, le +filtrage ne fonctionnera que si filter-name est identique à +provider-name. +

    + +

    +Voir "Modification de contenu avec les +filtres Lua" pour plus de détails. +

    + + +
    top

    LuaPackageCPath Directive

    diff --git a/docs/manual/mod/mod_macro.html.fr b/docs/manual/mod/mod_macro.html.fr index 92539445a81..f97fbe4118c 100644 --- a/docs/manual/mod/mod_macro.html.fr +++ b/docs/manual/mod/mod_macro.html.fr @@ -27,8 +27,6 @@

    Langues Disponibles:  en  |  fr 

    -
    Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.
    diff --git a/docs/manual/mod/mod_negotiation.html.fr b/docs/manual/mod/mod_negotiation.html.fr index 3e83d226a65..12e729f7629 100644 --- a/docs/manual/mod/mod_negotiation.html.fr +++ b/docs/manual/mod/mod_negotiation.html.fr @@ -28,8 +28,6 @@  fr  |  ja 

    -
    Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.
    Description:Ce module permet d'utiliser des macros dans les fichiers de configuration Apache.
    Statut:Base
    @@ -205,11 +203,19 @@ contenu

    A l'arrivée d'une requête pour la ressource - document.html, le fichier - document.html.var sera consulté, et la variante de + document.html.var, la variante de document.html qui correspond le mieux à la préference de langage spécifiée dans l'en-tête de la requête de l'utilisateur Accept-Language sera choisie.

    + +

    Si Multiviews est activée, et si MultiviewsMatch est définie à + "handlers" ou "any", une requête pour document.html va + rechercher document.html.var, et continuer la + négociation avec le gestionnaire explicite type-map.

    + +

    D'autres directives de configuration, comme Alias, peuvent être utilisées pour + associer document.html avec + document.html.var.

    top

    Multivues

    diff --git a/docs/manual/mod/mod_proxy.html.fr b/docs/manual/mod/mod_proxy.html.fr index cfba74e3f9c..9db47e98a14 100644 --- a/docs/manual/mod/mod_proxy.html.fr +++ b/docs/manual/mod/mod_proxy.html.fr @@ -28,8 +28,6 @@  fr  |  ja 

    -
    Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.
    Description:Effectue la négociation de contenu
    Statut:Base
    @@ -80,6 +78,7 @@ +
    Description:Serveur mandataire/passerelle multi-protocole
    Statut:Extension
    Identificateur de Module:proxy_module
    HTTP/0.9, HTTP/1.0, et HTTP/1.1mod_proxy_http
    SCGImod_proxy_scgi
    WS and WSS (Web-sockets)mod_proxy_wstunnel
    @@ -150,6 +149,7 @@
  • mod_proxy_ftp
  • mod_proxy_http
  • mod_proxy_scgi
    • +
  • mod_proxy_wstunnel
  • mod_proxy_balancer
  • mod_ssl
    • @@ -803,6 +803,21 @@ mandat +

    Différences avec la section de configuration Location

    +

    Une URL d'arrière-plan sera concernée par le conteneur Proxy si + elle commence par la url-avec-jokers, même si le + dernier segment de chemin de la directive ne correspond qu'à un + préfixe de segment dee chemin de l'URL d'arrière-plan. Par exemple, <Proxy + http://example.com/foo> correspondra entre autres aux URLs + http://example.com/foo, http://example.com/foo/bar, et + http://example.com/foobar. La correspondance de l'URL finale + diffère du comportement de la section <Location> qui, pour le cas de cette note, + traitera le segment de chemin final comme s'il se terminait par un + slash.

    +

    Pour un contrôle plus fin de la correspondance des URL, voir la + directive <ProxyMatch>.

    +
    +

    Voir aussi