From b9dfdee7af522187fac9d0146600b3d1ad9c0544 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sat, 2 May 2015 16:39:20 +0000 Subject: [PATCH] XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1677332 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_authz_owner.xml.fr | 12 +- docs/manual/mod/mod_dialup.xml.fr | 10 +- docs/manual/mod/mod_example_hooks.xml.fr | 6 +- docs/manual/mod/mod_ext_filter.xml.fr | 10 +- docs/manual/mod/mod_log_debug.xml.fr | 8 +- docs/manual/mod/mod_proxy.xml.fr | 144 ++++++++++++----------- 6 files changed, 96 insertions(+), 94 deletions(-) diff --git a/docs/manual/mod/mod_authz_owner.xml.fr b/docs/manual/mod/mod_authz_owner.xml.fr index 46eeb818c8..7778b5419a 100644 --- a/docs/manual/mod/mod_authz_owner.xml.fr +++ b/docs/manual/mod/mod_authz_owner.xml.fr @@ -1,7 +1,7 @@ - + @@ -98,11 +98,11 @@ d'Apache smith.

-<Directory /home/*/public_html/private> +<Directory "/home/*/public_html/private"> AuthType Basic AuthName MyPrivateFiles AuthBasicProvider dbm - AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all + AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all" Require file-owner </Directory> @@ -123,14 +123,14 @@ d'Apache répertoires project-foo de chacun d'entre eux.

-<Directory /home/*/public_html/project-foo> +<Directory "/home/*/public_html/project-foo"> AuthType Basic AuthName "Project Foo Files" AuthBasicProvider dbm # combined user/group database - AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all - AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all + AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all" + AuthDBMGroupFile "/usr/local/apache2/etc/.htdbm-all" Satisfy All Require file-group diff --git a/docs/manual/mod/mod_dialup.xml.fr b/docs/manual/mod/mod_dialup.xml.fr index 1c856a1cd0..23a8114cd0 100644 --- a/docs/manual/mod/mod_dialup.xml.fr +++ b/docs/manual/mod/mod_dialup.xml.fr @@ -1,7 +1,7 @@ - + @@ -41,8 +41,8 @@ modems. Ainsi, il est possible de naviguer sur votre site avec un modem 56k V.92 en positionnant une configuration de ce type :

-<Location /mysite> - ModemStandard V.92 +<Location "/mysite"> + ModemStandard "V.92" </Location> @@ -67,8 +67,8 @@ client.

souhaitez simuler.

-<Location /mysite> - ModemStandard V.26bis +<Location "/mysite"> + ModemStandard "V.26bis" </Location> diff --git a/docs/manual/mod/mod_example_hooks.xml.fr b/docs/manual/mod/mod_example_hooks.xml.fr index a92084be40..aa176bb32e 100644 --- a/docs/manual/mod/mod_example_hooks.xml.fr +++ b/docs/manual/mod/mod_example_hooks.xml.fr @@ -1,7 +1,7 @@ - + @@ -110,7 +110,7 @@

Pour activer le module example_hooks, ajoutez à votre fichier httpd.conf un bloc du style :

-<Location /example-hooks-info> +<Location "/example-hooks-info"> SetHandler example-hooks-handler </Location> @@ -121,7 +121,7 @@ correspondant :

- AddHandler example-hooks-handler .example + AddHandler example-hooks-handler ".example"

