From 50749c03dc4c30241bd4633a3c9d334d465d3f2a Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sun, 3 May 2015 16:34:52 +0000 Subject: [PATCH] XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1677446 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_auth_form.xml.fr | 34 ++++++++++++------------ docs/manual/mod/mod_dir.xml.fr | 14 +++++----- docs/manual/mod/mod_filter.xml.fr | 6 ++--- docs/manual/mod/mod_macro.xml.fr | 18 ++++++------- docs/manual/mod/mod_proxy_ajp.xml.fr | 14 +++++----- docs/manual/mod/mod_rewrite.xml.fr | 37 ++++++++++++++------------- docs/manual/mod/mod_session.xml.fr | 4 +-- docs/manual/mod/mod_substitute.xml.fr | 18 ++++++------- 8 files changed, 73 insertions(+), 72 deletions(-) diff --git a/docs/manual/mod/mod_auth_form.xml.fr b/docs/manual/mod/mod_auth_form.xml.fr index 458e8d7931..0cfb5fdf5e 100644 --- a/docs/manual/mod/mod_auth_form.xml.fr +++ b/docs/manual/mod/mod_auth_form.xml.fr @@ -1,7 +1,7 @@ - + @@ -86,10 +86,10 @@ l'authentification Exemple simple AuthFormProvider file -AuthUserFile conf/passwd +AuthUserFile "conf/passwd" AuthType form AuthName realm -AuthFormLoginRequiredLocation http://example.com/login.html +AuthFormLoginRequiredLocation "http://example.com/login.html" Session On SessionCookieName session path=/ SessionCryptoPassphrase secret @@ -154,12 +154,12 @@ SessionCryptoPassphrase secret Exemple de configuration du gestionnaire de formulaire de connexion -<Location /dologin.html> +<Location "/dologin.html"> SetHandler form-login-handler - AuthFormLoginRequiredLocation http://example.com/login.html - AuthFormLoginSuccessLocation http://example.com/success.html + AuthFormLoginRequiredLocation "http://example.com/login.html" + AuthFormLoginSuccessLocation "http://example.com/success.html" AuthFormProvider file - AuthUserFile conf/passwd + AuthUserFile "conf/passwd" AuthType form AuthName realm Session On @@ -236,11 +236,11 @@ SessionCryptoPassphrase secret Exemple simple d'authentification à la volée AuthFormProvider file -ErrorDocument 401 /login.shtml -AuthUserFile conf/passwd +ErrorDocument 401 "/login.shtml" +AuthUserFile "conf/passwd" AuthType form AuthName realm -AuthFormLoginRequiredLocation http://example.com/login.html +AuthFormLoginRequiredLocation "http://example.com/login.html" Session On SessionCookieName session path=/ SessionCryptoPassphrase secret @@ -327,7 +327,7 @@ SessionCryptoPassphrase secret Exemple avec script CGI AuthFormProvider file - ErrorDocument 401 /cgi-bin/login.cgi + ErrorDocument 401 "/cgi-bin/login.cgi" ... @@ -355,7 +355,7 @@ SessionCryptoPassphrase secret SetHandler form-logout-handler AuthName realm -AuthFormLogoutLocation http://example.com/loggedout.html +AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionCookieName session path=/ SessionCryptoPassphrase secret @@ -377,7 +377,7 @@ SessionCryptoPassphrase secret limitée SetHandler form-logout-handler -AuthFormLogoutLocation http://example.com/loggedout.html +AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionMaxAge 1 SessionCookieName session path=/ @@ -418,12 +418,12 @@ zone concernée Exemple -<Location /secure> +<Location "/secure"> AuthType form AuthName "private area" AuthFormProvider dbm AuthDBMType SDBM - AuthDBMUserFile /www/etc/dbmpasswd + AuthDBMUserFile "/www/etc/dbmpasswd" Require valid-user #... </Location> @@ -742,9 +742,9 @@ depuis la version 2.4.4. Exemple -<Location /logout> +<Location "/logout"> SetHandler form-logout-handler - AuthFormLogoutLocation http://example.com/loggedout.html + AuthFormLogoutLocation "http://example.com/loggedout.html" Session on #... </Location> diff --git a/docs/manual/mod/mod_dir.xml.fr b/docs/manual/mod/mod_dir.xml.fr index ebecb9737e..8204df021c 100644 --- a/docs/manual/mod/mod_dir.xml.fr +++ b/docs/manual/mod/mod_dir.xml.fr @@ -1,7 +1,7 @@ - + @@ -115,19 +115,19 @@ client envoie une requête pour un répertoire

