Serveur Apache HTTP Version 2.5
Serveur Apache HTTP Version 2.5
AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth ContentDigest DefaultRuntimeDir DefaultType <Location> <LocationMatch> LogLevel LogLevelOverride MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeTrailers Mutex NameVirtualHost Options Protocol RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC UseCanonicalName UseCanonicalPhysicalPort <VirtualHost> Warning
Cette directive permet d'effectuer une optimisation de la socket
d'écoute d'un type de protocole en fonction du système
@@ -143,7 +146,8 @@ sur les autres plates-formes.
filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les
protocoles qui nécessitent l'envoi de données par le serveur en
premier, comme 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
@@ -151,10 +155,9 @@ 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
@@ -163,10 +166,9 @@ 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
@@ -175,10 +177,9 @@ 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 @@ -202,7 +203,7 @@ sur les autres plates-formes.
ProtocolProtocolCette directive permet de définir si les requêtes contenant des
@@ -264,16 +263,13 @@ sup
sur 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
@@ -305,13 +300,10 @@ 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
@@ -383,8 +374,7 @@ autoris
La directive AllowEncodedSlashes permet
@@ -477,7 +467,8 @@ All pour les versions ant
SetHandler, SetInputFilter, SetOutputFilter, et directives du
module mod_mime Add* et Remove*), des metadonnées
des documents (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName), des directives du
- module mod_rewrite RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule) et de la directive
+ module mod_rewrite directives (RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule), des directives du
+ module mod_alias directives (Redirect, RedirectTemp, RedirectPermanent, RedirectMatch), et de la directive
Action du module
mod_actions.
@@ -489,7 +480,7 @@ All pour les versions ant
des répertoires (AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
- DefaultIcon, DirectoryIndex, FancyIndexing,
+ DefaultIcon, DirectoryIndex, FallbackResource, FancyIndexing,
HeaderName, IndexIgnore, IndexOptions, ReadmeName,
etc...).
@@ -499,6 +490,11 @@ All pour les versions ant
Permet l'utilisation des directives contrôlant l'accès au serveur
(Allow, Deny et Order).
+
+
+
+
+
+ AllowOverride Options=Indexes,MultiViews
+
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
@@ -606,10 +605,9 @@ 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.
@@ -617,10 +615,9 @@ 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
@@ -654,6 +651,47 @@ scripts CGI
les fichiers scripts CGI possédant une extension .foo
seront passés à l'interpréteur FOO.
| Description: | Active la transmission d'en-têtes d'autorisation HTTP aux scripts en +tant que variables CGI |
|---|---|
| Syntaxe: | CGIPassAuth On|Off |
| Défaut: | CGIPassAuth Off |
| Contexte: | répertoire, .htaccess |
| AllowOverride: | AuthConfig |
| Statut: | Core |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.5.0 du serveur HTTP +Apache |
La directive CGIPassAuth permet aux
+ scripts d'accéder aux en-têtes d'autorisation HTTP tels que
+ Authorization, en-tête nécessaire aux scripts qui
+ implémente une authentification HTTP de base. Normalement, ces
+ en-têtes HTTP sont invisibles pour les scripts car ils leurs
+ permettraient de voir les identifiants et mots de passe
+ utilisés pour accéder au serveur lorsque l'authentification HTTP de
+ base est activée au niveau du serveur web. Cette directive doit être
+ définie à "On" lorsque des scripts sont autorisés à implémenter une
+ authentification HTTP de base.
Cette directive constitue une alternative à l'option de
+ compilation SECURITY_HOLE_PASS_AUTHORIZATION qui était
+ déjà disponible dans les versions précédentes du serveur HTTP
+ Apache.
Cette option est prise en compte par tout module qui utilise
+ ap_add_common_vars(), comme mod_cgi,
+ mod_cgid, mod_proxy_fcgi,
+ mod_proxy_scgi, etc... En particulier, elle affecte
+ les modules qui ne traitent pas à proprement parler les requêtes,
+ mais utilisent quand-même cette API, comme
+ mod_include ou mod_ext_filter. Les
+ modules tiers qui n'utilisent pas ap_add_common_vars()
+ peuvent aussi choisir de prendre en compte cette option.
La directive DefaultRuntimeDir permet de
définir le répertoire dans lequel le serveur va créer les différents
@@ -714,9 +754,9 @@ dans la r
généré relativement à la valeur de la directive
ServerRoot.
- DefaultRuntimeDir scratch/
-
Example
+DefaultRuntimeDir scratch/+
La valeur par défaut de la directive
DefaultRuntimeDir peut être modifiée en
@@ -751,18 +791,17 @@ autre type de m
none est disponible dans les
-versions d'Apache httpd 2.2.7 et supérieures. Tous les autres choix sont
-DESACTIVÉS à partir des version 2.3.x.none, sont
+DESACTIVÉS à partir de la version 2.3.0.Cette directive a été désactivée. Pour la compatibilité
ascendante avec les anciens fichiers de configuration, elle peut
être spécifiée avec la valeur 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>
+
+ DocumentRoot /var/www/${servername}/htdocs
+
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
@@ -863,9 +900,10 @@ 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.
@@ -877,19 +915,14 @@ 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
@@ -935,13 +965,10 @@ 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é
@@ -976,9 +1003,10 @@ 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.
A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
<DirectoryMatch ^/var/www/combined/(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</DirectoryMatch>
+
+
<Directory>
@@ -1026,9 +1069,8 @@ depuis Internet
de l'URL sera ajouté par le serveur à la racine des documents afin
de construire le chemin du document recherché. Exemple :
-
- 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
@@ -1064,14 +1106,13 @@ 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
@@ -1109,17 +1150,16 @@ 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
@@ -1178,21 +1218,17 @@ 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>+
Cette directive définit si le programme httpd
peut utiliser le support sendfile du noyau pour transmettre le
@@ -1245,21 +1280,17 @@ sup
problème, vous pouvez activer cette fonctionnalité en
spécifiant :
- 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
@@ -1285,26 +1316,24 @@ 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>+ @@ -1327,7 +1356,7 @@ d'erreur
- 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
@@ -1364,14 +1391,12 @@ 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
@@ -1440,24 +1465,23 @@ 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.
L'utilisation de syslog à la place d'un nom de
fichier active la journalisation via syslogd(8) si le système le
- supporte. Le dispositif syslog par défaut est local7,
+ supporte et si mod_syslog a été chargé. Le
+ dispositif syslog par défaut est local7,
mais vous pouvez le modifier à l'aide de la syntaxe
syslog:facility, où facility peut
être remplacé par un des noms habituellement documentés dans la page
@@ -1465,9 +1489,12 @@ 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+ + +
Des modules additionnels peuvent implémenter leur propre
+ fournisseur ErrorLog. La syntaxe est similaire à l'exemple
+ syslog ci-dessus.
SECURITE : Voir le document conseils à propos de sécurité pour des détails sur les raisons pour lesquelles votre @@ -1497,15 +1524,14 @@ personnalisation des r
La directive ErrorLogFormat permet de
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
@@ -1649,10 +1675,9 @@ 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 pour les MPMs threadés)
+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 :
@@ -1663,19 +1688,17 @@ 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éponseL'argument filename peut contenir un nom de fichier
ou une chaîne de caractères avec caractères génériques, où
? remplace un caractère, et * toute chaîne
- de caractères. On peut aussi utiliser les Expressions rationnelles en ajoutant la
+ de caractères.
<Files "cat.html"> + # Insérer ici des directives qui s'appliquent au fichier cat.html +</Files> + +<Files "?at.*"> + # Les directives insérées ici s'appliqueront aux fichiers + # cat.html, bat.html, hat.php, et ainsi de suite. +</Files>+ + +
On peut aussi utiliser les Expressions rationnelles en ajoutant la
caractère ~. 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.
+A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
<FilesMatch ^(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</FilesMatch>
+
+
Lorsqu'elle est placée dans un fichier .htaccess ou
une section <Directory>, <Location>, ou <Files>, cette directive force
@@ -1908,9 +1958,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
@@ -1920,22 +1969,17 @@ 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 @@ -2035,21 +2079,19 @@ 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
opérateurs de type shell pour la comparaison de chaînes
- (=, !=, <, ...), la
+ (==, !=, <, ...), la
comparaison d'entiers (-eq, -ne, ...), ou
à 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
@@ -2057,6 +2099,9 @@ requ
d'environnement (env), et un grand nombre d'autres
propriétés. La documentation complète est disponible dans Les expressions dans le serveur HTTP Apache.
Cette section de configuration ne peut contenir que des + directives qui supportent le contexte de répertoire.
+
- 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>+
La section <IfModule
test>...</IfModule> permet de conférer à
@@ -2207,9 +2239,8 @@ fichiers de configuration du serveur
Cette directive permet l'inclusion d'autres fichiers de configuration dans un des fichiers de configuration du serveur.
@@ -2240,35 +2271,31 @@ version 2.3.6Exemples :
-
- 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+
Le nombre de secondes pendant lesquelles Apache httpd va attendre une
requête avant de fermer la connexion. Le délai peut être défini en
@@ -2401,13 +2426,10 @@ certaines m
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,
@@ -2442,18 +2464,13 @@ 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>+
Par exemple :
-
- <LimitExcept POST GET>
-
- Require valid-user
-
- </LimitExcept>
-
<LimitExcept POST GET> + Require valid-user +</LimitExcept>+ @@ -2501,7 +2515,6 @@ sous-requ
Une redirection interne survient, par exemple, quand on utilise
la directive Action qui
@@ -2523,9 +2536,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+
- 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 @@ -2619,9 +2630,8 @@ requ
Par exemple :
-
- LimitRequestFields 50
-
LimitRequestFields 50+
Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2663,14 +2673,11 @@ requ
Par exemple ::
-
- LimitRequestFieldSize 4094
-
LimitRequestFieldSize 4094+
Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2712,14 +2719,11 @@ HTTP
Par exemple :
-
- LimitRequestLine 4094
-
LimitRequestLine 4094-
Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2748,9 +2752,8 @@ XML
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
@@ -2865,14 +2869,11 @@ 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 @@ -2923,13 +2924,29 @@ 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.
A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
<LocationMatch ^/combined/(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</LocationMatch>
+
+
Par exemple :
-
- LogLevel notice
-
LogLevel notice+
Si la journalisation s'effectue directement dans un fichier,
@@ -3125,30 +3141,88 @@ 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>+
LogLevelOverride.
+ | Description: | Surcharge la verbosité du journal des erreurs pour certains +clients |
|---|---|
| Syntaxe: | LogLevel ipaddress[/prefixlen]
+ [module:]level [module:level] ...
+ |
| Défaut: | non définie |
| Contexte: | configuration du serveur, serveur virtuel |
| Statut: | Core |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.5.0 du serveur HTTP +Apache. |
La directive LogLevelOverride permet
+ d'affiner la définition de la directive LogLevel pour les requêtes en provenance
+ de certaines adresses IP. Il est ainsi possible d'activer une
+ journalisation détaillée seulement pour certains clients à des fins
+ de test. Les adresses IP sont vérifiées à un stade très précoce du
+ processus de connexion. Ainsi, la directive
+ LogLevelOverride permet de modifier le niveau
+ de journalisation pour des processus comme la négociation SSL qui
+ intervient avant l'évaluation d'une éventuelle directive LogLevel au sein d'un conteneur <If>.
La directive LogLevelOverride accepte soit
+ une adresse IP simple, soit une spécification de sous-réseau CIDR de
+ la forme adresse-IP/masque. Pour la syntaxe de la spécification du
+ niveau de journalisation, voir la directive LogLevel directive.
Pour les requêtes concernées par une directive
+ LogLevelOverride, les spécifications de
+ niveau répertoire de la directive LogLevel sont ignorées.
Exemples:
+ +LogLevelOverride 192.0.2.0/24 ssl:trace6 + LogLevelOverride 192.0.2.7 ssl:trace8+ + +
LogLevelOverride n'affecte que les
+ messages associés à la requête ou à la connexion. Les messages
+ associés au serveur ne sont pas affectés.
LogLevelPar exemple :
-
- MaxKeepAliveRequests 500
-
MaxKeepAliveRequests 500+
| Description: | Détermine si les données supplémentaires (trailers) sont +fusionnées avec les en-têtes |
|---|---|
| Syntaxe: | MergeTrailers [on|off] |
| Défaut: | MergeTrailers off |
| Contexte: | configuration du serveur, serveur virtuel |
| Statut: | Core |
| Module: | core |
Cette directive permet de contrôler la fusion des données HTTP + supplémentaires (trailers) avec la représentation interne des + en-têtes. Cette fusion intervient lorsque le corps de la requête a + été entièrement reçu, bien longtemps après que la majeure partie du + traitement des en-têtes ait une chance de pouvoir examiner ou + modifier les en-têtes de la requête.
+Cette option a été introduite dans un souci de compatibilité avec + les versions antérieures à 2.4.10, où les données supplémentaires + étaient systématiquement fusionnées avec les en-têtes de la requête.
+Avec les mécanismes à base de fichier fcntl et
flock, le chemin, s'il est fourni, est un répertoire dans
lequel le fichier verrou sera créé. Le répertoire par défaut est le
- répertoire httpd défini par la directive ServerRoot. Utilisez toujours un système
+ répertoire d'exécution httpd défini par la directive DefaultRuntimeDir. Si le répertoire
+ spécifié est un chemin relatif, il est relatif au chemin défini par
+ la directive DefaultRuntimeDir.
+ Utilisez toujours un système
de fichiers local sur disque pour /chemin/vers/mutex et
jamais un répertoire se trouvant dans un système de fichiers NFS ou
AFS. Le nom de base du fichier se composera du type de mutex, d'une
@@ -3521,10 +3619,9 @@ verrou pour tous les mutex ou seulement les mutex sp
mutex par défaut pour tous les autres mutex deviendra
sysvsem.
- Mutex sysvsem default
- Mutex fcntl:/var/httpd/locks mpm-accept
-
Mutex sysvsem default +Mutex fcntl:/var/httpd/locks mpm-accept+
Bien que le serveur suive les liens symboliques, il ne modifie
pas le nom de chemin concerné défini par la section
<Directory>.
Notez aussi que cette option est ignorée si
- elle est définie dans une section <Location>.
Les options FollowSymLinks et
+ SymLinksIfOwnerMatch ne fonctionnent que dans les
+ sections <Directory> ou les fichiers
+ .htaccess.
Le fait d'omettre cette option ne doit pas être considéré comme une mesure de sécurité efficace, car il existe toujours une situation de compétition (race condition) entre l'instant où l'on @@ -3649,14 +3750,18 @@ particulier vers un fichier ou un répertoire dont le propriétaire est le même que celui du lien. -
Cette option est ignorée si elle est
- définie dans une section <Location>.
Les options FollowSymLinks et
+ SymLinksIfOwnerMatch ne fonctionnent que dans les
+ sections <Directory> ou les fichiers
+ .htaccess.
Le fait d'omettre cette option ne doit pas être considéré comme une mesure de sécurité efficace, car il existe toujours une situation de compétition (race condition) entre l'instant où l'on vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où - l'on utilise effectivement ce chemin.
Normalement, si plusieurs directives @@ -3682,38 +3787,28 @@ particulier
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
@@ -3737,8 +3832,8 @@ particulier
Cette directive permet de spécifier le protocole utilisé pour une
socket d'écoute particulière. Le protocole sert à déterminer quel
@@ -3755,18 +3850,35 @@ 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.
AcceptFilterAcceptFilterListen| Description: | Enregistrement de méthodes HTTP non standards |
|---|---|
| Syntaxe: | RegisterHttpMethod méthode [méthode [...]] |
| Contexte: | configuration du serveur |
| Statut: | Core |
| Module: | core |
Normalement, les méthodes HTTP non conformes aux RFCs correspondantes
+sont rejetées au cours du traitement de la requête par HTTPD. Pour
+éviter ceci, les modules peuvent enregistrer les méthodes HTTP non
+standards qu'ils supportent. La directive
+RegisterHttpMethod permet d'enregistrer de telles
+méthodes manuellement. Ceci peut s'avérer utile si de telle méthodes
+doivent être utilisées dans un traitement externe, comme un script CGI.
Registry-Strict est disponible dans les versions
-2.0 et supérieures du serveur HTTP ApacheCette directive permet de contrôler la méthode qu'utilise Apache
httpd pour trouver l'interpréteur destiné à exécuter les scripts CGI. La
@@ -3916,16 +4026,14 @@ l'option 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
@@ -3973,8 +4081,6 @@ elle-m
Avec ExtendedStatus On, mod_status affiche la
véritable requête en cours de traitement. Pour des raisons
@@ -4027,9 +4133,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 !
@@ -4050,15 +4155,14 @@ 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
@@ -4066,6 +4170,11 @@ serveurs virtuels
priorité particulière si le nom contient des caractères génériques
(que ce soit pour ServerName ou ServerAlias).
Tous les noms spécifiés au sein d'une section
+ VirtualHost sont traités comme un
+ ServerAlias (sans caractères génériques).
UseCanonicalName
- 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
annule cependant la précédente (pour ce serveur).
Si la directive ServerName n'est pas
- définie, le serveur tente de déterminer le nom d'hôte en effectuant
- une recherche DNS inverse sur son adresse IP. Si la directive
+ définie, le serveur tente de déterminer le nom
+ d'hôte visible du point de vue du client en effectuant
+ une recherche DNS inverse sur une adresse IP du serveur.
Si la directive
ServerName ne précise pas de port, le serveur
utilisera celui de la requête entrante. Il est recommandé de
spécifier un nom d'hôte et un port spécifiques à l'aide de la
@@ -4203,9 +4314,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
@@ -4283,13 +4393,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
@@ -4307,12 +4414,12 @@ HTTP
ServerTokens Min[imal]- Le serveur renvoie (par exemple):
Server:
- Apache/2.4.1
+ Apache/2.4.2ServerTokens OSServer:
- Apache/2.4.1 (Unix)Lorsqu'elle se situe à l'intérieur d'un fichier
.htaccess, ou d'une section <Directory> ou <Location>, cette directive force le
@@ -4363,22 +4468,27 @@ gestionnaire particulier
extensions, vous pouvez ajouter la ligne suivante dans un fichier
.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 aussi utiliser cette directive pour associer un + gestionnaire à des fichiers possèdant une extension de nom de + fichier particulière. Par exemple :
+ +<FilesMatch \.php$> + SetHandler application/x-httpd-php +</FilesMatch>+
Vous pouvez écraser la définition antérieure d'une directive
SetHandler en utilisant la valeur
@@ -4442,13 +4552,10 @@ 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 @@ -4483,7 +4590,7 @@ du serveur maximum jusqu'à l'arrivée de l'accusé-réception d'un paquet si le tampon d'envoi est plein. -
mod_cgi, le temps d'attente maximum des
+ mod_cgi et mod_cgid, le temps d'attente maximum des
sorties d'un script CGI.mod_ext_filter, le temps d'attente
@@ -4506,8 +4613,6 @@ du serveur
Cette directive l'emporte sur le comportement de
TRACE pour le noyau du serveur et
@@ -4595,9 +4700,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 @@ -4739,17 +4841,14 @@ 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 @@ -4809,6 +4908,39 @@ qu'utilise le serveur HTTP Apache
| Description: | Message d'avertissement personnalisable en provenance de +l'interprétation du fichier de configuration |
|---|---|
| Syntaxe: | Warning message |
| Contexte: | configuration du serveur, serveur virtuel, répertoire, .htaccess |
| Statut: | Core |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.5 du serveur HTTP +Apache. |
Cette directive permet de signaler la détection d'un problème de + configuration en générant un message d'avertissement + personnalisable. L'interprétation du fichier de configuration n'est + pas interrompue. Un exemple typique d'utilisation est la + vérification de la définition de certaines options définies par + l'utilisateur, et l'envoi d'un avertissement éventuel.
+ +# Exemple +# signale que ReverseProxy n'est pas défini +<IfDefine !ReverseProxy> + Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger + si nécessaire" +</IfDefine> + +<IfDefine ReverseProxy> + # définition de la configuration personnalisée du mandataire +</IfDefine>+ + +