Après avoir rechargé la configuration ou redémarré votre serveur, diff --git a/docs/manual/mod/mod_ext_filter.xml.fr b/docs/manual/mod/mod_ext_filter.xml.fr index eed372d268..d9f58eeed2 100644 --- a/docs/manual/mod/mod_ext_filter.xml.fr +++ b/docs/manual/mod/mod_ext_filter.xml.fr @@ -1,7 +1,7 @@ - + @@ -98,7 +98,7 @@ ExtFilterDefine c-to-html mode=output \ # la directive de mod_ext_filter qui définit le filtre externe ExtFilterDefine gzip mode=output cmd=/bin/gzip -<Location /gzipped> +<Location "/gzipped"> # directive de base permettant de traiter la sortie avec le # filtre gzip @@ -122,7 +122,7 @@ ExtFilterDefine gzip mode=output cmd=/bin/gzip ExtFilterDefine slowdown mode=output cmd=/bin/cat \ preservescontentlength -<Location /> +<Location "/"> # directive de base permettant de traiter plusieurs fois la # sortie avec le filtre slowdown # @@ -141,7 +141,7 @@ ExtFilterDefine slowdown mode=output cmd=/bin/cat \ ExtFilterDefine fixtext mode=output intype=text/html \ cmd="/bin/sed s/verdana/arial/g" -<Location /> +<Location "/"> # directive de base permettant de traiter la sortie avec le # filtre fixtext SetOutputFilter fixtext @@ -177,7 +177,7 @@ ExtFilterDefine traceafter \ cmd="/bin/tracefilter.pl /tmp/traceafter" \ EnableEnv=trace_this_client ftype=21 -<Directory /usr/local/docs> +<Directory "/usr/local/docs"> SetEnvIf Remote_Addr 192.168.1.31 trace_this_client SetOutputFilter tracebefore;deflate;traceafter </Directory> diff --git a/docs/manual/mod/mod_log_debug.xml.fr b/docs/manual/mod/mod_log_debug.xml.fr index fb0a120976..641bdf3dc2 100644 --- a/docs/manual/mod/mod_log_debug.xml.fr +++ b/docs/manual/mod/mod_log_debug.xml.fr @@ -1,7 +1,7 @@ - + @@ -39,7 +39,7 @@ /foo/* : -<Location /foo/> +<Location "/foo/">   LogMessage "/foo/ has been requested" </Location> @@ -49,7 +49,7 @@ Enregistre un message si une requête pour /foo/* est traitée dans une sous-requête : -<Location /foo/> +<Location "/foo/">   LogMessage "subrequest to /foo/" hook=type_checker expr=%{IS_SUBREQ} </Location> @@ -74,7 +74,7 @@ Enregistre la valeur de la variable d'environnement de requête "X-Foo" à chaque étape du traitement : -<Location /> +<Location "/">   LogMessage "%{reqenv:X-Foo}" hook=all </Location> diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index 3679ebfc01..17709639cc 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -168,8 +168,8 @@ Mandataire inverse -ProxyPass /foo http://foo.example.com/bar -ProxyPassReverse /foo http://foo.example.com/bar +ProxyPass "/foo" "http://foo.example.com/bar" +ProxyPassReverse "/foo" "http://foo.example.com/bar" @@ -178,7 +178,7 @@ ProxyPassReverse /foo http://foo.example.com/bar ProxyRequests On ProxyVia On -<Proxy *> +<Proxy "*"> Require host internal.example.com </Proxy> @@ -196,7 +196,7 @@ ProxyVia On Scripts PHP et mandataire inverse -<FilesMatch \.php$> +<FilesMatch "\.php$"> # Les sockets Unix nécessitent une version 2.4.7 ou supérieure du # serveur HTTP Apache SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/" @@ -233,7 +233,7 @@ ProxyVia On - ProxyPass /example http://backend.example.com connectiontimeout=5 timeout=30 + ProxyPass "/example" "http://backend.example.com" connectiontimeout=5 timeout=30 @@ -246,7 +246,7 @@ ProxyVia On - ProxySet http://backend.example.com connectiontimeout=5 timeout=30 + ProxySet "http://backend.example.com" connectiontimeout=5 timeout=30 @@ -256,7 +256,7 @@ ProxyVia On module="mod_proxy">ProxySet :

-<Proxy http://backend.example.com> +<Proxy "http://backend.example.com"> ProxySet connectiontimeout=5 timeout=30 </Proxy> @@ -279,8 +279,8 @@ ProxyVia On original, y compris un éventuel chemin donné :

-ProxyPass /examples http://backend.example.com/examples -ProxyPass /docs http://backend.example.com/docs +ProxyPass "/examples" "http://backend.example.com/examples" +ProxyPass "/docs" "http://backend.example.com/docs"

Dans cet exemple, deux workers différents sont définis, chacun @@ -294,8 +294,8 @@ ProxyPass /docs http://backend.example.com/docs dans le fichier de configuration. Dans l'exemple suivant,

-ProxyPass /apps http://backend.example.com/ timeout=60 -ProxyPass /examples http://backend.example.com/examples timeout=10 +ProxyPass "/apps" "http://backend.example.com/" timeout=60 +ProxyPass "/examples" "http://backend.example.com/examples" timeout=10

le second worker n'est pas vraiment créé. C'est le premier @@ -354,7 +354,7 @@ ProxyPass /examples http://backend.example.com/examples timeout=10 l'exemple suivant :

-<Proxy *> +<Proxy "*"> Require ip 192.168.0 </Proxy> @@ -433,8 +433,8 @@ ProxyPass /examples http://backend.example.com/examples timeout=10 proxy-nokeepalive.

-<Location /buggyappserver/> - ProxyPass http://buggyappserver:7001/foo/ +<Location "/buggyappserver/"> + ProxyPass "http://buggyappserver:7001/foo/" SetEnv force-proxy-request-1.0 1 SetEnv proxy-nokeepalive 1 </Location> @@ -538,7 +538,7 @@ mandatées votre-reseau.example.com :