# Exemple A: Positionner index.html en page d'index, puis ajouter index.php. -<Directory /foo> +<Directory "/foo"> DirectoryIndex index.html DirectoryIndex index.php </Directory> # Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive. -<Directory /foo> +<Directory "/foo"> DirectoryIndex index.html index.php </Directory> # Exemple C: Pour remplacer la liste des ressources, il faut d'abord la vider : # Ici, seul index.php restera référencé comme ressource d'index. -<Directory /foo> +<Directory "/foo"> DirectoryIndex index.html DirectoryIndex disabled DirectoryIndex index.php @@ -227,7 +227,7 @@ host # voir l'avertissement de sécurité ci-dessous ! -<Location /some/path> +<Location "/some/path"> DirectorySlash Off SetHandler some-handler </Location> @@ -296,10 +296,10 @@ de la version 2.4.4 du serveur HTTP Apache. http://example.com/blog/, cet URI intermédiaire doit être spécifié en tant que url-locale :

-<Directory /web/example.com/htdocs/blog> +<Directory "/web/example.com/htdocs/blog"> FallbackResource /blog/index.php </Directory> -<Directory /web/example.com/htdocs/blog/images> +<Directory "/web/example.com/htdocs/blog/images"> FallbackResource disabled </Directory> diff --git a/docs/manual/mod/mod_filter.xml.fr b/docs/manual/mod/mod_filter.xml.fr index 2960717157..7b05f2690f 100644 --- a/docs/manual/mod/mod_filter.xml.fr +++ b/docs/manual/mod/mod_filter.xml.fr @@ -1,7 +1,7 @@ - + @@ -230,7 +230,7 @@ FilterProtocol downsample "change=yes" FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'" FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'" FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'" -<Location /image-filter> +<Location "/image-filter"> FilterChain unpack downsample repack </Location> @@ -327,7 +327,7 @@ particulier DEFLATE.

-<Location /cgi-bin/> +<Location "/cgi-bin/"> Options Includes AddOutputFilterByType INCLUDES;DEFLATE text/html </Location> diff --git a/docs/manual/mod/mod_macro.xml.fr b/docs/manual/mod/mod_macro.xml.fr index 46af042233..cf238325b4 100644 --- a/docs/manual/mod/mod_macro.xml.fr +++ b/docs/manual/mod/mod_macro.xml.fr @@ -1,7 +1,7 @@ - + @@ -58,9 +58,9 @@ définir de nombreux serveurs virtuels similaires :

ServerName $domain ServerAlias www.$domain - DocumentRoot /var/www/vhosts/$name - ErrorLog /var/log/httpd/$name.error_log - CustomLog /var/log/httpd/$name.access_log combined + DocumentRoot "/var/www/vhosts/$name" + ErrorLog "/var/log/httpd/$name.error_log" + CustomLog "/var/log/httpd/$name.access_log" combined </VirtualHost> </Macro> @@ -121,7 +121,7 @@ de l'entourer d'accolades afin d'éviter toute confusion :

<Macro DocRoot ${docroot}> - DocumentRoot /var/www/${docroot}/htdocs + DocumentRoot "/var/www/${docroot}/htdocs" </Macro> @@ -144,15 +144,15 @@ création dynamique de serveurs virtuels.

