core.xml.fr revision a84592bb632899fd65753b227741b5ebe6b3b471
842ae4bd224140319ae7feec1872b93dfd491143fielding<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- English Revision: 1234876:1238701 (outdated) -->
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- French translation : Lucien GENTIS -->
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- Reviewed by : Vincent Deffontaines -->
2d2eda71267231c2526be701fe655db125852c1ffielding Licensed to the Apache Software Foundation (ASF) under one or more
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd contributor license agreements. See the NOTICE file distributed with
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd this work for additional information regarding copyright ownership.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd The ASF licenses this file to You under the Apache License, Version 2.0
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd (the "License"); you may not use this file except in compliance with
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd the License. You may obtain a copy of the License at
0432a26b69eedfb9ca5f34fba590236378a24851ben Unless required by applicable law or agreed to in writing, software
0432a26b69eedfb9ca5f34fba590236378a24851ben distributed under the License is distributed on an "AS IS" BASIS,
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bf6b5eb3bf3c4a71e6146d4bcd07cf1749dc6d70jorton See the License for the specific language governing permissions and
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh limitations under the License.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<description>Fonctionnalités de base du serveur HTTP Apache toujours
bf6b5eb3bf3c4a71e6146d4bcd07cf1749dc6d70jortondisponibles</description>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Permet d'optimiser la configuration d'une socket pour
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianhl'écoute d'un protocole</description>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<contextlist><context>server config</context></contextlist>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<compatibility>Disponible depuis la version 2.3.3 sous Windows et 2.1.5
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbbsur les autres plates-formes.</compatibility>
30c289e6bc6d28d210b21edd800ab2cfc78a8381wrowe <p>Cette directive permet d'effectuer une optimisation de la socket
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein d'écoute d'un type de protocole en fonction du système
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein d'exploitation. Le but premier est de faire en sorte que le noyau
cd39d2139743ca0ef899953c6496dcf99e9c791atrawick n'envoie pas de socket au processus du serveur jusqu'à ce que
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein des données soient reçues, ou qu'une requête HTTP complète soit mise
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton en tampon. Seuls les <a
b627048681b27fe30f979ba471b523be3a6a22adrbb href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein sektion=9">Filtres d'acceptation de FreeBSD</a>, le filtre plus
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version
44c46ef733836b32585d135d2d90856e7cfd9929rbb optimisée d'AcceptEx() de Windows sont actuellement supportés.</p>
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb <p>L'utilisation de l'argument <code>none</code> va désactiver tout
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna protocoles qui nécessitent l'envoi de données par le serveur en
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb premier, comme <code>ftp:</code> ou <code>nntp</code>:</p>
ef5650b61a8e35f3cc93ec07e73efc17ea329894jorton <p>Les noms de protocoles par défaut sont <code>https</code> pour le
7c7372abe2484e7fcf81937b93496d1246e5b816gstein port 443 et <code>http</code> pour tous les autres ports. Pour
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton spécifier un autre protocole à utiliser avec un port en écoute,
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton ajoutez l'argument <var>protocol</var> à la directive <directive
d71fd7cd9c4815d0647425f21ba3a803919a9148jorton <p>Sous FreeBSD, les valeurs par défaut sont :</p>
7c7372abe2484e7fcf81937b93496d1246e5b816gstein AcceptFilter http httpready <br/>
7c7372abe2484e7fcf81937b93496d1246e5b816gstein AcceptFilter https dataready
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Le filtre d'acceptation <code>httpready</code> met en tampon des
2d2eda71267231c2526be701fe655db125852c1ffielding requêtes HTTP entières au niveau du noyau. Quand une requête
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh entière a été reçue, le noyau l'envoie au serveur. Voir la page de
2d2eda71267231c2526be701fe655db125852c1ffielding manuel de <a
2d2eda71267231c2526be701fe655db125852c1ffielding href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&
2d2eda71267231c2526be701fe655db125852c1ffielding sektion=9">accf_http(9)</a> pour plus de détails. Comme les requêtes
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Sous Linux, les valeurs par défaut sont :</p>
dd5cbadf2df719db2f3c769d03ec847da25854e6bnicholes AcceptFilter http data <br/>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh AcceptFilter https data
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas
2d2eda71267231c2526be701fe655db125852c1ffielding la mise en tampon des requêtes http. Toute valeur autre que
2d2eda71267231c2526be701fe655db125852c1ffielding <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code>
2d2eda71267231c2526be701fe655db125852c1ffielding pour ce protocole. Pour plus de détails, voir la page de
2d2eda71267231c2526be701fe655db125852c1ffielding manuel Linux de <a
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>Sous Windows, les valeurs par défaut sont :</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AcceptFilter http data <br/>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AcceptFilter https data
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </example>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Le module MPM pour Windows mpm_winnt utilise la directive
2d2eda71267231c2526be701fe655db125852c1ffielding AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte
2d2eda71267231c2526be701fe655db125852c1ffielding pas la mise en tampon du protocole http. Deux valeurs utilisent
2d2eda71267231c2526be701fe655db125852c1ffielding l'API Windows AcceptEx() et vont recycler les sockets réseau entre
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh les connexions. <code>data</code> attend jusqu'à ce que les données
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh aient été transmises comme décrit plus haut, et le tampon de données
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh initiales ainsi que les adresses réseau finales sont tous extraits
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh grâce à une seule invocation d'AcceptEx(). <code>connect</code>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh utilise l'API AcceptEx(), extrait aussi les adresses réseau finales,
2d2eda71267231c2526be701fe655db125852c1ffielding mais à l'instar de <code>none</code>, la valeur <code>connect</code>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh n'attend pas la transmission des données initiales.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Sous Windows, <code>none</code> utilise accept() au lieu
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh d'AcceptEx(), et ne recycle pas les sockets entre les connexions.
2d2eda71267231c2526be701fe655db125852c1ffielding Ceci s'avère utile pour les interfaces réseau dont le pilote est
a0bd5cdd79004f4b7b1b441e38133519d3e20a1fsf défectueux, ainsi que pour certains fournisseurs de réseau comme les
2d2eda71267231c2526be701fe655db125852c1ffielding pilotes vpn, ou les filtres anti-spam, anti-virus ou
2d2eda71267231c2526be701fe655db125852c1ffielding anti-spyware.</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh</directivesynopsis>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Les ressources acceptent des informations sous forme d'un
2d2eda71267231c2526be701fe655db125852c1ffieldingnom de chemin en fin de requête.</description>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<context>virtual host</context><context>directory</context>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh<compatibility>Disponible dans Apache httpd version 2.0.30 et
4a13940dc2990df0a798718d3a3f9cf1566c2217bjhsupérieures</compatibility>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Cette directive permet de définir si les requêtes contenant des
2d2eda71267231c2526be701fe655db125852c1ffielding informations sous forme d'un nom de chemin suivant le nom d'un
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh fichier réel (ou un fichier qui n'existe pas dans un répertoire qui
2d2eda71267231c2526be701fe655db125852c1ffielding existe) doivent être acceptées ou rejetées. Les scripts peuvent
2d2eda71267231c2526be701fe655db125852c1ffielding accéder à cette information via la variable d'environnement
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Supposons par exemple que <code>/test/</code> pointe vers un
2d2eda71267231c2526be701fe655db125852c1ffielding répertoire qui ne contient que le fichier <code>here.html</code>.
2d2eda71267231c2526be701fe655db125852c1ffielding Les requêtes pour <code>/test/here.html/more</code> et
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/test/nothere.html/more</code> vont affecter la valeur
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/more</code> à la variable d'environnement
dbbf1b4183ae16353011a5269b37899f02b97d81gregames <p>L'argument de la directive <directive>AcceptPathInfo</directive>
2d2eda71267231c2526be701fe655db125852c1ffielding possède trois valeurs possibles :</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <dt><code>Off</code></dt><dd>Une requête ne sera acceptée que si
2d2eda71267231c2526be701fe655db125852c1ffielding elle correspond à un chemin qui existe. Par conséquent, une requête
e9a0000eb55887c0278a9184d501812f5e056dbfjim contenant une information de chemin après le nom de fichier réel
2d2eda71267231c2526be701fe655db125852c1ffielding comme <code>/test/here.html/more</code> dans l'exemple ci-dessus
2d2eda71267231c2526be701fe655db125852c1ffielding renverra une erreur "404 NOT FOUND".</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding <dt><code>On</code></dt><dd>Une requête sera acceptée si la partie
ee1af2aeb57527f33baa4737aa431e4aef997855rbowen principale du chemin correspond à un fichier existant. Dans
2d2eda71267231c2526be701fe655db125852c1ffielding l'exemple ci-dessus <code>/test/here.html/more</code>, la requête
2d2eda71267231c2526be701fe655db125852c1ffielding sera acceptée si <code>/test/here.html</code> correspond à un nom de
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh fichier valide.</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding <dt><code>Default</code></dt><dd>Le traitement des requêtes est
2d2eda71267231c2526be701fe655db125852c1ffielding déterminé par le <a
2d2eda71267231c2526be701fe655db125852c1ffielding href="/handler.html">gestionnaire</a> responsable de la requête.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh Le gestionnaire de base pour les fichiers normaux rejette par défaut
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui
2d2eda71267231c2526be701fe655db125852c1ffielding servent des scripts, comme<a
2d2eda71267231c2526be701fe655db125852c1ffielding href="mod_isapi.html">isapi-handler</a>, acceptent en général par
2d2eda71267231c2526be701fe655db125852c1ffielding défaut les requêtes avec <code>PATH_INFO</code>.</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Le but premier de la directive <code>AcceptPathInfo</code> est de
2d2eda71267231c2526be701fe655db125852c1ffielding vous permettre de remplacer le choix du gestionnaire d'accepter ou
2d2eda71267231c2526be701fe655db125852c1ffielding de rejeter <code>PATH_INFO</code>. Ce remplacement est nécessaire
ee7882748b83255e50ea6bc3b3fdc8ee0949e2e3jorton par exemple, lorsque vous utilisez un <a
2d2eda71267231c2526be701fe655db125852c1ffielding href="mod_include.html">INCLUDES</a>, pour générer un contenu basé
2d2eda71267231c2526be701fe655db125852c1ffielding sur <code>PATH_INFO</code>. Le gestionnaire de base va en général
2d2eda71267231c2526be701fe655db125852c1ffielding rejeter la requête, et vous pouvez utiliser la configuration
2d2eda71267231c2526be701fe655db125852c1ffielding suivante pour utiliser un tel script :</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim Options +Includes<br />
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh SetOutputFilter INCLUDES<br />
2d2eda71267231c2526be701fe655db125852c1ffielding AcceptPathInfo On<br />
742318b93e89c311f66b55f426c4d9cf2c14628bjim </Files>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh </example>
742318b93e89c311f66b55f426c4d9cf2c14628bjim</directivesynopsis>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<directivesynopsis>
2efb935ae8fe12d5192a3bf2c52c28461b6c68afdgaudet<description>Nom du fichier de configuration distribué</description>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<contextlist><context>server config</context><context>virtual
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbbhost</context>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</contextlist>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>Au cours du traitement d'une requête, le serveur recherche le
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh premier fichier de configuration existant à partir de la liste
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb de noms dans chaque répertoire composant le chemin du document, à
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb partir du moment où les fichiers de configuration distribués sont <a
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb href="#allowoverride">activés pour ce répertoire</a>. Par exemple
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AccessFileName .acl
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </example>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>avant de renvoyer le document
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>/usr/local/web/index.html</code>, le serveur va rechercher les
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb pour y lire d'éventuelles directives, à moins quelles n'aient été
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb désactivées avec</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <Directory /><br />
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb AllowOverride None<br />
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </Directory>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh </example>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<seealso><directive module="core">AllowOverride</directive></seealso>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<seealso><a href="/configuring.html">Fichiers de configuration</a></seealso>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<seealso><a href="/howto/htaccess.html">Fichiers .htaccess</a></seealso>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb</directivesynopsis>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<directivesynopsis>
99d6d3207e24ba1f8eba77ef903948d738886cf5nd<description>Paramètre jeu de caractères par défaut à ajouter quand le
99d6d3207e24ba1f8eba77ef903948d738886cf5ndtype de contenu d'une réponse est <code>text/plain</code> ou
99d6d3207e24ba1f8eba77ef903948d738886cf5nd<syntax>AddDefaultCharset On|Off|<var>jeu de caractères</var></syntax>
99d6d3207e24ba1f8eba77ef903948d738886cf5nd<context>virtual host</context><context>directory</context>
99d6d3207e24ba1f8eba77ef903948d738886cf5nd <p>Cette directive spécifie une valeur par défaut pour le paramètre
99d6d3207e24ba1f8eba77ef903948d738886cf5nd jeu de caractères du type de média (le nom d'un codage de
99d6d3207e24ba1f8eba77ef903948d738886cf5nd caractères) à ajouter à une réponse, si et seulement si le type de
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb contenu de la réponse est soit <code>text/plain</code>, soit
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb tout jeu de caractères spécifié dans le corps de la réponse via un
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh élément <code>META</code>, bien que cet effet dépende en fait
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb souvent de la configuration du client de l'utilisateur. La
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh définition de <code>AddDefaultCharset Off</code> désactive cette
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb fonctionnalité. <code>AddDefaultCharset On</code> ajoute un jeu de
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb caractères par défaut de <code>iso-8859-1</code>. Toute autre valeur
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb peut être définie via le paramètre <var>jeu de caractères</var>, qui
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb doit appartenir à la liste des <a
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh href="http://www.iana.org/assignments/character-sets">valeurs de
11e076839c8d5a82d55e710194d0daac51390dbdsf jeux de caractères enregistrés par l'IANA</a> à utiliser dans les
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh types de média Internet (types MIME).
11e076839c8d5a82d55e710194d0daac51390dbdsf Par exemple :</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben AddDefaultCharset utf-8
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben </example>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>La directive <directive>AddDefaultCharset</directive> ne doit
11e076839c8d5a82d55e710194d0daac51390dbdsf être utilisée que lorsque toutes les ressources textes auxquelles
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben elle s'applique possèdent le jeu de caractère spécifié, et qu'il est
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben trop contraignant de définir leur jeu de caractères
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben individuellement. Un exemple de ce type est l'ajout du paramètre jeu
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben de caractères aux ressources comportant un contenu généré, comme les
11e076839c8d5a82d55e710194d0daac51390dbdsf scripts CGI hérités qui peuvent être vulnérables à des attaques de
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben type cross-site scripting à cause des données utilisateurs incluses
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben dans leur sortie. Notez cependant qu'une meilleur solution consiste
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben à corriger (ou supprimer) ces scripts, car la définition d'un jeu de
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben caractères par défaut ne protège pas les utilisateurs qui ont activé
11e076839c8d5a82d55e710194d0daac51390dbdsf la fonctionnalité "Détection automatique de l'encodage des
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb caractères" dans leur navigateur.</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<seealso><directive module="mod_mime">AddCharset</directive></seealso>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh</directivesynopsis>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<directivesynopsis>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<description>Détermine si les séparateurs de chemin encodés sont
1374444b4fab1475091e12a81663f379b73005efrbbautorisés à transiter dans les URLs tels quels</description>
bbe046d7cbb950ab3e372e4119ae001a5fe52ed4striker<contextlist><context>server config</context><context>virtual
bbe046d7cbb950ab3e372e4119ae001a5fe52ed4strikerhost</context>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh</contextlist>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<compatibility>Disponible dans Apache httpd version 2.0.46 et
742318b93e89c311f66b55f426c4d9cf2c14628bjimsupérieures. L'option NoDecode est disponible depuis la version
c8aa00ee0cfc17b5fa08fb8a2b08d30dc9e4f1b1wrowe2.3.12.</compatibility>
4542d057c4bde23857f31d449fa3108561206139wrowe <p>La directive <directive>AllowEncodedSlashes</directive> permet
c8aa00ee0cfc17b5fa08fb8a2b08d30dc9e4f1b1wrowe l'utilisation des URLs contenant des séparateurs de chemin
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh encodés dans la partie chemin
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>\</code> sur les systèmes concernés).</p>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh refusées et provoquent le renvoi d'une erreur 404 (Not found).</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les
11e076839c8d5a82d55e710194d0daac51390dbdsf slashes encodés sont décodés comme tout autre caractère codé.</p>
11e076839c8d5a82d55e710194d0daac51390dbdsf <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées,
742318b93e89c311f66b55f426c4d9cf2c14628bjim mais les slashes codés ne sont pas décodés et laissés dans leur état
6d74c65f131583f6832b04424c1a9e1e7cc72c8egregames codé.</p>
6d74c65f131583f6832b04424c1a9e1e7cc72c8egregames <p>Définir <directive>AllowEncodedSlashes</directive> à
6d74c65f131583f6832b04424c1a9e1e7cc72c8egregames <code>On</code> est surtout utile en association avec
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Si le codage des slashes dans la partie chemin est nécessaire,
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh l'utilisation de l'option <code>NoDecode</code> est fortement
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh recommandée par mesure de sécurité. Permettre le décodage des
11e076839c8d5a82d55e710194d0daac51390dbdsf slashes pourrait éventuellement induire l'autorisation de chemins
2e123e8beedc9f921448c113e2d6823a92fd5261fielding non sûrs.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<seealso><directive module="core">AcceptPathInfo</directive></seealso>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben</directivesynopsis>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<directivesynopsis>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<description>Types de directives autorisées dans les fichiers
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<default>AllowOverride None à partir de la version 2.3.9, AllowOverride
759f4a24d09e28c4eaca9f97311b497fc15cb5c7benAll pour les versions antérieures</default>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben le nom est défini par la directive <directive
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben module="core">AccessFileName</directive>), il doit savoir lesquelles
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe des directives placées dans ce fichier sont autorisées à modifier la
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe configuration préexistante.</p>
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe <Directory></title>
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe La directive <directive>AllowOverride</directive> ne peut être
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe utilisée que dans les sections <directive type="section"
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe module="core">Directory</directive> définies sans expressions
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe rationnelles, et non dans les sections <directive
64b9fa4bc3e79b0eefb2d93fb56eae40d88e0f06wrowe type="section" module="core">Location</directive>, <directive
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben module="core" type="section">DirectoryMatch</directive> ou
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <directive type="section" module="core">Files</directive>.
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh module="core">AllowOverrideList</directive> sont définies à <code>None</code>, les
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh fichiers <a href="#accessfilename">.htaccess</a> sont totalement
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben fichiers <code>.htaccess</code> du système de fichiers.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>Lorsque cette directive est définie à <code>All</code>, toute
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh directive valable dans le <a
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh href="directive-dict.html#Context">Contexte</a> .htaccess sera
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh autorisée dans les fichiers <code>.htaccess</code>.</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>L'argument <var>type directive</var> peut contenir les
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh groupements de directives suivants :</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim Permet l'utilisation des directives d'autorisation (<directive
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd <directive module="mod_authn_dbm">AuthDBMUserFile</directive>,
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd <directive module="mod_authz_groupfile">AuthGroupFile</directive>,
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd <directive module="mod_authn_core">AuthType</directive>, <directive
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd module="mod_authn_file">AuthUserFile</directive>, <directive
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd module="mod_authz_core">Require</directive>, <em>etc...</em>).</dd>
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd Permet l'utilisation des directives qui contrôlent les types de
d11bf78168abbb07d8ed9f54d7ea0953d46aad83nd documents (directives <directive
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb <directive module="core">SetHandler</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="core">SetInputFilter</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="core">SetOutputFilter</directive>, et directives du
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module <module>mod_mime</module> Add* et Remove*), des metadonnées
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick des documents (<directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_headers">RequestHeader</directive>, <directive
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb module="mod_setenvif">SetEnvIfNoCase</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_setenvif">BrowserMatch</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_usertrack">CookieExpires</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_usertrack">CookieDomain</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_usertrack">CookieStyle</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_usertrack">CookieTracking</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_usertrack">CookieName</directive>), des directives du
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_rewrite">RewriteEngine</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_rewrite">RewriteOptions</directive>, <directive
1ce78cf71b5baaf2c1ab48e818cb1f2397df5010trawick module="mod_rewrite">RewriteBase</directive>, <directive
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben module="mod_rewrite">RewriteCond</directive>, <directive
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb module="mod_rewrite">RewriteRule</directive>) et de la directive
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb <directive module="mod_actions">Action</directive> du module
3d96ee83babeec32482c9082c9426340cee8c44dwrowe Permet l'utilisation des directives qui contrôlent l'indexation
2d2eda71267231c2526be701fe655db125852c1ffielding des répertoires (<directive
ceb14f8ba57a8086c9a68ad264efbe2433134382covener <directive module="mod_autoindex">AddIcon</directive>, <directive
11e076839c8d5a82d55e710194d0daac51390dbdsf <directive module="mod_autoindex">AddIconByType</directive>,
11e076839c8d5a82d55e710194d0daac51390dbdsf <directive module="mod_autoindex">DefaultIcon</directive>, <directive
11e076839c8d5a82d55e710194d0daac51390dbdsf module="mod_autoindex">FancyIndexing</directive>, <directive
742318b93e89c311f66b55f426c4d9cf2c14628bjim module="mod_autoindex">HeaderName</directive>, <directive
b0d8a6d437db6f4c222173f27ef81c98622fbd02pquerna module="mod_autoindex">IndexIgnore</directive>, <directive
2d2eda71267231c2526be701fe655db125852c1ffielding module="mod_autoindex">IndexOptions</directive>, <directive
ceb14f8ba57a8086c9a68ad264efbe2433134382covener Permet l'utilisation des directives contrôlant l'accès au serveur
ceb14f8ba57a8086c9a68ad264efbe2433134382covener (<directive
ceb14f8ba57a8086c9a68ad264efbe2433134382covener module="mod_authz_host">Allow</directive>, <directive
ceb14f8ba57a8086c9a68ad264efbe2433134382covener module="mod_authz_host">Deny</directive> et <directive
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh Permet l'utilisation des directives contrôlant les fonctionnalités
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh spécifiques d'un répertoire (<directive
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm module="mod_include">XBitHack</directive>). "Options" doit être
2d2eda71267231c2526be701fe655db125852c1ffielding suivi d'un signe "égal", puis d'une liste d'options séparées par des
cf35a54aa4b61245bf315cc594f8809c1cf31729geoff virgules (pas d'espaces) ; ces options doivent être définies à
2d2eda71267231c2526be701fe655db125852c1ffielding l'aide de la commande <directive
2d2eda71267231c2526be701fe655db125852c1ffielding <note><title>Désactivation implicite des options</title>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Bien que la liste des options disponibles dans les fichiers
2d2eda71267231c2526be701fe655db125852c1ffielding .htaccess puisse être limitée par cette directive, tant qu'un
2d2eda71267231c2526be701fe655db125852c1ffielding directive <directive module="core">Options</directive> est
2d2eda71267231c2526be701fe655db125852c1ffielding autorisée, toute autre option héritée peut être désactivée en
2d2eda71267231c2526be701fe655db125852c1ffielding utilisant la syntaxe non-relative. En d'autres termes, ce
2d2eda71267231c2526be701fe655db125852c1ffielding mécanisme ne peut pas forcer une option spécifique à rester
2d2eda71267231c2526be701fe655db125852c1ffielding <em>activée</em> tout en permettant à toute autre option d'être
2d2eda71267231c2526be701fe655db125852c1ffielding activée.
2d2eda71267231c2526be701fe655db125852c1ffielding AllowOverride AuthConfig Indexes
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Dans l'exemple ci-dessus, toutes les directives qui ne font
2d2eda71267231c2526be701fe655db125852c1ffielding partie ni du groupe <code>AuthConfig</code>, ni du groupe
2d2eda71267231c2526be701fe655db125852c1ffielding <code>Indexes</code>, provoquent une erreur "internal
2d2eda71267231c2526be701fe655db125852c1ffielding server error".</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <note><p>Pour des raisons de sécurité et de performance, ne
2d2eda71267231c2526be701fe655db125852c1ffielding définissez pas <code>AllowOverride</code> à autre chose que
2d2eda71267231c2526be701fe655db125852c1ffielding <code>None</code> dans votre bloc <code><Directory /></code>.
2d2eda71267231c2526be701fe655db125852c1ffielding Recherchez plutôt (ou créez) le bloc <code><Directory></code>
2d2eda71267231c2526be701fe655db125852c1ffielding qui se réfère au répertoire où vous allez précisément placer un
2d2eda71267231c2526be701fe655db125852c1ffielding<seealso><directive module="core">AccessFileName</directive></seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding<seealso><directive module="core">AllowOverrideList</directive></seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding<seealso><a href="/configuring.html">Fichiers de configuration</a></seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding<seealso><a href="/howto/htaccess.html">Fichiers .htaccess</a></seealso>
4d88cba691cf0cc222161dc403067071eca58751rbb</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Directives autorisées dans les fichiers <code>.htaccess</code></description>
2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>directory</context></contextlist>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Lorsque le serveur trouve un fichier <code>.htaccess</code>
2d2eda71267231c2526be701fe655db125852c1ffielding (comme spécifié par la directive <directive
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh module="core">AccessFileName</directive>), il doit savoir lesquelles
2d2eda71267231c2526be701fe655db125852c1ffielding des directives déclarées dans ce fichier peuvent remplacer des
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh directives des fichiers de configuration du serveur.</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <note><title>Seulement disponible dans les sections <Directory></title>
2d2eda71267231c2526be701fe655db125852c1ffielding La directive <directive>AllowOverrideList</directive> n'est
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh disponible que dans les sections <directive type="section"
2d2eda71267231c2526be701fe655db125852c1ffielding module="core">Directory</directive> spécifiées sans expressions
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh rationnelles.
2d2eda71267231c2526be701fe655db125852c1ffielding module="core">AllowOverride</directive> sont définies à
2d2eda71267231c2526be701fe655db125852c1ffielding href="#accessfilename">.htaccess</a> sont totalement ignorés. Dans
2d2eda71267231c2526be701fe655db125852c1ffielding ce cas, le serveur ne cherchera même pas à lire des fichiers
2d2eda71267231c2526be701fe655db125852c1ffielding <code>.htaccess</code> dans le système de fichiers.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding AllowOverride None<br />
11e076839c8d5a82d55e710194d0daac51390dbdsf AllowOverrideList Redirect RedirectMatch
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh </example>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Dans l'exemple ci-dessus, seules les directives
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh Toutes les autres provoqueront une erreur interne du serveur.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding AllowOverride AuthConfig<br />
2d2eda71267231c2526be701fe655db125852c1ffielding AllowOverrideList CookieTracking CookieName
763f7b125b6d3dd1e4992a3822005efa2616f983coar </example>
2d2eda71267231c2526be701fe655db125852c1ffielding module="core">AllowOverride</directive> autorise les directives du
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <directive>AllowOverrideList</directive> n'autorise que deux
5a9667916c79d8c699b069068e5570aa1c331c80gstein directives du groupement <code>FileInfo</code>. Toutes les autres
5a9667916c79d8c699b069068e5570aa1c331c80gstein provoqueront une erreur interne du serveur.</p>
5a9667916c79d8c699b069068e5570aa1c331c80gstein<seealso><directive module="core">AccessFileName</directive></seealso>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<seealso><directive module="core">AllowOverride</directive></seealso>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<seealso><a href="/configuring.html">Fichiers de configuration</a></seealso>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<seealso><a href="/howto/htaccess.html">Fichiers .htaccess</a></seealso>
5a9667916c79d8c699b069068e5570aa1c331c80gstein</directivesynopsis>
5a9667916c79d8c699b069068e5570aa1c331c80gstein<directivesynopsis>
5a9667916c79d8c699b069068e5570aa1c331c80gstein<description>Technique permettant de localiser l'interpréteur des
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianhscripts CGI</description>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<syntax>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></syntax>
5a9667916c79d8c699b069068e5570aa1c331c80gstein<contextlist><context>directory</context><context>.htaccess</context>
5a9667916c79d8c699b069068e5570aa1c331c80gstein</contextlist>
5a9667916c79d8c699b069068e5570aa1c331c80gstein <p>Cette directive permet de contrôler la manière dont Apache httpd trouve
5a9667916c79d8c699b069068e5570aa1c331c80gstein l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec
5a9667916c79d8c699b069068e5570aa1c331c80gstein la définition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous
5a9667916c79d8c699b069068e5570aa1c331c80gstein les fichiers scripts CGI possédant une extension <code>.foo</code>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh seront passés à l'interpréteur FOO.</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh</directivesynopsis>
62db15de4c1f335a64d45821796ae197cff94ef8rbb<directivesynopsis>
62db15de4c1f335a64d45821796ae197cff94ef8rbb<description>Active la génération d'un en-tête <code>Content-MD5</code>
2d2eda71267231c2526be701fe655db125852c1ffieldingdans la réponse HTTP</description>
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb<contextlist><context>server config</context><context>virtual
5a9667916c79d8c699b069068e5570aa1c331c80gsteinhost</context>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<context>directory</context><context>.htaccess</context>
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb</contextlist>
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb <p>Cette directive active la génération d'un en-tête
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <code>Content-MD5</code> selon les définitions des RFC 1864 et
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>MD5 est un algorithme permettant de générer un condensé (parfois
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh appelé "empreinte") à partir de données d'une taille aléatoire ; le
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar degré de précision est tel que la moindre altération des données
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb d'origine entraîne une altération de l'empreinte.</p>
62db15de4c1f335a64d45821796ae197cff94ef8rbb <p>L'en-tête <code>Content-MD5</code> permet de vérifier
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar ou un client peut utiliser cet en-tête pour rechercher une
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb éventuelle modification accidentelle de la réponse au cours de sa
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh transmission. Exemple d'en-tête :</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh </example>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Notez que des problèmes de performances peuvent affecter votre
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh serveur, car l'empreinte est générée pour chaque requête (il n'y a
2d2eda71267231c2526be701fe655db125852c1ffielding pas de mise en cache).</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh documents servis par le module <module>core</module>, à l'exclusion
2d2eda71267231c2526be701fe655db125852c1ffielding de tout autre module. Ainsi, les documents SSI, les sorties de
2d2eda71267231c2526be701fe655db125852c1ffielding scripts CGI, et les réponses à des requêtes partielles (byte range)
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh ne comportent pas cet en-tête.</p>
db3fa7db7c7910f2f23c3e3ffe0cf9f41a1899b9trawick</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Les seuls effets de cette directive sont des émissions
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianhd'avertissements si sa valeur est différente de <code>none</code>. Dans
54e94821097724bf413d2d4cc70711760f7494e1trawickles versions précédentes, DefaultType permettait de spécifier un type de
db3fa7db7c7910f2f23c3e3ffe0cf9f41a1899b9trawickmédia à assigner par défaut au contenu d'une réponse pour lequel aucun
54e94821097724bf413d2d4cc70711760f7494e1trawickautre type de média n'avait été trouvé.
54e94821097724bf413d2d4cc70711760f7494e1trawick</description>
54e94821097724bf413d2d4cc70711760f7494e1trawick<syntax>DefaultType <var>type média|none</var></syntax>
54e94821097724bf413d2d4cc70711760f7494e1trawick<contextlist><context>server config</context><context>virtual
54e94821097724bf413d2d4cc70711760f7494e1trawickhost</context>
54e94821097724bf413d2d4cc70711760f7494e1trawick<context>directory</context><context>.htaccess</context>
54e94821097724bf413d2d4cc70711760f7494e1trawick</contextlist>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<compatibility>L'argument <code>none</code> est disponible dans les
c8477d12d1b127ab46dffe4ee526b9d11f71699egregamesversions d'Apache httpd 2.2.7 et supérieures. Tous les autres choix sont
c8477d12d1b127ab46dffe4ee526b9d11f71699egregamesDESACTIVÉS à partir des version 2.3.x.</compatibility>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>Cette directive a été désactivée. Pour la compatibilité
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh ascendante avec les anciens fichiers de configuration, elle peut
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh être spécifiée avec la valeur <code>none</code>, c'est à dire sans
2d2eda71267231c2526be701fe655db125852c1ffielding type de médium par défaut. Par exemple :</p>
2d2eda71267231c2526be701fe655db125852c1ffielding DefaultType None
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh </example>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><code>DefaultType None</code> n'est disponible que dans les
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh versions d'Apache 2.2.7 et supérieures.</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Utilisez le fichier de configuration mime.types et la directive
2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="mod_mime">AddType</directive> pour configurer
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe l'assignement d'un type de médium via les extensions de fichiers, ou
742318b93e89c311f66b55f426c4d9cf2c14628bjim la directive <directive module="core">ForceType</directive> pour
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh attribuer un type de médium à des ressources spécifiques. Dans le
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe cas contraire, le serveur enverra sa réponse sans champ d'en-tête
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe Content-Type, et le destinataire devra déterminer lui-même le type
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe de médium.</p>
e57fd661645dcfdf166e77484b509b248e62a19eaaron</directivesynopsis>
e57fd661645dcfdf166e77484b509b248e62a19eaaron<directivesynopsis>
e57fd661645dcfdf166e77484b509b248e62a19eaaron<description>Permet de définir une variable</description>
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe<syntax>Define <var>nom-paramètre</var> [<var>valeur-paramètre</var>]</syntax>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<contextlist><context>server config</context><context>virtual host</context>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Avec un seul paramètre, l'effet de la directive
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <directive>Define</directive> est identique à celui de l'argument
2d2eda71267231c2526be701fe655db125852c1ffielding <code>-D</code> du programme <program>httpd</program>. Il permet de
2d2eda71267231c2526be701fe655db125852c1ffielding modifier le comportement des sections <directive module="core"
2d2eda71267231c2526be701fe655db125852c1ffielding type="section">IfDefine</directive> sans avoir à ajouter d'argument
2d2eda71267231c2526be701fe655db125852c1ffielding <code>-D</code> au sein des scripts de démarrage.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>De plus, le second paramètre permet d'affecter une valeur à la
2d2eda71267231c2526be701fe655db125852c1ffielding variable définie par le premier. Cette variable peut être référencée
2d2eda71267231c2526be701fe655db125852c1ffielding dans le fichier de configuration via la syntaxe <code>${VAR}</code>.
2d2eda71267231c2526be701fe655db125852c1ffielding La portée de la variable est toujours globale, et n'est jamais
2d2eda71267231c2526be701fe655db125852c1ffielding limitée à la section de configuration courante.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <IfDefine TEST><br/>
2d2eda71267231c2526be701fe655db125852c1ffielding </IfDefine><br/>
2d2eda71267231c2526be701fe655db125852c1ffielding <IfDefine !TEST><br/>
952908500d5f99f35afc5ed510391b9bdc3833farbb Define SSL<br/>
952908500d5f99f35afc5ed510391b9bdc3833farbb </IfDefine><br/>
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
103a93c625bcde1a6a7a5155b64dcda36f612180pquerna <p>Le caractère ":" est interdit dans les noms de variables afin
103a93c625bcde1a6a7a5155b64dcda36f612180pquerna d'éviter les conflits avec la syntaxe de la directive <directive
952908500d5f99f35afc5ed510391b9bdc3833farbb</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Regroupe un ensemble de directives qui ne s'appliquent
2d2eda71267231c2526be701fe655db125852c1ffieldingqu'au répertoire concerné du système de fichiers, à ses
3887202241db08986e94b252fbd06a55e55d4b2dbhydesous-répertoires, et à leur contenu.</description>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde<syntax><Directory <var>chemin répertoire</var>>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde... </Directory></syntax>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde<contextlist><context>server config</context><context>virtual
3887202241db08986e94b252fbd06a55e55d4b2dbhydehost</context>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde</contextlist>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>Les balises <directive type="section">Directory</directive> et
3887202241db08986e94b252fbd06a55e55d4b2dbhyde <code></Directory></code> permettent de regrouper un ensemble
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh de directives qui ne s'appliquent qu'au répertoire précisé,
2d2eda71267231c2526be701fe655db125852c1ffielding à ses sous-répertoires, et aux fichiers situés dans ces
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh sous-répertoires. Toute directive
3887202241db08986e94b252fbd06a55e55d4b2dbhyde autorisée dans un contexte de répertoire peut être utilisée.
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <var>chemin répertoire</var> est soit le chemin absolu d'un
2d2eda71267231c2526be701fe655db125852c1ffielding répertoire, soit une chaîne de caractères avec caractères génériques
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna utilisant la comparaison Unix de style shell. Dans une chaîne de
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna caractères avec caractères génériques, <code>?</code> correspond à
2d2eda71267231c2526be701fe655db125852c1ffielding un caractère quelconque, et <code>*</code> à toute chaîne de
7c7372abe2484e7fcf81937b93496d1246e5b816gstein caractères. Les intervalles de caractères <code>[]</code> sont aussi
7c7372abe2484e7fcf81937b93496d1246e5b816gstein autorisés. Aucun caractère générique ne peut remplacer le caractère
864c5615d55b8ebbde24e72043f6325741335a74fielding `/', si bien que l'expression <code><Directory
2d2eda71267231c2526be701fe655db125852c1ffielding /*/public_html></code> ne conviendra pas pour le chemin
742318b93e89c311f66b55f426c4d9cf2c14628bjim * <code>/home/user/public_html</code>, alors que <code><Directory
742318b93e89c311f66b55f426c4d9cf2c14628bjim /home/*/public_html></code> conviendra. Exemple :</p>
e57fd661645dcfdf166e77484b509b248e62a19eaaron Options Indexes FollowSymLinks<br />
952908500d5f99f35afc5ed510391b9bdc3833farbb </Directory>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf doit correspondre exactement au chemin du système de fichier
3887202241db08986e94b252fbd06a55e55d4b2dbhyde qu'Apache httpd utilise pour accéder aux fichiers. Les directives
3887202241db08986e94b252fbd06a55e55d4b2dbhyde comprises dans une section <code><Directory></code> ne
742318b93e89c311f66b55f426c4d9cf2c14628bjim s'appliqueront pas aux fichiers du même répertoire auxquels on
742318b93e89c311f66b55f426c4d9cf2c14628bjim aura accédé via un chemin différent, per exemple via un lien
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh symbolique.</p>
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm <p> Les <glossary ref="regex">Expressions rationnelles</glossary>
e57fd661645dcfdf166e77484b509b248e62a19eaaron peuvent aussi être utilisées en ajoutant le caractère
2d2eda71267231c2526be701fe655db125852c1ffielding <Directory ~ "^/www/.*/[0-9]{3}">
e57fd661645dcfdf166e77484b509b248e62a19eaaron <p>pourra correspondre à tout répertoire situé dans /www/ et dont le
952908500d5f99f35afc5ed510391b9bdc3833farbb nom se compose de trois chiffres.</p>
6658f209f08181bd218341770db9f428032dd23ajwoolley type="section">Directory</directive> (sans expression rationnelle)
952908500d5f99f35afc5ed510391b9bdc3833farbb correspondent au répertoire (ou à un de ses parents) qui contient le
2d2eda71267231c2526be701fe655db125852c1ffielding document, les directives de la section <directive
2d2eda71267231c2526be701fe655db125852c1ffielding type="section">Directory</directive> dont le chemin est le plus
2d2eda71267231c2526be701fe655db125852c1ffielding court sont appliquées en premier, en s'intercalant avec les
2d2eda71267231c2526be701fe655db125852c1ffielding directives des fichiers <a href="#accessfilename">.htaccess</a>. Par
e57fd661645dcfdf166e77484b509b248e62a19eaaron exemple, avec</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <Directory /><br />
79c0ed7d839527abd86794a6b1d2df4fd189a2a8jerenkrantz AllowOverride None<br />
853a0c44563b056e40e9cffe911190f554e63ec3chuck </Directory><br />
952908500d5f99f35afc5ed510391b9bdc3833farbb <Directory /home><br />
e57fd661645dcfdf166e77484b509b248e62a19eaaron AllowOverride FileInfo<br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </Directory>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte
952908500d5f99f35afc5ed510391b9bdc3833farbb le chemin suivant :</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <li>Aplication de la directive <code>AllowOverride None</code>
952908500d5f99f35afc5ed510391b9bdc3833farbb (qui désactive les fichiers <code>.htaccess</code>).</li>
952908500d5f99f35afc5ed510391b9bdc3833farbb FileInfo</code> (pour le répertoire <code>/home</code>).</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li>Application de toute directive <code>FileInfo</code> qui se
2d2eda71267231c2526be701fe655db125852c1ffielding trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>,
2d2eda71267231c2526be701fe655db125852c1ffielding <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <p>Les directives associées aux répertoires sous forme d'expressions
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf rationnelles ne sont prises en compte qu'une fois toutes les
952908500d5f99f35afc5ed510391b9bdc3833farbb directives des sections sans expressions rationnelles appliquées.
9f9307bbe539dbcf96919715315eb64ce3465f5bben Alors, tous les répertoires avec expressions rationnelles sont
e57fd661645dcfdf166e77484b509b248e62a19eaaron testés selon l'ordre dans lequel ils apparaissent dans le fichier de
952908500d5f99f35afc5ed510391b9bdc3833farbb configuration. Par exemple, avec</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <Directory ~ abc$><br />
952908500d5f99f35afc5ed510391b9bdc3833farbb # ... directives here ...<br />
952908500d5f99f35afc5ed510391b9bdc3833farbb </Directory>
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>la section avec expression rationnelle ne sera prise en compte
952908500d5f99f35afc5ed510391b9bdc3833farbb qu'après les sections <directive
952908500d5f99f35afc5ed510391b9bdc3833farbb type="section">Directory</directive> sans expression rationnelle
952908500d5f99f35afc5ed510391b9bdc3833farbb et les fichiers <code>.htaccess</code>. Alors, l'expression
952908500d5f99f35afc5ed510391b9bdc3833farbb rationnelle conviendra pour <code>/home/abc/public_html/abc</code>
952908500d5f99f35afc5ed510391b9bdc3833farbb et la section <directive type="section">Directory</directive>
9f9307bbe539dbcf96919715315eb64ce3465f5bben correspondante s'appliquera.</p>
62db15de4c1f335a64d45821796ae197cff94ef8rbb <p><strong>Notez que la politique d'accès par défaut
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb dans les sections <code><Directory /></code> consiste à
742318b93e89c311f66b55f426c4d9cf2c14628bjim autoriser tout accès sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier
a520b923984f45daeaf0741d5c7e3de1f2d24509rbb correspondant à une URL. Il est recommandé de modifier cette
742318b93e89c311f66b55f426c4d9cf2c14628bjim situation à l'aide d'un bloc du style</strong></p>
11a7b0dff22d26770b532c174d1cf2e7b56ec244wrowe <Directory /><br />
11a7b0dff22d26770b532c174d1cf2e7b56ec244wrowe Require all denied<br />
952908500d5f99f35afc5ed510391b9bdc3833farbb </Directory>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><strong>puis d'affiner la configuration pour les répertoires que vous
952908500d5f99f35afc5ed510391b9bdc3833farbb voulez rendre accessibles. Voir la page <a
952908500d5f99f35afc5ed510391b9bdc3833farbb href="/misc/security_tips.html">Conseils à propos de sécurité</a>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <p>Les sections <directive type="section">Directory</directive> se situent
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf dans le fichier <code>httpd.conf</code>. Les directives <directive
952908500d5f99f35afc5ed510391b9bdc3833farbb type="section">Directory</directive> ne peuvent pas être imbriquées
e57fd661645dcfdf166e77484b509b248e62a19eaaron et ne sont pas autorisées dans les sections <directive module="core"
e57fd661645dcfdf166e77484b509b248e62a19eaaron type="section">Limit</directive> ou <directive module="core"
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><a href="/sections.html">Comment fonctionnent les sections
952908500d5f99f35afc5ed510391b9bdc3833farbb<Directory>, <Location> et <Files></a> pour des
952908500d5f99f35afc5ed510391b9bdc3833farbbexplications à propos de la manière dont ces différentes sections se
952908500d5f99f35afc5ed510391b9bdc3833farbbcombinent entre elles à la réception d'une requête</seealso>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<description>Regroupe des directives qui s'appliquent au contenu de répertoires
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfdu système de fichiers correspondant à une expression rationnelle</description>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf... </DirectoryMatch></syntax>
2d2eda71267231c2526be701fe655db125852c1ffielding</contextlist>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Les balises <directive type="section">DirectoryMatch</directive>
2d2eda71267231c2526be701fe655db125852c1ffielding et <code></DirectoryMatch></code> permettent de regrouper un
2d2eda71267231c2526be701fe655db125852c1ffielding ensemble de directives qui ne s'appliqueront qu'au répertoire
2d2eda71267231c2526be701fe655db125852c1ffielding précisé (et aux fichiers qu'il contient), comme pour la section <directive
2d2eda71267231c2526be701fe655db125852c1ffielding module="core" type="section">Directory</directive>. Cependant, le
2d2eda71267231c2526be701fe655db125852c1ffielding répertoire est précisé sous la forme d'une <glossary
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm ref="regex">expression rationnelle</glossary>. Par exemple :</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <DirectoryMatch "^/www/(.+/)?[0-9]{3}">
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>conviendrait pour les sous-répertoires de <code>/www/</code> dont
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm le nom se compose de trois chiffres.</p>
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm Avant la version 2.3.9, cette directive s'appliquait aussi aux
952908500d5f99f35afc5ed510391b9bdc3833farbb sous-répertoires (comme la directive <directive module="core"
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm type="section">Directory</directive>), et ne tenait pas compte du
952908500d5f99f35afc5ed510391b9bdc3833farbb symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm répertoires qui correspondent à l'expression sont affectés par les
2d2eda71267231c2526be701fe655db125852c1ffielding directives contenues dans la section.
2d2eda71267231c2526be701fe655db125852c1ffielding Cette directive s'applique aux requêtes pour des répertoires avec
952908500d5f99f35afc5ed510391b9bdc3833farbb ou sans slash de fin ; les expressions contenant un symbole de fin
11e076839c8d5a82d55e710194d0daac51390dbdsf de ligne ($) doivent donc faire l'objet d'une attention
952908500d5f99f35afc5ed510391b9bdc3833farbb particulière.
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><directive type="section" module="core">Directory</directive>
2d2eda71267231c2526be701fe655db125852c1ffieldingpour une description de la manière dont les expressions rationnelles
e57fd661645dcfdf166e77484b509b248e62a19eaaronsont traitées en présence d'autres sections <directive
952908500d5f99f35afc5ed510391b9bdc3833farbbtype="section">Directory</directive> sans expressions rationnelles</seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbbhref="/sections.html">Comment fonctionnent les sections
952908500d5f99f35afc5ed510391b9bdc3833farbb<Directory>, <Location> et <Files></a> pour une
742318b93e89c311f66b55f426c4d9cf2c14628bjimexplication à propos de la manière dont ces différentes sections se
952908500d5f99f35afc5ed510391b9bdc3833farbbcombinent entre elles à la réception d'une requête</seealso>
742318b93e89c311f66b55f426c4d9cf2c14628bjim</directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Racine principale de l'arborescence des documents visible
2d2eda71267231c2526be701fe655db125852c1ffieldingdepuis Internet</description>
2d2eda71267231c2526be701fe655db125852c1ffielding<syntax>DocumentRoot <var>chemin répertoire</var></syntax>
2d2eda71267231c2526be701fe655db125852c1ffielding<default>DocumentRoot /usr/local/apache/htdocs</default>
e57fd661645dcfdf166e77484b509b248e62a19eaaron<contextlist><context>server config</context><context>virtual
742318b93e89c311f66b55f426c4d9cf2c14628bjimhost</context>
f8033d657a57eab45af44368774d8beb3e4f7f35pquerna</contextlist>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Cette directive permet de définir le répertoire à partir duquel
e57fd661645dcfdf166e77484b509b248e62a19eaaron <program>httpd</program> va servir les fichiers. S'il ne correspond
fa3785601cc3801525bc3fc98cafcea5d82efe99wrowe pas à un <directive module="mod_alias">Alias</directive>, le chemin
a18775c154178d6c07aed84bd54ac16f59f89bc9wrowe de l'URL sera ajouté par le serveur à la racine des documents afin
e57fd661645dcfdf166e77484b509b248e62a19eaaron de construire le chemin du document recherché. Exemple :</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>un accès à <code>http://my.example.com/index.html</code> se
e57fd661645dcfdf166e77484b509b248e62a19eaaron réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin
742318b93e89c311f66b55f426c4d9cf2c14628bjim répertoire</var> n'est pas un chemin absolu, il est considéré comme
e57fd661645dcfdf166e77484b509b248e62a19eaaron relatif au chemin défini par la directive <directive
cd9eb79cfbf9bc730ccacc3a3774b1fe1b99ed53wrowe <p>Le répertoire défini par la directive
97ff7bf3f33a3527953d975df5cbf82a5a7dc9a6wrowe <directive>DocumentRoot</directive> ne doit pas comporter de slash
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfcorrespondance des URLs avec le système de fichiers</a></seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Contient des directives qui ne s'appliquent que si la
952908500d5f99f35afc5ed510391b9bdc3833farbbcondition correspondant à la section <directive type="section"
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgsteinmodule="core">If</directive> ou <directive type="section"
952908500d5f99f35afc5ed510391b9bdc3833farbbmodule="core">ElseIf</directive> précédente n'est pas satisfaite par la
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgsteinrequête à l'exécution</description>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<contextlist><context>server config</context><context>virtual host</context>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</contextlist>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf <p>La section <directive type="section">Else</directive> applique
e302f38fd646764ce1a1e1c578d794aef514a9e5sf les directives qu'elle contient si et seulement si les conditions
e302f38fd646764ce1a1e1c578d794aef514a9e5sf correspondant à la section <directive type="section">If</directive>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf ou <directive type="section">ElseIf</directive> immédiatement
e57fd661645dcfdf166e77484b509b248e62a19eaaron supérieure et dans la même portée n'ont pas été satisfaites. Par
e57fd661645dcfdf166e77484b509b248e62a19eaaron exemple, dans :</p>
e57fd661645dcfdf166e77484b509b248e62a19eaaron <If "-z req('Host')"><br/>
2d2eda71267231c2526be701fe655db125852c1ffielding </If><br/>
2d2eda71267231c2526be701fe655db125852c1ffielding <Else><br/>
a93bda3b944fb92e3850db5621b5a27fc0e44509wrowe </Else><br/>
9f9307bbe539dbcf96919715315eb64ce3465f5bben </example>
e57e920838f31508f1418aa4c25ce55b345b2cebrbb type="section">If</directive> serait satisfaite pour les requêtes
e57e920838f31508f1418aa4c25ce55b345b2cebrbb HTTP/1.0 sans en-tête <var>Host:</var>, alors que celle de la section
a93bda3b944fb92e3850db5621b5a27fc0e44509wrowe <directive type="section">Else</directive> le serait pour les
e57e920838f31508f1418aa4c25ce55b345b2cebrbb requêtes comportant un en-tête <var>Host:</var>.</p>
e57e920838f31508f1418aa4c25ce55b345b2cebrbb<seealso><directive type="section" module="core">If</directive></seealso>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<seealso><directive type="section" module="core">ElseIf</directive></seealso>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<seealso><a href="/sections.html">Fonctionnement des sections <Directory>, <Location>,
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <Files></a> pour une explication de la manière dont ces
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf différentes section se combinent entre elles lorsqu'une requête est
439ccf2a084e1da566548931c585cbcc3a9e7f4cminfrin reçue. Les directives <directive type="section">If</directive>,
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <directive type="section">ElseIf</directive>, et <directive
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf type="section">Else</directive> s'appliquent en dernier.</seealso>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<description>Contient des directives qui ne s'appliquent que si la
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfcondition correspondante est satisfaite par une requête à l'exécution,
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfalors que la condition correspondant à la section <directive
49fd87ed00b95bdd7a4cfc874e5c5fe4a04faf5aminfrintype="section" module="core">If</directive> ou <directive
49fd87ed00b95bdd7a4cfc874e5c5fe4a04faf5aminfrintype="section">ElseIf</directive> précédente ne l'était pas.</description>
49fd87ed00b95bdd7a4cfc874e5c5fe4a04faf5aminfrin<syntax><ElseIf <var>expression</var>> ... </ElseIf></syntax>
49fd87ed00b95bdd7a4cfc874e5c5fe4a04faf5aminfrin<contextlist><context>server config</context><context>virtual host</context>
8269892c0023355f51a3f67be442662aefdc6f92minfrin<context>directory</context><context>.htaccess</context>
8269892c0023355f51a3f67be442662aefdc6f92minfrin</contextlist>
9f9307bbe539dbcf96919715315eb64ce3465f5bben <p>La section <directive type="section">ElseIf</directive> applique
9f9307bbe539dbcf96919715315eb64ce3465f5bben les directives qu'elle contient si et seulement si d'une part la
9f9307bbe539dbcf96919715315eb64ce3465f5bben condition correspondante est satisfaite, et d'autre part la condition
853a0c44563b056e40e9cffe911190f554e63ec3chuck correspondant à la section <directive type="section">If</directive>
853a0c44563b056e40e9cffe911190f554e63ec3chuck ou <directive type="section">ElseIf</directive> de la même portée ne
853a0c44563b056e40e9cffe911190f554e63ec3chuck l'est pas. Par exemple, dans :</p>
11e076839c8d5a82d55e710194d0daac51390dbdsf </If><br/>
11e076839c8d5a82d55e710194d0daac51390dbdsf <ElseIf "-R '10.0.0.0/8'"><br/>
9f9307bbe539dbcf96919715315eb64ce3465f5bben </ElseIf><br/>
9f9307bbe539dbcf96919715315eb64ce3465f5bben <Else><br/>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh </Else><br/>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh </example>
f9a773d26994c3b267589e404cdb5b760f83e888jerenkrantz <p>La condition correspondant à la section <directive
f9a773d26994c3b267589e404cdb5b760f83e888jerenkrantz type="section">ElseIf</directive> est satisfaite si l'adresse
f9a773d26994c3b267589e404cdb5b760f83e888jerenkrantz distante de la requête appartient au sous-réseau 10.0.0.0/8, mais
f9a773d26994c3b267589e404cdb5b760f83e888jerenkrantz pas si elle appartient au sous-réseau 10.1.0.0/16.</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<seealso><a href="/expr.html">Les expressions dans le serveur HTTP
742318b93e89c311f66b55f426c4d9cf2c14628bjimApache</a>, pour une référence complète et d'autres exemples.</seealso>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<seealso><directive type="section" module="core">If</directive></seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding<seealso><directive type="section" module="core">Else</directive></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><a href="/sections.html">Fonctionnement des sections <Directory>, <Location>,
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm <Files></a> pour une explication de la manière dont ces
be8a31a0afdb2363dbcc98bbbaa94b6184061b5fdreid différentes section se combinent entre elles lorsqu'une requête est
952908500d5f99f35afc5ed510391b9bdc3833farbb reçue. Les directives <directive type="section">If</directive>,
952908500d5f99f35afc5ed510391b9bdc3833farbb <directive type="section">ElseIf</directive>, et <directive
952908500d5f99f35afc5ed510391b9bdc3833farbb type="section">Else</directive> s'appliquent en dernier.</seealso>
2d2eda71267231c2526be701fe655db125852c1ffielding</directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<description>Utilise la projection en mémoire (Memory-Mapping) pour
8269892c0023355f51a3f67be442662aefdc6f92minfrinlire les fichiers pendant qu'ils sont servis</description>
8269892c0023355f51a3f67be442662aefdc6f92minfrin<contextlist><context>server config</context><context>virtual
952908500d5f99f35afc5ed510391b9bdc3833farbbhost</context>
952908500d5f99f35afc5ed510391b9bdc3833farbb</contextlist>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Cette directive définit si <program>httpd</program> peut utiliser
952908500d5f99f35afc5ed510391b9bdc3833farbb la projection en mémoire (Memory-Mapping) quand il doit lire le contenu
952908500d5f99f35afc5ed510391b9bdc3833farbb d'un fichier pendant qu'il est servi. Par défaut, lorsque le
952908500d5f99f35afc5ed510391b9bdc3833farbb traitement d'une requête requiert l'accès aux données contenues dans
952908500d5f99f35afc5ed510391b9bdc3833farbb un fichier -- par exemple, pour servir un fichier interprété par le
952908500d5f99f35afc5ed510391b9bdc3833farbb serveur à l'aide de <module>mod_include</module> -- Apache httpd projette
952908500d5f99f35afc5ed510391b9bdc3833farbb le fichier en mémoire si le système d'exploitation le permet.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Cette projection en mémoire induit parfois une amélioration des
742318b93e89c311f66b55f426c4d9cf2c14628bjim performances. Sur certains systèmes cependant, il est préférable de
eb0fa8f996539c1cd5e5edf34f46e7e9c199641estas désactiver la projection en mémoire afin d'éviter certains problèmes
eb0fa8f996539c1cd5e5edf34f46e7e9c199641estas opérationnels :</p>
eb0fa8f996539c1cd5e5edf34f46e7e9c199641estas <li>Sur certains systèmes multi-processeurs, la projection en
952908500d5f99f35afc5ed510391b9bdc3833farbb mémoire peut dégrader les performances du programme
a93bda3b944fb92e3850db5621b5a27fc0e44509wrowe <li>S'il fait l'objet d'une projection en mémoire par
9f9307bbe539dbcf96919715315eb64ce3465f5bben <program>httpd</program>, la suppression ou la troncature d'un
a93bda3b944fb92e3850db5621b5a27fc0e44509wrowe fichier peut provoquer un crash de <program>httpd</program> avec une
ca47a2b6bcea23e8af185c68f256dcbbfd2a0f9dtrawick erreur de segmentation.</li>
2fc50921b88defeb7127985dfe4b4130175e069ejwoolley <p>Pour les configurations de serveur sujettes à ce genre de
1250054c500b75b81ccbff16a52a01145650f1e6sf problème, il est préférable de désactiver la projection en mémoire
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna des fichiers servis en spécifiant :</p>
2f1bb5376c5c4022383bb729679ca751dd75a2eabrianp EnableMMAP Off
135402675e89e6df0e17735e48f428a1e1d8eb16pquerna <p>Pour les montages NFS, cette fonctionnalité peut être
135402675e89e6df0e17735e48f428a1e1d8eb16pquerna explicitement désactivée pour les fichiers concernés en spécifiant
742318b93e89c311f66b55f426c4d9cf2c14628bjim <Directory "/chemin vers montage NFS">
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf EnableMMAP Off
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </Directory>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </example>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<description>Utilise le support sendfile du noyau pour servir les
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sffichiers aux clients</description>
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf<contextlist><context>server config</context><context>virtual
efd83d1dd1a25688a3093c5a542ae16bacef62ddsfhost</context>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf</contextlist>
e302f38fd646764ce1a1e1c578d794aef514a9e5sf<compatibility>Disponible dans les versions 2.0.44 et
e302f38fd646764ce1a1e1c578d794aef514a9e5sfsupérieures. Par défaut à Off depuis la version 2.3.9.</compatibility>
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna <p>Cette directive définit si le programme <program>httpd</program>
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna peut utiliser le support sendfile du noyau pour transmettre le
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna contenu des fichiers aux clients. Par défaut, lorsque le traitement
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna d'une requête ne requiert pas l'accès aux données contenues dans un
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna fichier -- par exemple, pour la transmission d'un fichier statique
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna -- Apache httpd utilise sendfile pour transmettre le contenu du fichier
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna sans même lire ce dernier, si le système d'exploitation le
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna permet.</p>
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna <p>Ce mécanisme sendfile évite la séparation des opérations de
742318b93e89c311f66b55f426c4d9cf2c14628bjim lecture et d'envoi, ainsi que les réservations de tampons. sur
742318b93e89c311f66b55f426c4d9cf2c14628bjim certains systèmes cependant, ou sous certains systèmes de fichiers,
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh il est préférable de désactiver cette fonctionnalité afin d'éviter
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna certains problèmes opérationnels :</p>
ad862ab5716726a2d72a292ba1dfb29566c86153brianp <li>Certains systèmes peuvent présenter un support sendfile
ad862ab5716726a2d72a292ba1dfb29566c86153brianp défectueux que le système de compilation n'a pas détecté, en
b0d8a6d437db6f4c222173f27ef81c98622fbd02pquerna particulier si les exécutables ont été compilés sur une autre
b44ddab21bd6e44ba3c03f7ae8ed08dd23b68b48sf machine, puis copiés sur la première avec un support sendfile
b44ddab21bd6e44ba3c03f7ae8ed08dd23b68b48sf défectueux.</li>
b44ddab21bd6e44ba3c03f7ae8ed08dd23b68b48sf <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna la récupération des paquets de vérification TCP (TCP-checksum) avec
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna certaines cartes réseau lorsqu'on utilise IPv6.</li>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <li>Sous Linux sur Itanium, <code>sendfile</code> peut s'avérer incapable de
742318b93e89c311f66b55f426c4d9cf2c14628bjim traiter les fichiers de plus de 2 Go.</li>
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna module="core">DocumentRoot</directive> (par exemple NFS, SMB, CIFS,
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf noyau peut s'avérer incapable de servir un fichier de ce montage
2d2eda71267231c2526be701fe655db125852c1ffielding réseau en passant par son propre cache.</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Pour les configurations de serveur non sujettes à ce genre de
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh problème, vous pouvez activer cette fonctionnalité en
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh spécifiant :</p>
2d2eda71267231c2526be701fe655db125852c1ffielding EnableSendfile On
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Pour les montages réseau, cette fonctionnalité peut être
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh explicitement désactivée pour les fichiers concernés en spécifiant
2d2eda71267231c2526be701fe655db125852c1ffielding <Directory "/chemin vers montage réseau">
2d2eda71267231c2526be701fe655db125852c1ffielding EnableSendfile Off
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </Directory>
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
8a261a9f7d18d1e862d63f68e93f288d3e1f0d94trawick <p>Veuillez noter que la configuration de la directive
952908500d5f99f35afc5ed510391b9bdc3833farbb <directive>EnableSendfile</directive> dans un contexte de répertoire
dad234382d8424e1c5a30af2838e172aec9d6d1bdreid ou de fichier .htaccess n'est pas supportée par
2d2eda71267231c2526be701fe655db125852c1ffielding <module>mod_cache_disk</module>. Le module ne prend en compte la
2d2eda71267231c2526be701fe655db125852c1ffielding définition de <directive>EnableSendfile</directive> que dans un
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf contexte global.
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf</directivesynopsis>
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf<directivesynopsis>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<description>Interrompt la lecture de la configuration avec un message
742318b93e89c311f66b55f426c4d9cf2c14628bjimd'erreur personnalisé</description>
2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>server config</context><context>virtual host</context>
3887202241db08986e94b252fbd06a55e55d4b2dbhyde</contextlist>
952908500d5f99f35afc5ed510391b9bdc3833farbb<compatibility>à partir de la version 2.3.9</compatibility>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Si une erreur peut être détectée dans la configuration, souvent
2d2eda71267231c2526be701fe655db125852c1ffielding un module manquant, cette
952908500d5f99f35afc5ed510391b9bdc3833farbb directive peut être utilisée pour générer un message d'erreur
2d2eda71267231c2526be701fe655db125852c1ffielding personnalisé, et interrompre la lecture de la configuration. </p>
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf # vérification du chargement de mod_include<br />
efd83d1dd1a25688a3093c5a542ae16bacef62ddsf <IfModule !include_module><br />
2d2eda71267231c2526be701fe655db125852c1ffielding Error mod_foo nécessite mod_include. Chargez-le via LoadModule.<br />
2d2eda71267231c2526be701fe655db125852c1ffielding </IfModule><br />
742318b93e89c311f66b55f426c4d9cf2c14628bjim # vérification de la définition de SSL ou (exclusif) NOSSL<br />
952908500d5f99f35afc5ed510391b9bdc3833farbb <IfDefine SSL><br />
742318b93e89c311f66b55f426c4d9cf2c14628bjim <IfDefine NOSSL><br />
169f62b04de69074b561b4e6dcf6f82572a5e367trawick Error SSL et NOSSL sont définies. Vous devez définir soit l'une,
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein soit l'autre.<br />
952908500d5f99f35afc5ed510391b9bdc3833farbb </IfDefine><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </IfDefine><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <IfDefine !SSL><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <IfDefine !NOSSL><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf Error Vous devez définir une et une seule des deux variables SSL
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf ou NOSSL.<br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </IfDefine><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </IfDefine><br />
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf </example>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<directivesynopsis>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<description>Document que le serveur renvoie au client en cas
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfd'erreur</description>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<syntax>ErrorDocument <var>code erreur</var> <var>document</var></syntax>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf<contextlist><context>server config</context><context>virtual
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sfhost</context>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf</contextlist>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Apache httpd peut traiter les problèmes et les erreurs de quatre
2d2eda71267231c2526be701fe655db125852c1ffielding manières,</p>
fa861fc5a880d2c3a5ecc0ec71fa7da556adf5c1wrowe <li>afficher un simple message d'erreur au contenu fixe</li>
952908500d5f99f35afc5ed510391b9bdc3833farbb <li>rediriger vers un <var>chemin d'URL</var> local pour traiter
952908500d5f99f35afc5ed510391b9bdc3833farbb le problème ou l'erreur</li>
952908500d5f99f35afc5ed510391b9bdc3833farbb <li>rediriger vers une <var>URL</var> externe pour traiter
952908500d5f99f35afc5ed510391b9bdc3833farbb le problème ou l'erreur</li>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>La première option constitue le comportement par défaut; pour
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf choisir une des trois autres options, il faut configurer Apache à
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf l'aide de la directive <directive>ErrorDocument</directive>, suivie
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf du code de la réponse HTTP et d'une URL ou d'un message. Apache
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf httpd fournit parfois des informations supplémentaires à propos du
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf problème ou de l'erreur.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Les URLs peuvent commencer par un slash (/) pour les chemins web
952908500d5f99f35afc5ed510391b9bdc3833farbb locaux (relatifs au répertoire défini par la directive <directive
952908500d5f99f35afc5ed510391b9bdc3833farbb module="core">DocumentRoot</directive>), ou se présenter sous la
952908500d5f99f35afc5ed510391b9bdc3833farbb forme d'une URL complète que le client pourra résoudre.
742318b93e89c311f66b55f426c4d9cf2c14628bjim Alternativement, un message à afficher par le navigateur pourra être
60262a02cfeba50d60d990b56d0e0c1d1fafb672sctemme fourni. Exemples :</p>
40965c37b2fd320093215de6c3fbd516382077eajim ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb ErrorDocument 403 "Désolé, vous n'avez pas l'autorisation d'accès
2f1bb5376c5c4022383bb729679ca751dd75a2eabrianp aujourd'hui"<br />
1af2b28846e2647963db788b081676884fb7df8crpluem ErrorDocument 403 Interdit!
4a68d6a5a7d10728f1f4172c595818f65e38f7b5sf </example>
78b8e4dd910f03af0a602bc4b63ad7bc69868ee3sf <p>De plus, on peut spécifier la valeur spéciale <code>default</code>
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb pour indiquer l'utilisation d'un simple message d'Apache httpd codé en
742318b93e89c311f66b55f426c4d9cf2c14628bjim dur. Bien que non nécessaire dans des circonstances normales, la
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb spécification de la valeur <code>default</code> va permettre de
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb rétablir l'utilisation du simple message d'Apache httpd codé en dur pour
470147d3f2750bfd47b5d8f1d90abab283eaad0dpquerna les configurations qui sans cela, hériteraient d'une directive
4fbb89a070c82e489830233bde6bc78ddf179978stoddard ErrorDocument 404 default<br />
742318b93e89c311f66b55f426c4d9cf2c14628bjim </Directory>
4fbb89a070c82e489830233bde6bc78ddf179978stoddard <p>Notez que lorsque vous spécifiez une directive
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb <directive>ErrorDocument</directive> pointant vers une URL distante
33510984c759eb3da154ceb0db9b75fa0031d3b4sf (c'est à dire tout ce qui commence par le préfixe http), le serveur
33510984c759eb3da154ceb0db9b75fa0031d3b4sf HTTP Apache va
33510984c759eb3da154ceb0db9b75fa0031d3b4sf envoyer une redirection au client afin de lui indiquer où trouver le
33510984c759eb3da154ceb0db9b75fa0031d3b4sf document, même dans le cas où ce document se trouve sur le serveur
33510984c759eb3da154ceb0db9b75fa0031d3b4sf local. Ceci a de nombreuses conséquences dont la plus importante
33510984c759eb3da154ceb0db9b75fa0031d3b4sf réside dans le fait que le client ne recevra pas le code d'erreur
33510984c759eb3da154ceb0db9b75fa0031d3b4sf original, mais au contraire un code de statut de redirection. Ceci
33510984c759eb3da154ceb0db9b75fa0031d3b4sf peut en retour semer la confusion chez les robots web et divers
33510984c759eb3da154ceb0db9b75fa0031d3b4sf clients qui tentent de déterminer la validité d'une URL en examinant
33510984c759eb3da154ceb0db9b75fa0031d3b4sf le code de statut. De plus, si vous utilisez une URL distante avec
33510984c759eb3da154ceb0db9b75fa0031d3b4sf <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit
33510984c759eb3da154ceb0db9b75fa0031d3b4sf demander un mot de passe à l'utilisateur car il ne recevra pas le
33510984c759eb3da154ceb0db9b75fa0031d3b4sf code de statut 401. C'est pourquoi, <strong>si vous utilisez une
33510984c759eb3da154ceb0db9b75fa0031d3b4sf directive <code>ErrorDocument 401</code>, elle devra faire référence
33510984c759eb3da154ceb0db9b75fa0031d3b4sf à un document par le biais d'un chemin local.</strong></p>
33510984c759eb3da154ceb0db9b75fa0031d3b4sf <p>Microsoft Internet Explorer (MSIE) ignore par défaut les messages
33510984c759eb3da154ceb0db9b75fa0031d3b4sf d'erreur générés par le serveur lorsqu'ils sont trop courts et
33510984c759eb3da154ceb0db9b75fa0031d3b4sf remplacent ses propres messages d'erreur "amicaux". Le seuil de
33510984c759eb3da154ceb0db9b75fa0031d3b4sf taille varie en fonction du type d'erreur, mais en général, si la
33510984c759eb3da154ceb0db9b75fa0031d3b4sf taille de votre message d'erreur est supérieure à 512 octets, il y a
33510984c759eb3da154ceb0db9b75fa0031d3b4sf peu de chances pour que MSIE l'occulte, et il sera affiché par ce
33510984c759eb3da154ceb0db9b75fa0031d3b4sf dernier. Vous trouverez d'avantage d'informations dans l'article de
33510984c759eb3da154ceb0db9b75fa0031d3b4sf la base de connaissances Microsoft <a
33510984c759eb3da154ceb0db9b75fa0031d3b4sf href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807"
33510984c759eb3da154ceb0db9b75fa0031d3b4sf <p>Bien que la plupart des messages d'erreur internes originaux
33510984c759eb3da154ceb0db9b75fa0031d3b4sf puissent être remplacés, ceux-ci sont cependant conservés dans
33510984c759eb3da154ceb0db9b75fa0031d3b4sf certaines circonstances sans tenir compte de la définition de la
33510984c759eb3da154ceb0db9b75fa0031d3b4sf directive <directive module="core">ErrorDocument</directive>. En
33510984c759eb3da154ceb0db9b75fa0031d3b4sf particulier, en cas de détection d'une requête mal formée, le
33510984c759eb3da154ceb0db9b75fa0031d3b4sf processus de traitement normal des requêtes est immédiatement
33510984c759eb3da154ceb0db9b75fa0031d3b4sf interrompu, et un message d'erreur interne est renvoyé, ceci afin de
33510984c759eb3da154ceb0db9b75fa0031d3b4sf se prémunir contre les problèmes de sécurité liés aux requêtes mal
33510984c759eb3da154ceb0db9b75fa0031d3b4sf formées.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Si vous utilisez mod_proxy, il est en général préférable
952908500d5f99f35afc5ed510391b9bdc3833farbb d'activer <directive
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben module="mod_proxy">ProxyErrorOverride</directive> afin d'être en
952908500d5f99f35afc5ed510391b9bdc3833farbb mesure de produire des messages d'erreur personnalisés pour le
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben compte de votre serveur d'origine. Si vous n'activez pas
952908500d5f99f35afc5ed510391b9bdc3833farbb ProxyErrorOverride, Apache httpd ne générera pas de messages d'erreur
3d96ee83babeec32482c9082c9426340cee8c44dwrowe personnalisés pour le contenu mandaté.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<seealso><a href="/custom-error.html">documentation sur la
952908500d5f99f35afc5ed510391b9bdc3833farbb</directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<directivesynopsis>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe<description>Définition du chemin du journal des erreurs</description>
2d2eda71267231c2526be701fe655db125852c1ffielding<syntax> ErrorLog <var>chemin fichier</var>|syslog[:<var>facility</var>]</syntax>
2d2eda71267231c2526be701fe655db125852c1ffielding<default>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</default>
2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>server config</context><context>virtual
2d2eda71267231c2526be701fe655db125852c1ffieldinghost</context>
2d2eda71267231c2526be701fe655db125852c1ffielding</contextlist>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>La directive <directive>ErrorLog</directive> permet de définir le
952908500d5f99f35afc5ed510391b9bdc3833farbb nom du fichier dans lequel le serveur va journaliser toutes les
952908500d5f99f35afc5ed510391b9bdc3833farbb erreurs qu'il rencontre. Si le <var>chemin fichier</var> n'est pas
952908500d5f99f35afc5ed510391b9bdc3833farbb absolu, il est considéré comme relatif au chemin défini par la
952908500d5f99f35afc5ed510391b9bdc3833farbb directive <directive module="core">ServerRoot</directive>.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Si le <var>chemin fichier</var> commence par une barre verticale
952908500d5f99f35afc5ed510391b9bdc3833farbb "<code>(|)</code>", il est considéré comme une commande à lancer pour traiter la
952908500d5f99f35afc5ed510391b9bdc3833farbb journalisation de l'erreur.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Voir les notes à propos des <a href="/logs.html#piped">journaux
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>L'utilisation de <code>syslog</code> à la place d'un nom de
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben fichier active la journalisation via syslogd(8) si le système le
952908500d5f99f35afc5ed510391b9bdc3833farbb supporte. Le dispositif syslog par défaut est <code>local7</code>,
3d96ee83babeec32482c9082c9426340cee8c44dwrowe mais vous pouvez le modifier à l'aide de la syntaxe
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <code>syslog:<var>facility</var></code>, où <var>facility</var> peut
952908500d5f99f35afc5ed510391b9bdc3833farbb être remplacé par un des noms habituellement documentés dans la page
952908500d5f99f35afc5ed510391b9bdc3833farbb de man syslog(1). Le dispositif syslog <code>local7</code> est
952908500d5f99f35afc5ed510391b9bdc3833farbb global, et si il est modifié dans un serveur virtuel, le dispositif
952908500d5f99f35afc5ed510391b9bdc3833farbb final spécifié affecte l'ensemble du serveur</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh ErrorLog syslog:user
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
952908500d5f99f35afc5ed510391b9bdc3833farbb href="/misc/security_tips.html#serverroot">conseils à propos de
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh sécurité</a> pour des détails sur les raisons pour lesquelles votre
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben sécurité peut être compromise si le répertoire contenant les
952908500d5f99f35afc5ed510391b9bdc3833farbb fichiers journaux présente des droits en écriture pour tout autre
952908500d5f99f35afc5ed510391b9bdc3833farbb utilisateur que celui sous lequel le serveur est démarré.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Lors de la spécification d'un chemin de fichier sur les
952908500d5f99f35afc5ed510391b9bdc3833farbb plates-formes non-Unix, on doit veiller à n'utiliser que des
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben slashes (/), même si la plate-forme autorise l'utilisation des
11e076839c8d5a82d55e710194d0daac51390dbdsf anti-slashes (\). Et d'une manière générale, il est recommandé de
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh n'utiliser que des slashes (/) dans les fichiers de
952908500d5f99f35afc5ed510391b9bdc3833farbb configuration.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><directive module="core">LogLevel</directive></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><a href="/logs.html">Fichiers journaux du serveur HTTP Apache</a></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb</directivesynopsis>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<directivesynopsis>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe<description>Spécification du format des entrées du journal des erreurs</description>
952908500d5f99f35afc5ed510391b9bdc3833farbb<syntax> ErrorLogFormat [connection|request] <var>format</var></syntax>
952908500d5f99f35afc5ed510391b9bdc3833farbb<contextlist><context>server config</context><context>virtual host</context>
952908500d5f99f35afc5ed510391b9bdc3833farbb</contextlist>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>La directive <directive>ErrorLogFormat</directive> permet de
3d96ee83babeec32482c9082c9426340cee8c44dwrowe spécifier quelles informations supplémentaires vont être enregistrées
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh dans le journal des erreurs en plus du message habituel.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
952908500d5f99f35afc5ed510391b9bdc3833farbb </example>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>La spécification de <code>connection</code> ou
952908500d5f99f35afc5ed510391b9bdc3833farbb <code>request</code> comme premier paramètre permet de définir des
3d96ee83babeec32482c9082c9426340cee8c44dwrowe formats supplémentaires, ce qui a pour effet de journaliser des
952908500d5f99f35afc5ed510391b9bdc3833farbb informations additionnelles lorsque le premier message est
952908500d5f99f35afc5ed510391b9bdc3833farbb enregistré respectivement pour une connexion ou une requête
bf507cc1e6ad55303c3d436c6ca153f46c788be6sf spécifique. Ces informations additionnelles ne sont enregistrées
bf507cc1e6ad55303c3d436c6ca153f46c788be6sf qu'une seule fois par connexion/requête. Si le traitement d'une
bf507cc1e6ad55303c3d436c6ca153f46c788be6sf connexion ou d'une requête ne génère aucun message dans le journal,
bf507cc1e6ad55303c3d436c6ca153f46c788be6sf alors aucune information additionnelle n'est enregistrée.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>Il peut arriver que certains items de la chaîne de format ne
952908500d5f99f35afc5ed510391b9bdc3833farbb produisent aucune sortie. Par exemple, l'en-tête Referer n'est
952908500d5f99f35afc5ed510391b9bdc3833farbb présent que si le message du journal est associé à une requête et s'il
952908500d5f99f35afc5ed510391b9bdc3833farbb est généré à un moment où l'en-tête Referer a déjà été lu par le
742318b93e89c311f66b55f426c4d9cf2c14628bjim client. Si aucune sortie n'est générée, le comportement par défaut
2d2eda71267231c2526be701fe655db125852c1ffielding consiste à supprimer tout ce qui se trouve entre l'espace précédent
952908500d5f99f35afc5ed510391b9bdc3833farbb et le suivant. Ceci implique que la ligne de journalisation est
952908500d5f99f35afc5ed510391b9bdc3833farbb divisée en champs ne contenant pas d'espace séparés par des espaces.
952908500d5f99f35afc5ed510391b9bdc3833farbb Si un item de la chaîne de format ne génère aucune sortie,
952908500d5f99f35afc5ed510391b9bdc3833farbb l'ensemble du champ est omis. Par exemple, si l'adresse distante
742318b93e89c311f66b55f426c4d9cf2c14628bjim <code>%a</code> du format <code>[%t] [%l] [%a] %M </code> n'est
742318b93e89c311f66b55f426c4d9cf2c14628bjim pas disponible, les crochets qui l'entourent ne seront eux-mêmes pas
742318b93e89c311f66b55f426c4d9cf2c14628bjim enregistrés. Il est possible d'échapper les espaces par un anti-slash
952908500d5f99f35afc5ed510391b9bdc3833farbb afin qu'ils ne soient pas considérés comme séparateurs de champs.
952908500d5f99f35afc5ed510391b9bdc3833farbb La combinaison '% ' (pourcentage espace) est un délimiteur de
aecb17a45c6d3ee4729ed5f68dc4270f211ee7a8fielding champ de taille nulle qui ne génère aucune sortie.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Ce comportement peut être changé en ajoutant des modificateurs à
952908500d5f99f35afc5ed510391b9bdc3833farbb l'item de la chaîne de format. Le modificateur <code>-</code>
952908500d5f99f35afc5ed510391b9bdc3833farbb (moins) provoque l'enregistrement d'un signe moins si l'item
742318b93e89c311f66b55f426c4d9cf2c14628bjim considéré ne génère aucune sortie. Pour les formats à enregistrement
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben unique par connexion/requête, il est aussi possible d'utiliser le
952908500d5f99f35afc5ed510391b9bdc3833farbb modificateur <code>+</code> (plus). Si un item ne générant aucune
742318b93e89c311f66b55f426c4d9cf2c14628bjim sortie possède le modificateur plus, la ligne dans son ensemble est
742318b93e89c311f66b55f426c4d9cf2c14628bjim omise.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Un modificateur de type entier permet d'assigner un niveau de
3d96ee83babeec32482c9082c9426340cee8c44dwrowe sévérité à un item de format. L'item considéré ne
952908500d5f99f35afc5ed510391b9bdc3833farbb sera journalisé que si la sévérité du message n'est pas
952908500d5f99f35afc5ed510391b9bdc3833farbb plus haute que le niveau de sévérité spécifié. Les
952908500d5f99f35afc5ed510391b9bdc3833farbb valeurs possibles vont de 1 (alert) à 15 (trace8), en passant par 4
742318b93e89c311f66b55f426c4d9cf2c14628bjim (warn) ou 7 (debug).</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Par exemple, voici ce qui arriverait si vous ajoutiez des
952908500d5f99f35afc5ed510391b9bdc3833farbb modificateurs à l'item <code>%{Referer}i</code> qui enregistre le
2d2eda71267231c2526be701fe655db125852c1ffielding <columnspec><column width=".3"/><column width=".7"/></columnspec>
971ced4989415d939afba8d70c82a9ce0113bceend <tr><th>Item modifié</th><th>Signification</th></tr>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <td>Enregistre le caractère <code>-</code> si l'en-tête
952908500d5f99f35afc5ed510391b9bdc3833farbb <td>N'enregistre rien si l'en-tête
952908500d5f99f35afc5ed510391b9bdc3833farbb <td>N'enregistre le contenu de l'en-tête <code>Referer</code> que si
952908500d5f99f35afc5ed510391b9bdc3833farbb la sévérité du message de journalisation est supérieure à 4.</td>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <p>Certains items de format acceptent des paramètres supplémentaires
952908500d5f99f35afc5ed510391b9bdc3833farbb entre accolades.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <columnspec><column width=".2"/><column width=".8"/></columnspec>
2d2eda71267231c2526be701fe655db125852c1ffielding <tr><th>Chaîne de format</th> <th>Description</th></tr>
fb8ee8b7a3a2503b95bf47685f9083e0b9834e6fminfrin <td>Port et adresse IP sous-jacents du correspondant pour la
fb8ee8b7a3a2503b95bf47685f9083e0b9834e6fminfrin connexion (voir le module
8419e6f8bff1a3617933f3ba760d2bdec7442f44coar <td>Variable d'environnement de requête <em>name</em></td></tr>
8419e6f8bff1a3617933f3ba760d2bdec7442f44coar <td>Nom du fichier source et numéro de ligne de l'appel du
8419e6f8bff1a3617933f3ba760d2bdec7442f44coar <td>En-tête de requête <em>name</em></td></tr>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <td>Nombre de requêtes persistantes pour cette connexion</td></tr>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <td>Sévérité du message</td></tr>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <td>Identifiant journal de la requête</td></tr>
952908500d5f99f35afc5ed510391b9bdc3833farbb <td>Identifiant journal de la connexion si utilisé dans la
952908500d5f99f35afc5ed510391b9bdc3833farbb <td>Nom du module qui effectue la journalisation du message</td></tr>
fb8ee8b7a3a2503b95bf47685f9083e0b9834e6fminfrin <td>Identifiant unique de thread système du thread courant
fb8ee8b7a3a2503b95bf47685f9083e0b9834e6fminfrin (l'identifiant affiché par la commande <code>top</code> par
fb8ee8b7a3a2503b95bf47685f9083e0b9834e6fminfrin exemple ; seulement sous Linux pour l'instant)</td></tr>
952908500d5f99f35afc5ed510391b9bdc3833farbb <td>L'heure courante au format compact ISO 8601, avec les
2d2eda71267231c2526be701fe655db125852c1ffielding module="core">ServerName</directive> du serveur courant.</td></tr>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <td>Le nom de serveur du serveur qui sert la requête en accord
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin avec la définition de la directive <directive module="core"
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <tr><td><code>\ </code> (anti-slash espace)</td>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <tr><td><code>% </code> (pourcentage espace)</td>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <td>Délimiteur de champ (aucune sortie)</td></tr>
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin <p>L'item de format identifiant journal <code>%L</code> génère un
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin identifiant unique pour une connexion ou une requête. Il peut servir
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin à déterminer quelles lignes correspondent à la même connexion ou
81cc440ca73845f44dc589db106d3feb7a36f33bminfrin requête ou quelle requête est associée à tel connexion. Un item de
952908500d5f99f35afc5ed510391b9bdc3833farbb format <code>%L</code> est aussi disponible dans le module
952908500d5f99f35afc5ed510391b9bdc3833farbb <module>mod_log_config</module>, mais il permet dans ce contexte de
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben corréler les entrées du journal des accès avec celles du journal des
952908500d5f99f35afc5ed510391b9bdc3833farbb erreurs. Si le module <module>mod_unique_id</module> est chargé,
952908500d5f99f35afc5ed510391b9bdc3833farbb c'est son identifiant unique qui sera utilisé comme identifiant de
952908500d5f99f35afc5ed510391b9bdc3833farbb journal pour les requêtes.</p>
8c3667cd1d0db08647793137c0d1aa7f6526bebfniq <example><title>Exemple (format par défaut)</title>
8c3667cd1d0db08647793137c0d1aa7f6526bebfniq ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a]
8c3667cd1d0db08647793137c0d1aa7f6526bebfniq %M% ,\ referer\ %{Referer}i"
8c3667cd1d0db08647793137c0d1aa7f6526bebfniq </example>
8c3667cd1d0db08647793137c0d1aa7f6526bebfniq <p>Cet exemple renverrait un message d'erreur du style :</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb [Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
3de8d8649277a02f53aa4f06121420985e8eee08nd </example>
3de8d8649277a02f53aa4f06121420985e8eee08nd <p>Notez que, comme indiqué plus haut, certains champs sont
82acfa3f57607ae78326104c420a317260554a47nd totalement supprimés s'ils n'ont pas été définis.</p>
3de8d8649277a02f53aa4f06121420985e8eee08nd <example><title>Exemple (similaire au format 2.2.x)</title>
3de8d8649277a02f53aa4f06121420985e8eee08nd ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a]
3de8d8649277a02f53aa4f06121420985e8eee08nd %M% ,\ referer\ %{Referer}i"
82acfa3f57607ae78326104c420a317260554a47nd </example>
82acfa3f57607ae78326104c420a317260554a47nd <example><title>Exemple avancé avec identifiants journal de
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"<br/>
82acfa3f57607ae78326104c420a317260554a47nd ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"<br/>
82acfa3f57607ae78326104c420a317260554a47nd ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"<br/>
82acfa3f57607ae78326104c420a317260554a47nd ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"<br/>
82acfa3f57607ae78326104c420a317260554a47nd ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"<br/>
82acfa3f57607ae78326104c420a317260554a47nd </example>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<seealso><directive module="core">ErrorLog</directive></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><directive module="core">LogLevel</directive></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb<seealso><a href="/logs.html">Fichiers journaux du serveur HTTP Apache</a></seealso>
952908500d5f99f35afc5ed510391b9bdc3833farbb</directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<directivesynopsis>
11e076839c8d5a82d55e710194d0daac51390dbdsf<description>Extrait des informations d'état étendues pour chaque
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianhrequête</description>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<contextlist><context>server config</context></contextlist>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe <p>Cette option permet d'extraire des données supplémentaires
2d2eda71267231c2526be701fe655db125852c1ffielding concernant la requête en cours de traitement pour un processus
952908500d5f99f35afc5ed510391b9bdc3833farbb donné, ainsi qu'un résumé d'utilisation ; vous pouvez accéder à
952908500d5f99f35afc5ed510391b9bdc3833farbb ces variables pendant l'exécution en configurant
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben <module>mod_status</module>. Notez que d'autres modules sont
952908500d5f99f35afc5ed510391b9bdc3833farbb susceptibles de s'appuyer sur ce tableau de bord.</p>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe <p>Cette directive s'applique au serveur dans son ensemble, et ne
7c7372abe2484e7fcf81937b93496d1246e5b816gstein peut pas être activée/désactivée pour un serveur virtuel
952908500d5f99f35afc5ed510391b9bdc3833farbb particulier. Notez que l'extraction des informations d'état étendues
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben peut ralentir le serveur. Notez aussi que cette définition ne peut
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben pas être modifiée au cours d'un redémarrage graceful.</p>
952908500d5f99f35afc5ed510391b9bdc3833farbb <p>Notez que le chargement de <module>mod_status</module> définit
952908500d5f99f35afc5ed510391b9bdc3833farbb automatiquement ExtendedStatus à On, et que d'autres modules tiers
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh sont susceptibles d'en faire de même. De tels modules ont besoin
742318b93e89c311f66b55f426c4d9cf2c14628bjim d'informations détaillées à propos de l'état de tous les processus.
59ae852bea7d507f61999f982ded8219d2c0ec15wrowe Depuis la version 2.3.6, <module>mod_status</module> a définit la
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben valeur par défaut à On, alors qu'elle était à Off dans les versions
3d96ee83babeec32482c9082c9426340cee8c44dwrowe antérieures.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben</directivesynopsis>
952908500d5f99f35afc5ed510391b9bdc3833farbb<directivesynopsis>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe<description>Caractéristiques de fichier utilisées lors de la génération
58619148951981bcfa5c506ad8ce745aa8831980rbbde l'en-tête de réponse HTTP ETag pour les fichiers statiques</description>
58619148951981bcfa5c506ad8ce745aa8831980rbb<contextlist><context>server config</context><context>virtual
58619148951981bcfa5c506ad8ce745aa8831980rbbhost</context>
58619148951981bcfa5c506ad8ce745aa8831980rbb</contextlist>
58619148951981bcfa5c506ad8ce745aa8831980rbb<compatibility>La valeur par défaut était "INode MTime Size"
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianhdans les versions 2.3.14 et antérieures.</compatibility>
3d96ee83babeec32482c9082c9426340cee8c44dwrowe La directive <directive>FileETag</directive> définit les
2d2eda71267231c2526be701fe655db125852c1ffielding caractéristiques de fichier utilisées lors de la génération de
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe l'en-tête de réponse HTTP <code>ETag</code> (entity tag) quand le
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe document est contenu dans un fichier statique(la valeur de
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe est utilisée dans le cadre de la gestion du cache pour préserver la
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh bande passante réseau). La directive
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe <directive>FileETag</directive> vous permet maintenant de choisir
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe quelles caractéristiques du fichier vont être utilisées, le cas
3d72602d1d9e6f0d49d20f0d0a71831c160ef589wrowe échéant. Les mots-clés reconnus sont :
58619148951981bcfa5c506ad8ce745aa8831980rbb <dd>Le numéro d'i-node du fichier sera inclus dans le processus de
58619148951981bcfa5c506ad8ce745aa8831980rbb génération</dd>
58619148951981bcfa5c506ad8ce745aa8831980rbb <dd>La date et l'heure auxquelles le fichier a été modifié la
58619148951981bcfa5c506ad8ce745aa8831980rbb dernière fois seront incluses</dd>
58619148951981bcfa5c506ad8ce745aa8831980rbb <dd>Tous les champs disponibles seront utilisés. Cette définition
58619148951981bcfa5c506ad8ce745aa8831980rbb est équivalente à : <example>FileETag INode MTime
58619148951981bcfa5c506ad8ce745aa8831980rbb <dd>Si le document se compose d'un fichier, aucun champ
92d6e181c597b97647d750c43a7bc3626e056b59gstein <code>ETag</code> ne sera inclus dans la réponse</dd>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>Les mots-clés <code>INode</code>, <code>MTime</code>, et
58619148951981bcfa5c506ad8ce745aa8831980rbb <code>Size</code> peuvent être préfixés par <code>+</code> ou
58619148951981bcfa5c506ad8ce745aa8831980rbb <code>-</code>, ce qui permet de modifier les valeurs par défaut
92d6e181c597b97647d750c43a7bc3626e056b59gstein héritées d'un niveau de configuration plus général. Tout mot-clé
58619148951981bcfa5c506ad8ce745aa8831980rbb apparaissant sans aucun préfixe annule entièrement et immédiatement
58619148951981bcfa5c506ad8ce745aa8831980rbb les configurations héritées.</p>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>Si la configuration d'un répertoire contient
58619148951981bcfa5c506ad8ce745aa8831980rbb <code>FileETag INode MTime Size</code>, et si un de
58619148951981bcfa5c506ad8ce745aa8831980rbb ses sous-répertoires contient <code>FileETag -INode</code>, la
58619148951981bcfa5c506ad8ce745aa8831980rbb configuration de ce sous-répertoire (qui sera propagée vers tout
58619148951981bcfa5c506ad8ce745aa8831980rbb sous-répertoire qui ne la supplante pas), sera équivalente à
58619148951981bcfa5c506ad8ce745aa8831980rbb Ne modifiez pas les valeurs par défaut pour les répertoires ou
3d96ee83babeec32482c9082c9426340cee8c44dwrowe localisations où WebDAV est activé et qui utilisent
58619148951981bcfa5c506ad8ce745aa8831980rbb <module>mod_dav_fs</module> comme fournisseur de stockage.
30c095035b1d5910cc239a1384c816aef228beb5jim comparaisons de champs <code>ETag</code> dans les requêtes
30c095035b1d5910cc239a1384c816aef228beb5jim conditionnelles. Ces requêtes conditionnelles échoueront si le
30c095035b1d5910cc239a1384c816aef228beb5jim format <code>ETag</code> est modifié via la directive
bdadc326446cae4a51bf75811fbe01a3a362df64gstein <note><title>Inclusions côté serveur</title>
30c095035b1d5910cc239a1384c816aef228beb5jim Aucun champ ETag n'est généré pour les réponses interprétées par
58619148951981bcfa5c506ad8ce745aa8831980rbb <module>mod_include</module>, car l'entité de la réponse peut
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben changer sans modification de l'INode, du MTime, ou de la taille du
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben fichier statique contenant les directives SSI.
58619148951981bcfa5c506ad8ce745aa8831980rbb</directivesynopsis>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<description>Contient des directives qui s'appliquent aux fichiers
58619148951981bcfa5c506ad8ce745aa8831980rbbprécisés</description>
58619148951981bcfa5c506ad8ce745aa8831980rbb<syntax><Files <var>nom fichier</var>> ... </Files></syntax>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<contextlist><context>server config</context><context>virtual
58619148951981bcfa5c506ad8ce745aa8831980rbbhost</context>
e0cb33839fe1b103e960da9538156de474d290e2sf</contextlist>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>La directive <directive type="section">Files</directive> limite
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh la portée des directives qu'elle contient aux fichiers précisés.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh Elle est comparable aux directives <directive module="core"
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh type="section">Directory</directive> et <directive module="core"
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben type="section">Location</directive>. Elle doit se terminer par une
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh balise <code></Files></code>. Les directives contenues dans
58619148951981bcfa5c506ad8ce745aa8831980rbb cette section s'appliqueront à tout objet dont le nom de base (la
58619148951981bcfa5c506ad8ce745aa8831980rbb dernière partie du nom de fichier) correspond au fichier spécifié.
ef5650b61a8e35f3cc93ec07e73efc17ea329894jorton Les sections <directive type="section">Files</directive> sont
ef5650b61a8e35f3cc93ec07e73efc17ea329894jorton traitées selon l'ordre dans lequel elles apparaissent dans le
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh fichier de configuration, après les sections <directive module="core"
58619148951981bcfa5c506ad8ce745aa8831980rbb type="section">Directory</directive> et la lecture des fichiers
58619148951981bcfa5c506ad8ce745aa8831980rbb <code>.htaccess</code>, mais avant les sections <directive
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben type="section" module="core">Location</directive>. Notez que les
58619148951981bcfa5c506ad8ce745aa8831980rbb sections <directive type="section">Files</directive> peuvent être
e0cb33839fe1b103e960da9538156de474d290e2sf imbriquées dans les sections <directive type="section"
e0cb33839fe1b103e960da9538156de474d290e2sf module="core">Directory</directive> afin de restreindre la portion
58619148951981bcfa5c506ad8ce745aa8831980rbb du système de fichiers à laquelle ces dernières vont
ef5650b61a8e35f3cc93ec07e73efc17ea329894jorton s'appliquer.</p>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>L'argument <var>filename</var> peut contenir un nom de fichier
742318b93e89c311f66b55f426c4d9cf2c14628bjim ou une chaîne de caractères avec caractères génériques, où
58619148951981bcfa5c506ad8ce745aa8831980rbb <code>?</code> remplace un caractère, et <code>*</code> toute chaîne
cda2a8c4fe289419f62e8b9607cafe4812974840sf de caractères. On peut aussi utiliser les <glossary
cda2a8c4fe289419f62e8b9607cafe4812974840sf ref="regex">Expressions rationnelles</glossary> en ajoutant la
58619148951981bcfa5c506ad8ce745aa8831980rbb <Files ~ "\.(gif|jpe?g|png)$">
58619148951981bcfa5c506ad8ce745aa8831980rbb </example>
975bdabd8564af8a8bc075b5e70eb77af84793b6sf <p>correspondrait à la plupart des formats graphiques de l'Internet.
58619148951981bcfa5c506ad8ce745aa8831980rbb Il est cependant préférable d'utiliser la directive <directive
3d96ee83babeec32482c9082c9426340cee8c44dwrowe module="core" type="section">FilesMatch</directive>.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>Notez qu'à la différence des sections <directive type="section"
cda2a8c4fe289419f62e8b9607cafe4812974840sf module="core">Directory</directive> et <directive type="section"
cda2a8c4fe289419f62e8b9607cafe4812974840sf module="core">Location</directive>, les sections <directive
cda2a8c4fe289419f62e8b9607cafe4812974840sf type="section">Files</directive> peuvent être utilisées dans les
cda2a8c4fe289419f62e8b9607cafe4812974840sf fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de
cda2a8c4fe289419f62e8b9607cafe4812974840sf contrôler l'accès à leurs propres ressources, fichier par
cda2a8c4fe289419f62e8b9607cafe4812974840sf fichier.</p>
cda2a8c4fe289419f62e8b9607cafe4812974840sf<seealso><a href="/sections.html">Comment fonctionnent les sections
cda2a8c4fe289419f62e8b9607cafe4812974840sf<Directory>, <Location> et <Files></a> pour une
cda2a8c4fe289419f62e8b9607cafe4812974840sfexplication de la manière dont ces différentes sections se combinent
0f7233952e2732c08e1848a0209ab207d4ada35asfentre elles à la réception d'une requête</seealso>
cda2a8c4fe289419f62e8b9607cafe4812974840sf</directivesynopsis>
cda2a8c4fe289419f62e8b9607cafe4812974840sf<description>Contient des directives qui s'appliquent à des fichiers
cda2a8c4fe289419f62e8b9607cafe4812974840sfspécifiés sous la forme d'expressions rationnelles</description>
cda2a8c4fe289419f62e8b9607cafe4812974840sf<syntax><FilesMatch <var>expression rationnelle</var>> ...
58619148951981bcfa5c506ad8ce745aa8831980rbb</FilesMatch></syntax>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben<contextlist><context>server config</context><context>virtual
58619148951981bcfa5c506ad8ce745aa8831980rbbhost</context>
58619148951981bcfa5c506ad8ce745aa8831980rbb</contextlist>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>La section <directive type="section">FilesMatch</directive>
742318b93e89c311f66b55f426c4d9cf2c14628bjim limite la portée des directives qu'elle contient aux fichiers
58619148951981bcfa5c506ad8ce745aa8831980rbb spécifiés, tout comme le ferait une section <directive module="core"
3d96ee83babeec32482c9082c9426340cee8c44dwrowe type="section">Files</directive>. Mais elle accepte aussi les
58619148951981bcfa5c506ad8ce745aa8831980rbb <glossary ref="regex">expressions rationnelles</glossary>. Par
2c3a18efdb0536acb42f25758b66bb85a67a9131sf exemple :</p>
2c3a18efdb0536acb42f25758b66bb85a67a9131sf <FilesMatch "\.(gif|jpe?g|png)$">
2c3a18efdb0536acb42f25758b66bb85a67a9131sf </example>
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>correspondrait à la plupart des formats graphiques de
742318b93e89c311f66b55f426c4d9cf2c14628bjim l'Internet.</p>
58619148951981bcfa5c506ad8ce745aa8831980rbb<seealso><a href="/sections.html">Comment fonctionnent les sections
58619148951981bcfa5c506ad8ce745aa8831980rbb<Directory>, <Location> et <Files></a> pour une
58619148951981bcfa5c506ad8ce745aa8831980rbbexplication de la manière dont ces différentes sections se combinent
11e076839c8d5a82d55e710194d0daac51390dbdsfentre elles à la réception d'une requête</seealso>
58619148951981bcfa5c506ad8ce745aa8831980rbb</directivesynopsis>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<directivesynopsis>
58619148951981bcfa5c506ad8ce745aa8831980rbb<description>Force le type de médium spécifié dans le champ d'en-tête
58619148951981bcfa5c506ad8ce745aa8831980rbbHTTP Content-Type pour les fichiers correspondants</description>
58619148951981bcfa5c506ad8ce745aa8831980rbb<syntax>ForceType <var>type médium</var>|None</syntax>
58619148951981bcfa5c506ad8ce745aa8831980rbb<contextlist><context>directory</context><context>.htaccess</context>
aecb17a45c6d3ee4729ed5f68dc4270f211ee7a8fielding</contextlist>
58619148951981bcfa5c506ad8ce745aa8831980rbb<compatibility>Intégré dans le coeur d'Apache httpd depuis la version
c779aea0c9b7c47c2e4fd258e3f54835a849625dpoirier2.0</compatibility>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>Lorsqu'elle est placée dans un fichier <code>.htaccess</code> ou
3d96ee83babeec32482c9082c9426340cee8c44dwrowe module="core">Directory</directive>, <directive type="section"
2d2eda71267231c2526be701fe655db125852c1ffielding module="core">Location</directive>, ou <directive type="section"
783334f576bfb7ef44623faf7af44a65cf13b9b4jim l'identification du type MIME des fichiers spécifiés à la valeur de
783334f576bfb7ef44623faf7af44a65cf13b9b4jim l'argument <var>type médium</var>. Par exemple, si vous possédez un
783334f576bfb7ef44623faf7af44a65cf13b9b4jim répertoire ne contenant que des fichiers GIF, et si vous ne voulez
783334f576bfb7ef44623faf7af44a65cf13b9b4jim pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser
783334f576bfb7ef44623faf7af44a65cf13b9b4jim </example>
783334f576bfb7ef44623faf7af44a65cf13b9b4jim <p>Notez que cette directive l'emporte sur d'autres associations de
783334f576bfb7ef44623faf7af44a65cf13b9b4jim type de médium indirectes définies dans mime.types ou via la
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem directive <directive module="mod_mime">AddType</directive>.</p>
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem <p>Vous pouvez aussi annuler toute définition plus générale de
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem <directive>ForceType</directive> en affectant la valeur
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem <code>None</code> à l'argument <var>type médium</var> :</p>
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem # force le type MIME de tous les fichiers à image/gif:<br />
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem <Location /images><br />
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem </Location><br />
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem # mais utilise les méthodes classiques d'attribution du type MIME
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem # dans le sous-répertoire suivant :<br />
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem ForceType None<br />
9257af3c6aaeaf201fccb3e3c87cf8c41783fdb7rpluem </Location>
7c66a25db06001672e6ec5485b69bc7f3c342753jim <p>A la base, cette directive écrase le type de contenu généré pour
7c66a25db06001672e6ec5485b69bc7f3c342753jim les fichiers statiques servis à partir du sytème de fichiers. Pour
7c66a25db06001672e6ec5485b69bc7f3c342753jim les ressources autres que les fichiers statiques pour lesquels le
7c66a25db06001672e6ec5485b69bc7f3c342753jim générateur de réponse spécifie en général un type de contenu, cette
7c66a25db06001672e6ec5485b69bc7f3c342753jim directive est ignorée.</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim</directivesynopsis>
b8055f3cb7e560830169cd1117a47b86abae41b4jim<directivesynopsis>
dac0f846350698d2a3e65c814daf82721bafc502jim<description>Répertoire dans lequel écrire les données de profiling
b8055f3cb7e560830169cd1117a47b86abae41b4jim<syntax>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</syntax>
b8055f3cb7e560830169cd1117a47b86abae41b4jim<contextlist><context>server config</context><context>virtual host</context>
b8055f3cb7e560830169cd1117a47b86abae41b4jim</contextlist>
b8055f3cb7e560830169cd1117a47b86abae41b4jim <p>Lorsque le serveur a été compilé avec le support du profiling
8689050b83e255d70c85e89a9990afa6514a10ebsf gprof, la directive <directive>GprofDir</directive> permet de
8689050b83e255d70c85e89a9990afa6514a10ebsf spécifier dans quel répertoire les fichiers <code>gmon.out</code>
b8055f3cb7e560830169cd1117a47b86abae41b4jim doivent être écrits lorsque le processus s'arrête. Si l'argument se
b8055f3cb7e560830169cd1117a47b86abae41b4jim termine par un caractère pourcentage ('%'), des sous-répertoires
dac0f846350698d2a3e65c814daf82721bafc502jim sont créés pour chaque identifiant de processus.</p>
b8055f3cb7e560830169cd1117a47b86abae41b4jim <p>Cette directive ne fonctionne actuellement qu'avec le MPM
b8055f3cb7e560830169cd1117a47b86abae41b4jim</directivesynopsis>
b8055f3cb7e560830169cd1117a47b86abae41b4jim<directivesynopsis>
b8055f3cb7e560830169cd1117a47b86abae41b4jim<description>Active la recherche DNS sur les adresses IP des
29ecbd9db1622e74964264d078336f7604d65093jimclients</description>
742318b93e89c311f66b55f426c4d9cf2c14628bjim<contextlist><context>server config</context><context>virtual
29ecbd9db1622e74964264d078336f7604d65093jimhost</context>
29ecbd9db1622e74964264d078336f7604d65093jim <p>Cette directive active la recherche DNS afin de pouvoir
29ecbd9db1622e74964264d078336f7604d65093jim journaliser les nom d'hôtes (et les passer aux programmes CGI et aux
29ecbd9db1622e74964264d078336f7604d65093jim inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur
29ecbd9db1622e74964264d078336f7604d65093jim <code>Double</code> déclenche une double recherche DNS inverse. En
29ecbd9db1622e74964264d078336f7604d65093jim d'autres termes, une fois la recherche inverse effectuée, on lance
29ecbd9db1622e74964264d078336f7604d65093jim une recherche directe sur le résultat de cette dernière. Au moins
29ecbd9db1622e74964264d078336f7604d65093jim une des adresses IP fournies par la recherche directe doit
29ecbd9db1622e74964264d078336f7604d65093jim correspondre à l'adresse originale (ce que l'on nomme
29ecbd9db1622e74964264d078336f7604d65093jim <code>PARANOID</code> dans la terminologie "tcpwrappers").</p>
29ecbd9db1622e74964264d078336f7604d65093jim <p>Quelle que soit la configuration, lorsqu'on utilise
29ecbd9db1622e74964264d078336f7604d65093jim <module>mod_authz_host</module> pour contrôler l'accès en fonction
29ecbd9db1622e74964264d078336f7604d65093jim du nom d'hôte, une double recherche DNS inverse est effectuée,
29ecbd9db1622e74964264d078336f7604d65093jim sécurité oblige. Notez cependant que le résultat de cette double
29ecbd9db1622e74964264d078336f7604d65093jim recherche n'est en général pas accessible, à moins que vous n'ayez
29ecbd9db1622e74964264d078336f7604d65093jim spécifié <code>HostnameLookups Double</code>. Par exemple, si vous
11e076839c8d5a82d55e710194d0daac51390dbdsf n'avez spécifié que <code>HostnameLookups On</code>, et si une
29ecbd9db1622e74964264d078336f7604d65093jim requête concerne un objet protégé par des restrictions en fonction
29ecbd9db1622e74964264d078336f7604d65093jim du nom d'hôte, quel que soit le résultat de la double recherche
2d2eda71267231c2526be701fe655db125852c1ffielding inverse, les programmes CGI ne recevront que le résultat de la
58619148951981bcfa5c506ad8ce745aa8831980rbb recherche inverse simple dans la variable
58619148951981bcfa5c506ad8ce745aa8831980rbb <p>La valeur par défaut est <code>Off</code> afin de préserver le
58619148951981bcfa5c506ad8ce745aa8831980rbb traffic réseau des sites pour lesquels la recherche inverse n'est
30c095035b1d5910cc239a1384c816aef228beb5jim pas vraiment nécessaire. Cette valeur par défaut est aussi bénéfique
47ab8dcf8ad581569376f2e04ef16bc785bb122aake pour les utilisateurs finaux car il n'ont ainsi pas à subir de temps
7c7372abe2484e7fcf81937b93496d1246e5b816gstein d'attente supplémentaires dus aux recherches DNS. Les sites
30c095035b1d5910cc239a1384c816aef228beb5jim fortement chargés devraient laisser cette directive à
30c095035b1d5910cc239a1384c816aef228beb5jim <code>Off</code>, car les recherches DNS peuvent prendre des temps
742318b93e89c311f66b55f426c4d9cf2c14628bjim très longs. Vous pouvez éventuellement utiliser hors ligne
30c095035b1d5910cc239a1384c816aef228beb5jim l'utilitaire <program>logresolve</program>, compilé par défaut dans
30c095035b1d5910cc239a1384c816aef228beb5jim le sous-répertoire <code>bin</code> de votre répertoire
58619148951981bcfa5c506ad8ce745aa8831980rbb d'installation, afin de déterminer les noms d'hôtes associés aux
47ab8dcf8ad581569376f2e04ef16bc785bb122aake adresses IP journalisées.</p>
2d2eda71267231c2526be701fe655db125852c1ffielding href="mod_authz_host.html#reqhost">directives Require à base de
2d2eda71267231c2526be701fe655db125852c1ffielding nom</a>, une recherche de nom d'hôte sera effectuée quelle que soit
2d2eda71267231c2526be701fe655db125852c1ffielding la définition de la directive <code>HostnameLookups</code>.</p>
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben</directivesynopsis>
58619148951981bcfa5c506ad8ce745aa8831980rbb<description>Contient des directives qui ne s'appliquent que si une
2d2eda71267231c2526be701fe655db125852c1ffieldingcondition est satisfaite au cours du traitement d'une
58619148951981bcfa5c506ad8ce745aa8831980rbbrequête</description>
58619148951981bcfa5c506ad8ce745aa8831980rbb<syntax><If <var>expression</var>> ... </If></syntax>
58619148951981bcfa5c506ad8ce745aa8831980rbb<contextlist><context>server config</context><context>virtual
58619148951981bcfa5c506ad8ce745aa8831980rbbhost</context>
58619148951981bcfa5c506ad8ce745aa8831980rbb</contextlist>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>La directive <directive type="section">If</directive> évalue une
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh expression à la volée, et applique les directives qu'elle contient
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh si et seulement si l'expression renvoie la valeur "vrai". Par
2d2eda71267231c2526be701fe655db125852c1ffielding exemple :</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <If "-z req('Host')">
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh </example>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <var>Host:</var>. Les expressions peuvent contenir différents
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh opérateurs de type shell pour la comparaison de chaînes
0186cb43574836fc95a0506456210c94cfc3ea6ftrawick (<code>=</code>, <code>!=</code>, <code><</code>, ...), la
6e70165f24ec2e664764a9402e358eb0f6e99a3dtrawick comparaison d'entiers (<code>-eq</code>, <code>-ne</code>, ...), ou
0186cb43574836fc95a0506456210c94cfc3ea6ftrawick à usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>,
6e70165f24ec2e664764a9402e358eb0f6e99a3dtrawick ...). Les expressions rationnelles sont aussi supportées,</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <p>ainsi que les comparaison de modèles de type shell et de
2d2eda71267231c2526be701fe655db125852c1ffielding nombreuses autres opérations. Ces opérations peuvent être effectuées
2d2eda71267231c2526be701fe655db125852c1ffielding sur les en-têtes de requêtes (<code>req</code>), les variables
2d2eda71267231c2526be701fe655db125852c1ffielding d'environnement (<code>env</code>), et un grand nombre d'autres
2d2eda71267231c2526be701fe655db125852c1ffielding propriétés. La documentation complète est disponible dans <a
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh href="/expr.html">Les expressions dans le serveur HTTP Apache</a>.</p>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<seealso><a href="/expr.html">Les expressions dans le serveur HTTP
11e076839c8d5a82d55e710194d0daac51390dbdsfApache</a>, pour une référence complète et d'autres exemples.</seealso>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<seealso><directive type="section" module="core">ElseIf</directive></seealso>
11e076839c8d5a82d55e710194d0daac51390dbdsf<seealso><directive type="section" module="core">Else</directive></seealso>
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh<seealso><a href="/sections.html">Comment fonctionnent les sections
11e076839c8d5a82d55e710194d0daac51390dbdsf<Directory>, <Location> et <Files></a> pour une
2d2eda71267231c2526be701fe655db125852c1ffieldingexplication de la manière dont ces différentes sections se combinent
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianhentre elles à la réception d'une requête. Les
2d2eda71267231c2526be701fe655db125852c1ffieldingdirectives <directive type="section">If</directive>, <directive
11e076839c8d5a82d55e710194d0daac51390dbdsftype="section">Else</directive> s'appliquent en dernier.</seealso>
11e076839c8d5a82d55e710194d0daac51390dbdsf</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<description>Contient des directives qui ne s'appliqueront que si un
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianhtest retourne "vrai" au démarrage du serveur</description>
9f9307bbe539dbcf96919715315eb64ce3465f5bben<syntax><IfDefine [!]<var>paramètre</var>> ...
9f9307bbe539dbcf96919715315eb64ce3465f5bben </IfDefine></syntax>
9f9307bbe539dbcf96919715315eb64ce3465f5bben<contextlist><context>server config</context><context>virtual
9f9307bbe539dbcf96919715315eb64ce3465f5bbenhost</context>
9f9307bbe539dbcf96919715315eb64ce3465f5bben</contextlist>
2d2eda71267231c2526be701fe655db125852c1ffielding <var>test</var>>...</IfDefine></code> permet de
2d2eda71267231c2526be701fe655db125852c1ffielding conférer un caractère conditionnel à un ensemble de directives. Les
2d2eda71267231c2526be701fe655db125852c1ffielding directives situées à l'intérieur d'une section <directive
2d2eda71267231c2526be701fe655db125852c1ffielding type="section">IfDefine</directive> ne s'appliquent que si
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben <var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben se trouve entre les balises de début et de fin est ignoré.</p>
18173b5033350759b5aa4f6d9a4fd9e12d440135trawick <p><var>test</var> peut se présenter sous deux formes :</p>
18173b5033350759b5aa4f6d9a4fd9e12d440135trawick <li><code>!</code><var>nom paramètre</var></li>
84ba82304285b4bb1aafd5c6cdada5ce74c29973striker <p>Dans le premier cas, les directives situées entre les balises de
84ba82304285b4bb1aafd5c6cdada5ce74c29973striker début et de fin ne s'appliqueront que si le paramètre nommé <var>nom
84ba82304285b4bb1aafd5c6cdada5ce74c29973striker paramètre</var> est défini. Le second format inverse le test, et
84ba82304285b4bb1aafd5c6cdada5ce74c29973striker dans ce cas, les directives ne s'appliqueront que si <var>nom
84ba82304285b4bb1aafd5c6cdada5ce74c29973striker paramètre</var> n'est <strong>pas</strong> défini.</p>
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben <p>L'argument <var>nom paramètre</var> est une définition qui peut
5f7c351eb2a69d8cef6c3e98e27ce6158a0b1780rbb être effectuée par la ligne de commande
5f7c351eb2a69d8cef6c3e98e27ce6158a0b1780rbb <code>-D<var>paramètre</var></code> au démarrage du serveur, ou via la
13ac66e9c773fd63bf3c5e33a8de956df3feaf5dfuankg directive <directive module="core">Define</directive>.</p>
dca927eafb338b9de9d0214818136c16d436e3fdrbb <p>Les sections <directive type="section">IfDefine</directive>
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben peuvent être imbriquées, ce qui permet d'implémenter un test
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben multi-paramètres simple. Exemple :</p>
13ac66e9c773fd63bf3c5e33a8de956df3feaf5dfuankg httpd -DReverseProxy -DUseCache -DMemCache ...<br />
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <IfDefine ReverseProxy><br />
13ac66e9c773fd63bf3c5e33a8de956df3feaf5dfuankg LoadModule proxy_http_module modules/mod_proxy_http.so<br />
3d0bdf16bc410722e6c42aa2ceb0677b0ae29b90ianh <IfDefine UseCache><br />
13ac66e9c773fd63bf3c5e33a8de956df3feaf5dfuankg <IfDefine MemCache><br />
0e6e93183d91142d7cf9ffbf502114ff77bd9e19ben LoadModule mem_cache_module modules/mod_mem_cache.so<br />
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf </IfDefine><br />
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf <IfDefine !MemCache><br />
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf LoadModule cache_disk_module modules/mod_cache_disk.so<br />
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf </IfDefine>
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf </IfDefine>
db68899293b375438612f0aca6b1afecbc38cdd6sf </IfDefine>
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf </example>
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf</directivesynopsis>
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf<description>Contient des directives qui ne s'appliquent qu'en fonction
db68899293b375438612f0aca6b1afecbc38cdd6sfde la présence ou de l'absence d'un module spécifique</description>
7bf4eb9638a127fbfbc402d2c0e4ec0085934cf0sf<syntax><IfModule [!]<var>fichier module</var>|<var>identificateur
3a59bb90be3bc6246632384c3d885b875ae507d5sf<contextlist><context>server config</context><context>virtual
3a59bb90be3bc6246632384c3d885b875ae507d5sfhost</context>
3a59bb90be3bc6246632384c3d885b875ae507d5sf</contextlist>
3a59bb90be3bc6246632384c3d885b875ae507d5sf<compatibility>Les identificateurs de modules sont disponibles dans les
3a59bb90be3bc6246632384c3d885b875ae507d5sfversions 2.1 et supérieures.</compatibility>
3a59bb90be3bc6246632384c3d885b875ae507d5sf <var>test</var>>...</IfModule></code> permet de conférer à
3a59bb90be3bc6246632384c3d885b875ae507d5sf des directives un caractère conditionnel basé sur la présence d'un
3a59bb90be3bc6246632384c3d885b875ae507d5sf module spécifique. Les directives situées dans une section
3a59bb90be3bc6246632384c3d885b875ae507d5sf <directive type="section">IfModule</directive> ne s'appliquent que
3a59bb90be3bc6246632384c3d885b875ae507d5sf si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce
3a59bb90be3bc6246632384c3d885b875ae507d5sf qui se trouve entre les balises de début et de fin est ignoré.</p>
3a59bb90be3bc6246632384c3d885b875ae507d5sf <p><var>test</var> peut se présenter sous deux formes :</p>
3a59bb90be3bc6246632384c3d885b875ae507d5sf <p>Dans le premier cas, les directives situées entre les balises de
3a59bb90be3bc6246632384c3d885b875ae507d5sf début et de fin ne s'appliquent que si le module <var>module</var>
3a59bb90be3bc6246632384c3d885b875ae507d5sf est présent -- soit compilé avec le binaire Apache httpd, soit chargé
3a59bb90be3bc6246632384c3d885b875ae507d5sf dynamiquement via la directive <directive module="mod_so"
3a59bb90be3bc6246632384c3d885b875ae507d5sf >LoadModule</directive>. Le second format inverse le test, et dans
3a59bb90be3bc6246632384c3d885b875ae507d5sf ce cas, les directives ne s'appliquent que si <var>module</var>
55d986c77300fd39420b41f765b08c15b4c6418drbb <p>L'argument <var>module</var> peut contenir soit l'identificateur
2d2eda71267231c2526be701fe655db125852c1ffielding du module, soit le nom du fichier source du module. Par exemple,
2d2eda71267231c2526be701fe655db125852c1ffielding <code>rewrite_module</code> est un identificateur et
2d2eda71267231c2526be701fe655db125852c1ffielding <code>mod_rewrite.c</code> le nom du fichier source
2d2eda71267231c2526be701fe655db125852c1ffielding correspondant. Si un module comporte plusieurs fichiers sources,
11e076839c8d5a82d55e710194d0daac51390dbdsf utilisez le nom du fichier qui contient la chaîne de caractères
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p>Les sections <directive type="section">IfModule</directive>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh peuvent être imbriquées, ce qui permet d'implémenter des tests
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh multi-modules simples.</p>
<syntax>Include <var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></syntax>
type="section">LimitExcept</directive> doit toujours être préférée à
a été placée (c'est à dire au niveau du serveur, d'un répertoire,
avec caractères génériques, <code>?</code> correspond à un caractère
un mécanisme qui permet en général de récupérer le mutex après
module ; et, sauf si le mot-clé <code>OmitPID</code> a été spécifié,
href="/misc/perf-tuning.html">Amélioration des
href="/sections.html#mergin">comment les sections sont
options courantes de manière forcée et toute option précédée d'un
httpd pour trouver l'interpréteur destiné à exécuter les scripts CGI. La
programmes non voulus sur des fichiers non destinés à être exécutés.
>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code>
href="/vhosts/name-based.html">serveurs virtuels à base de
href="/vhosts/name-based.html">serveurs virtuels à base de
ServerName www.example.com
href="/vhosts/name-based.html">serveurs virtuels à base de
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
évènements avant de considérer qu'une requête a échoué</description>
href="/vhosts/name-based.html">serveurs virtuels à base de
href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">la