-<Proxy *> +<Proxy "*"> Require host votre-reseau.example.com </Proxy> @@ -549,7 +549,7 @@ mandatées l'intermédiaire du serveur mandataire :

-<Proxy http://example.com/foo/*> +<Proxy "http://example.com/foo/*"> SetOutputFilter INCLUDES </Proxy> @@ -559,7 +559,7 @@ mandatées 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"> 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 nommés.

-<ProxyMatch ^http://(?<sitename>[^/]+)> +<ProxyMatch "^http://(?<sitename>[^/]+)"> Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </ProxyMatch> @@ -736,9 +736,10 @@ requêtes Exemple -ProxyRemote http://goodguys.example.com/ http://mirrorguys.example.com:8000 -ProxyRemote * http://cleverproxy.localdomain -ProxyRemote ftp http://ftpproxy.mydomain:8080 +ProxyRemote "http://goodguys.example.com/" +"http://mirrorguys.example.com:8000" +ProxyRemote "*" "http://cleverproxy.localdomain" +ProxyRemote "ftp" "http://ftpproxy.mydomain:8080" @@ -910,26 +911,26 @@ du serveur HTTP Apache. -<Proxy balancer://hotcluster> - BalancerMember http://www2.example.com:8080 loadfactor=1 - BalancerMember http://www3.example.com:8080 loadfactor=2 +<Proxy "balancer://hotcluster"> + BalancerMember "http://www2.example.com:8080" loadfactor=1 + BalancerMember "http://www3.example.com:8080" loadfactor=2 ProxySet lbmethod=bytraffic </Proxy> -<Proxy http://backend> +<Proxy "http://backend"> ProxySet keepalive=On </Proxy> - ProxySet balancer://foo lbmethod=bytraffic timeout=15 + ProxySet "balancer://foo" lbmethod=bytraffic timeout=15 - ProxySet ajp://backend:7001 timeout=15 + ProxySet "ajp://backend:7001" timeout=15 Avertissement @@ -988,8 +989,8 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache http://example.com/ ; alors la ligne

-<Location /mirror/foo/> - ProxyPass http://backend.example.com/ +<Location "/mirror/foo/"> + ProxyPass "http://backend.example.com/" </Location> @@ -1004,7 +1005,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache href="mod_proxy_balancer.html#balancer_manager">Balancer Manager :

- ProxyPass /miroir/foo/ http://backend.example.com/ + ProxyPass "/miroir/foo/" "http://backend.example.com/" @@ -1020,17 +1021,17 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache du mandat inverse, comme dans l'exemple suivant :

-<Location /mirror/foo/> - ProxyPass http://backend.example.com/ +<Location "/mirror/foo/"> + ProxyPass "http://backend.example.com/" </Location> -<Location /mirror/foo/i> - ProxyPass ! +<Location "/mirror/foo/i"> + ProxyPass "!" </Location> -ProxyPass /mirror/foo/i ! -ProxyPass /mirror/foo http://backend.example.com +ProxyPass "/mirror/foo/i" "!" +ProxyPass "/mirror/foo" "http://backend.example.com"

va mandater toutes les requêtes pour /miroir/foo @@ -1089,7 +1090,7 @@ ProxyPass /mirror/foo http://backend.example.com Exemple - ProxyPass /example http://backend.example.com max=20 ttl=120 retry=300 + ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300 @@ -1431,25 +1432,25 @@ ProxyPass /mirror/foo http://backend.example.com

Exemple de configuration d'un répartiteur de charge

-ProxyPass /special-area http://special.example.com smax=5 max=10 -ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On -<Proxy balancer://mycluster> - BalancerMember ajp://1.2.3.4:8009 - BalancerMember ajp://1.2.3.5:8009 loadfactor=20 +ProxyPass "/special-area" "http://special.example.com" smax=5 max=10 +ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On +<Proxy "balancer://mycluster"> + BalancerMember "ajp://1.2.3.4:8009" + BalancerMember "ajp://1.2.3.5:8009" loadfactor=20 # Less powerful server, don't send as many requests there, - BalancerMember ajp://1.2.3.6:8009 loadfactor=5 + BalancerMember "ajp://1.2.3.6:8009" loadfactor=5 </Proxy>

Configuration d'un serveur cible de réserve qui ne sera utilisé que si aucun autre serveur cible n'est disponible

