diff options
Diffstat (limited to 'docs/manual/mod/core.html.fr')
| -rw-r--r-- | docs/manual/mod/core.html.fr | 5625 |
1 files changed, 2999 insertions, 2626 deletions
diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 3632a1a850..d3a0a6e216 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -138,89 +138,91 @@ disponibles</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="acceptfilter" id="acceptfilter">Directive</a> <a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures optimizations for a Protocol's Listener Sockets</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser la configuration d'une socket pour +l'écoute d'un protocole</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocole</var> <var>filtre +d'acceptation</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive enables operating system specific optimizations for a - listening socket by the <code class="directive">Protocol</code> type. - The basic premise is for the kernel to not send a socket to the server - process until either data is received or an entire HTTP Request is buffered. - Only <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9"> - FreeBSD's Accept Filters</a>, Linux's more primitive - <code>TCP_DEFER_ACCEPT</code>, and Windows' optimized AcceptEx() - are currently supported.</p> - - <p>Using <code>none</code> for an argument will disable any accept filters - for that protocol. This is useful for protocols that require a server - send data first, such as <code>ftp:</code> or <code>nntp</code>:</p> + <p>Cette directive permet d'effectuer une optimisation de la socket + d'écoute d'un type de protocole en fonction du système + d'exploitation. Le but premier est de faire en sorte que le noyau + n'envoie pas de socket au processus du serveur jusqu'à ce que + des données soient reçues, ou qu'une requête HTTP complète soit mise + en tampon. Seuls les <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter& sektion=9">Filtres d'acceptation de FreeBSD</a>, le filtre plus + primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version + optimisée d'AcceptEx() de Windows sont actuellement supportés.</p> + + <p>L'utilisation de l'argument <code>none</code> va désactiver tout + filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les + protocoles qui nécessitent l'envoi de données par le serveur en + premier, comme <code>ftp:</code> ou <code>nntp</code>:</p> <pre class="prettyprint lang-config">AcceptFilter nntp none</pre> - <p>The default protocol names are <code>https</code> for port 443 - and <code>http</code> for all other ports. To specify that another - protocol is being used with a listening port, add the <var>protocol</var> - argument to the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> - directive.</p> + <p>Les noms de protocoles par défaut sont <code>https</code> pour le + port 443 et <code>http</code> pour tous les autres ports. Pour + spécifier un autre protocole à utiliser avec un port en écoute, + ajoutez l'argument <var>protocol</var> à la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> - <p>The default values on FreeBSD are:</p> + <p>Sous FreeBSD, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http httpready AcceptFilter https dataready</pre> - <p>The <code>httpready</code> accept filter buffers entire HTTP requests at - the kernel level. Once an entire request is received, the kernel then - sends it to the server. See the - <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9"> - accf_http(9)</a> man page for more details. Since HTTPS requests are - encrypted, only the <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9"> - accf_data(9)</a> filter is used.</p> + <p>Le filtre d'acceptation <code>httpready</code> met en tampon des + requêtes HTTP entières au niveau du noyau. Quand une requête + entière a été reçue, le noyau l'envoie au serveur. Voir la page de + manuel de <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http& sektion=9">accf_http(9)</a> pour plus de détails. Comme les requêtes + HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data& sektion=9">accf_data(9)</a>.</p> - <p>The default values on Linux are:</p> + <p>Sous Linux, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http data AcceptFilter https data</pre> - <p>Linux's <code>TCP_DEFER_ACCEPT</code> does not support buffering http - requests. Any value besides <code>none</code> will enable - <code>TCP_DEFER_ACCEPT</code> on that listener. For more details - see the Linux - <a href="http://man7.org/linux/man-pages/man7/tcp.7.html"> - tcp(7)</a> man page.</p> + <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas + la mise en tampon des requêtes http. Toute valeur autre que + <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code> + pour ce protocole. Pour plus de détails, voir la page de + manuel Linux de <a href="http://man7.org/linux/man-pages/man7/tcp.7.html">tcp(7)</a>.</p> - <p>The default values on Windows are:</p> + <p>Sous Windows, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http connect AcceptFilter https connect</pre> - <p>Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx() - API, and does not support http protocol buffering. <code>connect</code> - will use the AcceptEx() API, also retrieve the network endpoint - addresses, but like <code>none</code> the <code>connect</code> option - does not wait for the initial data transmission.</p> + <p>Le module MPM pour Windows mpm_winnt utilise la directive + AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte + pas la mise en tampon du protocole http. <code>connect</code> + utilise l'API AcceptEx(), extrait aussi les adresses réseau finales, + mais à l'instar de <code>none</code>, la valeur <code>connect</code> + n'attend pas la transmission des données initiales.</p> - <p>On Windows, <code>none</code> uses accept() rather than AcceptEx() - and will not recycle sockets between connections. This is useful for - network adapters with broken driver support, as well as some virtual - network providers such as vpn drivers, or spam, virus or spyware - filters.</p> + <p>Sous Windows, <code>none</code> utilise accept() au lieu + d'AcceptEx(), et ne recycle pas les sockets entre les connexions. + Ceci s'avère utile pour les interfaces réseau dont le pilote est + défectueux, ainsi que pour certains fournisseurs de réseau comme les + pilotes vpn, ou les filtres anti-spam, anti-virus ou + anti-spyware.</p> <div class="warning"> - <h3>The <code>data</code> AcceptFilter (Windows)</h3> - - <p>For versions 2.4.23 and prior, the Windows <code>data</code> accept - filter waited until data had been transmitted and the initial data - buffer and network endpoint addresses had been retrieved from the - single AcceptEx() invocation. This implementation was subject to a - denial of service attack and has been disabled.</p> - - <p>Current releases of httpd default to the <code>connect</code> filter - on Windows, and will fall back to <code>connect</code> if - <code>data</code> is specified. Users of prior releases are encouraged - to add an explicit setting of <code>connect</code> for their - AcceptFilter, as shown above.</p> + <h3>L'AcceptFilter <code>data</code> (Windows)</h3> + + <p>Jusqu'à la version 2.4.23, le filtre d'acceptation <code>data</code> + attendait que des données aient été transmises et que le tampon de données + initial et l'adresse réseau finale aient été déterminés par l'invocation + AcceptEx(). Cette implémentation étant vulnérable à une attaque de type + denial of service, elle a été désactivée.</p> + + <p>La version actuelle de httpd prend par défaut le filtre + <code>connect</code> sous Windows, et reprendra la valeur + <code>data</code> si <code>data</code> est spécifié. Il est fortement + conseillé aux utilisateurs des versions plus anciennes de définir + explicitement le filtre <code>connect</code> pour leurs AcceptFilter + comme indiqué plus haut.</p> </div> @@ -232,7 +234,8 @@ AcceptFilter https connect</pre> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="acceptpathinfo" id="acceptpathinfo">Directive</a> <a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Resources accept trailing pathname information</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources acceptent des informations sous forme d'un +nom de chemin en fin de requête.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AcceptPathInfo Default</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -241,83 +244,86 @@ AcceptFilter https connect</pre> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive controls whether requests that contain trailing - pathname information that follows an actual filename (or - non-existent file in an existing directory) will be accepted or - rejected. The trailing pathname information can be made - available to scripts in the <code>PATH_INFO</code> environment - variable.</p> - - <p>For example, assume the location <code>/test/</code> points to - a directory that contains only the single file - <code>here.html</code>. Then requests for - <code>/test/here.html/more</code> and - <code>/test/nothere.html/more</code> both collect - <code>/more</code> as <code>PATH_INFO</code>.</p> - - <p>The three possible arguments for the - <code class="directive">AcceptPathInfo</code> directive are:</p> + <p>Cette directive permet de définir si les requêtes contenant des + informations sous forme d'un nom de chemin suivant le nom d'un + fichier réel (ou un fichier qui n'existe pas dans un répertoire qui + existe) doivent être acceptées ou rejetées. Les scripts peuvent + accéder à cette information via la variable d'environnement + <code>PATH_INFO</code>.</p> + + <p>Supposons par exemple que <code>/test/</code> pointe vers un + répertoire qui ne contient que le fichier <code>here.html</code>. + Les requêtes pour <code>/test/here.html/more</code> et + <code>/test/nothere.html/more</code> vont affecter la valeur + <code>/more</code> à la variable d'environnement + <code>PATH_INFO</code>.</p> + + <p>L'argument de la directive <code class="directive">AcceptPathInfo</code> + possède trois valeurs possibles :</p> <dl> - <dt><code>Off</code></dt><dd>A request will only be accepted if it - maps to a literal path that exists. Therefore a request with - trailing pathname information after the true filename such as - <code>/test/here.html/more</code> in the above example will return - a 404 NOT FOUND error.</dd> - - <dt><code>On</code></dt><dd>A request will be accepted if a - leading path component maps to a file that exists. The above - example <code>/test/here.html/more</code> will be accepted if - <code>/test/here.html</code> maps to a valid file.</dd> - - <dt><code>Default</code></dt><dd>The treatment of requests with - trailing pathname information is determined by the <a href="../handler.html">handler</a> responsible for the request. - The core handler for normal files defaults to rejecting - <code>PATH_INFO</code> requests. Handlers that serve scripts, such as <a href="mod_cgi.html">cgi-script</a> and <a href="mod_isapi.html">isapi-handler</a>, generally accept - <code>PATH_INFO</code> by default.</dd> + <dt><code>Off</code></dt><dd>Une requête ne sera acceptée que si + elle correspond à un chemin qui existe. Par conséquent, une requête + contenant une information de chemin après le nom de fichier réel + comme <code>/test/here.html/more</code> dans l'exemple ci-dessus + renverra une erreur "404 NOT FOUND".</dd> + + <dt><code>On</code></dt><dd>Une requête sera acceptée si la partie + principale du chemin correspond à un fichier existant. Dans + l'exemple ci-dessus <code>/test/here.html/more</code>, la requête + sera acceptée si <code>/test/here.html</code> correspond à un nom de + fichier valide.</dd> + + <dt><code>Default</code></dt><dd>Le traitement des requêtes est + déterminé par le <a href="../handler.html">gestionnaire</a> responsable de la requête. + Le gestionnaire de base pour les fichiers normaux rejette par défaut + les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui + servent des scripts, comme<a href="mod_cgi.html">cgi-script</a> et <a href="mod_isapi.html">isapi-handler</a>, acceptent en général par + défaut les requêtes avec <code>PATH_INFO</code>.</dd> </dl> - <p>The primary purpose of the <code>AcceptPathInfo</code> - directive is to allow you to override the handler's choice of - accepting or rejecting <code>PATH_INFO</code>. This override is required, - for example, when you use a <a href="../filter.html">filter</a>, such - as <a href="mod_include.html">INCLUDES</a>, to generate content - based on <code>PATH_INFO</code>. The core handler would usually reject - the request, so you can use the following configuration to enable - such a script:</p> - - <pre class="prettyprint lang-config"><Files "mypaths.shtml"> + <p>Le but premier de la directive <code>AcceptPathInfo</code> est de + vous permettre de remplacer le choix du gestionnaire d'accepter ou + de rejeter <code>PATH_INFO</code>. Ce remplacement est nécessaire + par exemple, lorsque vous utilisez un <a href="../filter.html">filtre</a>, comme <a href="mod_include.html">INCLUDES</a>, pour générer un contenu basé + sur <code>PATH_INFO</code>. Le gestionnaire de base va en général + rejeter la requête, et vous pouvez utiliser la configuration + suivante pour utiliser un tel script :</p> +<pre class="prettyprint lang-config"><Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On </Files></pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="accessfilename" id="accessfilename">Directive</a> <a name="AccessFileName" id="AccessFileName">AccessFileName</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de configuration distribué</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du-fichier</var> +[<var>nom-du-fichier</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AccessFileName .htaccess</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>While processing a request, the server looks for - the first existing configuration file from this list of names in - every directory of the path to the document, if distributed - configuration files are <a href="#allowoverride">enabled for that - directory</a>. For example:</p> + <p>Au cours du traitement d'une requête, le serveur recherche le + premier fichier de configuration existant à partir de la liste + de noms dans chaque répertoire composant le chemin du document, à + partir du moment où les fichiers de configuration distribués sont <a href="#allowoverride">activés pour ce répertoire</a>. Par exemple + :</p> <pre class="prettyprint lang-config">AccessFileName .acl</pre> - <p>Before returning the document - <code>/usr/local/web/index.html</code>, the server will read - <code>/.acl</code>, <code>/usr/.acl</code>, - <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code> - for directives unless they have been disabled with:</p> + <p>avant de renvoyer le document + <code>/usr/local/web/index.html</code>, le serveur va rechercher les + fichiers <code>/.acl</code>, <code>/usr/.acl</code>, + <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code> + pour y lire d'éventuelles directives, à moins quelles n'aient été + désactivées avec</p> <pre class="prettyprint lang-config"><Directory "/"> AllowOverride None @@ -327,49 +333,56 @@ AcceptFilter https connect</pre> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> -<li><a href="../configuring.html">Configuration Files</a></li> -<li><a href="../howto/htaccess.html">.htaccess Files</a></li> +<li><a href="../configuring.html">Fichiers de configuration</a></li> +<li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="adddefaultcharset" id="adddefaultcharset">Directive</a> <a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default charset parameter to be added when a response -content-type is <code>text/plain</code> or <code>text/html</code></td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Paramètre jeu de caractères par défaut à ajouter quand le +type de contenu d'une réponse est <code>text/plain</code> ou +<code>text/html</code></td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDefaultCharset On|Off|<var>jeu de caractères</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AddDefaultCharset Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive specifies a default value for the media type - charset parameter (the name of a character encoding) to be added - to a response if and only if the response's content-type is either - <code>text/plain</code> or <code>text/html</code>. This should override - any charset specified in the body of the response via a <code>META</code> - element, though the exact behavior is often dependent on the user's client - configuration. A setting of <code>AddDefaultCharset Off</code> - disables this functionality. <code>AddDefaultCharset On</code> enables - a default charset of <code>iso-8859-1</code>. Any other value is assumed - to be the <var>charset</var> to be used, which should be one of the - <a href="http://www.iana.org/assignments/character-sets">IANA registered - charset values</a> for use in Internet media types (MIME types). - For example:</p> + <p>Cette directive spécifie une valeur par défaut pour le paramètre + jeu de caractères du type de média (le nom d'un codage de + caractères) à ajouter à une réponse, si et seulement si le type de + contenu de la réponse est soit <code>text/plain</code>, soit + <code>text/html</code>. Ceci va remplacer + tout jeu de caractères spécifié dans le corps de la réponse via un + élément <code>META</code>, bien que cet effet dépende en fait + souvent de la configuration du client de l'utilisateur. La + définition de <code>AddDefaultCharset Off</code> désactive cette + fonctionnalité. <code>AddDefaultCharset On</code> ajoute un jeu de + caractères par défaut de <code>iso-8859-1</code>. Toute autre valeur + peut être définie via le paramètre <var>jeu de caractères</var>, qui + doit appartenir à la liste des <a href="http://www.iana.org/assignments/character-sets">valeurs de + jeux de caractères enregistrés par l'IANA</a> à utiliser dans les + types de média Internet (types MIME). + Par exemple :</p> <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre> - <p><code class="directive">AddDefaultCharset</code> should only be used when all - of the text resources to which it applies are known to be in that - character encoding and it is too inconvenient to label their charset - individually. One such example is to add the charset parameter - to resources containing generated content, such as legacy CGI - scripts, that might be vulnerable to cross-site scripting attacks - due to user-provided data being included in the output. Note, however, - that a better solution is to just fix (or delete) those scripts, since - setting a default charset does not protect users that have enabled - the "auto-detect character encoding" feature on their browser.</p> + <p>La directive <code class="directive">AddDefaultCharset</code> ne doit + être utilisée que lorsque toutes les ressources textes auxquelles + elle s'applique possèdent le jeu de caractère spécifié, et qu'il est + trop contraignant de définir leur jeu de caractères + individuellement. Un exemple de ce type est l'ajout du paramètre jeu + de caractères aux ressources comportant un contenu généré, comme les + scripts CGI hérités qui peuvent être vulnérables à des attaques de + type cross-site scripting à cause des données utilisateurs incluses + dans leur sortie. Notez cependant qu'une meilleur solution consiste + à corriger (ou supprimer) ces scripts, car la définition d'un jeu de + caractères par défaut ne protège pas les utilisateurs qui ont activé + la fonctionnalité "Détection automatique de l'encodage des + caractères" dans leur navigateur.</p> <h3>Voir aussi</h3> <ul> @@ -379,37 +392,42 @@ content-type is <code>text/plain</code> or <code>text/html</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowencodedslashes" id="allowencodedslashes">Directive</a> <a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether encoded path separators in URLs are allowed to -be passed through</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les séparateurs de chemin encodés sont +autorisés à transiter dans les URLs tels quels</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|Off|NoDecode</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td> -NoDecode option available in 2.3.12 and later.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'option NoDecode est disponible depuis la version +2.3.12.</td></tr> </table> - <p>The <code class="directive">AllowEncodedSlashes</code> directive allows URLs - which contain encoded path separators (<code>%2F</code> for <code>/</code> - and additionally <code>%5C</code> for <code>\</code> on accordant systems) - to be used in the path info.</p> + <p>La directive <code class="directive">AllowEncodedSlashes</code> permet + l'utilisation des URLs contenant des séparateurs de chemin + encodés dans la partie chemin + (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour + <code>\</code> sur les systèmes concernés).</p> - <p>With the default value, <code>Off</code>, such URLs are refused - with a 404 (Not found) error.</p> + <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont + refusées et provoquent le renvoi d'une erreur 404 (Not found).</p> - <p>With the value <code>On</code>, such URLs are accepted, and encoded - slashes are decoded like all other encoded characters.</p> + <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les + slashes encodés sont décodés comme tout autre caractère codé.</p> - <p>With the value <code>NoDecode</code>, such URLs are accepted, but - encoded slashes are not decoded but left in their encoded state.</p> + <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées, + mais les slashes codés ne sont pas décodés et laissés dans leur état + codé.</p> - <p>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is - mostly useful when used in conjunction with <code>PATH_INFO</code>.</p> + <p>Définir <code class="directive">AllowEncodedSlashes</code> à + <code>On</code> est surtout utile en association avec + <code>PATH_INFO</code>.</p> <div class="note"><h3>Note</h3> - <p>If encoded slashes are needed in path info, use of <code>NoDecode</code> is - strongly recommended as a security measure. Allowing slashes - to be decoded could potentially allow unsafe paths.</p> + <p>Si le codage des slashes dans la partie chemin est nécessaire, + l'utilisation de l'option <code>NoDecode</code> est fortement + recommandée par mesure de sécurité. Permettre le décodage des + slashes pourrait éventuellement induire l'autorisation de chemins + non sûrs.</p> </div> <h3>Voir aussi</h3> @@ -420,167 +438,174 @@ NoDecode option available in 2.3.12 and later.</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowoverride" id="allowoverride">Directive</a> <a name="AllowOverride" id="AllowOverride">AllowOverride</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types of directives that are allowed in -<code>.htaccess</code> files</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autorisées dans les fichiers +<code>.htaccess</code></td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<var>directive-type</var> [<var>directive-type</var>] ...</code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier)</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverride None à partir de la version 2.3.9, AllowOverride +All pour les versions antérieures</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>When the server finds an <code>.htaccess</code> file (as - specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), - it needs to know which directives declared in that file can override - earlier configuration directives.</p> - - <div class="note"><h3>Only available in <Directory> sections</h3> - <code class="directive">AllowOverride</code> is valid only in - <code class="directive"><a href="#directory"><Directory></a></code> - sections specified without regular expressions, not in <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> or - <code class="directive"><a href="#files"><Files></a></code> sections. + <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont + le nom est défini par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles + des directives placées dans ce fichier sont autorisées à modifier la + configuration préexistante.</p> + + <div class="note"><h3>Valable seulement dans les sections + <Directory></h3> + La directive <code class="directive">AllowOverride</code> ne peut être + utilisée que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> définies sans expressions + rationnelles, et non dans les sections <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> ou + <code class="directive"><a href="#files"><Files></a></code>. </div> - <p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> is set to - <code>None</code>, <a href="#accessfilename">.htaccess</a> files are - completely ignored. In this case, the server will not even attempt - to read <code>.htaccess</code> files in the filesystem.</p> + <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> sont définies à <code>None</code>, les + fichiers <a href="#accessfilename">.htaccess</a> sont totalement + ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les + fichiers <code>.htaccess</code> du système de fichiers.</p> - <p>When this directive is set to <code>All</code>, then any - directive which has the .htaccess <a href="directive-dict.html#Context">Context</a> is allowed in - <code>.htaccess</code> files.</p> + <p>Lorsque cette directive est définie à <code>All</code>, toute + directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera + autorisée dans les fichiers <code>.htaccess</code>.</p> - <p>The <var>directive-type</var> can be one of the following - groupings of directives. (See the <a href="overrides.html">override class - index</a> for an up-to-date listing of which directives are enabled by each - <var>directive-type</var>.)</p> + <p>L'argument <var>directive-type</var> peut contenir les + groupements de directives suivants (Voir l'<a href="overrides.html">index de la class override</a> pour obtenir une liste mise à + jour des directives activées par chaque argument <var>directive-type</var>) :</p> <dl> <dt><a href="overrides.html#override-authconfig">AuthConfig</a></dt> <dd> - Allow use of the authorization directives (<code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>, + Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>, <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>, <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>, - <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, <em>etc.</em>).</dd> + <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, <em>etc...</em>).</dd> <dt><a href="overrides.html#override-fileinfo">FileInfo</a></dt> <dd> - Allow use of the directives controlling document types - (<code class="directive"><a href="#errordocument">ErrorDocument</a></code>, - <code class="directive"><a href="#forcetype">ForceType</a></code>, - <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, - <code class="directive"><a href="#sethandler">SetHandler</a></code>, - <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, - <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, and - <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* and Remove* directives), - document meta data (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiename">CookieName</a></code>), - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives (<code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>), - <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> directives (<code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirecttemp">RedirectTemp</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectpermanent">RedirectPermanent</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code>), and - <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> from + Permet l'utilisation des directives qui contrôlent les types de + documents (directives <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, + <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, et directives du + module <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* et Remove*), des metadonnées + des documents (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiename">CookieName</a></code>), des directives du + module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives (<code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>), des directives du + module <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> directives (<code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirecttemp">RedirectTemp</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectpermanent">RedirectPermanent</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code>), et de la directive + <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> du module <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>. </dd> <dt><a href="overrides.html#override-indexes">Indexes</a></dt> <dd> - Allow use of the directives controlling directory indexing - (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>, + Permet l'utilisation des directives qui contrôlent l'indexation + des répertoires (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>, - <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>, - <em>etc.</em>).</dd> + <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>, + <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>, + <em>etc...</em>).</dd> <dt><a href="overrides.html#override-limit">Limit</a></dt> <dd> - Allow use of the directives controlling host access (<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> and <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>).</dd> + Permet l'utilisation des directives contrôlant l'accès au serveur + (<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> et <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>).</dd> + + <dt>Nonfatal=[Override|Unknown|All]</dt> - <dd> - Allow use of AllowOverride option to treat invalid (unrecognized - or disallowed) directives in - .htaccess as nonfatal. Instead of causing an Internal Server - Error, disallowed or unrecognised directives will be ignored - and a warning logged: + <dd>Permet d'utiliser l'option AllowOverride pour rendre non fatales les + directives invalides (non reconnues ou non permises) dans les fichiers + .htaccess : au lieu de causer une Internal Server Error, les directives + non autorisées ou non reconnues seront ignorées et un avertissement + enregistré dans le journal : <ul> - <li><strong>Nonfatal=Override</strong> treats directives - forbidden by AllowOverride as nonfatal.</li> - <li><strong>Nonfatal=Unknown</strong> treats unknown directives - as nonfatal. This covers typos and directives implemented - by a module that's not present.</li> - <li><strong>Nonfatal=All</strong> treats both the above as nonfatal.</li> + <li><strong>Nonfatal=Override</strong> rend les directives + interdite par AllowOverride non fatales.</li> + <li><strong>Nonfatal=Unknown</strong> rend les directives + inconnues non fatales. Sont concernées les erreurs de frappe + et les directives implémentées par un module non chargé.</li> + <li><strong>Nonfatal=All</strong> rend toutes les directives + précédentes non fatales.</li> </ul> - <p>Note that a syntax error in a valid directive will still cause - an Internal Server Error.</p> - <div class="warning"><h3>Security</h3> - Nonfatal errors may have security implications for .htaccess users. - For example, if AllowOverride disallows AuthConfig, users' - configuration designed to restrict access to a site will be disabled. + <p>Notez qu'une erreur de syntaxe dans une directive valide + causera toujours une Internal Server Error.</p> + <div class="warning"><h3>Sécurité</h3> + Les erreurs non fatales peuvent être à l'origine de problèmes + de sécurité pour les utilisateurs de fichiers .htaccess. Par + exemple, si AllowOverride interdit AuthConfig, toute + configuration utilisateur destinée à restreindre l'accès à un + site ne sera pas prise en compte. </div> </dd> <dt><a href="overrides.html#override-options">Options</a>[=<var>Option</var>,...]</dt> <dd> - Allow use of the directives controlling specific directory - features (<code class="directive"><a href="#options">Options</a></code> and - <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). - An equal sign may be given followed by a comma-separated list, without - spaces, of options that may be set using the <code class="directive"><a href="#options">Options</a></code> command. - - <div class="note"><h3>Implicit disabling of Options</h3> - <p>Even though the list of options that may be used in .htaccess files - can be limited with this directive, as long as any <code class="directive"><a href="#options">Options</a></code> directive is allowed any - other inherited option can be disabled by using the non-relative - syntax. In other words, this mechanism cannot force a specific option - to remain <em>set</em> while allowing any others to be set. + Permet l'utilisation des directives contrôlant les fonctionnalités + spécifiques d'un répertoire (<code class="directive"><a href="#options">Options</a></code> et <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). "Options" doit être + suivi d'un signe "égal", puis d'une liste d'options séparées par des + virgules (pas d'espaces) ; ces options doivent être définies à + l'aide de la commande <code class="directive"><a href="#options">Options</a></code>. + + <div class="note"><h3>Désactivation implicite des options</h3> + <p>Bien que la liste des options disponibles dans les fichiers + .htaccess puisse être limitée par cette directive, tant qu'un + directive <code class="directive"><a href="#options">Options</a></code> est + autorisée, toute autre option héritée peut être désactivée en + utilisant la syntaxe non-relative. En d'autres termes, ce + mécanisme ne peut pas forcer une option spécifique à rester + <em>activée</em> tout en permettant à toute autre option d'être + activée. </p></div> <div class="example"><p><code> AllowOverride Options=Indexes,MultiViews </code></p></div> + </dd> </dl> - <p>Example:</p> + <p>Exemple :</p> <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre> - <p>In the example above, all directives that are neither in the group - <code>AuthConfig</code> nor <code>Indexes</code> cause an internal - server error.</p> + <p>Dans l'exemple ci-dessus, toutes les directives qui ne font + partie ni du groupe <code>AuthConfig</code>, ni du groupe + <code>Indexes</code>, provoquent une erreur "Internal + Server Error".</p> - <div class="note"><p>For security and performance reasons, do not set - <code>AllowOverride</code> to anything other than <code>None</code> - in your <code><Directory "/"></code> block. Instead, find (or - create) the <code><Directory></code> block that refers to the - directory where you're actually planning to place a - <code>.htaccess</code> file.</p> + <div class="note"><p>Pour des raisons de sécurité et de performance, ne + définissez pas <code>AllowOverride</code> à autre chose que + <code>None</code> dans votre bloc <code><Directory "/"></code>. + Recherchez plutôt (ou créez) le bloc <code><Directory></code> + qui se réfère au répertoire où vous allez précisément placer un + fichier <code>.htaccess</code>.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> <li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li> -<li><a href="../configuring.html">Configuration Files</a></li> -<li><a href="../howto/htaccess.html">.htaccess Files</a></li> -<li><a href="overrides.html">Override Class Index for .htaccess</a></li> +<li><a href="../configuring.html">Fichiers de configuration</a></li> +<li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> +<li><a href="overrides.html">Index de la class Override pour .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowoverridelist" id="allowoverridelist">Directive</a> <a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Individual directives that are allowed in -<code>.htaccess</code> files</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directives autorisées dans les fichiers <code>.htaccess</code></td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverrideList None|<var>directive</var> [<var>directive-type</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverrideList None</code></td></tr> @@ -588,22 +613,21 @@ NoDecode option available in 2.3.12 and later.</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>When the server finds an <code>.htaccess</code> file (as - specified by <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), - it needs to know which directives declared in that file can override - earlier configuration directives.</p> - - <div class="note"><h3>Only available in <Directory> sections</h3> - <code class="directive">AllowOverrideList</code> is valid only in - <code class="directive"><a href="#directory"><Directory></a></code> - sections specified without regular expressions, not in <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> or - <code class="directive"><a href="#files"><Files></a></code> sections. + <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> + (comme spécifié par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles + des directives déclarées dans ce fichier peuvent remplacer des + directives des fichiers de configuration du serveur.</p> + + <div class="note"><h3>Seulement disponible dans les sections <Directory></h3> + La directive <code class="directive">AllowOverrideList</code> n'est + disponible que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> spécifiées sans expressions + rationnelles. </div> - <p>When this directive is set to <code>None</code> and <code class="directive"><a href="#allowoverride">AllowOverride</a></code> is set to <code>None</code>, - then <a href="#accessfilename">.htaccess</a> files are completely - ignored. In this case, the server will not even attempt to read - <code>.htaccess</code> files in the filesystem.</p> + <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> sont définies à + <code>None</code>, les fichiers <a href="#accessfilename">.htaccess</a> sont totalement ignorés. Dans + ce cas, le serveur ne cherchera même pas à lire des fichiers + <code>.htaccess</code> dans le système de fichiers.</p> <p>Example:</p> @@ -611,9 +635,9 @@ NoDecode option available in 2.3.12 and later.</td></tr> AllowOverrideList Redirect RedirectMatch</pre> - <p>In the example above, only the <code>Redirect</code> and - <code>RedirectMatch</code> directives are allowed. All others will - cause an Internal Server Error.</p> + <p>Dans l'exemple ci-dessus, seules les directives + <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées. + Toutes les autres provoqueront une erreur interne du serveur.</p> <p>Example:</p> @@ -621,128 +645,139 @@ AllowOverrideList Redirect RedirectMatch</pre> AllowOverrideList CookieTracking CookieName</pre> - <p>In the example above, <code class="directive"><a href="#allowoverride">AllowOverride - </a></code> grants permission to the <code>AuthConfig</code> - directive grouping and <code class="directive">AllowOverrideList</code> grants - permission to only two directives from the <code>FileInfo</code> directive - grouping. All others will cause an Internal Server Error.</p> + <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> autorise les directives du + groupement <code>AuthConfig</code>, et + <code class="directive">AllowOverrideList</code> n'autorise que deux + directives du groupement <code>FileInfo</code>. Toutes les autres + provoqueront une erreur interne du serveur.</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> -<li><a href="../configuring.html">Configuration Files</a></li> -<li><a href="../howto/htaccess.html">.htaccess Files</a></li> +<li><a href="../configuring.html">Fichiers de configuration</a></li> +<li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="asyncfilter" id="asyncfilter">Directive</a> <a name="AsyncFilter" id="AsyncFilter">AsyncFilter</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the minimum filter type eligible for asynchronous handling</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le type de filtrage minimal disponible pour le + traitement asynchrone</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AsyncFilter request|connection|network</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AsyncFilter request</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Only available from Apache 2.5.0 and later.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.0 du serveur + HTTP Apache</td></tr> </table> - <p>This directive controls the minimum filter levels that are eligible - for asynchronous handling. This may be necessary to support legacy external - filters that did not handle meta buckets correctly.</p> - - <p>If set to "network", asynchronous handling will be limited to the network - filter only. If set to "connection", all connection and network filters - will be eligible for asynchronous handling, including <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. - If set to "request", all filters will be eligible for asynchronous handling.</p> + <p>Cette directive permet de définir les niveaux minimaux de + filtrage disponibles pour le traitement asynchrone. Son + utilisation s'avère nécessaire pour le support des filtres + externes anciens qui ne géraient pas les meta-conteneurs + correctement.</p> + + <p>Si elle est définie à "network", le traitement asynchrone se + limitera aux filtrages réseau. Si elle est définie à + "connection", tous les filtres de réseau et de connexion seront + disponibles pour le traitement asynchrone, y compris + <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Si elle est définie à "request", tous + les filtres seront disponibles pour le traitement asynchrone.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgimapextension" id="cgimapextension">Directive</a> <a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI -scripts</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettant de localiser l'interpréteur des +scripts CGI</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare only</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare uniquement</td></tr> </table> - <p>This directive is used to control how Apache httpd finds the - interpreter used to run CGI scripts. For example, setting - <code>CGIMapExtension sys:\foo.nlm .foo</code> will - cause all CGI script files with a <code>.foo</code> extension to - be passed to the FOO interpreter.</p> + <p>Cette directive permet de contrôler la manière dont Apache httpd trouve + l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec + la définition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous + les fichiers scripts CGI possédant une extension <code>.foo</code> + seront passés à l'interpréteur FOO.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgipassauth" id="cgipassauth">Directive</a> <a name="CGIPassAuth" id="CGIPassAuth">CGIPassAuth</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables passing HTTP authorization headers to scripts as CGI -variables</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la transmission d'en-têtes d'autorisation HTTP aux scripts en +tant que variables CGI</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIPassAuth On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CGIPassAuth Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.4.13 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.13 du serveur HTTP +Apache</td></tr> </table> - <p><code class="directive">CGIPassAuth</code> allows scripts access to HTTP - authorization headers such as <code>Authorization</code>, which is - required for scripts that implement HTTP Basic authentication. - Normally these HTTP headers are hidden from scripts. This is to disallow - scripts from seeing user ids and passwords used to access the server when - HTTP Basic authentication is enabled in the web server. This directive - should be used when scripts are allowed to implement HTTP Basic - authentication.</p> - - <p>This directive can be used instead of the compile-time setting - <code>SECURITY_HOLE_PASS_AUTHORIZATION</code> which has been available - in previous versions of Apache HTTP Server.</p> - - <p>The setting is respected by any modules which use - <code>ap_add_common_vars()</code>, such as <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, + <p>La directive <code class="directive">CGIPassAuth</code> permet aux + scripts d'accéder aux en-têtes d'autorisation HTTP tels que + <code>Authorization</code>, en-tête nécessaire aux scripts qui + implémente une authentification HTTP de base. Normalement, ces + en-têtes HTTP sont invisibles pour les scripts car ils leurs + permettraient de voir les identifiants et mots de passe + utilisés pour accéder au serveur lorsque l'authentification HTTP de + base est activée au niveau du serveur web. Cette directive doit être + définie à "On" lorsque des scripts sont autorisés à implémenter une + authentification HTTP de base.</p> + + <p>Cette directive constitue une alternative à l'option de + compilation <code>SECURITY_HOLE_PASS_AUTHORIZATION</code> qui était + déjà disponible dans les versions précédentes du serveur HTTP + Apache.</p> + + <p>Cette option est prise en compte par tout module qui utilise + <code>ap_add_common_vars()</code>, comme <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>, - <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>, and so on. Notably, it affects - modules which don't handle the request in the usual sense but - still use this API; examples of this are <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> - and <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>. Third-party modules that don't - use <code>ap_add_common_vars()</code> may choose to respect the setting - as well.</p> + <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>, etc... En particulier, elle affecte + les modules qui ne traitent pas à proprement parler les requêtes, + mais utilisent quand-même cette API, comme + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ou <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>. Les + modules tiers qui n'utilisent pas <code>ap_add_common_vars()</code> + peuvent aussi choisir de prendre en compte cette option.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgivar" id="cgivar">Directive</a> <a name="CGIVar" id="CGIVar">CGIVar</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls how some CGI variables are set</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la manière dont certaines variables CGI sont définies</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIVar <var>variable</var> <var>rule</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.4.21 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</td></tr> </table> - <p>This directive controls how some CGI variables are set.</p> + <p>Cette directive permet de contrôler la manière dont certaines variables CGI + sont définies.</p> - <p><strong>REQUEST_URI</strong> rules:</p> + <p>règles <strong>REQUEST_URI</strong> :</p> <dl> - <dt><code>original-uri</code> (default)</dt> - <dd>The value is taken from the original request line, and will not - reflect internal redirects or subrequests which change the requested - resource.</dd> + <dt><code>original-uri</code> (valeur par défaut)</dt> + <dd>La valeur est extraite de la requête originale, et ne tient pas compte + des redirections internes ou des sous-requêtes qui pourraient modifier la + ressource demandée.</dd> <dt><code>current-uri</code></dt> - <dd>The value reflects the resource currently being processed, - which may be different than the original request from the client - due to internal redirects or subrequests.</dd> + <dd>La valeur reflète la ressource en cours de traitement ; elle peut être + différente de la ressource demandée dans la requête initiale du client suite à + d'éventuelles redirections internes ou sous-requêtes.</dd> </dl> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="contentdigest" id="contentdigest">Directive</a> <a name="ContentDigest" id="ContentDigest">ContentDigest</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the generation of <code>Content-MD5</code> HTTP Response -headers</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d'un en-tête <code>Content-MD5</code> +dans la réponse HTTP</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ContentDigest Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -750,104 +785,114 @@ headers</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive enables the generation of - <code>Content-MD5</code> headers as defined in RFC1864 - respectively RFC2616.</p> + <p>Cette directive active la génération d'un en-tête + <code>Content-MD5</code> selon les définitions des RFC 1864 et + 2616.</p> - <p>MD5 is an algorithm for computing a "message digest" - (sometimes called "fingerprint") of arbitrary-length data, with - a high degree of confidence that any alterations in the data - will be reflected in alterations in the message digest.</p> + <p>MD5 est un algorithme permettant de générer un condensé (parfois + appelé "empreinte") à partir de données d'une taille aléatoire ; le + degré de précision est tel que la moindre altération des données + d'origine entraîne une altération de l'empreinte.</p> - <p>The <code>Content-MD5</code> header provides an end-to-end - message integrity check (MIC) of the entity-body. A proxy or - client may check this header for detecting accidental - modification of the entity-body in transit. Example header:</p> + <p>L'en-tête <code>Content-MD5</code> permet de vérifier + l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire + ou un client peut utiliser cet en-tête pour rechercher une + éventuelle modification accidentelle de la réponse au cours de sa + transmission. Exemple d'en-tête :</p> <div class="example"><p><code> Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA== </code></p></div> - <p>Note that this can cause performance problems on your server - since the message digest is computed on every request (the - values are not cached).</p> + <p>Notez que des problèmes de performances peuvent affecter votre + serveur, car l'empreinte est générée pour chaque requête (il n'y a + pas de mise en cache).</p> - <p><code>Content-MD5</code> is only sent for documents served - by the <code class="module"><a href="../mod/core.html">core</a></code>, and not by any module. For example, - SSI documents, output from CGI scripts, and byte range responses - do not have this header.</p> + <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les + documents servis par le module <code class="module"><a href="../mod/core.html">core</a></code>, à l'exclusion + de tout autre module. Ainsi, les documents SSI, les sorties de + scripts CGI, et les réponses à des requêtes partielles (byte range) + ne comportent pas cet en-tête.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="defaultruntimedir" id="defaultruntimedir">Directive</a> <a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server run-time files</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>directory-path</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire de base des fichiers créés au cours de l'exécution du serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>chemin-répertoire</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.2 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis de la version 2.4.2 du serveur HTTP +Apache</td></tr> </table> - <p>The <code class="directive">DefaultRuntimeDir</code> directive sets the - directory in which the server will create various run-time files - (shared memory, locks, etc.). If set as a relative path, the full path - will be relative to <code class="directive">ServerRoot</code>.</p> + <p>La directive <code class="directive">DefaultRuntimeDir</code> permet de + définir le répertoire dans lequel le serveur va créer les différents + fichiers relatifs à son exécution (mémoire partagée, verrous, + etc...). Si le chemin spécifié est relatif, le chemin absolu sera + généré relativement à la valeur de la directive + <code class="directive">ServerRoot</code>.</p> <p><strong>Example</strong></p> <pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre> - <p>The default location of <code class="directive">DefaultRuntimeDir</code> may be - modified by changing the <code>DEFAULT_REL_RUNTIMEDIR</code> #define - at build time.</p> + <p>La valeur par défaut de la directive + <code class="directive">DefaultRuntimeDir</code> peut être modifiée en + changeant la valeur de la macro <code>DEFAULT_REL_RUNTIMEDIR</code> + définie à la compilation.</p> - <p>Note: <code class="directive">ServerRoot</code> should be specified before this - directive is used. Otherwise, the default value of <code class="directive">ServerRoot</code> - would be used to set the base directory.</p> + <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas + été spécifiée avant d'utiliser cette directive, c'est la valeur par + défaut de <code class="directive">ServerRoot</code> qui sera utilisée pour + définir la base du répertoire.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../misc/security_tips.html#serverroot">the - security tips</a> for information on how to properly set - permissions on the <code class="directive">ServerRoot</code></li> +<li>Voir les <a href="../misc/security_tips.html#serverroot">conseils à propos de +sésurité</a> pour plus d'informations en vue de définir correctement les +permissions sur la racine du serveur <code class="directive">ServerRoot</code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="defaulttype" id="defaulttype">Directive</a> <a name="DefaultType" id="DefaultType">DefaultType</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>This directive has no effect other than to emit warnings -if the value is not <code>none</code>. In prior versions, DefaultType -would specify a default media type to assign to response content for -which no other media type configuration could be found. +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de cette directive sont des émissions +d'avertissements si sa valeur est différente de <code>none</code>. Dans +les versions précédentes, DefaultType permettait de spécifier un type de +média à assigner par défaut au contenu d'une réponse pour lequel aucun +autre type de média n'avait été trouvé. </td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>media-type|none</var></code></td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type média|none</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultType none</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>All choices except <code>none</code> are DISABLED for 2.3.x and later. -</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Tous les arguments, excepté <code>none</code>, sont +DESACTIVÉS à partir de la version 2.3.0.</td></tr> </table> - <p>This directive has been disabled. For backwards compatibility - of configuration files, it may be specified with the value - <code>none</code>, meaning no default media type. For example:</p> + <p>Cette directive a été désactivée. Pour la compatibilité + ascendante avec les anciens fichiers de configuration, elle peut + être spécifiée avec la valeur <code>none</code>, c'est à dire sans + type de médium par défaut. Par exemple :</p> <pre class="prettyprint lang-config">DefaultType None</pre> - <p><code>DefaultType None</code> is only available in - httpd-2.2.7 and later.</p> + <p><code>DefaultType None</code> n'est disponible que dans les + versions d'Apache 2.2.7 et supérieures.</p> - <p>Use the mime.types configuration file and the - <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> to configure media - type assignments via file extensions, or the - <code class="directive"><a href="#forcetype">ForceType</a></code> directive to configure - the media type for specific resources. Otherwise, the server will - send the response without a Content-Type header field and the - recipient may attempt to guess the media type.</p> + <p>Utilisez le fichier de configuration mime.types et la directive + <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> pour configurer + l'assignement d'un type de médium via les extensions de fichiers, ou + la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour + attribuer un type de médium à des ressources spécifiques. Dans le + cas contraire, le serveur enverra sa réponse sans champ d'en-tête + Content-Type, et le destinataire devra déterminer lui-même le type + de médium.</p> <h3>Voir aussi</h3> <ul> @@ -858,23 +903,23 @@ which no other media type configuration could be found. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="define" id="define">Directive</a> <a name="Define" id="Define">Define</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a variable</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>parameter-name</var> [<var>parameter-value</var>]</code></td></tr> -<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de définir une variable</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>nom-paramètre</var> [<var>valeur-paramètre</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>In its one parameter form, <code class="directive">Define</code> is - equivalent to passing the <code>-D</code> argument to - <code class="program"><a href="../programs/httpd.html">httpd</a></code>. It can be used to toggle the use of - <code class="directive"><a href="#ifdefine"><IfDefine></a></code> - sections without needing to alter <code>-D</code> arguments in any - startup scripts.</p> - - <p>In addition to that, if the second parameter is given, a config variable - is set to this value. The variable can be used in the configuration using - the <code>${VAR}</code> syntax. The variable is always globally defined - and not limited to the scope of the surrounding config section.</p> + <p>Avec un seul paramètre, l'effet de la directive + <code class="directive">Define</code> est identique à celui de l'argument + <code>-D</code> du programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Il permet de + modifier le comportement des sections <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sans avoir à ajouter d'argument + <code>-D</code> au sein des scripts de démarrage.</p> + + <p>De plus, le second paramètre permet d'affecter une valeur à la + variable définie par le premier. Cette variable peut être référencée + dans le fichier de configuration via la syntaxe <code>${VAR}</code>. + La portée de la variable est toujours globale, et n'est jamais + limitée à la section de configuration courante.</p> <pre class="prettyprint lang-config"><IfDefine TEST> Define servername test.example.com @@ -884,80 +929,86 @@ which no other media type configuration could be found. Define SSL </IfDefine> -DocumentRoot "/var/www/${servername}/htdocs"</pre> + DocumentRoot "/var/www/${servername}/htdocs"</pre> - <p>Variable names may not contain colon ":" characters, to avoid clashes - with <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>'s syntax.</p> + <p>Le caractère ":" est interdit dans les noms de variables afin + d'éviter les conflits avec la syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> - <div class="note"><h3>Virtual Host scope and pitfalls</h3> - <p>While this directive is supported in virtual host context, - the changes it makes are visible to any later configuration - directives, beyond any enclosing virtual host.</p> + <div class="note"><h3>Portée de la directive et pièges à éviter</h3> + <p>Si cette directive est définie au sein d'un bloc VirtualHost, les + changements qu'elle induit sont visibles de toute directive + ultérieure, au delà de tout bloc VirtualHost.</p> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="directory" id="directory">Directive</a> <a name="Directory" id="Directory"><Directory></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that apply only to the -named file-system directory, sub-directories, and their contents.</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Directory <var>directory-path</var>> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui ne s'appliquent +qu'au répertoire concerné du système de fichiers, à ses +sous-répertoires, et à leur contenu.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Directory <var>chemin répertoire</var>> ... </Directory></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><code class="directive"><Directory></code> and - <code></Directory></code> are used to enclose a group of - directives that will apply only to the named directory, - sub-directories of that directory, and the files within the respective - directories. Any directive that is allowed - in a directory context may be used. <var>Directory-path</var> is - either the full path to a directory, or a wild-card string using - Unix shell-style matching. In a wild-card string, <code>?</code> matches - any single character, and <code>*</code> matches any sequences of - characters. You may also use <code>[]</code> character ranges. None - of the wildcards match a `/' character, so <code><Directory - "/*/public_html"></code> will not match - <code>/home/user/public_html</code>, but <code><Directory - "/home/*/public_html"></code> will match. Example:</p> + <p>Les balises <code class="directive"><Directory></code> et + <code></Directory></code> permettent de regrouper un ensemble + de directives qui ne s'appliquent qu'au répertoire précisé, + à ses sous-répertoires, et aux fichiers situés dans ces + sous-répertoires. Toute directive + autorisée dans un contexte de répertoire peut être utilisée. + <var>chemin répertoire</var> est soit le chemin absolu d'un + répertoire, soit une chaîne de caractères avec caractères génériques + utilisant la comparaison Unix de style shell. Dans une chaîne de + caractères avec caractères génériques, <code>?</code> correspond à + un caractère quelconque, et <code>*</code> à toute chaîne de + caractères. Les intervalles de caractères <code>[]</code> sont aussi + autorisés. Aucun caractère générique ne peut remplacer le caractère + `/', si bien que l'expression <code><Directory + "/*/public_html"></code> ne conviendra pas pour le chemin + * <code>/home/user/public_html</code>, alors que <code><Directory + "/home/*/public_html"></code> conviendra. Exemple :</p> <pre class="prettyprint lang-config"><Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks </Directory></pre> - <p>Directory paths <em>may</em> be quoted, if you like, however, it - <em>must</em> be quoted if the path contains spaces. This is because a - space would otherwise indicate the end of an argument.</p> + <p>Les chemins de répertoires contenant des espaces <em>doivent</em> être + entourés de guillemets afin d'empêcher l'interprétation de ces + espaces comme fins d'arguments.</p> <div class="note"> - <p>Be careful with the <var>directory-path</var> arguments: - They have to literally match the filesystem path which Apache httpd uses - to access the files. Directives applied to a particular - <code><Directory></code> will not apply to files accessed from - that same directory via a different path, such as via different symbolic - links.</p> + <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il + doit correspondre exactement au chemin du système de fichier + qu'Apache httpd utilise pour accéder aux fichiers. Les directives + comprises dans une section <code><Directory></code> ne + s'appliqueront pas aux fichiers du même répertoire auxquels on + aura accédé via un chemin différent, per exemple via un lien + symbolique.</p> </div> - <p><a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Regular - expressions</a> can also be used, with the addition of the - <code>~</code> character. For example:</p> + <p> Les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> + peuvent aussi être utilisées en ajoutant le caractère + <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Directory ~ "^/www/[0-9]{3}"> </Directory></pre> - <p>would match directories in <code>/www/</code> that consisted of - three numbers.</p> + <p>pourra correspondre à tout répertoire situé dans /www/ et dont le + nom se compose de trois chiffres.</p> - <p>If multiple (non-regular expression) <code class="directive"><Directory></code> sections - match the directory (or one of its parents) containing a document, - then the directives are applied in the order of shortest match - first, interspersed with the directives from the <a href="#accessfilename">.htaccess</a> files. For example, - with</p> + <p>Si plusieurs sections <code class="directive"><Directory></code> (sans expression rationnelle) + correspondent au répertoire (ou à un de ses parents) qui contient le + document, les directives de la section <code class="directive"><Directory></code> dont le chemin est le plus + court sont appliquées en premier, en s'intercalant avec les + directives des fichiers <a href="#accessfilename">.htaccess</a>. Par + exemple, avec</p> <pre class="prettyprint lang-config"><Directory "/"> AllowOverride None @@ -968,180 +1019,189 @@ named file-system directory, sub-directories, and their contents.</td></tr> </Directory></pre> - <p>for access to the document <code>/home/web/dir/doc.html</code> - the steps are:</p> + <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte + le chemin suivant :</p> <ul> - <li>Apply directive <code>AllowOverride None</code> - (disabling <code>.htaccess</code> files).</li> + <li>Aplication de la directive <code>AllowOverride None</code> + (qui désactive les fichiers <code>.htaccess</code>).</li> - <li>Apply directive <code>AllowOverride FileInfo</code> (for - directory <code>/home</code>).</li> + <li>Application de la directive <code>AllowOverride + FileInfo</code> (pour le répertoire <code>/home</code>).</li> - <li>Apply any <code>FileInfo</code> directives in - <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> and - <code>/home/web/dir/.htaccess</code> in that order.</li> + <li>Application de toute directive <code>FileInfo</code> qui se + trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>, + <code>/home/web/.htaccess</code> ou + <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li> </ul> - <p>Regular expressions are not considered until after all of the - normal sections have been applied. Then all of the regular - expressions are tested in the order they appeared in the - configuration file. For example, with</p> + <p>Les directives associées aux répertoires sous forme d'expressions + rationnelles ne sont prises en compte qu'une fois toutes les + directives des sections sans expressions rationnelles appliquées. + Alors, tous les répertoires avec expressions rationnelles sont + testés selon l'ordre dans lequel ils apparaissent dans le fichier de + configuration. Par exemple, avec</p> <pre class="prettyprint lang-config"><Directory ~ "abc$"> - # ... directives here ... + # ... directives ici ... </Directory></pre> - <p>the regular expression section won't be considered until after - all normal <code class="directive"><Directory></code>s and - <code>.htaccess</code> files have been applied. Then the regular - expression will match on <code>/home/abc/public_html/abc</code> and - the corresponding <code class="directive"><Directory></code> will - be applied.</p> + <p>la section avec expression rationnelle ne sera prise en compte + qu'après les sections <code class="directive"><Directory></code> sans expression rationnelle + et les fichiers <code>.htaccess</code>. Alors, l'expression + rationnelle conviendra pour <code>/home/abc/public_html/abc</code> + et la section <code class="directive"><Directory></code> + correspondante s'appliquera.</p> - <p><strong>Note that the default access for - <code><Directory "/"></code> is to permit all access. - This means that Apache httpd will serve any file mapped from an URL. It is - recommended that you change this with a block such - as</strong></p> + <p><strong>Notez que la politique d'accès par défaut + dans les sections <code><Directory "/"></code> consiste à + autoriser tout accès sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier + correspondant à une URL. Il est recommandé de modifier cette + situation à l'aide d'un bloc du style</strong></p> <pre class="prettyprint lang-config"><Directory "/"> Require all denied </Directory></pre> - <p><strong>and then override this for directories you - <em>want</em> accessible. See the <a href="../misc/security_tips.html">Security Tips</a> page for more - details.</strong></p> + <p><strong>puis d'affiner la configuration pour les répertoires que vous + voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils à propos de sécurité</a> + pour plus de détails.</strong></p> - <p>The directory sections occur in the <code>httpd.conf</code> file. - <code class="directive"><Directory></code> directives - cannot nest, and cannot appear in a <code class="directive"><a href="#limit"><Limit></a></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section.</p> + <p>Les sections <code class="directive"><Directory></code> se situent + dans le fichier <code>httpd.conf</code>. Les directives <code class="directive"><Directory></code> ne peuvent pas être imbriquées + et ne sont pas autorisées dans les sections <code class="directive"><a href="#limit"><Limit></a></code> ou <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../sections.html">How <Directory>, - <Location> and <Files> sections work</a> for an - explanation of how these different sections are combined when a - request is received</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour des +explications à propos de la manière dont ces différentes sections se +combinent entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="directorymatch" id="directorymatch">Directive</a> <a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose directives that apply to -the contents of file-system directories matching a regular expression.</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent au contenu de répertoires +du système de fichiers correspondant à une expression rationnelle</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><DirectoryMatch <var>regex</var>> ... </DirectoryMatch></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><code class="directive"><DirectoryMatch></code> and - <code></DirectoryMatch></code> are used to enclose a group - of directives which will apply only to the named directory (and the files within), - the same as <code class="directive"><a href="#directory"><Directory></a></code>. - However, it takes as an argument a - <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>. For example:</p> + <p>Les balises <code class="directive"><DirectoryMatch></code> + et <code></DirectoryMatch></code> permettent de regrouper un + ensemble de directives qui ne s'appliqueront qu'au répertoire + précisé (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory"><Directory></a></code>. Cependant, le + répertoire est précisé sous la forme d'une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Par exemple :</p> <pre class="prettyprint lang-config"><DirectoryMatch "^/www/(.+/)?[0-9]{3}/"> # ... </DirectoryMatch></pre> - <p>matches directories in <code>/www/</code> (or any subdirectory thereof) - that consist of three numbers.</p> + <p>convient pour les sous-répertoires de <code>/www/</code> dont + le nom se compose de trois chiffres.</p> - <div class="note"><h3>Compatibility</h3> - Prior to 2.3.9, this directive implicitly applied to sub-directories - (like <code class="directive"><a href="#directory"><Directory></a></code>) and - could not match the end of line symbol ($). In 2.3.9 and later, - only directories that match the expression are affected by the enclosed - directives. + <div class="note"><h3>Compatibilité</h3> + Avant la version 2.3.9, cette directive s'appliquait aussi aux + sous-répertoires (comme la directive <code class="directive"><a href="#directory"><Directory></a></code>), et ne tenait pas compte du + symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les + répertoires qui correspondent à l'expression sont affectés par les + directives contenues dans la section. </div> - <div class="note"><h3>Trailing Slash</h3> - This directive applies to requests for directories that may or may - not end in a trailing slash, so expressions that are anchored to the - end of line ($) must be written with care. + <div class="note"><h3>slash de fin</h3> + Cette directive s'applique aux requêtes pour des répertoires avec + ou sans slash de fin ; les expressions contenant un symbole de fin + de ligne ($) doivent donc faire l'objet d'une attention + particulière. </div> - <p>From 2.4.8 onwards, named groups and backreferences are captured and - written to the environment with the corresponding name prefixed with - "MATCH_" and in upper case. This allows elements of paths to be referenced - from within <a href="../expr.html">expressions</a> and modules like - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered - (unnamed) backreferences are ignored. Use named groups instead.</p> - - <pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)"> + <p>A partir de la version 2.4.8, les groupes nommés et les + références arrières sont extraits et enregistrés dans + l'environnement avec leur nom en majuscules et préfixé + par "MATCH_". Ceci permet + de référencer des URLs dans des <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour + éviter toute confusion, les références arrières numérotées (non + nommées) sont ignorées. Vous devez utiliser à la place des groupes + nommés.</p> + +<pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)"> Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </DirectoryMatch></pre> - + <h3>Voir aussi</h3> <ul> -<li><code class="directive"><a href="#directory"><Directory></a></code> for -a description of how regular expressions are mixed in with normal -<code class="directive"><Directory></code>s</li> -<li><a href="../sections.html">How <Directory>, <Location> and -<Files> sections work</a> for an explanation of how these different -sections are combined when a request is received</li> +<li><code class="directive"><a href="#directory"><Directory></a></code> +pour une description de la manière dont les expressions rationnelles +sont traitées en présence d'autres sections <code class="directive"><Directory></code> sans expressions rationnelles</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication à propos de la manière dont ces différentes sections se +combinent entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="documentroot" id="documentroot">Directive</a> <a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory that forms the main document tree visible -from the web</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible +depuis Internet</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin répertoire</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DocumentRoot "/usr/local/apache/htdocs"</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive sets the directory from which <code class="program"><a href="../programs/httpd.html">httpd</a></code> - will serve files. Unless matched by a directive like <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, the server appends the - path from the requested URL to the document root to make the - path to the document. Example:</p> + <p>Cette directive permet de définir le répertoire à partir duquel + <code class="program"><a href="../programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond + pas à un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, le chemin + de l'URL sera ajouté par le serveur à la racine des documents afin + de construire le chemin du document recherché. Exemple :</p> <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre> - <p>then an access to - <code>http://my.example.com/index.html</code> refers to - <code>/usr/web/index.html</code>. If the <var>directory-path</var> is - not absolute then it is assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> + <p>un accès à <code>http://my.example.com/index.html</code> se + réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin + répertoire</var> n'est pas un chemin absolu, il est considéré comme + relatif au chemin défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> - <p>The <code class="directive">DocumentRoot</code> should be specified without - a trailing slash.</p> + <p>Le répertoire défini par la directive + <code class="directive">DocumentRoot</code> ne doit pas comporter de slash + final.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../urlmapping.html#documentroot">Mapping URLs to Filesystem -Locations</a></li> +<li><a href="../urlmapping.html#documentroot">Mise en +correspondance des URLs avec le système de fichiers</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="else" id="else">Directive</a> <a name="Else" id="Else"><Else></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if the condition of a -previous <code class="directive"><a href="#if"><If></a></code> or -<code class="directive"><a href="#elseif"><ElseIf></a></code> section is not -satisfied by a request at runtime</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la +condition correspondant à la section <code class="directive"><a href="#if"><If></a></code> ou <code class="directive"><a href="#elseif"><ElseIf></a></code> précédente n'est pas satisfaite par la +requête à l'exécution</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Else> ... </Else></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version +2.4.26 du serveur HTTP Apache</td></tr> </table> - <p>The <code class="directive"><Else></code> applies the enclosed - directives if and only if the most recent - <code class="directive"><If></code> or - <code class="directive"><ElseIf></code> section - in the same scope has not been applied. - For example: In </p> + <p>La section <code class="directive"><Else></code> applique + les directives qu'elle contient si et seulement si les conditions + correspondant à la section <code class="directive"><If></code> + ou <code class="directive"><ElseIf></code> immédiatement + supérieure et dans la même portée n'ont pas été satisfaites. Par + exemple, dans :</p> <pre class="prettyprint lang-config"><If "-z req('Host')"> # ... @@ -1151,44 +1211,43 @@ satisfied by a request at runtime</td></tr> </Else></pre> - <p> The <code class="directive"><If></code> would match HTTP/1.0 - requests without a <var>Host:</var> header and the - <code class="directive"><Else></code> would match requests - with a <var>Host:</var> header.</p> + <p>La condition de la section <code class="directive"><If></code> serait satisfaite pour les requêtes + HTTP/1.0 sans en-tête <var>Host:</var>, alors que celle de la section + <code class="directive"><Else></code> le serait pour les + requêtes comportant un en-tête <var>Host:</var>.</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#if"><If></a></code></li> <li><code class="directive"><a href="#elseif"><ElseIf></a></code></li> -<li><a href="../sections.html">How <Directory>, <Location>, - <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received. - <code class="directive"><If></code>, - <code class="directive"><ElseIf></code>, and - <code class="directive"><Else></code> are applied last.</li> +<li><a href="../sections.html">Fonctionnement des sections <Directory>, <Location>, + <Files></a> pour une explication de la manière dont ces + différentes section se combinent entre elles lorsqu'une requête est + reçue. Les directives <code class="directive"><If></code>, + <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="elseif" id="elseif">Directive</a> <a name="ElseIf" id="ElseIf"><ElseIf></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is satisfied -by a request at runtime while the condition of a previous -<code class="directive"><a href="#if"><If></a></code> or -<code class="directive"><ElseIf></code> section is not -satisfied</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la +condition correspondante est satisfaite par une requête à l'exécution, +alors que la condition correspondant à la section <code class="directive"><a href="#if"><If></a></code> ou <code class="directive"><ElseIf></code> précédente ne l'était pas.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ElseIf <var>expression</var>> ... </ElseIf></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version +2.4.26 du serveur HTTP Apache</td></tr> </table> - <p>The <code class="directive"><ElseIf></code> applies the enclosed - directives if and only if both the given condition evaluates to true and - the most recent <code class="directive"><If></code> or - <code class="directive"><ElseIf></code> section in the same scope has - not been applied. For example: In </p> + <p>La section <code class="directive"><ElseIf></code> applique + les directives qu'elle contient si et seulement si d'une part la + condition correspondante est satisfaite, et d'autre part la condition + correspondant à la section <code class="directive"><If></code> + ou <code class="directive"><ElseIf></code> de la même portée ne + l'est pas. Par exemple, dans :</p> <pre class="prettyprint lang-config"><If "-R '10.1.0.0/16'"> #... @@ -1201,29 +1260,29 @@ satisfied</td></tr> </Else></pre> - <p>The <code class="directive"><ElseIf></code> would match if - the remote address of a request belongs to the subnet 10.0.0.0/8 but - not to the subnet 10.1.0.0/16.</p> + <p>La condition correspondant à la section <code class="directive"><ElseIf></code> est satisfaite si l'adresse + distante de la requête appartient au sous-réseau 10.0.0.0/8, mais + pas si elle appartient au sous-réseau 10.1.0.0/16.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../expr.html">Expressions in Apache HTTP Server</a>, -for a complete reference and more examples.</li> +<li><a href="../expr.html">Les expressions dans le serveur HTTP +Apache</a>, pour une référence complète et d'autres exemples.</li> <li><code class="directive"><a href="#if"><If></a></code></li> <li><code class="directive"><a href="#else"><Else></a></code></li> -<li><a href="../sections.html">How <Directory>, <Location>, - <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received. - <code class="directive"><If></code>, - <code class="directive"><ElseIf></code>, and - <code class="directive"><Else></code> are applied last.</li> +<li><a href="../sections.html">Fonctionnement des sections <Directory>, <Location>, + <Files></a> pour une explication de la manière dont ces + différentes section se combinent entre elles lorsqu'une requête est + reçue. Les directives <code class="directive"><If></code>, + <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="enablemmap" id="enablemmap">Directive</a> <a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use memory-mapping to read files during delivery</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en mémoire (Memory-Mapping) pour +lire les fichiers pendant qu'ils sont servis</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableMMAP On</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -1231,34 +1290,39 @@ for a complete reference and more examples.</li> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive controls whether the <code class="program"><a href="../programs/httpd.html">httpd</a></code> may use - memory-mapping if it needs to read the contents of a file during - delivery. By default, when the handling of a request requires - access to the data within a file -- for example, when delivering a - server-parsed file using <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache httpd - memory-maps the file if the OS supports it.</p> - - <p>This memory-mapping sometimes yields a performance improvement. - But in some environments, it is better to disable the memory-mapping - to prevent operational problems:</p> + <p>Cette directive définit si <code class="program"><a href="../programs/httpd.html">httpd</a></code> peut utiliser + la projection en mémoire (Memory-Mapping) quand il doit lire le contenu + d'un fichier pendant qu'il est servi. Par défaut, lorsque le + traitement d'une requête requiert l'accès aux données contenues dans + un fichier -- par exemple, pour servir un fichier interprété par le + serveur à l'aide de <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache httpd projette + le fichier en mémoire si le système d'exploitation le permet.</p> + + <p>Cette projection en mémoire induit parfois une amélioration des + performances. Sur certains systèmes cependant, il est préférable de + désactiver la projection en mémoire afin d'éviter certains problèmes + opérationnels :</p> <ul> - <li>On some multiprocessor systems, memory-mapping can reduce the - performance of the <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li> - <li>Deleting or truncating a file while <code class="program"><a href="../programs/httpd.html">httpd</a></code> - has it memory-mapped can cause <code class="program"><a href="../programs/httpd.html">httpd</a></code> to - crash with a segmentation fault. - </li> + <li>Sur certains systèmes multi-processeurs, la projection en + mémoire peut dégrader les performances du programme + <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li> + <li>S'il fait l'objet d'une projection en mémoire par + <code class="program"><a href="../programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un + fichier peut provoquer un crash de <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec une + erreur de segmentation.</li> </ul> - <p>For server configurations that are vulnerable to these problems, - you should disable memory-mapping of delivered files by specifying:</p> - + <p>Pour les configurations de serveur sujettes à ce genre de + problème, il est préférable de désactiver la projection en mémoire + des fichiers servis en spécifiant :</p> + <pre class="prettyprint lang-config">EnableMMAP Off</pre> - <p>For NFS mounted files, this feature may be disabled explicitly for - the offending files by specifying:</p> + <p>Pour les montages NFS, cette fonctionnalité peut être + explicitement désactivée pour les fichiers concernés en spécifiant + :</p> <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> EnableMMAP Off @@ -1269,86 +1333,96 @@ for a complete reference and more examples.</li> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="enablesendfile" id="enablesendfile">Directive</a> <a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the kernel sendfile support to deliver files to the client</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les +fichiers aux clients</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableSendfile Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Default changed to Off in -version 2.3.9.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Par défaut à Off depuis la version 2.3.9.</td></tr> </table> - <p>This directive controls whether <code class="program"><a href="../programs/httpd.html">httpd</a></code> may use the - sendfile support from the kernel to transmit file contents to the client. - By default, when the handling of a request requires no access - to the data within a file -- for example, when delivering a - static file -- Apache httpd uses sendfile to deliver the file contents - without ever reading the file if the OS supports it.</p> - - <p>This sendfile mechanism avoids separate read and send operations, - and buffer allocations. But on some platforms or within some - filesystems, it is better to disable this feature to avoid - operational problems:</p> + <p>Cette directive définit si le programme <code class="program"><a href="../programs/httpd.html">httpd</a></code> + peut utiliser le support sendfile du noyau pour transmettre le + contenu des fichiers aux clients. Par défaut, lorsque le traitement + d'une requête ne requiert pas l'accès aux données contenues dans un + fichier -- par exemple, pour la transmission d'un fichier statique + -- Apache httpd utilise sendfile pour transmettre le contenu du fichier + sans même lire ce dernier, si le système d'exploitation le + permet.</p> + + <p>Ce mécanisme sendfile évite la séparation des opérations de + lecture et d'envoi, ainsi que les réservations de tampons. sur + certains systèmes cependant, ou sous certains systèmes de fichiers, + il est préférable de désactiver cette fonctionnalité afin d'éviter + certains problèmes opérationnels :</p> <ul> - <li>Some platforms may have broken sendfile support that the build - system did not detect, especially if the binaries were built on - another box and moved to such a machine with broken sendfile - support.</li> - <li>On Linux the use of sendfile triggers TCP-checksum - offloading bugs on certain networking cards when using IPv6.</li> - <li>On Linux on Itanium, <code>sendfile</code> may be unable to handle - files over 2GB in size.</li> - <li>With a network-mounted <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (e.g., NFS, SMB, CIFS, FUSE), - the kernel may be unable to serve the network file through - its own cache.</li> + <li>Certains systèmes peuvent présenter un support sendfile + défectueux que le système de compilation n'a pas détecté, en + particulier si les exécutables ont été compilés sur une autre + machine, puis copiés sur la première avec un support sendfile + défectueux.</li> + <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de + la récupération des paquets de vérification TCP (TCP-checksum) avec + certaines cartes réseau lorsqu'on utilise IPv6.</li> + <li>Sous Linux sur Itanium, <code>sendfile</code> peut s'avérer incapable de + traiter les fichiers de plus de 2 Go.</li> + <li>Avec un montage réseau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS, SMB, CIFS, + FUSE), le + noyau peut s'avérer incapable de servir un fichier de ce montage + réseau en passant par son propre cache.</li> </ul> - <p>For server configurations that are not vulnerable to these problems, - you may enable this feature by specifying:</p> + <p>Pour les configurations de serveur non sujettes à ce genre de + problème, vous pouvez activer cette fonctionnalité en + spécifiant :</p> <pre class="prettyprint lang-config">EnableSendfile On</pre> - <p>For network mounted files, this feature may be disabled explicitly - for the offending files by specifying:</p> + <p>Pour les montages réseau, cette fonctionnalité peut être + explicitement désactivée pour les fichiers concernés en spécifiant + :</p> <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> EnableSendfile Off </Directory></pre> - <p>Please note that the per-directory and .htaccess configuration - of <code class="directive">EnableSendfile</code> is not supported by - <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. - Only global definition of <code class="directive">EnableSendfile</code> - is taken into account by the module. + <p>Veuillez noter que la configuration de la directive + <code class="directive">EnableSendfile</code> dans un contexte de répertoire + ou de fichier .htaccess n'est pas supportée par + <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. Le module ne prend en compte la + définition de <code class="directive">EnableSendfile</code> que dans un + contexte global. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="error" id="error">Directive</a> <a name="Error" id="Error">Error</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Abort configuration parsing with a custom error message</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrompt la lecture de la configuration avec un message +d'erreur personnalisé</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Error <var>message</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.3.9 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>à partir de la version 2.3.9</td></tr> </table> - <p>If an error can be detected within the configuration, this - directive can be used to generate a custom error message, and halt - configuration parsing. The typical use is for reporting required - modules which are missing from the configuration.</p> + <p>Si une erreur peut être détectée dans la configuration, souvent + un module manquant, cette + directive peut être utilisée pour générer un message d'erreur + personnalisé, et interrompre la lecture de la configuration. </p> - <pre class="prettyprint lang-config"># Example -# ensure that mod_include is loaded + <pre class="prettyprint lang-config"># Exemple +# vérification du chargement de mod_include <IfModule !include_module> Error "mod_include is required by mod_foo. Load it with LoadModule." </IfModule> -# ensure that exactly one of SSL,NOSSL is defined +# vérification de la définition de SSL ou (exclusif) NOSSL <IfDefine SSL> <IfDefine NOSSL> Error "Both SSL and NOSSL are defined. Define only one of them." @@ -1366,58 +1440,63 @@ version 2.3.9.</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="errordocument" id="errordocument">Directive</a> <a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>What the server will return to the client -in case of an error</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>error-code</var> <var>document</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas +d'erreur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>In the event of a problem or error, Apache httpd can be configured - to do one of four things,</p> + <p>Apache httpd peut traiter les problèmes et les erreurs de quatre + manières,</p> <ol> - <li>output a simple hardcoded error message</li> + <li>afficher un simple message d'erreur au contenu fixe</li> - <li>output a customized message</li> + <li>afficher un message personnalisé</li> - <li>internally redirect to a local <var>URL-path</var> to handle the - problem/error</li> + <li>rediriger en interne vers un <var>chemin d'URL</var> local pour traiter + le problème ou l'erreur</li> - <li>redirect to an external <var>URL</var> to handle the - problem/error</li> + <li>rediriger vers une <var>URL</var> externe pour traiter + le problème ou l'erreur</li> </ol> - <p>The first option is the default, while options 2-4 are - configured using the <code class="directive">ErrorDocument</code> - directive, which is followed by the HTTP response code and a URL - or a message. Apache httpd will sometimes offer additional information - regarding the problem/error.</p> - - <p>From 2.4.13, <a href="../expr.html">expression syntax</a> can be - used inside the directive to produce dynamic strings and URLs.</p> - - <p>URLs can begin with a slash (/) for local web-paths (relative - to the <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), or be a - full URL which the client can resolve. Alternatively, a message - can be provided to be displayed by the browser. Note that deciding - whether the parameter is an URL, a path or a message is performed - before any expression is parsed. Examples:</p> + <p>La première option constitue le comportement par défaut; pour + choisir une des trois autres options, il faut configurer Apache à + l'aide de la directive <code class="directive">ErrorDocument</code>, suivie + du code de la réponse HTTP et d'une URL ou d'un message. Apache + httpd fournit parfois des informations supplémentaires à propos du + problème ou de l'erreur.</p> + + <p>A partir de la version 2.4.13, cette directive peut utiliser la + <a href="../expr.html">syntaxe des expressions</a> pour générer des + chaînes de caractères et des URLs dynamiques.</p> + + <p>Les URLs peuvent commencer par un slash (/) pour les chemins web + locaux (relatifs au répertoire défini par la directive <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), ou se présenter sous la + forme d'une URL complète que le client pourra résoudre. + Alternativement, un message à afficher par le navigateur pourra être + fourni. Notez que la décision à propos de la nature du paramètre, à + savoir une URL, un chemin ou un message, est prise avant + l'interprétation de toute expression. Exemples :</p> <pre class="prettyprint lang-config">ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi ErrorDocument 404 /errors/bad_urls.php ErrorDocument 401 /subscription_info.html -ErrorDocument 403 "Sorry, can't allow you access today" +ErrorDocument 403 "Désolé, nous ne pouvons pas vous accorder l'accès aujourd'hui" ErrorDocument 403 Forbidden! ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}</pre> - <p>Additionally, the special value <code>default</code> can be used - to specify Apache httpd's simple hardcoded message. While not required - under normal circumstances, <code>default</code> will restore - Apache httpd's simple hardcoded message for configurations that would - otherwise inherit an existing <code class="directive">ErrorDocument</code>.</p> + <p>De plus, on peut spécifier la valeur spéciale <code>default</code> + pour indiquer l'utilisation d'un simple message d'Apache httpd codé en + dur. Bien que non nécessaire dans des circonstances normales, la + spécification de la valeur <code>default</code> va permettre de + rétablir l'utilisation du simple message d'Apache httpd codé en dur pour + les configurations qui sans cela, hériteraient d'une directive + <code class="directive">ErrorDocument</code> existante.</p> <pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl @@ -1426,275 +1505,306 @@ ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}</pre> </Directory></pre> - <p>Note that when you specify an <code class="directive">ErrorDocument</code> - that points to a remote URL (ie. anything with a method such as - <code>http</code> in front of it), Apache HTTP Server will send a redirect to the - client to tell it where to find the document, even if the - document ends up being on the same server. This has several - implications, the most important being that the client will not - receive the original error status code, but instead will - receive a redirect status code. This in turn can confuse web - robots and other clients which try to determine if a URL is - valid using the status code. In addition, if you use a remote - URL in an <code>ErrorDocument 401</code>, the client will not - know to prompt the user for a password since it will not - receive the 401 status code. Therefore, <strong>if you use an - <code>ErrorDocument 401</code> directive, then it must refer to a local - document.</strong></p> - - <p>Microsoft Internet Explorer (MSIE) will by default ignore - server-generated error messages when they are "too small" and substitute - its own "friendly" error messages. The size threshold varies depending on - the type of error, but in general, if you make your error document - greater than 512 bytes, then MSIE will show the server-generated - error rather than masking it. More information is available in - Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p> - - <p>Although most error messages can be overridden, there are certain - circumstances where the internal messages are used regardless of the - setting of <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. In - particular, if a malformed request is detected, normal request processing - will be immediately halted and the internal error message returned. - This is necessary to guard against security problems caused by - bad requests.</p> - - <p>If you are using mod_proxy, you may wish to enable - <code class="directive"><a href="../mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> so that you can provide - custom error messages on behalf of your Origin servers. If you don't enable ProxyErrorOverride, - Apache httpd will not generate custom error documents for proxied content.</p> + <p>Notez que lorsque vous spécifiez une directive + <code class="directive">ErrorDocument</code> pointant vers une URL distante + (c'est à dire tout ce qui commence par le préfixe http), le serveur + HTTP Apache va + envoyer une redirection au client afin de lui indiquer où trouver le + document, même dans le cas où ce document se trouve sur le serveur + local. Ceci a de nombreuses conséquences dont la plus importante + réside dans le fait que le client ne recevra pas le code d'erreur + original, mais au contraire un code de statut de redirection. Ceci + peut en retour semer la confusion chez les robots web et divers + clients qui tentent de déterminer la validité d'une URL en examinant + le code de statut. De plus, si vous utilisez une URL distante avec + <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit + demander un mot de passe à l'utilisateur car il ne recevra pas le + code de statut 401. C'est pourquoi, <strong>si vous utilisez une + directive <code>ErrorDocument 401</code>, elle devra faire référence + à un document par le biais d'un chemin local.</strong></p> + + <p>Microsoft Internet Explorer (MSIE) ignore par défaut les messages + d'erreur générés par le serveur lorsqu'ils sont trop courts et + remplacent ses propres messages d'erreur "amicaux". Le seuil de + taille varie en fonction du type d'erreur, mais en général, si la + taille de votre message d'erreur est supérieure à 512 octets, il y a + peu de chances pour que MSIE l'occulte, et il sera affiché par ce + dernier. Vous trouverez d'avantage d'informations dans l'article de + la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p> + + <p>Bien que la plupart des messages d'erreur internes originaux + puissent être remplacés, ceux-ci sont cependant conservés dans + certaines circonstances sans tenir compte de la définition de la + directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En + particulier, en cas de détection d'une requête mal formée, le + processus de traitement normal des requêtes est immédiatement + interrompu, et un message d'erreur interne est renvoyé, ceci afin de + se prémunir contre les problèmes de sécurité liés aux requêtes mal + formées.</p> + + <p>Si vous utilisez mod_proxy, il est en général préférable + d'activer <code class="directive"><a href="../mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> afin d'être en + mesure de produire des messages d'erreur personnalisés pour le + compte de votre serveur d'origine. Si vous n'activez pas + ProxyErrorOverride, Apache httpd ne générera pas de messages d'erreur + personnalisés pour le contenu mandaté.</p> + <h3>Voir aussi</h3> <ul> -<li><a href="../custom-error.html">documentation of - customizable responses</a></li> +<li><a href="../custom-error.html">documentation sur la +personnalisation des réponses</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="errorlog" id="errorlog">Directive</a> <a name="ErrorLog" id="ErrorLog">ErrorLog</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location where the server will log errors</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définition du chemin du journal des erreurs</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:[<var>facility</var>][:<var>tag</var>]]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ErrorLog</code> directive sets the name of - the file to which the server will log any errors it encounters. If - the <var>file-path</var> is not absolute then it is assumed to be - relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> + <p>La directive <code class="directive">ErrorLog</code> permet de définir le + nom du fichier dans lequel le serveur va journaliser toutes les + erreurs qu'il rencontre. Si le <var>file-path</var> n'est pas + absolu, il est considéré comme relatif au chemin défini par la + directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> <pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre> - <p>If the <var>file-path</var> - begins with a pipe character "<code>|</code>" then it is assumed to be a - command to spawn to handle the error log.</p> + <p>Si le <var>file-path</var> commence par une barre verticale + "<code>(|)</code>", il est considéré comme une commande à lancer pour traiter la + journalisation de l'erreur.</p> <pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre> - <p>See the notes on <a href="../logs.html#piped">piped logs</a> for - more information.</p> - - <p>Using <code>syslog</code> instead of a filename enables logging - via syslogd(8) if the system supports it and if <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code> - is loaded. The default is to use syslog facility <code>local7</code>, - but you can override this by using the <code>syslog:<var>facility</var></code> - syntax where <var>facility</var> can be one of the names usually documented in - syslog(1). The facility is effectively global, and if it is changed - in individual virtual hosts, the final facility specified affects the - entire server. Same rules apply for the syslog tag, which by default - uses the Apache binary name, <code>httpd</code> in most cases. You can - also override this by using the <code>syslog::<var>tag</var></code> - syntax.</p> - - <pre class="prettyprint lang-config">ErrorLog syslog:user -ErrorLog syslog:user:httpd.srv1 + <p>Voir les notes à propos des <a href="../logs.html#piped">journaux + redirigés</a> pour plus d'informations.</p> + + <p>L'utilisation de <code>syslog</code> à la place d'un nom de + fichier active la journalisation via syslogd(8) si le système le + supporte et si <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code> a été chargé. Le + dispositif syslog par défaut est <code>local7</code>, + mais vous pouvez le modifier à l'aide de la syntaxe + <code>syslog:<var>facility</var></code>, où <var>facility</var> peut + être remplacé par un des noms habituellement documentés dans la page + de man syslog(1). Le dispositif syslog <code>local7</code> est + global, et si il est modifié dans un serveur virtuel, le dispositif + final spécifié affecte l'ensemble du serveur. La même règle s'applique au + tag syslog qui utilise par défaut le nom du binaire du serveur HTTP Apache + <code>httpd</code> dans la plupart des cas. Vous pouvez aussi modifier cette + valeur en utilisant la syntaxe <code>syslog::<var>tag</var></code>.</p> + + <pre class="prettyprint lang-config"> ErrorLog syslog:user + ErrorLog syslog:user:httpd.srv1 ErrorLog syslog::httpd.srv2</pre> - <p>Additional modules can provide their own ErrorLog providers. The syntax - is similar to the <code>syslog</code> example above.</p> + <p>Des modules additionnels peuvent implémenter leur propre + fournisseur ErrorLog. La syntaxe est similaire à l'exemple + <code>syslog</code> ci-dessus.</p> - <p>SECURITY: See the <a href="../misc/security_tips.html#serverroot">security tips</a> - document for details on why your security could be compromised - if the directory where log files are stored is writable by - anyone other than the user that starts the server.</p> + <p>SECURITE : Voir le document <a href="../misc/security_tips.html#serverroot">conseils à propos de + sécurité</a> pour des détails sur les raisons pour lesquelles votre + sécurité peut être compromise si le répertoire contenant les + fichiers journaux présente des droits en écriture pour tout autre + utilisateur que celui sous lequel le serveur est démarré.</p> <div class="warning"><h3>Note</h3> - <p>When entering a file path on non-Unix platforms, care should be taken - to make sure that only forward slashes are used even though the platform - may allow the use of back slashes. In general it is a good idea to always - use forward slashes throughout the configuration files.</p> + <p>Lors de la spécification d'un chemin de fichier sur les + plates-formes non-Unix, on doit veiller à n'utiliser que des + slashes (/), même si la plate-forme autorise l'utilisation des + anti-slashes (\). Et d'une manière générale, il est recommandé de + n'utiliser que des slashes (/) dans les fichiers de + configuration.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li> -<li><a href="../logs.html">Apache HTTP Server Log Files</a></li> +<li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="errorlogformat" id="errorlogformat">Directive</a> <a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format specification for error log entries</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécification du format des entrées du journal des erreurs</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><code class="directive">ErrorLogFormat</code> allows to specify what - supplementary information is logged in the error log in addition to the - actual log message.</p> + <p>La directive <code class="directive">ErrorLogFormat</code> permet de + spécifier quelles informations supplémentaires vont être enregistrées + dans le journal des erreurs en plus du message habituel.</p> - <pre class="prettyprint lang-config">#Simple example + <pre class="prettyprint lang-config"># Exemple simple ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> - <p>Specifying <code>connection</code> or <code>request</code> as first - parameter allows to specify additional formats, causing additional - information to be logged when the first message is logged for a specific - connection or request, respectively. This additional information is only - logged once per connection/request. If a connection or request is processed - without causing any log message, the additional information is not logged - either.</p> - - <p>It can happen that some format string items do not produce output. For - example, the Referer header is only present if the log message is - associated to a request and the log message happens at a time when the - Referer header has already been read from the client. If no output is - produced, the default behavior is to delete everything from the preceding - space character to the next space character. This means the log line is - implicitly divided into fields on non-whitespace to whitespace transitions. - If a format string item does not produce output, the whole field is - omitted. For example, if the remote address <code>%a</code> in the log - format <code>[%t] [%l] [%a] %M </code> is not available, the surrounding - brackets are not logged either. Space characters can be escaped with a - backslash to prevent them from delimiting a field. The combination '% ' - (percent space) is a zero-width field delimiter that does not produce any - output.</p> - - <p>The above behavior can be changed by adding modifiers to the format - string item. A <code>-</code> (minus) modifier causes a minus to be logged if the - respective item does not produce any output. In once-per-connection/request - formats, it is also possible to use the <code>+</code> (plus) modifier. If an - item with the plus modifier does not produce any output, the whole line is - omitted.</p> - - <p>A number as modifier can be used to assign a log severity level to a - format item. The item will only be logged if the severity of the log - message is not higher than the specified log severity level. The number can - range from 1 (alert) over 4 (warn) and 7 (debug) to 15 (trace8).</p> - - <p>For example, here's what would happen if you added modifiers to - the <code>%{Referer}i</code> token, which logs the - <code>Referer</code> request header.</p> - - <table class="bordered"><tr class="header"><th>Modified Token</th><th>Meaning</th></tr> + <p>La spécification de <code>connection</code> ou + <code>request</code> comme premier paramètre permet de définir des + formats supplémentaires, ce qui a pour effet de journaliser des + informations additionnelles lorsque le premier message est + enregistré respectivement pour une connexion ou une requête + spécifique. Ces informations additionnelles ne sont enregistrées + qu'une seule fois par connexion/requête. Si le traitement d'une + connexion ou d'une requête ne génère aucun message dans le journal, + alors aucune information additionnelle n'est enregistrée.</p> + + <p>Il peut arriver que certains items de la chaîne de format ne + produisent aucune sortie. Par exemple, l'en-tête Referer n'est + présent que si le message du journal est associé à une requête et s'il + est généré à un moment où l'en-tête Referer a déjà été lu par le + client. Si aucune sortie n'est générée, le comportement par défaut + consiste à supprimer tout ce qui se trouve entre l'espace précédent + et le suivant. Ceci implique que la ligne de journalisation est + divisée en champs ne contenant pas d'espace séparés par des espaces. + Si un item de la chaîne de format ne génère aucune sortie, + l'ensemble du champ est omis. Par exemple, si l'adresse distante + <code>%a</code> du format <code>[%t] [%l] [%a] %M </code> n'est + pas disponible, les crochets qui l'entourent ne seront eux-mêmes pas + enregistrés. Il est possible d'échapper les espaces par un anti-slash + afin qu'ils ne soient pas considérés comme séparateurs de champs. + La combinaison '% ' (pourcentage espace) est un délimiteur de + champ de taille nulle qui ne génère aucune sortie.</p> + + <p>Ce comportement peut être changé en ajoutant des modificateurs à + l'item de la chaîne de format. Le modificateur <code>-</code> + (moins) provoque l'enregistrement d'un signe moins si l'item + considéré ne génère aucune sortie. Pour les formats à enregistrement + unique par connexion/requête, il est aussi possible d'utiliser le + modificateur <code>+</code> (plus). Si un item ne générant aucune + sortie possède le modificateur plus, la ligne dans son ensemble est + omise.</p> + + <p>Un modificateur de type entier permet d'assigner un niveau de + sévérité à un item de format. L'item considéré ne + sera journalisé que si la sévérité du message n'est pas + plus haute que le niveau de sévérité spécifié. Les + valeurs possibles vont de 1 (alert) à 15 (trace8), en passant par 4 + (warn) ou 7 (debug).</p> + + <p>Par exemple, voici ce qui arriverait si vous ajoutiez des + modificateurs à l'item <code>%{Referer}i</code> qui enregistre le + contenu de l'en-tête <code>Referer</code>.</p> + + <table class="bordered"><tr class="header"><th>Item modifié</th><th>Signification</th></tr> <tr> <td><code>%-{Referer}i</code></td> - <td>Logs a <code>-</code> if <code>Referer</code> is not set.</td> + <td>Enregistre le caractère <code>-</code> si l'en-tête + <code>Referer</code> n'est pas défini.</td> </tr> <tr class="odd"> <td><code>%+{Referer}i</code></td> - <td>Omits the entire line if <code>Referer</code> is not set.</td> + <td>N'enregistre rien si l'en-tête + <code>Referer</code> n'est pas défini.</td> </tr> <tr> <td><code>%4{Referer}i</code></td> - <td>Logs the <code>Referer</code> only if the log message severity - is higher than 4.</td> + <td>N'enregistre le contenu de l'en-tête <code>Referer</code> que si + la sévérité du message de journalisation est supérieure à 4.</td> </tr> </table> - <p>Some format string items accept additional parameters in braces.</p> + <p>Certains items de format acceptent des paramètres supplémentaires + entre accolades.</p> - <table class="bordered"><tr class="header"><th>Format String</th> <th>Description</th></tr> + <table class="bordered"><tr class="header"><th>Chaîne de format</th> <th>Description</th></tr> <tr><td><code>%%</code></td> - <td>The percent sign</td></tr> + <td>Le signe pourcentage</td></tr> <tr class="odd"><td><code>%a</code></td> - <td>Client IP address and port of the request</td></tr> + <td>Adresse IP et port clients</td></tr> <tr><td><code>%{c}a</code></td> - <td>Underlying peer IP address and port of the connection (see the - <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module)</td></tr> + <td>Port et adresse IP sous-jacents du correspondant pour la + connexion (voir le module + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr> <tr class="odd"><td><code>%A</code></td> - <td>Local IP-address and port</td></tr> + <td>Adresse IP et port locaux</td></tr> <tr><td><code>%{<em>name</em>}e</code></td> - <td>Request environment variable <em>name</em></td></tr> + <td>Variable d'environnement de requête <em>name</em></td></tr> <tr class="odd"><td><code>%E</code></td> - <td>APR/OS error status code and string</td></tr> + <td>Etat d'erreur APR/OS et chaîne</td></tr> <tr><td><code>%F</code></td> - <td>Source file name and line number of the log call</td></tr> + <td>Nom du fichier source et numéro de ligne de l'appel du + journal</td></tr> <tr class="odd"><td><code>%{<em>name</em>}i</code></td> - <td>Request header <em>name</em></td></tr> + <td>En-tête de requête <em>name</em></td></tr> <tr><td><code>%k</code></td> - <td>Number of keep-alive requests on this connection</td></tr> + <td>Nombre de requêtes persistantes pour cette connexion</td></tr> <tr class="odd"><td><code>%l</code></td> - <td>Loglevel of the message</td></tr> + <td>Sévérité du message</td></tr> <tr><td><code>%L</code></td> - <td>Log ID of the request</td></tr> + <td>Identifiant journal de la requête</td></tr> <tr class="odd"><td><code>%{c}L</code></td> - <td>Log ID of the connection</td></tr> + <td>Identifiant journal de la connexion</td></tr> <tr><td><code>%{C}L</code></td> - <td>Log ID of the connection if used in connection scope, empty otherwise</td></tr> + <td>Identifiant journal de la connexion si utilisé dans la + portée de la connexion, vide sinon</td></tr> <tr class="odd"><td><code>%m</code></td> - <td>Name of the module logging the message</td></tr> + <td>Nom du module qui effectue la journalisation du message</td></tr> <tr><td><code>%M</code></td> - <td>The actual log message</td></tr> + <td>Le message effectif</td></tr> <tr class="odd"><td><code>%{<em>name</em>}n</code></td> - <td>Request note <em>name</em></td></tr> + <td>Note de requête <em>name</em></td></tr> <tr><td><code>%P</code></td> - <td>Process ID of current process</td></tr> + <td>Identifiant du processus courant</td></tr> <tr class="odd"><td><code>%T</code></td> - <td>Thread ID of current thread</td></tr> + <td>Identifiant du thread courant</td></tr> <tr><td><code>%{g}T</code></td> - <td>System unique thread ID of current thread (the same ID as - displayed by e.g. <code>top</code>; currently Linux only)</td></tr> + <td>Identifiant unique de thread système du thread courant + (l'identifiant affiché par la commande <code>top</code> par + exemple ; seulement sous Linux pour l'instant)</td></tr> <tr class="odd"><td><code>%t</code></td> - <td>The current time</td></tr> + <td>L'heure courante</td></tr> <tr><td><code>%{u}t</code></td> - <td>The current time including micro-seconds</td></tr> + <td>L'heure courante avec les microsecondes</td></tr> <tr class="odd"><td><code>%{cu}t</code></td> - <td>The current time in compact ISO 8601 format, including - micro-seconds</td></tr> + <td>L'heure courante au format compact ISO 8601, avec les + microsecondes</td></tr> <tr><td><code>%v</code></td> - <td>The canonical <code class="directive"><a href="#servername">ServerName</a></code> - of the current server.</td></tr> + <td>Le nom de serveur canonique <code class="directive"><a href="#servername">ServerName</a></code> du serveur courant.</td></tr> <tr class="odd"><td><code>%V</code></td> - <td>The server name of the server serving the request according to the - <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> - setting.</td></tr> -<tr><td><code>\ </code> (backslash space)</td> - <td>Non-field delimiting space</td></tr> -<tr class="odd"><td><code>% </code> (percent space)</td> - <td>Field delimiter (no output)</td></tr> + <td>Le nom de serveur du serveur qui sert la requête en accord + avec la définition de la directive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>.</td></tr> +<tr><td><code>\ </code> (anti-slash espace)</td> + <td>Espace non délimiteur</td></tr> +<tr class="odd"><td><code>% </code> (pourcentage espace)</td> + <td>Délimiteur de champ (aucune sortie)</td></tr> </table> - <p>The log ID format <code>%L</code> produces a unique id for a connection - or request. This can be used to correlate which log lines belong to the - same connection or request, which request happens on which connection. - A <code>%L</code> format string is also available in - <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> to allow to correlate access log entries - with error log lines. If <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, its - unique id will be used as log ID for requests.</p> - - <pre class="prettyprint lang-config">#Example (default format for threaded MPMs) + <p>L'item de format identifiant journal <code>%L</code> génère un + identifiant unique pour une connexion ou une requête. Il peut servir + à déterminer quelles lignes correspondent à la même connexion ou + requête ou quelle requête est associée à tel connexion. Un item de + format <code>%L</code> est aussi disponible dans le module + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>, mais il permet dans ce contexte de + corréler les entrées du journal des accès avec celles du journal des + erreurs. Si le module <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> est chargé, + c'est son identifiant unique qui sera utilisé comme identifiant de + journal pour les requêtes.</p> + + <pre class="prettyprint lang-config"># Exemple (format par défaut pour les MPMs threadés) ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> - <p>This would result in error messages such as:</p> + <p>Cet exemple renverrait un message d'erreur du style :</p> <div class="example"><p><code> [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 </code></p></div> - <p>Notice that, as discussed above, some fields are omitted - entirely because they are not defined.</p> + <p>Notez que, comme indiqué plus haut, certains champs sont + totalement supprimés s'ils n'ont pas été définis.</p> - <pre class="prettyprint lang-config">#Example (similar to the 2.2.x format) + <pre class="prettyprint lang-config"># Exemple (similaire au format 2.2.x) ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> - <pre class="prettyprint lang-config">#Advanced example with request/connection log IDs + <pre class="prettyprint lang-config"># Exemple avancé avec identifiants journal de requête/connexion ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M" ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T" ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" @@ -1707,39 +1817,42 @@ ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre> <ul> <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li> <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li> -<li><a href="../logs.html">Apache HTTP Server Log Files</a></li> +<li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="extendedstatus" id="extendedstatus">Directive</a> <a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep track of extended status information for each -request</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'état étendues pour chaque +requête</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtendedStatus Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This option tracks additional data per worker about the - currently executing request and creates a utilization summary. - You can see these variables during runtime by configuring - <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Note that other modules may - rely on this scoreboard.</p> - - <p>This setting applies to the entire server and cannot be - enabled or disabled on a virtualhost-by-virtualhost basis. - The collection of extended status information can slow down - the server. Also note that this setting cannot be changed - during a graceful restart.</p> + + <p>Cette option permet d'extraire des données supplémentaires + concernant la requête en cours de traitement pour un processus + donné, ainsi qu'un résumé d'utilisation ; vous pouvez accéder à + ces variables pendant l'exécution en configurant + <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Notez que d'autres modules sont + susceptibles de s'appuyer sur ce tableau de bord.</p> + + <p>Cette directive s'applique au serveur dans son ensemble, et ne + peut pas être activée/désactivée pour un serveur virtuel + particulier. Notez que l'extraction des informations d'état étendues + peut ralentir le serveur. Notez aussi que cette définition ne peut + pas être modifiée au cours d'un redémarrage graceful.</p> <div class="note"> - <p>Note that loading <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> will change - the default behavior to ExtendedStatus On, while other - third party modules may do the same. Such modules rely on - collecting detailed information about the state of all workers. - The default is changed by <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> beginning - with version 2.3.6. The previous default was always Off.</p> + <p>Notez que le chargement de <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> définit + automatiquement ExtendedStatus à On, et que d'autres modules tiers + sont susceptibles d'en faire de même. De tels modules ont besoin + d'informations détaillées à propos de l'état de tous les processus. + Depuis la version 2.3.6, <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a définit la + valeur par défaut à On, alors qu'elle était à Off dans les versions + antérieures.</p> </div> @@ -1747,249 +1860,272 @@ request</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="fileetag" id="fileetag">Directive</a> <a name="FileETag" id="FileETag">FileETag</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File attributes used to create the ETag -HTTP response header for static files</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caractéristiques de fichier utilisées lors de la génération +de l'en-tête de réponse HTTP ETag pour les fichiers statiques</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>FileETag MTime Size</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The default used to be "INode MTime Size" in 2.3.14 and -earlier.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La valeur par défaut était "INode MTime Size" +dans les versions 2.3.14 et antérieures.</td></tr> </table> <p> - The <code class="directive">FileETag</code> directive configures the file - attributes that are used to create the <code>ETag</code> (entity - tag) response header field when the document is based on a static file. - (The <code>ETag</code> value is used in cache management to save - network bandwidth.) The - <code class="directive">FileETag</code> directive allows you to choose - which of these -- if any -- should be used. The recognized keywords are: + La directive <code class="directive">FileETag</code> définit les + caractéristiques de fichier utilisées lors de la génération de + l'en-tête de réponse HTTP <code>ETag</code> (entity tag) quand le + document est contenu dans un fichier statique(la valeur de + <code>ETag</code> + est utilisée dans le cadre de la gestion du cache pour préserver la + bande passante réseau). La directive + <code class="directive">FileETag</code> vous permet maintenant de choisir + quelles caractéristiques du fichier vont être utilisées, le cas + échéant. Les mots-clés reconnus sont : </p> <dl> <dt><strong>INode</strong></dt> - <dd>The file's i-node number will be included in the calculation</dd> + <dd>Le numéro d'i-node du fichier sera inclus dans le processus de + génération</dd> <dt><strong>MTime</strong></dt> - <dd>The date and time the file was last modified will be included</dd> + <dd>La date et l'heure auxquelles le fichier a été modifié la + dernière fois seront incluses</dd> <dt><strong>Size</strong></dt> - <dd>The number of bytes in the file will be included</dd> + <dd>La taille du fichier en octets sera incluse</dd> <dt><strong>All</strong></dt> - <dd>All available fields will be used. This is equivalent to: - <pre class="prettyprint lang-config">FileETag INode MTime Size</pre> + <dd>Tous les champs disponibles seront utilisés. Cette définition + est équivalente à : + <pre class="prettyprint lang-config">FileETag INode MTime Size</pre> </dd> <dt><strong>None</strong></dt> - <dd>If a document is file-based, no <code>ETag</code> field will be - included in the response</dd> + <dd>Si le document se compose d'un fichier, aucun champ + <code>ETag</code> ne sera inclus dans la réponse</dd> </dl> - <p>The <code>INode</code>, <code>MTime</code>, and <code>Size</code> - keywords may be prefixed with either <code>+</code> or <code>-</code>, - which allow changes to be made to the default setting inherited - from a broader scope. Any keyword appearing without such a prefix - immediately and completely cancels the inherited setting.</p> - - <p>If a directory's configuration includes - <code>FileETag INode MTime Size</code>, and a - subdirectory's includes <code>FileETag -INode</code>, - the setting for that subdirectory (which will be inherited by - any sub-subdirectories that don't override it) will be equivalent to + <p>Les mots-clés <code>INode</code>, <code>MTime</code>, et + <code>Size</code> peuvent être préfixés par <code>+</code> ou + <code>-</code>, ce qui permet de modifier les valeurs par défaut + héritées d'un niveau de configuration plus général. Tout mot-clé + apparaissant sans aucun préfixe annule entièrement et immédiatement + les configurations héritées.</p> + + <p>Si la configuration d'un répertoire contient + <code>FileETag INode MTime Size</code>, et si un de + ses sous-répertoires contient <code>FileETag -INode</code>, la + configuration de ce sous-répertoire (qui sera propagée vers tout + sous-répertoire qui ne la supplante pas), sera équivalente à <code>FileETag MTime Size</code>.</p> - <div class="warning"><h3>Warning</h3> - Do not change the default for directories or locations that have WebDAV - enabled and use <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> as a storage provider. - <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> uses <code>MTime Size</code> - as a fixed format for <code>ETag</code> comparisons on conditional requests. - These conditional requests will break if the <code>ETag</code> format is - changed via <code class="directive">FileETag</code>. + <div class="warning"><h3>Avertissement</h3> + Ne modifiez pas les valeurs par défaut pour les répertoires ou + localisations où WebDAV est activé et qui utilisent + <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage. + <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise + <code>MTime Size</code> comme format fixe pour les + comparaisons de champs <code>ETag</code> dans les requêtes + conditionnelles. Ces requêtes conditionnelles échoueront si le + format <code>ETag</code> est modifié via la directive + <code class="directive">FileETag</code>. </div> - <div class="note"><h3>Server Side Includes</h3> - An ETag is not generated for responses parsed by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> - since the response entity can change without a change of the INode, MTime, or Size - of the static file with embedded SSI directives. + <div class="note"><h3>Inclusions côté serveur</h3> + Aucun champ ETag n'est généré pour les réponses interprétées par + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, car l'entité de la réponse peut + changer sans modification de l'INode, du MTime, ou de la taille du + fichier statique contenant les directives SSI. </div> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="files" id="files">Directive</a> <a name="Files" id="Files"><Files></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to matched -filenames</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers +précisés</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Files <var>nom fichier</var>> ... </Files></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive"><Files></code> directive - limits the scope of the enclosed directives by filename. It is comparable - to the <code class="directive"><a href="#directory"><Directory></a></code> - and <code class="directive"><a href="#location"><Location></a></code> - directives. It should be matched with a <code></Files></code> - directive. The directives given within this section will be applied to - any object with a basename (last component of filename) matching the - specified filename. <code class="directive"><Files></code> - sections are processed in the order they appear in the - configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and - <code>.htaccess</code> files are read, but before <code class="directive"><a href="#location"><Location></a></code> sections. Note - that <code class="directive"><Files></code> can be nested - inside <code class="directive"><a href="#directory"><Directory></a></code> sections to restrict the - portion of the filesystem they apply to.</p> - - <p>The <var>filename</var> argument should include a filename, or - a wild-card string, where <code>?</code> matches any single character, - and <code>*</code> matches any sequences of characters.</p> + <p>La directive <code class="directive"><Files></code> limite + la portée des directives qu'elle contient aux fichiers précisés. + Elle est comparable aux directives <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#location"><Location></a></code>. Elle doit se terminer par une + balise <code></Files></code>. Les directives contenues dans + cette section s'appliqueront à tout objet dont le nom de base (la + dernière partie du nom de fichier) correspond au fichier spécifié. + Les sections <code class="directive"><Files></code> sont + traitées selon l'ordre dans lequel elles apparaissent dans le + fichier de configuration, après les sections <code class="directive"><a href="#directory"><Directory></a></code> et la lecture des fichiers + <code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location"><Location></a></code>. Notez que les + sections <code class="directive"><Files></code> peuvent être + imbriquées dans les sections <code class="directive"><a href="#directory"><Directory></a></code> afin de restreindre la portion + du système de fichiers à laquelle ces dernières vont + s'appliquer.</p> + + <p>L'argument <var>filename</var> peut contenir un nom de fichier + ou une chaîne de caractères avec caractères génériques, où + <code>?</code> remplace un caractère, et <code>*</code> toute chaîne + de caractères.</p> <pre class="prettyprint lang-config"><Files "cat.html"> - # Insert stuff that applies to cat.html here + # Insérer ici des directives qui s'appliquent au fichier cat.html </Files> <Files "?at.*"> - # This would apply to cat.html, bat.html, hat.php and so on. + # Les directives insérées ici s'appliqueront aux fichiers + # cat.html, bat.html, hat.php, et ainsi de suite. </Files></pre> - <p><a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Regular expressions</a> - can also be used, with the addition of the - <code>~</code> character. For example:</p> + + <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la + caractère <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Files ~ "\.(gif|jpe?g|png)$"> #... </Files></pre> - <p>would match most common Internet graphics formats. <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> is preferred, - however.</p> + <p>correspondrait à la plupart des formats graphiques de l'Internet. + Il est cependant préférable d'utiliser la directive <code class="directive"><a href="#filesmatch"><FilesMatch></a></code>.</p> - <p>Note that unlike <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#location"><Location></a></code> sections, <code class="directive"><Files></code> sections can be used inside - <code>.htaccess</code> files. This allows users to control access to - their own files, at a file-by-file level.</p> + <p>Notez qu'à la différence des sections <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#location"><Location></a></code>, les sections <code class="directive"><Files></code> peuvent être utilisées dans les + fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de + contrôler l'accès à leurs propres ressources, fichier par + fichier.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../sections.html">How <Directory>, <Location> - and <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="filesmatch" id="filesmatch">Directive</a> <a name="FilesMatch" id="FilesMatch"><FilesMatch></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply to regular-expression matched -filenames</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent à des fichiers +spécifiés sous la forme d'expressions rationnelles</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><FilesMatch <var>expression rationnelle</var>> ... +</FilesMatch></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive"><FilesMatch></code> directive - limits the scope of the enclosed directives by filename, just as the - <code class="directive"><a href="#files"><Files></a></code> directive - does. However, it accepts a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular - expression</a>. For example:</p> + <p>La section <code class="directive"><FilesMatch></code> + limite la portée des directives qu'elle contient aux fichiers + spécifiés, tout comme le ferait une section <code class="directive"><a href="#files"><Files></a></code>. Mais elle accepte aussi les + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par + exemple :</p> <pre class="prettyprint lang-config"><FilesMatch ".+\.(gif|jpe?g|png)$"> # ... </FilesMatch></pre> - <p>would match most common Internet graphics formats.</p> + <p>correspondrait à la plupart des formats graphiques de + l'Internet.</p> - <div class="note">The <code>.+</code> at the start of the regex ensures that - files named <code>.png</code>, or <code>.gif</code>, for example, - are not matched.</div> + <div class="note">Les caractères <code>.+</code> au début de l'expression + rationnelle permettent de s'assurer que les fichiers de nom + <code>.png</code>, ou <code>.gif</code>, par exemple, ne seront pas + pris en compte.</div> - <p>From 2.4.8 onwards, named groups and backreferences are captured and - written to the environment with the corresponding name prefixed with - "MATCH_" and in upper case. This allows elements of files to be referenced - from within <a href="../expr.html">expressions</a> and modules like - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered - (unnamed) backreferences are ignored. Use named groups instead.</p> + <p>A partir de la version 2.4.8, les groupes nommés et les + références arrières sont extraits et enregistrés dans + l'environnement avec leur nom en majuscules et préfixé + par "MATCH_". Ceci permet + de référencer des URLs dans des <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour + éviter toute confusion, les références arrières numérotées (non + nommées) sont ignorées. Vous devez utiliser à la place des groupes + nommés.</p> - <pre class="prettyprint lang-config"><FilesMatch "^(?<sitename>[^/]+)"> +<pre class="prettyprint lang-config"><FilesMatch "^(?<sitename>[^/]+)"> require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </FilesMatch></pre> - + <h3>Voir aussi</h3> <ul> -<li><a href="../sections.html">How <Directory>, <Location> - and <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="forcetype" id="forcetype">Directive</a> <a name="ForceType" id="ForceType">ForceType</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be served with the specified -media type in the HTTP Content-Type header field</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>media-type</var>|None</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le type de médium spécifié dans le champ d'en-tête +HTTP Content-Type pour les fichiers correspondants</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>type médium</var>|None</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>When placed into an <code>.htaccess</code> file or a - <code class="directive"><a href="#directory"><Directory></a></code>, or - <code class="directive"><a href="#location"><Location></a></code> or - <code class="directive"><a href="#files"><Files></a></code> - section, this directive forces all matching files to be served - with the content type identification given by - <var>media-type</var>. For example, if you had a directory full of - GIF files, but did not want to label them all with <code>.gif</code>, - you might want to use:</p> + <p>Lorsqu'elle est placée dans un fichier <code>.htaccess</code> ou + une section <code class="directive"><a href="#directory"><Directory></a></code>, <code class="directive"><a href="#location"><Location></a></code>, ou <code class="directive"><a href="#files"><Files></a></code>, cette directive force + l'identification du type MIME des fichiers spécifiés à la valeur de + l'argument <var>type médium</var>. Par exemple, si vous possédez un + répertoire ne contenant que des fichiers GIF, et si vous ne voulez + pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser + :</p> <pre class="prettyprint lang-config">ForceType image/gif</pre> - <p>Note that this directive overrides other indirect media type - associations defined in mime.types or via the - <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p> + <p>Notez que cette directive l'emporte sur d'autres associations de + type de médium indirectes définies dans mime.types ou via la + directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p> - <p>You can also override more general - <code class="directive">ForceType</code> settings - by using the value of <code>None</code>:</p> + <p>Vous pouvez aussi annuler toute définition plus générale de + <code class="directive">ForceType</code> en affectant la valeur + <code>None</code> à l'argument <var>type médium</var> :</p> - <pre class="prettyprint lang-config"># force all files to be image/gif: + <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers à image/gif: <Location "/images"> ForceType image/gif </Location> -# but normal mime-type associations here: +# mais utilise les méthodes classiques d'attribution du type MIME +# dans le sous-répertoire suivant : <Location "/images/mixed"> ForceType None </Location></pre> - - <p>This directive primarily overrides the content types generated for - static files served out of the filesystem. For resources other than - static files, where the generator of the response typically specifies - a Content-Type, this directive has no effect.</p> - + + <p>A la base, cette directive écrase le type de contenu généré pour + les fichiers statiques servis à partir du sytème de fichiers. Pour + les ressources autres que les fichiers statiques pour lesquels le + générateur de réponse spécifie en général un type de contenu, cette + directive est ignorée.</p> <div class="note"><h3>Note</h3> - <p>If no handler is explicitly set for a request, the specified content - type will also be used as the handler name. </p> + <p>Si aucun gestionnaire n'est explicitement défini pour une + requête, le type de contenu spécifié sera aussi utilisé comme nom de + gestionnaire.</p> - <p>When explicit directives such as - <code class="directive"><a href="#sethandler">SetHandler</a></code> or - <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> do not apply - to the current request, the internal handler name normally set by those - directives is instead set to the content type specified by this directive. + <p>Lorsque des directives explicites comme <code class="directive"><a href="#sethandler">SetHandler</a></code> ou + <code class="directive">module="mod_mime">AddHandler</code> ne s'appliquent + pas à la requête courante, le nom du gestionnaire interne + normalement défini par ces directives correspondra alors au type de + contenu spécifié par cette directive. </p> - <p> - This is a historical behavior that some third-party modules - (such as mod_php) may look for a "synthetic" content type used only to - signal the module to take responsibility for the matching request. + <p>Il s'agit d'un comportement historique que certains modules + tiers, comme mod_php, peuvent interpréter comme un type de contenu + artificiel ne servant qu'à indiquer le module qui doit prendre en + compte la requête considérée. </p> - <p>Configurations that rely on such "synthetic" types should be avoided. - Additionally, configurations that restrict access to - <code class="directive"><a href="#sethandler">SetHandler</a></code> or - <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> should - restrict access to this directive as well.</p> + <p>Dans la mesure du possible, il est conseillé d'éviter les + configurations qui comportent de tels types artificiels. En outre, + les configurations qui restreignent l'accès aux directives + <code class="directive"><a href="#sethandler">SetHandler</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> doivent aussi restreindre + l'accès à cette directive.</p> </div> @@ -1997,285 +2133,310 @@ media type in the HTTP Content-Type header field</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="gprofdir" id="gprofdir">Directive</a> <a name="GprofDir" id="GprofDir">GprofDir</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory to write gmon.out profiling data to. </td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire dans lequel écrire les données de profiling +gmon.out.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>When the server has been compiled with gprof profiling support, - <code class="directive">GprofDir</code> causes <code>gmon.out</code> files to - be written to the specified directory when the process exits. If the - argument ends with a percent symbol ('%'), subdirectories are created - for each process id.</p> + <p>Lorsque le serveur a été compilé avec le support du profiling + gprof, la directive <code class="directive">GprofDir</code> permet de + spécifier dans quel répertoire les fichiers <code>gmon.out</code> + doivent être écrits lorsque le processus s'arrête. Si l'argument se + termine par un caractère pourcentage ('%'), des sous-répertoires + sont créés pour chaque identifiant de processus.</p> - <p>This directive currently only works with the <code class="module"><a href="../mod/prefork.html">prefork</a></code> - MPM.</p> + <p>Cette directive ne fonctionne actuellement qu'avec le MPM + <code class="module"><a href="../mod/prefork.html">prefork</a></code>.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="hostnamelookups" id="hostnamelookups">Directive</a> <a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables DNS lookups on client IP addresses</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la recherche DNS sur les adresses IP des +clients</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HostnameLookups Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive enables DNS lookups so that host names can be - logged (and passed to CGIs/SSIs in <code>REMOTE_HOST</code>). - The value <code>Double</code> refers to doing double-reverse - DNS lookup. That is, after a reverse lookup is performed, a forward - lookup is then performed on that result. At least one of the IP - addresses in the forward lookup must match the original - address. (In "tcpwrappers" terminology this is called - <code>PARANOID</code>.)</p> - - <p>Regardless of the setting, when <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> is - used for controlling access by hostname, a double reverse lookup - will be performed. This is necessary for security. Note that the - result of this double-reverse isn't generally available unless you - set <code>HostnameLookups Double</code>. For example, if only - <code>HostnameLookups On</code> and a request is made to an object - that is protected by hostname restrictions, regardless of whether - the double-reverse fails or not, CGIs will still be passed the - single-reverse result in <code>REMOTE_HOST</code>.</p> - - <p>The default is <code>Off</code> in order to save the network - traffic for those sites that don't truly need the reverse - lookups done. It is also better for the end users because they - don't have to suffer the extra latency that a lookup entails. - Heavily loaded sites should leave this directive - <code>Off</code>, since DNS lookups can take considerable - amounts of time. The utility <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compiled by - default to the <code>bin</code> subdirectory of your installation - directory, can be used to look up host names from logged IP addresses - offline.</p> - - <p>Finally, if you have <a href="mod_authz_host.html#reqhost">hostname-based Require - directives</a>, a hostname lookup will be performed regardless of - the setting of <code>HostnameLookups</code>.</p> + <p>Cette directive active la recherche DNS afin de pouvoir + journaliser les nom d'hôtes (et les passer aux programmes CGI et aux + inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur + <code>Double</code> déclenche une double recherche DNS inverse. En + d'autres termes, une fois la recherche inverse effectuée, on lance + une recherche directe sur le résultat de cette dernière. Au moins + une des adresses IP fournies par la recherche directe doit + correspondre à l'adresse originale (ce que l'on nomme + <code>PARANOID</code> dans la terminologie "tcpwrappers").</p> + + <p>Quelle que soit la configuration, lorsqu'on utilise + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour contrôler l'accès en fonction + du nom d'hôte, une double recherche DNS inverse est effectuée, + sécurité oblige. Notez cependant que le résultat de cette double + recherche n'est en général pas accessible, à moins que vous n'ayez + spécifié <code>HostnameLookups Double</code>. Par exemple, si vous + n'avez spécifié que <code>HostnameLookups On</code>, et si une + requête concerne un objet protégé par des restrictions en fonction + du nom d'hôte, quel que soit le résultat de la double recherche + inverse, les programmes CGI ne recevront que le résultat de la + recherche inverse simple dans la variable + <code>REMOTE_HOST</code>.</p> + + <p>La valeur par défaut est <code>Off</code> afin de préserver le + traffic réseau des sites pour lesquels la recherche inverse n'est + pas vraiment nécessaire. Cette valeur par défaut est aussi bénéfique + pour les utilisateurs finaux car il n'ont ainsi pas à subir de temps + d'attente supplémentaires dus aux recherches DNS. Les sites + fortement chargés devraient laisser cette directive à + <code>Off</code>, car les recherches DNS peuvent prendre des temps + très longs. Vous pouvez éventuellement utiliser hors ligne + l'utilitaire <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compilé par défaut dans + le sous-répertoire <code>bin</code> de votre répertoire + d'installation, afin de déterminer les noms d'hôtes associés aux + adresses IP journalisées.</p> + + <p>Enfin, si vous avez des <a href="mod_authz_host.html#reqhost">directives Require à base de + nom</a>, une recherche de nom d'hôte sera effectuée quelle que soit + la définition de la directive <code>HostnameLookups</code>.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="httpprotocoloptions" id="httpprotocoloptions">Directive</a> <a name="HttpProtocolOptions" id="HttpProtocolOptions">HttpProtocolOptions</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modify restrictions on HTTP Request Messages</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modifie les contraintes sur le format des requêtes HTTP</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HttpProtocolOptions Strict LenientMethods Allow0.9</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.2.32 or 2.4.24 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir des versions 2.2.32 et 2.4.24 du serveur HTTP +Apache</td></tr> </table> - <p>This directive changes the rules applied to the HTTP Request Line - (<a href="https://tools.ietf.org/html/rfc7230#section-3.1.1">RFC 7230 §3.1.1</a>) and the HTTP Request Header Fields - (<a href="https://tools.ietf.org/html/rfc7230#section-3.2">RFC 7230 §3.2</a>), which are now applied by default or using - the <code>Strict</code> option. Due to legacy modules, applications or - custom user-agents which must be deprecated the <code>Unsafe</code> - option has been added to revert to the legacy behaviors.</p> - - <p>These rules are applied prior to request processing, - so must be configured at the global or default (first) matching - virtual host section, by IP/port interface (and not by name) - to be honored.</p> - - <p>The directive accepts three parameters from the following list - of choices, applying the default to the ones not specified:</p> + <p>Cette directive permet de modifier les règles qui s'appliquent à la ligne + de requête HTTP (<a href="https://tools.ietf.org/html/rfc7230#section-3.1.1">RFC 7230 + §3.1.1</a>) et aux champs des en-têtes des requêtes HTTP (<a href="https://tools.ietf.org/html/rfc7230#section-3.2">RFC 7230 + §3.2</a>), qui s'appliquent maintenant par défaut ou en utilisant + l'option <code>Strict</code>. L'option <code>Unsafe</code> + a été ajoutée pour pouvoir restaurer les anciens + comportements nécessaires aux anciens modules et applications et aux agents + utilisateurs personnalisés considérés comme obsolètes.</p> + + <p>Ces règles + s'appliquant avant le traitement de la requête, elles doivent, pour être prises en + compte, être définies + au niveau global ou dans la première section par défaut du serveur virtuel + qui correspond à la requête considérée, par interface IP/port et non par + nom.</p> + + <p>Cette directive accepte trois paramètres issus de la liste suivante, ceux + qui ne sont pas spécifiés prenant leur valeur par défaut :</p> <dl> <dt>Strict|Unsafe</dt> <dd> - <p>Prior to the introduction of this directive, the Apache HTTP Server - request message parsers were tolerant of a number of forms of input - which did not conform to the protocol. - <a href="https://tools.ietf.org/html/rfc7230#section-9.4">RFC 7230 §9.4 Request Splitting</a> and - <a href="https://tools.ietf.org/html/rfc7230#section-9.5">§9.5 Response Smuggling</a> call out only two of the potential - risks of accepting non-conformant request messages, while - <a href="https://tools.ietf.org/html/rfc7230#section-3.5">RFC 7230 §3.5</a> "Message Parsing Robustness" identify the - risks of accepting obscure whitespace and request message formatting. - As of the introduction of this directive, all grammar rules of the - specification are enforced in the default <code>Strict</code> operating - mode, and the strict whitespace suggested by section 3.5 is enforced - and cannot be relaxed.</p> - - <div class="warning"><h3>Security risks of Unsafe</h3> - <p>Users are strongly cautioned against toggling the <code>Unsafe</code> - mode of operation, particularly on outward-facing, publicly accessible - server deployments. If an interface is required for faulty monitoring - or other custom service consumers running on an intranet, users should - toggle the Unsafe option only on a specific virtual host configured - to service their internal private network.</p> - </div> + <p>Avant l'introduction de cette directive, les interpréteurs de requêtes du + serveur HTTP Apache toléraient un grand nombre de formats en entrée qui + n'étaient pas forcément conformes au protocole. <a href="https://tools.ietf.org/html/rfc7230#section-9.4">RFC 7230 §9.4 + Request Splitting</a> et <a href="https://tools.ietf.org/html/rfc7230#section-9.5">§9.5 Response + Smuggling</a> ne rappellent que deux des risques potentiels induits par des + requêtes non conformes, alors que <a href="https://tools.ietf.org/html/rfc7230#section-3.5">RFC 7230 + §3.5</a> signale les risques encourus par l'acceptation de blancs non + conformes dans les lignes de requête. Avec l'introduction de cette + directive, toutes les règles de grammaire de la spécification doivent être + respectées dans le mode d'opérations par défaut <code>Strict</code>.</p> + + <div class="warning"><h3>Risques de sécurité liés au mode Unsafe</h3> + <p>Il est fortement déconseillé aux utilisateurs d'utiliser le mode + d'opération <code>Unsafe</code>, ou + <code>UnsafeWhitespace</code>, en particulier pour les déploiements de + serveurs ouverts sur l'extérieur et/ou accessibles au public. Si un moniteur + défectueux ou autre logiciel spécialisé ne s'exécutant que sur un intranet + nécessite une interface, les utilisateurs ne doivent utiliser les options de + type UnSafe qu'en cas de nécessité et uniquement au sein d'un serveur + virtuel bien spécifique et sur un réseau privé.</p> + </div> - <div class="example"><h3>Example of a request leading to HTTP 400 with Strict mode</h3><p><code> + <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 400 en + mode Strict</h3><p><code> # Missing CRLF<br /> GET / HTTP/1.0\n\n </code></p></div> - <div class="warning"><h3>Command line tools and CRLF</h3> - <p>Some tools need to be forced to use CRLF, otherwise httpd will return - a HTTP 400 response like described in the above use case. For example, - the <strong>OpenSSL s_client needs the -crlf parameter to work - properly</strong>.</p> - <p>The <code class="directive"><a href="../mod/mod_dumpio.html#dumpioinput">DumpIOInput</a></code> directive - can help while reviewing the HTTP request to identify issues like the - absence of CRLF.</p> + <div class="warning"><h3>Utilitaires en ligne de commande et CRLF</h3> + <p>Il peut s'avérer nécessaire de forcer certains utilitaires à utiliser + CRLF ; si ce n'est pas le cas, httpd reverra une réponse HTTP 400 comme + dans le cas précédent. Par exemple, le <strong>client OpenSSL s_client + doit utiliser le paramètre -crlf pour fonctionner correctement</strong>.</p> + <p>Pour détecter des problèmes tels que l'absence de CRLF, vous pouvez + utiliser la directive <code class="directive"><a href="../mod/mod_dumpio.html#dumpioinput">DumpIOInput</a></code> qui permet de décortiquer + les requêtes HTTP.</p> </div> </dd> <dt>RegisteredMethods|LenientMethods</dt> <dd> - <p><a href="https://tools.ietf.org/html/rfc7231#section-4.1">RFC 7231 §4.1</a> "Request Methods" "Overview" requires that - origin servers shall respond with a HTTP 501 status code when an - unsupported method is encountered in the request line. - This already happens when the <code>LenientMethods</code> option is used, - but administrators may wish to toggle the <code>RegisteredMethods</code> - option and register any non-standard methods using the - <code class="directive"><a href="#registerhttpmethod">RegisterHttpMethod</a></code> - directive, particularly if the <code>Unsafe</code> - option has been toggled.</p> - - <div class="warning"><h3>Forward Proxy compatibility</h3> - <p>The <code>RegisteredMethods</code> option should <strong>not</strong> - be toggled for forward proxy hosts, as the methods supported by the - origin servers are unknown to the proxy server.</p> - </div> + <p>La section de la <a href="https://tools.ietf.org/html/rfc7231#section-4.1">RFC 7231 + §4.1</a> "Request Methods" "Overview" indique que les serveurs doivent + renvoyer un message d'erreur lorsque la ligne de requête comporte une + méthode non supportée. C'est déjà le cas lorsque l'option + <code>LenientMethods</code> est utilisée, mais les administrateurs ont la + possibilité de limiter les méthodes utilisées via l'option + <code>RegisteredMethods</code> en enregistrant toute méthode non standard + via la directive <code class="directive">RegisterHttpMethod</code>, en particulier + si l'option <code>Unsafe</code> est utilisée.</p> + + <div class="warning"><h3>Compatibilité avec le mandat direct</h3> + <p>L'option + <code>RegisteredMethods</code> <strong>ne doit pas</strong> être utilisée + pour les serveurs mandataires car ces derniers ne connaissent pas les + méthodes supportées par les serveurs originaux.</p> + </div> - <div class="example"><h3>Example of a request leading to HTTP 501 with LenientMethods mode</h3><p><code> + <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 501 en + mode LenientMethods</h3><p><code> - # Unknown HTTP method<br /> + # Méthode HTTP inconnue<br /> WOW / HTTP/1.0\r\n\r\n<br /><br /> - # Lowercase HTTP method<br /> + # Méthode HTTP spécifiée en minuscules<br /> get / HTTP/1.0\r\n\r\n<br /> </code></p></div> </dd> <dt>Allow0.9|Require1.0</dt> <dd> - <p><a href="https://tools.ietf.org/html/rfc2616#section-19.6">RFC 2616 §19.6</a> "Compatibility With Previous Versions" had - encouraged HTTP servers to support legacy HTTP/0.9 requests. RFC 7230 - supersedes this with "The expectation to support HTTP/0.9 requests has - been removed" and offers additional comments in - <a href="https://tools.ietf.org/html/rfc7230#appendix-A">RFC 7230 Appendix A</a>. The <code>Require1.0</code> option allows - the user to remove support of the default <code>Allow0.9</code> option's - behavior.</p> - - <div class="example"><h3>Example of a request leading to HTTP 400 with Require1.0 mode</h3><p><code> + <p>La section de la <a href="https://tools.ietf.org/html/rfc2616#section-19.6">RFC 2616 + §19.6</a> "Compatibility With Previous Versions" encouragait les + serveurs HTTP à supporter les anciennes requêtes HTTP/0.9. La RFC 7230 va + cependant à son encontre via sa préconisation "Le souhait de supporter les + requêtes HTTP/0.9 a été supprimé" et y adjoint des commentaires dans <a href="https://tools.ietf.org/html/rfc7230#appendix-A">RFC 7230 Appendix + A</a>. A ce titre, l'option <code>Require1.0</code> permet à l'utilisateur + d'inhiber le comportement induit par l'option par défaut + <code>Allow0.9</code>.</p> + + <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 400 en + mode Require1.0</h3><p><code> - # Unsupported HTTP version<br /> + # Version HTTP non supportée<br /> GET /\r\n\r\n </code></p></div> </dd> </dl> - <p>Reviewing the messages logged to the - <code class="directive"><a href="#errorlog">ErrorLog</a></code>, configured with - <code class="directive"><a href="#loglevel">LogLevel</a></code> <code>debug</code> level, - can help identify such faulty requests along with their origin. - Users should pay particular attention to the 400 responses in the access - log for invalid requests which were unexpectedly rejected.</p> + + <p>La consultation des messages enregistrés dans le journal + <code class="directive">ErrorLog</code>, configuré via la directive + <code class="directive">LogLevel</code> avec un niveau <code>info</code>, pourra + vous aider à identifier de telles requêtes non conformes ainsi que leur + provenance. Les utilisateurs devront accorder une attention particulière aux + messages d'erreur de type 400 dans le journal access pour détecter les + requêtes apparemment valides mais rejetées.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="if" id="if">Directive</a> <a name="If" id="If"><If></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only if a condition is -satisfied by a request at runtime</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si une +condition est satisfaite au cours du traitement d'une +requête</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Nested conditions are evaluated in 2.4.26 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version +2.4.26 du serveur HTTP Apache</td></tr> </table> - <p>The <code class="directive"><If></code> directive - evaluates an expression at runtime, and applies the enclosed - directives if and only if the expression evaluates to true. - For example:</p> + <p>La directive <code class="directive"><If></code> évalue une + expression à la volée, et applique les directives qu'elle contient + si et seulement si l'expression renvoie la valeur "vrai". Par + exemple :</p> <pre class="prettyprint lang-config"><If "-z req('Host')"></pre> - <p>would match HTTP/1.0 requests without a <var>Host:</var> header. - Expressions may contain various shell-like operators for string - comparison (<code>==</code>, <code>!=</code>, <code><</code>, ...), - integer comparison (<code>-eq</code>, <code>-ne</code>, ...), - and others (<code>-n</code>, <code>-z</code>, <code>-f</code>, ...). - It is also possible to use regular expressions, </p> + <p>serait satisfaite pour les requêtes HTTP/1.0 sans en-tête + <var>Host:</var>. Les expressions peuvent contenir différents + opérateurs de type shell pour la comparaison de chaînes + (<code>==</code>, <code>!=</code>, <code><</code>, ...), la + comparaison d'entiers (<code>-eq</code>, <code>-ne</code>, ...), ou + à usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>, + ...). Les expressions rationnelles sont aussi supportées,</p> <pre class="prettyprint lang-config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></pre> - <p>shell-like pattern matches and many other operations. These operations - can be done on request headers (<code>req</code>), environment variables - (<code>env</code>), and a large number of other properties. The full - documentation is available in <a href="../expr.html">Expressions in - Apache HTTP Server</a>.</p> + <p>ainsi que les comparaison de modèles de type shell et de + nombreuses autres opérations. Ces opérations peuvent être effectuées + sur les en-têtes de requêtes (<code>req</code>), les variables + d'environnement (<code>env</code>), et un grand nombre d'autres + propriétés. La documentation complète est disponible dans <a href="../expr.html">Les expressions dans le serveur HTTP Apache</a>.</p> - <p>Only directives that support the <a href="directive-dict.html#Context">directory context</a> can be used within this configuration section.</p> + <p>Cette section de configuration ne peut contenir que des + directives qui supportent le <a href="directive-dict.html#Context">contexte de répertoire</a>.</p> <div class="warning"> - Certain variables, such as <code>CONTENT_TYPE</code> and other - response headers, are set after <If> conditions have already - been evaluated, and so will not be available to use in this - directive. + Certaines variables comme <code>CONTENT_TYPE</code> ainsi que + d'autres en-têtes de réponse ne seront pas disponibles dans ce bloc, + car elle sont définies après l'évaluation des conditions <If>. </div> <h3>Voir aussi</h3> <ul> -<li><a href="../expr.html">Expressions in Apache HTTP Server</a>, -for a complete reference and more examples.</li> +<li><a href="../expr.html">Les expressions dans le serveur HTTP +Apache</a>, pour une référence complète et d'autres exemples.</li> <li><code class="directive"><a href="#elseif"><ElseIf></a></code></li> <li><code class="directive"><a href="#else"><Else></a></code></li> -<li><a href="../sections.html">How <Directory>, <Location>, - <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received. - <code class="directive"><If></code>, - <code class="directive"><ElseIf></code>, and - <code class="directive"><Else></code> are applied last.</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête. Les +directives <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="ifdefine" id="ifdefine">Directive</a> <a name="IfDefine" id="IfDefine"><IfDefine></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only -if a test is true at startup</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfDefine [!]<var>parameter-name</var>> ... +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliqueront que si un +test retourne "vrai" au démarrage du serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfDefine [!]<var>paramètre</var>> ... </IfDefine></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code><IfDefine <var>test</var>>...</IfDefine> - </code> section is used to mark directives that are conditional. The - directives within an <code class="directive"><IfDefine></code> - section are only processed if the <var>test</var> is true. If <var> - test</var> is false, everything between the start and end markers is - ignored.</p> + <p>La section <code><IfDefine + <var>test</var>>...</IfDefine></code> permet de + conférer un caractère conditionnel à un ensemble de directives. Les + directives situées à l'intérieur d'une section <code class="directive"><IfDefine></code> ne s'appliquent que si + <var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui + se trouve entre les balises de début et de fin est ignoré.</p> - <p>The <var>test</var> in the <code class="directive"><IfDefine></code> section directive can be one of two forms:</p> + <p><var>test</var> peut se présenter sous deux formes :</p> <ul> - <li><var>parameter-name</var></li> + <li><var>nom paramètre</var></li> - <li><code>!</code><var>parameter-name</var></li> + <li><code>!</code><var>nom paramètre</var></li> </ul> - <p>In the former case, the directives between the start and end - markers are only processed if the parameter named - <var>parameter-name</var> is defined. The second format reverses - the test, and only processes the directives if - <var>parameter-name</var> is <strong>not</strong> defined.</p> + <p>Dans le premier cas, les directives situées entre les balises de + début et de fin ne s'appliqueront que si le paramètre nommé <var>nom + paramètre</var> est défini. Le second format inverse le test, et + dans ce cas, les directives ne s'appliqueront que si <var>nom + paramètre</var> n'est <strong>pas</strong> défini.</p> - <p>The <var>parameter-name</var> argument is a define as given on the - <code class="program"><a href="../programs/httpd.html">httpd</a></code> command line via <code>-D<var>parameter</var> - </code> at the time the server was started or by the <code class="directive"><a href="#define">Define</a></code> directive.</p> + <p>L'argument <var>nom paramètre</var> est une définition qui peut + être effectuée par la ligne de commande + <code class="program"><a href="../programs/httpd.html">httpd</a></code> via le paramètre + <code>-D<var>paramètre</var></code> au démarrage du serveur, ou via la + directive <code class="directive"><a href="#define">Define</a></code>.</p> - <p><code class="directive"><IfDefine></code> sections are - nest-able, which can be used to implement simple - multiple-parameter tests. Example:</p> + <p>Les sections <code class="directive"><IfDefine></code> + peuvent être imbriquées, ce qui permet d'implémenter un test + multi-paramètres simple. Exemple :</p> <div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div> <pre class="prettyprint lang-config"><IfDefine ReverseProxy> @@ -2297,8 +2458,8 @@ if a test is true at startup</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="ifdirective" id="ifdirective">Directive</a> <a name="IfDirective" id="IfDirective"><IfDirective></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the -presence or absence of a specific directive</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives dont le traitement est conditionné par la +présence ou l'absence d'une directive particulière</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfDirective [!]<var>directive-name</var>> ... </IfDirective></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -2306,13 +2467,16 @@ presence or absence of a specific directive</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code><IfDirective <var>test</var>>...</IfDirective></code> - section is used to mark directives that are conditional on the presence of - a specific directive. The directives within an <code class="directive"><IfDirective></code> section are only processed if the <var>test</var> - is true. If <var>test</var> is false, everything between the start and - end markers is ignored.</p> + <p>La section <code><IfDirective + <var>test</var>>...</IfDirective></code> permet de regrouper des + directives dont le traitement n'est effectué que si une directive + particulière est présente, autrement dit si l'expression <var>test</var> est + évaluée à true. Si l'expression <var>test</var> est évaluée à false, toutes + les lignes qui se trouvent entre les balises de début et de fin de la + section sont ignorées.</p> - <p>The <var>test</var> in the <code class="directive"><IfDirective></code> section can be one of two forms:</p> + <p>L'expression <var>test</var> de la section <code class="directive"><IfDirective></code> peut prendre les deux formes + suivantes :</p> <ul> <li><var>directive-name</var></li> @@ -2320,18 +2484,17 @@ presence or absence of a specific directive</td></tr> <li>!<var>directive-name</var></li> </ul> - <p>In the former case, the directives between the start and end - markers are only processed if a directive of the given name is - available at the time of processing. The second format reverses the test, - and only processes the directives if <var>directive-name</var> is - <strong>not</strong> available.</p> + <p>Dans le premier cas, les directives qui se situent entre les balises de + début et de fin de la section ne sont traitées que si une directive de nom + directive-name est disponible à cet instant. Dans le second cas, la condition est + inversée, et les directives ne sont traitées que si + <var>directive-name</var> n'est <strong>pas</strong> disponible.</p> - <div class="note">This section should only be used if you need to have one - configuration file that works across multiple versions of - <code class="program"><a href="../programs/httpd.html">httpd</a></code>, regardless of whether a particular - directive is available. In normal operation, directives need not - be placed in <code class="directive"><IfDirective></code> - sections.</div> + <div class="note">Cette section ne doit être utilisée que si vous devez partager le même + fichier de configuration entre plusieurs versions de + <code class="program"><a href="../programs/httpd.html">httpd</a></code>, sans tenir compte de la disponibilité de telle ou + telle directive. Dans une configuration standard, il est inutile de placer + les directives dans des sections <code class="directive"><IfDirective></code>.</div> <h3>Voir aussi</h3> <ul> @@ -2341,8 +2504,8 @@ presence or absence of a specific directive</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="iffile" id="iffile">Directive</a> <a name="IfFile" id="IfFile"><IfFile></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that will be processed only -if file exists at startup</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui ne seront traitées que si un fichier +existe au démarrage</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfFile [!]<var>parameter-name</var>> ... </IfFile></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -2350,50 +2513,52 @@ if file exists at startup</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code><IfFile <var>filename</var>>...</IfFile> - </code> section is used to mark directives that are conditional on - the existence of a file on disk. The directives within an - <code class="directive"><IfFile></code> section are only - processed if the <var>filename</var> exists. If <var> filename</var> - doesn't exist, everything between the start and end markers is - ignored. <var>filename</var> can be an absolute path or a path - relative to the server root.</p> - - <p>The <var>filename</var> in the <code class="directive"><IfFile - ></code> section directive can take the same forms as the - <var>test</var> variable in the <code class="directive"><IfDefine - ></code> section, i.e. the test can be negated if the <code> - !</code> character is placed directly before <var>filename</var>. + <p>La section <code><IfFile <var>filename</var>>...</IfFile></code> + permet de conditionner le traitement de directives à + l'existence d'un fichier sur disque. Ainsi, les directives définies au sein + d'une section <code class="directive"><IfFile></code> ne seront + traitées que si le fichier <var>filename</var> existe. Si le fichier + <var>filename</var> n'existe pas, tout ce qui se trouve entre les marqueurs + start et end sera ignoré. <var>filename</var> peut être un chemin absolu ou + relatif au chemin défini par la directive ServerRoot.</p> + + <p>Le paramètre <var>filename</var> de l'en-tête d'une section <code class="directive"><IfFile></code> peut prendre la même forme que la variable + <var>test</var> de la section <code class="directive"><IfDefine></code> ; à ce titre, le résultat du test peut être + inversé en plaçant le caractère <code>!</code> juste avant + <var>filename</var>. </p> - <p>If a relative <var>filename</var> is supplied, the check is - <code class="directive">ServerRoot</code> relative. In the case where - this directive occurs before the <code class="directive">ServerRoot</code>, - the path will be checked relative to the compiled-in server root or - the server root passed in on the command line via the <code>-d</code> - parameter.</p> + <p>Si <var>filename</var> est un chemin relatif, il sera généré par rapport + au chemin défini par la directive <code class="directive">ServerRoot</code>. Lorsque + la directive <code class="directive"><IfFile></code> intervient avant + la définition de la directive <code class="directive">ServerRoot</code>, + <var>filename</var> sera relatif au répertoire racine par défaut du serveur + ou au répertoire racine passé dans la ligne de commande via l'option + <code>-d</code>.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="ifmodule" id="ifmodule">Directive</a> <a name="IfModule" id="IfModule"><IfModule></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the -presence or absence of a specific module</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ... - </IfModule></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'en fonction +de la présence ou de l'absence d'un module spécifique</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfModule [!]<var>fichier module</var>|<var>identificateur +module</var>> ... </IfModule></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code><IfModule <var>test</var>>...</IfModule></code> - section is used to mark directives that are conditional on the presence of - a specific module. The directives within an <code class="directive"><IfModule></code> section are only processed if the <var>test</var> - is true. If <var>test</var> is false, everything between the start and - end markers is ignored.</p> + <p>La section <code><IfModule + <var>test</var>>...</IfModule></code> permet de conférer à + des directives un caractère conditionnel basé sur la présence d'un + module spécifique. Les directives situées dans une section + <code class="directive"><IfModule></code> ne s'appliquent que + si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce + qui se trouve entre les balises de début et de fin est ignoré.</p> - <p>The <var>test</var> in the <code class="directive"><IfModule></code> section directive can be one of two forms:</p> + <p><var>test</var> peut se présenter sous deux formes :</p> <ul> <li><var>module</var></li> @@ -2401,36 +2566,37 @@ presence or absence of a specific module</td></tr> <li>!<var>module</var></li> </ul> - <p>In the former case, the directives between the start and end - markers are only processed if the module named <var>module</var> - is included in Apache httpd -- either compiled in or - dynamically loaded using <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. The second format reverses the test, - and only processes the directives if <var>module</var> is - <strong>not</strong> included.</p> - - <p>The <var>module</var> argument can be either the module identifier or - the file name of the module, at the time it was compiled. For example, - <code>rewrite_module</code> is the identifier and - <code>mod_rewrite.c</code> is the file name. If a module consists of - several source files, use the name of the file containing the string + <p>Dans le premier cas, les directives situées entre les balises de + début et de fin ne s'appliquent que si le module <var>module</var> + est présent -- soit compilé avec le binaire Apache httpd, soit chargé + dynamiquement via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Le second format inverse le test, et dans + ce cas, les directives ne s'appliquent que si <var>module</var> + n'est <strong>pas</strong> présent.</p> + + <p>L'argument <var>module</var> peut contenir soit l'identificateur + du module, soit le nom du fichier source du module. Par exemple, + <code>rewrite_module</code> est un identificateur et + <code>mod_rewrite.c</code> le nom du fichier source + correspondant. Si un module comporte plusieurs fichiers sources, + utilisez le nom du fichier qui contient la chaîne de caractères <code>STANDARD20_MODULE_STUFF</code>.</p> - <p><code class="directive"><IfModule></code> sections are - nest-able, which can be used to implement simple multiple-module - tests.</p> + <p>Les sections <code class="directive"><IfModule></code> + peuvent être imbriquées, ce qui permet d'implémenter des tests + multi-modules simples.</p> - <div class="note">This section should only be used if you need to have one - configuration file that works whether or not a specific module - is available. In normal operation, directives need not be - placed in <code class="directive"><IfModule></code> - sections.</div> + <div class="note">Cette section ne doit être utilisée que si votre fichier de + configuration ne fonctionne qu'en fonction de la présence ou de + l'absence d'un module spécifique. D'une manière générale, il n'est + pas nécessaire de placer les directives à l'intérieur de sections + <code class="directive"><IfModule></code>.</div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="ifsection" id="ifsection">Directive</a> <a name="IfSection" id="IfSection"><IfSection></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Encloses directives that are processed conditional on the -presence or absence of a specific section directive</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives dont le traitement est conditionné par la +présence ou l'absence d'une section particulière</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfSection [!]<var>section-name</var>> ... </IfSection></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -2438,47 +2604,43 @@ presence or absence of a specific section directive</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code><IfSection - <var>test</var>>...</IfSection></code> section is used - to mark directives that are conditional on the presence of a - specific section directive. A section directive is any directive - such as <code class="directive"><VirtualHost></code> which - encloses other directives, and has a directive name with a leading - "<".</p> - - <p>The directives within an <code class="directive"><IfSection></code> section are only processed if the <var>test</var> - is true. If <var>test</var> is false, everything between the start and - end markers is ignored.</p> - - <p>The <var>section-name</var> must be specified without either - the leading "<" or closing ">". The <var>test</var> in the - <code class="directive"><IfSection></code> section can be one - of two forms:</p> + <p>La section <code><IfSection + <var>test</var>>...</IfSection></code> permet de regrouper des + directives dont le traitement n'est effectué que si une section de + configuration particulière est présente. Une section, par exemple <code class="directive"><VirtualHost></code>, permet de regrouper des directives + et possède un nom précédé du caractère "<".</p> + + <p>Les directives situées à l'intérieur d'une section <code class="directive"><IfSection></code> ne sont traitées que si l'expression + <var>test</var> est évaluée à true. Si l'expression <var>test</var> est + évaluée à false, toutes les lignes situées entre les balises de début et de + fin de la section sont ignorées.</p> + + <p><var>section-name</var> doit être spécifié sans les caractères de début + "<" ou fin ">". L'expression <var>test</var> de la section <code class="directive"><IfSection></code> peut prendre deux formes :</p> <ul> <li><var>section-name</var></li> <li>!<var>section-name</var></li> </ul> - <p>In the former case, the directives between the start and end - markers are only processed if a section directive of the given - name is available at the time of processing. The second format - reverses the test, and only processes the directives if - <var>section-name</var> is <strong>not</strong> an available - section directive.</p> + <p>Dans le premier cas, les directives qui se situent entre les balises de + début et de fin de la section ne sont traitées que si une section de nom + section-name est disponible à cet instant. Dans le second cas, la condition est + inversée, et les directives ne sont traitées que si + <var>section-name</var> n'est <strong>pas</strong> disponible.</p> - <p>For example:</p> + <p>Par exemple :</p> <pre class="prettyprint lang-config"><IfSection VirtualHost> ... </IfSection></pre> - <div class="note">This section should only be used if you need to have one - configuration file that works across multiple versions of <code class="program"><a href="../programs/httpd.html">httpd</a></code>, - regardless of whether a particular section directive is - available. In normal operation, directives need not be placed in - <code class="directive"><IfSection></code> sections.</div> + <div class="note">Cette section ne doit être utilisée que si vous devez partager le même + fichier de configuration entre plusieurs versions de + <code class="program"><a href="../programs/httpd.html">httpd</a></code>, sans tenir compte de la disponibilité de telle ou + telle section. Dans une configuration standard, il est inutile de placer + les directives dans des sections <code class="directive"><IfSection></code>.</div> <h3>Voir aussi</h3> <ul> @@ -2488,62 +2650,70 @@ presence or absence of a specific section directive</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="include" id="include">Directive</a> <a name="Include" id="Include">Include</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within -the server configuration files</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclut d'autres fichiers de configuration dans un des +fichiers de configuration du serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Include <var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Directory -wildcard matching available in 2.3.6 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Utilisation des caractères +génériques dans la partie chemin depuis la version 2.3.6</td></tr> </table> - <p>This directive allows inclusion of other configuration files - from within the server configuration files.</p> - - <p>Shell-style (<code>fnmatch()</code>) wildcard characters can be used - in the filename or directory parts of the path to include several files - at once, in alphabetical order. In addition, if - <code class="directive">Include</code> points to a directory, rather than a file, - Apache httpd will read all files in that directory and any subdirectory. - However, including entire directories is not recommended, because it is - easy to accidentally leave temporary files in a directory that can cause - <code class="program"><a href="../programs/httpd.html">httpd</a></code> to fail. Instead, we encourage you to use the - wildcard syntax shown below, to include files that match a particular - pattern, such as *.conf, for example.</p> - - <p>The <code class="directive"><a href="#include">Include</a></code> directive will - <strong>fail with an error</strong> if a wildcard expression does not - match any file. The <code class="directive"><a href="#includeoptional">IncludeOptional</a></code> - directive can be used if non-matching wildcards should be ignored.</p> - - <p>The file path specified may be an absolute path, or may be relative - to the <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory.</p> - - <p>Examples:</p> + <p>Cette directive permet l'inclusion d'autres fichiers de + configuration dans un des fichiers de configuration du serveur.</p> + + <p>On peut utiliser des caractères génériques de style Shell + (<code>fnmatch()</code>) aussi bien dans la partie nom de fichier du + chemin que dans la partie répertoires pour inclure plusieurs + fichiers en une + seule fois, selon leur ordre alphabétique. De plus, si la directive + <code class="directive">Include</code> pointe vers un répertoire, Apache + httpd inclura tous les fichiers de ce répertoire et de tous ces + sous-répertoires. L'inclusion de répertoires entiers est cependant + déconseillée, car il est fréquent d'oublier des fichiers + temporaires dans un répertoire, ce qui causerait une erreur + <code class="program"><a href="../programs/httpd.html">httpd</a></code> en cas d'inclusion. Pour inclure des + fichiers qui correspondent à un certain modèle, comme *.conf par + exemple, nous vous recommandons d'utiliser plutôt la syntaxe avec + caractères génériques comme ci-dessous.</p> + + <p>La directive <code class="directive"><a href="#include">Include</a></code> + <strong>échouera avec un code d'erreur</strong> si une expression + contenant des caractères génériques ne correspond à aucun fichier. + Pour ignorer les expressions contenant des caractères génériques ne + correspondant à aucun fichier, utilisez la directive <code class="directive"><a href="#includeoptional">IncludeOptional</a></code>.</p> + + <p>Le chemin fichier spécifié peut être soit un chemin absolu, soit + un chemin relatif au répertoire défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> + + <p>Exemples :</p> <pre class="prettyprint lang-config">Include /usr/local/apache2/conf/ssl.conf Include /usr/local/apache2/conf/vhosts/*.conf</pre> - <p>Or, providing paths relative to your <code class="directive"><a href="#serverroot">ServerRoot</a></code> directory:</p> + <p>ou encore, avec des chemins relatifs au répertoire défini par la + directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p> <pre class="prettyprint lang-config">Include conf/ssl.conf Include conf/vhosts/*.conf</pre> - <p>Wildcards may be included in the directory or file portion of the - path. This example will fail if there is no subdirectory in conf/vhosts - that contains at least one *.conf file:</p> - + <p>On peut aussi insérer des caractères génériques dans la partie + répertoires du chemin. Dans l'exemple suivant, la directive + échouera si aucun sous-répertoire de conf/vhosts ne contient au + moins un fichier *.conf :</p> + <pre class="prettyprint lang-config">Include conf/vhosts/*/*.conf</pre> - <p>Alternatively, the following command will just be ignored in case of - missing files or directories:</p> + <p>Par contre, dans l'exemple suivant, la directive sera simplement + ignorée si aucun sous-répertoire de conf/vhosts ne contient au + moins un fichier *.conf :</p> <pre class="prettyprint lang-config">IncludeOptional conf/vhosts/*/*.conf</pre> - + <h3>Voir aussi</h3> <ul> @@ -2554,20 +2724,22 @@ Include conf/vhosts/*.conf</pre> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="includeoptional" id="includeoptional">Directive</a> <a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Includes other configuration files from within -the server configuration files</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IncludeOptional <var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclusion de fichiers dans le fichier de configuration</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IncludeOptional +<var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in 2.3.6 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.6 du serveur HTTP +Apache</td></tr> </table> - <p>This directive allows inclusion of other configuration files - from within the server configuration files. It works identically to the - <code class="directive"><a href="#include">Include</a></code> directive, with the - exception that if wildcards do not match any file or directory, the - <code class="directive"><a href="#includeoptional">IncludeOptional</a></code> directive will be - silently ignored instead of causing an error.</p> + <p>Cette directive permet d'inclure des fichiers dans les fichiers + de configuration du serveur. Elle fonctionne de manière identique à + la directive <code class="directive"><a href="#include">Include</a></code>, à + l'exception du fait que si l'expression avec caractères génériques + wilcard ne correspond à aucun fichier ou répertoire, elle sera + ignorée silencieusement au lieu de causer une erreur.</p> + <h3>Voir aussi</h3> <ul> @@ -2578,36 +2750,38 @@ the server configuration files</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="keepalive" id="keepalive">Directive</a> <a name="KeepAlive" id="KeepAlive">KeepAlive</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables HTTP persistent connections</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les connexions HTTP persistantes</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAlive On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAlive On</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The Keep-Alive extension to HTTP/1.0 and the persistent - connection feature of HTTP/1.1 provide long-lived HTTP sessions - which allow multiple requests to be sent over the same TCP - connection. In some cases this has been shown to result in an - almost 50% speedup in latency times for HTML documents with - many images. To enable Keep-Alive connections, set - <code>KeepAlive On</code>.</p> - - <p>For HTTP/1.0 clients, Keep-Alive connections will only be - used if they are specifically requested by a client. In - addition, a Keep-Alive connection with an HTTP/1.0 client can - only be used when the length of the content is known in - advance. This implies that dynamic content such as CGI output, - SSI pages, and server-generated directory listings will - generally not use Keep-Alive connections to HTTP/1.0 clients. - For HTTP/1.1 clients, persistent connections are the default - unless otherwise specified. If the client requests it, chunked - encoding will be used in order to send content of unknown - length over persistent connections.</p> - - <p>When a client uses a Keep-Alive connection, it will be counted - as a single "request" for the <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> directive, regardless - of how many requests are sent using the connection.</p> + <p>L'extension Keep-Alive de HTTP/1.0 et l'implémentation des + connexions persistantes dans HTTP/1.1 ont rendu possibles des + sessions HTTP de longue durée, ce qui permet de transmettre + plusieurs requêtes via la même connexion TCP. Dans certains cas, le + gain en rapidité pour des documents comportant de nombreuses images + peut atteindre 50%. Pour activer les connexions persistantes, + définissez <code>KeepAlive On</code>.</p> + + <p>Pour les clients HTTP/1.0, les connexions persistantes ne seront + mises en oeuvre que si elles ont été spécialement demandées par un + client. De plus, une connexion persistante avec un client HTTP/1.0 + ne peut être utilisée que si la taille du contenu est connue + d'avance. Ceci implique que les contenus dynamiques comme les + sorties CGI, les pages SSI, et les listings de répertoires générés + par le serveur n'utiliseront en général pas les connexions + persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1, + les connexions persistantes sont utilisées par défaut, sauf + instructions contraires. Si le client le demande, le transfert par + tronçons de taille fixe (chunked encoding) sera utilisé afin de + transmettre un contenu de longueur inconnue via une connexion + persistante.</p> + + <p>Lorsqu'un client utilise une connexion persistante, elle comptera + pour une seule requête pour la directive <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>, quel + que soit le nombre de requêtes transmises via cette connexion.</p> <h3>Voir aussi</h3> <ul> @@ -2617,94 +2791,96 @@ the server configuration files</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="keepalivetimeout" id="keepalivetimeout">Directive</a> <a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for subsequent -requests on a persistent connection</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle le serveur va attendre une requête +avant de fermer une connexion persistante</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAliveTimeout <var>time-interval</var>[s]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAliveTimeout 5</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The number of seconds Apache httpd will wait for a subsequent - request before closing the connection. By adding a postfix of ms the - timeout can be also set in milliseconds. Once a request has been - received, the timeout value specified by the - <code class="directive"><a href="#timeout">Timeout</a></code> directive applies.</p> - - <p>Setting <code class="directive">KeepAliveTimeout</code> to a high value - may cause performance problems in heavily loaded servers. The - higher the timeout, the more server processes will be kept - occupied waiting on connections with idle clients.</p> - - <p>If <code class="directive">KeepAliveTimeout</code> is <strong>not</strong> - set for a name-based virtual host, the value of the first defined - virtual host best matching the local IP and port will be used.</p> + <p>Le nombre de secondes pendant lesquelles Apache httpd va attendre une + requête avant de fermer la connexion. Le délai peut être défini en + millisecondes en suffixant sa valeur par ms. La valeur du délai + spécifiée par la directive <code class="directive"><a href="#timeout">Timeout</a></code> s'applique dès qu'une requête a + été reçue.</p> + + <p>Donner une valeur trop élévée à + <code class="directive">KeepAliveTimeout</code> peut induire des problèmes + de performances sur les serveurs fortement chargés. Plus le délai + est élévé, plus nombreux seront les processus serveur en attente de + requêtes de la part de clients inactifs.</p> + + <p>Si la directive <code class="directive">KeepAliveTimeout</code> + <strong>n'est pas</strong> définie pour un des serveurs virtuels + à base de nom, c'est le serveur virtuel dont la paire adresse + IP/port correspond le mieux qui sera utilisée.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limit" id="limit">Directive</a> <a name="Limit" id="Limit"><Limit></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict enclosed access controls to only certain HTTP -methods</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ... +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite les contrôles d'accès que la section contient à +certaines méthodes HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Limit <var>méthode</var> [<var>méthode</var>] ... > ... </Limit></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig, Limit</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Access controls are normally effective for - <strong>all</strong> access methods, and this is the usual - desired behavior. <strong>In the general case, access control - directives should not be placed within a - <code class="directive"><Limit></code> section.</strong></p> - - <p>The purpose of the <code class="directive"><Limit></code> - directive is to restrict the effect of the access controls to the - nominated HTTP methods. For all other methods, the access - restrictions that are enclosed in the <code class="directive"><Limit></code> bracket <strong>will have no - effect</strong>. The following example applies the access control - only to the methods <code>POST</code>, <code>PUT</code>, and - <code>DELETE</code>, leaving all other methods unprotected:</p> + <p>Les contrôles d'accès s'appliquent normalement à + <strong>toutes</strong> les méthodes d'accès, et c'est en général le + comportement souhaité. <strong>Dans le cas général, les directives + de contrôle d'accès n'ont pas à être placées dans une section + <code class="directive"><Limit></code>.</strong></p> + + <p>La directive <code class="directive"><Limit></code> a pour + but de limiter les effets des contrôles d'accès aux méthodes HTTP + spécifiées. Pour toutes les autres méthodes, les restrictions + d'accès contenues dans la section <code class="directive"><Limit></code> <strong>n'auront aucun + effet</strong>. L'exemple suivant n'applique les contrôles d'accès + qu'aux méthodes <code>POST</code>, <code>PUT</code>, et + <code>DELETE</code>, en laissant les autres méthodes sans protection + :</p> <pre class="prettyprint lang-config"><Limit POST PUT DELETE> Require valid-user </Limit></pre> - <p>The method names listed can be one or more of: <code>GET</code>, - <code>POST</code>, <code>PUT</code>, <code>DELETE</code>, - <code>CONNECT</code>, <code>OPTIONS</code>, - <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>, - <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>, - <code>LOCK</code>, and <code>UNLOCK</code>. <strong>The method name is - case-sensitive.</strong> If <code>GET</code> is used, it will also - restrict <code>HEAD</code> requests. The <code>TRACE</code> method - cannot be limited (see <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p> + <p>La liste des noms de méthodes peut contenir une ou plusieurs + valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>, + <code>PUT</code>, <code>DELETE</code>, <code>CONNECT</code>, + <code>OPTIONS</code>, <code>PATCH</code>, <code>PROPFIND</code>, + <code>PROPPATCH</code>, <code>MKCOL</code>, <code>COPY</code>, + <code>MOVE</code>, <code>LOCK</code>, et <code>UNLOCK</code>. + <strong>Le nom de méthode est sensible à la casse.</strong> Si la + valeur <code>GET</code> est présente, les requêtes <code>HEAD</code> + seront aussi concernées. La méthode <code>TRACE</code> ne peut pas + être limitée (voir la directive <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p> - <div class="warning">A <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section should always be - used in preference to a <code class="directive"><Limit></code> - section when restricting access, since a <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> section provides protection - against arbitrary methods.</div> + <div class="warning">Une section <code class="directive"><LimitExcept></code> doit toujours être préférée à + une section <code class="directive"><Limit></code> pour la + restriction d'accès, car une section <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> fournit une protection contre + les méthodes arbitraires.</div> - <p>The <code class="directive"><Limit></code> and + <p>Les directives <code class="directive"><Limit></code> et <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> - directives may be nested. In this case, each successive level of - <code class="directive"><Limit></code> or <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> directives must - further restrict the set of methods to which access controls apply.</p> - - <div class="warning">When using - <code class="directive"><Limit></code> or - <code class="directive"><LimitExcept></code> directives with - the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive, - note that the first <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> - to succeed authorizes the request, regardless of the presence of other - <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directives.</div> - - <p>For example, given the following configuration, all users will - be authorized for <code>POST</code> requests, and the - <code>Require group editors</code> directive will be ignored - in all cases:</p> + peuvent être imbriquées. Dans ce cas, pour chaque niveau des + directives <code class="directive"><Limit></code> ou <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>, ces dernières + doivent restreindre l'accès pour les méthodes auxquelles les + contrôles d'accès s'appliquent.</p> + + <div class="warning">Lorsqu'on utilise les directives <code class="directive"><Limit></code> ou <code class="directive"><LimitExcept></code> avec la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, la première directive + <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> dont la + condition est satisfaite autorise la requête, sans tenir compte de + la présence d'autres directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.</div> + + <p>Par exemple, avec la configuration suivante, tous les + utilisateurs seront autorisés à effectuer des requêtes + <code>POST</code>, et la directive <code>Require group + editors</code> sera ignorée dans tous les cas :</p> <pre class="prettyprint lang-config"><LimitExcept GET> Require valid-user @@ -2718,24 +2894,27 @@ methods</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitexcept" id="limitexcept">Directive</a> <a name="LimitExcept" id="LimitExcept"><LimitExcept></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access controls to all HTTP methods -except the named ones</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ... +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique les contrôles d'accès à toutes les méthodes HTTP, +sauf celles qui sont spécifiées</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><LimitExcept <var>méthode</var> [<var>méthode</var>] ... > ... </LimitExcept></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig, Limit</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><code class="directive"><LimitExcept></code> and - <code></LimitExcept></code> are used to enclose - a group of access control directives which will then apply to any - HTTP access method <strong>not</strong> listed in the arguments; - i.e., it is the opposite of a <code class="directive"><a href="#limit"><Limit></a></code> section and can be used to control - both standard and nonstandard/unrecognized methods. See the - documentation for <code class="directive"><a href="#limit"><Limit></a></code> for more details.</p> - - <p>For example:</p> + <p><code class="directive"><LimitExcept></code> et + <code></LimitExcept></code> permettent de regrouper des + directives de contrôle d'accès qui s'appliqueront à toutes les + méthodes d'accès HTTP qui ne font <strong>pas</strong> partie de la + liste des arguments ; en d'autres termes, elles ont un comportement + opposé à celui de la section <code class="directive"><a href="#limit"><Limit></a></code>, et on peut les utiliser pour + contrôler aussi bien les méthodes standards que les méthodes non + standards ou non reconnues. Voir la documentation de la section + <code class="directive"><a href="#limit"><Limit></a></code> pour plus + de détails.</p> + + <p>Par exemple :</p> <pre class="prettyprint lang-config"><LimitExcept POST GET> Require valid-user @@ -2747,30 +2926,33 @@ except the named ones</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a> <a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine maximum number of internal redirects and nested -subrequests</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le nombre maximal de redirections internes et de +sous-requêtes imbriquées</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>nombre</var> [<var>nombre</var>]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitInternalRecursion 10</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>An internal redirect happens, for example, when using the <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> directive, which internally - redirects the original request to a CGI script. A subrequest is Apache httpd's - mechanism to find out what would happen for some URI if it were requested. - For example, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> uses subrequests to look for the - files listed in the <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> - directive.</p> - - <p><code class="directive">LimitInternalRecursion</code> prevents the server - from crashing when entering an infinite loop of internal redirects or - subrequests. Such loops are usually caused by misconfigurations.</p> - - <p>The directive stores two different limits, which are evaluated on - per-request basis. The first <var>number</var> is the maximum number of - internal redirects that may follow each other. The second <var>number</var> - determines how deeply subrequests may be nested. If you specify only one - <var>number</var>, it will be assigned to both limits.</p> + <p>Une redirection interne survient, par exemple, quand on utilise + la directive <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> qui + redirige en interne la requête d'origine vers un script CGI. Une + sous-requête est le mécanisme qu'utilise Apache httpd pour déterminer ce + qui se passerait pour un URI s'il faisait l'objet d'une requête. Par + exemple, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> utilise les sous-requêtes pour + rechercher les fichiers listés dans la directive <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p> + + <p>La directive <code class="directive">LimitInternalRecursion</code> permet + d'éviter un crash du serveur dû à un bouclage infini de redirections + internes ou de sous-requêtes. De tels bouclages sont dus en général + à des erreurs de configuration.</p> + + <p>La directive accepte, comme arguments, deux limites qui sont + évaluées à chaque requête. Le premier <var>nombre</var> est le + nombre maximum de redirections internes qui peuvent se succéder. Le + second <var>nombre</var> détermine la profondeur d'imbrication + maximum des sous-requêtes. Si vous ne spécifiez qu'un seul + <var>nombre</var>, il sera affecté aux deux limites.</p> <pre class="prettyprint lang-config">LimitInternalRecursion 5</pre> @@ -2779,47 +2961,51 @@ subrequests</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestbody" id="limitrequestbody">Directive</a> <a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restricts the total size of the HTTP request body sent -from the client</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>limite la taille maximale du corps de la requête HTTP +envoyée par le client</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>octets</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestBody 0</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive specifies the number of <var>bytes</var> from 0 - (meaning unlimited) to 2147483647 (2GB) that are allowed in a - request body. See the note below for the limited applicability - to proxy requests.</p> - - <p>The <code class="directive">LimitRequestBody</code> directive allows - the user to set a limit on the allowed size of an HTTP request - message body within the context in which the directive is given - (server, per-directory, per-file or per-location). If the client - request exceeds that limit, the server will return an error - response instead of servicing the request. The size of a normal - request message body will vary greatly depending on the nature of - the resource and the methods allowed on that resource. CGI scripts - typically use the message body for retrieving form information. - Implementations of the <code>PUT</code> method will require - a value at least as large as any representation that the server - wishes to accept for that resource.</p> - - <p>This directive gives the server administrator greater - control over abnormal client request behavior, which may be - useful for avoiding some forms of denial-of-service - attacks.</p> - - <p>If, for example, you are permitting file upload to a particular - location and wish to limit the size of the uploaded file to 100K, - you might use the following directive:</p> + <p>Cette directive spécifie la taille maximale autorisée pour le + corps d'une requête ; la valeur de l'argument <var>octets</var> va + de 0 (pour une taille illimitée), à 2147483647 (2Go). Voir la note + ci-dessous pour la limite d'applicabilité aux requêtes mandatées.</p> + + <p>La directive <code class="directive">LimitRequestBody</code> permet de + définir une limite pour la taille maximale autorisée du corps d'une + requête HTTP en tenant compte du contexte dans lequel la directive + a été placée (c'est à dire au niveau du serveur, d'un répertoire, + d'un fichier ou d'une localisation). Si la requête du client dépasse + cette limite, le serveur répondra par un message d'erreur et ne + traitera pas la requête. La taille du corps d'une requête normale va + varier de manière importante en fonction de la nature de la + ressource et des méthodes autorisées pour cette dernière. Les + scripts CGI utilisent souvent le corps du message pour extraire les + informations d'un formulaire. Les implémentations de la méthode + <code>PUT</code> nécessitent une valeur au moins aussi élevée que la + taille maximale des représentations que le serveur désire accepter + pour cette ressource.</p> + + <p>L'administrateur du serveur peut utiliser cette directive pour + contrôler plus efficacement les comportements anormaux des requêtes + des clients, ce qui lui permettra de prévenir certaines formes + d'attaques par déni de service.</p> + + <p>Si par exemple, vous autorisez le chargement de fichiers vers une + localisation particulière, et souhaitez limiter la taille des + fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante + :</p> <pre class="prettyprint lang-config">LimitRequestBody 102400</pre> - <div class="note"><p>For a full description of how this directive is interpreted by - proxy requests, see the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> documentation.</p> + <div class="note"><p>Pour une description détaillée de la manière dont cette + directive est interprétée par les requêtes mandatées, voir la + documentation du module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p> </div> @@ -2827,133 +3013,141 @@ from the client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestfields" id="limitrequestfields">Directive</a> <a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of HTTP request header fields that -will be accepted from the client</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de champs d'en-tête autorisés dans une +requête HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>nombre</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFields 100</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><var>Number</var> is an integer from 0 (meaning unlimited) to - 32767. The default value is defined by the compile-time - constant <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 as - distributed).</p> - - <p>The <code class="directive">LimitRequestFields</code> directive allows - the server administrator to modify the limit on the number of - request header fields allowed in an HTTP request. A server needs - this value to be larger than the number of fields that a normal - client request might include. The number of request header fields - used by a client rarely exceeds 20, but this may vary among - different client implementations, often depending upon the extent - to which a user has configured their browser to support detailed - content negotiation. Optional HTTP extensions are often expressed - using request header fields.</p> - - <p>This directive gives the server administrator greater - control over abnormal client request behavior, which may be - useful for avoiding some forms of denial-of-service attacks. - The value should be increased if normal clients see an error - response from the server that indicates too many fields were - sent in the request.</p> - - <p>For example:</p> + <p><var>nombre</var> est un entier de 0 (nombre de champs illimité) + à 32767. La valeur par défaut est définie à la compilation par la + constante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 selon la + distribution).</p> + + <p>La directive <code class="directive">LimitRequestFields</code> permet à + l'administrateur du serveur de modifier le nombre maximum de champs + d'en-tête autorisés dans une requête HTTP. Pour un serveur, cette + valeur doit être supérieure au nombre de champs qu'une requête + client normale peut contenir. Le nombre de champs d'en-tête d'une + requête qu'un client utilise dépasse rarement 20, mais ce nombre + peut varier selon les implémentations des clients, et souvent en + fonction des extensions que les utilisateurs configurent dans leurs + navigateurs pour supporter la négociation de contenu détaillée. Les + extensions HTTP optionnelles utilisent souvent les + champs d'en-tête des requêtes.</p> + + <p>L'administrateur du serveur peut utiliser cette directive pour + contrôler plus efficacement les comportements anormaux des requêtes + des clients, ce qui lui permettra de prévenir certaines formes + d'attaques par déni de service. La valeur spécifiée doit être + augmentée si les clients standards reçoivent une erreur du serveur + indiquant que la requête comportait un nombre d'en-têtes trop + important.</p> + + <p>Par exemple :</p> <pre class="prettyprint lang-config">LimitRequestFields 50</pre> - <div class="warning"><h3>Warning</h3> - <p> When name-based virtual hosting is used, the value for this - directive is taken from the default (first-listed) virtual host for the - local IP and port combination.</p> - </div> + <div class="warning"><h3>Avertissement</h3> + <p>Dans le cas des serveurs virtuels à base de noms, la valeur de + cette directive est extraite du serveur virtuel par défaut (le + premier de la liste) pour la paire adresse IP/port.</p> + </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a> <a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of the HTTP request header allowed from the -client</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dédinit la taille maximale autorisée d'un en-tête de +requête HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>octets</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive specifies the number of <var>bytes</var> - that will be allowed in an HTTP request header.</p> - - <p>The <code class="directive">LimitRequestFieldSize</code> directive - allows the server administrator to set the limit - on the allowed size of an HTTP request header field. A server - needs this value to be large enough to hold any one header field - from a normal client request. The size of a normal request header - field will vary greatly among different client implementations, - often depending upon the extent to which a user has configured - their browser to support detailed content negotiation. SPNEGO - authentication headers can be up to 12392 bytes.</p> - - <p>This directive gives the server administrator greater - control over abnormal client request behavior, which may be - useful for avoiding some forms of denial-of-service attacks.</p> - - <p>For example:</p> + <p>Cette directive permet de définir le nombre maximum + d'<var>octets</var> autorisés dans un en-tête de requête HTTP.</p> + + <p>La directive <code class="directive">LimitRequestFieldSize</code> permet + à l'administrateur du serveur de définir la taille + maximale autorisée d'un en-tête de requête HTTP. Pour un serveur, + cette valeur doit être suffisamment grande pour contenir tout + en-tête d'une requête client normale. La taille d'un champ d'en-tête + de requête normal va varier selon les implémentations des clients, + et en fonction des extensions que les utilisateurs + configurent dans leurs navigateurs pour supporter la négociation de + contenu détaillée. Les en-têtes d'authentification SPNEGO peuvent + atteindre une taille de 12392 octets.</p> + + <p>>L'administrateur du serveur peut utiliser cette directive pour + contrôler plus efficacement les comportements anormaux des requêtes + des clients, ce qui lui permettra de prévenir certaines formes + d'attaques par déni de service.</p> + + <p>Par exemple ::</p> <pre class="prettyprint lang-config">LimitRequestFieldSize 4094</pre> - <div class="note">Under normal conditions, the value should not be changed from - the default.</div> + <div class="note">Dans des conditions normales, la valeur par défaut de cette + directive ne doit pas être modifiée.</div> - <div class="warning"><h3>Warning</h3> - <p> When name-based virtual hosting is used, the value for this - directive is taken from the default (first-listed) virtual host best - matching the current IP address and port combination.</p> + <div class="warning"><h3>Avertissement</h3> + <p>Dans le cas des serveurs virtuels à base de noms, la valeur de + cette directive est extraite du serveur virtuel par défaut (le + premier de la liste) pour lequel la paire adresse IP/port + correspond le mieux.</p> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestline" id="limitrequestline">Directive</a> <a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit the size of the HTTP request line that will be accepted -from the client</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale d'une ligne de requête +HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>octets</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestLine 8190</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive sets the number of <var>bytes</var> that will be - allowed on the HTTP request-line.</p> - - <p>The <code class="directive">LimitRequestLine</code> directive allows - the server administrator to set the limit on the allowed size - of a client's HTTP request-line. Since the request-line consists of the - HTTP method, URI, and protocol version, the - <code class="directive">LimitRequestLine</code> directive places a - restriction on the length of a request-URI allowed for a request - on the server. A server needs this value to be large enough to - hold any of its resource names, including any information that - might be passed in the query part of a <code>GET</code> request.</p> - - <p>This directive gives the server administrator greater - control over abnormal client request behavior, which may be - useful for avoiding some forms of denial-of-service attacks.</p> - - <p>For example:</p> + <p>Cette directive permet de définir la taille maximale autorisée + pour une ligne de requête HTTP en <var>octets</var>.</p> + + <p>La directive <code class="directive">LimitRequestLine</code> permet à + l'administrateur du serveur de définir la taille + maximale autorisée d'une ligne de requête HTTP client. Comme une + requête comporte une méthode HTTP, un URI, et une version de + protocole, la directive <code class="directive">LimitRequestLine</code> + impose une restriction sur la longueur maximale autorisée pour un + URI dans une requête au niveau du serveur. Pour un serveur, cette + valeur doit être suffisamment grande pour référencer les noms de + toutes ses ressources, y compris toutes informations pouvant être + ajoutées dans la partie requête d'une méthode <code>GET</code>.</p> + + <p>L'administrateur du serveur peut utiliser cette directive pour + contrôler plus efficacement les comportements anormaux des requêtes + des clients, ce qui lui permettra de prévenir certaines formes + d'attaques par déni de service.</p> + + <p>Par exemple :</p> <pre class="prettyprint lang-config">LimitRequestLine 4094</pre> - <div class="note">Under normal conditions, the value should not be changed from - the default.</div> + <div class="note">Dans des conditions normales, cette directive doit conserver + sa valeur par défaut.</div> - <div class="warning"><h3>Warning</h3> - <p> When name-based virtual hosting is used, the value for this - directive is taken from the default (first-listed) virtual host best - matching the current IP address and port combination.</p> + <div class="warning"><h3>Avertissement</h3> + <p>Dans le cas des serveurs virtuels à base de noms, la valeur de + cette directive est extraite du serveur virtuel par défaut (le + premier de la liste) pour lequel la paire adresse IP/port + correspond le mieux.</p> </div> @@ -2961,18 +3155,20 @@ from the client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a> <a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the size of an XML-based request body</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale du corps d'une requête au format +XML</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>octets</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Limit (in bytes) on maximum size of an XML-based request - body. A value of <code>0</code> will disable any checking.</p> + <p>Taille maximale (en octets) du corps d'une requête au format XML. + Une valeur de <code>0</code> signifie qu'aucune limite n'est + imposée.</p> - <p>Example:</p> + <p>Exemple :</p> <pre class="prettyprint lang-config">LimitXMLRequestBody 0</pre> @@ -2982,101 +3178,114 @@ from the client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="location" id="location">Directive</a> <a name="Location" id="Location"><Location></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to matching -URLs</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs +spécifiées</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Location - <var>URL-path</var>|<var>URL</var>> ... </Location></code></td></tr> + <var>chemin URL</var>|<var>URL</var>> ... </Location></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive"><Location></code> directive - limits the scope of the enclosed directives by URL. It is similar to the - <code class="directive"><a href="#directory"><Directory></a></code> - directive, and starts a subsection which is terminated with a - <code></Location></code> directive. <code class="directive"><Location></code> sections are processed in the - order they appear in the configuration file, after the <code class="directive"><a href="#directory"><Directory></a></code> sections and - <code>.htaccess</code> files are read, and after the <code class="directive"><a href="#files"><Files></a></code> sections.</p> - - <p><code class="directive"><Location></code> sections operate - completely outside the filesystem. This has several consequences. - Most importantly, <code class="directive"><Location></code> - directives should not be used to control access to filesystem - locations. Since several different URLs may map to the same - filesystem location, such access controls may by circumvented.</p> - - <p>The enclosed directives will be applied to the request if the path component - of the URL meets <em>any</em> of the following criteria: + <p>La directive <code class="directive"><Location></code> + limite la portée des directives contenues aux URLs définies par + l'argument URL. Elle est similaire à la directive <code class="directive"><a href="#directory"><Directory></a></code>, et marque le + début d'une section qui se termine par une directive + <code></Location></code>. Les sections <code class="directive"><Location></code> sont traitées selon l'ordre dans + lequel elles apparaissent dans le fichier de configuration, mais + après les sections <code class="directive"><a href="#directory"><Directory></a></code> et la lecture des + fichiers <code>.htaccess</code>, et après les sections <code class="directive"><a href="#files"><Files></a></code>.</p> + + <p>Les sections <code class="directive"><Location></code> + agissent complètement en dehors du système de fichiers. Ceci a de + nombreuses conséquences. Parmi les plus importantes, on ne doit pas + utiliser les sections <code class="directive"><Location></code> + pour contrôler l'accès aux répertoires du système de fichiers. Comme + plusieurs URLs peuvent correspondre au même répertoire du système de + fichiers, un tel contrôle d'accès pourrait être contourné.</p> + + <p>Les directives que contient cette section seront appliquées aux + requêtes si la partie chemin de l'URL satisfait à l'un au moins de + ces critères : </p> <ul> - <li>The specified location matches exactly the path component of the URL. + <li>Le chemin spécifié correspond exactement à la partie chemin de + l'URL. </li> - <li>The specified location, which ends in a forward slash, is a prefix - of the path component of the URL (treated as a context root). + <li>Le chemin spécifié, qui se termine par un slash, est un + préfixe de la partie chemin de l'URL (traité comme une racine du + contexte). </li> - <li>The specified location, with the addition of a trailing slash, is a - prefix of the path component of the URL (also treated as a context root). + <li>Le chemin spécifié, si on lui ajoute un slash de fin, est un + préfixe de la partie chemin de l'URL (aussi traité comme une racine du + contexte). </li> </ul> <p> - In the example below, where no trailing slash is used, requests to - /private1, /private1/ and /private1/file.txt will have the enclosed - directives applied, but /private1other would not. + Dans l'exemple ci-dessous, où aucun slash de fin n'est utilisé, les + directives contenues dans la section s'appliqueront à /private1, + /private1/ et /private1/file.txt, mais pas à /private1other. </p> <pre class="prettyprint lang-config"><Location "/private1"> # ... </Location></pre> <p> - In the example below, where a trailing slash is used, requests to - /private2/ and /private2/file.txt will have the enclosed - directives applied, but /private2 and /private2other would not. + De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les + directives contenues dans la section s'appliqueront à /private2/ et + à /private2/file.txt, mais pas à /private2other. </p> <pre class="prettyprint lang-config"><Location "/private2<em>/</em>"> # ... </Location></pre> - - <div class="note"><h3>When to use <code class="directive"><Location></code></h3> - - <p>Use <code class="directive"><Location></code> to apply - directives to content that lives outside the filesystem. For - content that lives in the filesystem, use <code class="directive"><a href="#directory"><Directory></a></code> and <code class="directive"><a href="#files"><Files></a></code>. An exception is - <code><Location "/"></code>, which is an easy way to - apply a configuration to the entire server.</p> + + <div class="note"><h3>Quand utiliser la section <code class="directive"><Location></code></h3> + + <p>Vous pouvez utiliser une section <code class="directive"><Location></code> pour appliquer des directives à + des contenus situés en dehors du système de fichiers. Pour les + contenus situés à l'intérieur du système de fichiers, utilisez + plutôt les sections <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#files"><Files></a></code>. <code><Location + "/"></code> constitue une exception et permet d'appliquer aisément + une configuration à l'ensemble du serveur.</p> </div> - <p>For all origin (non-proxy) requests, the URL to be matched is a - URL-path of the form <code>/path/</code>. <em>No scheme, hostname, - port, or query string may be included.</em> For proxy requests, the - URL to be matched is of the form - <code>scheme://servername/path</code>, and you must include the - prefix.</p> + <p>Pour toutes les requêtes originales (non mandatées), l'argument + URL est un chemin d'URL de la forme + <code>/chemin/</code>. <em>Aucun protocole, nom d'hôte, port, ou chaîne + de requête ne doivent apparaître.</em> Pour les requêtes mandatées, l'URL + spécifiée doit être de la forme + <code>protocole://nom_serveur/chemin</code>, et vous devez inclure + le préfixe.</p> - <p>The URL may use wildcards. In a wild-card string, <code>?</code> matches - any single character, and <code>*</code> matches any sequences of - characters. Neither wildcard character matches a / in the URL-path.</p> + <p>L'URL peut contenir des caractères génériques. Dans une chaîne + avec caractères génériques, <code>?</code> correspond à un caractère + quelconque, et <code>*</code> à toute chaîne de caractères. Les + caractères génériques ne peuvent pas remplacer un / dans le chemin + URL.</p> - <p><a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Regular expressions</a> - can also be used, with the addition of the <code>~</code> - character. For example:</p> + <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions + rationnelles</a>, moyennant l'addition d'un caractère + <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Location ~ "/(extra|special)/data"> #... </Location></pre> - <p>would match URLs that contained the substring <code>/extra/data</code> - or <code>/special/data</code>. The directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> behaves - identical to the regex version of <code class="directive"><Location></code>, and is preferred, for the - simple reason that <code>~</code> is hard to distinguish from - <code>-</code> in many fonts.</p> + <p>concernerait les URLs contenant les sous-chaîne + <code>/extra/data</code> ou <code>/special/data</code>. La directive + <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> + présente un comportement identique à la version avec expressions + rationnelles de la directive <code class="directive"><Location></code>, et son utilisation est + préférable à l'utilisation de cette dernière pour la simple raison + qu'il est difficile de distinguer <code>~</code> de <code>-</code> + dans la plupart des fontes.</p> - <p>The <code class="directive"><Location></code> - functionality is especially useful when combined with the - <code class="directive"><a href="#sethandler">SetHandler</a></code> - directive. For example, to enable status requests but allow them - only from browsers at <code>example.com</code>, you might use:</p> + <p>La directive <code class="directive"><Location></code> + s'utilise principalement avec la directive <code class="directive"><a href="#sethandler">SetHandler</a></code>. Par exemple, pour activer les + requêtes d'état, mais ne les autoriser que depuis des navigateurs + appartenant au domaine <code>example.com</code>, vous pouvez + utiliser :</p> <pre class="prettyprint lang-config"><Location "/status"> SetHandler server-status @@ -3084,119 +3293,129 @@ URLs</td></tr> </Location></pre> - <div class="note"><h3>Note about / (slash)</h3> - <p>The slash character has special meaning depending on where in a - URL it appears. People may be used to its behavior in the filesystem - where multiple adjacent slashes are frequently collapsed to a single - slash (<em>i.e.</em>, <code>/home///foo</code> is the same as - <code>/home/foo</code>). In URL-space this is not necessarily true. - The <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> - directive and the regex version of <code class="directive"><Location></code> require you to explicitly specify multiple - slashes if that is your intention.</p> - - <p>For example, <code><LocationMatch "^/abc"></code> would match - the request URL <code>/abc</code> but not the request URL <code> - //abc</code>. The (non-regex) <code class="directive"><Location></code> directive behaves similarly when used for - proxy requests. But when (non-regex) <code class="directive"><Location></code> is used for non-proxy requests it will - implicitly match multiple slashes with a single slash. For example, - if you specify <code><Location "/abc/def"></code> and the - request is to <code>/abc//def</code> then it will match.</p> + <div class="note"><h3>Note à propos du slash (/)</h3> + <p>La signification du caractère slash dépend de l'endroit où il + se trouve dans l'URL. Les utilisateurs peuvent être habitués à + son comportement dans le système de fichiers où plusieurs slashes + successifs sont souvent réduits à un slash unique (en d'autres + termes, <code>/home///foo</code> est identique à + <code>/home/foo</code>). Dans l'espace de nommage des URLs, ce + n'est cependant pas toujours le cas. Pour la directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> et la + version avec expressions rationnelles de la directive <code class="directive"><Location></code>, vous devez spécifier + explicitement les slashes multiples si telle est votre + intention.</p> + + <p>Par exemple, <code><LocationMatch "^/abc"></code> va + correspondre à l'URL <code>/abc</code> mais pas à l'URL <code> + //abc</code>. La directive <code class="directive"><Location></code> sans expression rationnelle se comporte de + la même manière lorsqu'elle est utilisée pour des requêtes + mandatées. Par contre, lorsque la directive <code class="directive"><Location></code> sans expression rationnelle + est utilisée pour des requêtes non mandatées, elle fera + correspondre implicitement les slashes multiples à des slashes + uniques. Par exemple, si vous spécifiez <code><Location + "/abc/def"></code>, une requête de la forme + <code>/abc//def</code> correspondra.</p> </div> <h3>Voir aussi</h3> <ul> -<li><a href="../sections.html">How <Directory>, <Location> - and <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received.</li> -<li><code class="directive"><a href="#locationmatch">LocationMatch</a></code></li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête.</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="locationmatch" id="locationmatch">Directive</a> <a name="LocationMatch" id="LocationMatch"><LocationMatch></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applies the enclosed directives only to regular-expression -matching URLs</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs +correspondant à une expression rationnelle</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><LocationMatch <var>regex</var>> ... </LocationMatch></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive"><LocationMatch></code> directive - limits the scope of the enclosed directives by URL, in an identical manner - to <code class="directive"><a href="#location"><Location></a></code>. However, - it takes a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a> - as an argument instead of a simple string. For example:</p> + <p>La directive <code class="directive"><LocationMatch></code> + limite la portée des directives contenues à l'URL spécifiée, de + manière identique à la directive <code class="directive"><a href="#location"><Location></a></code>. Mais son argument permettant de + spécifier les URLs concernées est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> au lieu d'une simple + chaîne de caractères. Par exemple :</p> <pre class="prettyprint lang-config"><LocationMatch "/(extra|special)/data"> # ... </LocationMatch></pre> - <p>would match URLs that contained the substring <code>/extra/data</code> - or <code>/special/data</code>.</p> + <p>correspondrait à toute URL contenant les sous-chaînes + <code>/extra/data</code> ou <code>/special/data</code>.</p> - <div class="note"><p>If the intent is that a URL <strong>starts with</strong> - <code>/extra/data</code>, rather than merely - <strong>contains</strong> <code>/extra/data</code>, prefix the - regular expression with a <code>^</code> to require this.</p> + <div class="note"><p>Si vous recherchez une URL <strong>commençant par</strong> + plutôt que seulement contenant <code>/extra/data</code>, préfixez + l'expression rationnelle avec un <code>^</code>.</p> <pre class="prettyprint lang-config"><LocationMatch "^/(extra|special)/data"></pre> </div> - <p>From 2.4.8 onwards, named groups and backreferences are captured and - written to the environment with the corresponding name prefixed with - "MATCH_" and in upper case. This allows elements of URLs to be referenced - from within <a href="../expr.html">expressions</a> and modules like - <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. In order to prevent confusion, numbered - (unnamed) backreferences are ignored. Use named groups instead.</p> - - <pre class="prettyprint lang-config"><LocationMatch "^/combined/(?<sitename>[^/]+)"> + <p>A partir de la version 2.4.8, les groupes nommés et les + références arrières sont extraits et enregistrés dans + l'environnement avec leur nom en majuscules et préfixé + par "MATCH_". Ceci permet + de référencer des URLs dans des <a href="../expr.html">expressions</a> + ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour + éviter toute confusion, les références arrières numérotées (non + nommées) sont ignorées. Vous devez utiliser à la place des groupes + nommés.</p> + +<pre class="prettyprint lang-config"><LocationMatch "^/combined/(?<sitename>[^/]+)"> require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </LocationMatch></pre> - + <h3>Voir aussi</h3> <ul> -<li><a href="../sections.html">How <Directory>, <Location> - and <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received</li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête.</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="loglevel" id="loglevel">Directive</a> <a name="LogLevel" id="LogLevel">LogLevel</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the verbosity of the ErrorLog</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel [<var>module</var>:]<var>level</var> - [<var>module</var>:<var>level</var>] ... +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la verbosité du journal des erreurs</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel [<var>module</var>:]<var>niveau</var> + [<var>module</var>:<var>niveau</var>] ... </code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogLevel warn</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Per-module and per-directory configuration is available in - Apache HTTP Server 2.3.6 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La configuration du niveau de journalisation par module +et par répertoire est disponible depuis la version 2.3.6 du serveur HTTP +Apache</td></tr> </table> - <p><code class="directive">LogLevel</code> adjusts the verbosity of the - messages recorded in the error logs (see <code class="directive"><a href="#errorlog">ErrorLog</a></code> directive). The following - <var>level</var>s are available, in order of decreasing - significance:</p> + <p>La directive <code class="directive">LogLevel</code> permet d'ajuster la + verbosité des messages enregistrés dans les journaux d'erreur (voir + la directive <code class="directive"><a href="#errorlog">ErrorLog</a></code> + directive). Les <var>niveau</var>x disponibles sont présentés + ci-après, par ordre de criticité décroissante :</p> <table class="bordered"> <tr> - <th><strong>Level</strong> </th> + <th><strong>Niveau</strong> </th> <th><strong>Description</strong> </th> - <th><strong>Example</strong> </th> + <th><strong>Exemple</strong> </th> </tr> <tr> <td><code>emerg</code> </td> - <td>Emergencies - system is unusable.</td> + <td>Urgences - le système est inutilisable.</td> <td>"Child cannot open lock file. Exiting"</td> </tr> @@ -3204,7 +3423,7 @@ matching URLs</td></tr> <tr> <td><code>alert</code> </td> - <td>Action must be taken immediately.</td> + <td>Des mesures doivent être prises immédiatement.</td> <td>"getpwuid: couldn't determine user name from uid"</td> </tr> @@ -3212,7 +3431,7 @@ matching URLs</td></tr> <tr> <td><code>crit</code> </td> - <td>Critical Conditions.</td> + <td>Conditions critiques.</td> <td>"socket: Failed to get a socket, exiting child"</td> </tr> @@ -3220,7 +3439,7 @@ matching URLs</td></tr> <tr> <td><code>error</code> </td> - <td>Error conditions.</td> + <td>Erreurs.</td> <td>"Premature end of script headers"</td> </tr> @@ -3228,7 +3447,7 @@ matching URLs</td></tr> <tr> <td><code>warn</code> </td> - <td>Warning conditions.</td> + <td>Avertissements.</td> <td>"child process 1234 did not exit, sending another SIGHUP"</td> @@ -3237,7 +3456,7 @@ matching URLs</td></tr> <tr> <td><code>notice</code> </td> - <td>Normal but significant condition.</td> + <td>Evènement important mais normal.</td> <td>"httpd: caught SIGBUS, attempting to dump core in ..."</td> @@ -3246,7 +3465,7 @@ matching URLs</td></tr> <tr> <td><code>info</code> </td> - <td>Informational.</td> + <td>Informations.</td> <td>"Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..."</td> @@ -3255,103 +3474,106 @@ matching URLs</td></tr> <tr> <td><code>debug</code> </td> - <td>Debug-level messages</td> + <td>Messages de débogage.</td> <td>"Opening config file ..."</td> </tr> <tr> <td><code>trace1</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"proxy: FTP: control connection complete"</td> </tr> <tr> <td><code>trace2</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"proxy: CONNECT: sending the CONNECT request to the remote proxy"</td> </tr> <tr> <td><code>trace3</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"openssl: Handshake: start"</td> </tr> <tr> <td><code>trace4</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"read from buffered SSL brigade, mode 0, 17 bytes"</td> </tr> <tr> <td><code>trace5</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"map lookup FAILED: map=rewritemap key=keyname"</td> </tr> <tr> <td><code>trace6</code> </td> - <td>Trace messages</td> + <td>Messages de traces</td> <td>"cache lookup FAILED, forcing new map lookup"</td> </tr> <tr> <td><code>trace7</code> </td> - <td>Trace messages, dumping large amounts of data</td> + <td>Messages de traces, enregistrement d'une grande quantité de + données</td> <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td> </tr> <tr> <td><code>trace8</code> </td> - <td>Trace messages, dumping large amounts of data</td> + <td>Messages de traces, enregistrement d'une grande quantité de + données</td> <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td> </tr> </table> - <p>When a particular level is specified, messages from all - other levels of higher significance will be reported as well. - <em>E.g.</em>, when <code>LogLevel info</code> is specified, - then messages with log levels of <code>notice</code> and - <code>warn</code> will also be posted.</p> + <p>Lorsqu'un niveau particulier est spécifié, les messages de tous + les autres niveaux de criticité supérieure seront aussi enregistrés. + <em>Par exemple</em>, si <code>LogLevel info</code> est spécifié, + les messages de niveaux <code>notice</code> et <code>warn</code> + seront aussi émis.</p> - <p>Using a level of at least <code>crit</code> is - recommended.</p> + <p>Il est recommandé d'utiliser un niveau <code>crit</code> ou + inférieur.</p> - <p>For example:</p> + <p>Par exemple :</p> <pre class="prettyprint lang-config">LogLevel notice</pre> <div class="note"><h3>Note</h3> - <p>When logging to a regular file, messages of the level - <code>notice</code> cannot be suppressed and thus are always - logged. However, this doesn't apply when logging is done - using <code>syslog</code>.</p> + <p>Si la journalisation s'effectue directement dans un fichier, + les messages de niveau <code>notice</code> ne peuvent pas être + supprimés et sont donc toujours journalisés. Cependant, ceci ne + s'applique pas lorsque la journalisation s'effectue vers + <code>syslog</code>.</p> </div> - - <p>Specifying a level without a module name will reset the level - for all modules to that level. Specifying a level with a module - name will set the level for that module only. It is possible to - use the module source file name, the module identifier, or the - module identifier with the trailing <code>_module</code> omitted - as module specification. This means the following three specifications - are equivalent:</p> + + <p>Spécifier un niveau sans nom de module va attribuer ce niveau à + tous les modules. Spécifier un niveau avec nom de module va + attribuer ce niveau à ce module seulement. Il est possible de + spécifier un module par le nom de son fichier source ou par son + identificateur, avec ou sans le suffixe <code>_module</code>. Les + trois spécifications suivantes sont donc équivalentes :</p> <pre class="prettyprint lang-config">LogLevel info ssl:warn LogLevel info mod_ssl.c:warn LogLevel info ssl_module:warn</pre> - <p>It is also possible to change the level per directory:</p> + <p>Il est aussi possible d'attribuer un niveau de journalisation par + répertoire :</p> <pre class="prettyprint lang-config">LogLevel info <Directory "/usr/local/apache/htdocs/app"> @@ -3360,12 +3582,12 @@ LogLevel info ssl_module:warn</pre> <div class="note"> - Per directory loglevel configuration only affects messages that are - logged after the request has been parsed and that are associated with - the request. Log messages which are associated with the server or - the connection are not affected. The latter can be influenced by the - <code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code> directive, - though. + La configuration du niveau de journalisation par répertoire + n'affecte que les messages journalisés après l'interprétation de + la requête et qui sont associés à cette dernière. Les messages + de journalisation associés au serveur ou à la connexion ne sont + pas affectés. Il est cependant possible d'agir sur ces + derniers à l'aide de la directive <code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code>. </div> <h3>Voir aussi</h3> @@ -3373,52 +3595,53 @@ LogLevel info ssl_module:warn</pre> <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li> <li><code class="directive"><a href="#errorlogformat">ErrorLogFormat</a></code></li> <li><code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code></li> -<li><a href="../logs.html">Apache HTTP Server Log Files</a></li> +<li><a href="../logs.html">Journaux du serveur HTTP Apache</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="logleveloverride" id="logleveloverride">Directive</a> <a name="LogLevelOverride" id="LogLevelOverride">LogLevelOverride</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the verbosity of the ErrorLog for certain clients</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Surcharge la verbosité du journal des erreurs pour certains +clients</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel <var>ipaddress</var>[/<var>prefixlen</var>] [<var>module</var>:]<var>level</var> [<var>module</var>:<var>level</var>] ... </code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>unset</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>non définie</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.5.0 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.0 du serveur HTTP +Apache.</td></tr> </table> - <p><code class="directive">LogLevelOverride</code> adjusts the - <code class="directive"><a href="#loglevel">LogLevel</a></code> for requests coming from - certain client IP addresses. - This allows to enable verbose logging only for certain test clients. - The IP address is checked at a very early state in the connection - processing. Therefore, <code class="directive">LogLevelOverride</code> allows to - change the log level for things like the SSL handshake which happen before - a <code class="directive"><a href="#loglevel">LogLevel</a></code> directive in an - <code class="directive"><a href="#if"><If></a></code> container would - be evaluated.</p> + <p>La directive <code class="directive">LogLevelOverride</code> permet + d'affiner la définition de la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> pour les requêtes en provenance + de certaines adresses IP. Il est ainsi possible d'activer une + journalisation détaillée seulement pour certains clients à des fins + de test. Les adresses IP sont vérifiées à un stade très précoce du + processus de connexion. Ainsi, la directive + <code class="directive">LogLevelOverride</code> permet de modifier le niveau + de journalisation pour des processus comme la négociation SSL qui + intervient avant l'évaluation d'une éventuelle directive <code class="directive"><a href="#loglevel">LogLevel</a></code> au sein d'un conteneur <code class="directive"><a href="#if"><If></a></code>.</p> - <p><code class="directive">LogLevelOverride</code> accepts either a single - IP-address or a CIDR IP-address/len subnet specification. - For the syntax of the loglevel specification, see the - <code class="directive"><a href="#loglevel">LogLevel</a></code> directive.</p> + <p>La directive <code class="directive">LogLevelOverride</code> accepte soit + une adresse IP simple, soit une spécification de sous-réseau CIDR de + la forme adresse-IP/masque. Pour la syntaxe de la spécification du + niveau de journalisation, voir la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> directive.</p> - <p>For requests that match a <code class="directive">LogLevelOverride</code> - directive, per-directory specifications of - <code class="directive"><a href="#loglevel">LogLevel</a></code> are ignored.</p> + <p>Pour les requêtes concernées par une directive + <code class="directive">LogLevelOverride</code>, les spécifications de + niveau répertoire de la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> sont ignorées.</p> - <p>Examples:</p> + <p>Exemples:</p> - <pre class="prettyprint lang-config"> LogLevelOverride 192.0.2.0/24 ssl:trace6 - LogLevelOverride 192.0.2.7 ssl:trace8</pre> + <pre class="prettyprint lang-config"> LogLevelOverride 192.0.2.0/24 ssl:trace6 + LogLevelOverride 192.0.2.7 ssl:trace8</pre> <div class="note"> - <code class="directive">LogLevelOverride</code> only affects - log messages that are associated with the request or the connection. - Log messages which are associated with the server are not affected. + La directive <code class="directive">LogLevelOverride</code> n'affecte que les + messages associés à la requête ou à la connexion. Les messages + associés au serveur ne sont pas affectés. </div> @@ -3430,22 +3653,22 @@ LogLevel info ssl_module:warn</pre> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a> <a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of requests allowed on a persistent -connection</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de requêtes permises pour une connexion +persistante</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>nombre</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">MaxKeepAliveRequests</code> directive - limits the number of requests allowed per connection when - <code class="directive"><a href="#keepalive">KeepAlive</a></code> is on. If it is - set to <code>0</code>, unlimited requests will be allowed. We - recommend that this setting be kept to a high value for maximum - server performance.</p> + <p>La directive <code class="directive">MaxKeepAliveRequests</code> permet + de limiter le nombre de requêtes autorisées par connexion lorsque + <code class="directive"><a href="#keepalive">KeepAlive</a></code> est à "on". Si sa + valeur est <code>0</code>, le nombre de requêtes autorisées est + illimité. Il est recommandé de définir une valeur assez haute pour + des performances du serveur maximales.</p> - <p>For example:</p> + <p>Par exemple :</p> <pre class="prettyprint lang-config">MaxKeepAliveRequests 500</pre> @@ -3454,340 +3677,375 @@ connection</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a> <a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of overlapping ranges (eg: <code>100-200,150-300</code>) allowed before returning the complete - resource </td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>number-of-ranges</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de chevauchements de segments de données autorisé + (par exemple <code>100-200,150-300</code>) avant le renvoi de la + ressource complète</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>nombre de + chevauchements</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRangeOverlaps 20</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP + Apache</td></tr> </table> - <p>The <code class="directive">MaxRangeOverlaps</code> directive - limits the number of overlapping HTTP ranges the server is willing to - return to the client. If more overlapping ranges than permitted are requested, - the complete resource is returned instead.</p> + <p>La directive <code class="directive">MaxRangeOverlaps</code> permet + de limiter le nombre de chevauchements de segments de données HTTP + autorisé par le serveur. Si le nombre de + chevauchements de segments demandé est supérieur au nombre maximal + autorisé, la ressource sera renvoyée dans son intégralité.</p> <dl> <dt><strong>default</strong></dt> - <dd>Limits the number of overlapping ranges to a compile-time default of 20.</dd> + <dd>Limite le nombre de chevauchements de segments à la valeur + par défaut 20 définie à la compilation.</dd> <dt><strong>none</strong></dt> - <dd>No overlapping Range headers are allowed.</dd> + <dd>Aucun chevauchement de segment n'est autorisé.</dd> <dt><strong>unlimited</strong></dt> - <dd>The server does not limit the number of overlapping ranges it is - willing to satisfy.</dd> + <dd>Le nombre de chevauchements de segments est illimité.</dd> <dt><var>number-of-ranges</var></dt> - <dd>A positive number representing the maximum number of overlapping ranges the - server is willing to satisfy.</dd> + <dd>Un nombre positif représente le nombre maximal de + chevauchements de segments autorisé par le serveur.</dd> </dl> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="maxrangereversals" id="maxrangereversals">Directive</a> <a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of range reversals (eg: <code>100-200,50-70</code>) allowed before returning the complete - resource </td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>number-of-ranges</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre d'inversions d'ordre autorisé dans la spécification des + segments de données (par exemple <code>100-200,50-70</code>) avant le renvoi de la + ressource complète</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>nombre + d'inversions</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRangeReversals 20</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP + Apache</td></tr> </table> - <p>The <code class="directive">MaxRangeReversals</code> directive - limits the number of HTTP Range reversals the server is willing to - return to the client. If more ranges reversals than permitted are requested, - the complete resource is returned instead.</p> + <p>La directive <code class="directive">MaxRangeReversals</code> permet + de limiter le nombre d'inversions d'ordre dans la spécification + des segments de données HTTP + autorisé par le serveur. Si le nombre + d'inversions demandé est supérieur au nombre maximal + autorisé, la ressource sera renvoyée dans son intégralité.</p> <dl> <dt><strong>default</strong></dt> - <dd>Limits the number of range reversals to a compile-time default of 20.</dd> + <dd>Limite le nombre d'inversions à la valeur + par défaut 20 définie à la compilation.</dd> <dt><strong>none</strong></dt> - <dd>No Range reversals headers are allowed.</dd> + <dd>Aucune inversion n'est autorisée.</dd> <dt><strong>unlimited</strong></dt> - <dd>The server does not limit the number of range reversals it is - willing to satisfy.</dd> + <dd>Le nombre d'inversions est illimité.</dd> <dt><var>number-of-ranges</var></dt> - <dd>A positive number representing the maximum number of range reversals the - server is willing to satisfy.</dd> + <dd>Un nombre positif représente le nombre maximal + d'inversions autorisé par le serveur.</dd> </dl> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="maxranges" id="maxranges">Directive</a> <a name="MaxRanges" id="MaxRanges">MaxRanges</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of ranges allowed before returning the complete -resource </td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRanges default | unlimited | none | <var>number-of-ranges</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de segments de données autorisé avant le renvoi de +l'intégralité de la ressource</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRanges default | unlimited | none | <var>nombre de segments</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRanges 200</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP +Apache</td></tr> </table> - <p>The <code class="directive">MaxRanges</code> directive - limits the number of HTTP ranges the server is willing to - return to the client. If more ranges than permitted are requested, - the complete resource is returned instead.</p> + <p>La directive <code class="directive">MaxRanges</code> permet de limiter + le nombre de segments de données que le serveur va renvoyer au + client. Si un nombre de segments plus important est demandé, la + ressource sera renvoyée dans son intégralité.</p> - <dl> + <dl> <dt><strong>default</strong></dt> - <dd>Limits the number of ranges to a compile-time default of 200.</dd> - + <dd>Limite le nombre de segments de données à 200 (valeur par + défaut définie à la compilation).</dd> + <dt><strong>none</strong></dt> - <dd>Range headers are ignored.</dd> - + <dd>Les en-têtes Range sont ignorés.</dd> + <dt><strong>unlimited</strong></dt> - <dd>The server does not limit the number of ranges it is - willing to satisfy.</dd> + <dd>Le nombre de segments de données est illimité.</dd> - <dt><var>number-of-ranges</var></dt> - <dd>A positive number representing the maximum number of ranges the - server is willing to satisfy.</dd> + <dt><var>nombre de segments</var></dt> + <dd>Un nombre positif représentera la nombre de segments de + données maximal que le serveur renverra au client.</dd> </dl> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="mergetrailers" id="mergetrailers">Directive</a> <a name="MergeTrailers" id="MergeTrailers">MergeTrailers</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether trailers are merged into headers</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les données supplémentaires (trailers) sont +fusionnées avec les en-têtes</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MergeTrailers [on|off]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MergeTrailers off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.11 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.11 du serveur HTTP +Apache</td></tr> </table> - <p>This directive controls whether HTTP trailers are copied into the - internal representation of HTTP headers. This merging occurs when the - request body has been completely consumed, long after most header - processing would have a chance to examine or modify request headers.</p> - <p>This option is provided for compatibility with releases prior to 2.4.11, - where trailers were always merged.</p> + <p>Cette directive permet de contrôler la fusion des données HTTP + supplémentaires (trailers) avec la représentation interne des + en-têtes. Cette fusion intervient lorsque le corps de la requête a + été entièrement reçu, bien longtemps après que la majeure partie du + traitement des en-têtes ait une chance de pouvoir examiner ou + modifier les en-têtes de la requête.</p> + <p>Cette option a été introduite dans un souci de compatibilité avec + les versions antérieures à 2.4.11, où les données supplémentaires + étaient systématiquement fusionnées avec les en-têtes de la requête.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="mutex" id="mutex">Directive</a> <a name="Mutex" id="Mutex">Mutex</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures mutex mechanism and lock file directory for all -or specified mutexes</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Mutex <var>mechanism</var> [default|<var>mutex-name</var>] ... [OmitPID]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les mécanismes de mutex et le repertoire du fichier +verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Mutex <var>mécanisme</var> [default|<var>nom-mutex</var>] ... [OmitPID]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Mutex default</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.4 du serveur HTTP Apache</td></tr> </table> - <p>The <code class="directive">Mutex</code> directive sets the mechanism, - and optionally the lock file location, that httpd and modules use - to serialize access to resources. Specify <code>default</code> as - the second argument to change the settings for all mutexes; specify - a mutex name (see table below) as the second argument to override - defaults only for that mutex.</p> + <p>La directive <code class="directive">Mutex</code> permet de définir le + mécanisme de mutex, et éventuellement le répertoire du fichier + verrou que les modules et httpd utilisent pour sérialiser l'accès aux + ressources. Spécifiez <code>default</code> comme second argument + pour modifier la configuration de tous les mutex ; spécifiez un nom + de mutex (voir la table ci-dessous) comme premier argument pour + ne modifier que la configuration de ce mutex.</p> - <p>The <code class="directive">Mutex</code> directive is typically used in - the following exceptional situations:</p> + <p>La directive <code class="directive">Mutex</code> est typiquement + utilisée dans les situations exceptionnelles suivantes :</p> <ul> - <li>change the mutex mechanism when the default mechanism selected - by <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> has a functional or performance - problem</li> + <li>choix d'un autre mécanisme de mutex lorsque le mécanisme par + défaut sélectionné par <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> présente un + problème de fonctionnement ou de performances.</li> - <li>change the directory used by file-based mutexes when the - default directory does not support locking</li> + <li>choix d'un autre répertoire utilisé par les mutex à base de + fichier lorsque le répertoire par défaut ne supporte pas le + verrouillage</li> </ul> - <div class="note"><h3>Supported modules</h3> - <p>This directive only configures mutexes which have been registered - with the core server using the <code>ap_mutex_register()</code> API. - All modules bundled with httpd support the <code class="directive">Mutex</code> - directive, but third-party modules may not. Consult the documentation - of the third-party module, which must indicate the mutex name(s) which - can be configured if this directive is supported.</p> + <div class="note"><h3>Modules supportés</h3> + <p>Cette directive ne configure que les mutex qui ont été + enregistrés avec le serveur de base via l'API + <code>ap_mutex_register()</code>. Tous les modules fournis avec + httpd supportent la directive <code class="directive">Mutex</code>, mais il + n'en sera pas forcément de même pour les modules tiers. + Reportez-vous à la documentation du module tiers considéré afin de + déterminer le(s) nom(s) de mutex qui pourront être définis si la + directive est supportée.</p> </div> - <p>The following mutex <em>mechanisms</em> are available:</p> + + + <p>Les <em>mécanismes</em> de mutex disponibles sont les suivants :</p> <ul> <li><code>default | yes</code> - <p>This selects the default locking implementation, as determined by - <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. The default locking implementation can - be displayed by running <code class="program"><a href="../programs/httpd.html">httpd</a></code> with the - <code>-V</code> option.</p></li> + <p>C'est l'implémentation du verrouillage par défaut, telle + qu'elle est définie par <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. On peut + afficher l'implémentation du verrouillage par défaut via la + commande <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec l'option <code>-V</code>.</p></li> <li><code>none | no</code> - <p>This effectively disables the mutex, and is only allowed for a - mutex if the module indicates that it is a valid choice. Consult the - module documentation for more information.</p></li> + <p>Le mutex est désactivé, et cette valeur n'est permise pour un + mutex que si le module indique qu'il s'agit d'un choix valide. + Consultez la documentation du module pour plus d'informations.</p></li> <li><code>posixsem</code> - <p>This is a mutex variant based on a Posix semaphore.</p> + <p>Une variante de mutex basée sur un sémaphore Posix.</p> - <div class="warning"><h3>Warning</h3> - <p>The semaphore ownership is not recovered if a thread in the process - holding the mutex segfaults, resulting in a hang of the web server.</p> + <div class="warning"><h3>Avertissement</h3> + <p>La propriété du sémaphore n'est pas restituée si un thread du + processus gérant le mutex provoque une erreur de segmentation, + ce qui provoquera un blocage du serveur web.</p> </div> </li> <li><code>sysvsem</code> - <p>This is a mutex variant based on a SystemV IPC semaphore.</p> + <p>Une variante de mutex basée sur un sémaphore IPC SystemV.</p> - <div class="warning"><h3>Warning</h3> - <p>It is possible to "leak" SysV semaphores if processes crash - before the semaphore is removed.</p> + <div class="warning"><h3>Avertissement</h3> + <p>Il peut arriver que les sémaphores SysV soient conservés si le + processus se crashe avant que le sémaphore ne soit supprimé.</p> </div> - <div class="warning"><h3>Security</h3> - <p>The semaphore API allows for a denial of service attack by any - CGIs running under the same uid as the webserver (<em>i.e.</em>, - all CGIs, unless you use something like <code class="program"><a href="../programs/suexec.html">suexec</a></code> - or <code>cgiwrapper</code>).</p> + <div class="warning"><h3>Sécurité</h3> + <p>L'API des sémaphores permet les attaques par déni de service + par tout programme CGI s'exécutant sous le même uid que le + serveur web (autrement dit tous les programmes CGI, à moins que + vous n'utilisiez un programme du style <code class="program"><a href="../programs/suexec.html">suexec</a></code> + ou <code>cgiwrapper</code>).</p> </div> </li> <li><code>sem</code> - <p>This selects the "best" available semaphore implementation, choosing - between Posix and SystemV IPC semaphores, in that order.</p></li> + <p>Sélection de la "meilleure" implémentation des sémaphores + disponible ; le choix s'effectue entre les sémaphores posix et + IPC SystemV, dans cet ordre.</p></li> <li><code>pthread</code> - <p>This is a mutex variant based on cross-process Posix thread - mutexes.</p> - - <div class="warning"><h3>Warning</h3> - <p>On most systems, if a child process terminates abnormally while - holding a mutex that uses this implementation, the server will deadlock - and stop responding to requests. When this occurs, the server will - require a manual restart to recover.</p> - <p>Solaris and Linux are notable exceptions as they provide a mechanism which - usually allows the mutex to be recovered after a child process - terminates abnormally while holding a mutex.</p> - <p>If your system is POSIX compliant or if it implements the - <code>pthread_mutexattr_setrobust_np()</code> function, you may be able - to use the <code>pthread</code> option safely.</p> + <p>Une variante de mutex à base de mutex de thread Posix + inter-processus.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>Sur la plupart des systèmes, si un processus enfant se + termine anormalement alors qu'il détenait un mutex qui utilise + cette implémentation, le serveur va se bloquer et cesser de + répondre aux requêtes. Dans ce cas, un redémarrage manuel est + nécessaire pour récupérer le mutex.</p> + <p>Solaris constitue une exception notable, en ceci qu'il fournit + un mécanisme qui permet en général de récupérer le mutex après + l'arrêt anormal d'un processus enfant qui détenait le mutex.</p> + <p>Si votre système implémente la fonction + <code>pthread_mutexattr_setrobust_np()</code>, vous devriez + pouvoir utiliser l'option <code>pthread</code> sans problème.</p> </div> </li> - <li><code>fcntl:/path/to/mutex</code> - <p>This is a mutex variant where a physical (lock-)file and the - <code>fcntl()</code> function are used as the mutex.</p> + <li><code>fcntl:/chemin/vers/mutex</code> + <p>Une variante de mutex utilisant un fichier verrou physique et + la fonction <code>fcntl()</code>.</p> - <div class="warning"><h3>Warning</h3> - <p>When multiple mutexes based on this mechanism are used within - multi-threaded, multi-process environments, deadlock errors (EDEADLK) - can be reported for valid mutex operations if <code>fcntl()</code> - is not thread-aware, such as on Solaris.</p> + <div class="warning"><h3>Avertissement</h3> + <p>Lorsqu'on utilise plusieurs mutex basés sur ce mécanisme dans + un environnement multi-processus, multi-thread, des erreurs de + blocage (EDEADLK) peuvent être rapportées pour des opérations de + mutex valides si la fonction <code>fcntl()</code> ne gère pas + les threads, comme sous Solaris.</p> </div> </li> - <li><code>flock:/path/to/mutex</code> - <p>This is similar to the <code>fcntl:/path/to/mutex</code> method - with the exception that the <code>flock()</code> function is used to - provide file locking.</p></li> + <li><code>flock:/chemin/vers/mutex</code> + <p>Méthode similaire à <code>fcntl:/chemin/vers/mutex</code>, + mais c'est la fonction <code>flock()</code> qui est utilisée + pour gérer le verrouillage par fichier.</p></li> - <li><code>file:/path/to/mutex</code> - <p>This selects the "best" available file locking implementation, - choosing between <code>fcntl</code> and <code>flock</code>, in that - order.</p></li> + <li><code>file:/chemin/vers/mutex</code> + <p>Sélection de la "meilleure" implémentation de verrouillage + par fichier disponible ; le choix s'effectue entre + <code>fcntl</code> et <code>flock</code>, dans cet ordre.</p></li> </ul> - <p>Most mechanisms are only available on selected platforms, where the - underlying platform and <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> support it. Mechanisms - which aren't available on all platforms are <em>posixsem</em>, - <em>sysvsem</em>, <em>sem</em>, <em>pthread</em>, <em>fcntl</em>, - <em>flock</em>, and <em>file</em>.</p> - - <p>With the file-based mechanisms <em>fcntl</em> and <em>flock</em>, - the path, if provided, is a directory where the lock file will be created. - The default directory is httpd's run-time file directory, - <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. If a relative - path is provided, it is relative to - <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. Always use a local - disk filesystem for <code>/path/to/mutex</code> and never a directory residing - on a NFS- or AFS-filesystem. The basename of the file will be the mutex - type, an optional instance string provided by the module, and unless the - <code>OmitPID</code> keyword is specified, the process id of the httpd - parent process will be appended to make the file name unique, avoiding - conflicts when multiple httpd instances share a lock file directory. For - example, if the mutex name is <code>mpm-accept</code> and the lock file - directory is <code>/var/httpd/locks</code>, the lock file name for the - httpd instance with parent process id 12345 would be - <code>/var/httpd/locks/mpm-accept.12345</code>.</p> - - <div class="warning"><h3>Security</h3> - <p>It is best to <em>avoid</em> putting mutex files in a world-writable - directory such as <code>/var/tmp</code> because someone could create - a denial of service attack and prevent the server from starting by - creating a lockfile with the same name as the one the server will try - to create.</p> + <p>La plupart des mécanismes ne sont disponibles que sur les + plate-formes où ces dernières et <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> les + supportent. Les mécanismes qui ne sont pas disponibles sur toutes + les plate-formes sont <em>posixsem</em>, + <em>sysvsem</em>, <em>sem</em>, <em>pthread</em>, <em>fcntl</em>, + <em>flock</em>, et <em>file</em>.</p> + + <p>Avec les mécanismes à base de fichier <em>fcntl</em> et + <em>flock</em>, le chemin, s'il est fourni, est un répertoire dans + lequel le fichier verrou sera créé. Le répertoire par défaut est le + répertoire d'exécution httpd défini par la directive <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. Si le répertoire + spécifié est un chemin relatif, il est relatif au chemin défini par + la directive <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. + Utilisez toujours un système + de fichiers local sur disque pour <code>/chemin/vers/mutex</code> et + jamais un répertoire se trouvant dans un système de fichiers NFS ou + AFS. Le nom de base du fichier se composera du type de mutex, d'une + chaîne optionnelle correspondant à l'instance et fournie par le + module ; et, sauf si le mot-clé <code>OmitPID</code> a été spécifié, + l'identificateur du processus parent httpd sera ajouté afin de + rendre le nom du fichier unique, évitant ainsi tout conflit lorsque + plusieurs instances d'httpd partagent le même répertoire de + verrouillage. Par exemple, si le nom de mutex est + <code>mpm-accept</code>, et si le répertoire de verrouillage est + <code>/var/httpd/locks</code>, le nom du fichier verrou pour + l'instance httpd dont le processus parent a pour identifiant 12345 + sera <code>/var/httpd/locks/mpm-accept.12345</code>.</p> + + <div class="warning"><h3>Sécurité</h3> + <p>Il est conseillé d'<em>éviter</em> de placer les fichiers mutex + dans un répertoire où tout le monde peut écrire comme + <code>/var/tmp</code>, car quelqu'un pourrait initier une attaque + par déni de service et empêcher le serveur de démarrer en créant un + fichier verrou possédant un nom identique à celui que le serveur va + tenter de créer.</p> </div> - <p>The following table documents the names of mutexes used by httpd - and bundled modules.</p> + <p>La table suivante décrit les noms de mutex utilisés par httpd et + ses modules associés.</p> <table class="bordered"><tr class="header"> - <th>Mutex name</th> + <th>Nom mutex</th> <th>Module(s)</th> - <th>Protected resource</th> + <th>Ressource protégée</th> </tr> <tr> <td><code>mpm-accept</code></td> - <td><code class="module"><a href="../mod/prefork.html">prefork</a></code> and <code class="module"><a href="../mod/worker.html">worker</a></code> MPMs</td> - <td>incoming connections, to avoid the thundering herd problem; - for more information, refer to the - <a href="../misc/perf-tuning.html">performance tuning</a> - documentation</td> + <td>modules MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code> et <code class="module"><a href="../mod/worker.html">worker</a></code></td> + <td>connexions entrantes, afin d'éviter le problème de + l'afflux de requêtes ; pour plus d'informations, voir la + documentation <a href="../misc/perf-tuning.html">Amélioration des + performances</a></td> </tr> <tr class="odd"> <td><code>authdigest-client</code></td> <td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td> - <td>client list in shared memory</td> + <td>liste de clients en mémoire partagée</td> </tr> <tr> <td><code>authdigest-opaque</code></td> <td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td> - <td>counter in shared memory</td> + <td>compteur en mémoire partagée</td> </tr> <tr class="odd"> <td><code>ldap-cache</code></td> <td><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code></td> - <td>LDAP result cache</td> + <td>cache de résultat de recherche LDAP</td> </tr> <tr> <td><code>rewrite-map</code></td> <td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td> - <td>communication with external mapping programs, to avoid - intermixed I/O from multiple requests</td> + <td>communication avec des programmes externes + d'associations de valeurs, afin d'éviter les interférences + d'entrées/sorties entre plusieurs requêtes</td> </tr> <tr class="odd"> <td><code>ssl-cache</code></td> <td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td> - <td>SSL session cache</td> + <td>cache de session SSL</td> </tr> <tr> <td><code>ssl-stapling</code></td> <td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td> - <td>OCSP stapling response cache</td> + <td>cache de l'étiquetage OCSP ("OCSP stapling")</td> </tr> <tr class="odd"> <td><code>watchdog-callback</code></td> <td><code class="module"><a href="../mod/mod_watchdog.html">mod_watchdog</a></code></td> - <td>callback function of a particular client module</td> + <td>fonction de rappel d'un module client particulier</td> </tr> </table> - <p>The <code>OmitPID</code> keyword suppresses the addition of the httpd - parent process id from the lock file name.</p> + <p>Le mot-clé <code>OmitPID</code> permet d'empêcher l'addition de + l'identifiant du processus httpd parent au nom du fichier verrou.</p> - <p>In the following example, the mutex mechanism for the MPM accept - mutex will be changed from the compiled-in default to <code>fcntl</code>, - with the associated lock file created in directory - <code>/var/httpd/locks</code>. The mutex mechanism for all other mutexes - will be changed from the compiled-in default to <code>sysvsem</code>.</p> + + <p>Dans l'exemple suivant, le mécanisme de mutex pour le mutex + mpm-accept est modifié pour passer du mécanisme par défaut au + mécanisme <code>fcntl</code>, avec le fichier verrou associé créé + dans le répertoire <code>/var/httpd/locks</code>. Le mécanisme de + mutex par défaut pour tous les autres mutex deviendra + <code>sysvsem</code>.</p> <pre class="prettyprint lang-config">Mutex sysvsem default Mutex fcntl:/var/httpd/locks mpm-accept</pre> @@ -3797,33 +4055,35 @@ Mutex fcntl:/var/httpd/locks mpm-accept</pre> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="namevirtualhost" id="namevirtualhost">Directive</a> <a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DEPRECATED: Designates an IP address for name-virtual -hosting</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de +nom</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>adresse</var>[:<var>port</var>]</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> -<p>Prior to 2.3.11, <code class="directive">NameVirtualHost</code> was required -to instruct the server that a particular IP address and port combination -was usable as a name-based virtual host. In 2.3.11 and later, -any time an IP address and port combination is used in multiple virtual -hosts, name-based virtual hosting is automatically enabled for that address.</p> - -<p>This directive currently has no effect.</p> + <p>Avant la version 2.3.11, il était nécessaire de définir une + directive <code class="directive">NameVirtualHost</code> pour indiquer au + serveur qu'une paire adresse IP/port particulière pouvait être + utilisée comme serveur virtuel à base de nom. Depuis la version + 2.3.11, chaque fois qu'une paire adresse IP/port est utilisée dans + plusieurs serveurs virtuels, l'hébergement virtuel à base de nom est + automatiquement activé pour cette adresse.</p> + + <p>Cette directive n'a actuellement plus aucun effet.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../vhosts/">Virtual Hosts -documentation</a></li> +<li><a href="../vhosts/">Documentation sur les serveurs +virtuels</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="options" id="options">Directive</a> <a name="Options" id="Options">Options</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures what features are available in a particular -directory</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les fonctionnalités disponibles pour un répertoire +particulier</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Options [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Options FollowSymlinks</code></td></tr> @@ -3831,115 +4091,129 @@ directory</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The default was changed from All to FollowSymlinks in 2.3.11</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Avec la version 2.3.11, la valeur par défaut passe de All +à FollowSymlinks</td></tr> </table> - <p>The <code class="directive">Options</code> directive controls which - server features are available in a particular directory.</p> + <p>La directive <code class="directive">Options</code> permet de définir + les fonctionnalités de serveur disponibles pour un répertoire + particulier.</p> - <p><var>option</var> can be set to <code>None</code>, in which - case none of the extra features are enabled, or one or more of - the following:</p> + <p><var>option</var> peut être défini à <code>None</code>, auquel + cas aucune fonctionnalité spécifique n'est activée, ou comprendre + une ou plusieurs des options suivantes :</p> <dl> <dt><code>All</code></dt> - <dd>All options except for <code>MultiViews</code>.</dd> + <dd>Toutes les options excepté <code>MultiViews</code>.</dd> <dt><code>ExecCGI</code></dt> - <dd> - Execution of CGI scripts using <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> - is permitted.</dd> + <dd>L'exécution de scripts CGI à l'aide du module + <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> est permise.</dd> <dt><code>FollowSymLinks</code></dt> <dd> - The server will follow symbolic links in this directory. This is - the default setting. - <div class="note"> - <p>Even though the server follows the symlink it does <em>not</em> - change the pathname used to match against <code class="directive"><a href="#directory"><Directory></a></code> sections.</p> - - <p>The <code>FollowSymLinks</code> and - <code>SymLinksIfOwnerMatch</code> <code class="directive"><a href="#options">Options</a></code> work only in <code class="directive"><a href="#directory"><Directory></a></code> sections or - <code>.htaccess</code> files.</p> - <p>Omitting this option should not be considered a security restriction, - since symlink testing is subject to race conditions that make it - circumventable.</p> + Le serveur va suivre les liens symboliques dans le répertoire + concerné. Il s'agit de la valeur par défaut. + <div class="note"> + <p>Bien que le serveur suive les liens symboliques, il ne modifie + <em>pas</em> le nom de chemin concerné défini par la section + <code class="directive"><a href="#directory"><Directory></a></code>.</p> + + <p>Les options <code>FollowSymLinks</code> et + <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les + sections <code class="directive"><a href="#directory"><Directory></a></code> ou les fichiers + <code>.htaccess</code>.</p> + + <p>Le fait d'omettre cette option ne doit pas être considéré comme + une mesure de sécurité efficace, car il existe toujours une + situation de compétition (race condition) entre l'instant où l'on + vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où + l'on utilise effectivement ce chemin.</p> </div></dd> <dt><code>Includes</code></dt> <dd> - Server-side includes provided by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> - are permitted.</dd> + Les inclusions côté serveur (SSI) à l'aide du module + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont autorisées.</dd> <dt><code>IncludesNOEXEC</code></dt> <dd> - Server-side includes are permitted, but the <code>#exec - cmd</code> and <code>#exec cgi</code> are disabled. It is still - possible to <code>#include virtual</code> CGI scripts from - <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>ed - directories.</dd> + Les inclusions côté serveur (SSI) sont permises, mais <code>#exec + cmd</code> et <code>#exec cgi</code> sont désactivés. + L'utilisation de <code>#include virtual</code> pour les scripts + CGI est cependant toujours possible depuis des répertoires + définis par <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd> <dt><code>Indexes</code></dt> <dd> - If a URL which maps to a directory is requested and there - is no <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> - (<em>e.g.</em>, <code>index.html</code>) in that directory, then - <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> will return a formatted listing - of the directory.</dd> + Si une URL requise correspond au répertoire concerné, et si aucun + <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> (<em>par + exemple</em> <code>index.html</code>) n'est défini pour ce + répertoire, le module <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> va renvoyer + un listing formaté du répertoire.</dd> <dt><code>MultiViews</code></dt> <dd> - <a href="../content-negotiation.html">Content negotiated</a> - "MultiViews" are allowed using - <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>. - <div class="note"><h3>Note</h3> <p>This option gets ignored if set - anywhere other than <code class="directive"><a href="#directory"><Directory></a></code>, as <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> - needs real resources to compare against and evaluate from.</p></div> + Les vues multiples ("multiviews") à <a href="../content-negotiation.html">contenu négocié</a> à l'aide du + module <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> sont autorisées. + <div class="note"><h3>Note</h3> <p>Cette option est ignorée si elle est + définie en tout autre endroit qu'une section <code class="directive"><a href="#directory"><Directory></a></code>, car + <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> a besoin de ressources réelles + pour effectuer ses comparaisons et ses évaluations.</p></div> + </dd> <dt><code>SymLinksIfOwnerMatch</code></dt> - <dd>The server will only follow symbolic links for which the - target file or directory is owned by the same user id as the - link. + <dd>Le serveur ne suivra que les liens symboliques qui renvoient + vers un fichier ou un répertoire dont le propriétaire est le même + que celui du lien. <div class="note"><h3>Note</h3> - <p>The <code>FollowSymLinks</code> and - <code>SymLinksIfOwnerMatch</code> <code class="directive"><a href="#options">Options</a></code> work only in <code class="directive"><a href="#directory"><Directory></a></code> sections or - <code>.htaccess</code> files.</p> - - <p>This option should not be considered a security restriction, - since symlink testing is subject to race conditions that make it - circumventable.</p> + <p>Les options <code>FollowSymLinks</code> et + <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les + sections <code class="directive"><a href="#directory"><Directory></a></code> ou les fichiers + <code>.htaccess</code>.</p> + + <p>Le fait d'omettre cette option ne doit pas être considéré comme + une mesure de sécurité efficace, car il existe toujours une + situation de compétition (race condition) entre l'instant où l'on + vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où + l'on utilise effectivement ce chemin.</p> </div> </dd> </dl> - <p>Normally, if multiple <code class="directive">Options</code> could - apply to a directory, then the most specific one is used and - others are ignored; the options are not merged. (See <a href="../sections.html#merging">how sections are merged</a>.) - However if <em>all</em> the options on the - <code class="directive">Options</code> directive are preceded by a - <code>+</code> or <code>-</code> symbol, the options are - merged. Any options preceded by a <code>+</code> are added to the - options currently in force, and any options preceded by a - <code>-</code> are removed from the options currently in - force. </p> + <p>Normalement, si plusieurs directives + <code class="directive">Options</code> peuvent s'appliquer à un répertoire, + c'est la plus spécifique qui est utilisée et les autres sont + ignorées ; les options ne sont pas fusionnées (voir <a href="../sections.html#merging">comment les sections sont + fusionnées</a>). Elles le sont cependant si <em>toutes</em> les + options de la directive <code class="directive">Options</code> sont + précédées d'un symbole <code>+</code> ou <code>-</code>. Toute + option précédée d'un <code>+</code> est ajoutée à la liste des + options courantes de manière forcée et toute option précédée d'un + <code>-</code> est supprimée de la liste des options courantes de la + même manière.</p> <div class="note"><h3>Note</h3> - <p>Mixing <code class="directive">Options</code> with a <code>+</code> or - <code>-</code> with those without is not valid syntax and will be - rejected during server startup by the syntax check with an abort.</p> + <p>Mélanger des <code class="directive">Options</code> avec <code>+</code> + ou <code>-</code> avec des <code class="directive">Options</code> sans + <code>+</code> ou <code>-</code> constitue une erreur de syntaxe, et + la vérification de la syntaxe au cours du démarrage du serveur fera + échouer ce dernier.</p> </div> - <p>For example, without any <code>+</code> and <code>-</code> symbols:</p> + <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code> + :</p> <pre class="prettyprint lang-config"><Directory "/web/docs"> Options Indexes FollowSymLinks @@ -3950,10 +4224,10 @@ directory</td></tr> </Directory></pre> - <p>then only <code>Includes</code> will be set for the - <code>/web/docs/spec</code> directory. However if the second - <code class="directive">Options</code> directive uses the <code>+</code> and - <code>-</code> symbols:</p> + <p>ici, seule l'option <code>Includes</code> sera prise en compte + pour le répertoire <code>/web/docs/spec</code>. Par contre, si la + seconde directive <code class="directive">Options</code> utilise les + symboles <code>+</code> et <code>-</code> :</p> <pre class="prettyprint lang-config"><Directory "/web/docs"> Options Indexes FollowSymLinks @@ -3964,46 +4238,51 @@ directory</td></tr> </Directory></pre> - <p>then the options <code>FollowSymLinks</code> and - <code>Includes</code> are set for the <code>/web/docs/spec</code> - directory.</p> + <p>alors, les options <code>FollowSymLinks</code> et + <code>Includes</code> seront prises en compte pour le répertoire + <code>/web/docs/spec</code>.</p> <div class="note"><h3>Note</h3> - <p>Using <code>-IncludesNOEXEC</code> or - <code>-Includes</code> disables server-side includes completely - regardless of the previous setting.</p> + <p>L'utilisation de <code>-IncludesNOEXEC</code> ou + <code>-Includes</code> désactive complètement les inclusions côté + serveur sans tenir compte des définitions précédentes.</p> </div> - <p>The default in the absence of any other settings is - <code>FollowSymlinks</code>.</p> + <p>En l'absence de toute définition d'options, la valeur par défaut + est <code>FollowSymlinks</code>.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="protocol" id="protocol">Directive</a> <a name="Protocol" id="Protocol">Protocol</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocol for a listening socket</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocol <var>protocol</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocole pour une socket d'écoute</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocol <var>protocole</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>On Windows, only available from Apache 2.3.3 and later.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, disponible à partir de la version 2.3.3 du +serveur HTTP Apache.</td></tr> </table> - <p>This directive specifies the protocol used for a specific listening socket. - The protocol is used to determine which module should handle a request and - to apply protocol specific optimizations with the <code class="directive">AcceptFilter</code> - directive.</p> + <p>Cette directive permet de spécifier le protocole utilisé pour une + socket d'écoute particulière. Le protocole sert à déterminer quel + module doit traiter une requête, et d'appliquer les optimisations + spécifiques au protocole via la directive + <code class="directive">AcceptFilter</code>.</p> - <p>You only need to set the protocol if you are running on non-standard ports; - otherwise, <code>http</code> is assumed for port 80 and <code>https</code> - for port 443.</p> + <p>Vous ne devez définir le protocole que si vous travaillez avec + des ports non standards ; dans le cas général, le protocole + <code>http</code> est associé au port 80 et le protocole + <code>https</code> au port 443.</p> - <p>For example, if you are running <code>https</code> on a non-standard port, - specify the protocol explicitly:</p> + <p>Par exemple, si vous travaillez avec le protocole + <code>https</code> sur un port non standard, spécifiez le protocole + de manière explicite :</p> <pre class="prettyprint lang-config">Protocol https</pre> - <p>You can also specify the protocol using the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive.</p> + <p>Vous pouvez aussi spécifier le protocole via la directive + <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> <h3>Voir aussi</h3> <ul> @@ -4014,40 +4293,46 @@ directory</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="protocols" id="protocols">Directive</a> <a name="Protocols" id="Protocols">Protocols</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocols available for a server/virtual host</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocols <var>protocol</var> ...</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocoles disponibles pour un serveur virtuel ou non</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocols <var>protocole</var> ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Protocols http/1.1</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Only available from Apache 2.4.17 and later.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.17 du serveur + HTTP Apache.</td></tr> </table> - <p>This directive specifies the list of protocols supported for a - server/virtual host. The list determines the allowed protocols - a client may negotiate for this server/host.</p> + <p>Cette directive permet de spécifier la liste des protocoles + supportés par un serveur virtuel ou non. Cette liste énumère les + protocoles qu'un client sera autorisé à négocier avec ce + serveur.</p> - <p>You need to set protocols if you want to extend the available - protocols for a server/host. By default, only the http/1.1 protocol - (which includes the compatibility with 1.0 and 0.9 clients) is - allowed.</p> + <p>Par défaut, + seul le protocole http/1.1 est disponible (compatible avec les + clients http/1.0 et http/0.9). Par conséquent, vous devez + fournir cette liste si vous voulez étendre les protocoles + disponibles pour le serveur.</p> - <p>For example, if you want to support HTTP/2 for a server with TLS, - specify:</p> + <p>Par exemple, si vous voulez autoriser le protocole + HTTP/2 pour un serveur avec TLS, utilisez + cette directive comme suit :</p> <pre class="prettyprint lang-config">Protocols h2 http/1.1</pre> - <p>Valid protocols are <code>http/1.1</code> for http and https connections, - <code>h2</code> on https connections and <code>h2c</code> for http - connections. Modules may enable more protocols.</p> + <p>Les protocoles valides sont <code>http/1.1</code> pour les + connexions http et https, <code>h2</code> pour les connections + https et <code>h2c</code> pour les connexions http. D'autres + modules peuvent fournir d'autres protocoles.</p> - <p>It is safe to specify protocols that are unavailable/disabled. Such - protocol names will simply be ignored.</p> + <p>Spécifier des protocoles non disponibles ou désactivés n'aura + aucun effet, et ceux-ci seront simplement ignorés.</p> - <p>Protocols specified in base servers are inherited for virtual hosts - only if the virtual host has no own Protocols directive. Or, the other - way around, Protocols directives in virtual hosts replace any - such directive in the base server. + <p>Si un serveur virtuel ne possède pas de directive Protocols + propre, il hérite des protocoles spécifiés pour le serveur + principal. Autrement dit, les directives Protocols définies au + niveau d'un serveur virtuel remplacent celles définies au niveau + du serveur principal. </p> @@ -4059,24 +4344,30 @@ directory</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="protocolshonororder" id="protocolshonororder">Directive</a> <a name="ProtocolsHonorOrder" id="ProtocolsHonorOrder">ProtocolsHonorOrder</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if order of Protocols determines precedence during negotiation</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine qui du client ou du serveur détermine l'ordre + des protocoles au cours de la négociation de la connexion</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProtocolsHonorOrder On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProtocolsHonorOrder On</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Only available from Apache 2.4.17 and later.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.17 du serveur + HTTP Apache.</td></tr> </table> - <p>This directive specifies if the server should honor the order in which - the <code class="directive">Protocols</code> directive lists protocols.</p> + <p>Cette directive permet de définir si le serveur doit tenir + compte de l'ordre des protocoles définis par la directive + <code class="directive">Protocols</code>.</p> - <p>If configured Off, the client supplied list order of protocols has - precedence over the order in the server configuration.</p> + <p>Si cette directive est définie à Off, l'ordre de la liste des + protocoles fournie par le client l'emporte sur l'ordre défini + dans la configuration du serveur.</p> - <p>With <code class="directive">ProtocolsHonorOrder</code> set to <code>on</code> - (default), the client ordering does not matter and only the ordering - in the server settings influences the outcome of the protocol - negotiation.</p> + <p>Si la directive <code class="directive">ProtocolsHonorOrder</code> + est définie à <code>on</code> (valeur par défaut), + il n'est pas tenu compte de l'ordre de la liste des protocoles + fournie par le client, et seul l'ordre de la liste des protocles + définie au niveau du serveur influera la + négociation du protocole.</p> <h3>Voir aussi</h3> @@ -4087,73 +4378,80 @@ directory</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="qualifyredirecturl" id="qualifyredirecturl">Directive</a> <a name="QualifyRedirectURL" id="QualifyRedirectURL">QualifyRedirectURL</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether the REDIRECT_URL environment variable is - fully qualified</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie si la variable d'environnement REDIRECT_URL est +pleinement qualifiée</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>QualifyRedirectURL ON|OFF</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>QualifyRedirectURL OFF</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Directive supported in 2.4.18 and later. 2.4.17 acted -as if 'QualifyRedirectURL ON' was configured.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Directive supportée à partir de la version 2.4.18 du +serveur HTTP Apache. Jusqu'à la version 2.4.17, le serveur se comportait +comme si la directive QualifyRedirectURL était définie à ON.</td></tr> </table> - <p>This directive controls whether the server will ensure that the - REDIRECT_URL environment variable is fully qualified. By default, - the variable contains the verbatim URL requested by the client, - such as "/index.html". With <code class="directive"><a href="#qualifyredirecturl on">QualifyRedirectURL ON</a></code>, the same request would result in a - value such as "http://www.example.com/index.html".</p> - <p>Even without this directive set, when a request is issued against a - fully qualified URL, REDIRECT_URL will remain fully qualified. + <p>Cette directive permet de s'assurer que le serveur vérifiera que + la variable d'environnement REDIRECT_URL est bien pleinement + qualifiée. Par défaut, cette variable contient l'URL textuellement + demandée par le client, par exemple "/index.html". Avec <code class="directive"><a href="#qualifyredirecturl on">QualifyRedirectURL ON</a></code>, la même requête + affectera à la variable REDIRECT_URL une valeur du style + "http://www.example.com/index.html".</p> + <p>Même si cette directive n'est pas définie, lorsqu'une requête est + soumise avec une URL pleinement qualifiée, la variable REDIRECT_URL + contiendra quand-même une URL pleinement qualifiée. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="registerhttpmethod" id="registerhttpmethod">Directive</a> <a name="RegisterHttpMethod" id="RegisterHttpMethod">RegisterHttpMethod</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Register non-standard HTTP methods</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RegisterHttpMethod <var>method</var> [<var>method</var> [...]]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistrement de méthodes HTTP non standards</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RegisterHttpMethod <var>méthode</var> [<var>méthode</var> [...]]</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> -<p>HTTP Methods that are not conforming to the relevant RFCs are normally -rejected by request processing in Apache HTTPD. To avoid this, modules -can register non-standard HTTP methods they support. -The <code class="directive">RegisterHttpMethod</code> allows to register such -methods manually. This can be useful if such methods are forwarded -for external processing, e.g. to a CGI script.</p> +<p>Normalement, les méthodes HTTP non conformes aux RFCs correspondantes +sont rejetées au cours du traitement de la requête par HTTPD. Pour +éviter ceci, les modules peuvent enregistrer les méthodes HTTP non +standards qu'ils supportent. La directive +<code class="directive">RegisterHttpMethod</code> permet d'enregistrer de telles +méthodes manuellement. Ceci peut s'avérer utile si de telle méthodes +doivent être utilisées dans un traitement externe, comme un script CGI.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="rlimitcpu" id="rlimitcpu">Directive</a> <a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the CPU consumption of processes launched -by Apache httpd children</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le temps CPU alloué aux processus initiés par les +processus enfants d'Apache httpd</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitCPU <var>secondes</var>|max [<var>secondes</var>|max]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Non défini ; utilise les valeurs par défaut du système +d'exploitation</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Takes 1 or 2 parameters. The first parameter sets the soft - resource limit for all processes and the second parameter sets - the maximum resource limit. Either parameter can be a number, - or <code>max</code> to indicate to the server that the limit should - be set to the maximum allowed by the operating system - configuration. Raising the maximum resource limit requires that - the server is running as <code>root</code> or in the initial startup - phase.</p> - - <p>This applies to processes forked from Apache httpd children - servicing requests, not the Apache httpd children themselves. This - includes CGI scripts and SSI exec commands, but not any - processes forked from the Apache httpd parent, such as piped - logs.</p> - - <p>CPU resource limits are expressed in seconds per - process.</p> + <p>Prend 1 ou 2 paramètres. Le premier definit la limite de + consommation de ressources pour tous les processus, et le second la + consommation de ressources maximale. Les deux paramètres peuvent + contenir soit un nombre, soit <code>max</code> pour indiquer au + serveur que la limite de consommation correspond à la valeur + maximale autorisée par la configuration du système d'exploitation. + Pour augmenter la consommation maximale de ressources, le serveur + doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa + phase de démarrage.</p> + + <p>Cette directive s'applique aux processus initiés par les + processus enfants d'Apache httpd qui traitent les requêtes, et non aux + processus enfants eux-mêmes. Sont concernés les scripts CGI et les + commandes exec des SSI, mais en aucun cas les processus initiés par + le processus parent d'Apache httpd comme les journalisations redirigées + vers un programme.</p> + + <p>Les limites de ressources CPU sont exprimées en secondes par + processus.</p> <h3>Voir aussi</h3> <ul> @@ -4164,32 +4462,35 @@ by Apache httpd children</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="rlimitmem" id="rlimitmem">Directive</a> <a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the memory consumption of processes launched -by Apache httpd children</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite la mémoire allouée aux processus initiés par les +processus enfants d'Apache httpd</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitMEM <var>octets</var>|max [<var>octets</var>|max]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Non défini ; utilise les valeurs par défaut du système +d'exploitation</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Takes 1 or 2 parameters. The first parameter sets the soft - resource limit for all processes and the second parameter sets - the maximum resource limit. Either parameter can be a number, - or <code>max</code> to indicate to the server that the limit should - be set to the maximum allowed by the operating system - configuration. Raising the maximum resource limit requires that - the server is running as <code>root</code> or in the initial startup - phase.</p> - - <p>This applies to processes forked from Apache httpd children - servicing requests, not the Apache httpd children themselves. This - includes CGI scripts and SSI exec commands, but not any - processes forked from the Apache httpd parent, such as piped - logs.</p> - - <p>Memory resource limits are expressed in bytes per - process.</p> + <p>Prend 1 ou 2 paramètres. Le premier definit la limite de + consommation de ressources pour tous les processus, et le second la + consommation de ressources maximale. Les deux paramètres peuvent + contenir soit un nombre, soit <code>max</code> pour indiquer au + serveur que la limite de consommation correspond à la valeur + maximale autorisée par la configuration du système d'exploitation. + Pour augmenter la consommation maximale de ressources, le serveur + doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa + phase de démarrage.</p> + + <p>Cette directive s'applique aux processus initiés par les + processus enfants d'Apache httpd qui traitent les requêtes, et non aux + processus enfants eux-mêmes. Sont concernés les scripts CGI et les + commandes exec des SSI, mais en aucun cas les processus initiés par + le processus parent d'Apache httpd comme les journalisations redirigées + vers un programme.</p> + + <p>Les limites de ressources mémoire sont exprimées en octets par + processus.</p> <h3>Voir aussi</h3> <ul> @@ -4200,39 +4501,42 @@ by Apache httpd children</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="rlimitnproc" id="rlimitnproc">Directive</a> <a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the number of processes that can be launched by -processes launched by Apache httpd children</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de processus qui peuvent être initiés par +les processus initiés par les processus enfants d'Apache httpd</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitNPROC <var>nombre</var>|max [<var>nombre</var>|max]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Takes 1 or 2 parameters. The first parameter sets the soft - resource limit for all processes, and the second parameter sets - the maximum resource limit. Either parameter can be a number, - or <code>max</code> to indicate to the server that the limit - should be set to the maximum allowed by the operating system - configuration. Raising the maximum resource limit requires that - the server is running as <code>root</code> or in the initial startup - phase.</p> - - <p>This applies to processes forked from Apache httpd children - servicing requests, not the Apache httpd children themselves. This - includes CGI scripts and SSI exec commands, but not any - processes forked from the Apache httpd parent, such as piped - logs.</p> - - <p>Process limits control the number of processes per user.</p> + <p>Prend 1 ou 2 paramètres. Le premier definit la limite de + consommation de ressources pour tous les processus, et le second la + consommation de ressources maximale. Les deux paramètres peuvent + contenir soit un nombre, soit <code>max</code> pour indiquer au + serveur que la limite de consommation correspond à la valeur + maximale autorisée par la configuration du système d'exploitation. + Pour augmenter la consommation maximale de ressources, le serveur + doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa + phase de démarrage.</p> + + <p>Cette directive s'applique aux processus initiés par les + processus enfants d'Apache httpd qui traitent les requêtes, et non aux + processus enfants eux-mêmes. Sont concernés les scripts CGI et les + commandes exec des SSI, mais en aucun cas les processus initiés par + le processus parent d'Apache httpd comme les journalisations redirigées + vers un programme.</p> + + <p>Les limites des processus contrôlent le nombre de processus par + utilisateur.</p> <div class="note"><h3>Note</h3> - <p>If CGI processes are <strong>not</strong> running - under user ids other than the web server user id, this directive - will limit the number of processes that the server itself can - create. Evidence of this situation will be indicated by - <strong><code>cannot fork</code></strong> messages in the - <code>error_log</code>.</p> + <p>Si les processus CGI s'exécutent sous le même + utilisateur que celui du serveur web, cette + directive va limiter le nombre de processus que le serveur + pourra lui-même créer. La présence de messages + <strong><code>cannot fork</code></strong> dans le journal des + erreurs indiquera que la limite est atteinte.</p> </div> <h3>Voir aussi</h3> @@ -4244,93 +4548,101 @@ processes launched by Apache httpd children</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a> <a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique for locating the interpreter for CGI -scripts</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpréteur des scripts +CGI</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Win32 only.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Win32 seulement</td></tr> </table> - <p>This directive is used to control how Apache httpd finds the - interpreter used to run CGI scripts. The default setting is - <code>Script</code>. This causes Apache httpd to use the interpreter pointed to - by the shebang line (first line, starting with <code>#!</code>) in the - script. On Win32 systems this line usually looks like:</p> + <p>Cette directive permet de contrôler la méthode qu'utilise Apache + httpd pour trouver l'interpréteur destiné à exécuter les scripts CGI. La + définition par défaut est <code>Script</code> : ceci indique à + Apache httpd qu'il doit utiliser l'interpréteur précisé dans la ligne + shebang du script (la première ligne, commençant par + <code>#!</code>). Sur les systèmes Win32, cette ligne ressemble + souvent à ceci :</p> <pre class="prettyprint lang-perl">#!C:/Perl/bin/perl.exe</pre> - <p>or, if <code>perl</code> is in the <code>PATH</code>, simply:</p> + <p>ou simplement, dans le cas où <code>perl</code> est dans le + <code>PATH</code> :</p> <pre class="prettyprint lang-perl">#!perl</pre> - <p>Setting <code>ScriptInterpreterSource Registry</code> will - cause the Windows Registry tree <code>HKEY_CLASSES_ROOT</code> to be - searched using the script file extension (e.g., <code>.pl</code>) as a - search key. The command defined by the registry subkey - <code>Shell\ExecCGI\Command</code> or, if it does not exist, by the subkey - <code>Shell\Open\Command</code> is used to open the script file. If the - registry keys cannot be found, Apache httpd falls back to the behavior of the - <code>Script</code> option.</p> - - <div class="warning"><h3>Security</h3> - <p>Be careful when using <code>ScriptInterpreterSource - Registry</code> with <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because - Apache httpd will try to execute <strong>every</strong> file within this - directory. The <code>Registry</code> setting may cause undesired - program calls on files which are typically not executed. For - example, the default open command on <code>.htm</code> files on - most Windows systems will execute Microsoft Internet Explorer, so - any HTTP request for an <code>.htm</code> file existing within the - script directory would start the browser in the background on the - server. This is a good way to crash your system within a minute or - so.</p> + <p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va + effectuer une recherche dans l'arborescence + <code>HKEY_CLASSES_ROOT</code> de la base de registre avec comme + mot-clé l'extension du fichier contenant le script (par exemple + <code>.pl</code>). C'est la commande définie par la sous-clé de + registre <code>Shell\ExecCGI\Command</code> ou, si elle n'existe + pas, la sous-clé <code>Shell\Open\Command</code> qui est utilisée + pour ouvrir le fichier du script. Si ces clés de registre ne sont + pas trouvées, Apache httpd utilise la méthode de l'option + <code>Script</code>.</p> + + <div class="warning"><h3>Sécurité</h3> + <p>Soyez prudent si vous utilisez <code>ScriptInterpreterSource + Registry</code> avec des répertoires faisant l'objet d'un <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, car Apache httpd va essayer + d'exécuter <strong>tous</strong> les fichiers contenus dans + celui-ci. L'option <code>Registry</code> peut causer des appels de + programmes non voulus sur des fichiers non destinés à être exécutés. + Par exemple, la commande par défaut open sur les fichiers + <code>.htm</code> sur la plupart des systèmes Windows va lancer + Microsoft Internet Explorer ; ainsi, toute requête HTTP pour un + fichier <code>.htm</code> situé dans le répertoire des scripts + va lancer le navigateur en arrière-plan sur le serveur, ce qui a + toutes les chances de crasher votre système dans les minutes qui + suivent.</p> </div> - <p>The option <code>Registry-Strict</code> which is new in Apache HTTP Server - 2.0 does the same thing as <code>Registry</code> but uses only the - subkey <code>Shell\ExecCGI\Command</code>. The - <code>ExecCGI</code> key is not a common one. It must be - configured manually in the windows registry and hence prevents - accidental program calls on your system.</p> + <p>L'option <code>Registry-Strict</code>, apparue avec la version + 2.0 du serveur HTTP Apache, + agit de manière identique à <code>Registry</code>, mais n'utilise + que la sous-clé <code>Shell\ExecCGI\Command</code>. La présence de + la clé <code>ExecCGI</code> n'étant pas systématique, Elle doit être + définie manuellement dans le registre Windows et évite ainsi tout + appel de programme accidentel sur votre système.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="seerequesttail" id="seerequesttail">Directive</a> <a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine if mod_status displays the first 63 characters -of a request or the last 63, assuming the request itself is greater than -63 chars.</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SeeRequestTail On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SeeRequestTail Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>mod_status with <code>ExtendedStatus On</code> - displays the actual request being handled. - For historical purposes, only 63 characters of the request - are actually stored for display purposes. This directive - controls whether the 1st 63 characters are stored (the previous - behavior and the default) or if the last 63 characters are. This - is only applicable, of course, if the length of the request is - 64 characters or greater.</p> - - <p>If Apache httpd is handling <code>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</code> mod_status displays as follows: + <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la + véritable requête en cours de traitement. Pour des raisons + historiques, seuls 63 caractères de la requête sont réellement + stockés à des fins d'affichage. Cette directive permet de déterminer + si ce sont les 63 premiers caractères qui seront stockés (c'est le + comportement par défaut), + ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que + si la taille de la requête est de 64 caractères ou plus.</p> + + <p>Si Apache httpd traite la requête <code>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code> + , l'affichage de la requête par mod_status se présentera comme suit : </p> <table class="bordered"> <tr> - <th>Off (default)</th> - <td>GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples</td> + <th>Off (défaut)</th> + <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td> </tr> <tr> <th>On</th> - <td>orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</td> + <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td> </tr> </table> @@ -4339,45 +4651,49 @@ of a request or the last 63, assuming the request itself is greater than <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="serveradmin" id="serveradmin">Directive</a> <a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Email address that the server includes in error -messages sent to the client</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'adresse électronique que le serveur inclut dans les +messages d'erreur envoyés au client</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>adresse électronique</var>|<var>URL</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerAdmin</code> sets the contact address - that the server includes in any error messages it returns to the - client. If the <code>httpd</code> doesn't recognize the supplied argument - as an URL, it - assumes, that it's an <var>email-address</var> and prepends it with - <code>mailto:</code> in hyperlink targets. However, it's recommended to - actually use an email address, since there are a lot of CGI scripts that - make that assumption. If you want to use an URL, it should point to another - server under your control. Otherwise users may not be able to contact you in - case of errors.</p> - - <p>It may be worth setting up a dedicated address for this, e.g.</p> + <p>La directive <code class="directive">ServerAdmin</code> permet de définir + l'adresse de contact que le serveur va inclure dans tout message + d'erreur qu'il envoie au client. Si le programme <code>httpd</code> + ne reconnait pas l'argument fourni comme une URL, il suppose que + c'est une <var>adresse électronique</var>, et lui ajoute le préfixe + <code>mailto:</code> dans les cibles des hyperliens. Il est + cependant recommandé d'utiliser exclusivement une adresse + électronique, car de nombreux scripts CGI considèrent ceci comme + implicite. Si vous utilisez une URL, elle doit pointer vers un autre + serveur que vous contrôlez. Dans le cas contraire, les utilisateurs + seraient dans l'impossibilité de vous contacter en cas de problème.</p> + + <p>Il peut s'avérer utile de définir une adresse dédiée à + l'administration du serveur, par exemple :</p> <pre class="prettyprint lang-config">ServerAdmin www-admin@foo.example.com</pre> - <p>as users do not always mention that they are talking about the - server!</p> + <p>car les utilisateurs ne mentionnent pas systématiquement le + serveur dont ils parlent !</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="serveralias" id="serveralias">Directive</a> <a name="ServerAlias" id="ServerAlias">ServerAlias</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate names for a host used when matching requests -to name-virtual hosts</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autres noms d'un serveur utilisables pour atteindre des +serveurs virtuels à base de nom</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>nom serveur</var> [<var>nom serveur</var>] +...</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerAlias</code> directive sets the - alternate names for a host, for use with <a href="../vhosts/name-based.html">name-based virtual hosts</a>. The - <code class="directive">ServerAlias</code> may include wildcards, if appropriate.</p> + <p>La directive <code class="directive">ServerAlias</code> permet de définir + les noms alternatifs d'un serveur utilisables pour atteindre des <a href="../vhosts/name-based.html">serveurs virtuels à base de + nom</a>. La directive <code class="directive">ServerAlias</code> peut + contenir des caractères génériques, si nécessaire.</p> <pre class="prettyprint lang-config"><VirtualHost *:80> ServerName server.example.com @@ -4387,99 +4703,109 @@ to name-virtual hosts</td></tr> # ... </VirtualHost></pre> + <p>La recherche du serveur virtuel à base de nom correspondant au + plus près à la requête s'effectue selon l'ordre d'apparition des + directives <code class="directive"><a href="#virtualhost"><virtualhost></a></code> dans le fichier de + configuration. Le premier serveur virtuel dont le <code class="directive"><a href="#servername">ServerName</a></code> ou le <code class="directive"><a href="#serveralias">ServerAlias</a></code> correspond est choisi, sans + priorité particulière si le nom contient des caractères génériques + (que ce soit pour ServerName ou ServerAlias).</p> - <p>Name-based virtual hosts for the best-matching set of <code class="directive"><a href="#virtualhost"><virtualhost></a></code>s are processed - in the order they appear in the configuration. The first matching <code class="directive"><a href="#servername">ServerName</a></code> or <code class="directive"><a href="#serveralias">ServerAlias</a></code> is used, with no different precedence for wildcards - (nor for ServerName vs. ServerAlias). </p> - - <p>The complete list of names in the <code class="directive"><a href="#virtualhost"><VirtualHost></a></code> - directive are treated just like a (non wildcard) - <code class="directive">ServerAlias</code>.</p> + <p>Tous les noms spécifiés au sein d'une section + <code class="directive"><a href="#virtualhost"><VirtualHost></a></code> sont traités comme un + <code class="directive"><a href="#serveralias"><ServerAlias></a></code> + (sans caractères génériques).</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> -<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li> +<li><a href="../vhosts/">Documentation sur les serveurs virtuels +du serveur HTTP Apache</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="servername" id="servername">Directive</a> <a name="ServerName" id="ServerName">ServerName</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hostname and port that the server uses to identify -itself</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName [<var>scheme</var>://]<var>domain-name</var>|<var>ip-address</var>[:<var>port</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom d'hôte et port que le serveur utilise pour +s'authentifier lui-même</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName +[<var>protocole</var>://]<var>nom-de-domaine</var>|<var>adresse-ip</var>[:<var>port</var>]</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerName</code> directive sets the - request scheme, hostname and port that the server uses to identify itself. - </p> - - <p><code class="directive">ServerName</code> is used (possibly - in conjunction with <code class="directive"><a href="#serveralias">ServerAlias</a></code>) to uniquely - identify a virtual host, when using <a href="../vhosts/name-based.html">name-based virtual hosts</a>.</p> - - <p>Additionally, this is used when - creating self-referential redirection URLs when - <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> is set to a non-default - value.</p> - - <p>For example, if the name of the - machine hosting the web server is <code>simple.example.com</code>, - but the machine also has the DNS alias <code>www.example.com</code> - and you wish the web server to be so identified, the following - directive should be used:</p> + <p>La directive <code class="directive">ServerName</code> permet de définir + les protocole, nom d'hôte et port d'une requête que le serveur + utilise pour s'authentifier lui-même.</p> + + <p>La directive <code class="directive">ServerName</code> permet + (éventuellement en conjonction avec la directive + <code class="directive"><a href="#serveralias">ServerAlias</a></code>) d'identifier de manière unique + un serveur virtuel, lorsqu'elle est utilisée dans un contexte de <a href="../vhosts/name-based.html">serveurs virtuels à base de + noms</a>.</p> + + <p>Cette directive est aussi utilisée lors de la création d'URLs de + redirection relatives quand la directive + <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> est définie à une valeur autre que + la valeur par défaut.</p> + + <p>Par exemple, si le nom de la + machine hébergeant le serveur web est + <code>simple.example.com</code>, la machine possède l'alias + DNS <code>www.example.com</code>, et si vous voulez que le serveur + web s'identifie avec cet alias, vous devez utilisez la définition + suivante :</p> <pre class="prettyprint lang-config">ServerName www.example.com</pre> - <p>The <code class="directive">ServerName</code> directive - may appear anywhere within the definition of a server. However, - each appearance overrides the previous appearance (within that - server).</p> - - <p>If no <code class="directive">ServerName</code> is specified, the - server attempts to deduce the client visible hostname by first asking - the operating system for the system hostname, and if that fails, - performing a reverse lookup on an IP address present on the system.</p> - - <p>If no port is specified in the - <code class="directive">ServerName</code>, then the server will use the - port from the incoming request. For optimal reliability and - predictability, you should specify an explicit hostname and port - using the <code class="directive">ServerName</code> directive.</p> - - <p>If you are using <a href="../vhosts/name-based.html">name-based virtual hosts</a>, - the <code class="directive">ServerName</code> inside a - <code class="directive"><a href="#virtualhost"><VirtualHost></a></code> - section specifies what hostname must appear in the request's - <code>Host:</code> header to match this virtual host.</p> - - <p>Sometimes, the server runs behind a device that processes SSL, - such as a reverse proxy, load balancer or SSL offload - appliance. When this is the case, specify the - <code>https://</code> scheme and the port number to which the - clients connect in the <code class="directive">ServerName</code> directive - to make sure that the server generates the correct - self-referential URLs. + <p>La directive <code class="directive">ServerName</code> peut apparaître à + toutes les étapes de la définition du serveur. Toute occurrence + annule cependant la précédente (pour ce serveur).</p> + + <p>Si la directive <code class="directive">ServerName</code> n'est pas + définie, le serveur tente de déterminer le nom + d'hôte visible du point de vue du client en demandant tout d'abord au + système d'exploitation le nom d'hôte système, et en cas d'échec, en effectuant + une recherche DNS inverse sur une adresse IP présente sur le système.</p> + + <p>Si la directive + <code class="directive">ServerName</code> ne précise pas de port, le serveur + utilisera celui de la requête entrante. Il est recommandé de + spécifier un nom d'hôte et un port spécifiques à l'aide de la + directive <code class="directive">ServerName</code> pour une fiabilité + optimale et à titre préventif.</p> + + <p>Si vous définissez des <a href="../vhosts/name-based.html">serveurs virtuels à base de + nom</a>, une directive <code class="directive">ServerName</code> située à + l'intérieur d'une section <code class="directive"><a href="#virtualhost"><VirtualHost></a></code> spécifiera quel nom d'hôte + doit apparaître dans l'en-tête de requête <code>Host:</code> pour + pouvoir atteindre ce serveur virtuel.</p> + + + <p>Parfois, le serveur s'exécute en amont d'un dispositif qui + implémente SSL, comme un mandataire inverse, un répartiteur de + charge ou un boîtier dédié SSL. Dans ce cas, spécifiez le protocole + <code>https://</code> et le port auquel les clients se connectent + dans la directive <code class="directive">ServerName</code>, afin de + s'assurer que le serveur génère correctement ses URLs + d'auto-identification. </p> - <p>See the description of the - <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> and - <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> directives for - settings which determine whether self-referential URLs (e.g., by the - <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> module) will refer to the - specified port, or to the port number given in the client's request. + <p>Voir la description des directives <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> et <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> pour les + définitions qui permettent de déterminer si les URLs + auto-identifiantes (par exemple via le module + <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) vont faire référence au port spécifié, ou + au port indiqué dans la requête du client. </p> <div class="warning"> - <p>Failure to set <code class="directive">ServerName</code> to a name that - your server can resolve to an IP address will result in a startup - warning. <code>httpd</code> will then use whatever hostname it can - determine, using the system's <code>hostname</code> command. This - will almost never be the hostname you actually want.</p> + <p>Si la valeur de la directive <code class="directive">ServerName</code> ne + peut pas être résolue en adresse IP, le démarrage du serveur + provoquera un avertissement. <code>httpd</code> va alors utiliser le + résultat de la commande système <code>hostname</code> pour + déterminer le nom du serveur, ce qui ne correspondra pratiquement + jamais au nom de serveur que vous souhaitez réellement.</p> <div class="example"><p><code> httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName </code></p></div> @@ -4488,10 +4814,10 @@ itself</td></tr> <h3>Voir aussi</h3> <ul> -<li><a href="../dns-caveats.html">Issues Regarding DNS and - Apache HTTP Server</a></li> -<li><a href="../vhosts/">Apache HTTP Server virtual host - documentation</a></li> +<li><a href="../dns-caveats.html">Problèmes concernant le DNS et +le serveur HTTP Apache</a></li> +<li><a href="../vhosts/">Documentation sur les serveurs virtuels +du serveur HTTP Apache</a></li> <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li> <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li> @@ -4500,60 +4826,64 @@ itself</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="serverpath" id="serverpath">Directive</a> <a name="ServerPath" id="ServerPath">ServerPath</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Legacy URL pathname for a name-based virtual host that -is accessed by an incompatible browser</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de chemin d'URL hérité pour un serveur virtuel à base +de nom accédé par un navigateur incompatible</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>chemin d'URL</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerPath</code> directive sets the legacy - URL pathname for a host, for use with <a href="../vhosts/">name-based virtual hosts</a>.</p> + <p>La directive <code class="directive">ServerPath</code> permet de définir + le nom de chemin d'URL hérité d'un hôte, à utiliser avec les <a href="../vhosts/">serveurs virtuels à base de nom</a>.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li> +<li><a href="../vhosts/">Documentation sur les serveurs virtuels +du serveur HTTP Apache</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="serverroot" id="serverroot">Directive</a> <a name="ServerRoot" id="ServerRoot">ServerRoot</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Base directory for the server installation</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine du répertoire d'installation du +serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>chemin de répertoire</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerRoot</code> directive sets the - directory in which the server lives. Typically it will contain the - subdirectories <code>conf/</code> and <code>logs/</code>. Relative - paths in other configuration directives (such as <code class="directive"><a href="#include">Include</a></code> or <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>, for example) are taken as - relative to this directory.</p> + <p>La directive <code class="directive">ServerRoot</code> permet de définir + le répertoire dans lequel le serveur est installé. En particulier, + il contiendra les sous-répertoires <code>conf/</code> et + <code>logs/</code>. Les chemins relatifs indiqués dans les autres + directives (comme <code class="directive"><a href="#include">Include</a></code> ou <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>) seront définis par + rapport à ce répertoire.</p> <pre class="prettyprint lang-config">ServerRoot "/home/httpd"</pre> - <p>The default location of <code class="directive">ServerRoot</code> may be - modified by using the <code>--prefix</code> argument to - <a href="../programs/configure.html"><code>configure</code></a>, and - most third-party distributions of the server have a different - default location from the one listed above.</p> + <p>La valeur par défaut de <code class="directive">ServerRoot</code> peut + être modifiée via l'argument <code>--prefix</code> de la commande <a href="../programs/configure.html"><code>configure</code></a>, et de + nombreuses distributions tierces du serveur proposent une valeur + différente de celles listées ci-dessus.</p> <h3>Voir aussi</h3> <ul> <li><a href="../invoking.html">the <code>-d</code> - option to <code>httpd</code></a></li> -<li><a href="../misc/security_tips.html#serverroot">the - security tips</a> for information on how to properly set - permissions on the <code class="directive">ServerRoot</code></li> + options de <code>httpd</code></a></li> +<li><a href="../misc/security_tips.html#serverroot">les conseils à +propos de sécurité</a> pour des informations sur la manière de définir +correctement les permissions sur le répertoire indiqué par la directive +<code class="directive">ServerRoot</code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="serversignature" id="serversignature">Directive</a> <a name="ServerSignature" id="ServerSignature">ServerSignature</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the footer on server-generated documents</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit un pied de page pour les documents générés par le +serveur</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerSignature Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> @@ -4561,25 +4891,28 @@ is accessed by an incompatible browser</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">ServerSignature</code> directive allows the - configuration of a trailing footer line under server-generated - documents (error messages, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> ftp directory - listings, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> output, ...). The reason why you - would want to enable such a footer line is that in a chain of proxies, - the user often has no possibility to tell which of the chained servers - actually produced a returned error message.</p> - - <p>The <code>Off</code> - setting, which is the default, suppresses the footer line (and is - therefore compatible with the behavior of Apache-1.2 and - below). The <code>On</code> setting simply adds a line with the - server version number and <code class="directive"><a href="#servername">ServerName</a></code> of the serving virtual host, - and the <code>EMail</code> setting additionally creates a - "mailto:" reference to the <code class="directive"><a href="#serveradmin">ServerAdmin</a></code> of the referenced - document.</p> - - <p>After version 2.0.44, the details of the server version number - presented are controlled by the <code class="directive"><a href="#servertokens">ServerTokens</a></code> directive.</p> + <p>La directive <code class="directive">ServerSignature</code> permet de + définir une ligne de pied de page fixe pour les documents générés + par le serveur (messages d'erreur, listings de répertoires ftp de + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, sorties de <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, + etc...). Dans le cas d'une chaîne de mandataires, l'utilisateur n'a + souvent aucun moyen de déterminer lequel des mandataires chaînés a + généré un message d'erreur, et c'est une des raisons pour lesquelles + on peut être amené à ajouter un tel pied de page.</p> + + <p>La valeur par défaut <code>Off</code> supprime la ligne de pied + de page (et est ainsi compatible avec le comportement des + versions 1.2 et antérieures d'Apache). la valeur <code>On</code> + ajoute simplement une ligne contenant le numéro de version du + serveur ainsi que le nom du serveur virtuel issu de la directive + <code class="directive"><a href="#servername">ServerName</a></code>, alors que la valeur + <code>EMail</code> ajoute en plus une référence "mailto:" à + l'administrateur du document référencé issu la directive + <code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p> + + <p>Après la version 2.0.44, les détails à propos du numéro de + version du serveur sont contrôlés à l'aide de la directive + <code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p> <h3>Voir aussi</h3> <ul> @@ -4589,64 +4922,72 @@ is accessed by an incompatible browser</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="servertokens" id="servertokens">Directive</a> <a name="ServerTokens" id="ServerTokens">ServerTokens</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the <code>Server</code> HTTP response -header</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-tête <code>Server</code> de la réponse +HTTP</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerTokens Full</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive controls whether <code>Server</code> response - header field which is sent back to clients includes a - description of the generic OS-type of the server as well as - information about compiled-in modules.</p> + <p>Cette directive permet de contrôler le contenu de l'en-tête + <code>Server</code> inclus dans la réponse envoyée au client : cet + en-tête peut contenir le type de système d'exploitation du serveur, + ainsi que des informations à propos des modules compilés avec le + serveur.</p> <dl> - <dt><code>ServerTokens Full</code> (or not specified)</dt> + <dt><code>ServerTokens Full</code> (ou non spécifié)</dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.4.2 - (Unix) PHP/4.2.2 MyMod/1.2</code></dd> + <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.2 + (Unix) PHP/4.2.2 MyMod/1.2</code></dd> - <dt><code>ServerTokens Prod[uctOnly]</code></dt> + <dt><code>ServerTokens Prod[uctOnly]</code></dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: + <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: Apache</code></dd> <dt><code>ServerTokens Major</code></dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: + <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: Apache/2</code></dd> <dt><code>ServerTokens Minor</code></dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: + <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: Apache/2.4</code></dd> <dt><code>ServerTokens Min[imal]</code></dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: + <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: Apache/2.4.2</code></dd> <dt><code>ServerTokens OS</code></dt> - <dd>Server sends (<em>e.g.</em>): <code>Server: Apache/2.4.2 - (Unix)</code></dd> + <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: + Apache/2.4.2 (Unix)</code></dd> + + </dl> - <p>This setting applies to the entire server, and cannot be - enabled or disabled on a virtualhost-by-virtualhost basis.</p> + <p>Cette définition s'applique à l'ensemble du serveur et ne peut + être activée ou désactivée pour tel ou tel serveur virtuel.</p> + + <p>Dans les versions postérieures à 2.0.44, cette directive contrôle + aussi les informations fournies par la directive <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p> + + <div class="note">Définir <code class="directive">ServerTokens</code> à une + valeur inférieure à <code>minimal</code> n'est pas + recommandé car le débogage des problèmes + interopérationnels n'en sera alors que plus difficile. Notez + aussi que la désactivation de l'en-tête Server: + n'améliore en rien la sécurité de votre + serveur ; le concept de "sécurité par + l'obscurité" est un mythe et conduit à + une mauvaise perception de ce qu'est la sécurité.</div> - <p>After version 2.0.44, this directive also controls the - information presented by the <code class="directive"><a href="#serversignature">ServerSignature</a></code> directive.</p> - <div class="note">Setting <code class="directive">ServerTokens</code> to less than - <code>minimal</code> is not recommended because it makes it more - difficult to debug interoperational problems. Also note that - disabling the Server: header does nothing at all to make your - server more secure. The idea of "security through obscurity" - is a myth and leads to a false sense of safety.</div> <h3>Voir aussi</h3> <ul> @@ -4656,61 +4997,64 @@ header</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="sethandler" id="sethandler">Directive</a> <a name="SetHandler" id="SetHandler">SetHandler</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Forces all matching files to be processed by a -handler</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers spécifiés par un +gestionnaire particulier</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetHandler <var>handler-name</var>|none|<var>expression</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.5 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5 du serveur HTTP Apache</td></tr> </table> - <p>When placed into an <code>.htaccess</code> file or a - <code class="directive"><a href="#directory"><Directory></a></code> or - <code class="directive"><a href="#location"><Location></a></code> - section, this directive forces all matching files to be parsed - through the <a href="../handler.html">handler</a> given by - <var>handler-name</var>. For example, if you had a directory you - wanted to be parsed entirely as imagemap rule files, regardless - of extension, you might put the following into an - <code>.htaccess</code> file in that directory:</p> + <p>Lorsqu'elle se situe à l'intérieur d'un fichier + <code>.htaccess</code>, ou d'une section <code class="directive"><a href="#directory"><Directory></a></code> ou <code class="directive"><a href="#location"><Location></a></code>, cette directive force le + traitement de tous les fichiers spécifiés par le <a href="../handler.html">gestionnaire</a> défini par l'argument + <var>nom gestionnaire</var>. Par exemple, dans le cas d'un + répertoire dont vous voulez interpréter le contenu comme des + fichiers de règles d'images cliquables, sans tenir compte des + extensions, vous pouvez ajouter la ligne suivante dans un fichier + <code>.htaccess</code> de ce répertoire :</p> <pre class="prettyprint lang-config">SetHandler imap-file</pre> - <p>Another example: if you wanted to have the server display a - status report whenever a URL of - <code>http://servername/status</code> was called, you might put - the following into <code>httpd.conf</code>:</p> + <p>Autre exemple : si vous voulez que le serveur affiche un + compte-rendu d'état chaque fois qu'une URL du type <code>http://nom + serveur/status</code> est appelée, vous pouvez ajouter ceci dans + <code>httpd.conf</code> :</p> <pre class="prettyprint lang-config"><Location "/status"> SetHandler server-status </Location></pre> - <p>You could also use this directive to configure a particular - handler for files with a particular file extension. For example:</p> + <p>Vous pouvez aussi utiliser cette directive pour associer un + gestionnaire à des fichiers possèdant une extension de nom de + fichier particulière. Par exemple :</p> <pre class="prettyprint lang-config"><FilesMatch "\.php$"> SetHandler application/x-httpd-php </FilesMatch></pre> - <p>String-valued expressions can be used to reference per-request - variables, including backreferences to named regular expressions:</p> + <p>On peut utiliser des expressions ayant pour valeur des chaînes pour + référencer des variables spécifiques à une requête, y compris les + références arrières vers des expressions rationnelles nommées :</p> <pre class="prettyprint lang-config"><LocationMatch ^/app/(?<sub>[^/]+)/> SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080" </LocationMatch></pre> - <p>You can override an earlier defined <code class="directive">SetHandler</code> - directive by using the value <code>None</code>.</p> + <p>Vous pouvez écraser la définition antérieure d'une directive + <code class="directive">SetHandler</code> en utilisant la valeur + <code>None</code>.</p> <div class="note"><h3>Note</h3> - <p>Because <code class="directive">SetHandler</code> overrides default handlers, - normal behavior such as handling of URLs ending in a slash (/) as - directories or index files is suppressed.</p></div> + <p>Comme <code class="directive">SetHandler</code> l'emporte sur la + définition des gestionnaires par défaut, le comportement habituel + consistant à traiter les URLs se terminant par un slash (/) comme + des répertoires ou des fichiers index est désactivé.</p></div> <h3>Voir aussi</h3> <ul> @@ -4720,60 +5064,58 @@ handler</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="setinputfilter" id="setinputfilter">Directive</a> <a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process client requests and POST -input</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les requêtes +client et les données POST</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">SetInputFilter</code> directive sets the - filter or filters which will process client requests and POST - input when they are received by the server. This is in addition to - any filters defined elsewhere, including the - <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code> - directive.</p> + <p>La directive <code class="directive">SetInputFilter</code> permet de + définir le ou les filtres par lesquels vont passer les requêtes + client et les données POST au moment où le serveur les reçoit. Cette + définition vient en ajout à tout autre filtre défini en + quelqu'endroit que ce soit, y compris via la directive <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p> - <p>If more than one filter is specified, they must be separated - by semicolons in the order in which they should process the - content.</p> + <p>Si la directive comporte plusieurs filtres, ils doivent être + séparés par des points-virgules, et spécifiés selon l'ordre dans + lequel vous souhaitez les voir agir sur les contenus.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../filter.html">Filters</a> documentation</li> +<li>documentation des <a href="../filter.html">Filtres</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="setoutputfilter" id="setoutputfilter">Directive</a> <a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the filters that will process responses from the -server</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les réponses +du serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">SetOutputFilter</code> directive sets the filters - which will process responses from the server before they are - sent to the client. This is in addition to any filters defined - elsewhere, including the - <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> - directive.</p> + <p>La directive <code class="directive">SetOutputFilter</code> permet de + définir les filtres par lesquels vont passer les réponses du serveur + avant d'être envoyées au client. Cette définition vient en ajout à + tout autre filtre défini en quelqu'endroit que ce soit, y compris + via la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p> - <p>For example, the following configuration will process all files - in the <code>/www/data/</code> directory for server-side - includes.</p> + <p>Par exemple, la configuration suivante va traiter tous les + fichiers du répertoire <code>/www/data/</code> comme des inclusions + côté serveur (SSI) :</p> <pre class="prettyprint lang-config"><Directory "/www/data/"> SetOutputFilter INCLUDES </Directory></pre> - <p>If more than one filter is specified, they must be separated - by semicolons in the order in which they should process the - content.</p> + <p>Si la directive comporte plusieurs filtres, ils doivent être + séparés par des points-virgules, et spécifiés selon l'ordre dans + lequel vous souhaitez les voir agir sur les contenus.</p> <h3>Voir aussi</h3> <ul> @@ -4783,40 +5125,41 @@ server</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="timeout" id="timeout">Directive</a> <a name="TimeOut" id="TimeOut">TimeOut</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Amount of time the server will wait for -certain events before failing a request</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps pendant lequel le serveur va attendre certains +évènements avant de considérer qu'une requête a échoué</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TimeOut <var>time-interval</var>[s]</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TimeOut 60</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>The <code class="directive">TimeOut</code> directive defines the length - of time Apache httpd will wait for I/O in various circumstances:</p> + <p>La directive <code class="directive">TimeOut</code> permet de définir le + temps maximum pendant lequel Apache httpd va attendre des entrées/sorties + selon les circonstances :</p> <ul> - <li><p>When reading data from the client, the length of time to - wait for a TCP packet to arrive if the read buffer is - empty.</p> - <p> For initial data on a new connection, this directive doesn't - take effect until after any configured <code class="directive"><a href="#acceptfilter"> - AcceptFilter</a></code> has passed the new connection to the server.</p> + <li><p>Lors de la lecture de données en provenance du client, le + temps maximum jusqu'à l'arrivée d'un paquet TCP si le tampon est + vide.</p> + <p>Pour les données initiales d'une nouvelle connexion, et tant qu'une + directive <code class="directive"><a href="#acceptfilter">AcceptFilter</a></code> n'aura pas + transmis cette nouvelle connexion au serveur, cette directive n'aura aucun + effet.</p> </li> - <li>When writing data to the client, the length of time to wait - for an acknowledgement of a packet if the send buffer is - full.</li> + <li>Lors de l'écriture de données destinées au client, le temps + maximum jusqu'à l'arrivée de l'accusé-réception d'un paquet si le + tampon d'envoi est plein.</li> - <li>In <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> and <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, - the length of time to wait for any individual block of output - from a CGI script.</li> + <li>Avec <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> et <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, le temps + d'attente maximum pour un bloc individuel en sortie d'un script CGI.</li> - <li>In <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, the length of time to - wait for output from a filtering process.</li> + <li>Avec <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, le temps d'attente + maximum des sorties d'un processus de filtrage.</li> - <li>In <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, the default timeout value if - <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> is not - configured.</li> + <li>Avec <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, la valeur du délai par défaut + si <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> n'est + pas défini.</li> </ul> @@ -4824,55 +5167,61 @@ certain events before failing a request</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="traceenable" id="traceenable">Directive</a> <a name="TraceEnable" id="TraceEnable">TraceEnable</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the behavior on <code>TRACE</code> requests</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le comportement des requêtes +<code>TRACE</code></td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TraceEnable on</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>This directive overrides the behavior of <code>TRACE</code> for both - the core server and <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. The default - <code>TraceEnable on</code> permits <code>TRACE</code> requests per - RFC 2616, which disallows any request body to accompany the request. - <code>TraceEnable off</code> causes the core server and - <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> to return a <code>405</code> (Method not - allowed) error to the client.</p> - - <p>Finally, for testing and diagnostic purposes only, request - bodies may be allowed using the non-compliant <code>TraceEnable - extended</code> directive. The core (as an origin server) will - restrict the request body to 64Kb (plus 8Kb for chunk headers if - <code>Transfer-Encoding: chunked</code> is used). The core will - reflect the full headers and all chunk headers with the response - body. As a proxy server, the request body is not restricted to 64Kb.</p> + <p>Cette directive l'emporte sur le comportement de + <code>TRACE</code> pour le noyau du serveur et + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. La définition par défaut + <code>TraceEnable on</code> permet des requêtes <code>TRACE</code> + selon la RFC 2616, qui interdit d'ajouter tout corps à la requête. + La définition <code>TraceEnable off</code> indique au noyau du + serveur et à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> de retourner un code + d'erreur <code>405</code> (Méthode non autorisée) au client.</p> + + <p>En fait, et à des fins de test et de diagnostic seulement, on + peut autoriser l'ajout d'un corps de requête à l'aide de la + définition non standard <code>TraceEnable extended</code>. Le noyau + du serveur (dans le cas d'un serveur d'origine) va limiter la taille + du corps de requête à 64Kb (plus 8Kb pour les en-têtes de + fractionnement si <code>Transfer-Encoding: chunked</code> est + utilisé). Le noyau du serveur va reproduire l'ensemble des en-têtes, + y compris les en-têtes de fractionnement avec le corps de la + réponse. Dans le cas d'un serveur mandataire, la taille du corps de + requête n'est pas limitée à 64Kb.</p> <div class="note"><h3>Note</h3> - - <p>Despite claims to the contrary, enabling the <code>TRACE</code> - method does not expose any security vulnerability in Apache httpd. - The <code>TRACE</code> method is defined by the HTTP/1.1 - specification and implementations are expected to support it.</p> - + <p>Bien que certains prétendent le contraire, activer la méthode + <code>TRACE</code> ne constitue pas un problème de sécurité dans Apache + httpd. La méthode <code>TRACE</code> est définie par la spécification + HTTP/1.1 et les différentes implémentations sont censées la supporter.</p> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="undefine" id="undefine">Directive</a> <a name="UnDefine" id="UnDefine">UnDefine</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine the existence of a variable</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Invalide la définition d'une variable</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnDefine <var>nom-variable</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Undoes the effect of a <code class="directive"><a href="#define">Define</a></code> or - of passing a <code>-D</code> argument to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> - <p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter - <code>-D</code> arguments in any startup scripts.</p> - <p>While this directive is supported in virtual host context, - the changes it makes are visible to any later configuration - directives, beyond any enclosing virtual host.</p> + <p>Annule l'effet d'une directive <code class="directive"><a href="#define">Define</a></code> ou d'un argument <code>-D</code> de + <code class="program"><a href="../programs/httpd.html">httpd</a></code> en invalidant l'existence de la variable + correspondante.</p> + <p>On peut utiliser cette directive pour inverser l'effet d'une + section <code class="directive"><a href="#ifdefine"><IfDefine></a></code> + sans avoir à modifier les arguments <code>-D</code> dans les scripts + de démarrage.</p> + <p>Si cette directive est définie au sein d'un bloc VirtualHost, les + changements qu'elle induit sont visibles de toute directive + ultérieure, au delà de tout bloc VirtualHost.</p> <h3>Voir aussi</h3> <ul> @@ -4883,58 +5232,64 @@ certain events before failing a request</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="usecanonicalname" id="usecanonicalname">Directive</a> <a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own name and -port</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur détermine son propre nom +et son port</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalName Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>In many situations Apache httpd must construct a <em>self-referential</em> - URL -- that is, a URL that refers back to the same server. With - <code>UseCanonicalName On</code> Apache httpd will use the hostname and port - specified in the <code class="directive"><a href="#servername">ServerName</a></code> - directive to construct the canonical name for the server. This name - is used in all self-referential URLs, and for the values of - <code>SERVER_NAME</code> and <code>SERVER_PORT</code> in CGIs.</p> - - <p>With <code>UseCanonicalName Off</code> Apache httpd will form - self-referential URLs using the hostname and port supplied by - the client if any are supplied (otherwise it will use the - canonical name, as defined above). These values are the same - that are used to implement <a href="../vhosts/name-based.html">name-based virtual hosts</a> - and are available with the same clients. The CGI variables - <code>SERVER_NAME</code> and <code>SERVER_PORT</code> will be - constructed from the client supplied values as well.</p> - - <p>An example where this may be useful is on an intranet server - where you have users connecting to the machine using short - names such as <code>www</code>. You'll notice that if the users - type a shortname and a URL which is a directory, such as - <code>http://www/splat</code>, <em>without the trailing - slash</em>, then Apache httpd will redirect them to - <code>http://www.example.com/splat/</code>. If you have - authentication enabled, this will cause the user to have to - authenticate twice (once for <code>www</code> and once again - for <code>www.example.com</code> -- see <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F"> - the FAQ on this subject for more information</a>). But if - <code class="directive">UseCanonicalName</code> is set <code>Off</code>, then - Apache httpd will redirect to <code>http://www/splat/</code>.</p> - - <p>There is a third option, <code>UseCanonicalName DNS</code>, - which is intended for use with mass IP-based virtual hosting to - support ancient clients that do not provide a - <code>Host:</code> header. With this option, Apache httpd does a - reverse DNS lookup on the server IP address that the client - connected to in order to work out self-referential URLs.</p> - - <div class="warning"><h3>Warning</h3> - <p>If CGIs make assumptions about the values of <code>SERVER_NAME</code>, - they may be broken by this option. The client is essentially free - to give whatever value they want as a hostname. But if the CGI is - only using <code>SERVER_NAME</code> to construct self-referential URLs, - then it should be just fine.</p> + <p>Dans de nombreuses situations, Apache httpd doit construire une URL + <em>auto-identifiante</em> -- c'est à dire une URL qui fait + référence au serveur lui-même. Avec <code>UseCanonicalName + On</code>, Apache httpd va utiliser le nom d'hôte et le port spécifiés par + la directive <code class="directive"><a href="#servername">ServerName</a></code> pour + construire le nom canonique du serveur. Ce nom est utilisé dans + toutes les URLs auto-identifiantes, et affecté aux variables + <code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les + programmes CGI.</p> + + <p>Avec <code>UseCanonicalName Off</code>, Apache httpd va construire ses + URLs auto-identifiantes à l'aide du nom d'hôte et du port fournis + par le client, si ce dernier en a fourni un (dans la négative, + Apache utilisera le nom canonique, de la même manière que + ci-dessus). Ces valeurs sont les mêmes que celles qui sont utilisées + pour implémenter les <a href="../vhosts/name-based.html">serveurs virtuels à base de + nom</a>, et sont disponibles avec les mêmes clients. De même, les + variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code> + seront affectées des valeurs fournies par le client.</p> + + <p>Cette directive peut s'avérer utile, par exemple, sur un serveur + intranet auquel les utilisateurs se connectent en utilisant des noms + courts tels que <code>www</code>. Si les utilisateurs tapent un nom + court suivi d'une URL qui fait référence à un répertoire, comme + <code>http://www/splat</code>, <em>sans le slash terminal</em>, vous + remarquerez qu'Apache httpd va les rediriger vers + <code>http://www.example.com/splat/</code>. Si vous avez activé + l'authentification, ceci va obliger l'utilisateur à s'authentifier + deux fois (une première fois pour <code>www</code> et une seconde + fois pour <code>www.example.com</code> -- voir <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">la + foire aux questions sur ce sujet pour plus d'informations</a>). + Par contre, si <code class="directive">UseCanonicalName</code> est définie à + <code>Off</code>, Apache httpd redirigera l'utilisateur vers + <code>http://www/splat/</code>.</p> + + <p>Pour l'hébergement virtuel en masse à base d'adresse IP, on + utilise une troisième option, <code>UseCanonicalName + DNS</code>, pour supporter les clients anciens qui ne + fournissent pas d'en-tête <code>Host:</code>. Apache httpd effectue alors + une recherche DNS inverse sur l'adresse IP du serveur auquel le + client s'est connecté afin de construire ses URLs + auto-identifiantes.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>Les programmes CGI risquent d'être perturbés par cette option + s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le + client est pratiquement libre de fournir la valeur qu'il veut comme + nom d'hôte. Mais si le programme CGI n'utilise + <code>SERVER_NAME</code> que pour construire des URLs + auto-identifiantes, il ne devrait pas y avoir de problème.</p> </div> <h3>Voir aussi</h3> @@ -4947,48 +5302,51 @@ port</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures how the server determines its own port</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur +détermine son propre port</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>In many situations Apache httpd must construct a <em>self-referential</em> - URL -- that is, a URL that refers back to the same server. With - <code>UseCanonicalPhysicalPort On</code>, Apache httpd will, when - constructing the canonical port for the server to honor - the <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> directive, - provide the actual physical port number being used by this request - as a potential port. With <code>UseCanonicalPhysicalPort Off</code>, - Apache httpd will not ever use the actual physical port number, instead - relying on all configured information to construct a valid port number.</p> + <p>Dans de nombreuses situations, Apache httpd doit construire une URL + <em>auto-identifiante</em> -- c'est à dire une URL qui fait + référence au serveur lui-même. Avec <code>UseCanonicalPhysicalPort + On</code>, Apache httpd va fournir le numéro de port physique réel utilisé + par la requête en tant que port potentiel, pour construire le port + canonique afin que le serveur puisse alimenter la directive + <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec + <code>UseCanonicalPhysicalPort Off</code>, Apache httpd n'utilisera pas le + numéro de port physique réel, mais au contraire se référera aux + informations de configuration pour construire un numéro de port + valide.</p> <div class="note"><h3>Note</h3> - <p>The ordering of the lookup when the physical port is used is as - follows:</p> + <p>L'ordre dans lequel s'effectue la recherche quand on utilise le + port physique est le suivant :</p> <dl> <dt><code>UseCanonicalName On</code></dt> <dd> <ol> - <li>Port provided in <code class="directive"><a href="#servername">Servername</a></code></li> - <li>Physical port</li> - <li>Default port</li> + <li>Port indiqué dans <code class="directive"><a href="#servername">Servername</a></code></li> + <li>Port physique</li> + <li>Port par défaut</li> </ol> </dd> <dt><code>UseCanonicalName Off | DNS</code></dt> <dd> <ol> - <li>Parsed port from <code>Host:</code> header</li> - <li>Physical port</li> - <li>Port provided in <code class="directive"><a href="#servername">Servername</a></code></li> - <li>Default port</li> + <li>Port spécifié dans l'en-tête <code>Host:</code></li> + <li>Port physique</li> + <li>Port spécifié par <code class="directive"><a href="#servername">Servername</a></code></li> + <li>Port par défaut</li> </ol> </dd> </dl> - <p>With <code>UseCanonicalPhysicalPort Off</code>, the - physical ports are removed from the ordering.</p> + <p>Avec <code>UseCanonicalPhysicalPort Off</code>, on reprend + l'ordre ci-dessus en supprimant "Port physique".</p> </div> @@ -5002,35 +5360,38 @@ port</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="virtualhost" id="virtualhost">Directive</a> <a name="VirtualHost" id="VirtualHost"><VirtualHost></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contains directives that apply only to a specific -hostname or IP address</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'à un nom +d'hôte spécifique ou à une adresse IP</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><VirtualHost - <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]] - ...> ... </VirtualHost></code></td></tr> + <var>adresse IP</var>[:<var>port</var>] [<var>adresse + IP</var>[:<var>port</var>]] ...> ... + </VirtualHost></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p><code class="directive"><VirtualHost></code> and - <code></VirtualHost></code> are used to enclose a group of - directives that will apply only to a particular virtual host. Any - directive that is allowed in a virtual host context may be - used. When the server receives a request for a document on a - particular virtual host, it uses the configuration directives - enclosed in the <code class="directive"><VirtualHost></code> - section. <var>Addr</var> can be any of the following, optionally followed by - a colon and a port number (or *):</p> + <p>Les balises <code class="directive"><VirtualHost></code> et + <code></VirtualHost></code> permettent de rassembler un groupe + de directives qui ne s'appliquent qu'à un serveur virtuel + particulier. Toute directive autorisée dans un contexte de serveur + virtuel peut être utilisée. Lorsque le serveur reçoit un requête + pour un document hébergé par un serveur virtuel particulier, il + applique les directives de configuration rassemblées dans la section + <code class="directive"><VirtualHost></code>. <var>adresse + IP</var> peut être une des entités suivantes, éventuellement suivies + d'un caractère ':' et d'un numéro de port (ou *) :</p> <ul> - <li>The IP address of the virtual host;</li> + <li>L'adresse IP du serveur virtuel ;</li> - <li>A fully qualified domain name for the IP address of the - virtual host (not recommended);</li> + <li>Un nom de domaine entièrement qualifié correspondant à + l'adresse IP du serveur virtuel (non recommandé) ;</li> - <li>The character <code>*</code>, which acts as a wildcard and matches - any IP address.</li> + <li>Le caractère <code>*</code>, qui agit comme un + caractère générique, et correspond à toute adresse IP.</li> - <li>The string <code>_default_</code>, which is an alias for <code>*</code></li> + <li>La chaîne <code>_default_</code>, dont la signification est + identique à celle du caractère <code>*</code></li> </ul> @@ -5044,9 +5405,10 @@ hostname or IP address</td></tr> - <p>IPv6 addresses must be specified in square brackets because - the optional port number could not be determined otherwise. An - IPv6 example is shown below:</p> + <p>Les adresses IPv6 doivent être entourées de crochets car dans le + cas contraire, un éventuel port optionnel ne pourrait pas être + déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 + :</p> <pre class="prettyprint lang-config"><VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> ServerAdmin webmaster@host.example.com @@ -5057,83 +5419,94 @@ hostname or IP address</td></tr> </VirtualHost></pre> - <p>Each Virtual Host must correspond to a different IP address, - different port number, or a different host name for the server, - in the former case the server machine must be configured to - accept IP packets for multiple addresses. (If the machine does - not have multiple network interfaces, then this can be - accomplished with the <code>ifconfig alias</code> command -- if - your OS supports it).</p> + <p>Chaque serveur virtuel doit correspondre à une adresse IP, un + port ou un nom d'hôte spécifique ; dans le premier cas, le serveur + doit être configuré pour recevoir les paquets IP de plusieurs + adresses (si le serveur n'a qu'une interface réseau, on peut + utiliser à cet effet la commande <code>ifconfig alias</code> -- si + votre système d'exploitation le permet).</p> <div class="note"><h3>Note</h3> - <p>The use of <code class="directive"><VirtualHost></code> does - <strong>not</strong> affect what addresses Apache httpd listens on. You - may need to ensure that Apache httpd is listening on the correct addresses - using <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> + <p>L'utilisation de la directive <code class="directive"><VirtualHost></code> n'affecte en rien les + adresses IP sur lesquelles Apache httpd est en écoute. Vous devez vous + assurer que les adresses des serveurs virtuels sont bien incluses + dans la liste des adresses précisées par la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> </div> - - <p>A <code class="directive"><a href="#servername">ServerName</a></code> should be - specified inside each <code class="directive"><VirtualHost></code> block. If it is absent, the - <code class="directive"><a href="#servername">ServerName</a></code> from the "main" - server configuration will be inherited.</p> - - <p>When a request is received, the server first maps it to the best matching - <code class="directive"><VirtualHost></code> based on the local - IP address and port combination only. Non-wildcards have a higher - precedence. If no match based on IP and port occurs at all, the - "main" server configuration is used.</p> - - <p>If multiple virtual hosts contain the best matching IP address and port, - the server selects from these virtual hosts the best match based on the - requested hostname. If no matching name-based virtual host is found, - then the first listed virtual host that matched the IP address will be - used. As a consequence, the first listed virtual host for a given IP address - and port combination is the default virtual host for that IP and port - combination.</p> - - <div class="warning"><h3>Security</h3> - <p>See the <a href="../misc/security_tips.html">security tips</a> - document for details on why your security could be compromised if the - directory where log files are stored is writable by anyone other - than the user that starts the server.</p> + + <p>Tout bloc <code class="directive"><VirtualHost></code> doit comporter une directive + <code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas + contraire, le serveur virtuel héritera de la valeur de la directive + <code class="directive"><a href="#servername">ServerName</a></code> issue de la + configuration du serveur principal.</p> + + <p>A l'arrivée d'une requête, le serveur tente de la + faire prendre en compte par la section <code class="directive"><VirtualHost></code> qui correspond le mieux en ne + se basant que sur la paire adresse IP/port. Les chaînes sans + caractères génériques l'emportent sur celles qui en contiennent. Si + aucune correspondance du point de vue de l'adresse IP/port n'est + trouvée, c'est la configuration du serveur "principal" qui sera + utilisée.</p> + + <p>Si plusieurs serveurs virtuels correspondent du point de vue de + l'adresse IP/port, le serveur sélectionne celui qui correspond le + mieux du point de vue du nom d'hôte de la requête. Si aucune + correspondance du point de vue du nom d'hôte n'est trouvée, c'est le + premier serveur virtuel dont l'adresse IP/port correspond qui sera + utilisé. Par voie de conséquence, le premier serveur virtuel + comportant une certaine paire adresse IP/port est le serveur virtuel + par défaut pour cette paire adresse IP/port.</p> + + <div class="warning"><h3>Sécurité</h3> + <p>Voir le document sur les <a href="../misc/security_tips.html">conseils à propos de sécurité</a> + pour une description détaillée des raisons pour lesquelles la + sécurité de votre serveur pourrait être compromise, si le répertoire + contenant les fichiers journaux est inscriptible par tout autre + utilisateur que celui qui démarre le serveur.</p> </div> <h3>Voir aussi</h3> <ul> -<li><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></li> -<li><a href="../dns-caveats.html">Issues Regarding DNS and - Apache HTTP Server</a></li> -<li><a href="../bind.html">Setting - which addresses and ports Apache HTTP Server uses</a></li> -<li><a href="../sections.html">How <Directory>, <Location> - and <Files> sections work</a> for an explanation of how these - different sections are combined when a request is received</li> +<li><a href="../vhosts/">Documentation des serveurs virtuels +du serveur HTTP Apache</a></li> +<li><a href="../dns-caveats.html">Problèmes concernant le DNS et +le serveur HTTP Apache</a></li> +<li><a href="../bind.html">Définition des adresses et ports +qu'utilise le serveur HTTP Apache</a></li> +<li><a href="../sections.html">Comment fonctionnent les sections +<Directory>, <Location> et <Files></a> pour une +explication de la manière dont ces différentes sections se combinent +entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="warning" id="warning">Directive</a> <a name="Warning" id="Warning">Warning</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Warn from configuration parsing with a custom message</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Message d'avertissement personnalisable en provenance de +l'interprétation du fichier de configuration</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Warning <var>message</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.5 and later</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5 du serveur HTTP +Apache.</td></tr> </table> - <p>If an issue can be detected from within the configuration, this - directive can be used to generate a custom warning message. The - configuration parsing is not halted. The typical use is to check - whether some user define options are set, and warn if not.</p> - - <pre class="prettyprint lang-config"># Example -# tell when ReverseProxy is not set + <p>Cette directive permet de signaler la détection d'un problème de + configuration en générant un message d'avertissement + personnalisable. L'interprétation du fichier de configuration n'est + pas interrompue. Un exemple typique d'utilisation est la + vérification de la définition de certaines options définies par + l'utilisateur, et l'envoi d'un avertissement éventuel.</p> + + <pre class="prettyprint lang-config"># Exemple +# signale que ReverseProxy n'est pas défini <IfDefine !ReverseProxy> - Warning "reverse proxy is not started, hope this is okay!" + Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger + si nécessaire" </IfDefine> <IfDefine ReverseProxy> - # define custom proxy configuration + # définition de la configuration personnalisée du mandataire </IfDefine></pre> |