You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by el...@apache.org on 2017/08/28 12:37:16 UTC
svn commit: r1806444 [2/28] - /httpd/httpd/trunk/docs/manual/mod/
Modified: httpd/httpd/trunk/docs/manual/mod/core.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.html.fr?rev=1806444&r1=1806443&r2=1806444&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.html.fr Mon Aug 28 12:37:14 2017
@@ -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>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>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>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>
+ <h3>L'AcceptFilter <code>data</code> (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>
+ <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>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>The three possible arguments for the
- <code class="directive">AcceptPathInfo</code> directive are:</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>
<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>With the default value, <code>Off</code>, such URLs are refused
- with a 404 (Not found) error.</p>
-
- <p>With the value <code>On</code>, such URLs are accepted, and encoded
- slashes are decoded like all other encoded characters.</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>Turning <code class="directive">AllowEncodedSlashes</code> <code>On</code> is
- mostly useful when used in conjunction with <code>PATH_INFO</code>.</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>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>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>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>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
<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>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>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>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>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>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 d
u
+ 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>
-
- <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>
+ <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>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
<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
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
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>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>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>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>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>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>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 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>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><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>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>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
<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
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)
[... 6559 lines stripped ...]