From: Lucien Gentis Date: Sun, 26 Mar 2017 13:16:38 +0000 (+0000) Subject: XML updates. X-Git-Tag: 2.4.26~216 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=003700ca0be8235b8f0fac87782cacd83474066a;p=apache XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1788729 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index d3d06bfee7..974db78858 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ - + @@ -2373,6 +2373,15 @@ host directives qui supportent le contexte de répertoire.

+ Ce n'est pas un langage de scripting + Le nom de cette directive peut sembler très familier aux programmeurs et + administrateurs, mais il ne doit pas être confondu avec son homonyme des langages de + scripting. A ce titre, l'implémentation actuelle n'envisage pas la + possibilité d'imbriquer une section If + dans une autre (la section If qui se + trouve à l'intérieure de l'autre serait ignorée). + + Certain variables, such as CONTENT_TYPE and other response headers, are set after <If> conditions have already diff --git a/docs/manual/mod/mod_proxy_fcgi.xml.fr b/docs/manual/mod/mod_proxy_fcgi.xml.fr index a5a4ce15a8..31991b518d 100644 --- a/docs/manual/mod/mod_proxy_fcgi.xml.fr +++ b/docs/manual/mod/mod_proxy_fcgi.xml.fr @@ -1,7 +1,7 @@ - + @@ -211,4 +211,126 @@ ProxyPass "/myapp/" "balancer://myappcluster/" + +ProxyFCGIBackendType +Spécifie le type de l'application FastCGI d'arrière-plan +ProxyFCGIBackendType FPM|GENERIC +ProxyFCGIBackendType FPM +server config +virtual hostdirectory +.htaccess +Disponible à partir de la version 2.4.26 du serveur HTTP Apache + + +

Cette directive permet de spécifier le type de l'application FastCGI +d'arrière-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de manière +historique des variables d'environnement exotiques pour identifier le type du +serveur mandataire utilisé. Définissez cette directive à "GENERIC" si votre +application n'est pas de type PHP-FPM et n'interpréter pas correctement des +variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles +qu'elles sont définies par le serveur.

+ +

SCRIPT_FILENAME est un exemple de valeur modifiée par la définition de cette +directive. Historiquement, lorsqu'on utilisait le module +mod_proxy_fcgi, SCRIPT_FILENAME était préfixé par la chaîne +"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI +génériques en tant que valeur en entrée pour leur script ; cependant, PHP-FPM +peut supprimer le préfixe, puis garder en mémoire qu'il communique avec Apache. +Avec les versions 2.4.21 à 2.4.25, ce préfixe était automatiquement supprimé par +le serveur, empêchant ainsi PHP-FPM de détecter et interopérer avec Apache dans +certains scénarios.

+ + + + +ProxyFCGISetEnvIf +Permet d'adapter la valeur des variables envoyées aux serveurs +FastCGI +ProxyFCGISetEnvIf conditional-expression + [!]environment-variable-name + [value-expression] +server config +virtual hostdirectory +.htaccess +Disponible à partir de la version 2.4.26 du serveur HTTP Apache. + + +

Juste avant la transmission d'une requête au serveur FastCGI configuré, le +coeur du programme du serveur web définit un certain nombre de variables +d'environnement en fonction de certains détails de la requête considérée. Les +programmes FastCGI utilisent souvent ces variables comme données en entrée afin +de déterminer quels scripts sous-jacents ils vont exécuter, ou quelles données +en sortie doivent être produites.

+

Voici quelques exemples de variables d'environnement importantes :

+
    +
  • SCRIPT_NAME
    • +
  • SCRIPT_FILENAME
    • +
  • REQUEST_URI
    • +
  • PATH_INFO
    • +
  • PATH_TRANSLATED
    • +
+ +

Cette directive permet de passer outre les variables d'environnement +ci-dessus, entre autres. Elle est évaluée après la définition de la valeur +initiale de ces variables ; elle peuvent donc être utilisées comme entrées dans +les expressions définissants les conditions et les valeurs.

+

Syntaxe des paramètres :

+
+
conditional-expression
+
Définit une condition en fonction de laquelle la +variable d'environnement qui suit sera modifiée ou non. Pour la syntaxe de cette +expression, reportez-vous aux exemples qui suivent ou à la spécification +détaillée dans le document ap_expr. +
+
environment-variable-name
+
Spécifie le nom de la variable d'environnement à modifier, par exemple +PATH_INFO. Si elle est précédée d'un point d'exclamation, la définition de la +variable sera annulée.
+
value-expression
+
Spécifie la nouvelle valeur de la variable "environment-variable-name". On +peut inclure des +références arrières, comme "$1", issues de captures en provenance de +l'expression rationnelle conditional-expression. Si cette valeur est +omise, la variable est définie (ou sa valeur est écrasée) par une chaîne vide +— voir cependant la note ci-après.
+
+ + + +# Une modification basique, inconditionnelle +ProxyFCGISetEnvIf "true" PATH_INFO "/example" + +# Utilisation d'une variable d'environnement pour spécifier la nouvelle valeur +ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}" +
+# Utilisation de captures dans la condition et de références arrières dans la +# nouvelle valeur +ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3" + + + +Note : Annulation définition ou valeur vide + La ligne suivante annule la définition de la variable VARIABLE, + ce qui l'empêche d'être envoyée au serveur FastCGI : + + ProxyFCGISetEnvIf true !VARIABLE + + La ligne suivante, quant à elle, efface la valeur de la variable + VARIABLE en lui affectant la chaîne vide ; cette variable + VARIABLE sera alors tout de même envoyée au serveur FastCGI : + + ProxyFCGISetEnvIf true VARIABLE + + La spécification CGI/1.1 ne fait pas de + distinction entre une variable contenant une chaîne vide et une variable qui + n'existe pas. De nombreuses implémentations CGI et FastCGI font cependant + cette distinction (ou permettent aux scripts de la faire). Le choix de celle + que vous allez utiliser dépend de votre implémentation et de la raison qui + vous pousse à modifier cette variable. + + + + + diff --git a/docs/manual/sections.xml.fr b/docs/manual/sections.xml.fr index 8a6e5a9e6b..33f6ca5802 100644 --- a/docs/manual/sections.xml.fr +++ b/docs/manual/sections.xml.fr @@ -3,7 +3,7 @@ - +