From: Rich Bowen
Ce document décrit les fichiers utilisés pour configurer le Serveur HTTP Apache.
@@ -92,6 +90,48 @@ le Serveur HTTP Apache. sont aussi ignorées. les arguments de directive sont séparés par des blancs. Si un argument contient des espaces, il doit être entouré de guillemets. +Un argument qui contient des espaces doit être entouré de guillemets
+ doubles (") ou de guillemets simples ('). Les
+ guillemets eux-mêmes ne font pas partie de l’argument.
À l’intérieur d’une chaîne entre guillemets, seules deux séquences
+ d’échappement sont reconnues : \\ produit une controblique
+ littérale et \" (ou \' si la chaîne est entourée
+ de guillemets simples) produit un guillemet littéral sans terminer la
+ chaîne. Toutes les autres séquences avec controblique sont conservées telles
+ quelles — par exemple, \n sera considéré comme une chaîne
+ littéral de deux caractères \n, pas comme une nouvelle
+ ligne.
En dehors des guillemets, les controbliques n’ont aucune signification + spéciale et sont traitées comme des caractères littéraux. La seule exception + est la controblique de continuation de ligne en fin de ligne, comme décrit + ci-avant.
+ +Notez que des chaînes entre guillemets adjacentes sans espace entre elles + ne sont pas concaténées — elles sont traitées comme des + arguments séparés. Par exemple :
+ +
+ # Il ne s’agit pas d’un seul argument, mais de DEUX :
+ Header set X-Foo "arg1""arg2"
+
Certaines directives acceptent des arguments qui contiennent des
+ sous-expressions ayant leur propre syntaxe, telles que les drapeaux de la
+ directive RewriteRule ou les
+ expression ap_expr. Dans ces cas, l’interpréteur de
+ fichier de configuration enlève tout d’abord les guillemets englobants et
+ traite les séquences avec controblique comme décrit ci-avant, puis
+ l’interpréteur propre à la directive traite le résultat. En cas de doute,
+ utiliser des guillemets simples autour d’un argument qui contient des
+ controbliques peut éviter un double traitement inattendu des séquenses
+ d’échappement.
Les directives dans les fichiers de configuration ne sont pas sensibles à la casse, mais leurs arguments le sont souvent.
diff --git a/docs/manual/configuring.xml.meta b/docs/manual/configuring.xml.meta index 28796b60e2..e719482486 100644 --- a/docs/manual/configuring.xml.meta +++ b/docs/manual/configuring.xml.meta @@ -9,7 +9,7 @@Apache HTTPD prend en charge la négociation de
diff --git a/docs/manual/content-negotiation.xml.meta b/docs/manual/content-negotiation.xml.meta
index 5ebb3ced68..d9d19c5db3 100644
--- a/docs/manual/content-negotiation.xml.meta
+++ b/docs/manual/content-negotiation.xml.meta
@@ -8,7 +8,7 @@
Deux types de variables d'environnement affectent le serveur HTTP Apache.
@@ -174,6 +172,18 @@| Modules Apparentés | Directives Apparentées |
|---|---|
De nombreux exemples d’utilisation qui nécessitaient auparavant de
+ définir et tester des variables d’environnement — par exemple les en-têtes
+ conditionnels, le contrôle d’accès et la journalisation — peuvent
+ maintenant être traités de manière plus directe en utilisant les
+ expressions <If> avec la
+ fonction reqenv. Voir Les expressions
+ dans le serveur HTTP Apache pour la syntaxe des expressions et la
+ liste complète des variables disponibles.
Require
+ expr fournit une alternative qui permet d’évaluer des
+ variables d’environnement en utilisant la fonction reqenv
+ en combinaison avec d’autres propriétés de requête.
@@ -282,8 +296,14 @@
par la spécification de HTTP. Elles ont été plus largement adoptées et
constituent une méthode standard pour transmettre des informations entre le
navigateur et le serveur, et entre les processus au sein du serveur. Nous en
- décrivons quelques unes ici ; consultez la spécification de CGI pour
- plus de détails.
+ décrivons quelques unes ici. Pour une liste complète des variables de
+ requête disponibles dans les expressions (parmi
+ lesquelles REQUEST_URI, REMOTE_ADDR,
+ SERVER_NAME et de nombreuses autres), voir le document de
+ référence variables dans les expressions.
+
+ Consultez la spécification CGI pour plus de détails à propos des + métavariables CGI standard.
La variable PATH_INFO est définie avec toute valeur qui
+
La variable PATH_INFO est définie avec toute valeur qui
apparaît après une ressource correspondante à la fin de l'URL,
QUERY_STRING non comprise. Tout paraît plus clair avec un
exemple :
Disponible dans les versions postérieures à 2.0.54
-Quand Apache httpd génère une redirection en réponse à une requête client, la réponse inclut un texte destiné à être affiché au cas où le client ne suivrait pas, ou ne pourrait pas suivre automatiquement la redirection. @@ -525,6 +543,12 @@ propos des variables REDIRECT_ dans le contexte des documents d'erreur, voir Réponses aux erreurs personnalisées.
+Ce renommage est particulièrement pertinent lorsqu’on utilise le drapeau
+ [E] flag de
+ mod_rewrite pour définir des variables, car les réécritures
+ dans un contexte de répertoire déclenchent toujours une redirection interne.
+ Voir cette section pour des exemples et des solutions de contournement.
Historiquement, il existe de nombreuses variantes dans la syntaxe des expressions permettant d'exprimer une condition dans les @@ -52,7 +50,7 @@
Comparaison avec SSLRequire
Historique de version
Exemples d'expressionsIf<If><ElseIf><Else>ErrorDocumentAliasScriptAliasRedirectAuthBasicFakeAuthFormLoginRequiredLocationAuthFormLoginSuccessLocationAuthFormLogoutLocationAuthNameAuthTypeRewriteCondSetEnvIfExprHeaderRequestHeaderFilterProviderCryptoKeyCryptoIVSSLRequireLogMessagemod_includeIf<If><ElseIf><Else>ErrorDocumentAliasScriptAliasRedirectAuthBasicFakeAuthFormLoginRequiredLocationAuthFormLoginSuccessLocationAuthFormLogoutLocationAuthNameAuthTypeRewriteCondSetEnvIfExprHeaderRequestHeaderFilterProviderCryptoKeyCryptoIVSSLRequireLogMessagemod_include%{REMOTE_USER} ne sera pas encore définie à ce stade.
+ Pour des informations à propos de la définition et de la manipulation des
+ variables d’environnement de requête (en utilisant SetEnv, SetEnvIf, le drapeau [E=...]
+ de mod_rewrite's et d’autres directives), voir Variables d’environnement dans Apache httpd.
Les variables suivantes contiennent la valeur de l'en-tête de
requête HTTP correspondant. La fonction
req permet d'extraire les valeurs des autres
@@ -214,7 +216,10 @@ DIGIT ::= <any US-ASCII digit "0".."9">
REQUEST_SCHEMEREQUEST_URIDOCUMENT_URIREQUEST_URIREQUEST_FILENAMESCRIPT_GROUPPATH_INFOAcceptPathInfoQUERY_STRINGLa fonction reqenv permet de tester les variables d’environnement à utilisation spéciale
+ (telles que no-gzip, nokeepalive, etc.), ainsi que
+ toute variable définie à l’aide de SetEnv,
+ SetEnvIf ou mod_rewrite.
Lorsque les fonctions req ou http sont
utilisées, le nom d'en-tête sera automatiquement ajouté à l'en-tête
Vary de la réponse HTTP, sauf spécification contraire pour la
diff --git a/docs/manual/expr.xml.meta b/docs/manual/expr.xml.meta
index ea324a8bb2..d5a2e5e1a5 100644
--- a/docs/manual/expr.xml.meta
+++ b/docs/manual/expr.xml.meta
@@ -8,6 +8,6 @@
ÐдÑеÑа в ÐнÑеÑнеÑе запиÑÑваÑÑÑÑ Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ URL — Uniform Resource @@ -77,7 +77,7 @@ Locator (ÑниÑиÑиÑованнÑй ÑказаÑÐµÐ»Ñ ÑеÑÑÑÑа), ко
ÐÐ»Ñ Ñого ÑÑÐ¾Ð±Ñ ÑоединиÑÑÑÑ Ñ ÑеÑвеÑом, ÐºÐ»Ð¸ÐµÐ½Ñ ÑнаÑала должен пÑеобÑазоваÑÑ @@ -112,7 +112,7 @@ Locator (ÑниÑиÑиÑованнÑй ÑказаÑÐµÐ»Ñ ÑеÑÑÑÑа), ко DNS.
HTTP-ÑеÑÐ²ÐµÑ Apache наÑÑÑоен Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Ð¿ÑоÑÑÑÑ ÑекÑÑовÑÑ Ñайлов. @@ -161,7 +161,7 @@ HTTP-ÑеÑвеÑа Apache. ÐÑли Ð²Ñ ÑÑÑановили httpd из и
СодеÑжимое ÑайÑа Ð¼Ð¾Ð¶ÐµÑ Ð¿ÑинимаÑÑ ÑазлиÑнÑе ÑоÑмÑ, но в ÑиÑоком ÑмÑÑле @@ -200,7 +200,7 @@ CSS-ÑÐ°Ð¹Ð»Ñ Ð¸ дÑÑгие ÑайлÑ, коÑоÑÑе пÑоÑÑо лежа или ÑоÑÑÐ¼Ñ Ð¿Ð¾Ð´Ð´ÐµÑжки, где Ð²Ñ ÑможеÑе полÑÑиÑÑ Ð¾ÑвеÑÑ Ð½Ð° Ñвои вопÑоÑÑ.
ÐÐ»Ñ Ð²Ð°Ñ, как админиÑÑÑаÑоÑа HTTP-ÑеÑвеÑа Apache, ÑамÑе ÑеннÑе акÑÐ¸Ð²Ñ — ÑÑо ÑÐ°Ð¹Ð»Ñ Ð¶ÑÑналов (лог-ÑайлÑ), @@ -223,7 +223,7 @@ CSS-ÑÐ°Ð¹Ð»Ñ Ð¸ дÑÑгие ÑайлÑ, коÑоÑÑе пÑоÑÑо лежа докÑменÑаÑии о жÑÑÐ½Ð°Ð»Ð°Ñ .
ТепеÑÑ, когда Ð²Ñ Ð·Ð½Ð°ÐºÐ¾Ð¼Ñ Ñ Ð¾Ñновами, поÑа двигаÑÑÑÑ Ð´Ð°Ð»ÑÑе.
@@ -248,7 +248,7 @@ CSS-ÑÐ°Ð¹Ð»Ñ Ð¸ дÑÑгие ÑайлÑ, коÑоÑÑе пÑоÑÑо лежа ru