<VirtualHost *:$port> ServerName $host - DocumentRoot $dir + DocumentRoot "$dir" # Racine des documents publique - <Directory $dir> + <Directory "$dir"> Require all granted </Directory> # restriction d'accès au sous-répertoire intranet. - <Directory $dir/intranet> + <Directory "$dir/intranet"> Require ip 10.0.0.0/8 </Directory> </VirtualHost> @@ -176,7 +176,7 @@ variables peuvent survenir.

<Macro DirGroup $dir $group> - <Directory $dir> + <Directory "$dir"> Require group $group </Directory> </Macro> diff --git a/docs/manual/mod/mod_proxy_ajp.xml.fr b/docs/manual/mod/mod_proxy_ajp.xml.fr index 773c4fb8c1..2ff64ebc33 100644 --- a/docs/manual/mod/mod_proxy_ajp.xml.fr +++ b/docs/manual/mod/mod_proxy_ajp.xml.fr @@ -1,7 +1,7 @@ - + @@ -62,7 +62,7 @@ d'environnement Mandataire inverse simple - ProxyPass /app ajp://backend.example.com:8009/app + ProxyPass "/app ajp://backend.example.com:8009/app" @@ -70,11 +70,11 @@ d'environnement Mandataire inverse avec répartiteur de charge <Proxy balancer://cluster> - BalancerMember ajp://app1.example.com:8009 loadfactor=1 - BalancerMember ajp://app2.example.com:8009 loadfactor=2 + BalancerMember "ajp://app1.example.com:8009" loadfactor=1 + BalancerMember "ajp://app2.example.com:8009" loadfactor=2 ProxySet lbmethod=bytraffic </Proxy> -ProxyPass /app balancer://cluster/app +ProxyPass "/app" "balancer://cluster/app" @@ -94,8 +94,8 @@ ProxyPass /app balancer://cluster/app ; par exemple :

Réécriture d'un chemin mandaté -ProxyPass /apps/foo ajp://backend.example.com:8009/foo -ProxyPassReverse /apps/foo http://www.example.com/foo +ProxyPass "/apps/foo" "ajp://backend.example.com:8009/foo" +ProxyPassReverse "/apps/foo" "http://www.example.com/foo"

Il est cependant préférable en général de déployer l'application diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr index 5a9a64f4e6..fdc512c739 100644 --- a/docs/manual/mod/mod_rewrite.xml.fr +++ b/docs/manual/mod/mod_rewrite.xml.fr @@ -1,7 +1,7 @@ - + @@ -365,14 +365,14 @@ recherche de mots-clés RewriteMap comme suit

- RewriteMap map-exemple txt:/chemin/vers/fichier/map.txt + RewriteMap "map-exemple" "txt:/chemin/vers/fichier/map.txt"

Vous pourrez ensuite utiliser cette table dans une directive RewriteRule comme suit :

- RewriteRule ^/ex/(.*) ${map-exemple:$1} + RewriteRule "^/ex/(.*)" "${map-exemple:$1}"

Les combinaisons suivantes pour type de correspondance @@ -463,12 +463,12 @@ de configuration aurait conduit le serveur à rechercher un réperto "opt" à la racine des documents.

-DocumentRoot /var/www/example.com -AliasMatch ^/myapp /opt/myapp-1.2.3 -<Directory /opt/myapp-1.2.3> +DocumentRoot "/var/www/example.com" +AliasMatch "^/myapp" "/opt/myapp-1.2.3" +<Directory "/opt/myapp-1.2.3"> RewriteEngine On RewriteBase /myapp/ - RewriteRule ^index\.html$ welcome.html + RewriteRule "^index\.html$" "welcome.html" </Directory> @@ -1007,7 +1007,7 @@ la réécriture soit effectuée RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
- RewriteRule ^/images - [F] + RewriteRule "^/images" "-" [F] @@ -1037,9 +1037,9 @@ la réécriture soit effectuée lieu du AND implicite. Exemple typique : -RewriteCond %{REMOTE_HOST} ^host1 [OR] -RewriteCond %{REMOTE_HOST} ^host2 [OR] -RewriteCond %{REMOTE_HOST} ^host3 +RewriteCond "%{REMOTE_HOST}" "^host1" [OR] +RewriteCond "%{REMOTE_HOST}" "^host2" [OR] +RewriteCond "%{REMOTE_HOST}" "^host3" RewriteRule ...règles concernant tous ces hôtes... @@ -1068,10 +1068,10 @@ RewriteRule ...règles concernant tous ces hôtes... pouvez utiliser ce qui suit :

