diff options
Diffstat (limited to 'docs/manual/mod/core.html.fr')
| -rw-r--r-- | docs/manual/mod/core.html.fr | 371 |
1 files changed, 158 insertions, 213 deletions
diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 66d59762..43e5b7bf 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -9,7 +9,7 @@ <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> -<script src="../style/scripts/prettify.js" type="text/javascript"> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> </script> <link href="../images/favicon.ico" rel="shortcut icon" /></head> @@ -143,9 +143,7 @@ sur les autres plates-formes.</td></tr> 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 <code>ftp:</code> ou <code>nntp</code>:</p> - <pre class="prettyprint lang-config"> - AcceptFilter nntp none - </pre> + <pre class="prettyprint lang-config">AcceptFilter nntp none</pre> <p>Les noms de protocoles par défaut sont <code>https</code> pour le @@ -154,10 +152,8 @@ sur les autres plates-formes.</td></tr> ajoutez l'argument <var>protocol</var> à la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> <p>Sous FreeBSD, les valeurs par défaut sont :</p> - <pre class="prettyprint lang-config"> -AcceptFilter http httpready -AcceptFilter https dataready - </pre> + <pre class="prettyprint lang-config">AcceptFilter http httpready +AcceptFilter https dataready</pre> <p>Le filtre d'acceptation <code>httpready</code> met en tampon des @@ -167,10 +163,8 @@ AcceptFilter https dataready HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data& sektion=9">accf_data(9)</a>.</p> <p>Sous Linux, les valeurs par défaut sont :</p> - <pre class="prettyprint lang-config"> -AcceptFilter http data -AcceptFilter https data - </pre> + <pre class="prettyprint lang-config">AcceptFilter http data +AcceptFilter https data</pre> <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas @@ -180,10 +174,8 @@ AcceptFilter https data manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/ tcp.7.html">tcp(7)</a>.</p> <p>Sous Windows, les valeurs par défaut sont :</p> - <pre class="prettyprint lang-config"> -AcceptFilter http data -AcceptFilter https data - </pre> + <pre class="prettyprint lang-config">AcceptFilter http data +AcceptFilter https data</pre> <p>Le module MPM pour Windows mpm_winnt utilise la directive @@ -257,7 +249,7 @@ nom de chemin en fin de requête.</td></tr> déterminé par le <a href="../handler.html">gestionnaire</a> responsable de la requête. Le gestionnaire de base pour les fichiers normaux rejette par défaut les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui - servent des scripts, comme <a href="mod_cgi.html">cgi-script</a> et <a href="mod_isapi.html">isapi-handler</a>, acceptent en général par + servent des scripts, comme<a href="mod_cgi.html">cgi-script</a> et <a href="mod_isapi.html">isapi-handler</a>, acceptent en général par défaut les requêtes avec <code>PATH_INFO</code>.</dd> </dl> @@ -268,13 +260,11 @@ nom de chemin en fin de requête.</td></tr> sur <code>PATH_INFO</code>. 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 :</p> -<pre class="prettyprint lang-config"> -<Files "mypaths.shtml"> +<pre class="prettyprint lang-config"><Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On -</Files> - </pre> +</Files></pre> @@ -307,11 +297,9 @@ nom de chemin en fin de requête.</td></tr> pour y lire d'éventuelles directives, à moins quelles n'aient été désactivées avec</p> - <pre class="prettyprint lang-config"> -<Directory /> + <pre class="prettyprint lang-config"><Directory /> AllowOverride None -</Directory> - </pre> +</Directory></pre> <h3>Voir aussi</h3> @@ -609,10 +597,8 @@ All pour les versions antérieures</code></td></tr> <p>Example:</p> - <pre class="prettyprint lang-config"> -AllowOverride None -AllowOverrideList Redirect RedirectMatch - </pre> + <pre class="prettyprint lang-config">AllowOverride None +AllowOverrideList Redirect RedirectMatch</pre> <p>Dans l'exemple ci-dessus, seules les directives @@ -621,10 +607,8 @@ AllowOverrideList Redirect RedirectMatch <p>Example:</p> - <pre class="prettyprint lang-config"> -AllowOverride AuthConfig -AllowOverrideList CookieTracking CookieName - </pre> + <pre class="prettyprint lang-config">AllowOverride AuthConfig +AllowOverrideList CookieTracking CookieName</pre> <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> autorise les directives du @@ -720,9 +704,7 @@ dans la réponse HTTP</td></tr> <code class="directive">ServerRoot</code></p> <p><strong>Example</strong></p> - <pre class="prettyprint lang-config"> -DefaultRuntimeDir scratch/ - </pre> + <pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre> <p>La valeur par défaut de la directive @@ -804,8 +786,7 @@ DESACTIVÉS à partir des version 2.3.x.</td></tr> La portée de la variable est toujours globale, et n'est jamais limitée à la section de configuration courante.</p> - <pre class="prettyprint lang-config"> -<IfDefine TEST> + <pre class="prettyprint lang-config"><IfDefine TEST> Define servername test.example.com </IfDefine> <IfDefine !TEST> @@ -813,8 +794,7 @@ DESACTIVÉS à partir des version 2.3.x.</td></tr> Define SSL </IfDefine> -DocumentRoot /var/www/${servername}/htdocs - </pre> +DocumentRoot /var/www/${servername}/htdocs</pre> <p>Le caractère ":" est interdit dans les noms de variables afin @@ -851,11 +831,9 @@ sous-répertoires, et à leur contenu.</td></tr> * <code>/home/user/public_html</code>, alors que <code><Directory /home/*/public_html></code> conviendra. Exemple :</p> - <pre class="prettyprint lang-config"> -<Directory "/usr/local/httpd/htdocs"> + <pre class="prettyprint lang-config"><Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks -</Directory> - </pre> +</Directory></pre> <div class="note"> @@ -872,11 +850,9 @@ sous-répertoires, et à leur contenu.</td></tr> peuvent aussi être utilisées en ajoutant le caractère <code>~</code>. Par exemple :</p> - <pre class="prettyprint lang-config"> -<Directory ~ "^/www/[0-9]{3}"> + <pre class="prettyprint lang-config"><Directory ~ "^/www/[0-9]{3}"> -</Directory> -</pre> +</Directory></pre> <p>pourra correspondre à tout répertoire situé dans /www/ et dont le @@ -889,15 +865,13 @@ sous-répertoires, et à leur contenu.</td></tr> directives des fichiers <a href="#accessfilename">.htaccess</a>. Par exemple, avec</p> - <pre class="prettyprint lang-config"> -<Directory /> + <pre class="prettyprint lang-config"><Directory /> AllowOverride None </Directory> <Directory "/home"> AllowOverride FileInfo -</Directory> - </pre> +</Directory></pre> <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte @@ -923,11 +897,9 @@ sous-répertoires, et à leur contenu.</td></tr> testés selon l'ordre dans lequel ils apparaissent dans le fichier de configuration. Par exemple, avec</p> - <pre class="prettyprint lang-config"> -<Directory ~ "abc$"> + <pre class="prettyprint lang-config"><Directory ~ "abc$"> # ... directives ici ... -</Directory> - </pre> +</Directory></pre> <p>la section avec expression rationnelle ne sera prise en compte @@ -943,11 +915,9 @@ sous-répertoires, et à leur contenu.</td></tr> correspondant à une URL. Il est recommandé de modifier cette situation à l'aide d'un bloc du style</strong></p> - <pre class="prettyprint lang-config"> -<Directory /> + <pre class="prettyprint lang-config"><Directory /> Require all denied -</Directory> - </pre> +</Directory></pre> <p><strong>puis d'affiner la configuration pour les répertoires que vous @@ -983,11 +953,9 @@ du système de fichiers correspondant à une expression rationnelle</td></tr> précisé (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory"><Directory></a></code>. Cependant, le répertoire est précisé sous la forme d'une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Par exemple :</p> - <pre class="prettyprint lang-config"> -<DirectoryMatch "^/www/(.+/)?[0-9]{3}"> + <pre class="prettyprint lang-config"><DirectoryMatch "^/www/(.+/)?[0-9]{3}"> # ... -</DirectoryMatch> -</pre> +</DirectoryMatch></pre> <p>conviendrait pour les sous-répertoires de <code>/www/</code> dont @@ -1007,6 +975,22 @@ du système de fichiers correspondant à une expression rationnelle</td></tr> de ligne ($) doivent donc faire l'objet d'une attention particulière. </div> + + <p>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 <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. 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.</p> + +<pre class="prettyprint lang-config"><DirectoryMatch ^/var/www/combined/(?<sitename>[^/]+)> + require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example +</DirectoryMatch></pre> + + <h3>Voir aussi</h3> <ul> @@ -1073,14 +1057,12 @@ requête à l'exécution</td></tr> supérieure et dans la même portée n'ont pas été satisfaites. Par exemple, dans :</p> - <pre class="prettyprint lang-config"> -<If "-z req('Host')"> + <pre class="prettyprint lang-config"><If "-z req('Host')"> # ... </If> <Else> # ... -</Else> - </pre> +</Else></pre> <p>La condition de la section <code class="directive"><If></code> serait satisfaite pour les requêtes @@ -1119,8 +1101,7 @@ alors que la condition correspondant à la section <code class="directive"><a hre ou <code class="directive"><ElseIf></code> de la même portée ne l'est pas. Par exemple, dans :</p> - <pre class="prettyprint lang-config"> -<If "-R '10.1.0.0/16'"> + <pre class="prettyprint lang-config"><If "-R '10.1.0.0/16'"> #... </If> <ElseIf "-R '10.0.0.0/8'"> @@ -1128,8 +1109,7 @@ alors que la condition correspondant à la section <code class="directive"><a hre </ElseIf> <Else> #... -</Else> - </pre> +</Else></pre> <p>La condition correspondant à la section <code class="directive"><ElseIf></code> est satisfaite si l'adresse @@ -1196,11 +1176,9 @@ lire les fichiers pendant qu'ils sont servis</td></tr> explicitement désactivée pour les fichiers concernés en spécifiant :</p> - <pre class="prettyprint lang-config"> -<Directory "/path-to-nfs-files"> + <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> EnableMMAP Off -</Directory> - </pre> +</Directory></pre> </div> @@ -1260,11 +1238,9 @@ fichiers aux clients</td></tr> explicitement désactivée pour les fichiers concernés en spécifiant :</p> - <pre class="prettyprint lang-config"> -<Directory "/path-to-nfs-files"> + <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> EnableSendfile Off -</Directory> - </pre> +</Directory></pre> <p>Veuillez noter que la configuration de la directive <code class="directive">EnableSendfile</code> dans un contexte de répertoire @@ -1291,8 +1267,7 @@ d'erreur personnalisé</td></tr> directive peut être utilisée pour générer un message d'erreur personnalisé, et interrompre la lecture de la configuration. </p> - <pre class="prettyprint lang-config"> -# Exemple + <pre class="prettyprint lang-config"># Exemple # vérification du chargement de mod_include <IfModule !include_module> Error "mod_include is required by mod_foo. Load it with LoadModule." @@ -1308,8 +1283,7 @@ d'erreur personnalisé</td></tr> <IfDefine !NOSSL> Error "Either SSL or NOSSL must be defined." </IfDefine> -</IfDefine> - </pre> +</IfDefine></pre> @@ -1353,13 +1327,11 @@ d'erreur</td></tr> Alternativement, un message à afficher par le navigateur pourra être fourni. Exemples :</p> - <pre class="prettyprint lang-config"> -ErrorDocument 500 http://foo.example.com/cgi-bin/tester + <pre class="prettyprint lang-config">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! - </pre> +ErrorDocument 403 Forbidden!</pre> <p>De plus, on peut spécifier la valeur spéciale <code>default</code> @@ -1370,13 +1342,11 @@ ErrorDocument 403 Forbidden! les configurations qui sans cela, hériteraient d'une directive <code class="directive">ErrorDocument</code> existante.</p> - <pre class="prettyprint lang-config"> -ErrorDocument 404 /cgi-bin/bad_urls.pl + <pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl <Directory /web/docs> ErrorDocument 404 default -</Directory> - </pre> +</Directory></pre> <p>Notez que lorsque vous spécifiez une directive @@ -1506,10 +1476,8 @@ personnalisation des réponses</a></li> spécifier quelles informations supplémentaires vont être enregistrées dans le journal des erreurs en plus du message habituel.</p> - <pre class="prettyprint lang-config"> -# Exemple simple -ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" - </pre> + <pre class="prettyprint lang-config"># Exemple simple +ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> <p>La spécification de <code>connection</code> ou @@ -1654,10 +1622,8 @@ ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" c'est son identifiant unique qui sera utilisé comme identifiant de journal pour les requêtes.</p> - <pre class="prettyprint lang-config"> -# 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" - </pre> + <pre class="prettyprint lang-config"># 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"</pre> <p>Cet exemple renverrait un message d'erreur du style :</p> @@ -1669,20 +1635,16 @@ ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% <p>Notez que, comme indiqué plus haut, certains champs sont totalement supprimés s'ils n'ont pas été définis.</p> - <pre class="prettyprint lang-config"> -# Exemple (similaire au format 2.2.x) -ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" - </pre> + <pre class="prettyprint lang-config"># Exemple (similaire au format 2.2.x) +ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> - <pre class="prettyprint lang-config"> -# Exemple avancé avec identifiants journal de requête/connexion + <pre class="prettyprint lang-config"># 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" - </pre> +ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre> @@ -1840,26 +1802,22 @@ précisés</td></tr> ou une chaîne de caractères avec caractères génériques, où <code>?</code> remplace un caractère, et <code>*</code> toute chaîne de caractères.</p> - <pre class="prettyprint lang-config"> -<Files "cat.html"> + <pre class="prettyprint lang-config"><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> -</pre> +</Files></pre> <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la caractère <code>~</code>. Par exemple :</p> - <pre class="prettyprint lang-config"> -<Files ~ "\.(gif|jpe?g|png)$"> + <pre class="prettyprint lang-config"><Files ~ "\.(gif|jpe?g|png)$"> #... -</Files> -</pre> +</Files></pre> <p>correspondrait à la plupart des formats graphiques de l'Internet. @@ -1897,16 +1855,30 @@ spécifiés sous la forme d'expressions rationnelles</td></tr> <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par exemple :</p> - <pre class="prettyprint lang-config"> -<FilesMatch "\.(gif|jpe?g|png)$"> + <pre class="prettyprint lang-config"><FilesMatch "\.(gif|jpe?g|png)$"> # ... -</FilesMatch> -</pre> +</FilesMatch></pre> <p>correspondrait à la plupart des formats graphiques de l'Internet.</p> + <p>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 <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. 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.</p> + +<pre class="prettyprint lang-config"><FileMatch ^(?<sitename>[^/]+)> + require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example +</FileMatch></pre> + + + <h3>Voir aussi</h3> <ul> <li><a href="../sections.html">Comment fonctionnent les sections @@ -1945,8 +1917,7 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> <code class="directive">ForceType</code> en affectant la valeur <code>None</code> à l'argument <var>type médium</var> :</p> - <pre class="prettyprint lang-config"> -# force le type MIME de tous les fichiers à image/gif: + <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers à image/gif: <Location /images> ForceType image/gif </Location> @@ -1955,8 +1926,7 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> # dans le sous-répertoire suivant : <Location /images/mixed> ForceType None -</Location> - </pre> +</Location></pre> <p>A la base, cette directive écrase le type de contenu généré pour @@ -2077,6 +2047,9 @@ requête</td></tr> d'environnement (<code>env</code>), et un grand nombre d'autres propriétés. La documentation complète est disponible dans <a href="../expr.html">Les expressions dans le serveur HTTP Apache</a>.</p> + <p>Cette section de configuration ne peut contenir que des + directives qui supportent le <a href="directive-dict.html#Context">contexte de répertoire</a>.</p> + <h3>Voir aussi</h3> <ul> @@ -2135,8 +2108,7 @@ test retourne "vrai" au démarrage du serveur</td></tr> multi-paramètres simple. Exemple :</p> <div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div> - <pre class="prettyprint lang-config"> -<IfDefine ReverseProxy> + <pre class="prettyprint lang-config"><IfDefine ReverseProxy> LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so <IfDefine UseCache> @@ -2148,8 +2120,7 @@ test retourne "vrai" au démarrage du serveur</td></tr> LoadModule cache_disk_module modules/mod_cache_disk.so </IfDefine> </IfDefine> -</IfDefine> - </pre> +</IfDefine></pre> </div> @@ -2250,19 +2221,15 @@ version 2.3.6</td></tr> <p>Exemples :</p> - <pre class="prettyprint lang-config"> -Include /usr/local/apache2/conf/ssl.conf -Include /usr/local/apache2/conf/vhosts/*.conf - </pre> + <pre class="prettyprint lang-config">Include /usr/local/apache2/conf/ssl.conf +Include /usr/local/apache2/conf/vhosts/*.conf</pre> <p>ou encore, avec des chemins relatifs au répertoire défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p> - <pre class="prettyprint lang-config"> -Include conf/ssl.conf -Include conf/vhosts/*.conf - </pre> + <pre class="prettyprint lang-config">Include conf/ssl.conf +Include conf/vhosts/*.conf</pre> <p>On peut aussi insérer des caractères génériques dans la partie @@ -2411,11 +2378,9 @@ certaines méthodes HTTP</td></tr> <code>DELETE</code>, en laissant les autres méthodes sans protection :</p> - <pre class="prettyprint lang-config"> -<Limit POST PUT DELETE> + <pre class="prettyprint lang-config"><Limit POST PUT DELETE> Require valid-user -</Limit> - </pre> +</Limit></pre> <p>La liste des noms de méthodes peut contenir une ou plusieurs @@ -2451,14 +2416,12 @@ certaines méthodes HTTP</td></tr> <code>POST</code>, et la directive <code>Require group editors</code> sera ignorée dans tous les cas :</p> - <pre class="prettyprint lang-config"> -<LimitExcept GET> + <pre class="prettyprint lang-config"><LimitExcept GET> Require valid-user </LimitExcept> <Limit POST> Require group editors -</Limit> - </pre> +</Limit></pre> </div> @@ -2487,11 +2450,9 @@ sauf celles qui sont spécifiées</td></tr> <p>Par exemple :</p> - <pre class="prettyprint lang-config"> -<LimitExcept POST GET> + <pre class="prettyprint lang-config"><LimitExcept POST GET> Require valid-user -</LimitExcept> - </pre> +</LimitExcept></pre> @@ -2800,22 +2761,18 @@ spécifiées</td></tr> directives contenues dans la section s'appliqueront à /private1, /private1/ et /private1/file.txt, mais pas à /private1other. </p> - <pre class="prettyprint lang-config"> -<Location /private1> + <pre class="prettyprint lang-config"><Location /private1> # ... -</Location> - </pre> +</Location></pre> <p> 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. </p> - <pre class="prettyprint lang-config"> -<Location /private2<em>/</em>> + <pre class="prettyprint lang-config"><Location /private2<em>/</em>> # ... -</Location> - </pre> +</Location></pre> <div class="note"><h3>Quand utiliser la section <code class="directive"><Location></code></h3> @@ -2846,11 +2803,9 @@ spécifiées</td></tr> rationnelles</a>, moyennant l'addition d'un caractère <code>~</code>. Par exemple :</p> - <pre class="prettyprint lang-config"> -<Location ~ "/(extra|special)/data"> + <pre class="prettyprint lang-config"><Location ~ "/(extra|special)/data"> #... -</Location> -</pre> +</Location></pre> <p>concernerait les URLs contenant les sous-chaîne @@ -2868,12 +2823,10 @@ spécifiées</td></tr> appartenant au domaine <code>example.com</code>, vous pouvez utiliser :</p> - <pre class="prettyprint lang-config"> -<Location /status> + <pre class="prettyprint lang-config"><Location /status> SetHandler server-status Require host example.com -</Location> - </pre> +</Location></pre> <div class="note"><h3>Note à propos du slash (/)</h3> @@ -2925,16 +2878,30 @@ correspondant à une expression rationnelle</td></tr> spécifier les URLs concernées est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> au lieu d'une simple chaîne de caractères. Par exemple :</p> - <pre class="prettyprint lang-config"> -<LocationMatch "/(extra|special)/data"> + <pre class="prettyprint lang-config"><LocationMatch "/(extra|special)/data"> # ... -</LocationMatch> -</pre> +</LocationMatch></pre> <p>correspondrait à toute URL contenant les sous-chaînes <code>/extra/data</code> ou <code>/special/data</code>.</p> + <p>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 <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. 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.</p> + +<pre class="prettyprint lang-config"><LocationMatch ^/combined/(?<sitename>[^/]+)> + require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example +</LocationMatch></pre> + + + <h3>Voir aussi</h3> <ul> <li><a href="../sections.html">Comment fonctionnent les sections @@ -3129,22 +3096,18 @@ Apache</td></tr> identificateur, avec ou sans le suffixe <code>_module</code>. Les trois spécifications suivantes sont donc équivalentes :</p> - <pre class="prettyprint lang-config"> -LogLevel info ssl:warn + <pre class="prettyprint lang-config">LogLevel info ssl:warn LogLevel info mod_ssl.c:warn -LogLevel info ssl_module:warn - </pre> +LogLevel info ssl_module:warn</pre> <p>Il est aussi possible d'attribuer un niveau de journalisation par répertoire :</p> - <pre class="prettyprint lang-config"> -LogLevel info + <pre class="prettyprint lang-config">LogLevel info <Directory "/usr/local/apache/htdocs/app"> LogLevel debug -</Directory> - </pre> +</Directory></pre> <div class="note"> @@ -3534,10 +3497,8 @@ verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr> mutex par défaut pour tous les autres mutex deviendra <code>sysvsem</code>.</p> - <pre class="prettyprint lang-config"> -Mutex sysvsem default -Mutex fcntl:/var/httpd/locks mpm-accept - </pre> + <pre class="prettyprint lang-config">Mutex sysvsem default +Mutex fcntl:/var/httpd/locks mpm-accept</pre> </div> @@ -3704,15 +3665,13 @@ particulier</td></tr> <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code> :</p> - <pre class="prettyprint lang-config"> -<Directory "/web/docs"> + <pre class="prettyprint lang-config"><Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options Includes -</Directory> - </pre> +</Directory></pre> <p>ici, seule l'option <code>Includes</code> sera prise en compte @@ -3720,15 +3679,13 @@ particulier</td></tr> seconde directive <code class="directive">Options</code> utilise les symboles <code>+</code> et <code>-</code> :</p> - <pre class="prettyprint lang-config"> -<Directory "/web/docs"> + <pre class="prettyprint lang-config"><Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options +Includes -Indexes -</Directory> - </pre> +</Directory></pre> <p>alors, les options <code>FollowSymLinks</code> et @@ -4060,15 +4017,13 @@ serveurs virtuels à base de nom</td></tr> nom</a>. La directive <code class="directive">ServerAlias</code> peut contenir des caractères génériques, si nécessaire.</p> - <pre class="prettyprint lang-config"> -<VirtualHost *:80> + <pre class="prettyprint lang-config"><VirtualHost *:80> ServerName server.example.com ServerAlias server server2.example.com server2 ServerAlias *.example.com UseCanonicalName Off # ... -</VirtualHost> - </pre> +</VirtualHost></pre> <p>La recherche du serveur virtuel à base de nom correspondant au plus près à la requête s'effectue selon l'ordre d'apparition des @@ -4380,22 +4335,18 @@ gestionnaire particulier</td></tr> serveur/status</code> est appelée, vous pouvez ajouter ceci dans <code>httpd.conf</code> :</p> - <pre class="prettyprint lang-config"> -<Location "/status"> + <pre class="prettyprint lang-config"><Location "/status"> SetHandler server-status -</Location> - </pre> +</Location></pre> <p>Vous pouvez aussi utiliser cette directive pour associer un gestionnaire à des fichiers possèdant une extension de nom de fichier particulière. Par exemple :</p> - <pre class="prettyprint lang-config"> -<FilesMatch \.php$> + <pre class="prettyprint lang-config"><FilesMatch \.php$> SetHandler application/x-httpd-php -</FilesMatch> - </pre> +</FilesMatch></pre> <p>Vous pouvez écraser la définition antérieure d'une directive @@ -4460,11 +4411,9 @@ du serveur</td></tr> fichiers du répertoire <code>/www/data/</code> comme des inclusions côté serveur (SSI) :</p> - <pre class="prettyprint lang-config"> -<Directory "/www/data/"> + <pre class="prettyprint lang-config"><Directory "/www/data/"> SetOutputFilter INCLUDES -</Directory> - </pre> +</Directory></pre> <p>Si la directive comporte plusieurs filtres, ils doivent être @@ -4736,15 +4685,13 @@ d'hôte spécifique ou à une adresse IP</td></tr> </ul> - <pre class="prettyprint lang-config"> -<VirtualHost 10.1.2.3:80> + <pre class="prettyprint lang-config"><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> - </pre> +</VirtualHost></pre> @@ -4753,15 +4700,13 @@ d'hôte spécifique ou à une adresse IP</td></tr> déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 :</p> - <pre class="prettyprint lang-config"> -<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> + <pre class="prettyprint lang-config"><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> - </pre> +</VirtualHost></pre> <p>Chaque serveur virtuel doit correspondre à une adresse IP, un @@ -4849,7 +4794,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/core.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); |