-ProxyPass / balancer://hotcluster/ -<Proxy balancer://hotcluster> - BalancerMember ajp://1.2.3.4:8009 loadfactor=1 - BalancerMember ajp://1.2.3.5:8009 loadfactor=2 +ProxyPass "/" "balancer://hotcluster/" +<Proxy "balancer://hotcluster"> + BalancerMember "ajp://1.2.3.4:8009" loadfactor=1 + BalancerMember "ajp://1.2.3.5:8009" loadfactor=2 # The server below is on hot standby - BalancerMember ajp://1.2.3.6:8009 status=+H + BalancerMember "ajp://1.2.3.6:8009" status=+H ProxySet lbmethod=bytraffic </Proxy> @@ -1505,14 +1506,14 @@ ProxyPass / balancer://hotcluster/ RewriteEngine On -RewriteCond %{HTTPS} =off -RewriteRule . - [E=protocol:http] -RewriteCond %{HTTPS} =on -RewriteRule . - [E=protocol:https] +RewriteCond "%{HTTPS}" =off +RewriteRule "". "-" [E=protocol:http] +RewriteCond "%{HTTPS}" =on +RewriteRule "." "-" [E=protocol:https] -RewriteRule ^/mirror/foo/(.*) %{ENV:protocol}://backend.example.com/$1 [P] -ProxyPassReverse /mirror/foo/ http://backend.example.com/ -ProxyPassReverse /mirror/foo/ https://backend.example.com/ +RewriteRule "^/mirror/foo/(.*)" "%{ENV:protocol}://backend.example.com/$1" [P] +ProxyPassReverse "/mirror/foo/" "http://backend.example.com/" +ProxyPassReverse "/mirror/foo/" "https://backend.example.com/" @@ -1545,7 +1546,7 @@ du serveur local en utilisant des expressions rationnelles http://example.com/ ; alors

- ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com/$1 + ProxyPassMatch "^(/.*\.gif)$" "http://backend.example.com/$1"

va provoquer la conversion interne de la requête locale @@ -1558,14 +1559,15 @@ du serveur local en utilisant des expressions rationnelles doit aussi l'être après). Ceci limite les correspondances que vous pouvez utiliser. Par exemple, si l'on avait utilisé

- ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com:8000$1 + ProxyPassMatch "^(/.*\.gif)$" + "http://backend.example.com:8000$1"

dans l'exemple précédent, nous aurions provoqué une erreur de syntaxe au démarrage du serveur. C'est une bogue (PR 46665 dans ASF bugzilla), et il est possible de la contourner en reformulant la correspondance :

- ProxyPassMatch ^/(.*\.gif)$ http://backend.example.com:8000/$1 + ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com:8000/$1" @@ -1641,10 +1643,10 @@ par un serveur mandaté en inverse http://example.com/ ; alors

-ProxyPass /mirror/foo/ http://backend.example.com/ -ProxyPassReverse /mirror/foo/ http://backend.example.com/ -ProxyPassReverseCookieDomain backend.example.com public.example.com -ProxyPassReverseCookiePath / /mirror/foo/ +ProxyPass "/mirror/foo/" "http://backend.example.com/" +ProxyPassReverse "/mirror/foo/" "http://backend.example.com/" +ProxyPassReverseCookieDomain "backend.example.com" "public.example.com" +ProxyPassReverseCookiePath "/" "/mirror/foo/"

ne va pas seulement provoquer la conversion interne d'une requête @@ -1738,7 +1740,7 @@ Dans l'exemple fourni avec la directive ProxyPassReverse, la directive :

- ProxyPassReverseCookiePath / /mirror/foo/ + ProxyPassReverseCookiePath "/" "/mirror/foo/"

va réécrire un cookie possédant un chemin d'arrière-plan / @@ -1771,7 +1773,7 @@ mandataire Exemple - ProxyBlock news.example.com auctions.example.com friends.example.com + ProxyBlock "news.example.com" "auctions.example.com" "friends.example.com" @@ -1783,7 +1785,7 @@ mandataire

Notez aussi que

- ProxyBlock * + ProxyBlock "*"

bloque les connexions vers tous les sites.

@@ -1907,8 +1909,8 @@ directement Exemple -ProxyRemote * http://firewall.example.com:81 -NoProxy .example.com 192.168.112.0/21 +ProxyRemote "*" "http://firewall.example.com:81" +NoProxy ".example.com" "192.168.112.0/21" @@ -2072,9 +2074,9 @@ mandatées Exemple - ProxyRemote * http://firewall.example.com:81
- NoProxy .example.com 192.168.112.0/21
- ProxyDomain .example.com + ProxyRemote "*" "http://firewall.example.com:81"
+ NoProxy ".example.com" "192.168.112.0/21"
+ ProxyDomain ".example.com" -- 2.40.0