-RewriteCond %{HTTP_USER_AGENT} (iPhone|Blackberry|Android) -RewriteRule ^/$ /homepage.mobile.html [L] +RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)" +RewriteRule "^/$" "/homepage.mobile.html" [L] -RewriteRule ^/$ /homepage.std.html [L] +RewriteRule "^/$" "/homepage.std.html" [L]

Explications : si vous utilisez un navigateur @@ -1107,10 +1107,11 @@ RewriteRule ^/$ /homepage.std.html [L] expression rationnelle compatible perl. Dans la première règle de réécriture, l'expression est comparée au (%-decoded) - chemin de l'URL (ou au - chemin fichier, en - fonction du contexte) de la - requête. Les expressions suivantes sont comparées à la sortie de + chemin de l'URL de la + requête, ou, dans un contexte de répertoire (voir + ci-dessous), au chemin de l'URL relativement à ce contexte de + répertoire. + Les expressions suivantes sont comparées à la sortie de la dernière règle de réécriture qui correspondait.

diff --git a/docs/manual/mod/mod_session.xml.fr b/docs/manual/mod/mod_session.xml.fr index e37168306d..c4bf602c99 100644 --- a/docs/manual/mod/mod_session.xml.fr +++ b/docs/manual/mod/mod_session.xml.fr @@ -1,7 +1,7 @@ - + @@ -301,7 +301,7 @@ Session On SessionCryptoPassphrase secret SessionCookieName session path=/ AuthFormProvider file -AuthUserFile conf/passwd +AuthUserFile "conf/passwd" AuthType form AuthName realm #... diff --git a/docs/manual/mod/mod_substitute.xml.fr b/docs/manual/mod/mod_substitute.xml.fr index e4613b307f..bee752c56a 100644 --- a/docs/manual/mod/mod_substitute.xml.fr +++ b/docs/manual/mod/mod_substitute.xml.fr @@ -1,7 +1,7 @@ - + @@ -85,9 +85,9 @@ réponse Exemple -<Location /> +<Location "/> AddOutputFilterByType SUBSTITUTE text/html - Substitute s/foo/bar/ni + Substitute "s/foo/bar/ni" </Location> @@ -98,7 +98,7 @@ réponse Exemple d'utilisation d'un délimiteur alternatif -<Location /> +<Location "/"> AddOutputFilterByType SUBSTITUTE text/html Substitute "s|<BR */?>|<br />|i" </Location> @@ -110,7 +110,7 @@ réponse substitution, comme illustré dans l'exemple suivant :

Exemple d'utilisation de références arrières et de captures -<Location /> +<Location "/"> AddOutputFilterByType SUBSTITUTE text/html # "foo=k,bar=k" -> "foo/bar=k" Substitute "s|foo=(\w+),bar=\1|foo/bar=$1" @@ -131,8 +131,8 @@ réponse Réécriture des URLs intégrées à un contenu mandaté -ProxyPass /blog/ http://internal.blog.example.com -ProxyPassReverse /blog/ http://internal.blog.example.com/ +ProxyPass "/blog/" "http://internal.blog.example.com" +ProxyPassReverse "/blog/" "http://internal.blog.example.com/" Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i" @@ -172,10 +172,10 @@ Apache Example -<Location /> +<Location "/"> AddOutputFilterByType SUBSTITUTE text/html SubstituteMaxLineLength 10m - Substitute s/foo/bar/ni + Substitute "s/foo/bar/ni" </Location> -- 2.40.0