From f367ba60eca30a9b463cb5a40dcc72069dfd037d Mon Sep 17 00:00:00 2001
From: Rich Bowen You could also use this directive to configure a particular
+ handler for files with a particular file extension. For example: You can override an earlier defined
+<FilesMatch \.php$>
+ SetHandler application/x-httpd-php
+</FilesMatch>
+
+
+
SetHandler
directive by using the value None
.ftp:
ou nntp
:
AcceptFilter nntp none
+ AcceptFilter nntp none ++
Les noms de protocoles par défaut sont https
pour le
port 443 et http
pour tous les autres ports. Pour
@@ -153,10 +156,11 @@ sur les autres plates-formes.
ajoutez l'argument protocol à la directive Listen
.
Sous FreeBSD, les valeurs par défaut sont :
-
- AcceptFilter http httpready
- AcceptFilter https dataready
-
+AcceptFilter http httpready +AcceptFilter https dataready ++
Le filtre d'acceptation httpready
met en tampon des
requêtes HTTP entières au niveau du noyau. Quand une requête
@@ -165,10 +169,11 @@ sur les autres plates-formes.
HTTPS sont chiffrées, celles-ci n'autorisent que le filtre accf_data(9).
Sous Linux, les valeurs par défaut sont :
-
- AcceptFilter http data
- AcceptFilter https data
-
+AcceptFilter http data +AcceptFilter https data ++
Le filtre TCP_DEFER_ACCEPT
de Linux ne supporte pas
la mise en tampon des requêtes http. Toute valeur autre que
@@ -177,10 +182,11 @@ sur les autres plates-formes.
manuel Linux de tcp(7).
Sous Windows, les valeurs par défaut sont :
-
- AcceptFilter http data
- AcceptFilter https data
-
+AcceptFilter http data +AcceptFilter https data ++
Le module MPM pour Windows mpm_winnt utilise la directive AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte @@ -204,7 +210,7 @@ sur les autres plates-formes.
Protocol
Protocol
PATH_INFO
. Le gestionnaire de base va en général
rejeter la requête, et vous pouvez utiliser la configuration
suivante pour utiliser un tel script :
++<Files "mypaths.shtml"> + Options +Includes + SetOutputFilter INCLUDES + AcceptPathInfo On +</Files> +-
- <Files "mes-chemins.shtml">
-
- Options +Includes
- SetOutputFilter INCLUDES
- AcceptPathInfo On
-
- </Files>
-
- AccessFileName .acl
-
AccessFileName .acl+
avant de renvoyer le document
/usr/local/web/index.html
, le serveur va rechercher les
@@ -307,13 +311,12 @@ sup
pour y lire d'éventuelles directives, à moins quelles n'aient été
désactivées avec
- <Directory />
-
- AllowOverride None
-
- </Directory>
-
+<Directory /> + AllowOverride None +</Directory> ++
- AddDefaultCharset utf-8
-
AddDefaultCharset utf-8+
La directive AddDefaultCharset
ne doit
être utilisée que lorsque toutes les ressources textes auxquelles
@@ -554,9 +556,8 @@ All pour les versions ant
Exemple :
-
- AllowOverride AuthConfig Indexes
-
AllowOverride AuthConfig Indexes+
Dans l'exemple ci-dessus, toutes les directives qui ne font
partie ni du groupe AuthConfig
, ni du groupe
@@ -608,10 +609,11 @@ All pour les versions ant
Example:
-
- AllowOverride None
- AllowOverrideList Redirect RedirectMatch
-
+AllowOverride None +AllowOverrideList Redirect RedirectMatch ++
Dans l'exemple ci-dessus, seules les directives
Redirect
et RedirectMatch
sont autorisées.
@@ -619,10 +621,11 @@ All pour les versions ant
Example:
-
- AllowOverride AuthConfig
- AllowOverrideList CookieTracking CookieName
-
+AllowOverride AuthConfig +AllowOverrideList CookieTracking CookieName ++
Dans l'exemple ci-dessus, la directive AllowOverride
autorise les directives du
groupement AuthConfig
, et
@@ -702,41 +705,42 @@ dans la r
Description: | Répertoire de base des fichiers créés par le serveur au -cours de son exécution |
---|---|
Syntaxe: | DefaultRuntimeDir chemin |
Description: | Répertoire de base des fichiers créés au cours de l'exécution du serveur |
Syntaxe: | DefaultRuntimeDir chemin-répertoire |
Défaut: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
Contexte: | configuration du serveur |
Statut: | Core |
Module: | core |
La directive DefaultRuntimeDir
permet de
- définir le répertoire dans lequel le serveur va créer différents
- fichiers au cours de son exécution (mémoire partagée, verrous,
- etc...). Si on spécifie un chemin relatif, ce chemin sera relatif au
- chemin défini par la directive ServerRoot
.
ServerRoot
.
-
- DefaultRuntimeDir scratch/
-
Example
++DefaultRuntimeDir scratch/ +-
Il est possible de modifier la valeur par défaut de la directive
- DefaultRuntimeDir
en redéfinissant la valeur
- de la variable DEFAULT_REL_RUNTIMEDIR
à la compilation.
Note: la directive ServerRoot
doit être
- déjà définie pour utiliser cette directive, car dans le cas
- contraire, c'est la valeur par défaut de
- ServerRoot
qui sera utilisée pour construire
- la répertoire de base.
La valeur par défaut de la directive
+ DefaultRuntimeDir
peut être modifiée en
+ changeant la valeur de la macro DEFAULT_REL_RUNTIMEDIR
+ définie à la compilation.
Note: si la valeur de ServerRoot
n'a pas
+ été spécifiée avant d'utiliser cette directive, c'est la valeur par
+ défaut de ServerRoot
qui sera utilisée pour
+ définir la base du répertoire.
ServerRoot
du serveur.ServerRoot
none
, c'est à dire sans
type de médium par défaut. Par exemple :
-
- DefaultType None
-
DefaultType None+ +
DefaultType None
n'est disponible que dans les
versions d'Apache 2.2.7 et supérieures.
- <IfDefine TEST>
- Define servername test.example.com
- </IfDefine>
- <IfDefine !TEST>
- Define servername www.example.com
- Define SSL
- </IfDefine>
-
+<IfDefine TEST> + Define servername test.example.com +</IfDefine> +<IfDefine !TEST> + Define servername www.example.com + Define SSL +</IfDefine> ++
Le caractère ":" est interdit dans les noms de variables afin
d'éviter les conflits avec la syntaxe de la directive RewriteMap
.
/home/user/public_html
, alors que <Directory
/home/*/public_html>
conviendra. Exemple :
-
- <Directory /usr/local/httpd/htdocs>
-
- Options Indexes FollowSymLinks
-
- </Directory>
-
+<Directory "/usr/local/httpd/htdocs"> + Options Indexes FollowSymLinks +</Directory> ++
Soyez prudent avec l'argument chemin répertoire : il
@@ -866,9 +870,12 @@ sous-r
peuvent aussi être utilisées en ajoutant le caractère
~
. Par exemple :
- <Directory ~ "^/www/.*/[0-9]{3}">
-
+<Directory ~ "^/www/.*/[0-9]{3}"> + +</Directory> ++
pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.
@@ -880,19 +887,16 @@ sous-r directives des fichiers .htaccess. Par exemple, avec -
- <Directory />
-
- AllowOverride None
-
- </Directory>
-
- <Directory /home>
-
- AllowOverride FileInfo
-
- </Directory>
-
+<Directory /> + AllowOverride None +</Directory> + +<Directory "/home"> + AllowOverride FileInfo +</Directory> ++
l'accès au document /home/web/dir/doc.html
emprunte
le chemin suivant :
- <Directory ~ abc$>
-
- # ... directives here ...
-
- </Directory>
-
+<Directory ~ "abc$"> + # ... directives ici ... +</Directory> ++
la section avec expression rationnelle ne sera prise en compte
qu'après les sections <Directory>
sans expression rationnelle
@@ -938,13 +941,12 @@ sous-r
correspondant à une URL. Il est recommandé de modifier cette
situation à l'aide d'un bloc du style
- <Directory />
-
- Require all denied
-
- </Directory>
-
+<Directory /> + Require all denied +</Directory> ++
puis d'affiner la configuration pour les répertoires que vous
voulez rendre accessibles. Voir la page Conseils à propos de sécurité
@@ -979,9 +981,12 @@ du syst
précisé (et aux fichiers qu'il contient), comme pour la section <Directory>
. Cependant, le
répertoire est précisé sous la forme d'une expression rationnelle. Par exemple :
- <DirectoryMatch "^/www/(.+/)?[0-9]{3}">
-
+<DirectoryMatch "^/www/(.+/)?[0-9]{3}"> + # ... +</DirectoryMatch> ++
conviendrait pour les sous-répertoires de /www/
dont
le nom se compose de trois chiffres.
- DocumentRoot /usr/web
-
DocumentRoot "/usr/web"+
un accès à http://my.example.com/index.html
se
réfère alors à /usr/web/index.html
. Si chemin
@@ -1067,14 +1071,15 @@ requ
supérieure et dans la même portée n'ont pas été satisfaites. Par
exemple, dans :
- <If "-z req('Host')">
- ...
- </If>
- <Else>
- ...
- </Else>
-
+<If "-z req('Host')"> + # ... +</If> +<Else> + # ... +</Else> ++
La condition de la section <If>
serait satisfaite pour les requêtes
HTTP/1.0 sans en-tête Host:, alors que celle de la section
@@ -1112,17 +1117,18 @@ alors que la condition correspondant
ou <ElseIf>
de la même portée ne
l'est pas. Par exemple, dans :
- <If "-R '10.1.0.0/16'">
- ...
- </If>
- <ElseIf "-R '10.0.0.0/8'">
- ...
- </ElseIf>
- <Else>
- ...
- </Else>
-
+<If "-R '10.1.0.0/16'"> + #... +</If> +<ElseIf "-R '10.0.0.0/8'"> + #... +</ElseIf> +<Else> + #... +</Else> ++
La condition correspondant à la section <ElseIf>
est satisfaite si l'adresse
distante de la requête appartient au sous-réseau 10.0.0.0/8, mais
@@ -1181,21 +1187,19 @@ lire les fichiers pendant qu'ils sont servis
problème, il est préférable de désactiver la projection en mémoire
des fichiers servis en spécifiant :
- EnableMMAP Off
-
EnableMMAP Off+
Pour les montages NFS, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :
-
- <Directory "/chemin vers montage NFS">
-
- EnableMMAP Off
-
- </Directory>
-
+<Directory "/path-to-nfs-files"> + EnableMMAP Off +</Directory> ++
- EnableSendfile On
-
EnableSendfile On+
Pour les montages réseau, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :
-
- <Directory "/chemin vers montage réseau">
-
- EnableSendfile Off
-
- </Directory>
-
+<Directory "/path-to-nfs-files"> + EnableSendfile Off +</Directory> ++
Veuillez noter que la configuration de la directive
EnableSendfile
dans un contexte de répertoire
ou de fichier .htaccess n'est pas supportée par
@@ -1288,26 +1290,26 @@ d'erreur personnalis
directive peut être utilisée pour générer un message d'erreur
personnalisé, et interrompre la lecture de la configuration.
- # vérification du chargement de mod_include
- <IfModule !include_module>
- Error mod_foo nécessite mod_include. Chargez-le via LoadModule.
- </IfModule>
-
- # vérification de la définition de SSL ou (exclusif) NOSSL
- <IfDefine SSL>
- <IfDefine NOSSL>
- Error SSL et NOSSL sont définies. Vous devez définir soit l'une,
- soit l'autre.
- </IfDefine>
- </IfDefine>
- <IfDefine !SSL>
- <IfDefine !NOSSL>
- Error Vous devez définir une et une seule des deux variables SSL
- ou NOSSL.
- </IfDefine>
- </IfDefine>
-
+# Exemple +# vérification du chargement de mod_include +<IfModule !include_module> + Error "mod_include is required by mod_foo. Load it with LoadModule." +</IfModule> + +# vérification de la définition de SSL ou (exclusif) NOSSL +<IfDefine SSL> +<IfDefine NOSSL> + Error "Both SSL and NOSSL are defined. Define only one of them." +</IfDefine> +</IfDefine> +<IfDefine !SSL> +<IfDefine !NOSSL> + Error "Either SSL or NOSSL must be defined." +</IfDefine> +</IfDefine> ++ @@ -1350,14 +1352,14 @@ d'erreur Alternativement, un message à afficher par le navigateur pourra être fourni. Exemples : -
- ErrorDocument 500 http://foo.example.com/cgi-bin/tester
- ErrorDocument 404 /cgi-bin/bad_urls.pl
- ErrorDocument 401 /subscription_info.html
- ErrorDocument 403 "Désolé, vous n'avez pas l'autorisation d'accès
- aujourd'hui"
- ErrorDocument 403 Interdit!
-
+ErrorDocument 500 http://foo.example.com/cgi-bin/tester +ErrorDocument 404 /cgi-bin/bad_urls.pl +ErrorDocument 401 /subscription_info.html +ErrorDocument 403 "Sorry can't allow you access today" +ErrorDocument 403 Forbidden! ++
De plus, on peut spécifier la valeur spéciale default
pour indiquer l'utilisation d'un simple message d'Apache httpd codé en
@@ -1367,14 +1369,14 @@ d'erreur
les configurations qui sans cela, hériteraient d'une directive
ErrorDocument
existante.
- ErrorDocument 404 /cgi-bin/bad_urls.pl
- <Directory /web/docs>
-
- ErrorDocument 404 default
-
- </Directory>
-
+ErrorDocument 404 /cgi-bin/bad_urls.pl + +<Directory /web/docs> + ErrorDocument 404 default +</Directory> ++
Notez que lorsque vous spécifiez une directive
ErrorDocument
pointant vers une URL distante
@@ -1443,17 +1445,15 @@ personnalisation des r
absolu, il est considéré comme relatif au chemin défini par la
directive ServerRoot
.
- ErrorLog /var/log/httpd/error_log
-
ErrorLog "/var/log/httpd/error_log"+
Si le chemin fichier commence par une barre verticale
"(|)
", il est considéré comme une commande à lancer pour traiter la
journalisation de l'erreur.
- ErrorLog "|/usr/local/bin/erreurs_httpd"
-
ErrorLog "|/usr/local/bin/httpd_errors"+
Voir les notes à propos des journaux redirigés pour plus d'informations.
@@ -1468,9 +1468,8 @@ personnalisation des r global, et si il est modifié dans un serveur virtuel, le dispositif final spécifié affecte l'ensemble du serveur -
- ErrorLog syslog:user
-
ErrorLog syslog:user+
SECURITE : Voir le document conseils à propos de sécurité pour des détails sur les raisons pour lesquelles votre @@ -1506,9 +1505,11 @@ personnalisation des r spécifier quelles informations supplémentaires vont être enregistrées dans le journal des erreurs en plus du message habituel.
-
- ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
-
+# Exemple simple +ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" ++
La spécification de connection
ou
request
comme premier paramètre permet de définir des
@@ -1652,10 +1653,11 @@ personnalisation des r
c'est son identifiant unique qui sera utilisé comme identifiant de
journal pour les requêtes.
- ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a]
- %M% ,\ referer\ %{Referer}i"
-
+# Exemple (format par défaut) +ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" ++
Cet exemple renverrait un message d'erreur du style :
@@ -1666,19 +1668,21 @@ personnalisation des rNotez que, comme indiqué plus haut, certains champs sont totalement supprimés s'ils n'ont pas été définis.
-
- ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a]
- %M% ,\ referer\ %{Referer}i"
-
+# Exemple (similaire au format 2.2.x) +ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" ++ + +
+# Exemple avancé avec identifiants journal de requête/connexion +ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M" +ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T" +ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" +ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'" +ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A" +-
- ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
- ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
- ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
- ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
- ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"
-
FileETag INode MTime
- Size
FileETag INode MTime Size+
ETag
ne sera inclus dans la réponse~
. Par exemple :
-
- <Files ~ "\.(gif|jpe?g|png)$">
-
+<Files ~ "\.(gif|jpe?g|png)$"> + #... +</Files> ++
correspondrait à la plupart des formats graphiques de l'Internet.
Il est cependant préférable d'utiliser la directive <FilesMatch>
.
- <FilesMatch "\.(gif|jpe?g|png)$">
-
+<FilesMatch "\.(gif|jpe?g|png)$"> + # ... +</FilesMatch> ++
correspondrait à la plupart des formats graphiques de l'Internet.
@@ -1911,9 +1922,8 @@ HTTP Content-Type pour les fichiers correspondants pas leur ajouter l'extension.gif
, vous pouvez utiliser
:
-
- ForceType image/gif
-
ForceType image/gif+
Notez que cette directive l'emporte sur d'autres associations de
type de médium indirectes définies dans mime.types ou via la
@@ -1923,22 +1933,19 @@ HTTP Content-Type pour les fichiers correspondants
ForceType
en affectant la valeur
None
à l'argument type médium :
- # force le type MIME de tous les fichiers à image/gif:
- <Location /images>
-
- ForceType image/gif
-
- </Location>
-
- # mais utilise les méthodes classiques d'attribution du type MIME
- # dans le sous-répertoire suivant :
- <Location /images/mixed>
-
- ForceType None
-
- </Location>
-
+# force le type MIME de tous les fichiers à image/gif: +<Location /images> + ForceType image/gif +</Location> + +# mais utilise les méthodes classiques d'attribution du type MIME +# dans le sous-répertoire suivant : +<Location /images/mixed> + ForceType None +</Location> ++
A la base, cette directive écrase le type de contenu généré pour les fichiers statiques servis à partir du sytème de fichiers. Pour @@ -2038,9 +2045,8 @@ requ si et seulement si l'expression renvoie la valeur "vrai". Par exemple :
-
- <If "-z req('Host')">
-
<If "-z req('Host')">+
serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
Host:. Les expressions peuvent contenir différents
@@ -2050,9 +2056,8 @@ requ
à usages divers (-n
, -z
, -f
,
...). Les expressions rationnelles sont aussi supportées,
- <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
-
<If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">+
ainsi que les comparaison de modèles de type shell et de nombreuses autres opérations. Ces opérations peuvent être effectuées @@ -2117,32 +2122,23 @@ test retourne "vrai" au d peuvent être imbriquées, ce qui permet d'implémenter un test multi-paramètres simple. Exemple :
-
- httpd -DReverseProxy -DUseCache -DMemCache ...
-
- # httpd.conf
- <IfDefine ReverseProxy>
-
- LoadModule proxy_module modules/mod_proxy.so
- LoadModule proxy_http_module modules/mod_proxy_http.so
- <IfDefine UseCache>
-
- LoadModule cache_module modules/mod_cache.so
- <IfDefine MemCache>
-
- LoadModule mem_cache_module modules/mod_mem_cache.so
-
- </IfDefine>
- <IfDefine !MemCache>
-
- LoadModule cache_disk_module modules/mod_cache_disk.so
-
- </IfDefine>
-
- </IfDefine>
-
- </IfDefine>
-
httpd -DReverseProxy -DUseCache -DMemCache ...
+<IfDefine ReverseProxy> + LoadModule proxy_module modules/mod_proxy.so + LoadModule proxy_http_module modules/mod_proxy_http.so + <IfDefine UseCache> + LoadModule cache_module modules/mod_cache.so + <IfDefine MemCache> + LoadModule mem_cache_module modules/mod_mem_cache.so + </IfDefine> + <IfDefine !MemCache> + LoadModule cache_disk_module modules/mod_cache_disk.so + </IfDefine> + </IfDefine> +</IfDefine> ++ @@ -2243,35 +2239,35 @@ version 2.3.6
Exemples :
-
- Include /usr/local/apache2/conf/ssl.conf
- Include /usr/local/apache2/conf/vhosts/*.conf
-
+Include /usr/local/apache2/conf/ssl.conf +Include /usr/local/apache2/conf/vhosts/*.conf ++
ou encore, avec des chemins relatifs au répertoire défini par la
directive ServerRoot
:
- Include conf/ssl.conf
- Include conf/vhosts/*.conf
-
+Include conf/ssl.conf +Include conf/vhosts/*.conf ++
On peut aussi insérer des caractères génériques dans la partie répertoires du chemin. Dans l'exemple suivant, la directive échouera si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :
-
- Include conf/vhosts/*/*.conf
-
Include conf/vhosts/*/*.conf+
Par contre, dans l'exemple suivant, la directive sera simplement ignorée si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :
-
- IncludeOptional conf/vhosts/*/*.conf
-
IncludeOptional conf/vhosts/*/*.conf+
DELETE
, en laissant les autres méthodes sans protection
:
-
- <Limit POST PUT DELETE>
-
- Require valid-user
-
- </Limit>
-
+<Limit POST PUT DELETE> + Require valid-user +</Limit> ++
La liste des noms de méthodes peut contenir une ou plusieurs
valeurs parmi les suivantes : GET
, POST
,
@@ -2445,18 +2440,15 @@ certaines m
POST
, et la directive Require group
editors
sera ignorée dans tous les cas :
- <LimitExcept GET>
-
- Require valid-user
-
- </LimitExcept>
- <Limit POST>
-
- Require group editors
-
- </Limit>
-
+<LimitExcept GET> + Require valid-user +</LimitExcept> +<Limit POST> + Require group editors +</Limit> ++ @@ -2484,13 +2476,12 @@ sauf celles qui sont sp
Par exemple :
-
- <LimitExcept POST GET>
-
- Require valid-user
-
- </LimitExcept>
-
+<LimitExcept POST GET> + Require valid-user +</LimitExcept> ++ @@ -2526,9 +2517,8 @@ sous-requ maximum des sous-requêtes. Si vous ne spécifiez qu'un seul nombre, il sera affecté aux deux limites. -
- LimitInternalRecursion 5
-
LimitInternalRecursion 5+ @@ -2573,9 +2563,8 @@ envoy fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante : -
- LimitRequestBody 102400
-
LimitRequestBody 102400+
Pour une description détaillée de la manière dont cette directive est interprétée par les requêtes mandatées, voir la @@ -2622,9 +2611,8 @@ requ
Par exemple :
-
- LimitRequestFields 50
-
LimitRequestFields 50+
Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2666,9 +2654,8 @@ requ
Par exemple ::
-
- LimitRequestFieldSize 4094
-
LimitRequestFieldSize 4094+
Par exemple :
-
- LimitRequestLine 4094
-
LimitRequestLine 4094+
Exemple :
-
- LimitXMLRequestBody 0
-
LimitXMLRequestBody 0+
- <Location /private1>
- ...
-
+<Location /private1> + # ... +</Location> ++
De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les directives contenues dans la section s'appliqueront à /private2/ et à /private2/file.txt, mais pas à /private2other.
-
- <Location /private2/>
- ...
-
+<Location /private2/> + # ... +</Location> ++
<Location>
~
. Par exemple :
-
- <Location ~ "/(extra|special)/data">
-
+<Location ~ "/(extra|special)/data"> + #... +</Location> ++
concernerait les URLs contenant les sous-chaîne
/extra/data
ou /special/data
. La directive
@@ -2868,14 +2860,13 @@ sp
appartenant au domaine example.com
, vous pouvez
utiliser :
- <Location /status>
-
- SetHandler server-status
- Require host example.com
-
- </Location>
-
+<Location /status> + SetHandler server-status + Require host example.com +</Location> ++
La signification du caractère slash dépend de l'endroit où il @@ -2926,9 +2917,12 @@ correspondant spécifier les URLs concernées est une expression rationnelle au lieu d'une simple chaîne de caractères. Par exemple :
-
- <LocationMatch "/(extra|special)/data">
-
+<LocationMatch "/(extra|special)/data"> + # ... +</LocationMatch> ++
correspondrait à toute URL contenant les sous-chaînes
/extra/data
ou /special/data
.
Par exemple :
-
- LogLevel notice
-
LogLevel notice+
Si la journalisation s'effectue directement dans un fichier,
@@ -3128,21 +3121,23 @@ Apache
identificateur, avec ou sans le suffixe _module
. Les
trois spécifications suivantes sont donc équivalentes :
- LogLevel info ssl:warn
- LogLevel info mod_ssl.c:warn
- LogLevel info ssl_module:warn
-
+LogLevel info ssl:warn +LogLevel info mod_ssl.c:warn +LogLevel info ssl_module:warn ++
Il est aussi possible d'attribuer un niveau de journalisation par répertoire :
-
- LogLevel info
- <Directory /usr/local/apache/htdocs/app>
- LogLevel debug
- </Files>
-
+LogLevel info +<Directory "/usr/local/apache/htdocs/app"> + LogLevel debug +</Directory> ++
Par exemple :
-
- MaxKeepAliveRequests 500
-
MaxKeepAliveRequests 500+
sysvsem
.
-
- Mutex sysvsem default
- Mutex fcntl:/var/httpd/locks mpm-accept
-
+Mutex sysvsem default +Mutex fcntl:/var/httpd/locks mpm-accept ++
Par exemple, sans aucun symbole +
et -
:
- <Directory /web/docs>
-
- Options Indexes FollowSymLinks
-
- </Directory>
-
- <Directory /web/docs/spec>
-
- Options Includes
-
- </Directory>
-
+<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options Includes +</Directory> ++
ici, seule l'option Includes
sera prise en compte
pour le répertoire /web/docs/spec
. Par contre, si la
seconde directive Options
utilise les
symboles +
et -
:
- <Directory /web/docs>
-
- Options Indexes FollowSymLinks
-
- </Directory>
-
- <Directory /web/docs/spec>
-
- Options +Includes -Indexes
-
- </Directory>
-
+<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options +Includes -Indexes +</Directory> ++
alors, les options FollowSymLinks
et
Includes
seront prises en compte pour le répertoire
@@ -3758,16 +3747,15 @@ seulement depuis la version 2.3.3 sous Windows.
https
sur un port non standard, spécifiez le protocole
de manière explicite :
- Protocol https
-
Protocol https+
Vous pouvez aussi spécifier le protocole via la directive
Listen
.
AcceptFilter
AcceptFilter
Listen
Registry-Strict
est disponible dans les versions
#!
). Sur les systèmes Win32, cette ligne ressemble
souvent à ceci :
-
- #!C:/Perl/bin/perl.exe
-
#!C:/Perl/bin/perl.exe+
ou simplement, dans le cas où perl
est dans le
PATH
:
- #!perl
-
#!perl+
Avec ScriptInterpreterSource Registry
, Windows va
effectuer une recherche dans l'arborescence
@@ -4030,9 +4016,8 @@ messages d'erreur envoy
Il peut s'avérer utile de définir une adresse dédiée à l'administration du serveur, par exemple :
-
- ServerAdmin www-admin@foo.example.com
-
ServerAdmin www-admin@foo.example.com+
car les utilisateurs ne mentionnent pas systématiquement le serveur dont ils parlent !
@@ -4053,15 +4038,16 @@ serveurs virtuels nom. La directiveServerAlias
peut
contenir des caractères génériques, si nécessaire.
-
- <VirtualHost *:80>
- ServerName serveur.example.com
- ServerAlias serveur serveur2.example.com serveur2
- ServerAlias *.example.com
- UseCanonicalName Off
- # ...
- </VirtualHost>
-
+<VirtualHost *:80> + ServerName server.example.com + ServerAlias server server2.example.com server2 + ServerAlias *.example.com + UseCanonicalName Off + # ... +</VirtualHost> ++
La recherche du serveur virtuel à base de nom correspondant au
plus près à la requête s'effectue selon l'ordre d'apparition des
directives <virtualhost>
dans le fichier de
@@ -4105,9 +4091,8 @@ enti
web s'identifie avec cet alias, vous devez utilisez la définition
suivante :
- ServerName www.example.com
-
ServerName www.example.com+
La directive ServerName
peut apparaître à
toutes les étapes de la définition du serveur. Toute occurrence
@@ -4206,9 +4191,8 @@ serveur
directives (comme Include
ou LoadModule
) seront définis par
rapport à ce répertoire.
- ServerRoot /home/httpd
-
ServerRoot "/home/httpd"+
La valeur par défaut de ServerRoot
peut
être modifiée via l'argument --prefix
de la commande configure
, et de
@@ -4286,13 +4270,10 @@ HTTP
ServerTokens Full
(ou non spécifié)Server: Apache/2.4.1
+ - Le serveur envoie par exemple :
Server: Apache/2.4.2
(Unix) PHP/4.2.2 MyMod/1.2
-
-
-
- ServerTokens Prod[uctOnly]
+ ServerTokens Prod[uctOnly]
- Le serveur renvoie (par exemple):
Server:
Apache
@@ -4310,12 +4291,12 @@ HTTP
ServerTokens Min[imal]
- Le serveur renvoie (par exemple):
Server:
- Apache/2.4.1
+ Apache/2.4.2
ServerTokens OS
Server:
- Apache/2.4.1 (Unix)
.htaccess
de ce répertoire :
-
- SetHandler imap-file
-
SetHandler imap-file+
Autre exemple : si vous voulez que le serveur affiche un
compte-rendu d'état chaque fois qu'une URL du type http://nom
serveur/status
est appelée, vous pouvez ajouter ceci dans
httpd.conf
:
- <Location /status>
-
- SetHandler server-status
-
- </Location>
-
+<Location "/status"> + SetHandler server-status +</Location> ++
Vous pouvez écraser la définition antérieure d'une directive
SetHandler
en utilisant la valeur
@@ -4445,13 +4424,12 @@ du serveur
fichiers du répertoire /www/data/
comme des inclusions
côté serveur (SSI) :
- <Directory /www/data/>
-
- SetOutputFilter INCLUDES
-
- </Directory>
-
+<Directory "/www/data/"> + SetOutputFilter INCLUDES +</Directory> ++
Si la directive comporte plusieurs filtres, ils doivent être
séparés par des points-virgules, et spécifiés selon l'ordre dans
@@ -4598,9 +4576,9 @@ et son port
http://www.example.com/splat/
. Si vous avez activé
l'authentification, ceci va obliger l'utilisateur à s'authentifier
deux fois (une première fois pour www
et une seconde
- fois pour www.example.com
-- voir la
- foire aux questions sur ce sujet pour plus d'informations). Par
- contre, si UseCanonicalName
est définie à
+ fois pour www.example.com
-- voir la
+ foire aux questions sur ce sujet pour plus d'informations).
+ Par contre, si UseCanonicalName
est définie à
Off
, Apache httpd redirigera l'utilisateur vers
http://www/splat/
.
- <VirtualHost 10.1.2.3:80>
-
- ServerAdmin webmaster@host.example.com
- DocumentRoot /www/docs/host.example.com
- ServerName host.example.com
- ErrorLog logs/host.example.com-error_log
- TransferLog logs/host.example.com-access_log
-
- </VirtualHost>
-
+<VirtualHost 10.1.2.3:80> + ServerAdmin webmaster@host.example.com + DocumentRoot /www/docs/host.example.com + ServerName host.example.com + ErrorLog logs/host.example.com-error_log + TransferLog logs/host.example.com-access_log +</VirtualHost> ++
Les adresses IPv6 doivent être entourées de crochets car dans le @@ -4742,17 +4719,16 @@ d'h déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 :
-
- <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80>
-
- ServerAdmin webmaster@host.example.com
- DocumentRoot /www/docs/host.example.com
- ServerName host.example.com
- ErrorLog logs/host.example.com-error_log
- TransferLog logs/host.example.com-access_log
-
- </VirtualHost>
-
+<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> + ServerAdmin webmaster@host.example.com + DocumentRoot /www/docs/host.example.com + ServerName host.example.com + ErrorLog logs/host.example.com-error_log + TransferLog logs/host.example.com-access_log +</VirtualHost> ++
Chaque serveur virtuel doit correspondre à une adresse IP, un port ou un nom d'hôte spécifique ; dans le premier cas, le serveur diff --git a/docs/manual/mod/core.xml.de b/docs/manual/mod/core.xml.de index bda8d2cb74..57e85d59b3 100644 --- a/docs/manual/mod/core.xml.de +++ b/docs/manual/mod/core.xml.de @@ -1,7 +1,7 @@ - + + + diff --git a/docs/manual/mod/core.xml.ja b/docs/manual/mod/core.xml.ja index 2fd47c7860..396d4d81e3 100644 --- a/docs/manual/mod/core.xml.ja +++ b/docs/manual/mod/core.xml.ja @@ -1,7 +1,7 @@ - + + + diff --git a/docs/manual/mod/mod_authn_file.xml.ja b/docs/manual/mod/mod_authn_file.xml.ja index 3d603f3e64..fe2431bea7 100644 --- a/docs/manual/mod/mod_authn_file.xml.ja +++ b/docs/manual/mod/mod_authn_file.xml.ja @@ -1,7 +1,7 @@ - + +