<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>
<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>
<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
<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>
<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>
<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>
<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>
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>
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>
<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>
<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
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
</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')">
# ...
</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'">
#...
</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>
<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
<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."
<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
</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'"
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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
<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
<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>
<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>
<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>
<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>
<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
</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>
<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>
<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>
<tr>
<td><code>error</code> </td>
- <td>Error conditions.</td>
+ <td>Erreurs.</td>
<td>"Premature end of script headers"</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>
<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>
<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>
<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">
<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>
<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>
<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>
<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>
<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>
<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
</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
</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>
<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>
<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>
<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>
<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>
<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>
<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>
<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
# ...
</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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
- <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
</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>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="asyncrequestworkerfactor" id="asyncrequestworkerfactor">Directive</a> <a name="AsyncRequestWorkerFactor" id="AsyncRequestWorkerFactor">AsyncRequestWorkerFactor</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit concurrent connections per process</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AsyncRequestWorkerFactor <var>factor</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de connexions simultanées par thread</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AsyncRequestWorkerFactor <var>facteur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>2</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>event</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.13 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.13</td></tr>
</table>
- <p>The event MPM handles some connections in an asynchronous way, where
- request worker threads are only allocated for short periods of time as
- needed, and other connections with one request worker thread reserved per
- connection. This can lead to situations where all workers are tied up and
- no worker thread is available to handle new work on established async
- connections.</p>
-
- <p>To mitigate this problem, the event MPM does two things:</p>
+ <p>Le MPM event gère certaines connexions de manière asynchrone ;
+ dans ce cas, les threads traitant la requête sont alloués selon les
+ besoins et pour de courtes périodes. Dans les autres cas, un
+ thread est réservé par
+ connexion. Ceci peut conduire à des situations où tous les threads
+ sont saturés et où aucun thread n'est capable d'effectuer de
+ nouvelles tâches pour les connexions asynchrones établies.</p>
+
+ <p>Pour minimiser les effets de ce problème, le MPM event utilise
+ deux méthodes :</p>
<ul>
- <li>it limits the number of connections accepted per process, depending on the
- number of idle request workers;</li>
- <li>if all workers are busy, it will
- close connections in keep-alive state even if the keep-alive timeout has
- not expired. This allows the respective clients to reconnect to a
- different process which may still have worker threads available.</li>
+ <li>il limite le nombre de connexions
+ simultanées par thread en fonction du nombre de processus
+ inactifs;</li>
+ <li>si tous les processus sont occupés, il ferme des connexions
+ permanentes, même si la limite de durée de la connexion n'a
+ pas été atteinte. Ceci autorise les clients
+ concernés à se reconnecter à un autre processus
+ possèdant encore des threads disponibles.</li>
</ul>
- <p>This directive can be used to fine-tune the per-process connection
- limit. A <strong>process</strong> will only accept new connections if the current number of
- connections (not counting connections in the "closing" state) is lower
- than:</p>
+ <p>Cette directive permet de personnaliser finement la limite du
+ nombre de connexions par thread. Un <strong>processus</strong> n'acceptera de
+ nouvelles connexions que si le nombre actuel de connexions (sans
+ compter les connexions à l'état "closing") est
+ inférieur à :</p>
<p class="indent"><strong>
<code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> +
(<code class="directive">AsyncRequestWorkerFactor</code> *
- <var>number of idle workers</var>)
+ <var>nombre de threads inactifs</var>)
</strong></p>
- <p>An estimation of the maximum concurrent connections across all the processes given
- an average value of idle worker threads can be calculated with:
+ <p>Il est possible d'effectuer une estimation du nombre maximum de
+ connexions simultanées pour tous les processus et pour un nombre donné moyen
+ de threads de travail inactifs comme suit :
</p>
<p class="indent"><strong>
(<code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> +
(<code class="directive">AsyncRequestWorkerFactor</code> *
- <var>number of idle workers</var>)) *
+ <var>number of idle workers</var>)) *
<code class="directive"><a href="../mod/mpm_common.html#serverlimit">ServerLimit</a></code>
</strong></p>
- <div class="note"><h3>Example</h3>
+ <div class="note"><h3>Exemple</h3>
<pre class="prettyprint lang-config">ThreadsPerChild = 10
ServerLimit = 4
AsyncRequestWorkerFactor = 2
MaxRequestWorkers = 40
-idle_workers = 4 (average for all the processes to keep it simple)
+idle_workers = 4 (moyenne pour tous les processus pour faire simple)
-max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
+max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 4)) * 4 = 72</pre>
</div>
- <p>When all the worker threads are idle, then absolute maximum numbers of concurrent
- connections can be calculared in a simpler way:</p>
+ <p>Lorsque tous les threads de travail sont inactifs, le nombre maximum
+ absolu de connexions simultanées peut être calculé de manière plus simple :</p>
<p class="indent"><strong>
(<code class="directive">AsyncRequestWorkerFactor</code> + 1) *
<code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
</strong></p>
-
- <div class="note"><h3>Example</h3>
- <pre class="prettyprint lang-config">ThreadsPerChild = 10
+ <div class="note"><h3>Exemple</h3>
+ <pre class="prettyprint lang-config">ThreadsPerChild = 10
ServerLimit = 4
MaxRequestWorkers = 40
AsyncRequestWorkerFactor = 2</pre>
- <p>If all the processes have all threads idle then: </p>
+ <p>Si tous les threads de tous les processus sont inactifs, alors :</p>
<pre class="prettyprint lang-config">idle_workers = 10</pre>
- <p>We can calculate the absolute maximum numbers of concurrent connections in two ways:</p>
-
- <pre class="prettyprint lang-config">max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
+ <p>Nous pouvons calculer le nombre maximum absolu de connexions simultanées
+ de deux manières :</p>
+
+ <pre class="prettyprint lang-config">max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 10)) * 4 = 120
-
-max_connections = (AsyncRequestWorkerFactor + 1) * MaxRequestWorkers
+
+max_connections = (AsyncRequestWorkerFactor + 1) * MaxRequestWorkers
= (2 + 1) * 40 = 120</pre>
</div>
- <p>Tuning <code class="directive">AsyncRequestWorkerFactor</code> requires knowledge about the traffic handled by httpd in each specific use case, so changing the default value requires extensive testing and data gathering from <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</p>
+ <p>Le réglage de la directive
+ <code class="directive">AsyncRequestWorkerFactor</code> nécessite de connaître le
+ trafic géré par httpd pour chaque style d'utilisation spécifique ; si vous
+ modifiez la valeur par défaut, vous devrez par conséquent effectuer des
+ tests approfondis en vous appuyant étroitement sur les données fournies par
+ <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</p>
- <p><code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> was called
- <code class="directive">MaxClients</code> prior to version 2.3.13. The above value
- shows that the old name did not accurately describe its meaning for the event MPM.</p>
+ <p>La directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> se nommait
+ <code class="directive">MaxClients</code> avant la version 2.3.13. La valeur
+ ci-dessus montre que cet ancien nom ne correspondait pas à sa
+ signification exacte pour le MPM event.</p>
- <p><code class="directive">AsyncRequestWorkerFactor</code> can take non-integer
- arguments, e.g "1.5".</p>
+ <p>La directive <code class="directive">AsyncRequestWorkerFactor</code>
+ accepte des valeurs d'argument de type non entier, comme "1.5".</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="allow" id="allow">Directive</a> <a name="Allow" id="Allow">Allow</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls which hosts can access an area of the
-server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Allow from all|<var>host</var>|env=[!]<var>env-variable</var>
-[<var>host</var>|env=[!]<var>env-variable</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie quels hôtes peuvent accéder à une certaine zone du
+serveur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Allow from all|<var>hôte</var>|env=[!]<var>variable
+d'environnement</var>
+[<var>hôte</var>|env=[!]<var>variable d'environnement</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>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr>
</table>
- <p>The <code class="directive">Allow</code> directive affects which hosts can
- access an area of the server. Access can be controlled by
- hostname, IP address, IP address range, or by other
- characteristics of the client request captured in environment
- variables.</p>
-
- <p>The first argument to this directive is always
- <code>from</code>. The subsequent arguments can take three
- different forms. If <code>Allow from all</code> is specified, then
- all hosts are allowed access, subject to the configuration of the
- <code class="directive"><a href="#deny">Deny</a></code> and <code class="directive"><a href="#order">Order</a></code> directives as discussed
- below. To allow only particular hosts or groups of hosts to access
- the server, the <em>host</em> can be specified in any of the
- following formats:</p>
+ <p>La directive <code class="directive">Allow</code> permet de définir quels
+ hôtes ont le droit d'accéder à une certaine partie du serveur. On
+ peut contrôler l'accès par nom d'hôte, adresse IP, intervalle
+ d'adresses IP, ou toute autre caractéristique de la requête client
+ enregistrée dans les variables d'environnement.</p>
+
+ <p>Le premier argument de cette directive est toujours
+ <code>from</code>. Les arguments suivants peuvent prendre trois
+ formes différentes. Si <code>Allow from all</code> est spécifié,
+ tout hôte se voit accordé l'accès, en tenant compte des directives
+ <code class="directive"><a href="#deny">Deny</a></code> et <code class="directive"><a href="#order">Order</a></code> comme décrit plus loin.
+ Pour ne permettre l'accès au serveur qu'à un hôte ou un groupe
+ d'hôtes particuliers, on peut spécifier un <em>nom d'hôte</em> sous
+ une des formes suivantes :</p>
<dl>
- <dt>A (partial) domain-name</dt>
+ <dt>Un nom de domaine (partiel)</dt>
<dd>
<pre class="prettyprint lang-config">Allow from example.org
Allow from .net example.edu</pre>
- <p>Hosts whose names match, or end in, this string are allowed
- access. Only complete components are matched, so the above
- example will match <code>foo.example.org</code> but it will not
- match <code>fooexample.org</code>. This configuration will cause
- Apache httpd to perform a double DNS lookup on the client IP
- address, regardless of the setting of the <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> directive. It will do
- a reverse DNS lookup on the IP address to find the associated
- hostname, and then do a forward lookup on the hostname to assure
- that it matches the original IP address. Only if the forward
- and reverse DNS are consistent and the hostname matches will
- access be allowed.</p></dd>
-
- <dt>A full IP address</dt>
+ <p>Les hôtes dont les noms correspondent ou se terminent par la
+ chaîne spécifiée ont l'autorisation d'accès. Seules les
+ composantes entières du nom d'hôte doivent correspondre ; ainsi,
+ dans l'exemple ci-dessus, <code>foo.example.org</code>
+ correspondra, mais <code>fooexample.org</code> ne conviendra pas.
+ Avec cette configuration, Apache httpd va effectuer une double recherche
+ DNS sur l'adresse IP du client, sans tenir compte de la
+ définition de la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code>. Tout d'abord, une
+ recherche DNS inverse sur l'adresse IP est effectuée pour
+ déterminer le nom d'hôte associé, puis une recherche directe sur
+ le nom d'hôte est effectuée afin de s'assurer qu'il correspond
+ bien à l'adresse IP originale. L'accès ne sera accordé que si le
+ nom d'hôte correspond et si les recherches DNS inverse et directe
+ concordent.</p></dd>
+
+ <dt>Une adresse IP complète</dt>
<dd>
<pre class="prettyprint lang-config">Allow from 10.1.2.3
Allow from 192.168.1.104 192.168.1.205</pre>
- <p>An IP address of a host allowed access</p></dd>
+ <p>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd>
- <dt>A partial IP address</dt>
+ <dt>Une adresse IP partielle</dt>
<dd>
<pre class="prettyprint lang-config">Allow from 10.1
Allow from 10 172.20 192.168.2</pre>
- <p>The first 1 to 3 bytes of an IP address, for subnet
- restriction.</p></dd>
+ <p>De un à trois des premiers octets d'une adresse IP, afin de
+ restreindre l'accès à un sous-réseau.</p></dd>
- <dt>A network/netmask pair</dt>
+ <dt>Une paire réseau/masque de sous-réseau</dt>
<dd>
<pre class="prettyprint lang-config">Allow from 10.1.0.0/255.255.0.0</pre>
- <p>A network a.b.c.d, and a netmask w.x.y.z. For more
- fine-grained subnet restriction.</p></dd>
+ <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z, pour
+ une définition plus précise de la restriction d'accès imposée à un
+ sous-réseau.</p></dd>
- <dt>A network/nnn CIDR specification</dt>
+ <dt>Une spécification CIDR réseau/nnn</dt>
<dd>
<pre class="prettyprint lang-config">Allow from 10.1.0.0/16</pre>
- <p>Similar to the previous case, except the netmask consists of
- nnn high-order 1 bits.</p></dd>
+ <p>Identique au cas précédent, mis à part que le masque est
+ constitué des nnn bits de poids fort.</p></dd>
</dl>
- <p>Note that the last three examples above match exactly the
- same set of hosts.</p>
+ <p>Notez que les trois derniers exemples désignent le même ensemble
+ d'hôtes.</p>
- <p>IPv6 addresses and IPv6 subnets can be specified as shown
- below:</p>
+ <p>On peut spécifier des adresses et sous-réseaux IPv6 de la manière
+ suivante :</p>
<pre class="prettyprint lang-config">Allow from 2001:db8::a00:20ff:fea7:ccea
Allow from 2001:db8::a00:20ff:fea7:ccea/10</pre>
- <p>The third format of the arguments to the
- <code class="directive">Allow</code> directive allows access to the server
- to be controlled based on the existence of an <a href="../env.html">environment variable</a>. When <code>Allow from
- env=<var>env-variable</var></code> is specified, then the request is
- allowed access if the environment variable <var>env-variable</var>
- exists. When <code>Allow from env=!<var>env-variable</var></code> is
- specified, then the request is allowed access if the environment
- variable <var>env-variable</var> doesn't exist.
- The server provides the ability to set environment
- variables in a flexible way based on characteristics of the client
- request using the directives provided by
- <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. Therefore, this directive can be
- used to allow access based on such factors as the clients
- <code>User-Agent</code> (browser type), <code>Referer</code>, or
- other HTTP request header fields.</p>
+ <p>Le troisième format d'argument de la directive
+ <code class="directive">Allow</code> permet de contrôler l'accès au serveur
+ en fonction de l'existence d'une <a href="../env.html">variable d'environnement</a>. Lorsque <code>Allow
+ from env=<var>variable d'environnement</var></code> est spécifié, la
+ requête est autorisée si la variable d'environnement <var>variable
+ d'environnement</var> existe. En revanche, lorsque <code>Allow from
+ env=!<var>env-variable</var></code> est spécifié, la
+ requête est autorisée si la variable d'environnement <var>variable
+ d'environnement</var> n'existe pas. Le serveur permet de définir
+ avec souplesse des variables d'environnement en se basant sur les
+ caractéristiques de la requête client et en utilisant les directives
+ fournies par le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. Ainsi, on peut
+ utiliser la directive <code class="directive">Allow</code> pour permettre
+ l'accès en fonction de paramètres comme le <code>User-Agent</code>
+ (type de navigateur) des clients, le <code>Referer</code>, ou
+ d'autres champs d'en-tête de la requête HTTP.</p>
<pre class="prettyprint lang-config">SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
<Directory "/docroot">
</Directory></pre>
- <p>In this case, browsers with a user-agent string beginning
- with <code>KnockKnock/2.0</code> will be allowed access, and all
- others will be denied.</p>
+ <p>Dans cet exemple, les navigateurs dont la chaîne user-agent
+ commence par <code>KnockKnock/2.0</code> se verront accorder
+ l'accès, alors que tous les autres seront rejetés.</p>
- <div class="note"> <h3>Merging of configuration sections</h3>
- <p>When any directive provided by this module is used in a new
- configuration section, no directives provided by this module are
- inherited from previous configuration sections.</p>
+ <div class="note"><h3>Fusion des sections de configuration</h3>
+ <p>Lorsqu'une directive fournie par ce module est utilisée dans
+ une nouvelle section de configuration, cette dernière n'hérite
+ d'aucune directive définie dans une section précédente.</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="deny" id="deny">Directive</a> <a name="Deny" id="Deny">Deny</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls which hosts are denied access to the
-server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Deny from all|<var>host</var>|env=[!]<var>env-variable</var>
-[<var>host</var>|env=[!]<var>env-variable</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit quels hôtes ne sont pas autorisés à accéder au
+serveur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Deny from all|<var>hôte</var>|env=[!]<var>variable
+d'environnement</var>
+[<var>hôte</var>|env=[!]<var>variable d'environnement</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>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr>
</table>
- <p>This directive allows access to the server to be restricted
- based on hostname, IP address, or environment variables. The
- arguments for the <code class="directive">Deny</code> directive are
- identical to the arguments for the <code class="directive"><a href="#allow">Allow</a></code> directive.</p>
+ <p>Cette directive permet de restreindre l'accès au serveur en
+ fonction du nom d'hôte, de l'adresse IP ou de variables
+ d'environnement. Les arguments de la directive
+ <code class="directive">Deny</code> sont identiques aux arguments de la
+ directive <code class="directive"><a href="#allow">Allow</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="order" id="order">Directive</a> <a name="Order" id="Order">Order</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the default access state and the order in which
-<code class="directive">Allow</code> and <code class="directive">Deny</code> are
-evaluated.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Order <var>ordering</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le statut d'accès par défaut et l'ordre dans lequel
+les directives <code class="directive">Allow</code> et
+<code class="directive">Deny</code> sont évaluées.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Order <var>ordre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Order Deny,Allow</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>Limit</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr>
</table>
- <p>The <code class="directive">Order</code> directive, along with the
- <code class="directive"><a href="#allow">Allow</a></code> and
- <code class="directive"><a href="#deny">Deny</a></code> directives,
- controls a three-pass access control system. The first pass
- processes either all <code class="directive"><a href="#allow">Allow</a></code> or all <code class="directive"><a href="#deny">Deny</a></code> directives, as specified
- by the <code class="directive"><a href="#order">Order</a></code>
- directive. The second pass parses the rest of the directives
- (<code class="directive"><a href="#deny">Deny</a></code> or
- <code class="directive"><a href="#allow">Allow</a></code>). The third
- pass applies to all requests which do not match either of the first
- two.</p>
-
- <p>Note that all <code class="directive"><a href="#allow">Allow</a></code> and <code class="directive"><a href="#deny">Deny</a></code> directives are
- processed, unlike a typical firewall, where only the first match is
- used. The last match is effective (also unlike a typical firewall).
- Additionally, the order in which lines appear in the configuration
- files is not significant -- all <code class="directive"><a href="#allow">Allow</a></code> lines are processed as
- one group, all <code class="directive"><a href="#deny">Deny</a></code> lines are considered as
- another, and the default state is considered by itself.</p>
-
- <p><em>Ordering</em> is one of:</p>
+ <p>La directive <code class="directive">Order</code>, associée aux
+ directives <code class="directive"><a href="#allow">Allow</a></code>
+ et <code class="directive"><a href="#deny">Deny</a></code>,
+ implémente un système de contrôle d'accès en trois passes. Au cours
+ de la première passe, ce sont soit toutes les directives <code class="directive"><a href="#allow">Allow</a></code>, soit toutes les
+ directives <code class="directive"><a href="#deny">Deny</a></code> qui sont traitées, selon
+ la définition de la directive <code class="directive"><a href="#order">Order</a></code>. Le reste des
+ directives (<code class="directive"><a href="#deny">Deny</a></code>
+ ou <code class="directive"><a href="#allow">Allow</a></code>) est
+ traité au cours de la seconde passe. La troisième passe s'applique à
+ toutes les requêtes qui ne sont concernées par aucune des deux
+ premières passes.</p>
+
+ <p>Notez que toutes les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> sont traitées, à la
+ différence d'un pare-feu classique où seule la première règle qui
+ correspond est utilisée. La dernière directive qui correspond
+ s'applique ( à la différence là encore d'un pare-feu classique). De
+ plus, l'ordre dans lequel les lignes apparaissent dans le fichier de
+ configuration n'a pas d'incidence -- toutes les lignes <code class="directive"><a href="#allow">Allow</a></code> sont considérées comme
+ un groupe, toutes les lignes <code class="directive"><a href="#deny">Deny</a></code> comme un autre, et le
+ statut par défaut a son existence propre.</p>
+
+ <p><em>Ordre</em> peut être :</p>
<dl>
<dt><code>Allow,Deny</code></dt>
- <dd>First, all <code class="directive"><a href="#allow">Allow</a></code> directives are
- evaluated; at least one must match, or the request is rejected.
- Next, all <code class="directive"><a href="#deny">Deny</a></code>
- directives are evaluated. If any matches, the request is rejected.
- Last, any requests which do not match an <code class="directive"><a href="#allow">Allow</a></code> or a <code class="directive"><a href="#deny">Deny</a></code> directive are denied
- by default.</dd>
+ <dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#allow">Allow</a></code> sont évaluées ; au
+ moins une d'entre elles doit correspondre, sinon la requête est
+ rejetée. Ensuite, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont évaluées. Si au
+ moins l'une d'entre elles correspond, la requête est rejetée.
+ Enfin, toute requête qui ne correspond à aucune directive
+ <code class="directive"><a href="#allow">Allow</a></code> ou
+ <code class="directive"><a href="#deny">Deny</a></code> est rejetée
+ par défaut.</dd>
<dt><code>Deny,Allow</code></dt>
- <dd>First, all <code class="directive"><a href="#deny">Deny</a></code> directives are
- evaluated; if any match, the request is denied
- <strong>unless</strong> it also matches an <code class="directive"><a href="#allow">Allow</a></code> directive. Any
- requests which do not match any <code class="directive"><a href="#allow">Allow</a></code> or <code class="directive"><a href="#deny">Deny</a></code> directives are
- permitted.</dd>
+ <dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont évaluées ; Si au
+ moins une d'entre elles correspond, la requête est rejetée,
+ <strong>à moins</strong> qu'elle corresponde aussi à une directive
+ <code class="directive"><a href="#allow">Allow</a></code>. Toute
+ requête qui ne correspond à aucune directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> est autorisée.</dd>
<dt><code>Mutual-failure</code></dt>
- <dd>This order has the same effect as <code>Order
- Allow,Deny</code> and is deprecated in its favor.</dd>
+ <dd>Cet argument a le même effet que <code>Allow,Deny</code> et
+ est devenu de ce fait obsolète.</dd>
</dl>
- <p>Keywords may only be separated by a comma; <em>no whitespace</em>
- is allowed between them.</p>
+ <p>Les mots-clés ne peuvent être séparés que par des virgules ;
+ <em>aucun espace</em> ne doit s'intercaler entre eux.</p>
<table class="bordered">
<tr>
<th>Match</th>
- <th>Allow,Deny result</th>
- <th>Deny,Allow result</th>
+ <th>Résultat Allow,Deny</th>
+ <th>Résultat Deny,Allow</th>
</tr><tr>
- <th>Match Allow only</th>
- <td>Request allowed</td>
- <td>Request allowed</td>
+ <th>Correspond à Allow seulement</th>
+ <td>Requête autorisée</td>
+ <td>Requête autorisée</td>
</tr><tr>
- <th>Match Deny only</th>
- <td>Request denied</td>
- <td>Request denied</td>
+ <th>Correspond à Deny seulement</th>
+ <td>Requête rejetée</td>
+ <td>Requête rejetée</td>
</tr><tr>
- <th>No match</th>
- <td>Default to second directive: Denied</td>
- <td>Default to second directive: Allowed</td>
+ <th>Aucune correspondance</th>
+ <td>Par défaut la seconde directive : rejet</td>
+ <td>Par défaut la seconde directive : autorisation</td>
</tr><tr>
- <th>Match both Allow & Deny</th>
- <td>Final match controls: Denied</td>
- <td>Final match controls: Allowed</td>
+ <th>Correspond à Allow & Deny</th>
+ <td>La dernière correspondance l'emporte : rejet</td>
+ <td>La dernière correspondance l'emporte : autorisation</td>
</tr>
</table>
- <p>In the following example, all hosts in the example.org domain
- are allowed access; all other hosts are denied access.</p>
+ <p>Dans cet exemple, tous les hôtes du domaine example.org ont
+ l'autorisation d'accès ; tous les autres voient leur accès
+ refusé.</p>
<pre class="prettyprint lang-config">Order Deny,Allow
Deny from all
Allow from example.org</pre>
- <p>In the next example, all hosts in the example.org domain are
- allowed access, except for the hosts which are in the
- foo.example.org subdomain, who are denied access. All hosts not
- in the example.org domain are denied access because the default
- state is to <code class="directive"><a href="#deny">Deny</a></code>
- access to the server.</p>
+ <p>Dans l'exemple suivant, tous les hôtes du domaine example.org ont
+ l'autorisation d'accès, sauf ceux du sous-domaine foo.example.org qui
+ voient leur accès refusé. Tous les hôtes qui ne sont pas dans le
+ domaine example.org sont rejetés car le statut par défaut est positionné
+ sur <code class="directive"><a href="#deny">Deny</a></code>, et consiste donc en un
+ refus d'accès.</p>
<pre class="prettyprint lang-config">Order Allow,Deny
Allow from example.org
Deny from foo.example.org</pre>
- <p>On the other hand, if the <code class="directive">Order</code> in the
- last example is changed to <code>Deny,Allow</code>, all hosts will
- be allowed access. This happens because, regardless of the actual
- ordering of the directives in the configuration file, the
- <code>Allow from example.org</code> will be evaluated last and will
- override the <code>Deny from foo.example.org</code>. All hosts not in
- the <code>example.org</code> domain will also be allowed access
- because the default state is <code class="directive"><a href="#allow">Allow</a></code>.</p>
+ <p>Par contre, si la valeur de la directive
+ <code class="directive">Order</code>, dans l'exemple précédent, est
+ <code>Deny,Allow</code>, tout le monde a l'autorisation d'accès.
+ Ceci est dû au fait que <code>Allow from example.org</code> sera
+ évalué en dernier, sans tenir compte de l'ordre réel dans lequel les
+ directives apparaissent dans le fichier de configuration, et va
+ l'emporter sur <code>Deny from foo.example.org</code>. Tout hôte qui
+ n'est pas dans le domaine <code>example.org</code> aura aussi
+ l'autorisation d'accès car le statut par défaut est positionné sur
+ <code class="directive"><a href="#allow">Allow</a></code> et constitue donc une
+ autorisation d'accès.</p>
- <p>The presence of an <code class="directive">Order</code> directive can
- affect access to a part of the server even in the absence of
- accompanying <code class="directive"><a href="#allow">Allow</a></code>
- and <code class="directive"><a href="#deny">Deny</a></code>
- directives because of its effect on the default access state. For
- example,</p>
+ <p>La présence d'une directive <code class="directive">Order</code> peut
+ affecter le contrôle d'accès à une partie du serveur même en
+ l'abscence de directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> associées, à cause de
+ son influence sur le statut par défaut. Par exemple,</p>
<pre class="prettyprint lang-config"><Directory "/www">
Order Allow,Deny
</Directory></pre>
- <p>will Deny all access to the <code>/www</code> directory
- because the default access state is set to
- <code class="directive"><a href="#deny">Deny</a></code>.</p>
-
- <p>The <code class="directive">Order</code> directive controls the order of access
- directive processing only within each phase of the server's
- configuration processing. This implies, for example, that an
- <code class="directive"><a href="#allow">Allow</a></code> or <code class="directive"><a href="#deny">Deny</a></code> directive occurring in a
- <code class="directive"><a href="../mod/core.html#location"><Location></a></code> section will
- always be evaluated after an <code class="directive"><a href="#allow">Allow</a></code> or <code class="directive"><a href="#deny">Deny</a></code> directive occurring in a
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section or
- <code>.htaccess</code> file, regardless of the setting of the
- <code class="directive">Order</code> directive. For details on the merging
- of configuration sections, see the documentation on <a href="../sections.html">How Directory, Location and Files sections
- work</a>.</p>
-
- <div class="note"> <h3>Merging of configuration sections</h3>
- <p>When any directive provided by this module is used in a new
- configuration section, no directives provided by this module are
- inherited from previous configuration sections.</p>
- </div>
+ <p>va interdire tout accès au répertoire <code>/www</code> à cause
+ du statut d'accès par défaut qui est défini à <code class="directive"><a href="#deny">Deny</a></code>.</p>
+ <p>La directive <code class="directive">Order</code> ne contrôle l'ordre
+ dans lequel sont traitées les directives d'accès qu'au cours de
+ chaque phase du traitement de la configuration du serveur. Ceci
+ implique, par exemple, qu'une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> située dans une section
+ <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sera
+ toujours évaluée après une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> située dans une section
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou un
+ fichier <code>.htaccess</code>, sans tenir compte de la
+ définition de la directive <code class="directive">Order</code>. Pour plus
+ de détails à propos de la fusion des sections de configuration, voir
+ le document <a href="../sections.html">Comment fonctionnent les sections Directory,
+ Location et Files</a>.</p>
+
+ <div class="note"><h3>Fusion des sections de configuration</h3>
+ <p>Lorsqu'une directive fournie par ce module est utilisée dans
+ une nouvelle section de configuration, cette dernière n'hérite
+ d'aucune directive définie dans une section précédente.</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="satisfy" id="satisfy">Directive</a> <a name="Satisfy" id="Satisfy">Satisfy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interaction between host-level access control and
-user authentication</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interaction entre le contrôle d'accès en fonction de l'hôte
+et l'authentification utilisateur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Satisfy Any|All</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Satisfy All</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr>
</table>
- <p>Access policy if both <code class="directive"><a href="#allow">Allow</a></code> and <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> used. The parameter can be
- either <code>All</code> or <code>Any</code>. This directive is only
- useful if access to a particular area is being restricted by both
- username/password <em>and</em> client host address. In this case
- the default behavior (<code>All</code>) is to require that the client
- passes the address access restriction <em>and</em> enters a valid
- username and password. With the <code>Any</code> option the client will be
- granted access if they either pass the host restriction or enter a
- valid username and password. This can be used to password restrict
- an area, but to let clients from particular addresses in without
- prompting for a password.</p>
-
- <p>For example, if you wanted to let people on your network have
- unrestricted access to a portion of your website, but require that
- people outside of your network provide a password, you could use a
- configuration similar to the following:</p>
+ <p>Politique d'accès dans le cas où on utilise à la fois <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. L'argument est soit
+ <code>All</code>, soit <code>Any</code>. L'utilisation de cette
+ directive n'a de sens que si l'accès à une zone particulière du
+ serveur est restreinte par utilisateur/mot de passe et en fonction
+ de l'adresse IP de l'hôte client. Dans ce cas, par
+ défaut (<code>All</code>), le client doit satisfaire à la
+ restriction d'adresse, <em>et</em> fournir un couple
+ utilisateur/mot de passe valide. Avec l'argument <code>Any</code>,
+ le client se verra accorder l'accès s'il satisfait à la restriction
+ d'adresse ou fournit un couple utilisateur/mot de passe valide. On
+ peut utiliser cette dernière définition pour restreindre l'accès à
+ une zone par mot de passe, mais accorder l'accès aux clients
+ possédant certaines adresses IP sans qu'ils aient à fournir de mot
+ de passe.</p>
+
+ <p>Par exemple, si vous souhaitez que les utilisateurs de votre
+ réseau accèdent à une zone de votre site web sans restriction, mais
+ que l'accès à cette zone nécessite un mot de passe pour les autres
+ utilisateurs, vous pouvez utiliser une configuration du style :</p>
<pre class="prettyprint lang-config">Require valid-user
Allow from 192.168.1
<p>
- Another frequent use of the <code class="directive">Satisfy</code> directive
- is to relax access restrictions for a subdirectory:
+ Une autre utilisation fréquente de la directive
+ <code class="directive">Satisfy</code> est l'allègement des restrictions
+ d'accès à un sous-répertoire par rapport aux restrictions d'accès au
+ répertoire parent :
</p>
<pre class="prettyprint lang-config"><Directory "/var/www/private">
</Directory></pre>
- <p>In the above example, authentication will be required for the
- <code>/var/www/private</code> directory, but will not be required
- for the <code>/var/www/private/public</code> directory.</p>
+ <p>Dans l'exemple ci-dessus, l'accès au répertoire
+ <code>/var/www/private</code> nécessitera une authentification,
+ alors que l'accès au répertoire <code>/var/www/private/public</code>
+ sera accordé sans restriction.</p>
- <p>Since version 2.0.51 <code class="directive">Satisfy</code> directives can
- be restricted to particular methods by <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> and <code class="directive"><a href="../mod/core.html#limitexcept"><LimitExcept></a></code> sections.</p>
- <div class="note"> <h3>Merging of configuration sections</h3>
- <p>When any directive provided by this module is used in a new
- configuration section, no directives provided by this module are
- inherited from previous configuration sections.</p>
- </div>
+ <p>Depuis la version 2.0.51, les directives
+ <code class="directive">Satisfy</code> peuvent être restreintes à certaines
+ méthodes particulières à l'aide des sections <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> et <code class="directive"><a href="../mod/core.html#limitexcept"><LimitExcept></a></code>.</p>
+ <div class="note"><h3>Fusion des sections de configuration</h3>
+ <p>Lorsqu'une directive fournie par ce module est utilisée dans
+ une nouvelle section de configuration, cette dernière n'hérite
+ d'aucune directive définie dans une section précédente.</p>
+ </div>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="action" id="action">Directive</a> <a name="Action" id="Action">Action</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates a CGI script for a particular handler or
-content-type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Action <var>action-type</var> <var>cgi-script</var> [virtual]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un script CGI pour un gestionnaire ou un type de
+contenu particulier</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Action <var>type d'action</var> <var>script cgi</var>
+[virtual]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_actions</td></tr>
</table>
- <p>This directive adds an action, which will activate
- <var>cgi-script</var> when <var>action-type</var> is triggered by
- the request. The <var>cgi-script</var> is the URL-path to a
- resource that has been designated as a CGI script using <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> or <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. The
- <var>action-type</var> can be either a <a href="../handler.html">handler</a> or a <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">MIME content type</a>. It sends the URL and
- file path of the requested document using the standard CGI
- <code>PATH_INFO</code> and <code>PATH_TRANSLATED</code>
- environment variables. The handler used for the particular request
- is passed using the <code>REDIRECT_HANDLER</code> variable.</p>
-
- <div class="example"><h3>Example: MIME type</h3><pre class="prettyprint lang-config"># Requests for files of a particular MIME content type:
+ <p>Cette directive ajoute une action qui va activer <var>script
+ cgi</var> lorsque <var>type d'action</var> est déclenché par la
+ requête. <var>script cgi</var> est un chemin URL vers une ressource
+ qui a été désignée comme script CGI à l'aide des directives
+ <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. <var>type d'action</var>
+ peut être soit un <a href="../handler.html">gestionnaire</a>, soit
+ un <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type de contenu MIME</a>. L'URL
+ et le chemin du document correspondant sont envoyés en utilisant
+ les variables d'environnement CGI standards <code>PATH_INFO</code>
+ et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette
+ requête particulière est transmis à l'aide de la variable
+ <code>REDIRECT_HANDLER</code>.</p>
+
+ <div class="example"><h3>Exemple : type MIME</h3><pre class="prettyprint lang-config"># Requests for files of a particular MIME content type:
Action image/gif /cgi-bin/images.cgi</pre>
</div>
- <p>In this example, requests for files with a MIME content
- type of <code>image/gif</code> will be handled by the
- specified cgi script <code>/cgi-bin/images.cgi</code>.</p>
+ <p>Dans cet exemple, les requêtes pour des fichiers possédant
+ le type de contenu MIME <code>image/gif</code> seront traitées par
+ le script CGI <code>/cgi-bin/images.cgi</code>.</p>
<div class="example"><h3>Example: File extension</h3><pre class="prettyprint lang-config"># Files of a particular file extension
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi</pre>
</div>
- <p>In this example, requests for files with a file extension of
- <code>.xyz</code> are handled by the specified cgi script
- <code>/cgi-bin/program.cgi</code>.</p>
+ <p>Dans cet exemple, les requêtes pour des fichiers possédant
+ l'extension <code>.xyz</code> seront traitées par
+ le script CGI <code>/cgi-bin/programme.cgi</code>.</p>
- <p>The optional <code>virtual</code> modifier turns off the check
- whether the requested file really exists. This is useful, for example,
- if you want to use the <code class="directive">Action</code> directive in
- virtual locations.</p>
+ <p>Le modificateur optionnel <code>virtual</code> permet de
+ désactiver la vérification de l'existence du fichier demandé. Ceci
+ peut s'avérer utile, par exemple, si vous voulez utiliser la
+ directive <code class="directive">Action</code> pour des localisations
+ virtuelles.</p>
<pre class="prettyprint lang-config"><Location "/news">
SetHandler news-handler
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="script" id="script">Directive</a> <a name="Script" id="Script">Script</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates a CGI script for a particular request
-method.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Script <var>method</var> <var>cgi-script</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un script CGI dans le cas d'une méthode de requête
+particulière.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Script <var>méthode</var> <var>script cgi</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_actions</td></tr>
</table>
- <p>This directive adds an action, which will activate
- <var>cgi-script</var> when a file is requested using the method of
- <var>method</var>. The <var>cgi-script</var> is the URL-path to a
- resource that has been designated as a CGI script using <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> or <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. The URL and
- file path of the requested document is sent using the standard CGI
- <code>PATH_INFO</code> and <code>PATH_TRANSLATED</code> environment
- variables.</p>
+ <p>Cette directive ajoute une action qui va activer <var>script
+ cgi</var> lorsqu'un fichier est demandé en utilisant la méthode
+ <var>méthode</var>. <var>script cgi</var> est le chemin URL d'une
+ ressource qui a été désignée comme script CGI en utilisant les
+ directives <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. L'URL et le chemin du
+ document demandé sont envoyés en utilisant les variables
+ d'environnement CGI standards <code>PATH_INFO</code> et
+ <code>PATH_TRANSLATED</code>.</p>
<div class="note">
- Any arbitrary method name may be used. <strong>Method names are
- case-sensitive</strong>, so <code>Script PUT</code> and
- <code>Script put</code> have two entirely different
- effects.
+ Tous les noms de méthode peuvent être utilisés. <strong>Les noms
+ de méthode sont sensibles à la casse</strong>, si bien que
+ <code>Script PUT</code> et <code>Script put</code> ont des effets
+ totalement différents.
</div>
- <p>Note that the <code class="directive">Script</code> command defines default
- actions only. If a CGI script is called, or some other resource that is
- capable of handling the requested method internally, it will do
- so. Also note that <code class="directive">Script</code> with a method of
- <code>GET</code> will only be called if there are query arguments present
- (<em>e.g.</em>, foo.html?hi). Otherwise, the request will
- proceed normally.</p>
+ <p>Notez que la commande <code class="directive">Script</code> ne définit
+ que des actions par défaut. Si un script CGI est appelé, ou toute
+ autre ressource capable de gérer la méthode de la requête en
+ interne, il agira en conséquence. Notez aussi que
+ <code class="directive">Script</code> avec une méthode <code>GET</code> ne
+ sera appelé que si la requête possède des arguments (par exemple
+ foo.html?hi). Dans le cas contraire, la requête sera traitée
+ normalement.</p>
<pre class="prettyprint lang-config"># All GET requests go here
Script GET /cgi-bin/search
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="alias" id="alias">Directive</a> <a name="Alias" id="Alias">Alias</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias [<var>URL-path</var>]
-<var>file-path</var>|<var>directory-path</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#Description">Description:</a></th><td>Met en correspondance des URLs avec des chemins du système
+de fichiers</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias [<var>chemin URL</var>]
+<var>chemin fichier</var>|<var>chemin répertoire</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>The <code class="directive">Alias</code> directive allows documents to
- be stored in the local filesystem other than under the
- <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. URLs with a
- (%-decoded) path beginning with <var>URL-path</var> will be mapped
- to local files beginning with <var>directory-path</var>. The
- <var>URL-path</var> is case-sensitive, even on case-insensitive
- file systems.</p>
+ <p>La directive <code class="directive">Alias</code> permet de stocker des
+ documents (destinés à être servis) dans des zones du système de
+ fichiers situées en dehors de l'arborescence du site web <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Les URLs dont le chemin
+ (décodé avec caractères %) commence par <var>chemin URL</var> seront
+ mises en correspondance avec des fichiers locaux dont le chemin
+ commence par <var>chemin répertoire</var>. Le <var>chemin URL</var>
+ est sensible à la casse, même sur les systèmes de fichiers
+ insensibles à la casse.</p>
<pre class="prettyprint lang-config">Alias "/image" "/ftp/pub/image"</pre>
- <p>A request for <code>http://example.com/image/foo.gif</code> would cause
- the server to return the file <code>/ftp/pub/image/foo.gif</code>. Only
- complete path segments are matched, so the above alias would not match a
- request for <code>http://example.com/imagefoo.gif</code>. For more complex
- matching using regular expressions, see the <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> directive.</p>
+ <p>Une requête pour <code>http://example.com/image/foo.gif</code> fera
+ renvoyer par le serveur le fichier
+ <code>/ftp/pub/image/foo.gif</code>. Seuls les éléments de chemin
+ complets sont testés ; ainsi l'alias précédent ne conviendra pas
+ pour une requête du style <code>http://example.com/imagefoo.gif</code>.
+ Pour des mises en correspondance plus complexes faisant intervenir
+ les expressions rationnelles, veuillez vous reporter à la directive
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</p>
- <p>Note that if you include a trailing / on the
- <var>URL-path</var> then the server will require a trailing / in
- order to expand the alias. That is, if you use</p>
+ <p>Notez que si vous ajoutez un slash de fin au <var>chemin
+ URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la
+ requête. Autrement dit, si vous définissez</p>
<pre class="prettyprint lang-config">Alias "/icons/" "/usr/local/apache/icons/"</pre>
- <p>then the URL <code>/icons</code> will not be aliased, as it lacks
- that trailing /. Likewise, if you omit the slash on the
- <var>URL-path</var> then you must also omit it from the
- <var>file-path</var>.</p>
+ <p>l'alias précédent ne s'appliquera pas à l'URL
+ <code>/icons</code> à cause de l'absence du slash final. Ainsi, si
+ le slash final est absent du <var>chemin de l'URL</var>, il doit
+ aussi l'être du <var>chemin du fichier</var>.</p>
- <p>Note that you may need to specify additional <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections which
- cover the <em>destination</em> of aliases. Aliasing occurs before
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections
- are checked, so only the destination of aliases are affected.
- (Note however <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
- sections are run through once before aliases are performed, so
- they will apply.)</p>
+ <p>Notez qu'il pourra s'avérer nécessaire de définir des sections
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
+ supplémentaires qui couvriront la <em>destination</em> des alias.
+ Le traitement des alias intervenant avant le traitement des sections
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>,
+ seules les cibles des alias sont affectées (Notez cependant
+ que les sections <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sont traitées avant les alias, et
+ s'appliqueront donc).</p>
- <p>In particular, if you are creating an <code>Alias</code> to a
- directory outside of your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, you may need to explicitly
- permit access to the target directory.</p>
+ <p>En particulier, si vous créez un alias ayant pour cible un
+ répertoire situé en dehors de l'arborescence de votre site web
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, vous devrez
+ probablement permettre explicitement l'accès à ce répertoire.</p>
<pre class="prettyprint lang-config">Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
</Directory></pre>
- <p>Any number slashes in the <var>URL-path</var> parameter
- matches any number of slashes in the requested URL-path.</p>
+ <p>Le nombre de slashes dans le paramètre <var>chemin URL</var> doit
+ correspondre au nombre de slashes dans le chemin URL de la requête.</p>
- <p>If the <code class="directive">Alias</code> directive is used within a
- <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
- or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
- section the URL-path is omitted, and the file-path is interpreted
- using <a href="../expr.html">expression syntax</a>.<br />
- This syntax is available in Apache 2.4.19 and later.</p>
+ <p>Si la directive <code class="directive">Alias</code> est définie au sein
+ d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>, <var>chemin URL</var> est
+ omis et <var>chemin fichier</var> est interprété en utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
+ Cette syntaxe est disponible à partir de la version 2.4.19 du
+ serveur HTTP Apache.</p>
<pre class="prettyprint lang-config"><Location "/image">
Alias "/ftp/pub/image"
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="aliasmatch" id="aliasmatch">Directive</a> <a name="AliasMatch" id="AliasMatch">AliasMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations using regular
-expressions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec le système de fichiers
+en faisant intervenir les expressions rationnelles</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AliasMatch <var>regex</var>
-<var>file-path</var>|<var>directory-path</var></code></td></tr>
+<var>chemin fichier</var>|<var>chemin répertoire</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>This directive is equivalent to <code class="directive"><a href="#alias">Alias</a></code>, but makes use of
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
- instead of simple prefix matching. The
- supplied regular expression is matched against the URL-path, and
- if it matches, the server will substitute any parenthesized
- matches into the given string and use it as a filename. For
- example, to activate the <code>/icons</code> directory, one might
- use:</p>
+ <p>Cette directive est identique à la directive <code class="directive"><a href="#alias">Alias</a></code>, mais fait appel aux <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la place d'une
+ simple mise en correspondance de préfixe. L'expression rationnelle
+ fournie est mise en correspondance avec le chemin URL, et si elle
+ correspond, le serveur va substituer toute partie de chemin
+ correspondant à l'expression entre parenthèses dans la chaîne
+ fournie et l'utiliser comme nom de fichier.
+ Par exemple, pour activer le répertoire <code>/icons</code>, on peut
+ utiliser :</p>
- <pre class="prettyprint lang-config">AliasMatch "^/icons(/|$)(.*)" "/usr/local/apache/icons$1$2"</pre>
+ <pre class="prettyprint lang-config">AliasMatch "^/icons(.*)" "/usr/local/apache/icons$1$2"</pre>
- <p>The full range of <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>
- power is available. For example,
- it is possible to construct an alias with case-insensitive
- matching of the URL-path:</p>
+ <p>Toute la puissance des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions
+ rationnelles</a> peut être mise à contribution. Par exemple,
+ il est possible de construire un alias avec un modèle de chemin URL
+ insensible à la casse :</p>
<pre class="prettyprint lang-config">AliasMatch "(?i)^/image(.*)" "/ftp/pub/image$1"</pre>
- <p>One subtle difference
- between <code class="directive"><a href="#alias">Alias</a></code>
- and <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> is
- that <code class="directive"><a href="#alias">Alias</a></code> will
- automatically copy any additional part of the URI, past the part
- that matched, onto the end of the file path on the right side,
- while <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will
- not. This means that in almost all cases, you will want the
- regular expression to match the entire request URI from beginning
- to end, and to use substitution on the right side.</p>
+ <p>Il existe une différence subtile entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> : <code class="directive"><a href="#alias">Alias</a></code> copie automatiquement toute
+ portion supplémentaire de l'URI située après la partie du modèle qui
+ correspond, à la fin du chemin du fichier de la partie droite, alors
+ que <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne le fait
+ pas. Cela signifie qu'il sera préférable dans la plupart des cas de
+ comparer l'expression rationnelle du modèle à la totalité de l'URI
+ de la requête, et d'utiliser les substitutions dans la partie
+ droite.</p>
- <p>In other words, just changing
- <code class="directive"><a href="#alias">Alias</a></code> to
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will not
- have the same effect. At a minimum, you need to
- add <code>^</code> to the beginning of the regular expression
- and add <code>(.*)$</code> to the end, and add <code>$1</code> to
- the end of the replacement.</p>
+ <p>En d'autres termes, le remplacement d'<code class="directive"><a href="#alias">Alias</a></code> par <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne produira pas le même
+ résultat. Au minimum, vous devez ajouter <code>^</code> au début de
+ l'expression rationnelle, <code>(.*)$</code> à sa fin et
+ <code>$1</code> à la fin de la chaîne de remplacement.</p>
- <p>For example, suppose you want to replace this with AliasMatch:</p>
+ <p>Par exemple, supposons que nous voulions reformuler cet alias
+ avec AliasMatch :</p>
<pre class="prettyprint lang-config">Alias "/image/" "/ftp/pub/image/"</pre>
- <p>This is NOT equivalent - don't do this! This will send all
- requests that have /image/ anywhere in them to /ftp/pub/image/:</p>
+ <p>Le simple remplacement d'Alias par AliasMatch ne produira pas le
+ même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes
+ qui contiennent /image/ vers /ftp/pub/image/ :</p>
<pre class="prettyprint lang-config">AliasMatch "/image/" "/ftp/pub/image/"</pre>
- <p>This is what you need to get the same effect:</p>
+ <p>Voici la directive AliasMatch qui produira le même résultat que
+ la directive Alias ci-dessus :</p>
<pre class="prettyprint lang-config">AliasMatch "^/image/(.*)$" "/ftp/pub/image/$1"</pre>
- <p>Of course, there's no point in
- using <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
- where <code class="directive"><a href="#alias">Alias</a></code> would
- work. <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> lets
- you do more complicated things. For example, you could
- serve different kinds of files from different directories:</p>
+ <p>Bien entendu, il n'y a aucune raison d'utiliser <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> dans le cas où <code class="directive"><a href="#alias">Alias</a></code> suffit. <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> vous permet d'effectuer
+ des choses beaucoup plus sophistiquées. Par exemple, vous pouvez
+ servir différentes sortes de fichiers à partir de répertoires
+ différents :</p>
- <pre class="prettyprint lang-config">AliasMatch "^/image/(.*)\.jpg$" "/files/jpg.images/$1.jpg"
-AliasMatch "^/image/(.*)\.gif$" "/files/gif.images/$1.gif"</pre>
+ <pre class="prettyprint lang-config"> AliasMatch "^/image/(.*)\.jpg$" "/fichiers/jpg.images/$1.jpg"
+ AliasMatch "^/image/(.*)\.gif$" "/fichiers/gif.images/$1.gif"</pre>
- <p>Multiple leading slashes in the requested URL are discarded
- by the server before directives from this module compares
- against the requested URL-path.
+ <p>Les éventuels slashes de tête multiples seront supprimés par le
+ serveur avant que les directives de ce module n'effectuent des
+ comparaisons avec le chemin URL de la requête.
</p>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirect" id="redirect">Directive</a> <a name="Redirect" id="Redirect">Redirect</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect asking the client to fetch
-a different URL</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>status</var>] [<var>URL-path</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe demandant au client
+d'effectuer une autre requête avec une URL différente</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>état</var>] [<var>URL-path</var>]
<var>URL</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>The <code class="directive">Redirect</code> directive maps an old URL into a new one by asking
- the client to refetch the resource at the new location.</p>
-
- <p>The old <em>URL-path</em> is a case-sensitive (%-decoded) path
- beginning with a slash. A relative path is not allowed.</p>
-
- <p>The new <em>URL</em> may be either an absolute URL beginning
- with a scheme and hostname, or a URL-path beginning with a slash.
- In this latter case the scheme and hostname of the current server
- will be added if you have
- <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> set to on,
- otherwise the hostname will be replaced with the requested Host
- header.</p>
-
- <p>Then any request beginning with <em>URL-path</em> will return a
- redirect request to the client at the location of the target
- <em>URL</em>. Additional path information beyond the matched
- <em>URL-path</em> will be appended to the target URL.</p>
-
- <pre class="prettyprint lang-config"># Redirect to a URL on a different host
+ <p>La directive <code class="directive">Redirect</code> permet de faire correspondre
+ une ancienne URL à une nouvelle en demandant au client d'aller chercher la
+ ressource à une autre localisation.</p>
+
+ <p>L'ancien <em>URL-path</em> est un chemin sensible à la casse
+ (décodé à l'aide de caractères %) commençant par un slash. Les
+ chemins relatifs ne sont pas autorisés.</p>
+
+ <p>La nouvelle <em>URL</em>
+ peut être une URL absolue commençant par un protocole et un nom
+ d'hôte, mais on peut aussi utiliser un chemin URL commençant par un
+ slash, auquel cas le protocole et le nom d'hôte du serveur local
+ seront ajoutés, si vous avez défini <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> à on. Si <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> n'a pas été défini à on, le nom
+ d'hôte sera remplacé par la valeur de l'en-tête requested Host.</p>
+
+ <p>Ensuite, toute requête commençant par <em>URL-path</em> va
+ renvoyer une redirection au client vers l'<em>URL</em> cible. Tout
+ élément de chemin supplémentaire situé en aval du <em>URL-path</em> sera
+ ajouté à l'URL cible.</p>
+
+ <pre class="prettyprint lang-config"># Redirige vers une URL sur un serveur différent
Redirect "/service" "http://foo2.example.com/service"
-# Redirect to a URL on the same host
+# Redirige vers une URL sur le même serveur
Redirect "/one" "/two"</pre>
- <p>If the client requests <code>http://example.com/service/foo.txt</code>,
- it will be told to access
- <code>http://foo2.example.com/service/foo.txt</code>
- instead. This includes requests with <code>GET</code> parameters, such as
- <code>http://example.com/service/foo.pl?q=23&a=42</code>,
- it will be redirected to
+ <p>Si le client effectue une requête pour l'URL
+ <code>http://example.com/service/foo.txt</code>, il lui sera demandé
+ d'en effectuer une autre pour l'URL
+ <code>http://foo2.example.com/service/foo.txt</code>. Ceci concerne
+ les requêtes avec paramètres <code>GET</code>, comme
+ <code>http://example.com/service/foo.pl?q=23&a=42</code>, qui
+ seront redirigées vers
<code>http://foo2.example.com/service/foo.pl?q=23&a=42</code>.
- Note that <code>POST</code>s will be discarded.<br />
- Only complete path segments are matched, so the above
- example would not match a request for
- <code>http://example.com/servicefoo.txt</code>. For more complex matching
- using the <a href="../expr.html">expression syntax</a>, omit the URL-path
- argument as described below. Alternatively, for matching using regular
- expressions, see the <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> directive.</p>
+ Notez que les <code>POST</code>s seront ignorés.<br />
+ Seuls les
+ éléments de chemin complets sont testés, si bien que l'exemple
+ précédent ne s'appliquera pas à l'URL
+ <code>http://example.com/servicefoo.txt</code>. Pour des mises en
+ correspondance plus complexes utilisant la <a href="../expr.html">syntaxe des expressions</a>, ne spécifiez pas
+ d'argument <var>URL-path</var> comme décrit ci-dessous. En outre,
+ pour une mise en correspondance en utilisant les expressions
+ rationnelles, veuillez vous reporter à la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p>
<div class="note"><h3>Note</h3>
- <p><code class="directive">Redirect</code> directives take precedence over <code class="directive"><a href="#alias">Alias</a></code> and <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>
- directives, irrespective of their ordering in the configuration
- file. <code class="directive">Redirect</code> directives inside a Location take
- precedence over <code class="directive">Redirect</code> and <code class="directive"><a href="#alias">Alias</a></code> directives with an <var>URL-path</var>.</p>
- </div>
-
- <p>If no <var>status</var> argument is given, the redirect will
- be "temporary" (HTTP status 302). This indicates to the client
- that the resource has moved temporarily. The <var>status</var>
- argument can be used to return other HTTP status codes:</p>
+ <p>Les directives <code class="directive">Redirect</code> ont priorité sur les
+ directives <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, quel que soit leur ordre
+ d'apparition dans le fichier de configuration. Les directives
+ <code class="directive">Redirect</code> définies au sein d'une section Location
+ l'emportent sur les directives <code class="directive">Redirect</code> et <code class="directive"><a href="#alias">Alias</a></code> comportant un argument
+ <var>URL-path</var>.</p></div>
+
+ <p>Si aucun argument <var>état</var> n'est spécifié, la
+ redirection sera temporaire (code HTTP 302). Le client est alors
+ informé que la ressource a été temporairement déplacée. On peut
+ utiliser l'argument <var>état</var> pour renvoyer d'autres codes HTTP :</p>
<dl>
<dt>permanent</dt>
- <dd>Returns a permanent redirect status (301) indicating that
- the resource has moved permanently.</dd>
+ <dd>Renvoie un code de redirection permanente (301), indiquant
+ que la ressource a été définitivement déplacée.</dd>
<dt>temp</dt>
- <dd>Returns a temporary redirect status (302). This is the
- default.</dd>
+ <dd>Renvoie un code de redirection temporaire (302). C'est le
+ comportement par défaut.</dd>
<dt>seeother</dt>
- <dd>Returns a "See Other" status (303) indicating that the
- resource has been replaced.</dd>
+ <dd>Renvoie un code "See Other" (303) indiquant que la ressource
+ a été remplacée par une autre.</dd>
<dt>gone</dt>
- <dd>Returns a "Gone" status (410) indicating that the
- resource has been permanently removed. When this status is
- used the <var>URL</var> argument should be omitted.</dd>
+ <dd>Renvoie un code "Gone" (410) indiquant que la ressource a
+ été définitivement supprimée. Lorsque
+ ce code est utilisé, on ne
+ doit pas utiliser l'argument <var>URL</var>.</dd>
</dl>
- <p>Other status codes can be returned by giving the numeric
- status code as the value of <var>status</var>. If the status is
- between 300 and 399, the <var>URL</var> argument must be present.
- If the status is <em>not</em> between 300 and 399, the
- <var>URL</var> argument must be omitted. The status must be a valid
- HTTP status code, known to the Apache HTTP Server (see the function
- <code>send_error_response</code> in http_protocol.c).</p>
+ <p>On peut renvoyer d'autres codes en spécifiant le code
+ numérique comme valeur de l'argument of <var>état</var>.
+ Si le code est compris entre 300 et 399, l'argument
+ <var>URL</var> doit être présent. Si le code
+ n'est <em>pas</em> compris entre 300 et 399, l'argument
+ <var>URL</var> ne doit pas apparaître. Le code doit être un code
+ HTTP valide, connu du serveur HTTP Apache (voir la
+ fonction <code>send_error_response</code> dans
+ http_protocol.c).</p>
<pre class="prettyprint lang-config">Redirect permanent "/one" "http://example.com/two"
Redirect 303 "/three" "http://example.com/other"</pre>
- <p>If the <code class="directive">Redirect</code> directive is used within a
- <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
- or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
- section with the <var>URL-path</var> omitted, then the <var>URL</var> parameter
- will be interpreted using <a href="../expr.html">expression syntax</a>.<br />
- This syntax is available in Apache 2.4.19 and later.</p>
+ <p>Si une directive <code class="directive">Redirect</code> est définie au
+ sein d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> et si l'argument <var>URL-path</var> est omis, l'argument <var>URL</var> sera interprété en
+ utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
+ Cette syntaxe est disponible à partir de la version 2.4.19 du
+ serveur HTTP Apache.</p>
<pre class="prettyprint lang-config"><Location "/one">
Redirect permanent "http://example.com/two"
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirectmatch" id="redirectmatch">Directive</a> <a name="RedirectMatch" id="RedirectMatch">RedirectMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect based on a regular expression match
-of the current URL</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>status</var>] <var>regex</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe faisant appel aux
+expressions rationnelles pour la mise en correspondance de l'URL
+courante</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>état</var>] <var>regex</var>
<var>URL</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>This directive is equivalent to <code class="directive"><a href="#redirect">Redirect</a></code>, but makes use of
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
- instead of simple prefix matching. The
- supplied regular expression is matched against the URL-path, and
- if it matches, the server will substitute any parenthesized
- matches into the given string and use it as a filename. For
- example, to redirect all GIF files to like-named JPEG files on
- another server, one might use:</p>
+ <p>Cette directive est identique à la directive <code class="directive"><a href="#redirect">Redirect</a></code>, mais fait appel aux
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la
+ place d'une simple mise en correspondance de préfixe. L'expression
+ rationnelle fournie est mise en correspondance avec le chemin URL,
+ et si elle correspond, le serveur va substituer toute partie de
+ chemin correspondante entre parenthèses dans la chaîne spécifiée et
+ l'utiliser comme nom de fichier. Par exemple, pour rediriger tous
+ les fichiers GIF vers les fichiers JPEG de même nom sur un autre
+ serveur, on peut utiliser :</p>
- <pre class="prettyprint lang-config">RedirectMatch "(.*)\.gif$" "http://other.example.com$1.jpg"</pre>
+ <pre class="prettyprint lang-config">RedirectMatch "(.*)\.gif$" "http://autre.example.com$1.jpg"</pre>
- <p>The considerations related to the difference between
- <code class="directive"><a href="#alias">Alias</a></code> and
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
- also apply to the difference between
- <code class="directive"><a href="#redirect">Redirect</a></code> and
- <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.
- See <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> for
- details.</p>
+ <p>Les remarques à propos de la différence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi à la
+ différence entre les directives <code class="directive"><a href="#redirect">Redirect</a></code> et <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>. Voir la directive
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
+ détails.</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="redirectpermanent" id="redirectpermanent">Directive</a> <a name="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external permanent redirect asking the client to fetch
-a different URL</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>URL-path</var> <var>URL</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe permanente demandant au
+client d'effectuer une nouvelle requête avec une URL
+différente</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>chemin URL</var> <var>URL</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>This directive makes the client know that the Redirect is
- permanent (status 301). Exactly equivalent to <code>Redirect
- permanent</code>.</p>
+ <p>Cette directive informe le client que la redirection est
+ permanente (code 301). Son comportement est exactement le même
+ que celui de <code>Redirect permanent</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="redirecttemp" id="redirecttemp">Directive</a> <a name="RedirectTemp" id="RedirectTemp">RedirectTemp</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external temporary redirect asking the client to fetch
-a different URL</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>URL-path</var> <var>URL</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe temporaire demandant au
+client d'effectuer une nouvelle requête avec une URL
+différente</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>chemin URL</var> <var>URL</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>This directive makes the client know that the Redirect is
- only temporary (status 302). Exactly equivalent to
- <code>Redirect temp</code>.</p>
+ <p>Cette directive informe le client que la redirection n'est
+ que temporaire (code 302). Son comportement est exactement le même
+ que celui de <code>Redirect temp</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="scriptalias" id="scriptalias">Directive</a> <a name="ScriptAlias" id="ScriptAlias">ScriptAlias</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location and designates the
-target as a CGI script</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias [<var>URL-path</var>]
-<var>file-path</var>|<var>directory-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers
+et désigne la cible comme script CGI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias [<var>chemin URL</var>]
+<var>chemin fichier</var>|<var>chemin répertoire</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>The <code class="directive">ScriptAlias</code> directive has the same
- behavior as the <code class="directive"><a href="#alias">Alias</a></code>
- directive, except that in addition it marks the target directory
- as containing CGI scripts that will be processed by <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>'s cgi-script handler. URLs with a case-sensitive
- (%-decoded) path beginning with <var>URL-path</var> will be mapped
- to scripts beginning with the second argument, which is a full
- pathname in the local filesystem.</p>
+ <p>La directive <code class="directive">ScriptAlias</code> présente le même
+ comportement que la directive <code class="directive"><a href="#alias">Alias</a></code>, mais désigne en plus le
+ répertoire cible comme conteneur de scripts CGI qui seront traitées
+ par le gestionnaire cgi-script du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>.
+ Les URLs dont le chemin URL sensible à la casse (décodé avec
+ caractères %) commence par <var>chemin URL</var> seront mises en
+ correspondance avec les scripts dont le chemin commence par le
+ second argument, qui est un chemin complet dans le système de
+ fichiers local.</p>
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-bin/"</pre>
- <p>A request for <code>http://example.com/cgi-bin/foo</code> would cause the
- server to run the script <code>/web/cgi-bin/foo</code>. This configuration
- is essentially equivalent to:</p>
+ <p>Une requête pour <code>http://example.com/cgi-bin/foo</code>
+ ferait exécuter par le serveur le script
+ <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement
+ équivalente à :</p>
<pre class="prettyprint lang-config">Alias "/cgi-bin/" "/web/cgi-bin/"
<Location "/cgi-bin">
SetHandler cgi-script
</Location></pre>
- <p><code class="directive">ScriptAlias</code> can also be used in conjunction with
- a script or handler you have. For example:</p>
+ <p>Vous pouvez aussi utiliser <code class="directive">ScriptAlias</code>
+ avec un script ou gestionnaire de votre cru. Par exemple :</p>
- <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"</pre>
+
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"</pre>
- <p>In this scenario all files requested in <code>/cgi-bin/</code> will be
- handled by the file you have configured, this allows you to use your own custom
- handler. You may want to use this as a wrapper for CGI so that you can add
- content, or some other bespoke action.</p>
+ <p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête
+ dans <code>/cgi-bin/</code> seront traités par le fichier que vous
+ avez spécifié, ce qui vous permet d'utiliser votre propre
+ gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour
+ les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p>
- <div class="warning">It is safer to avoid placing CGI scripts under the
- <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> in order to
- avoid accidentally revealing their source code if the
- configuration is ever changed. The
- <code class="directive">ScriptAlias</code> makes this easy by mapping a
- URL and designating CGI scripts at the same time. If you do
- choose to place your CGI scripts in a directory already
- accessible from the web, do not use
- <code class="directive">ScriptAlias</code>. Instead, use <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, and <code class="directive"><a href="../mod/core.html#options">Options</a></code> as in:
+ <div class="warning">Il est préférable d'éviter de placer les
+ scripts CGI dans l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> afin d'éviter de révéler
+ accidentellement leur code source lors d'une modification de
+ configuration. On y parvient aisément avec
+ <code class="directive">ScriptAlias</code> en mettant en correspondance une
+ URL et en désignant la cible comme scripts CGI par la même occasion.
+ Si vous choisissez de placer vos scripts CGI dans un répertoire
+ accessible depuis le web, n'utilisez pas
+ <code class="directive">ScriptAlias</code>. Utilisez plutôt <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, et <code class="directive"><a href="../mod/core.html#options">Options</a></code> comme dans l'exemple suivant :
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/cgi-bin">
SetHandler cgi-script
Options ExecCGI
</Directory></pre>
- This is necessary since multiple <var>URL-paths</var> can map
- to the same filesystem location, potentially bypassing the
- <code class="directive">ScriptAlias</code> and revealing the source code
- of the CGI scripts if they are not restricted by a
- <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> section.</div>
+ Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent
+ correspondre à la même zone du système de fichiers, court-circuitant
+ ainsi la directive <code class="directive">ScriptAlias</code> et révélant le
+ code source des scripts CGI s'ils ne sont pas protégés par une
+ section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>.</div>
- <p>If the <code class="directive">ScriptAlias</code> directive is used within
- a <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
- or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
- section with the URL-path omitted, then the URL parameter will be
- interpreted using <a href="../expr.html">expression syntax</a>.<br />
- This syntax is available in Apache 2.4.19 and later.</p>
+ <p>Si la directive <code class="directive">ScriptAlias</code> est définie au
+ sein d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> et si l'argument <var>chemin
+ URL</var> est omis, l'argument <var>URL</var> sera interprété en
+ utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
+ Cette syntaxe est disponible à partir de la version 2.4.19 du
+ serveur HTTP Apache.</p>
<pre class="prettyprint lang-config"><Location "/cgi-bin">
ScriptAlias "/web/cgi-bin/"
<h3>Voir aussi</h3>
<ul>
-<li><a href="../howto/cgi.html">CGI Tutorial</a></li>
+<li><a href="../howto/cgi.html">Tutoriel CGI</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="scriptaliasmatch" id="scriptaliasmatch">Directive</a> <a name="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location using a regular expression
-and designates the target as a CGI script</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers
+en faisant appel aux expressions rationnelles et en désignant la cible
+comme un script CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAliasMatch <var>regex</var>
-<var>file-path</var>|<var>directory-path</var></code></td></tr>
+<var>chemin fichier</var>|<var>chemin répertoire</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>This directive is equivalent to <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, but makes use of
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
- instead of simple prefix matching. The
- supplied regular expression is matched against the URL-path,
- and if it matches, the server will substitute any parenthesized
- matches into the given string and use it as a filename. For
- example, to activate the standard <code>/cgi-bin</code>, one
- might use:</p>
+ <p>Cette directive est équivalente à la directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, mais fait appel aux
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la
+ place d'une simple mise en correspondance de préfixe. L'expression
+ rationnelle fournie est mise en correspondance avec le chemin URL,
+ et si elle correspond, le serveur va substituer toute partie de
+ chemin entre parenthèses dans la chaîne spécifiée et l'utiliser
+ comme nom de fichier. Par exemple, pour activer le répertoire
+ standard <code>/cgi-bin</code>, on peut utiliser :</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"</pre>
- <p>As for AliasMatch, the full range of <a class="glossarylink" href="../glossary.html#rexex" title="voir glossaire">regular
- expression</a> power is available.
- For example, it is possible to construct an alias with case-insensitive
- matching of the URL-path:</p>
+ <p>Comme dans le cas d'AliasMatch, toute la puissance des <a class="glossarylink" href="../glossary.html#rexex" title="voir glossaire">expressions rationnelles</a> peut être mise à
+ contribution. Par exemple, il est possible de construire un alias
+ avec une comparaison du modèle du chemin URL insensible à la casse :</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "(?i)^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"</pre>
- <p>The considerations related to the difference between
- <code class="directive"><a href="#alias">Alias</a></code> and
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
- also apply to the difference between
- <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> and
- <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>.
- See <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> for
- details.</p>
+ <p>Les remarques à propos de la différence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi à la
+ différence entre les directives <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> et <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>. Voir la directive
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
+ détails.</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="allowmethods" id="allowmethods">Directive</a> <a name="AllowMethods" id="AllowMethods">AllowMethods</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access to the listed HTTP methods</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint l'accès aux méthodes HTTP spécifiées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowMethods reset|<em>HTTP-method</em>
[<em>HTTP-method</em>]...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowMethods reset</code></td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_allowmethods</td></tr>
</table>
-<p>The HTTP-methods are case sensitive and are generally, as per
-RFC, given in upper case. The GET and HEAD methods are treated as
-equivalent. The <code>reset</code> keyword can be used to
-turn off <code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> in a deeper nested context:</p>
+<p>Le nom de chaque méthode HTTP est sensible à la casse, et est le plus
+souvent défini en majuscules, comme dans les RFCs. Les méthodes GET et
+HEAD sont traitées de la même manière. Le mot-clé
+<code>reset</code> permet de désactiver
+<code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> dans les niveaux inférieurs
+d'imbrication :</p>
<pre class="prettyprint lang-config"><Location "/svn">
AllowMethods reset
</Location></pre>
-<div class="note"><h3>Caution</h3>
- <p>The TRACE method cannot be denied by this module;
- use <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code> instead.</p>
+<div class="note"><h3>Avertissement</h3>
+ <p>La méthode TRACE ne peut pas être rejetée par ce module ; pour ce
+ faire, vous devez utiliser la directive <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code>.</p>
</div>
-<p><code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> was written to replace the rather
-kludgy implementation of <code class="directive"><a href="../mod/core.html#limit">Limit</a></code> and
-<code class="directive"><a href="../mod/core.html#limitexcept">LimitExcept</a></code>.</p>
+<p>Le module <code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> a été écrit pour
+remplacer l'implémentation "bricolée" des directives <code class="directive"><a href="../mod/core.html#limit">Limit</a></code> et <code class="directive"><a href="../mod/core.html#limitexcept">LimitExcept</a></code>.</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="authbasicauthoritative" id="authbasicauthoritative">Directive</a> <a name="AuthBasicAuthoritative" id="AuthBasicAuthoritative">AuthBasicAuthoritative</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization and authentication are passed to
-lower level modules</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si les processus d'autorisation et
+d'authentification peuvent être confiés à des modules de plus bas
+niveau</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicAuthoritative On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicAuthoritative On</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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
</table>
- <p>Normally, each authorization module listed in <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> will attempt
- to verify the user, and if the user is not found in any provider,
- access will be denied. Setting the
- <code class="directive">AuthBasicAuthoritative</code> directive explicitly
- to <code>Off</code> allows for both authentication and
- authorization to be passed on to other non-provider-based modules
- if there is <strong>no userID</strong> or <strong>rule</strong>
- matching the supplied userID. This should only be necessary when
- combining <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> with third-party modules
- that are not configured with the <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
- directive. When using such modules, the order of processing
- is determined in the modules' source code and is not configurable.</p>
+ <p>Normalement, chaque module d'autorisation énuméré dans la
+ directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> va tenter de
+ vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des
+ fournisseurs, l'accès sera refusé. Définir explicitement la
+ directive <code class="directive">AuthBasicAuthoritative</code> à
+ <code>Off</code> permet de confier l'autorisation et
+ l'authentification à d'autres modules non basés sur les fournisseurs
+ si <strong>aucun identifiant utilisateur</strong> ou aucune
+ <strong>règle</strong> ne correspondent à l'identifiant utilisateur
+ spécifié. Ceci ne peut s'avérer nécessaire que lorsque
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> est combiné avec des modules tiers
+ qui n'ont pas été configurés à l'aide de la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>. Lorsqu'on
+ utilise de tels modules, l'ordre dans lequel s'effectue le
+ traitement est défini dans le code source des modules et n'est pas
+ configurable.</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="authbasicfake" id="authbasicfake">Directive</a> <a name="AuthBasicFake" id="AuthBasicFake">AuthBasicFake</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake basic authentication using the given expressions for
-username and password</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicFake off|username [password]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Authentification de base simulée à l'aide des nom
+d'utilisateur et mot de passe fournis</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicFake off|nom-utilisateur [mot-de-passe]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The username and password specified are combined into an
- Authorization header, which is passed to the server or service
- behind the webserver. Both the username and password fields are
- interpreted using the <a href="../expr.html">expression parser</a>,
- which allows both the username and password to be set based on
- request parameters.</p>
+ <p>Les nom d'utilisateur et mot de passe spécifiés sont rassemblés
+ dans un en-tête d'autorisation qui est transmis au serveur ou au
+ service sous-jacent au serveur. Ces nom d'utilisateur et mot de
+ passe sont interprétés par l'<a href="../expr.html">interpréteur
+ d'expression</a>, ce qui permet de les définir en fonction de
+ paramètres de la requête.</p>
- <p>If the password is not specified, the default value "password"
- will be used. To disable fake basic authentication for an URL
- space, specify "AuthBasicFake off".</p>
+ <p>Si aucun mot de passe n'est spécifié, la valeur par défaut
+ "password" sera utilisée. Pour désactiver l'authentification de base
+ simulée pour un espace d'URL, définissez AuthBasicFake à "off".</p>
- <p>In this example, we pass a fixed username and password to a
- backend server.</p>
+ <p>Dans l'exemple suivant, un nom d'utilisateur et un mot de passe
+ prédéfinis sont transmis à un serveur d'arrière-plan :</p>
- <div class="example"><h3>Fixed Example</h3><pre class="prettyprint lang-config"><Location "/demo">
+ <div class="example"><h3>Exemple de transmission d'un nom d'utilisateur et
+ d'un mot de passe prédéfinis</h3><pre class="prettyprint lang-config"><Location "/demo">
AuthBasicFake demo demopass
</Location></pre>
</div>
- <p>In this example, we pass the email address extracted from a client
- certificate, extending the functionality of the FakeBasicAuth option
- within the <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code>
- directive. Like the FakeBasicAuth option, the password is set to the
- fixed string "password".</p>
+ <p>Dans l'exemple suivant, l'adresse email extraite d'un certificat
+ client est transmise au serveur, étendant par là-même la
+ fonctionnalité de l'option FakeBasicAuth de la directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Comme avec l'option
+ FakeBasicAuth, le mot de passe se voit attribué le contenu fixe de
+ la chaîne "password".</p>
- <div class="example"><h3>
Certificate Example</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <div class="example"><h3>
Exemple d'utilisation avec un certificat</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}"
</Location></pre>
</div>
- <p>Extending the above example, we generate a password by hashing the
- email address with a fixed passphrase, and passing the hash to the
- backend server. This can be used to gate into legacy systems that do
- not support client certificates.</p>
+ <p>Pour compléter l'exemple précédent, il est possible de générer la
+ valeur du mot de passe en procédant à un hashage de l'adresse email
+ à partir d'un mot d'une passphrase initial fixée, puis de transmettre le
+ résultat obtenu au serveur d'arrière-plan. Ceci peut s'avérer utile
+ pour donner accès à des serveurs anciens qui ne supportent pas les
+ certificats clients.</p>
- <div class="example"><h3>Password Example</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <div class="example"><h3>Exemple de génération de mot de passe par hashage de
+ l'adresse email</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" "%{sha1:passphrase-%{SSL_CLIENT_S_DN_Email}}"
</Location></pre>
</div>
- <div class="example"><h3>
Exclusion Example</h3><pre class="prettyprint lang-config"><Location "/public">
+ <div class="example"><h3>
Désactivation de l'authentification simulée</h3><pre class="prettyprint lang-config"><Location "/public">
AuthBasicFake off
</Location></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="authbasicprovider" id="authbasicprovider">Directive</a> <a name="AuthBasicProvider" id="AuthBasicProvider">AuthBasicProvider</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>provider-name</var>
-[<var>provider-name</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(les) fournisseur(s) d'authentification pour
+cette zone du site web</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>nom fournisseur</var>
+[<var>nom fournisseur</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicProvider file</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
</table>
- <p>The <code class="directive">AuthBasicProvider</code> directive sets
- which provider is used to authenticate the users for this location.
- The default <code>file</code> provider is implemented
- by the <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> module. Make sure
- that the chosen provider module is present in the server.</p>
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <p>La directive <code class="directive">AuthBasicProvider</code> permet de
+ définir le fournisseur utilisé pour authentifier les utilisateurs
+ pour la zone du site web concernée. Le fournisseur par défaut
+ <code>file</code> est implémenté par le module
+ <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le module
+ implémentant le fournisseur choisi soit bien présent dans le
+ serveur.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthType basic
AuthName "private area"
AuthBasicProvider dbm
Require valid-user
</Location></pre>
</div>
- <p> Providers are queried in order until a provider finds a match
- for the requested username, at which point this sole provider will
- attempt to check the password. A failure to verify the password does
- not result in control being passed on to subsequent providers.</p>
+ <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un
+ d'entre eux trouve une correspondance pour le nom d'utilisateur de
+ la requête ; alors, ce dernier fournisseur sera le seul à vérifier
+ le mot de passe. Un échec dans la vérification du mot de passe
+ n'entraîne pas le passage du contrôle au fournisseur suivant.</p>
- <p>Providers are implemented by <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
+ <p>Les différents fournisseurs disponibles sont implémentés par les
+ modules <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>,
- <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
and <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p>
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
et <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</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="authbasicusedigestalgorithm" id="authbasicusedigestalgorithm">Directive</a> <a name="AuthBasicUseDigestAlgorithm" id="AuthBasicUseDigestAlgorithm">AuthBasicUseDigestAlgorithm</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Check passwords against the authentication providers as if
-Digest Authentication was in force instead of Basic Authentication.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie les mots de passe auprès des fournisseurs
+d'authentification à la manière de l'authentification de type Digest.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicUseDigestAlgorithm MD5|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicUseDigestAlgorithm Off</code></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.4.7 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.7 du serveur HTTP
+Apache</td></tr>
</table>
- <p>Normally, when using Basic Authentication, the providers listed in
- <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
- attempt to verify a user by checking their data stores for
- a matching username and associated password. The stored passwords
- are usually encrypted, but not necessarily so; each provider may
- choose its own storage scheme for passwords.</p>
+ <p>Normalement, lorsqu'on utilise l'authentification basique, les
+ fournisseurs spécifiés via la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> tentent de
+ contrôler l'identité d'un utilisateur en recherchant dans leurs
+ bases de données l'existence d'un couple utilisateur/mot de passe
+ correspondant. Les mots de passe enregistrés sont en général
+ chiffrés, mais ce n'est pas systématique ; chaque fournisseur peut
+ choisir son propre mode de stockage des mots de passe.</p>
- <p>When using <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> and Digest
- Authentication, providers perform a similar check to find a matching
- username in their data stores. However, unlike in the Basic
- Authentication case, the value associated with each stored username
- must be an encrypted string composed from the username, realm name,
- and password. (See
- <a href="http://tools.ietf.org/html/rfc2617#section-3.2.2.2">
- RFC 2617, Section 3.2.2.2</a> for more details on the format used
- for this encrypted string.)</p>
+ <p>Lorsqu'on utilise l'authentification de type Digest, les
+ fournisseurs spécifiés par la directive <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> effectuent
+ une recherche similaire dans leurs bases de
+ données pour trouver un couple utilisateur/mot de passe
+ correspondant. Cependant, à la différence de l'authentification
+ basique, les données associées à chaque utilisateur et comportant le
+ nom d'utilisateur, le domaine de protection (realm) et le mot de
+ passe doivent être contenues dans une chaîne chiffrée (Voir le
+ document <a href="http://tools.ietf.org/html/rfc2617#section-3.2.2.2">RFC 2617,
+ Section 3.2.2.2</a> pour plus de détails à propos du type de
+ chiffrement utilisé pour cette chaîne).</p>
- <p>As a consequence of the difference in the stored values between
- Basic and Digest Authentication, converting from Digest
- Authentication to Basic Authentication generally requires that all
- users be assigned new passwords, as their existing passwords cannot
- be recovered from the password storage scheme imposed on those
- providers which support Digest Authentication.</p>
+ <p>A cause de la différence entre les méthodes de stockage des
+ données des authentifications de type basique et digest, le passage
+ d'une méthode d'authentification de type digest à une méthode
+ d'authentification de type basique requiert l'attribution de
+ nouveaux
+ mots de passe à chaque utilisateur, car leur mots de passe existant
+ ne peut pas être extrait à partir du schéma de stockage utilisé
+ par les fournisseurs d'authentification de type digest.</p>
- <p>Setting the <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code> directive
- to <code>MD5</code> will cause the user's Basic Authentication password
- to be checked using the same encrypted format as for Digest
- Authentication. First a string composed from the username, realm name,
- and password is hashed with MD5; then the username and this encrypted
- string are passed to the providers listed in
- <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
- as if
- <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>
- was set to <code>Digest</code> and Digest Authentication was in force.
+ <p>Si la directive <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code> est
+ définie à la valeur <code>MD5</code>, le mot de passe d'un
+ utilisateur dans le cas de l'authentification basique sera vérifié
+ en utilisant le même format de chiffrement que dans le cas de
+ l'authentification de type digest. Tout d'abord, une chaîne
+ comportant le nom d'utilisateur, le domaine de protection (realm) et
+ le mot de passe est générée sous forme de condensé (hash) en
+ utilisant l'algorithme MD5 ; puis le nom d'utilisateur et cette
+ chaîne chiffrée sont transmis aux fournisseurs spécifiés via la
+ directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> comme si la
+ directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>
+ était définie à <code>Digest</code> et si l'authentification de type
+ Digest était utilisée.
</p>
- <p>Through the use of <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
- a site may switch from Digest to Basic Authentication without
- requiring users to be assigned new passwords.</p>
+ <p>Grâce à cette directive, un site peut basculer d'une
+ authentification de type digest à basique sans devoir changer les
+ mots de passe des utilisateurs. </p>
<div class="note">
- The inverse process of switching from Basic to Digest
- Authentication without assigning new passwords is generally
- not possible. Only if the Basic Authentication passwords
- have been stored in plain text or with a reversable encryption
- scheme will it be possible to recover them and generate a
- new data store following the Digest Authentication password
- storage scheme.
+ Le processus inverse consistant à passer d'une authentification de
+ type basique à digest sans changer les mots de passe n'est en
+ général pas possible. Les mots de passe enregistrés dans le cas
+ d'une authentification de type basique ne pourront être extraits
+ et chiffrés à nouveau selon le schéma de l'authentification de
+ type digest, que s'ils ont été stockés en clair ou selon un schéma de
+ chiffrement réversible.
</div>
<div class="note">
- Only providers which support Digest Authentication will be able
- to authenticate users when <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
- is set to <code>MD5</code>. Use of other providers will result
- in an error response and the client will be denied access.
- </div>
+ Seuls les fournisseurs qui supportent l'authentification de type
+ digest pourront authentifier les utilisateurs lorsque la directive
+ <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
+ est définie à <code>MD5</code>. L'utilisation d'un autre
+ fournisseur provoquera un message d'erreur et le client se verra
+ refuser l'accès.</div>
</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="authdigestalgorithm" id="authdigestalgorithm">Directive</a> <a name="AuthDigestAlgorithm" id="AuthDigestAlgorithm">AuthDigestAlgorithm</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Selects the algorithm used to calculate the challenge and
-response hashes in digest authentication</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sélectionne l'algorithme utilisé pour calculer les
+condensés du défit et de sa réponse</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestAlgorithm MD5|MD5-sess</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestAlgorithm MD5</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestAlgorithm</code> directive
- selects the algorithm used to calculate the challenge and response
- hashes.</p>
+ <p>La directive <code class="directive">AuthDigestAlgorithm</code> permet de
+ sélectionner l'algorithme utilisé pour calculer les condensés du
+ défit et de sa réponse.</p>
<div class="note">
- <code>MD5-sess</code> is not correctly implemented yet.
+ <code>MD5-sess</code> n'est pas encore correctement implémenté.
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authdigestdomain" id="authdigestdomain">Directive</a> <a name="AuthDigestDomain" id="AuthDigestDomain">AuthDigestDomain</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URIs that are in the same protection space for digest
-authentication</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les URIs qui se trouvent dans le même espace de protection
+concernant l'authentification à base de condensés</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestDomain <var>URI</var> [<var>URI</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestDomain</code> directive allows
- you to specify one or more URIs which are in the same protection
- space (<em>i.e.</em> use the same realm and username/password info).
- The specified URIs are prefixes; the client will assume
- that all URIs "below" these are also protected by the same
- username/password. The URIs may be either absolute URIs (<em>i.e.</em>
- including a scheme, host, port, etc.) or relative URIs.</p>
+ <p>La directive <code class="directive">AuthDigestDomain</code> vous permet
+ de spécifier un ou plusieurs URIs se trouvant dans le même
+ espace de protection (c'est à dire utilisant le même utilisateur/mot
+ de passe et se trouvant dans le même domaine). Les URIs spécifiés
+ sont des préfixes ; le client doit savoir que tous les URIs situés
+ sous ces préfixes seront protégés par le même utilisateur/mot de
+ passe. Les URIs peuvent être soit des URIs absolus (c'est à dire
+ avec protocole, nom serveur, port, etc...), soit des URIs
+ relatifs.</p>
- <p>This directive <em>should</em> always be specified and
- contain at least the (set of) root URI(s) for this space.
- Omitting to do so will cause the client to send the
- Authorization header for <em>every request</em> sent to this
- server. Apart from increasing the size of the request, it may
- also have a detrimental effect on performance if <code class="directive"><a href="#authdigestnccheck">AuthDigestNcCheck</a></code> is on.</p>
+ <p>Cette directive doit toujours être présente et contenir au moins
+ le(s) URI(s) racine(s) pour cet espace. Dans le cas contraire, le
+ client va envoyer un en-tête d'autorisation avec <em>chaque
+ requête</em> à destination de ce serveur. Outre une augmentation de
+ la taille de la requête, les performances vont s'en trouver
+ affectées si la directive <code class="directive"><a href="#authdigestnccheck">AuthDigestNcCheck</a></code> est définie à
+ On.</p>
- <p>The URIs specified can also point to different servers, in
- which case clients (which understand this) will then share
- username/password info across multiple servers without
- prompting the user each time. </p>
+ <p>Les URIs spécifiés peuvent aussi référencer différents serveurs,
+ auquel cas les clients (qui sont à même de le comprendre) vont
+ partager l'utilisateur/mot de passe entre plusieurs serveurs sans le
+ demander à l'utilisateur à chaque fois.</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="authdigestnccheck" id="authdigestnccheck">Directive</a> <a name="AuthDigestNcCheck" id="AuthDigestNcCheck">AuthDigestNcCheck</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables or disables checking of the nonce-count sent by the
-server</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive la vérification du nombre d'envois du
+nombre à valeur unique (nonce) par le serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNcCheck On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestNcCheck 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#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
<div class="note">
- Not implemented yet.
+ Non encore implémenté.
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authdigestnonceformat" id="authdigestnonceformat">Directive</a> <a name="AuthDigestNonceFormat" id="AuthDigestNonceFormat">AuthDigestNonceFormat</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines how the nonce is generated</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la manière dont le nombre à valeur unique du
+serveur (nonce) est généré</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNonceFormat <var>format</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <div class="note">Not implemented yet.</div>
+ <div class="note">Non encore implémenté.</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="authdigestnoncelifetime" id="authdigestnoncelifetime">Directive</a> <a name="AuthDigestNonceLifetime" id="AuthDigestNonceLifetime">AuthDigestNonceLifetime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How long the server nonce is valid</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNonceLifetime <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de validité du nombre à valeur unique du
+serveur (nonce)</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNonceLifetime <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestNonceLifetime 300</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestNonceLifetime</code> directive
- controls how long the server nonce is valid. When the client
- contacts the server using an expired nonce the server will send
- back a 401 with <code>stale=true</code>. If <var>seconds</var> is
- greater than 0 then it specifies the amount of time for which the
- nonce is valid; this should probably never be set to less than 10
- seconds. If <var>seconds</var> is less than 0 then the nonce never
- expires.
+ <p>La directive <code class="directive">AuthDigestNonceLifetime</code>
+ permet de contrôler la durée de validité du nombre à valeur unique
+ du serveur (nonce). Lorsque le client contacte le serveur en
+ utilisant un nonce dont la validité a expiré, le serveur renvoie un
+ code d'erreur 401 avec <code>stale=true</code>. Si
+ <var>secondes</var> est supérieur à 0, il spécifie la durée de
+ validité du nonce ; il est en général déconseillé d'affecter à cet
+ argument une valeur inférieure à 10 secondes. Si
+ <var>secondes</var> est inférieur à 0, le nonce n'expire jamais.
+
</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="authdigestprovider" id="authdigestprovider">Directive</a> <a name="AuthDigestProvider" id="AuthDigestProvider">AuthDigestProvider</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestProvider <var>provider-name</var>
-[<var>provider-name</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(s) fournisseurs(s) d'authentification pour la
+zone du site web concernée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestProvider <var>nom fournisseur</var>
+[<var>nom fournisseur</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestProvider file</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestProvider</code> directive sets
- which provider is used to authenticate the users for this location.
- The default <code>file</code> provider is implemented
- by the <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> module. Make sure
- that the chosen provider module is present in the server.</p>
+ <p>La directive <code class="directive">AuthDigestProvider</code> permet de
+ définir quel fournisseur d'authentification sera utilisé pour
+ authentifier les utilisateurs pour la zone du site web concernée.
+ Assurez-vous que le module implémentant le fournisseur
+ d'authentification choisi soit bien présent dans le serveur. Le
+ fournisseur par défaut <code>file</code> est implémenté par le
+ module <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>.</p>
- <p>See <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>,
- <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> and <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>
- for providers.</p>
+ <p>Voir <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
+ <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et
+ <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>
+ pour la liste des fournisseurs disponibles.</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="authdigestqop" id="authdigestqop">Directive</a> <a name="AuthDigestQop" id="AuthDigestQop">AuthDigestQop</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the quality-of-protection to use in digest
-authentication</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le niveau de protection fourni par
+l'authentification à base de condensé</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestQop none|auth|auth-int [auth|auth-int]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestQop auth</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestQop</code> directive determines
- the <dfn>quality-of-protection</dfn> to use. <code>auth</code> will
- only do authentication (username/password); <code>auth-int</code> is
- authentication plus integrity checking (an MD5 hash of the entity
- is also computed and checked); <code>none</code> will cause the module
- to use the old RFC-2069 digest algorithm (which does not include
- integrity checking). Both <code>auth</code> and <code>auth-int</code> may
- be specified, in which the case the browser will choose which of
- these to use. <code>none</code> should only be used if the browser for
- some reason does not like the challenge it receives otherwise.</p>
+ <p>La directive <code class="directive">AuthDigestQop</code> permet de
+ définir le <dfn>niveau de protection</dfn> fourni. <code>auth</code>
+ ne fournit que l'authentification (nom utilisateur/mot de passe) ;
+ <code>auth-int</code> fournit l'authentification plus un contrôle
+ d'intégrité (un condensé MD5 de l'entité est aussi calculé et
+ vérifié) ; avec <code>none</code>, le module va utiliser l'ancien
+ algorithme de condensés RFC-2069 (qui n'effectue pas de contrôle
+ d'intégrité). On peut spécifier à la fois <code>auth</code> et
+ <code>auth-int</code>, auquel cas c'est le navigateur qui va choisir
+ lequel des deux utiliser. <code>none</code> ne doit être utilisé que
+ dans le cas où le navigateur ne serait pas à même (pour une raison
+ ou pour une autre) de relever le défit qu'il recevrait si un autre
+ niveau de protection était défini.</p>
<div class="note">
- <code>auth-int</code> is not implemented yet.
+ <code>auth-int</code> n'est pas encore implémenté.
</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="authdigestshmemsize" id="authdigestshmemsize">Directive</a> <a name="AuthDigestShmemSize" id="AuthDigestShmemSize">AuthDigestShmemSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The amount of shared memory to allocate for keeping track
-of clients</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestShmemSize <var>size</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité de mémoire partagée à allouer afin de conserver
+les informations à propos des clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestShmemSize <var>taille</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestShmemSize 1000</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
- <p>The <code class="directive">AuthDigestShmemSize</code> directive defines
- the amount of shared memory, that will be allocated at the server
- startup for keeping track of clients. Note that the shared memory
- segment cannot be set less than the space that is necessary for
- tracking at least <em>one</em> client. This value is dependent on your
- system. If you want to find out the exact value, you may simply
- set <code class="directive">AuthDigestShmemSize</code> to the value of
- <code>0</code> and read the error message after trying to start the
- server.</p>
+ <p>La directive <code class="directive">AuthDigestShmemSize</code> permet de
+ définir la quantité de mémoire partagée à allouer au démarrage du
+ serveur afin de conserver les informations à propos des clients.
+ Notez que le segment de mémoire partagée ne peut pas être défini à
+ une taille inférieure à l'espace nécessaire pour conserver les
+ informations à propos d'<em>un</em> client. Cette valeur dépend de
+ votre système. Si vous voulez en déterminer la valeur exacte, vous
+ pouvez simplement définir <code class="directive">AuthDigestShmemSize</code>
+ à <code>0</code> et consulter le message d'erreur que renverra le
+ serveur lorsqu'on essaiera de le démarrer.</p>
- <p>The <var>size</var> is normally expressed in Bytes, but you
- may follow the number with a <code>K</code> or an <code>M</code> to
- express your value as KBytes or MBytes. For example, the following
- directives are all equivalent:</p>
+ <p>L'argument <var>size</var> s'exprime par défaut en octets, mais
+ vous pouvez suffixer le nombre par un <code>K</code> ou un
+ <code>M</code> pour spécifier respectivement des KiloOctets ou des
+ MégaOctets. Par exemple, les directives qui suivent sont toutes
+ équivalentes :</p>
-<pre class="prettyprint lang-config">AuthDigestShmemSize 1048576
+
<pre class="prettyprint lang-config">AuthDigestShmemSize 1048576
AuthDigestShmemSize 1024K
AuthDigestShmemSize 1M</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformauthoritative" id="authformauthoritative">Directive</a> <a name="AuthFormAuthoritative" id="AuthFormAuthoritative">AuthFormAuthoritative</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization and authentication are passed to
-lower level modules</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si l'autorisation et l'authentification sont confiés à
+des modules de plus bas niveau</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormAuthoritative On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormAuthoritative On</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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
</table>
- <p>Normally, each authorization module listed in <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> will attempt
- to verify the user, and if the user is not found in any provider,
- access will be denied. Setting the
- <code class="directive">AuthFormAuthoritative</code> directive explicitly
- to <code>Off</code> allows for both authentication and
- authorization to be passed on to other non-provider-based modules
- if there is <strong>no userID</strong> or <strong>rule</strong>
- matching the supplied userID. This should only be necessary when
- combining <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> with third-party modules
- that are not configured with the <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code>
- directive. When using such modules, the order of processing
- is determined in the modules' source code and is not configurable.</p>
+ <p>Normalement, chacun des modules d'autorisation spécifiés par la
+ directive <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> va tenter de
+ vérifier l'identité de l'utilisateur, et si ce dernier n'est trouvé
+ dans aucun fournisseur, l'accès sera refusé. En définissant
+ explicitement la directive
+ <code class="directive">AuthFormAuthoritative</code> à <code>Off</code> on
+ confie les processus d'authentification et d'autorisation à des
+ modules ne s'appuyant pas sur des fournisseurs, si <strong>aucun
+ identifiant utilisateur</strong> ou aucune <strong>règle</strong> ne
+ correspond à l'identifiant utilisateur fourni. Ceci ne peut s'avérer
+ nécessaire que si l'on combine <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> avec
+ des modules tiers qui ne se configurent pas avec la directive
+ <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code>.
+ Lorsqu'on utilise de tels modules, la chronologie du processus est
+ déterminée dans leur code source, et n'est pas configurable.</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="authformbody" id="authformbody">Directive</a> <a name="AuthFormBody" id="AuthFormBody">AuthFormBody</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the body of the request to attempt on successful login</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormBody <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le corps de la
+requête à effectuer en cas de connexion réussie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormBody <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_body</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code> directive specifies
- the name of an HTML field which, if present, will contain the method of the request to
- to submit should login be successful.</p>
+ <p>La directive <code class="directive"><a href="#authformbody">AuthFormBody</a></code>
+ spécifie le nom du champ HTML qui, s'il existe, contiendra le corps
+ de la requête à effectuer en cas de connexion réussie.</p>
- <p>By populating the form with fields described by
- <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>,
- <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> and
- <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, a website can retry
- a request that may have been interrupted by the login screen, or by a session
- timeout.</p>
+ <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
+ mesure de relancer une requête qui a été éventuellement interrompue
+ par l'écran de connexion, ou par l'expiration d'un délai de
+ session.</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="authformdisablenostore" id="authformdisablenostore">Directive</a> <a name="AuthFormDisableNoStore" id="AuthFormDisableNoStore">AuthFormDisableNoStore</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable the CacheControl no-store header on the login page</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive l'en-tête CacheControl no-store sur la page de
+connexion</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormDisableNoStore <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormDisableNoStore Off</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformdisablenostore">AuthFormDisableNoStore</a></code> flag
- disables the sending of a <code>Cache-Control no-store</code> header with the
- error 401 page returned when the user is not yet logged in. The purpose of the header
- is to make it difficult for an <code>ecmascript</code> application to attempt to resubmit the
- login form, and reveal the username and password to the backend application. Disable
- at your own risk.</p>
+ <p>Le drapeau <code class="directive"><a href="#authformdisablenostore">AuthFormDisableNoStore</a></code> supprime
+ l'envoi d'un en-tête <code>Cache-Control no-store</code> lorsqu'une
+ page avec code d'erreur 401 est renvoyée, si l'utilisateur n'est pas
+ encore connecté. Avec cette en-tête, il est plus difficile pour une
+ application <code>ecmascript</code> de resoumettre un formulaire de connexion, et
+ ainsi révéler le nom d'utilisateur et le mot de passe à
+ l'application sous-jacente. Vous devez être conscient des risques
+ encourus si vous le désactivez.</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="authformfakebasicauth" id="authformfakebasicauth">Directive</a> <a name="AuthFormFakeBasicAuth" id="AuthFormFakeBasicAuth">AuthFormFakeBasicAuth</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake a Basic Authentication header</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Simule une en-tête d'authentification de base</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormFakeBasicAuth <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormFakeBasicAuth Off</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></code> flag
- determines whether a <code>Basic Authentication</code> header will be added to
- the request headers. This can be used to expose the username and password to
- an underlying application, without the underlying application having to be aware
- of how the login was achieved.</p>
+ <p>Le drapeau <code class="directive"><a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></code>
+ détermine si une en-tête d'<code>Authentification de base</code>
+ sera ajoutée aux en-têtes de la requête. On peut utiliser cette
+ méthode pour présenter le nom d'utilisateur et le mot de passe à
+ l'application sous-jacente, sans que cette dernière ait besoin de
+ connaître la manière dont le processus de connexion a été mené à
+ bien.</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="authformlocation" id="authformlocation">Directive</a> <a name="AuthFormLocation" id="AuthFormLocation">AuthFormLocation</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying a URL to redirect to on successful login</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLocation <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contiendra l'URL vers
+laquelle l'utilisateur sera redirigé en cas de connexion
+réussie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLocation <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_location</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code> directive specifies
- the name of an HTML field which, if present, will contain a URL to redirect the browser to
- should login be successful.</p>
+ <p>La directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>
+ spécifie le nom du champ HTML qui, s'il existe, contiendra l'URL
+ vers laquelle rediriger le navigateur en cas de connexion
+ réussie.</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="authformloginrequiredlocation" id="authformloginrequiredlocation">Directive</a> <a name="AuthFormLoginRequiredLocation" id="AuthFormLoginRequiredLocation">AuthFormLoginRequiredLocation</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL of the page to be redirected to should login be required</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit être redirigé si une
+authentification est requise</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginRequiredLocation <var>url</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later. The use of the expression
-parser has been added in 2.4.4.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
+Apache. L'interprétation des expressions rationnelles est supportée
+depuis la version 2.4.4.</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code> directive
- specifies the URL to redirect to should the user not be authorised to view a page. The value
- is parsed using the <a href="../expr.html">ap_expr</a> parser before being sent to the client.
- By default, if a user is not authorised to view a page, the HTTP response code
- <code>HTTP_UNAUTHORIZED</code> will be returned with the page specified by the
- <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code> directive. This directive overrides this
- default.</p>
+ <p>La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
+ spécifie l'URL vers laquelle l'utilisateur devra être
+ redirigé s'il n'est pas autorisé à accéder à une page. Sa valeur est
+ interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
+ avant d'être envoyée au client. Par défaut,
+ si un utilisateur n'est pas autorisé à accéder à une page, le code
+ de réponse HTTP <code>HTTP_UNAUTHORIZED</code> est renvoyé avec la
+ page spécifiée par la directive <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code>. La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
+ permet de remplacer cette valeur par défaut.</p>
- <p>Use this directive if you have a dedicated login page to redirect users to.</p>
+ <p>Vous pouvez utiliser cette directive si vous voulez présenter une
+ page de connexion personnalisée à vos utilisateurs.</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="authformloginsuccesslocation" id="authformloginsuccesslocation">Directive</a> <a name="AuthFormLoginSuccessLocation" id="AuthFormLoginSuccessLocation">AuthFormLoginSuccessLocation</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL of the page to be redirected to should login be successful</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit être redirigé en cas
+de connexion réussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginSuccessLocation <var>url</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later. The use of the expression
-parser has been added in 2.4.4.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
+Apache. L'interprétation des expressions rationnelles est supportée
+depuis la version 2.4.4.</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code> directive
- specifies the URL to redirect to should the user have logged in successfully. The value is
- parsed using the <a href="../expr.html">ap_expr</a> parser before being sent to the client.
- This directive can be overridden if a form field has been defined containing another URL
- using the <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code> directive.</p>
+ <p>La directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
+ spécifie l'URL vers laquelle l'utilisateur doit être
+ redirigé en cas de connexion réussie. Sa valeur est
+ interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
+ avant d'être envoyée au client. L'effet de cette directive
+ peut être annulé si l'on a défini un champ de formulaire contenant
+ une autre URL à l'aide de la directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>.</p>
- <p>Use this directive if you have a dedicated login URL, and you have not embedded the
- destination page in the login form.</p>
+ <p>Vous pouvez utiliser cette directive si vous possédez une URL de
+ connexion personnalisée, et si vous n'avez pas intégré la page de
+ destination dans le formulaire de connexion.</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="authformlogoutlocation" id="authformlogoutlocation">Directive</a> <a name="AuthFormLogoutLocation" id="AuthFormLogoutLocation">AuthFormLogoutLocation</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The URL to redirect to after a user has logged out</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL vers laquelle un utilisateur devra être redirigé
+après s'être déconnecté</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLogoutLocation <var>uri</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later. The use of the expression
-parser has been added in 2.4.4.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
+Apache. L'interprétation des expressions rationnelles est supportée
+depuis la version 2.4.4.</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code> directive
- specifies the URL of a page on the server to redirect to should the user attempt to log
- out. The value is parsed using the <a href="../expr.html">ap_expr</a> parser before
- being sent to the client.</p>
+ <p>La directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>
+ spécifie l'URL de la page du serveur vers laquelle l'utilisateur
+ devra être redirigé s'il se déconnecte. Sa valeur est
+ interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
+ avant d'être envoyée au client.</p>
- <p>When a URI is accessed that is served by the handler <code>form-logout-handler</code>,
- the page specified by this directive will be shown to the end user. For example:</p>
+ <p>Lorsqu'un accès est tenté sur un URI traité par le gestionnaire
+ <code>form-logout-handler</code>, la page spécifiée par cette
+ directive sera présentée à l'utilisateur final. Par exemple :</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><Location "/logout">
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><Location "/logout">
SetHandler form-logout-handler
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session on
</Location></pre>
</div>
- <p>An attempt to access the URI <var>/logout/</var> will result in the user being logged
- out, and the page <var>/loggedout.html</var> will be displayed. Make sure that the page
- <var>loggedout.html</var> is not password protected, otherwise the page will not be
- displayed.</p>
+ <p>Si un utilisateur tente d'accéder à l'URI <var>/logout/</var>, il
+ sera déconnecté, et la page <var>/loggedout.html</var> lui sera
+ présentée. Assurez-vous que la page <var>loggedout.html</var> n'est
+ pas protégée par mot de passe, car dans le cas contraire, elle ne
+ serait pas affiché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="authformmethod" id="authformmethod">Directive</a> <a name="AuthFormMethod" id="AuthFormMethod">AuthFormMethod</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the method of the request to attempt on successful login</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMethod <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant la méthode de la
+requête à effectuer en cas de connexion réussie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMethod <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_method</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code> directive specifies
- the name of an HTML field which, if present, will contain the method of the request to
- to submit should login be successful.</p>
+ <p>La directive <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>
+ spécifie le nom du champ HTML qui, s'il existe, contiendra le type
+ MIME de la requête à effectuer en cas de connexion réussie.</p>
- <p>By populating the form with fields described by
- <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>,
- <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> and
- <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, a website can retry
- a request that may have been interrupted by the login screen, or by a session
- timeout.</p>
+ <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
+ mesure de relancer une requête qui a été éventuellement interrompue
+ par l'écran de connexion, ou par l'expiration d'un délai de
+ session.</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="authformmimetype" id="authformmimetype">Directive</a> <a name="AuthFormMimetype" id="AuthFormMimetype">AuthFormMimetype</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the mimetype of the body of the request to attempt on successful login</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMimetype <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le type MIME du
+corps de la requête à effectuer en cas de connexion
+réussie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMimetype <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_mimetype</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code> directive specifies
- the name of an HTML field which, if present, will contain the
- mimetype of the request to submit should login be successful.</p>
+ <p>La directive <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code>
+ spécifie le nom du champ HTML qui, s'il existe, contiendra le type
+ MIME de la requête à effectuer en cas de connexion réussie.</p>
- <p>By populating the form with fields described by
- <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>,
- <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> and
- <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, a website can retry
- a request that may have been interrupted by the login screen, or by a session
- timeout.</p>
+ <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
+ mesure de relancer une requête qui a été éventuellement interrompue
+ par l'écran de connexion, ou par l'expiration d'un délai de
+ session.</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="authformpassword" id="authformpassword">Directive</a> <a name="AuthFormPassword" id="AuthFormPassword">AuthFormPassword</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the login password</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormPassword <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le mot de passe
+de connexion</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormPassword <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_password</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformpassword">AuthFormPassword</a></code> directive specifies
- the name of an HTML field which, if present, will contain the password to be used to log
- in.</p>
+ <p>La directive <code class="directive"><a href="#authformpassword">AuthFormPassword</a></code> permet de
+ spécifier le nom du champ HTML qui, s'il existe, contiendra le mot
+ de passe qui sera utilisé pour la connexion.</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="authformprovider" id="authformprovider">Directive</a> <a name="AuthFormProvider" id="AuthFormProvider">AuthFormProvider</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormProvider <var>provider-name</var>
-[<var>provider-name</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(s) fournisseur(s) d'authentification pour la
+zone concernée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormProvider <var>nom fournisseur</var>
+[<var>nom fournisseur</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormProvider file</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
</table>
- <p>The <code class="directive">AuthFormProvider</code> directive sets
- which provider is used to authenticate the users for this location.
- The default <code>file</code> provider is implemented
- by the <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> module. Make sure
- that the chosen provider module is present in the server.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <p>La directive <code class="directive">AuthFormProvider</code> permet de
+ définir quel fournisseur sera utilisé pour authentifier les
+ utilisateurs pour la zone concernée. Le fournisseur par défaut
+ <code>file</code> est implémenté par le module
+ <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le fournisseur
+ choisi soit bien présent dans le serveur.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthType form
AuthName "private area"
AuthFormProvider dbm
</Location></pre>
</div>
- <p>Providers are implemented by <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
- <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>,
- <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> and <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p>
+ <p>Les différents fournisseurs sont implémentés par les modules
+ <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>,
+ <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</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="authformsitepassphrase" id="authformsitepassphrase">Directive</a> <a name="AuthFormSitePassphrase" id="AuthFormSitePassphrase">AuthFormSitePassphrase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Bypass authentication checks for high traffic sites</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Court-circuite l'authentification pour les sites à fort
+trafic</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSitePassphrase <var>secret</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformsitepassphrase">AuthFormSitePassphrase</a></code> directive
- specifies a passphrase which, if present in the user session, causes Apache httpd to
- bypass authentication checks for the given URL. It can be used on high traffic websites
- to reduce the load induced on authentication infrastructure.</p>
-
- <p>The passphrase can be inserted into a user session by adding this directive to the
- configuration for the <var>form-login-handler</var>. The <var>form-login-handler</var>
- itself will always run the authentication checks, regardless of whether a passphrase
- is specified or not.</p>
-
- <div class="warning"><h3>Warning</h3>
- <p>If the session is exposed to the user through the use of
- <code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, and the session is not protected with
- <code class="module"><a href="../mod/mod_session_crypto.html">mod_session_crypto</a></code>, the passphrase is open to potential exposure
- through a dictionary attack. Regardless of how the session is configured,
- ensure that this directive is not used within URL spaces where private user data
- could be exposed, or sensitive transactions can be conducted. Use at own risk.</p>
+ <p>La directive <code class="directive"><a href="#authformsitepassphrase">AuthFormSitePassphrase</a></code>
+ spécifie un mot de passe qui, s'il est présent dans la session
+ utilisateur, indique à Apache httpd de court-circuiter l'authentification
+ pour l'URL considérée. On peut l'utiliser dans le cas de sites web à
+ fort trafic afin de réduire la charge induite sur l'infrastructure
+ d'authentification.</p>
+
+ <p>On peut insérer le mot de passe dans une session utilisateur en
+ ajoutant cette directive à la configuration concernant le
+ gestionnaire <var>form-login-handler</var>. Le gestionnaire
+ <var>form-login-handler</var>, quant à lui, effectuera toujours les
+ vérifications d'authentification, qu'un mot de passe soit spécifié
+ ou non.</p>
+
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Si la session est présentée à l'utilisateur à l'aide du module
+ <code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et si la session n'est pas
+ protégée par le module <code class="module"><a href="../mod/mod_session_crypto.html">mod_session_crypto</a></code>, le mot
+ de passe peut faire l'objet d'une attaque de type dictionnaire.
+ Quelle que soit la configuration de la session, assurez-vous que
+ cette directive n'est pas utilisée dans un espace d'URLs contenant
+ des données privées, ou à partir desquelles des transactions
+ sensibles pourraient être menées. En tout état de cause, vous
+ devez être conscient des risques encourus avant de l'utiliser.</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="authformsize" id="authformsize">Directive</a> <a name="AuthFormSize" id="AuthFormSize">AuthFormSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The largest size of the form in bytes that will be parsed for the login details</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSize <var>size</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille maximale en octets du formulaire dont seront
+extraites les informations de connexion</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSize <var>taille</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>8192</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformsize">AuthFormSize</a></code> directive specifies
- the maximum size of the body of the request that will be parsed to find the login form.</p>
+ <p>La directive <code class="directive"><a href="#authformsize">AuthFormSize</a></code> spécifie
+ la taille maximale du corps de la requête qui sera utilisée pour
+ trouver le formulaire de connexion.</p>
- <p>If a login request arrives that exceeds this size, the whole request will be aborted
- with the HTTP response code <code>HTTP_REQUEST_TOO_LARGE</code>.</p>
+ <p>Si une requête de connexion entrante possède une taille
+ supérieure à cette valeur, elle sera rejetée avec le code de réponse
+ HTTP <code>HTTP_REQUEST_TOO_LARGE</code>.</p>
- <p>If you have populated the form with fields described by
- <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>,
- <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> and
- <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, you probably want to set this
- field to a similar size as the <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>
- directive.</p>
+ <p>Si vous avez ajouté au formulaire des champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, il est recommandé
+ de définir cette directive à une valeur similaire à celle de la
+ directive <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</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="authformusername" id="authformusername">Directive</a> <a name="AuthFormUsername" id="AuthFormUsername">AuthFormUsername</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The name of a form field carrying the login username</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormUsername <var>fieldname</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le nom de
+connexion</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormUsername <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_username</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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#authformusername">AuthFormUsername</a></code> directive specifies
- the name of an HTML field which, if present, will contain the username to be used to log
- in.</p>
+ <p>La directive <code class="directive"><a href="#authformusername">AuthFormUsername</a></code> permet de
+ spécifier le nom du champ HTML qui, s'il existe, contiendra le nom
+ d'utilisateur qui sera utilisé pour la connexion.</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="anonymous" id="anonymous">Directive</a> <a name="Anonymous" id="Anonymous">Anonymous</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies userIDs that are allowed access without
-password verification</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous <var>user</var> [<var>user</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la liste des identifiants utilisateur autorisés à
+accéder sans vérification du mot de passe</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous <var>utilisateur</var> [<var>utilisateur</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_anon</td></tr>
</table>
- <p>A list of one or more 'magic' userIDs which are allowed
- access without password verification. The userIDs are space
- separated. It is possible to use the ' and " quotes to allow a
- space in a userID as well as the \ escape character.</p>
-
- <p>Please note that the comparison is
- <strong>case-IN-sensitive</strong>.<br />
- It's strongly recommended that the magic username
- '<code>anonymous</code>' is always one of the allowed
- userIDs.</p>
-
- <div class="example"><h3>Ex
ample:</h3><pre class="prettyprint lang-config">Anonymous anonymous "Not Registered" "I don't know"</pre>
+ <p>Une liste d'un ou plusieurs identifiants utilisateur spéciaux
+ autorisés à accéder sans vérification du mot de passe. Les
+ identifiants doivent être séparés par un espace. Pour spécifier un
+ identifiant contenant un espace, on peut utiliser les guillemets '
+ ou ", ou le caractère d'échappement \.</p>
+
+ <p>Veuillez noter que la vérification <strong>n'est pas sensible à
+ la casse</strong>.<br />
+ Il est fortement conseillé d'intégrer l'utilisateur spécial
+ '<code>anonymous</code>' dans la liste des identifiants.</p>
+
+ <div class="example"><h3>Ex
emple:</h3><pre class="prettyprint lang-config">Anonymous anonymous "Not Registered" "I don't know"</pre>
</div>
- <p>This would allow the user to enter without password
- verification by using the userIDs "anonymous",
- "AnonyMous", "Not Registered" and "I Don't Know".</p>
+ <p>Dans cet exemple, l'utilisateur peut accéder au site sans
+ vérification du mot de passe en utilisant l'identifiant "anonymous",
+ "Not Registered", "I Don't Know" ou encore "AnonyMous".</p>
- <p>As of Apache 2.1 it is possible to specify the userID as
- "<code>*</code>". That allows <em>any</em> supplied userID to be
- accepted.</p>
+ <p>Depuis Apache 2.1, il est possible de remplacer la liste des
+ identifiants autorisés par le caractère "<code>*</code>", ce qui
+ permet d'utiliser <em>n'importe quel</em> identifiant pour pouvoir
+ accéder au site.</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="anonymous_logemail" id="anonymous_logemail">Directive</a> <a name="Anonymous_LogEmail" id="Anonymous_LogEmail">Anonymous_LogEmail</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether the password entered will be logged in the
-error log</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le mot de passe fourni sera enregistré dans le
+journal des erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous_LogEmail On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Anonymous_LogEmail On</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_anon</td></tr>
</table>
- <p>When set <code>On</code>, the default, the 'password' entered
- (which hopefully contains a sensible email address) is logged in
- the error log.</p>
+ <p>Lorsque cette directive est définie à <code>On</code>, valeur
+ par défaut, le 'mot de passe' fourni (censé contenir une adresse
+ email valide) est enregistré dans le journal des erreurs.</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="anonymous_mustgiveemail" id="anonymous_mustgiveemail">Directive</a> <a name="Anonymous_MustGiveEmail" id="Anonymous_MustGiveEmail">Anonymous_MustGiveEmail</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies whether blank passwords are allowed</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si l'abscence de mot de passe est
+autorisée</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous_MustGiveEmail On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Anonymous_MustGiveEmail On</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_anon</td></tr>
</table>
- <p>Specifies whether the user must specify an email address as
- the password. This prohibits blank passwords.</p>
+ <p>Détermine si l'utilisateur doit spécifier une adresse email comme
+ mot de passe. Lorsque cette directive est définie à <code>On</code>,
+ fournir un mot de passe est obligatoire.</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="anonymous_nouserid" id="anonymous_nouserid">Directive</a> <a name="Anonymous_NoUserID" id="Anonymous_NoUserID">Anonymous_NoUserID</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether the userID field may be empty</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le champ identifiant peut être
+vide</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous_NoUserID On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Anonymous_NoUserID 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_anon</td></tr>
</table>
- <p>When set <code>On</code>, users can leave the userID (and
- perhaps the password field) empty. This can be very convenient for
- MS-Explorer users who can just hit return or click directly on the
- OK button; which seems a natural reaction.</p>
+ <p>Lorsque cette directive est définie à <code>On</code>, les
+ utilisateurs peuvent laisser le champ identifiant vide (et peut-être
+ aussi le champ mot de passe selon la définition de la directive
+ <code class="directive"><a href="#anonymous_mustgiveemail">Anonymous_MustGiveEmail</a></code>). Ceci
+ peut s'avérer très utile pour les utilisateurs de MS-Explorer qui
+ ont pour seule possibilité d'appuyer sur Entrée ou de cliquer
+ directement sur le bouton OK, ce qui semble être une réaction
+ naturelle.</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="anonymous_verifyemail" id="anonymous_verifyemail">Directive</a> <a name="Anonymous_VerifyEmail" id="Anonymous_VerifyEmail">Anonymous_VerifyEmail</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether to check the password field for a correctly
-formatted email address</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine s'il faut vérifier que le format de l'adresse
+email fournie comme mot de passe est correct</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Anonymous_VerifyEmail On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Anonymous_VerifyEmail 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_anon</td></tr>
</table>
- <p>When set <code>On</code> the 'password' entered is checked for
- at least one '@' and a '.' to encourage users to enter valid email
- addresses (see the above <code class="directive"><a href="#anonymous_logemail">Anonymous_LogEmail</a></code>).</p>
+ <p>Lorsque cette directive est définie à <code>On</code>, Apache
+ vérifie que le 'mot de passe' entré contient au moins un '@' et un
+ '.' afin d'inciter les utilisateurs à fournir des adresses email
+ valides (voir ci-dessus la directive <code class="directive"><a href="#anonymous_logemail">Anonymous_LogEmail</a></code>).</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="authname" id="authname">Directive</a> <a name="AuthName" id="AuthName">AuthName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Authorization realm for use in HTTP
-authentication</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthName <var>auth-domain</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'identifiant de l'autorisation à utiliser avec
+l'authentification HTTP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthName <var>identifiant d'autorisation</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr>
</table>
- <p>This directive sets the name of the authorization realm for a
- directory. This realm is given to the client so that the user
- knows which username and password to send.
- <code class="directive">AuthName</code> takes a single argument; if the
- realm name contains spaces, it must be enclosed in quotation
- marks. It must be accompanied by <code class="directive"><a href="#authtype">AuthType</a></code> and <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directives, and directives such
- as <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> and
- <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> to
- work.</p>
-
- <p>For example:</p>
+ <p>Cette directive permet de définir l'identifiant d'autorisation
+ pour un répertoire. Cet identifiant est fourni au client de façon à
+ ce qu'il sache quels nom d'utilisateur et mot de passe envoyer.
+ <code class="directive">AuthName</code> accepte un seul argument ; s'il
+ contient des espaces, il doit être entouré de guillemets. Pour
+ pouvoir fonctionner, la directive <code class="directive">AuthName</code>
+ doit être utilisée en combinaison avec les directives <code class="directive"><a href="#authtype">AuthType</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, ainsi que des
+ directives comme <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> et <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>.</p>
+
+ <p>Par exemple :</p>
<pre class="prettyprint lang-config">AuthName "Top Secret"</pre>
- <p>The string provided for the <code>AuthName</code> is what will
- appear in the password dialog provided by most browsers.</p>
+ <p>La chaîne fournie comme argument à <code>AuthName</code>
+ apparaîtra dans la boîte de dialogue d'authentification pour la
+ plupart des navigateurs.</p>
- <p>The <a href="../expr.html">expression syntax</a> can be
- used inside the directive to produce the name dynamically.</p>
+ <p>Il est possible de définir cette directive en utilisant la <a href="../expr.html">syntaxe des expressions</a> pour
+ spécifier l'identifiant d'autorisation de manière dynamique.</p>
- <p>For example:</p>
+ <p>Exemple :</p>
<pre class="prettyprint lang-config">AuthName "%{HTTP_HOST}"</pre>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../howto/auth.html">Authentication, Authorization, and
- Access Control</a></li>
+<li><a href="../howto/auth.html">Authentification, autorisation et contrôle
+ d'accès</a></li>
<li><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></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="authnprovideralias" id="authnprovideralias">Directive</a> <a name="AuthnProviderAlias" id="AuthnProviderAlias"><AuthnProviderAlias></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
-extension of a base authentication provider and referenced by
-the specified alias</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthnProviderAlias <var>baseProvider Alias</var>>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui constituent une
+extension d'un fournisseur d'authentification de base et lui attribue
+l'alias spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthnProviderAlias <var>alias-fournisseur</var>>
... </AuthnProviderAlias></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr>
</table>
- <p><code><AuthnProviderAlias></code> and
- <code></AuthnProviderAlias></code> are used to enclose a group of
- authentication directives that can be referenced by the alias name
- using one of the directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">
- AuthBasicProvider</a></code> or <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">
- AuthDigestProvider</a></code>.</p>
+ <p>Les balises <code><AuthnProviderAlias></code> et
+ <code></AuthnProviderAlias></code> permettent de regrouper un
+ ensemble de directives d'authentification qui seront référencées par
+ l'alias spécifié à l'aide des directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>.</p>
+
+ <div class="note">Cette directive n'a aucun influence sur le processus
+ d'autorisation, même pour les modules qui fournissent à la fois
+ l'authentification et l'autorisation.</div>
- <div class="note">This directive has no affect on authorization, even for modules that
- provide both authentication and authorization.</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="authtype" id="authtype">Directive</a> <a name="AuthType" id="AuthType">AuthType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of user authentication</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type d'authentification utilisateur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthType None|Basic|Digest|Form</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr>
</table>
- <p>This directive selects the type of user authentication for a
- directory. The authentication types available are <code>None</code>,
- <code>Basic</code> (implemented by
- <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>), <code>Digest</code>
- (implemented by <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>), and
- <code>Form</code> (implemented by <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>).</p>
-
- <p>To implement authentication, you must also use the <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directives. In addition, the
- server must have an authentication-provider module such as
- <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> and an authorization module such
- as <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p>
-
- <p>The authentication type <code>None</code> disables authentication.
- When authentication is enabled, it is normally inherited by each
- subsequent <a href="../sections.html#mergin">configuration section</a>,
- unless a different authentication type is specified. If no
- authentication is desired for a subsection of an authenticated
- section, the authentication type <code>None</code> may be used;
- in the following example, clients may access the
- <code>/www/docs/public</code> directory without authenticating:</p>
+ <p>Cette directive permet de définir le type d'authentification
+ utilisateur pour un répertoire. Les types d'authentification
+ disponibles sont <code>None</code>, <code>Basic</code> (implémenté
+ par <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>), <code>Digest</code>
+ (implémenté par <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>), et
+ <code>Form</code> (implémenté par
+ <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>).</p>
+
+ <p>Pour mettre en oeuvre l'authentification, vous devez aussi
+ utiliser les directives <code class="directive"><a href="#authname">AuthName</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. De plus, le serveur
+ doit pouvoir disposer d'un module fournisseur d'authentification
+ comme <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et d'un module d'autorisation
+ comme <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p>
+
+ <p>Le type d'authentification <code>None</code> désactive
+ l'authentification. Lorsqu'une authentification est définie, elle
+ est en général héritée par chacune des <a href="../sections.html#mergin">sections de configuration</a> qui
+ suivent, à moins qu'un autre type d'authentification ne soit
+ spécifié. Si l'on ne souhaite pas mettre en oeuvre
+ d'authentification pour une sous-section d'une section authentifiée,
+ on doit utiliser le type d'authentification <code>None</code> ; dans
+ l'exemple suivant, les clients peuvent accéder au répertoire
+ <code>/www/docs/public</code> sans devoir s'authentifier :</p>
<pre class="prettyprint lang-config"><Directory "/www/docs">
AuthType Basic
</Directory></pre>
- <p>From 2.4.13, <a href="../expr.html">expression syntax</a> can be
- used inside the directive to specify the type dynamically.</p>
+ <p>A partir de la version 2.4.13, il est possible de définir cette
+ directive en utilisant la <a href="../expr.html">syntaxe des expressions</a> pour
+ spécifier le type d'authentification de manière dynamique.</p>
- <div class="note">When disabling authentication, note that clients which have
- already authenticated against another portion of the server's document
- tree will typically continue to send authentication HTTP headers
- or cookies with each request, regardless of whether the server
- actually requires authentication for every resource.</div>
+ <div class="note">Veuillez noter que, lorsque l'authentification n'est pas
+ activée, les clients qui se sont déjà authentifiés pour une autre
+ zone de l'arborescence du site continueront en général à envoyer des
+ en-tête d'authentification HTTP ou des cookies avec chaque requête,
+ sans se préoccuper de savoir si le serveur nécessite vraiment une
+ authentification pour chaque ressource.</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../howto/auth.html">Authentication, Authorization,
- and Access Control</a></li>
+<li><a href="../howto/auth.html">Authentification, autorisation et contrôle
+ d'accès</a></li>
</ul>
</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="authdbduserpwquery" id="authdbduserpwquery">Directive</a> <a name="AuthDBDUserPWQuery" id="AuthDBDUserPWQuery">AuthDBDUserPWQuery</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SQL query to look up a password for a user</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBDUserPWQuery <var>query</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Requête SQL servant à vérifier le mot de passe d'un
+utilisateur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBDUserPWQuery <var>requête</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_dbd</td></tr>
</table>
- <p>The <code class="directive">AuthDBDUserPWQuery</code> specifies an
- SQL query to look up a password for a specified user. The user's ID
- will be passed as a single string parameter when the SQL query is
- executed. It may be referenced within the query statement using
- a <code>%s</code> format specifier.</p>
+ <p>La directive <code class="directive">AuthDBDUserPWQuery</code> permet de
+ spécifier une requête servant à vérifier le mot de passe d'un
+ utilisateur donné. L'identifiant utilisateur sera transmis comme
+ paramètre sous forme d'une seule chaîne de caractères lorsque la
+ requête sera exécutée. Cet identifiant est référencé dans la requête
+ en utilisant le spécificateur de format <code>%s</code>.</p>
<pre class="prettyprint lang-config">AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"</pre>
- <p>The first column value of the first row returned by the query
- statement should be a string containing the encrypted password.
- Subsequent rows will be ignored. If no rows are returned, the user
- will not be authenticated through <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
- <p>If httpd was built against <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> version 1.3.0
- or higher, any additional column values in the first row returned by
- the query statement will be stored as environment variables with
- names of the form <code>AUTHENTICATE_<var>COLUMN</var></code>.
+ <p>La première colonne du premier enregistrement renvoyé par la
+ requête se présentera sous la forme d'une chaîne de caractères
+ contenant le mot de passe chiffré. Les enregistrements suivants sont
+ ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur ne
+ sera pas authentifié par <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
+ <p>Si httpd a été compilé avec la version 1.3.0 ou supérieure de
+ l'<a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>, toute valeur de colonne supplémentaire
+ du premier enregistrement renvoyé par la requête sera stockée dans
+ une variable d'environnement dont le nom aura la forme
+ <code>AUTHENTICATE_<var>valeur-colonne</var></code>.
</p>
- <p>The encrypted password format depends on which authentication
- frontend (e.g. <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> or
- <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>) is being used. See <a href="../misc/password_encryptions.html">Password Formats</a> for
- more information.</p>
+ <p>Le format du mot de passe chiffré dépend du frontal
+ d'authentification utilisé (par exemple
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ou
+ <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>). Voir la documentation sur les <a href="../misc/password_encryptions.html">Formats de mots de passe</a> pour
+ plus de détails.</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="authdbduserrealmquery" id="authdbduserrealmquery">Directive</a> <a name="AuthDBDUserRealmQuery" id="AuthDBDUserRealmQuery">AuthDBDUserRealmQuery</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SQL query to look up a password hash for a user and realm.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Requête SQL servant à vérifier une empreinte de mot de
+passe pour un utilisateur et un identifiant d'authentification.
</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBDUserRealmQuery <var>query</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBDUserRealmQuery <var>requête</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_dbd</td></tr>
</table>
- <p>The <code class="directive">AuthDBDUserRealmQuery</code> specifies an
- SQL query to look up a password for a specified user and realm in a
- digest authentication process.
- The user's ID and the realm, in that order, will be passed as string
- parameters when the SQL query is executed. They may be referenced
- within the query statement using <code>%s</code> format specifiers.</p>
+ <p>La directive <code class="directive">AuthDBDUserRealmQuery</code> spécifie
+ une requête SQL servant à vérifier une empreinte de mot
+ de passe pour un utilisateur et un identifiant d'authentification
+ donnés au cours d'un processus d'authentification digest. Les
+ identifiants de l'utilisateur et de l'authentification
+ sont passés dans cet ordre comme paramètres à l'exécution de la
+ requête. Ils sont référencés dans la chaîne de la requête en
+ utilisant des spécificateurs de format <code>%s</code>.</p>
<pre class="prettyprint lang-config">AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s"</pre>
- <p>The first column value of the first row returned by the query
- statement should be a string containing the encrypted password.
- Subsequent rows will be ignored. If no rows are returned, the user
- will not be authenticated through <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
- <p>If httpd was built against <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> version 1.3.0
- or higher, any additional column values in the first row returned by
- the query statement will be stored as environment variables with
- names of the form <code>AUTHENTICATE_<var>COLUMN</var></code>.
+ <p>La première colonne du premier enregistrement renvoyé par la
+ requête se présentera sous la forme d'une chaîne de caractères
+ contenant le mot de passe chiffré. Les enregistrements suivants
+ seront ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur
+ ne sera pas authentifié par <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
+ <p>Si httpd a été compilé avec une version 1.3.0 ou supérieure de
+ l'<a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>, toute valeur de colonne supplémentaire
+ du premier enregistrement renvoyé par la requête sera stockée dans
+ une variable d'environnement avec un nom de la forme
+ <code>AUTHENTICATE_<var>COLONNE</var></code>.
</p>
- <p>The encrypted password format depends on which authentication
- frontend (e.g. <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> or
- <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>) is being used. See <a href="../misc/password_encryptions.html">Password Formats</a> for
- more information.</p>
+ <p>Le format du mot de passe chiffré dépend du frontal
+ d'authentification utilisé (par exemple
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ou
+ <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>). Voir la documentation sur les <a href="../misc/password_encryptions.html">Formats de mots de passe</a> pour
+ plus de détails.</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="authdbmtype" id="authdbmtype">Directive</a> <a name="AuthDBMType" id="AuthDBMType">AuthDBMType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the type of database file that is used to
-store passwords</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le type de fichier de base de données utilisé pour
+stocker les mots de passe</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBMType default|SDBM|GDBM|NDBM|DB</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDBMType default</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_dbm</td></tr>
</table>
- <p>Sets the type of database file that is used to store the passwords.
- The default database type is determined at compile time. The
- availability of other types of database files also depends on
- <a href="../programs/configure.html#options">compile-time settings</a>.</p>
+ <p>Cette directive définit le type de fichier de base de
+ données utilisé pour stocker les mots de passe. Le type de base de
+ données par défaut est défini à la compilation. La liste des autres
+ types de bases de données disponibles dépend aussi de la configuration de la
+ <a href="../programs/configure.html#options">compilation</a>.</p>
- <p>For example, in order to enable the support for Berkeley DB
- (correspondent to the <code>db</code> type) the
- <code>--with-berkeley-db</code> option needs to be added to httpd's
- configure to generate the necessary DSO.</p>
+ <p>Par exemple, pour activer le support de Berkeley DB (correspondant au
+ type <code>db</code>), il faut ajouter l'option
+ <code>--with-berkeley-db</code> à la ligne de commande configure de httpd
+ pour générer le DSO approprié.</p>
- <p>It is crucial that whatever program you use to create your password
- files is configured to use the same type of database.</p>
+ <p>Il est impératif que le programme que vous utilisez pour créer
+ vos fichiers de mots de passe soit configuré pour utiliser le même
+ type de base de donné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="authdbmuserfile" id="authdbmuserfile">Directive</a> <a name="AuthDBMUserFile" id="AuthDBMUserFile">AuthDBMUserFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a database file containing the list of users and
-passwords for authentication</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBMUserFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom d'un fichier de base de données pour
+l'authentification contenant la liste
+des utilisateurs et de leurs mots de passe</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBMUserFile <var>chemin-fichier</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_dbm</td></tr>
</table>
- <p>The <code class="directive">AuthDBMUserFile</code> directive sets the
- name of a DBM file containing the list of users and passwords for
- user authentication. <var>File-path</var> is the absolute path to
- the user file.</p>
+ <p>La directive <code class="directive">AuthDBMUserFile</code> définit
+ le nom d'un fichier de base de données pour
+ l'authentification contenant la liste des utilisateurs et de leurs
+ mots de passe. <var>chemin-fichier</var> doit être un chemin absolu
+ vers le fichier de base de données.</p>
- <p>The user file is keyed on the username. The value for a user is
- the encrypted password, optionally followed by a colon and arbitrary
- data. The colon and the data following it will be ignored by the
- server.</p>
+ <p>La clé du fichier de base de données est le nom de l'utilisateur.
+ La valeur associée est le mot de passe chiffré, éventuellement suivi
+ par un ':' et des données aléatoires. Ce ':' ainsi que les données
+ aléatoires qui suivent seront ignorées par le serveur.</p>
- <div class="warning"><h3>Security:</h3>
- <p>Make sure that the <code class="directive">AuthDBMUserFile</code> is stored
- outside the document tree of the web-server; do <em>not</em> put it in
- the directory that it protects. Otherwise, clients will be able to
- download the <code class="directive">AuthDBMUserFile</code>.</p>
+ <div class="warning"><h3>Sécurité :</h3>
+ <p>Faites en sorte que le fichier spécifié par la directive
+ <code class="directive">AuthDBMUserFile</code> soit stocké en dehors de
+ l'arborescence des documents du serveur web ; en particulier, ne
+ l'enregistrez <em>pas</em> dans le répertoire qu'il protège, faute
+ de quoi, les clients auraient la possibilité de
+ télécharger le fichier des mots de passe.</p>
</div>
- <p>The encrypted password format depends on which authentication
- frontend (e.g. <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> or
- <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>) is being used. See <a href="../misc/password_encryptions.html">Password Formats</a> for
- more information.</p>
+ <p>Le format de mot de passe chiffré dépend du frontal
+ d'authentification utilisé (par exemple
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ou
+ <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>). Voir la documentation sur les <a href="../misc/password_encryptions.html">Formats de mots de
+ passe</a> pour plus de détails.</p>
- <p>Important compatibility note: The implementation of
- <code>dbmopen</code> in the Apache modules reads the string length of
- the hashed values from the DBM data structures, rather than relying
- upon the string being NULL-appended. Some applications, such as
- the Netscape web server, rely upon the string being
- NULL-appended, so if you are having trouble using DBM files
- interchangeably between applications this may be a part of the
- problem.</p>
+ <p>Note importante concernant la compatibilité : l'implémentation de
+ <code>dbmopen</code> dans les modules d'Apache lit la longueur de la
+ chaîne correspondant aux données chiffrées dans la structure des
+ données DBM, plutôt que de calculer cette longueur en se basant sur
+ le caractère nul final. Certaines applications par contre, comme le
+ serveur web Netscape, calculent cette longueur en se basant sur
+ le caractère nul final ; par conséquent, si vous rencontrez des
+ difficultés en échangeant des fichiers DBM entre plusieurs
+ applications, le problème peut éventuellement s'expliquer par cette
+ différence d'implémentation.</p>
- <p>A perl script called
- <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> is included with
- Apache. This program can be used to create and update DBM
- format password files for use with this module. Another
- tool for maintaining the DBM files is the included program
- <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</p>
+ <p>Un script perl nommé <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> est fourni avec
+ Apache. On peut utiliser ce programme pour créer et mettre à jour
+ les fichiers de mots de passe au format DBM que ce module
+ utilise. Le programme fourni <code class="program"><a href="../programs/htdbm.html">htdbm</a></code> est un autre
+ utilitaire permettant de maintenir les fichiers DBM.</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="authuserfile" id="authuserfile">Directive</a> <a name="AuthUserFile" id="AuthUserFile">AuthUserFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a text file containing the list of users and
-passwords for authentication</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthUserFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom d'un fichier texte pour l'authentification
+contenant la liste des utilisateurs et de leurs mots de
+passe</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthUserFile <var>chemin-fichier</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_file</td></tr>
</table>
- <p>The <code class="directive">AuthUserFile</code> directive sets the name
- of a textual file containing the list of users and passwords for
- user authentication. <var>File-path</var> is the path to the user
- file. If it is not absolute, it is treated as relative to the
- <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
+ <p>La directive <code class="directive">AuthUserFile</code> permet de
+ définir le nom d'un fichier texte pour l'authentification contenant
+ la liste des utilisateurs et de leurs mots de passe.
+ <var>chemin-fichier</var> est le chemin vers le fichier
+ des utilisateurs. S'il n'est pas absolu, il est considéré comme
+ relatif au répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
- <p>Each line of the user file contains a username followed by
- a colon, followed by the encrypted password. If the same user
- ID is defined multiple times, <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> will
- use the first occurrence to verify the password.</p>
+ <p>Chaque ligne du fichier des utilisateurs se compose du nom de
+ l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le
+ même identifiant utilisateur est référencé plusieurs fois,
+ <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> utilisera la première occurrence pour
+ vérifier le mot de passe.</p>
- <p>The encrypted password format depends on which authentication
- frontend (e.g. <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> or
- <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>) is being used. See <a href="../misc/password_encryptions.html">Password Formats</a> for
- more information.</p>
+ <p>Le format du mot de passe chiffré dépend du frontal
+ d'authentification utilisé (par exemple
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ou
+ <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>). Voir la documentation sur les
+ <a href="../misc/password_encryptions.html">Formats de mots de
+ passe</a> pour plus de détails.</p>
- <p>For <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, use the utility <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>
- which is installed as part of the binary distribution, or which
- can be found in <code>src/support</code>. See the
- <a href="../programs/htpasswd.html">man page</a> for more details.
- In short:</p>
+ <p>Pour <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, utilisez le programme
+ <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> fourni avec la distribution binaire,
+ mais que vous trouverez aussi dans le répertoire
+ <code>src/support</code> de l'arborescence des sources. Voir sa <a href="../programs/htpasswd.html">page de manuel</a> pour plus de
+ détails. En bref :</p>
- <p>Create a password file <code>Filename</code> with
- <code>username</code> as the initial ID. It will prompt for
- the password:</p>
+ <p>On crée un fichier de mots de passe <code>nom-fichier</code> avec
+ <code>nom-utilisateur</code> comme identifiant initial. Le mot de
+ passe correspondant sera alors demandé :</p>
<div class="example"><p><code>
- htpasswd -c Filename username
+ htpasswd -c nom-fichier nom-utilisateur
</code></p></div>
- <p>Add or modify <code>username2</code> in the password file
- <code>Filename</code>:</p>
+ <p>Pour ajouter ou modifier <code>nom-utilisateur2</code> dans le
+ fichier de mots de passe <code>nom-fichier</code> :</p>
<div class="example"><p><code>
- htpasswd Filename username2
+ htpasswd nom-fichier nom-utilisateur2
</code></p></div>
- <p>Note that searching large text files is <em>very</em>
- inefficient; <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code> should be used
- instead.</p>
+ <p>Noter qu'une recherche dans de grands fichiers texte peut être
+ très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM
+ avec la directive <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>.</p>
- <p>For <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>, use <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>
- instead. Note that you cannot mix user data for Digest Authentication
- and Basic Authentication within the same file.</p>
+ <p>Pour <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>, vous devez utiliser
+ le programme <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.
+ Notez que vous ne pouvez pas mélanger des données utilisateur pour
+ l'Authentification HTTP à base de condensé et des données pour
+ l'Authentification de Base dans le même fichier.</p>
- <div class="warning"><h3>Security</h3>
- <p>Make sure that the <code class="directive">AuthUserFile</code> is
- stored outside the document tree of the web-server. Do
- <strong>not</strong> put it in the directory that it protects.
- Otherwise, clients may be able to download the
- <code class="directive">AuthUserFile</code>.</p>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Assurez-vous que le fichier <code class="directive">AuthUserFile</code>
+ soit bien stocké en dehors de l'arborescence des documents du
+ serveur web. Ne placez <strong>pas</strong> ce fichier dans le
+ répertoire qu'il protège. Dans le cas contraire, les clients
+ seraient en mesure de télécharger le fichier des mots de passe.</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="authncachecontext" id="authncachecontext">Directive</a> <a name="AuthnCacheContext" id="AuthnCacheContext">AuthnCacheContext</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a context string for use in the cache key</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheContext <var>directory|server|custom-string</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie une chaîne de contexte à utiliser dans la clé du
+cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheContext <var>directory|server|chaîne-personnalisée</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>directory</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
</table>
- <p>This directive specifies a string to be used along with the supplied
- username (and realm in the case of Digest Authentication) in constructing
- a cache key. This serves to disambiguate identical usernames serving
- different authentication areas on the server.</p>
- <p>Two special values for this are <var>directory</var>, which uses
- the directory context of the request as a string, and <var>server</var>
- which uses the virtual host name.</p>
- <p>The default is <var>directory</var>, which is also the most
- conservative setting. This is likely to be less than optimal, as it
- (for example) causes <var>$app-base</var>, <var>$app-base/images</var>,
- <var>$app-base/scripts</var> and <var>$app-base/media</var> each to
- have its own separate cache key. A better policy is to name the
- <code class="directive">AuthnCacheContext</code> for the password
- provider: for example a <var>htpasswd</var> file or database table.</p>
- <p>Contexts can be shared across different areas of a server, where
- credentials are shared. However, this has potential to become a vector
- for cross-site or cross-application security breaches, so this directive
- is not permitted in <var>.htaccess</var> contexts.</p>
+ <p>Cette directive permet de spécifier une chaîne à utiliser avec le
+ nom d'utilisateur fourni (et le domaine d'authentification - realm -
+ dans le cas d'une authentification à base de condensés) lors de la
+ construction d'une clé de cache. Ceci permet de lever l'ambiguïté
+ entre plusieurs noms d'utilisateurs identiques servant différentes
+ zones d'authentification sur le serveur.</p>
+ <p>Il y a deux valeurs spéciales pour le paramètre : <var>directory</var>,
+ qui utilise le contexte de répertoire de la requête comme chaîne, et
+ <var>server</var>, qui utilise le nom du serveur virtuel.</p>
+ <p>La valeur par défaut est <var>directory</var>, qui est aussi la
+ définition la plus courante. Ceci est cependant loin d'être optimal,
+ car par exemple, <var>$app-base</var>, <var>$app-base/images</var>,
+ <var>$app-base/scripts</var> et <var>$app-base/media</var>
+ possèderont chacun leur propre clé de cache. Il est préférable
+ d'utiliser le fournisseur de mot de passe : par exemple un fichier
+ <var>htpasswd</var> ou une table de base de données.</p>
+ <p>Les contextes peuvent être partagés entre différentes zones du
+ serveur, où les données d'authentification sont partagées. Ceci est
+ cependant susceptible de créer des trous de sécurité de type
+ cross-site ou cross-application, et cette directive n'est donc pas
+ disponible dans les contextes <var>.htaccess</var>.</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="authncacheenable" id="authncacheenable">Directive</a> <a name="AuthnCacheEnable" id="AuthnCacheEnable">AuthnCacheEnable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable Authn caching configured anywhere</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la mise en cache de l'authentification en tout
+endroit</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheEnable</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
</table>
- <p>This directive is not normally necessary: it is implied if
- authentication cacheing is enabled anywhere in <var>httpd.conf</var>.
- However, if it is not enabled anywhere in <var>httpd.conf</var>
- it will by default not be initialised, and is therefore not
- available in a <var>.htaccess</var> context. This directive
- ensures it is initialised so it can be used in <var>.htaccess</var>.</p>
+ <p>Normalement, cette directive n'est pas nécessaire : l'activation
+ est implicite si la mise en cache de l'authentification a été
+ activée en tout autre endroit du fichier <var>httpd.conf</var>. Par
+ contre, si cette mise en cache n'a pas été activée, par défaut, elle
+ ne sera pas initialisée, et ne sera donc pas disponible dans un
+ contexte de fichier <var>.htaccess</var>. Cette directive permet
+ d'être sûr que la mise en cache a bien été activée et pourra
+ donc être utilisée dans les fichiers <var>.htaccess</var>.</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="authncacheprovidefor" id="authncacheprovidefor">Directive</a> <a name="AuthnCacheProvideFor" id="AuthnCacheProvideFor">AuthnCacheProvideFor</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify which authn provider(s) to cache for</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheProvideFor <var>authn-provider</var> [...]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le fournisseur pour lequel on veut effectuer une
+mise en cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheProvideFor <var>fournisseur-authn</var> [...]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
</table>
- <p>This directive specifies an authentication provider or providers
- to cache for. Credentials found by a provider not listed in an
- AuthnCacheProvideFor directive will not be cached.</p>
+ <p>Cette directive permet de spécifier un ou plusieurs fournisseurs
+ pour le(s)quel(s) on veut effectuer une mise en cache. Les données
+ d'authentification trouvées par un fournisseur non spécifié dans une
+ directive AuthnCacheProvideFor ne seront pas mises en cache.</p>
- <p>For example, to cache credentials found by <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
- or by a custom provider <var>myprovider</var>, but leave those looked
- up by lightweight providers like file or dbm lookup alone:</p>
- <pre class="prettyprint lang-config">AuthnCacheProvideFor dbd myprovider</pre>
+ <p>Par exemple, pour mettre en cache les données d'authentification
+ trouvées par <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> ou par un fournisseur
+ personnalisé <var>mon-fournisseur</var>, et ne pas mettre en cache
+ celles trouvées par les fournisseurs légers comme file ou dbm :</p>
+ <pre class="prettyprint lang-config">AuthnCacheProvideFor dbd mon-fournisseur</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="authncachesocache" id="authncachesocache">Directive</a> <a name="AuthnCacheSOCache" id="AuthnCacheSOCache">AuthnCacheSOCache</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Select socache backend provider to use</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheSOCache <var>provider-name[:provider-args]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sélectionne le fournisseur socache d'arrière-plan à
+utiliser</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheSOCache <var>nom-fournisseur[:arguments-fournisseur]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Optional provider arguments are available in
-Apache HTTP Server 2.4.7 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les arguments optionnels du fournisseur sont disponibles
+à partir de la version 2.4.7 du serveur HTTP Apache</td></tr>
</table>
- <p>This is a server-wide setting to select a provider for the
- <a href="../socache.html">shared object cache</a>, followed by
- optional arguments for that provider.
- Some possible values for <var>provider-name</var> are "dbm", "dc",
- "memcache", or "shmcb", each subject to the appropriate module
- being loaded. If not set, your platform's default will be used.</p>
+ <p>Cette définition s'applique à l'ensemble du serveur et permet de
+ sélectionner un fournisseur pour le <a href="../socache.html">cache
+ d'objets partagés</a>, ainsi que des arguments éventuels pour ce
+ fournisseur. Les fournisseurs disponibles sont, entre autres, "dbm",
+ "dc", "memcache", ou "shmcb", chacun d'entre eux nécessitant le chargement
+ du module approprié. Si elle est
+ absente, c'est la valeur par défaut pour votre plate-forme 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="authncachetimeout" id="authncachetimeout">Directive</a> <a name="AuthnCacheTimeout" id="AuthnCacheTimeout">AuthnCacheTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set a timeout for cache entries</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheTimeout <var>timeout</var> (seconds)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une durée de vie pour les entrées du cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheTimeout <var>durée-de-vie</var> (secondes)</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>300 (5 minutes)</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
</table>
- <p>Cacheing authentication data can be a security issue, though short-term
- cacheing is unlikely to be a problem. Typically a good solution is to
- cache credentials for as long as it takes to relieve the load on a
- backend, but no longer, though if changes to your users and passwords
- are infrequent then a longer timeout may suit you. The default 300
- seconds (5 minutes) is both cautious and ample to keep the load
- on a backend such as dbd (SQL database queries) down.</p>
- <p>This should not be confused with session timeout, which is an
- entirely separate issue. However, you may wish to check your
- session-management software for whether cached credentials can
- "accidentally" extend a session, and bear it in mind when setting
- your timeout.</p>
+ <p>La mise en cache des données d'authentification peut constituer
+ un trou de sécurité, bien qu'un mise en cache de courte durée ne
+ posera probablement pas de problème. En général, il est conseillé de
+ conserver les entrées du cache de façon à ce que la charge du serveur
+ d'arrière-plan reste normale, mais pas plus longtemps ;
+ une durée de vie plus longue peut être paramétrée si les
+ changements d'utilisateurs et de mots de passe sont peu fréquents.
+ La durée de vie par défaut de 300 secondes (5 minutes) est à la fois
+ raisonnable et suffisamment importante pour réduire la charge d'un
+ serveur d'arrière-plan comme dbd (requêtes SQL).</p>
+ <p>Cette durée de vie ne doit pas être confondue avec la durée de
+ vie de session qui est un tout autre sujet. Cependant, vous devez
+ utiliser votre logiciel de gestion de session pour vérifier si les
+ données d'authentification mises en cache peuvent allonger
+ accidentellement une session, et en tenir compte lorsque vous
+ définissez la durée de vie.</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="authldapauthorizeprefix" id="authldapauthorizeprefix">Directive</a> <a name="AuthLDAPAuthorizePrefix" id="AuthLDAPAuthorizePrefix">AuthLDAPAuthorizePrefix</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the prefix for environment variables set during
-authorization</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPAuthorizePrefix <em>prefix</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le préfixe ajouté aux variables d'environnement
+durant la phase d'autorisation</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPAuthorizePrefix <em>préfixe</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPAuthorizePrefix AUTHORIZE_</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.6 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.6</td></tr>
</table>
- <p>This directive allows you to override the prefix used for environment
- variables set during LDAP authorization. If <em>AUTHENTICATE_</em> is
- specified, consumers of these environment variables see the same information
- whether LDAP has performed authentication, authorization, or both.</p>
+ <p>Cette directive permet de spécifier le préfixe ajouté aux
+ variables d'environnement durant la phase d'autorisation. Si la
+ valeur spécifiée est <em>AUTHENTICATE_</em>, les utilisateurs de ces
+ variables d'environnement verront les mêmes informations, que le
+ serveur effectue une authentification, une autorisation, ou les
+ deux.</p>
<div class="note"><h3>Note</h3>
- No authorization variables are set when a user is authorized on the basis of
- <code>Require valid-user</code>.
+ Aucune variable d'autorisation n'est définie lorsqu'un utilisateur
+ s'est vu autoriser l'accès via la directive <code>Require
+ valid-user</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="authldapbindauthoritative" id="authldapbindauthoritative">Directive</a> <a name="AuthLDAPBindAuthoritative" id="AuthLDAPBindAuthoritative">AuthLDAPBindAuthoritative</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si l'on doit utiliser d'autres fournisseurs
+d'authentification lorsque le serveur ne peut pas valider les données
+d'authentification de l'utilisateur, alors que ce dernier possède un
+DN.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPBindAuthoritative off|on</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPBindAuthoritative on</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>By default, subsequent authentication providers are only queried if a
- user cannot be mapped to a DN, but not if the user can be mapped to a DN and their
- password cannot be verified with an LDAP bind.
- If <code class="directive">AuthLDAPBindAuthoritative</code>
- is set to <em>off</em>, other configured authentication modules will have
- a chance to validate the user if the LDAP bind (with the current user's credentials)
- fails for any reason.</p>
- <p> This allows users present in both LDAP and
- <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> to authenticate
- when the LDAP server is available but the user's account is locked or password
- is otherwise unusable.</p>
+ <p>Par défaut, des fournisseurs d'authentification sont appelés
+ si un utilisateur ne possède pas de DN, mais ne le sont pas si
+ l'utilisateur possède un DN et si son mot de passe ne peut pas être
+ vérifié lors d'une connexion au serveur LDAP. Si la directive
+ <code class="directive">AuthLDAPBindAuthoritative</code> est
+ définie à <em>off</em>, d'autres modules d'authentification
+ configurés auront une chance de valider le mot de passe de
+ l'utilisateur si la tentative de connexion au serveur LDAP échoue
+ pour une raison quelconque (avec les données d'authentification
+ fournies).</p>
+ <p>Ceci permet aux utilisateurs présent à la fois dans l'annuaire
+ LDAP et dans un fichier <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> de s'authentifier
+ lorsque le serveur LDAP est disponible, alors que le compte de
+ l'utilisateur est verrouillé ou que son mot de passe est
+ inutilisable pour une raison quelconque.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapbinddn" id="authldapbinddn">Directive</a> <a name="AuthLDAPBindDN" id="AuthLDAPBindDN">AuthLDAPBindDN</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Optional DN to use in binding to the LDAP server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPBindDN <em>distinguished-name</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Un DN optionnel pour se connecter au serveur
+LDAP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPBindDN <em>dn</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>An optional DN used to bind to the server when searching for
- entries. If not provided, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will use
- an anonymous bind.</p>
+ <p>Cette directive permet de définir un DN optionnel pour se
+ connecter au serveur afin d'y rechercher des entrées. Si aucun DN
+ n'est spécifié, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tentera une
+ connexion anonyme.</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="authldapbindpassword" id="authldapbindpassword">Directive</a> <a name="AuthLDAPBindPassword" id="AuthLDAPBindPassword">AuthLDAPBindPassword</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Password used in conjunction with the bind DN</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPBindPassword <em>password</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mot de passe à utiliser en conjonction avec le DN de
+connexion</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPBindPassword <em>mot-de-passe</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td><em>exec:</em> was added in 2.4.5.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td><em>exec:</em> est disponible depuis la version 2.4.5 du
+serveur HTTP Apache.</td></tr>
</table>
- <p>A bind password to use in conjunction with the bind DN. Note
- that the bind password is probably sensitive data, and should be
- properly protected. You should only use the <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code> and <code class="directive">AuthLDAPBindPassword</code> if you
- absolutely need them to search the directory.</p>
-
- <p>If the value begins with exec: the resulting command will be
- executed and the first line returned to standard output by the
- program will be used as the password.</p>
-<pre class="prettyprint lang-config">#Password used as-is
+ <p>Cette directive permet de spécifier un mot de passe à utiliser en
+ conjonction avec le DN de connexion. Notez que ce mot de passe
+ constitue en général une donnée sensible, et doit donc être protégé
+ de manière appropriée. Vous ne devez utiliser les directives
+ <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code> et
+ <code class="directive">AuthLDAPBindPassword</code> que si
+ vous en avez vraiment besoin pour effectuer une recherche dans
+ l'annuaire.</p>
+
+ <p>Si la valeur commence par exec:, la commande résultante sera
+ exécutée, et la première ligne renvoyée sur la sortie standard sera
+ utilisée comme mot de passe.</p>
+<pre class="prettyprint lang-config">#Mot de passe utilisé tel quel
AuthLDAPBindPassword secret
-#Run /path/to/program to get my password
+#Exécute /path/to/program pour obtenir le mot de passe
AuthLDAPBindPassword exec:/path/to/program
-#Run /path/to/otherProgram and provide arguments
+#Exécute /path/to/otherProgram avec un argument pour obtenir le mot de passe
AuthLDAPBindPassword "exec:/path/to/otherProgram argument1"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapcharsetconfig" id="authldapcharsetconfig">Directive</a> <a name="AuthLDAPCharsetConfig" id="AuthLDAPCharsetConfig">AuthLDAPCharsetConfig</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Language to charset conversion configuration file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPCharsetConfig <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier de configuration de la correspondance
+langage/jeu de caractères</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPCharsetConfig <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>The <code class="directive">AuthLDAPCharsetConfig</code> directive sets the location
- of the language to charset conversion configuration file. <var>File-path</var> is relative
- to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. This file specifies
- the list of language extensions to character sets.
- Most administrators use the provided <code>charset.conv</code>
- file, which associates common language extensions to character sets.</p>
-
- <p>The file contains lines in the following format:</p>
+ <p>La directive <code class="directive">AuthLDAPCharsetConfig</code> permet
+ de définir le chemin du fichier de configuration de la
+ correspondance langage/jeu de caractères. <var>chemin-fichier</var>
+ est un chemin relatif au répertoire défini par la directive
+ <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Ce fichier contient une liste
+ de correspondances extension de langage/jeu de caractères. La
+ plupart des administrateurs utilisent le fichier
+ <code>charset.conv</code> fourni qui associe les extensions de
+ langage courantes à leurs jeux de caractères.</p>
+
+ <p>Le fichier contient des lignes au format suivant :</p>
<div class="example"><p><code>
- <var>Language-Extension</var> <var>charset</var> [<var>Language-String</var>] ...
+ <var>extension de langage</var> <var>jeu de caractères</var>
+ [<var>Nom du langage</var>] ...
</code></p></div>
- <p>The case of the extension does not matter. Blank lines, and lines
- beginning with a hash character (<code>#</code>) are ignored.</p>
+ <p>L'extension est insensible à la casse. Les lignes vides et les
+ lignes commençant par un dièse (<code>#</code>) sont ignoré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="authldapcompareasuser" id="authldapcompareasuser">Directive</a> <a name="AuthLDAPCompareAsUser" id="AuthLDAPCompareAsUser">AuthLDAPCompareAsUser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the authenticated user's credentials to perform authorization comparisons</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilisation des données d'authentification de l'utilisateur
+pour effectuer les comparaisons pour l'attribution des autorisations</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPCompareAsUser on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPCompareAsUser 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.6 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version version 2.3.6</td></tr>
</table>
- <p>When set, and <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> has authenticated the
- user, LDAP comparisons for authorization use the queried distinguished name (DN)
- and HTTP basic authentication password of the authenticated user instead of
- the servers configured credentials.</p>
-
- <p> The <em>ldap-attribute</em>, <em>ldap-user</em>, and <em>ldap-group</em> (single-level only)
- authorization checks use comparisons.</p>
-
- <p>This directive only has effect on the comparisons performed during
- nested group processing when <code class="directive"><a href="#authldapsearchasuser">
- AuthLDAPSearchAsUser</a></code> is also enabled.</p>
-
- <p> This directive should only be used when your LDAP server doesn't
- accept anonymous comparisons and you cannot use a dedicated
- <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
- </p>
+ <p>Lorsque cette directive est définie, et si
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> a authentifié l'utilisateur, les
+ recherches LDAP pour les autorisations utilisent le nom distinctif
+ trouvé (DN) et le mot de passe d'authentification basique HTTP de
+ l'utilisateur authentifié au lieu des données d'authentification
+ configurées au niveau du serveur.</p>
+
+ <p>Les vérifications d'autorisation <em>ldap-attribute</em>,
+ <em>ldap-user</em>, et <em>ldap-group</em> (niveau simple seulement)
+ utilisent des comparaisons.</p>
+
+ <p>Cette directive n'a d'effet sur les comparaisons effectuées au
+ cours des traitements de groupe imbriqués, et lorsque la directive
+ <code class="directive"><a href="#authldapsearchasuser">AuthLDAPSearchAsUser</a></code>
+ est aussi activée.</p>
+
+ <p>Cette directive ne doit être utilisée que si votre serveur LDAP
+ n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
+ utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
+ </p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapcomparednonserver" id="authldapcomparednonserver">Directive</a> <a name="AuthLDAPCompareDNOnServer" id="AuthLDAPCompareDNOnServer">AuthLDAPCompareDNOnServer</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the LDAP server to compare the DNs</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le serveur LDAP pour comparer les DNs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPCompareDNOnServer on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPCompareDNOnServer on</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>When set, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will use the LDAP
- server to compare the DNs. This is the only foolproof way to
- compare DNs. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will search the
- directory for the DN specified with the <a href="#reqdn"><code>Require dn</code></a> directive, then,
- retrieve the DN and compare it with the DN retrieved from the user
- entry. If this directive is not set,
- <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> simply does a string comparison. It
- is possible to get false negatives with this approach, but it is
- much faster. Note the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> cache can speed up
- DN comparison in most situations.</p>
+ <p>Lorsque cette directive est définie à on,
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> utilise le serveur LDAP pour
+ comparer les DNs. Il s'agit de la seule méthode infaillible pour
+ comparer les DNs. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> va rechercher
+ dans l'annuaire le DN spécifié par la directive <a href="#reqdn"><code>Require dn</code></a>, puis extraire ce DN et le
+ comparer avec le DN extrait de l'entrée de l'utilisateur. Si cette
+ directive est à off, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> effectue une
+ simple comparaison de chaînes. Cette dernière approche peut produire
+ des faux négatifs, mais elle est beaucoup plus rapide. Notez
+ cependant que le cache de <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> peut accélérer
+ la comparaison de DNs dans la plupart des situations.</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="authldapdereferencealiases" id="authldapdereferencealiases">Directive</a> <a name="AuthLDAPDereferenceAliases" id="AuthLDAPDereferenceAliases">AuthLDAPDereferenceAliases</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>When will the module de-reference aliases</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>À quel moment le module va déréférencer les
+alias</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPDereferenceAliases never|searching|finding|always</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPDereferenceAliases always</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>This directive specifies when <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will
- de-reference aliases during LDAP operations. The default is
+ <p>Cette directive permet de spécifier à quel moment
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> va déréférencer les alias au cours
+ des opérations liées à LDAP. La valeur par défaut est
<code>always</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="authldapgroupattribute" id="authldapgroupattribute">Directive</a> <a name="AuthLDAPGroupAttribute" id="AuthLDAPGroupAttribute">AuthLDAPGroupAttribute</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>LDAP attributes used to identify the user members of
-groups.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPGroupAttribute <em>attribute</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'attribut LDAP utilisé pour vérifier l'appartenance d'un
+utilisateur à un groupe.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPGroupAttribute <em>attribut</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPGroupAttribute member uniquemember</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>This directive specifies which LDAP attributes are used to
- check for user members within groups. Multiple attributes can be used
- by specifying this directive multiple times. If not specified,
- then <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> uses the <code>member</code> and
- <code>uniquemember</code> attributes.</p>
+ <p>Cette directive permet de spécifier quel attribut LDAP est
+ utilisé pour vérifier l'appartenance d'un utilisateur à un
+ groupe. On peut spécifier plusieurs attributs en répétant cette
+ directive plusieurs fois. Si la directive n'est pas définie,
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> utilise les attributs
+ <code>member</code> et <code>uniquemember</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="authldapgroupattributeisdn" id="authldapgroupattributeisdn">Directive</a> <a name="AuthLDAPGroupAttributeIsDN" id="AuthLDAPGroupAttributeIsDN">AuthLDAPGroupAttributeIsDN</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the DN of the client username when checking for
-group membership</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le DN de l'utilisateur pour vérifier son
+appartenance à un groupe</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPGroupAttributeIsDN on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPGroupAttributeIsDN on</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>When set <code>on</code>, this directive says to use the
- distinguished name of the client username when checking for group
- membership. Otherwise, the username will be used. For example,
- assume that the client sent the username <code>bjenson</code>,
- which corresponds to the LDAP DN <code>cn=Babs Jenson,
- o=Example</code>. If this directive is set,
- <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will check if the group has
- <code>cn=Babs Jenson, o=Example</code> as a member. If this
- directive is not set, then <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will
- check if the group has <code>bjenson</code> as a member.</p>
+ <p>Lorsqu'elle est définie à <code>on</code>, cette directive
+ indique que c'est le DN de l'utilisateur qui doit être utilisé pour
+ vérifier son appartenance à un groupe. Dans le cas contraire, c'est
+ le nom de l'utilisateur qui sera utilisé. Par exemple, supposons que
+ le client envoie le nom d'utilisateur <code>bjenson</code>, qui
+ correspond au DN LDAP <code>cn=Babs Jenson,o=Example</code>. Si la
+ directive est à <code>on</code>, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> va
+ vérifier si <code>cn=Babs Jenson, o=Example</code> est un membre du
+ groupe. Dans le cas contraire, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
+ vérifiera si <code>bjenson</code> est un membre du groupe.</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="authldapinitialbindasuser" id="authldapinitialbindasuser">Directive</a> <a name="AuthLDAPInitialBindAsUser" id="AuthLDAPInitialBindAsUser">AuthLDAPInitialBindAsUser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines if the server does the initial DN lookup using the basic authentication users'
-own username, instead of anonymously or with hard-coded credentials for the server</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le serveur effectue la recherche initiale du
+DN en utilisant le nom propre de l'utilisateur pour l'authentification
+de base
+et non de manière anonyme, ou en utilisant des données d'authentification
+codées en dur pour le serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPInitialBindAsUser off|on</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPInitialBindAsUser 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.6 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.6</td></tr>
</table>
- <p>By default, the server either anonymously, or with a dedicated user and
- password, converts the basic authentication username into an LDAP
- distinguished name (DN). This directive forces the server to use the verbatim username
- and password provided by the incoming user to perform the initial DN
- search.</p>
-
- <p> If the verbatim username can't directly bind, but needs some
- cosmetic transformation, see <code class="directive"><a href="#authldapinitialbindpattern">
- AuthLDAPInitialBindPattern</a></code>.</p>
-
- <p> This directive should only be used when your LDAP server doesn't
- accept anonymous searches and you cannot use a dedicated
-
<code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
+ <p>Par défaut, le serveur convertit le nom d'utilisateur pour
+ l'authentification de base en nom distinctif LDAP (DN) soit de
+ manière anonyme, soit avec un couple nom/mot de passe dédié. Cette
+ directive permet de forcer le serveur à utiliser les véritables nom
+ d'utilisateur et mot de passe fournis par l'utilisateur pour
+ effectuer la recherche initiale du DN.</p>
+
+ <p>Si le nom d'utilisateur ne peut pas s'authentifier directement
+ et nécessite de légères modifications, voir la directive <code class="directive"><a href="#authldapinitialbindpattern">AuthLDAPInitialBindPattern</a></code>.</p>
+
+ <p>Cette directive ne doit être utilisée que si votre serveur LDAP
+ n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
+
utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
</p>
- <div class="note"><h3>Not available with authorization-only</h3>
- This directive can only be used if this module authenticates the user, and
- has no effect when this module is used exclusively for authorization.
+ <div class="note"><h3>Non disponible dans la cas d'une autorisation seule</h3>
+ On ne peut utiliser cette directive que si ce module
+ effectue une authentification, et n'a aucun effet si ce module
+ n'est utilisé que pour les processus d'autorisation.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapinitialbindpattern" id="authldapinitialbindpattern">Directive</a> <a name="AuthLDAPInitialBindPattern" id="AuthLDAPInitialBindPattern">AuthLDAPInitialBindPattern</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the transformation of the basic authentication username to be used when binding to the LDAP server
-to perform a DN lookup</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie la modification a apporter au nom d'utilisateur
+pour l'authentification de base lors de l'authentification auprès du
+serveur LDAP pour effectuer une recherche de DN</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPInitialBindPattern <em><var>regex</var> <var>substitution</var></em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPInitialBindPattern (.*) $1 (remote username used verbatim)</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPInitialBindPattern (.*) $1 (nom de l'utilisateur
+distant utilisé tel quel)</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.6 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.6</td></tr>
</table>
- <p>If <code class="directive"><a href="#authldapinitialbindasuser">AuthLDAPInitialBindAsUser</a></code> is set to
- <em>ON</em>, the basic authentication username will be transformed according to the
- regular expression and substitution arguments.</p>
-
- <p> The regular expression argument is compared against the current basic authentication username.
- The substitution argument may contain backreferences, but has no other variable interpolation.</p>
-
- <p> This directive should only be used when your LDAP server doesn't
- accept anonymous searches and you cannot use a dedicated
- <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
- </p>
+ <p>Si la directive <code class="directive"><a href="#authldapinitialbindasuser">AuthLDAPInitialBindAsUser</a></code> est
+ définie à <em>ON</em>, le nom utilisateur pour l'authentification de
+ base sera transformé selon l'expression rationnelle
+ <var>regex</var> et l'argument <var>substitution</var> spécifiés.</p>
+
+ <p>L'expression rationnelle est comparée au nom d'utilisateur pour
+ l'authentification de base courant. L'argument
+ <var>substitution</var> peut contenir des références arrières, mais
+ n'effectue aucune autre interpolation de variable.</p>
+
+ <p>Cette directive ne doit être utilisée que si votre serveur LDAP
+ n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
+ utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
+ </p>
<pre class="prettyprint lang-config">AuthLDAPInitialBindPattern (.+) $1@example.com</pre>
<pre class="prettyprint lang-config">AuthLDAPInitialBindPattern (.+) cn=$1,dc=example,dc=com</pre>
- <div class="note"><h3>Not available with authorization-only</h3>
- This directive can only be used if this module authenticates the user, and
- has no effect when this module is used exclusively for authorization.
- </div>
- <div class="note"><h3>debugging</h3>
- The substituted DN is recorded in the environment variable
- <em>LDAP_BINDASUSER</em>. If the regular expression does not match the input,
- the verbatim username is used.
+ <div class="note"><h3>Non disponible dans la cas d'une autorisation seule</h3>
+ On ne peut utiliser cette directive que si ce module
+ effectue une authentification, et n'a aucun effet si ce module
+ n'est utilisé que pour les processus d'autorisation.
+ </div>
+ <div class="note"><h3>Débogage</h3>
+ Le DN de substitution est enregistré dans la variable
+ d'environnement <em>LDAP_BINDASUSER</em>. Si l'expression
+ rationnelle ne convient pas, le nom d'utilisateur est utilisé
+ tel quel.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapmaxsubgroupdepth" id="authldapmaxsubgroupdepth">Directive</a> <a name="AuthLDAPMaxSubGroupDepth" id="AuthLDAPMaxSubGroupDepth">AuthLDAPMaxSubGroupDepth</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the maximum sub-group nesting depth that will be
-evaluated before the user search is discontinued.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPMaxSubGroupDepth <var>Number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie la profondeur d'imbrication des sous-groupes
+maximale prise en compte avant l'abandon de la recherche de
+l'utilisateur.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPMaxSubGroupDepth <var>Nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPMaxSubGroupDepth 0</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.0 and later, defaulted to 10 in 2.4.x and early 2.5</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.0 du serveur HTTP
+Apache ; la valeur par défaut était 10 dans les versions 2.4.x et les
+premières versions 2.5</td></tr>
</table>
- <p>When this directive is set to a non-zero value <code>X</code>
- combined with use of the <code>Require ldap-group someGroupDN</code>
- directive, the provided user credentials will be searched for
- as a member of the <code>someGroupDN</code> directory object or of
- any group member of the current group up to the maximum nesting
- level <code>X</code> specified by this directive.</p>
- <p>See the <a href="#reqgroup"><code>Require ldap-group</code></a>
- section for a more detailed example.</p>
-
- <div class="note"><h3>Nested groups performance</h3>
- <p> When <code class="directive">AuthLDAPSubGroupAttribute</code> overlaps with
- <code class="directive">AuthLDAPGroupAttribute</code> (as it does by default and
- as required by common LDAP schemas), uncached searching for subgroups in
- large groups can be very slow. If you use large, non-nested groups, keep
- <code class="directive">AuthLDAPMaxSubGroupDepth</code> set to zero.</p>
+ <p>Lorsque cette directive est définie à une valeur <code>X</code>
+ non nulle, en combinaison avec l'utilisation de la directive
+ <code>Require ldap-group DN-groupe</code>, les données de connexion
+ fournies seront utilisées pour vérifier l'appartenance de
+ l'utilisateur à l'objet de l'annuaire <code>DN-groupe</code> ou à
+ tout sous-groupe du groupe courant en tenant compte de la profondeur
+ d'imbrication maximale <code>X</code> spécifiée par la directive.</p>
+ <p>Se référer à la section <a href="#reqgroup"><code>Require
+ ldap-group</code></a> pour un exemple plus détaillé.</p>
+
+ <div class="note"><h3>Performances dans le cas des groupes imbriqués</h3>
+ <p>Lorsque les directives
+ <code class="directive">AuthLDAPSubGroupAttribute</code> et
+ <code class="directive">AuthLDAPGroupAttribute</code> se recouvrent (comme
+ c'est le cas par défaut et requis par les schémas LDAP courants), la
+ recherche de sous-groupes au sein de grands groupes peut être très
+ longue. Si vos groupes sont très grands et non imbriqués, définissez
+ la directive <code class="directive">AuthLDAPMaxSubGroupDepth</code> à 0.</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="authldapremoteuserattribute" id="authldapremoteuserattribute">Directive</a> <a name="AuthLDAPRemoteUserAttribute" id="AuthLDAPRemoteUserAttribute">AuthLDAPRemoteUserAttribute</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the value of the attribute returned during the user
-query to set the REMOTE_USER environment variable</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie l'attribut dont la valeur renvoyée au cours de la
+requête de l'utilisateur sera utilisée pour définir la variable
+d'environnement REMOTE_USER</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPRemoteUserAttribute uid</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>If this directive is set, the value of the
- <code>REMOTE_USER</code> environment variable will be set to the
- value of the attribute specified. Make sure that this attribute is
- included in the list of attributes in the AuthLDAPUrl definition,
- otherwise this directive will have no effect. This directive, if
- present, takes precedence over <code class="directive"><a href="#authldapremoteuserisdn">AuthLDAPRemoteUserIsDN</a></code>. This
- directive is useful should you want people to log into a website
- using an email address, but a backend application expects the
- username as a userid.</p>
- <p> This directive only has effect when this module is used for
- authentication.</p>
+ <p>Lorsque cette directive est définie, la variable d'environnement
+ <code>REMOTE_USER</code> sera définie à la valeur de l'attribut
+ spécifié. Assurez-vous que cet attribut soit bien inclus dans la
+ liste d'attributs spécifiés dans la définition de AuthLDAPUrl ; dans
+ le cas contraire, cette directive n'aurait aucun effet. Si elle est
+ présente, cette directive l'emporte sur <code class="directive"><a href="#authldapremoteuserisdn">AuthLDAPRemoteUserIsDN</a></code>. Elle
+ peut s'avérer utile par exemple, si vous souhaitez que les
+ utilisateurs se connectent à un site web en utilisant leur adresse
+ email, alors qu'une application sous-jacente nécessite un nom
+ d'utilisateur comme identifiant.</p>
+ <p>Cette directive n'a d'effet que si l'on utilise ce module pour
+ l'authentification.</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="authldapremoteuserisdn" id="authldapremoteuserisdn">Directive</a> <a name="AuthLDAPRemoteUserIsDN" id="AuthLDAPRemoteUserIsDN">AuthLDAPRemoteUserIsDN</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the DN of the client username to set the REMOTE_USER
-environment variable</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le DN de l'utilisateur pour définir la variable
+d'environnement REMOTE_USER</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPRemoteUserIsDN on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPRemoteUserIsDN 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>If this directive is set to on, the value of the
- <code>REMOTE_USER</code> environment variable will be set to the full
- distinguished name of the authenticated user, rather than just
- the username that was passed by the client. It is turned off by
- default.</p>
- <p> This directive only has effect when this module is used for
- authentication.</p>
+ <p>Lorsque cette directive est à on, la variable d'environnement
+ <code>REMOTE_USER</code> sera définie avec la valeur du DN complet
+ de l'utilisateur authentifié, et non plus avec simplement le nom
+ d'utilisateur fourni par le client. Elle est définie à off par
+ défaut.</p>
+ <p>Cette directive n'a d'effet que si l'on utilise ce module pour
+ l'authentification.</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="authldapsearchasuser" id="authldapsearchasuser">Directive</a> <a name="AuthLDAPSearchAsUser" id="AuthLDAPSearchAsUser">AuthLDAPSearchAsUser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use the authenticated user's credentials to perform authorization searches</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise les données d'authentification de l'utilisateur
+pour la recherche des autorisations</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPSearchAsUser on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPSearchAsUser 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.6 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.6</td></tr>
</table>
- <p>When set, and <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> has authenticated the
- user, LDAP searches for authorization use the queried distinguished name (DN)
- and HTTP basic authentication password of the authenticated user instead of
- the servers configured credentials.</p>
-
- <p> The <em>ldap-filter</em> and <em>ldap-dn</em> authorization
- checks use searches.</p>
-
- <p>This directive only has effect on the comparisons performed during
- nested group processing when <code class="directive"><a href="#authldapcompareasuser">
- AuthLDAPCompareAsUser</a></code> is also enabled.</p>
+ <p>Lorsque cette directive est définie, et si
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> a authentifié l'utilisateur, les
+ recherches LDAP pour définir les autorisations utilisent le nom
+ distinctif (DN) trouvé et le mot de passe pour l'authentification de
+ base HTTP de l'utilisateur authentifié, au lieu des données
+ d'authentification configurées au niveau du serveur.</p>
+
+ <p>Les vérifications d'autorisation <em>ldap-filter</em> et
+ <em>ldap-dn</em> utilisent des recherches.</p>
+
+ <p>Cette directive n'a d'effet sur les comparaisons effectuées au
+ cours des traitements de groupe imbriqués, et lorsque la directive
+ <code class="directive"><a href="#authldapcompareasuser">AuthLDAPCompareAsUser</a></code>
+ est aussi activée.</p>
+
+ <p>Cette directive ne doit être utilisée que si votre serveur LDAP
+ n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
+ utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
+ </p>
- <p> This directive should only be used when your LDAP server doesn't
- accept anonymous searches and you cannot use a dedicated
- <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>.
- </p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authldapsubgroupattribute" id="authldapsubgroupattribute">Directive</a> <a name="AuthLDAPSubGroupAttribute" id="AuthLDAPSubGroupAttribute">AuthLDAPSubGroupAttribute</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the attribute labels, one value per
-directive line, used to distinguish the members of the current group that
-are groups.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPSubGroupAttribute <em>attribute</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie les noms d'attribut, un par directive, utilisés
+pour différencier les membres du groupe courant qui sont eux-mêmes des
+groupes.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPSubGroupAttribute <em>attribut</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPSubgroupAttribute member uniquemember</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.0 du serveur HTTP
+Apache</td></tr>
</table>
- <p>An LDAP group object may contain members that are users and
- members that are groups (called nested or sub groups). The
- <code class="directive">AuthLDAPSubGroupAttribute</code> directive identifies the
- labels of group members and the <code class="directive"><a href="#authldapgroupattribute">AuthLDAPGroupAttribute</a></code>
- directive identifies the labels of the user members. Multiple
- attributes can be used by specifying this directive multiple times.
- If not specified, then <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> uses the
- <code>member</code> and <code>uniqueMember</code> attributes.</p>
+ <p>Un objet groupe LDAP peut contenir des membres qui sont des
+ utilisateurs et des membres qui sont eux-mêmes des groupes (appelés
+ sous-groupes ou groupes imbriqués). La directive
+ <code class="directive">AuthLDAPSubGroupAttribute</code> spécifie l'attribut utilisé
+ pour identifier les groupes, alors que la directive <code class="directive"><a href="#authldapgroupattribute">AuthLDAPGroupAttribute</a></code> spécifie
+ l'attribut utilisé pour identifier les utilisateurs. On peut spécifier
+ plusieurs attributs en répétant la directive plusieurs fois. Si elle n'est
+ pas définie, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> utilise les attributs
+ <code>member</code> et <code>uniqueMember</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="authldapsubgroupclass" id="authldapsubgroupclass">Directive</a> <a name="AuthLDAPSubGroupClass" id="AuthLDAPSubGroupClass">AuthLDAPSubGroupClass</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies which LDAP objectClass values identify directory
-objects that are groups during sub-group processing.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPSubGroupClass <em>LdapObjectClass</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie quelles valeurs d'objectClass LDAP identifient les
+objets de l'annuaire qui sont des groupes au cours du traitement des
+sous-groupes.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPSubGroupClass <em>ObjectClass-LDAP</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthLDAPSubGroupClass groupOfNames groupOfUniqueNames</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.0 du serveur HTTP
+Apache</td></tr>
</table>
- <p>An LDAP group object may contain members that are users and
- members that are groups (called nested or sub groups). The
+ <p>Un objet groupe LDAP peut contenir des membres qui sont des
+ utilisateurs et des membres qui sont eux-mêmes des groupes (appelés
+ sous-groupes ou groupes imbriqués). La directive
<code class="directive"><a href="#authldapsubgroupattribute">AuthLDAPSubGroupAttribute</a></code>
- directive identifies the
- labels of members that may be sub-groups of the current group
- (as opposed to user members). The <code class="directive">AuthLDAPSubGroupClass</code>
- directive specifies the LDAP objectClass values used in verifying that
- these potential sub-groups are in fact group objects. Verified sub-groups
- can then be searched for more user or sub-group members. Multiple
- attributes can be used by specifying this directive multiple times.
- If not specified, then <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> uses the
- <code>groupOfNames</code> and <code>groupOfUniqueNames</code> values.</p>
+ permet d'identifier les
+ membres qui sont des sous-groupes du groupe courant (à l'opposé des
+ membres utilisateurs). La directive
+ <code class="directive">AuthLDAPSubGroupClass</code> permet de spécifier les valeurs
+ d'objectClass LDAP utilisées pour vérifier que certains membres sont
+ en fait des objets groupe. Les sous-groupes ainsi identifiés peuvent
+ alors faire l'objet d'une recherche d'autres membres utilisateurs ou
+ sous-groupes. On peut spécifier plusieurs attributs en répétant
+ cette directive plusieurs fois. Si cette directive n'est pas
+ définie, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> utilise les attributs
+ <code>groupOfNames</code> et <code>groupOfUniqueNames</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="authldapurl" id="authldapurl">Directive</a> <a name="AuthLDAPUrl" id="AuthLDAPUrl">AuthLDAPUrl</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL specifying the LDAP search parameters</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL permettant de spécifier les paramètres de la
+recherche LDAP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthLDAPUrl <em>url [NONE|SSL|TLS|STARTTLS]</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr>
</table>
- <p>An RFC 2255 URL which specifies the LDAP search parameters
- to use. The syntax of the URL is</p>
-<div class="example"><p><code>ldap://host:port/basedn?attribute?scope?filter</code></p></div>
- <p>If you want to specify more than one LDAP URL that Apache should try in turn, the syntax is:</p>
+ <p>Une URL conforme à la RFC 2255 qui permet de spécifier les
+ paramètres à utiliser pour la recherche dans l'annuaire LDAP. La
+ syntaxe de l'URL est :</p>
+<div class="example"><p><code>ldap://hôte:port/DN-de-base?attribut?portée?filtre</code></p></div>
+ <p>Si vous souhaitez mettre à la disposition d'Apache plusieurs URLs
+ LDAP, la syntaxe sera :</p>
<pre class="prettyprint lang-config">AuthLDAPUrl "ldap://ldap1.example.com ldap2.example.com/dc=..."</pre>
-<p><em><strong>Caveat: </strong>If you specify multiple servers, you need to enclose the entire URL string in quotes;
-otherwise you will get an error: "AuthLDAPURL takes one argument, URL to define LDAP connection.." </em>
-You can of course use search parameters on each of these.</p>
+<p><em><strong>Mise en garde : </strong>Si vous spécifiez plusieurs
+serveurs, vous devez en entourer la liste avec des guillemets ; dans le
+cas contraire, vous générerez une erreur : "AuthLDAPURL takes one
+argument, URL to define LDAP connection..".</em> Vous pouvez bien
+entendu ajouter des paramètres de recherche à chacun des serveurs
+spécifiés.</p>
<dl>
<dt>ldap</dt>
- <dd>For regular ldap, use the
- string <code>ldap</code>. For secure LDAP, use <code>ldaps</code>
- instead. Secure LDAP is only available if Apache was linked
- to an LDAP library with SSL support.</dd>
+ <dd>Pour ldap non sécurisé, utilisez la chaîne
+ <code>ldap</code>. Pour ldap sécurisé, utilisez à la place la
+ chaîne <code>ldaps</code>. LDAP sécurisé n'est disponible que si
+ Apache a été lié avec une bibliothèque LDAP supportant SSL.</dd>
-<dt>host:port</dt>
+<dt>hôte:port</dt>
<dd>
- <p>The name/port of the ldap server (defaults to
- <code>localhost:389</code> for <code>ldap</code>, and
- <code>localhost:636</code> for <code>ldaps</code>). To
- specify multiple, redundant LDAP servers, just list all
- servers, separated by spaces. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>
- will try connecting to each server in turn, until it makes a
- successful connection. If multiple ldap servers are specified,
- then entire LDAP URL must be encapsulated in double quotes.</p>
-
- <p>Once a connection has been made to a server, that
- connection remains active for the life of the
- <code class="program"><a href="../programs/httpd.html">httpd</a></code> process, or until the LDAP server goes
- down.</p>
-
- <p>If the LDAP server goes down and breaks an existing
- connection, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> will attempt to
- re-connect, starting with the primary server, and trying
- each redundant server in turn. Note that this is different
- than a true round-robin search.</p>
+ <p>Il s'agit du nom/port du serveur ldap
+ (dont la valeur par défaut est
+ <code>localhost:389</code> pour <code>ldap</code>, et
+ <code>localhost:636</code> pour <code>ldaps</code>). Pour
+ spécifier plusieurs serveurs LDAP redondants, indiquez
+ simplement leur liste en les séparant par des espaces.
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tentera alors de se connecter
+ à chacun des serveurs jusqu'à ce qu'il parvienne à se
+ connecter avec succès. Notez qu'en cas de multiples serveurs
+ LDAP, l'ensemble de l'URL LDAP doit être entourée de
+ guillemets.</p>
+
+ <p>lorsqu'une connection a été établie avec un serveur, elle
+ reste active pendant toute la durée de vie du processus
+ <code class="program"><a href="../programs/httpd.html">httpd</a></code>, ou jusqu'à ce que le serveur LDAP
+ cesse de fonctionner.</p>
+
+ <p>Si le serveur LDAP cesse de fonctionner, et ainsi
+ interrompt une
+ connexion existante, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tentera
+ de se reconnecter en commençant par le premier serveur de la
+ liste, et ainsi de suite avec les serveurs redondants
+ suivants. Notez que ce processus n'a rien à voir avec une
+ véritable recherche de type round-robin.</p>
</dd>
-<dt>basedn</dt>
-
- <dd>The DN of the branch of the
- directory where all searches should start from. At the very
- least, this must be the top of your directory tree, but
- could also specify a subtree in the directory.</dd>
-
-<dt>attribute</dt>
-
- <dd>The attribute to search for.
- Although RFC 2255 allows a comma-separated list of
- attributes, only the first attribute will be used, no
- matter how many are provided. If no attributes are
- provided, the default is to use <code>uid</code>. It's a good
- idea to choose an attribute that will be unique across all
- entries in the subtree you will be using. All attributes
- listed will be put into the environment with an AUTHENTICATE_ prefix
- for use by other modules.</dd>
-
-<dt>scope</dt>
-
- <dd>The scope of the search. Can be either <code>one</code> or
- <code>sub</code>. Note that a scope of <code>base</code> is
- also supported by RFC 2255, but is not supported by this
- module. If the scope is not provided, or if <code>base</code> scope
- is specified, the default is to use a scope of
- <code>sub</code>.</dd>
-
-<dt>filter</dt>
-
- <dd>A valid LDAP search filter. If
- not provided, defaults to <code>(objectClass=*)</code>, which
- will search for all objects in the tree. Filters are
- limited to approximately 8000 characters (the definition of
- <code>MAX_STRING_LEN</code> in the Apache source code). This
- should be more than sufficient for any application. In 2.4.10 and later,
- the keyword <code>none</code> disables the use of a filter; this is
- required by some primitive LDAP servers.</dd>
+<dt>DN-de-base</dt>
+ <dd>Le DN de la branche de l'annuaire à partir de laquelle
+ toutes les recherches seront lancées. Il doit au moins
+ correspondre à la racine de votre annuaire, mais vous pouvez
+ aussi indiquer une branche plus spécifique.</dd>
+
+<dt>attribut</dt>
+
+ <dd>Il s'agit de l'attribut à utiliser pour la recherche.
+ Bien que la RFC
+ 2255 autorise une liste d'attributs séparés par des virgules,
+ seul le premier sera retenu, sans tenir compte des autres
+ attributs fournis. Si aucun attribut n'est fourni, l'attribut
+ par défaut est <code>uid</code>. Il est judicieux de choisir un
+ attribut dont la valeur sera unique parmi toutes les entrées de
+ la branche de l'annuaire que vous aurez définie. Tous les
+ attributs spécifiés seront enregistrés dans des variables
+ d'environnement avec le préfixe AUTHENTICATE_, afin de pouvoir
+ être utilisés par d'autres modules.</dd>
+
+<dt>portée</dt>
+
+ <dd>Il s'agit de la portée de la recherche. Elle peut prendre
+ les valeurs <code>one</code> ou <code>sub</code>. Notez que la
+ RFC 2255 supporte aussi une portée de valeur <code>base</code>,
+ mais cette dernière n'est pas supportée par le module. Si la
+ portée n'est pas définie, ou si elle est définie à
+ <code>base</code>, c'est la valeur de portée par défaut
+ <code>sub</code> qui sera utilisée.</dd>
+
+<dt>filtre</dt>
+
+ <dd>Il s'agit d'un filtre de recherche LDAP valide. Si aucun
+ filtre n'est spécifié, le filtre par défaut
+ <code>(objectClass=*)</code> sera utilisé, ce qui corrspond à
+ une recherche de tous les types d'objets de l'arborescence. La
+ taille des filtres est limitée à environ 8000 caractères (valeur
+ de la macro <code>MAX_STRING_LEN</code> dans le code source
+ d'Apache), ce qui s'avère plus que suffisant pour la plupart des
+ applications. A partir de la version 2.4.10 du serveur HTTP Apache, le
+ mot-clé <code>none</code> permet de désactiver
+ l'utilisation des filtres, ce qui peut s'avérer nécessaire avec
+ certains serveurs LDAP primitifs.</dd>
</dl>
- <p>When doing searches, the attribute, filter and username passed
- by the HTTP client are combined to create a search filter that
- looks like
- <code>(&(<em>filter</em>)(<em>attribute</em>=<em>username</em>))</code>.</p>
+ <p>Pour une recherche, les attribut, filtre et nom d'utilisateur
+ fournis par le client HTTP sont combinés pour créer un filtre de
+ recherche du style :
+ <code>(&(<em>filtre</em>)(<em>attribut</em>
+ =<em>nom-utilisateur</em>))</code>.</p>
- <p>For example, consider an URL of
- <code>ldap://ldap.example.com/o=Example?cn?sub?(posixid=*)</code>. When
- a client attempts to connect using a username of <code>Babs
- Jenson</code>, the resulting search filter will be
- <code>(&(posixid=*)(cn=Babs Jenson))</code>.</p>
+ <p>Par exemple, considérons l'URL
+ <code>ldap://ldap.example.com/o=Example?cn?sub?(posixid=*)</code>.
+ Lorsqu'un client tentera de se connecter en utilisant le nom
+ d'utilisateur <code>Babs Jenson</code>, le filtre de recherche sera
+ : <code>(&(posixid=*)(cn=Babs Jenson))</code>.</p>
- <p>An optional parameter can be added to allow the LDAP Url to override
- the connection type. This parameter can be one of the following:</p>
+ <p>On peut encore ajouter un paramètre optionnel pour permettre à
+ l'URL LDAP de surcharger le type de connexion. Ce paramètre peut
+ prendre l'une des valeurs suivantes :</p>
<dl>
<dt>NONE</dt>
- <dd>Establish an unsecure connection on the default LDAP port. This
- is the same as <code>ldap://</code> on port 389.</dd>
+ <dd>Établit une connexion non sécurisée sur le port LDAP par
+ défaut, ce qui est équivalent à <code>ldap://</code> sur le port
+ 389.</dd>
<dt>SSL</dt>
- <dd>Establish a secure connection on the default secure LDAP port.
- This is the same as <code>ldaps://</code></dd>
+ <dd>Établit une connexion sécurisée sur le port LDAP sécurisé
+ par défaut, ce qui est équivalent à <code>ldaps://</code>.</dd>
<dt>TLS | STARTTLS</dt>
- <dd>Establish an upgraded secure connection on the default LDAP port.
- This connection will be initiated on port 389 by default and then
- upgraded to a secure connection on the same port.</dd>
+ <dd>Établit une connexion sécurisée par élévation de niveau sur
+ le port LDAP par défaut. Cette connexion sera initialisée sur le
+ port 389 par défaut, puis élevée à un niveau de connexion
+ sécurisée sur le même port.</dd>
</dl>
- <p>See above for examples of <code class="directive"><a href="#authldapurl">AuthLDAPUrl</a></code> URLs.</p>
+ <p>Voir plus haut pour des exemples d'URLs définies par la directive
+ <code class="directive"><a href="#authldapurl">AuthLDAPUrl</a></code>.</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="authmerging" id="authmerging">Directive</a> <a name="AuthMerging" id="AuthMerging">AuthMerging</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls the manner in which each configuration section's
-authorization logic is combined with that of preceding configuration
-sections.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont chaque logique d'autorisation des
+sections de configuration se combine avec celles des sections de
+configuration précédentes.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthMerging Off | And | Or</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthMerging 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p>When authorization is enabled, it is normally inherited by each
- subsequent <a href="../sections.html#merging">configuration section</a>,
- unless a different set of authorization directives is specified.
- This is the default action, which corresponds to an explicit setting
- of <code>AuthMerging Off</code>.</p>
-
- <p>However, there may be circumstances in which it is desirable
- for a configuration section's authorization to be combined with
- that of its predecessor while configuration sections are being
- merged. Two options are available for this case, <code>And</code>
- and <code>Or</code>.</p>
-
- <p>When a configuration section contains <code>AuthMerging And</code>
- or <code>AuthMerging Or</code>,
- its authorization logic is combined with that of the nearest
- predecessor (according to the overall order of configuration sections)
- which also contains authorization logic as if the two sections
- were jointly contained within a
- <code class="directive"><a href="#requireall"><RequireAll></a></code> or
- <code class="directive"><a href="#requireany"><RequireAny></a></code>
- directive, respectively.</p>
-
- <div class="note">The setting of <code class="directive">AuthMerging</code> is not
- inherited outside of the configuration section in which it appears.
- In the following example, only users belonging to group <code>alpha</code>
- may access <code>/www/docs</code>. Users belonging to either
- groups <code>alpha</code> or <code>beta</code> may access
- <code>/www/docs/ab</code>. However, the default <code>Off</code>
- setting of <code class="directive">AuthMerging</code> applies to the
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
- configuration section for <code>/www/docs/ab/gamma</code>, so
- that section's authorization directives override those of the
- preceding sections. Thus only users belong to the group
- <code>gamma</code> may access <code>/www/docs/ab/gamma</code>.</div>
+ <p>Lorsque l'autorisation est activée, elle est normalement héritée
+ par chaque <a href="../sections.html#merging">section de
+ configuration</a> suivante, à moins qu'un jeu de directives
+ d'autorisations différent ne soit spécifié. Il s'agit du
+ comportement par défaut, qui correspond à la définition explicite
+ <code>AuthMerging Off</code>.</p>
+
+ <p>Dans certaines situations cependant, il peut être souhaitable de
+ combiner la logique d'autorisation d'une section de configuration
+ avec celle de la section précédente lorsque les sections de
+ configuration se combinent entre elles. Dans ce cas, deux options
+ sont disponibles, <code>And</code> et <code>Or</code>.</p>
+
+ <p>Lorsqu'une section de configuration contient <code>AuthMerging
+ And</code> ou <code>AuthMerging Or</code>, sa logique d'autorisation
+ se combine avec celle de la section de configuration qui la précède
+ (selon l'ordre général des sections de configuration), et qui
+ contient aussi une logique d'autorisation, comme si les deux
+ sections étaient concaténées, respectivement, dans une directive
+ <code class="directive"><a href="#requireall"><RequireAll></a></code> ou <code class="directive"><a href="#requireany"><RequireAny></a></code>.</p>
+
+ <div class="note">La définition de la directive
+ <code class="directive">AuthMerging</code> ne concerne que la section de
+ configuration dans laquelle elle apparaît. Dans l'exemple suivant,
+ seuls les utilisateurs appartenant au groupe <code>alpha</code> sont
+ autorisés à accéder à <code>/www/docs</code>. Les utilisateurs
+ appartenant au groupe <code>alpha</code> ou au groupe
+ <code>beta</code> sont autorisés à accéder à
+ <code>/www/docs/ab</code>. Cependant, la définition implicite à
+ <code>Off</code> de la directive <code class="directive">AuthMerging</code>
+ s'applique à la section de configuration <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> concernant le répertoire
+ <code>/www/docs/ab/gamma</code>, ce qui implique que les directives
+ d'autorisation de cette section l'emportent sur celles des sections
+ précédentes. Par voie de conséquence, seuls les utilisateurs
+ appartenant au groupe <code>gamma</code> sont autorisés à accéder à
+ <code>/www/docs/ab/gamma</code>.</div>
<pre class="prettyprint lang-config"><Directory "/www/docs">
AuthType Basic
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authzprovideralias" id="authzprovideralias">Directive</a> <a name="AuthzProviderAlias" id="AuthzProviderAlias"><AuthzProviderAlias></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
-extension of a base authorization provider and referenced by the specified
-alias</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthzProviderAlias <var>baseProvider Alias Require-Parameters</var>>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives représentant une extension d'un
+fournisseur d'autorisation de base qui pourra être référencée à l'aide
+de l'alias spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthzProviderAlias <var>fournisseur-de-base Alias
+Paramètres-Require</var>>
... </AuthzProviderAlias>
</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p><code class="directive"><AuthzProviderAlias></code> and
- <code></AuthzProviderAlias></code> are used to enclose a group of
- authorization directives that can be referenced by the alias name using the
- directive <code class="directive"><a href="#require">Require</a></code>.</p>
+ <p>Les balises <code class="directive"><AuthzProviderAlias></code> et
+ <code></AuthzProviderAlias></code> permettent de regrouper des
+ directives d'autorisation auxquelles on pourra faire référence à
+
l'aide de l'alias spécifié dans une directive <code class="directive"><a href="#require">Require</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="authzsendforbiddenonfailure" id="authzsendforbiddenonfailure">Directive</a> <a name="AuthzSendForbiddenOnFailure" id="AuthzSendForbiddenOnFailure">AuthzSendForbiddenOnFailure</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if
-authentication succeeds but authorization fails
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si
+l'authentification réussit et si l'autorisation a été refusée.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzSendForbiddenOnFailure On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthzSendForbiddenOnFailure Off</code></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTPD 2.3.11 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.11 d'Apache HTTPD</td></tr>
</table>
- <p>If authentication succeeds but authorization fails, Apache HTTPD will
- respond with an HTTP response code of '401 UNAUTHORIZED' by default. This
- usually causes browsers to display the password dialogue to the user
- again, which is not wanted in all situations.
- <code class="directive">AuthzSendForbiddenOnFailure</code> allows to change the
- response code to '403 FORBIDDEN'.</p>
-
- <div class="warning"><h3>Security Warning</h3>
- <p>Modifying the response in case of missing authorization weakens the
- security of the password, because it reveals to a possible attacker, that
- his guessed password was right.</p>
+ <p>Par défaut, si l'authentification réussit, alors que
+ l'autorisation est refusée, Apache HTTPD renvoie un code de réponse
+ HTTP '401 UNAUTHORIZED'. En général, les navigateurs proposent alors
+ une nouvelle fois à l'utilisateur la boîte de dialogue de saisie du
+ mot de passe, ce qui n'est pas toujours souhaitable. La directive
+ <code class="directive">AuthzSendForbiddenOnFailure</code> permet de changer
+ le code de réponse en '403 FORBIDDEN'.</p>
+
+ <div class="warning"><h3>Avertissement de sécurité</h3>
+ <p>La modification de la réponse en cas de refus d'autorisation
+ diminue la sécurité du mot de passe, car elle indique à un éventuel
+ attaquant que le mot de passe qu'il a saisi était correct.</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="require" id="require">Directive</a> <a name="Require" id="Require">Require</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tests whether an authenticated user is authorized by
-an authorization provider.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Require [not] <var>entity-name</var>
- [<var>entity-name</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie si un utilisateur authentifié a une
+autorisation d'accès accordée par un fournisseur
+d'autorisation.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Require [not] <var>nom-entité</var> [<var>nom-entité</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p>This directive tests whether an authenticated user is authorized
- according to a particular authorization provider and the specified
- restrictions. <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> provides the following
- generic authorization providers:</p>
+ <p>Cette directive permet de vérifier si un utilisateur authentifié
+ a l'autorisation d'accès accordée pour un certain fournisseur
+ d'autorisation et en tenant compte de certaines restrictions.
+ <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> met à disposition les fournisseurs
+ d'autorisation génériques suivants :</p>
<dl>
<dt><code>Require all granted</code></dt>
- <dd>Access is allowed unconditionally.</dd>
+ <dd>L'accès est autorisé sans restriction.</dd>
<dt><code>Require all denied</code></dt>
- <dd>Access is denied unconditionally.</dd>
+ <dd>L'accès est systématiquement refusé.</dd>
<dt><code>Require env <var>env-var</var> [<var>env-var</var>]
...</code></dt>
- <dd>Access is allowed only if one of the given environment variables is
- set.</dd>
+ <dd>L'accès n'est autorisé que si l'une au moins des variables
+ d'environnement spécifiées est définie.</dd>
<dt><code>Require method <var>http-method</var> [<var>http-method</var>]
...</code></dt>
- <dd>Access is allowed only for the given HTTP methods.</dd>
+ <dd>L'accès n'est autorisé que pour les méthodes HTTP spécifiées.</dd>
<dt><code>Require expr <var>expression</var> </code></dt>
- <dd>Access is allowed if <var>expression</var> evaluates to true.</dd>
+ <dd>L'accès est autorisé si <var>expression</var> est évalué à
+ vrai.</dd>
</dl>
- <p>Some of the allowed syntaxes provided by <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>,
- <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>,
- and <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> are:</p>
+ <p>Voici quelques exemples de syntaxes autorisées par
+ <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>, <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> et
+ <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> :</p>
<dl>
- <dt><code>Require user <var>userid</var> [<var>userid</var>]
+ <dt><code>Require user <var>identifiant utilisateur</var>
+ [<var>identifiant utilisateur</var>]
...</code></dt>
- <dd>Only the named users can access the resource.</dd>
+ <dd>Seuls les utilisateurs spécifiés auront accès à la
+ ressource.</dd>
- <dt><code>Require group <var>group-name</var> [<var>group-name</var>]
+ <dt><code>Require group <var>nom groupe</var> [<var>nom
+ groupe</var>]
...</code></dt>
- <dd>Only users in the named groups can access the resource.</dd>
+ <dd>Seuls les utilisateurs appartenant aux groupes spécifiés
+ auront accès à la ressource.</dd>
<dt><code>Require valid-user</code></dt>
- <dd>All valid users can access the resource.</dd>
+ <dd>Tous les utilisateurs valides auront accès à la
+ ressource.</dd>
<dt><code>Require ip 10 172.20 192.168.2</code></dt>
- <dd>Clients in the specified IP address ranges can access the
- resource.</dd>
+ <dd>Les clients dont les adresses IP font partie des tranches
+ spécifiées auront accès à la ressource.</dd>
</dl>
- <p>Other authorization modules that implement require options
- include <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>,
- <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code>,
- <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> and <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
-
- <p>In most cases, for a complete authentication and authorization
- configuration, <code class="directive">Require</code> must be accompanied by
- <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> and
- <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> or
- <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>
- directives, and directives such as
- <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
- and <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> (to
- define users and groups) in order to work correctly. Example:</p>
+ <p>D'autres modules d'autorisation comme
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>, <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>,
+ <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code>,
+ <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> et <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
+ implémentent des options de la directive Require.</p>
+
+ <p>Pour qu'une configuration d'authentification et d'autorisation
+ fonctionne correctement, la directive <code class="directive">Require</code>
+ doit être accompagnée dans la plupart des cas de directives <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> et <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>, ainsi que
+ de directives telles que <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> et <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> (pour la
+ définition des utilisateurs et des groupes). Exemple :</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Restricted Resource"
Require group admin</pre>
- <p>Access controls which are applied in this way are effective for
- <strong>all</strong> methods. <strong>This is what is normally
- desired.</strong> If you wish to apply access controls only to
- specific methods, while leaving other methods unprotected, then
- place the <code class="directive">Require</code> statement into a
- <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>
- section.</p>
+ <p>Les contrôles d'accès appliqués de cette manière sont effectifs
+ pour <strong>toutes</strong> les méthodes. <strong>C'est d'ailleurs
+ ce que l'on souhaite en général.</strong> Si vous voulez n'appliquer
+ les contrôles d'accès qu'à certaines méthodes, tout en laissant les
+ autres méthodes sans protection, placez la directive
+ <code class="directive">Require</code> dans une section <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p>
- <p>The result of the <code class="directive">Require</code> directive
- may be negated through the use of the
- <code>not</code> option. As with the other negated authorization
- directive <code class="directive"><RequireNone></code>,
- when the <code class="directive">Require</code> directive is negated it can
- only fail or return a neutral result, and therefore may never
- independently authorize a request.</p>
+ <p>Le résultat de la directive <code class="directive">Require</code> peut
+ être inversé en utilisant l'option <code>not</code>. Comme dans le
+ cas de l'autre directive d'autorisation inversée <code class="directive"><RequireNone></code>, si la directive
+ <code class="directive">Require</code> est inversée, elle ne peut qu'échouer
+ ou produire un résultat neutre ; elle ne peut donc alors pas
+ en soi autoriser une requête.</p>
- <p>In the following example, all users in the <code>alpha</code>
- and <code>beta</code> groups are authorized, except for those who
- are also in the <code>reject</code> group.</p>
+ <p>Dans l'exemple suivant, tous les utilisateurs appartenant aux
+ groupes <code>alpha</code> et <code>beta</code> ont l'autorisation
+ d'accès, à l'exception de ceux appartenant au groupe
+ <code>reject</code>.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs">
<RequireAll>
</Directory></pre>
- <p>When multiple <code class="directive">Require</code> directives are
- used in a single
- <a href="../sections.html#merging">configuration section</a>
- and are not contained in another authorization directive like
- <code class="directive"><a href="#requireall"><RequireAll></a></code>,
- they are implicitly contained within a
- <code class="directive"><a href="#requireany"><RequireAny></a></code>
- directive. Thus the first one to authorize a user authorizes the
- entire request, and subsequent <code class="directive">Require</code> directives
- are ignored.</p>
-
- <div class="warning"><h3>Security Warning</h3>
- <p>Exercise caution when setting authorization directives in
- <code class="directive"><a href="../mod/core.html#location">Location</a></code> sections
- that overlap with content served out of the filesystem.
- By default, these <a href="../sections.html#merging">configuration sections</a> overwrite authorization configuration
- in <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>,
- and <code class="directive"><a href="../mod/core.html#files">Files</a></code> sections.</p>
- <p>The <code class="directive"><a href="#authmerging">AuthMerging</a></code> directive
- can be used to control how authorization configuration sections are
- merged.</p>
+ <p>Lorsque plusieurs directives <code class="directive">Require</code> sont
+ placées dans une même <a href="../sections.html#merging">section de
+ configuration</a>, et ne se trouvent pas dans une autre directive
+ d'autorisation comme <code class="directive"><a href="#requireall"><RequireAll></a></code>, elles sont implicitement
+ contenues dans une directive <code class="directive"><a href="#requireany"><RequireAny></a></code>. Ainsi, la première directive
+ <code class="directive">Require</code> qui autorise l'accès à un utilisateur
+ autorise l'accès pour l'ensemble de la requête, et les directives
+ <code class="directive">Require</code> suivantes sont ignorées.</p>
+
+ <div class="warning"><h3>Avertissement à propos de la sécurité</h3>
+ <p>Prettez une attention particulière aux directives d'autorisation
+ définies
+ au sein des sections <code class="directive"><a href="../mod/core.html#location">Location</a></code>
+ qui se chevauchent avec des contenus servis depuis le système de
+ fichiers. Par défaut, les configurations définies dans ces <a href="../sections.html#merging">sections</a> l'emportent sur les
+ configurations d'autorisations définies au sein des sections
+ <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et <code class="directive"><a href="../mod/core.html#files">Files</a></code> sections.</p>
+ <p>La directive <code class="directive"><a href="#authmerging">AuthMerging</a></code> permet de contrôler
+ la manière selon laquelle les configurations d'autorisations sont
+ fusionnées au sein des sections précitées.</p>
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../howto/access.html">Access Control howto</a></li>
-<li><a href="#logic">Authorization Containers</a></li>
+<li><a href="../howto/access.html">Tutoriel du contrôle d'accès</a></li>
+<li><a href="#logic">Conteneurs d'autorisation</a></li>
<li><code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
</ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="requireall" id="requireall">Directive</a> <a name="RequireAll" id="RequireAll"><RequireAll></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which none
-must fail and at least one must succeed for the enclosing directive to
-succeed.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe plusieurs directives d'autorisation dont aucune ne
+doit échouer et dont au moins une doit retourner un résultat positif
+pour que la directive globale retourne elle-même un résultat
+positif.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAll> ... </RequireAll></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p><code class="directive"><RequireAll></code> and
- <code></RequireAll></code> are used to enclose a group of
- authorization directives of which none must fail and at least one
- must succeed in order for
- the <code class="directive"><RequireAll></code> directive to
- succeed.</p>
-
- <p>If none of the directives contained within the
- <code class="directive"><RequireAll></code> directive fails,
- and at least one succeeds, then the
- <code class="directive"><RequireAll></code> directive
- succeeds. If none succeed and none fail, then it returns a
- neutral result. In all other cases, it fails.</p>
+ <p>Les balises <code class="directive"><RequireAll></code> et
+ <code></RequireAll></code> permettent de regrouper des
+ directives d'autorisation dont aucune ne doit échouer, et dont au
+ moins une doit retourner un résultat positif pour que la directive
+ <code class="directive"><RequireAll></code> retourne elle-même
+ un résultat positif.</p>
+
+ <p>Si aucune des directives contenues dans la directive <code class="directive"><RequireAll></code> n'échoue, et si au moins une
+ retourne un résultat positif, alors la directive <code class="directive"><RequireAll></code> retourne elle-même un résultat
+ positif. Si aucune ne retourne un résultat positif, et si aucune
+ n'échoue, la directive globale retourne un résultat neutre. Dans
+ tous les autres cas, elle échoue.</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="#logic">Authorization Containers</a></li>
-<li><a href="../howto/auth.html">Authentication, Authorization,
- and Access Control</a></li>
+<li><a href="#logic">Conteneurs d'autorisation</a></li>
+<li><a href="../howto/auth.html">Authentification, autorisation et
+contrôle d'accès</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="requireany" id="requireany">Directive</a> <a name="RequireAny" id="RequireAny"><RequireAny></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which one
-must succeed for the enclosing directive to succeed.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont au moins une
+doit retourner un résultat positif pour que la directive globale
+retourne elle-même un résultat positif.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAny> ... </RequireAny></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p><code class="directive"><RequireAny></code> and
- <code></RequireAny></code> are used to enclose a group of
- authorization directives of which one must succeed in order for
- the <code class="directive"><RequireAny></code> directive to
- succeed.</p>
-
- <p>If one or more of the directives contained within the
- <code class="directive"><RequireAny></code> directive succeed,
- then the <code class="directive"><RequireAny></code> directive
- succeeds. If none succeed and none fail, then it returns a
- neutral result. In all other cases, it fails.</p>
-
- <div class="note">Because negated authorization directives are unable to
- return a successful result, they can not significantly influence
- the result of a <code class="directive"><RequireAny></code>
- directive. (At most they could cause the directive to fail in
- the case where they failed and all other directives returned a
- neutral value.) Therefore negated authorization directives
- are not permitted within a <code class="directive"><RequireAny></code>
- directive.</div>
+ <p>Les balises <code class="directive"><RequireAny></code> et
+ <code></RequireAny></code> permettent de regrouper des
+ directives d'autorisation dont au moins une doit retourner un
+ résultat positif pour que la directive <code class="directive"><RequireAny></code> retourne elle-même un résultat
+ positif.</p>
+
+ <p>Si une ou plusieurs directives contenues dans la directive
+ <code class="directive"><RequireAny></code> retournent un
+ résultat positif, alors la directive <code class="directive"><RequireAny></code> retourne elle-même un résultat
+ positif. Si aucune ne retourne un résultat positif et aucune
+ n'échoue, la directive globale retourne un résultat neutre. Dans
+ tous les autres cas, elle échoue.</p>
+
+ <div class="note">Comme les directives d'autorisation inversées sont incapables
+ de retourner un résultat positif, elles ne peuvent pas impacter de
+ manière significative le résultat d'une directive <code class="directive"><RequireAny></code> (elles pourraient tout au plus
+ faire échouer la directive dans le cas où elles échoueraient
+ elles-mêmes, et où
+ toutes les autres directives retourneraient un résultat neutre).
+ C'est pourquoi il n'est pas permis d'utiliser les directives
+ d'autorisation inversées dans une directive <code class="directive"><RequireAny></code>.</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="#logic">Authorization Containers</a></li>
-<li><a href="../howto/auth.html">Authentication, Authorization,
- and Access Control</a></li>
+<li><a href="#logic">Conteneurs d'autorisation</a></li>
+<li><a href="../howto/auth.html">Authentification, autorisation et
+contrôle d'accès</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="requirenone" id="requirenone">Directive</a> <a name="RequireNone" id="RequireNone"><RequireNone></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of authorization directives of which none
-must succeed for the enclosing directive to not fail.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont aucune ne doit
+retourner un résultat positif pour que la directive globale n'échoue
+pas.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireNone> ... </RequireNone></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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr>
</table>
- <p><code class="directive"><RequireNone></code> and
- <code></RequireNone></code> are used to enclose a group of
- authorization directives of which none must succeed
- in order for the
- <code class="directive"><RequireNone></code> directive to
- not fail.</p>
-
- <p>If one or more of the directives contained within the
- <code class="directive"><RequireNone></code> directive succeed,
- then the <code class="directive"><RequireNone></code> directive
- fails. In all other cases, it returns a neutral result. Thus as with
- the other negated authorization directive <code>Require not</code>,
- it can never independently
- authorize a request because it can never return a successful result.
- It can be used, however, to restrict the set of users who are
- authorized to access a resource.</p>
-
- <div class="note">Because negated authorization directives are unable to
- return a successful result, they can not significantly influence
- the result of a <code class="directive"><RequireNone></code>
- directive. Therefore negated authorization directives
- are not permitted within a
- <code class="directive"><RequireNone></code> directive.</div>
+ <p>Les balises <code class="directive"><RequireNone></code> et
+ <code></RequireNone></code> permettent de regrouper des
+ directives d'autorisation dont aucune ne doit retourner un résultat
+ positif pour que la directive <code class="directive"><RequireNone></code> n'échoue pas.</p>
+
+ <p>Si une ou plusieurs directives contenues dans la directive
+ <code class="directive"><RequireNone></code> retournent un
+ résultat positif, la directive <code class="directive"><RequireNone></code> échouera. Dans tous les
+ autres cas, cette dernière retournera un résultat neutre. Ainsi,
+ comme pour la directive d'autorisation inversée <code>Require
+ not</code>, elle ne peut jamais en soi autoriser une requête
+ car elle ne pourra jamais retourner un résultat
+ positif. Par contre, on peut l'utiliser pour restreindre l'ensemble
+ des utilisateurs autorisés à accéder à une ressource.</p>
+
+ <div class="note">Comme les directives d'autorisation inversées sont incapables
+ de retourner un résultat positif, elles ne peuvent pas impacter de
+ manière significative le résultat d'une directive <code class="directive"><RequireNone></code>.
+ C'est pourquoi il n'est pas permis d'utiliser les directives
+ d'autorisation inversées dans une directive <code class="directive"><RequireNone></code>.</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="#logic">Authorization Containers</a></li>
-<li><a href="../howto/auth.html">Authentication, Authorization,
- and Access Control</a></li>
+<li><a href="#logic">Conteneurs d'autorisation</a></li>
+<li><a href="../howto/auth.html">Authentification, autorisation et
+contrôle d'accès</a></li>
</ul>
</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="authzdbdlogintoreferer" id="authzdbdlogintoreferer">Directive</a> <a name="AuthzDBDLoginToReferer" id="AuthzDBDLoginToReferer">AuthzDBDLoginToReferer</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to redirect the Client to the Referring
-page on successful login or logout if a <code>Referer</code> request
-header is present</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si le client doit être redirigé vers la page
+d'origine en cas de connexion ou de déconnexion réussie si une en-tête
+de requête <code>Referer</code> est présente</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDLoginToReferer On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthzDBDLoginToReferer Off</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
</table>
- <p>In conjunction with <code>Require dbd-login</code> or
- <code>Require dbd-logout</code>, this provides the option to
- redirect the client back to the Referring page (the URL in
- the <code>Referer</code> HTTP request header, if present).
- When there is no <code>Referer</code> header,
- <code>AuthzDBDLoginToReferer On</code> will be ignored.</p>
+ <p>Utilisée en conjonction avec <code>Require dbd-login</code> ou
+ <code>Require dbd-logout</code>, cette directive permet de rediriger
+ le client vers la page d'origine (l'URL contenue dans l'en-tête
+ de requête HTTP <code>Referer</code>, s'il est présent). En
+ l'absence d'en-tête <code>Referer</code>, la définition
+ <code>AuthzDBDLoginToReferer On</code> sera ignoré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="authzdbdquery" id="authzdbdquery">Directive</a> <a name="AuthzDBDQuery" id="AuthzDBDQuery">AuthzDBDQuery</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the SQL Query for the required operation</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDQuery <var>query</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la requête SQL pour l'opération
+requise</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDQuery <var>requête</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
</table>
- <p>The <code class="directive">AuthzDBDQuery</code> specifies an SQL
- query to run. The purpose of the query depends on the
- <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive in
- effect.</p>
+ <p>La directive <code class="directive">AuthzDBDQuery</code> permet de
+ spécifier une requête SQL à exécuter. Le but de cette requête dépend
+ de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> en cours de
+ traitement.</p>
<ul>
- <li>When used with a <code>Require dbd-group</code> directive,
- it specifies a query to look up groups for the current user. This is
- the standard functionality of other authorization modules such as
- <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> and <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>.
- The first column value of each row returned by the query statement
- should be a string containing a group name. Zero, one, or more rows
- may be returned.
+ <li>Avec la directive <code>Require dbd-group</code>, elle spécifie
+ une requête permettant de rechercher les groupes d'appartenance de
+ l'utilisateur courant. Ceci correspond à la fonctionnalité standard
+ d'autres modules d'autorisation comme
+ <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> et
+ <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>.
+ La première colonne de chaque enregistrement renvoyé par la requête
+ doit contenir une chaîne de caractères correspondant à un nom de
+ groupe. La requête peut renvoyer zéro, un ou plusieurs
+ enregistrements.
<pre class="prettyprint lang-config">Require dbd-group
AuthzDBDQuery "SELECT group FROM groups WHERE user = %s"</pre>
</li>
- <li>When used with a <code>Require dbd-login</code> or
- <code>Require dbd-logout</code> directive, it will never deny access,
- but will instead execute a SQL statement designed to log the user
- in or out. The user must already be authenticated with
- <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.
+ <li>Avec la directive <code>Require dbd-login</code> ou
+ <code>Require dbd-logout</code>, elle ne refusera jamais l'accès,
+ mais au contraire exécutera une requête SQL permettant d'enregistrer
+ la connexion ou la déconnexion de l'utilisateur. Ce dernier doit
+
être déjà authentifié avec <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.
<pre class="prettyprint lang-config">Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"</pre>
</li>
</ul>
- <p>In all cases, the user's ID will be passed as a single string
- parameter when the SQL query is executed. It may be referenced within
- the query statement using a <code>%s</code> format specifier.</p>
+ <p>Dans tous les cas, l'identifiant utilisateur sera transmis comme
+ paramètre sous la forme d'une simple chaîne lorsque la requête SQL
+ sera exécutée. Il y sera fait référence dans la requête en utilisant
+ le spécificateur de format <code>%s</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="authzdbdredirectquery" id="authzdbdredirectquery">Directive</a> <a name="AuthzDBDRedirectQuery" id="AuthzDBDRedirectQuery">AuthzDBDRedirectQuery</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a query to look up a login page for the user</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDRedirectQuery <var>query</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une requête pour rechercher une page vers laquelle
+rediriger l'utilisateur après une connexion réussie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDRedirectQuery <var>requête</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
</table>
- <p>Specifies an optional SQL query to use after successful login
- (or logout) to redirect the user to a URL, which may be
- specific to the user. The user's ID will be passed as a single string
- parameter when the SQL query is executed. It may be referenced within
- the query statement using a <code>%s</code> format specifier.</p>
+ <p>Spécifie une requête SQL optionnelle à utiliser après une
+ connexion (ou une déconnexion) réussie pour rediriger l'utilisateur
+ vers une URL, qui peut être spécifique à l'utilisateur.
+ L'identifiant utilisateur sera transmis comme paramètre sous la
+ forme d'une simple chaîne lorsque la requête SQL sera exécutée. Il y
+ sera fait référence dans la requête en utilisant le spécificateur de
+ format <code>%s</code>.</p>
<pre class="prettyprint lang-config">AuthzDBDRedirectQuery "SELECT userpage FROM userpages WHERE user = %s"</pre>
- <p>The first column value of the first row returned by the query
- statement should be a string containing a URL to which to redirect
- the client. Subsequent rows will be ignored. If no rows are returned,
- the client will not be redirected.</p>
- <p>Note that <code class="directive">AuthzDBDLoginToReferer</code> takes
- precedence if both are set.</p>
+ <p>La première colonne du premier enregistrement renvoyé par la
+ requête doit contenir une chaîne de caractères correspondant à une
+ URL vers laquelle rediriger le client. Les enregistrements suivants
+ sont ignorés. Si aucun enregistrement n'est renvoyé, le client ne
+ sera pas redirigé.</p>
+ <p>Notez que <code class="directive">AuthzDBDLoginToReferer</code> l'emporte
+ sur cette directive si les deux sont définies.</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="authdbmgroupfile" id="authdbmgroupfile">Directive</a> <a name="AuthDBMGroupFile" id="AuthDBMGroupFile">AuthDBMGroupFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of the database file containing the list
-of user groups for authorization</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBMGroupFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom du fichier de base de données qui liste
+les groupes d'utilisateurs.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDBMGroupFile <var>chemin-fichier</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbm</td></tr>
</table>
- <p>The <code class="directive">AuthDBMGroupFile</code> directive sets the
- name of a DBM file containing the list of user groups for user
- authorization. <var>File-path</var> is the absolute path to the
- group file.</p>
-
- <p>The group file is keyed on the username. The value for a
- user is a comma-separated list of the groups to which the users
- belongs. There must be no whitespace within the value, and it
- must never contain any colons.</p>
-
- <div class="warning"><h3>Security</h3>
- <p>Make sure that the <code class="directive">AuthDBMGroupFile</code> is
- stored outside the document tree of the web-server. Do
- <strong>not</strong> put it in the directory that it protects.
- Otherwise, clients will be able to download the
- <code class="directive">AuthDBMGroupFile</code> unless otherwise
- protected.</p>
+ <p>La directive <code class="directive">AuthDBMGroupFile</code> définit
+ le nom d'un fichier DBM contenant la liste des groupes
+ d'utilisateurs, destinés à la gestion des autorisations.
+ <var>chemin-fichier</var> est le chemin absolu du
+ fichier de groupes.</p>
+
+ <p>La clé du fichier de groupes est le nom d'utilisateur. La valeur
+ de chaque clé est la liste des groupes, séparés par des virgules,
+ auxquels l'utilisateur appartient. Cette liste ne doit comporter
+ ni espace, ni caractère ':'.</p>
+
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Le fichier spécifié par la directive
+<code class="directive">AuthDBMGroupFile</code> doit être situé en dehors de
+l'arborescence des documents du serveur web. Ne le placez
+<strong>surtout pas</strong> dans le répertoire qu'il protège, faute
+de quoi, les clients pourraient le télécharger, en l'abscence de
+protection supplémentaire.</p>
</div>
- <p>Combining Group and Password DBM files: In some cases it is
- easier to manage a single database which contains both the
- password and group details for each user. This simplifies any
- support programs that need to be written: they now only have to
- deal with writing to and locking a single DBM file. This can be
- accomplished by first setting the group and password files to
- point to the same DBM:</p>
+ <p>Utilisation combinée de fichiers DBM de groupes et de mots de
+ passe : dans certains cas, il est plus simple de gérer une seule
+ base de données contenant les groupes et mots de passe de chaque
+ utilisateur. L'écriture de programmes de support en est ainsi
+ simplifiée car ils n'ont plus qu'un seul fichier DBM à gérer et
+ à verrouiller. Pour ce faire, on attribue le même nom de fichier
+ DBM aux fichiers de groupes et de mots de passe :</p>
<pre class="prettyprint lang-config">AuthDBMGroupFile "/www/userbase"
AuthDBMUserFile "/www/userbase"</pre>
- <p>The key for the single DBM is the username. The value consists
- of</p>
+ <p>La clé du fichier DBM unique est le nom d'utilisateur. La
+ valeur associée à la clé contient :</p>
<div class="example"><p><code>
- Encrypted Password : List of Groups [ : (ignored) ]
+ Mot de passe chiffré : Liste de groupes [ : (ignoré) ]
</code></p></div>
- <p>The password section contains the encrypted
- password as before. This is followed by a colon and the comma
- separated list of groups. Other data may optionally be left in the
- DBM file after another colon; it is ignored by the authorization
- module.</p>
+ <p>La partie mot de passe contient comme d'habitude le mot de
+ passe chiffré. Viennent ensuite le caractère ':' et la liste des
+ groupes séparés par des virgules. Il est possible d'ajouter
+ d'autres données en fin de ligne après un autre caractère ':',
+ mais elles seront ignorées par le module d'autorisation.</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="authzdbmtype" id="authzdbmtype">Directive</a> <a name="AuthzDBMType" id="AuthzDBMType">AuthzDBMType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the type of database file that is used to
-store list of user groups</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le type de fichier de base de données contenant
+la liste des groupes d'utilisateurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBMType default|SDBM|GDBM|NDBM|DB</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthzDBMType default</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbm</td></tr>
</table>
- <p>Sets the type of database file that is used to store the list
- of user groups.
- The default database type is determined at compile time. The
- availability of other types of database files also depends on
- <a href="../install.html#dbm">compile-time settings</a>.</p>
-
- <p>It is crucial that whatever program you use to create your group
- files is configured to use the same type of database.</p>
+ <p>Définit le type de fichier de base de données contenant la
+ liste des groupes d'utilisateurs. Le type de base de données par
+ défaut est déterminé à la compilation. Les autres types de bases
+ de données disponibles dépendent aussi de la
+ <a href="../install.html#dbm">configuration de la
+ compilation</a>.</p>
+
+ <p>Quel que soit le programme que vous utilisez pour créer votre
+ fichier de groupes, il est impératif que celui-ci soit configuré
+ pour utiliser le même type de base de données.</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="authgroupfile" id="authgroupfile">Directive</a> <a name="AuthGroupFile" id="AuthGroupFile">AuthGroupFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a text file containing the list
-of user groups for authorization</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthGroupFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom d'un fichier texte contenant la liste des
+groupes d'utilisateurs permettant de définir les autorisations des
+utilisateurs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthGroupFile <var>chemin-fichier</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_groupfile</td></tr>
</table>
- <p>The <code class="directive">AuthGroupFile</code> directive sets the
- name of a textual file containing the list of user groups for user
- authorization. <var>File-path</var> is the path to the group
- file. If it is not absolute, it is treated as relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
-
- <p>Each line of the group file contains a groupname followed by a
- colon, followed by the member usernames separated by spaces.</p>
-
- <div class="example"><h3>Example:</h3><p><code>
- mygroup: bob joe anne
+ <p>La directive <code class="directive">AuthGroupFile</code> définit
+le nom d'un fichier texte, qui liste les groupes d'utilisateurs
+permettant de définir les autorisations.
+<var>chemin-fichier</var> est le chemin du fichier de groupes. S'il n'est
+pas absolu, ce chemin est considéré comme relatif au répertoire défini par
+la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
+
+ <p>Chaque ligne du fichier de groupes contient un nom de groupe
+suivi du caractère ':' et des noms des utilisateurs membres du groupe
+séparés par des espaces.</p>
+
+ <div class="example"><h3>Exemple :</h3><p><code>
+ mon-groupe : bob joe anne
</code></p></div>
- <p>Note that searching large text files is <em>very</em>
- inefficient; <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> provides a much better performance.</p>
+ <p>Notez que la recherche dans de grands fichiers textes est
+<em>très</em> inefficace ; la directive <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> fournit de bien meilleures
+ performances.</p>
- <div class="warning"><h3>Security</h3>
- <p>Make sure that the <code class="directive">AuthGroupFile</code> is
- stored outside the document tree of the web-server; do <em>not</em>
- put it in the directory that it protects. Otherwise, clients may
- be able to download the <code class="directive">AuthGroupFile</code>.</p>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Le fichier <code class="directive">AuthGroupFile</code> ne doit pas
+être stocké dans l'arborescence des documents du site web ; ne le placez
+<em>surtout pas</em> dans le répertoire qu'il protège, faute de quoi les
+clients pourraient le télécharger.</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="addalt" id="addalt">Directive</a> <a name="AddAlt" id="AddAlt">AddAlt</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file, instead of an
-icon selected by filename</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAlt <var>string</var> <var>file</var> [<var>file</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son nom</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAlt <var>texte</var> <var>fichier</var> [<var>fichier</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p><code class="directive">AddAlt</code> provides the alternate text to
- display for a file, instead of an icon, for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>File</var> is a file extension, partial filename, wild-card
- expression or full filename for files to describe.
- If <var>String</var> contains any whitespace, you have to enclose it
- in quotes (<code>"</code> or <code>'</code>). This alternate text
- is displayed if the client is image-incapable, has image loading
- disabled, or fails to retrieve the icon.</p>
+ <p>La directive <code class="directive">AddAlt</code> permet d'afficher un
+ texte optionnel pour un fichier, à la place d'un icône, dans le cas
+ d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>fichier</var> est une extension de fichier, un nom de fichier
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le(s) fichier(s)
+ concerné(s). Si <var>texte</var> contient des espaces, vous devez
+ l'entourer de guillemets ou d'apostrophes (<code>"</code> ou
+ <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
<pre class="prettyprint lang-config">AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addaltbyencoding" id="addaltbyencoding">Directive</a> <a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file instead of an icon
-selected by MIME-encoding</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByEncoding <var>string</var> <var>MIME-encoding</var>
-[<var>MIME-encoding</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son codage MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByEncoding <var>texte</var> <var>codage MIME</var>
+[<var>codage MIME</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p><code class="directive">AddAltByEncoding</code> provides the alternate
- text to display for a file, instead of an icon, for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>MIME-encoding</var> is a valid content-encoding, such as
- <code>x-compress</code>. If <var>String</var> contains any whitespace,
- you have to enclose it in quotes (<code>"</code> or <code>'</code>).
- This alternate text is displayed if the client is image-incapable,
- has image loading disabled, or fails to retrieve the icon.</p>
+ <p>La directive <code class="directive">AddAltByEncoding</code> permet
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
+ dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>codage MIME</var> doit être un type valide, comme
+ <code>x-compress</code>. Si <var>texte</var> contient des espaces,
+ vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
<pre class="prettyprint lang-config">AddAltByEncoding gzip x-gzip</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addaltbytype" id="addaltbytype">Directive</a> <a name="AddAltByType" id="AddAltByType">AddAltByType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Alternate text to display for a file, instead of an
-icon selected by MIME content-type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByType <var>string</var> <var>MIME-type</var>
-[<var>MIME-type</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son type MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByType <var>texte</var> <var>type MIME</var>
+[<var>type MIME</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p><code class="directive">AddAltByType</code> sets the alternate text to
- display for a file, instead of an icon, for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>MIME-type</var> is a valid content-type, such as
- <code>text/html</code>. If <var>String</var> contains any whitespace,
- you have to enclose it in quotes (<code>"</code> or <code>'</code>).
- This alternate text is displayed if the client is image-incapable,
- has image loading disabled, or fails to retrieve the icon.</p>
+ <p>La directive <code class="directive">AddAltByType</code> permet
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
+ dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>type MIME</var> doit être un type MIME valide, comme
+ <code>text/html</code>. Si <var>texte</var> contient des espaces,
+ vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
- <pre class="prettyprint lang-config">AddAltByType 'plain text' text/plain</pre>
+ <pre class="prettyprint lang-config">AddAltByType 'Fichier texte' text/plain</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="adddescription" id="adddescription">Directive</a> <a name="AddDescription" id="AddDescription">AddDescription</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Description to display for a file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDescription <var>string file</var> [<var>file</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Afficher la description d'un fichier</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDescription <var>texte</var> [<var>fichier</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>This sets the description to display for a file, for
- <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>File</var> is a file extension, partial filename, wild-card
- expression or full filename for files to describe.
- <var>String</var> is enclosed in double quotes (<code>"</code>).</p>
+ <p>Cette directive permet d'afficher une description pour un
+ fichier, dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>fichier</var> est une extension de fichier, un nom de fichier
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le fichier.
+ <var>texte</var> doit être entouré de guillemets
+ (<code>"</code>).</p>
<pre class="prettyprint lang-config">AddDescription "The planet Mars" mars.gif
AddDescription "My friend Marshall" friends/mars.gif</pre>
- <p>The typical, default description field is 23 bytes wide. 6
- more bytes are added by the <code><a href="#indexoptions.suppressicon">IndexOptions SuppressIcon</a></code> option, 7 bytes are
- added by the <code><a href="#indexoptions.suppresssize">IndexOptions SuppressSize</a></code> option, and 19 bytes are
- added by the <code><a href="#indexoptions.suppresslastmodified">IndexOptions SuppressLastModified</a></code> option.
- Therefore, the widest default the description column is ever
- assigned is 55 bytes.</p>
-
- <p>Since the <var>File</var> argument may be a partial file name,
- please remember that a too-short partial filename may match
- unintended files. For example, <code>le.html</code> will match the
- file <code>le.html</code> but will also match the file
- <code>example.html</code>. In the event that there may be ambiguity,
- use as complete a filename as you can, but keep in mind that the
- first match encountered will be used, and order your list of
- <code>AddDescription</code> directives accordingly.</p>
-
- <p>See the <a href="#indexoptions.descriptionwidth">DescriptionWidth</a> <code class="directive"><a href="#indexoptions">IndexOptions</a></code> keyword for details on overriding the size
- of this column, or allowing descriptions of unlimited length.</p>
-
- <div class="note"><h3>Caution</h3>
- <p>Descriptive text defined with <code class="directive">AddDescription</code>
- may contain HTML markup, such as tags and character entities. If the
- width of the description column should happen to truncate a tagged
- element (such as cutting off the end of a bolded phrase), the
- results may affect the rest of the directory listing.</p>
+ <p>La taille par défaut, habituelle du champ de description est de
+ 23 octets. L'option <code><a href="#indexoptions.suppressicon">IndexOptions SuppressIcon</a></code> ajoute 6 octets, l'option
+ <code><a href="#indexoptions.suppresssize">IndexOptions
+ SuppressSize</a></code> en ajoute 7 et l'option <code><a href="#indexoptions.suppresslastmodified">IndexOptions
+ SuppressLastModified</a></code> en ajoute 19. Ainsi, la plus grande
+ taille par défaut qui peut être assignée à la colonne description
+ est de 55 octets.</p>
+
+ <p>Comme l'argument <var>fichier</var> peut être un nom de fichier
+ partiel, vous devez garder à l'esprit qu'un nom de fichier partiel
+ trop court pourra correspondre à des fichiers non voulus. Par
+ exemple, <code>le.html</code> correspondra au fichier
+ <code>le.html</code>, mais aussi au fichier
+ <code>example.html</code>. En cas d'ambiguïté, utilisez un nom de
+ fichier aussi complet que possible, et ordonnez votre liste de
+ directives <code>AddDescription</code> en conséquence.</p>
+
+ <p>Voir le mot-clé <a href="#indexoptions.descriptionwidth">DescriptionWidth</a> de la directive <code class="directive">module="mod_autoindex">IndexOptions</code> pour plus de
+ détails sur la manière d'augmenter la taille de cette colonne, ou
+ pour permettre des descriptions de taille illimitée.</p>
+
+ <div class="note"><h3>Avertissement</h3>
+ <p>Le texte descriptif défini par la directive
+ <code class="directive">AddDescription</code> peut contenir des marquages
+ HTML, comme des balises ou des entités caractères. Si la limite de
+ taille de la colonne description venait à tronquer une balise (par
+ exemple couper la fin d'une phrase en caractères gras), le
+ résultat pourrait en affecter toute la suite du listing du
+ répertoire.</p>
</div>
- <div class="note"><h3>Arguments with path information</h3>
- <p>Absolute paths are not currently supported and do not match
- anything at runtime. Arguments with relative path information,
- which would normally only be used in htaccess context, are implicitly
- prefixed with '*/' to avoid matching partial directory names.</p>
+ <div class="note"><h3>Arguments avec chemins</h3>
+ <p>Les chemins absolus ne sont actuellement pas supportés et ne
+ peuvent correspondre à aucun chemin réel à l'exécution. Les
+ arguments contenant des chemins relatifs, qui ne devraient être
+ normalement utilisés que dans les fichiers htaccess, sont
+ implicitement préfixés par '*/' afin d'éviter toute association
+ avec des noms de répertoires partiels.</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="addicon" id="addicon">Directive</a> <a name="AddIcon" id="AddIcon">AddIcon</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display for a file selected by name</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIcon <var>icon</var> <var>name</var> [<var>name</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher pour un fichier en fonction de son
+nom</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIcon <var>icône</var> <var>nom</var> [<var>nom</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>This sets the icon to display next to a file ending in
- <var>name</var> for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. <var>Icon</var> is either a (%-escaped)
- relative URL to the icon, a fully qualified remote URL, or of the format <code>
- (<var>alttext</var>,<var>url</var>)</code> where <var>alttext</var>
- is the text tag given for an icon for non-graphical browsers.</p>
-
- <p><var>Name</var> is either <code>^^DIRECTORY^^</code> for directories,
- <code>^^BLANKICON^^</code> for blank lines (to format the list
- correctly), a file extension, a wildcard expression, a partial
- filename or a complete filename.</p>
-
- <p><code>^^BLANKICON^^</code> is only used for formatting, and so
- is unnecessary if you're using <code>IndexOptions
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier dont le nom se termine par <var>nom</var>, dans le cas
+ d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL distante pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>nom</var> correspond à <code>^^DIRECTORY^^</code> pour les
+ répertoires, <code>^^BLANKICON^^</code> pour les lignes vides
+ (pour personnaliser la présentation du listing), une extension de
+ fichier, une expression avec caractères génériques, un nom de
+ fichier partiel ou un nom de fichier complet.</p>
+
+ <p><code>^^BLANKICON^^</code> n'est utilisé que pour le formatage,
+ et n'est donc pas nécessaire si vous utilisez <code>IndexOptions
HTMLTable</code>.</p>
<pre class="prettyprint lang-config">#Examples
AddIcon /icons/backup.png *~</pre>
- <p><code class="directive"><a href="#addiconbytype">AddIconByType</a></code>
- should be used in preference to <code class="directive">AddIcon</code>,
- when possible.</p>
+ <p>Lorsque c'est possible, il est préférable d'utiliser <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> plutôt que
+ <code class="directive">AddIcon</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="addiconbyencoding" id="addiconbyencoding">Directive</a> <a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display next to files selected by MIME
-content-encoding</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByEncoding <var>icon</var> <var>MIME-encoding</var>
-[<var>MIME-encoding</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher à côté d'un fichier en fonction de son
+codage MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByEncoding <var>icône</var> <var>codage MIME</var>
+[<var>codage MIME</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>This sets the icon to display next to files with <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>Icon</var> is either a (%-escaped) relative URL to the icon,
- a fully qualified remote URL,
- or of the format <code>(<var>alttext</var>,<var>url</var>)</code>
- where <var>alttext</var> is the text tag given for an icon for
- non-graphical browsers.</p>
-
- <p><var>MIME-encoding</var> is a valid content-encoding, such as
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>codage MIME</var> doit être un codage valide, comme
<code>x-compress</code>.</p>
<pre class="prettyprint lang-config">AddIconByEncoding /icons/compress.png x-compress</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addiconbytype" id="addiconbytype">Directive</a> <a name="AddIconByType" id="AddIconByType">AddIconByType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display next to files selected by MIME
-content-type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByType <var>icon</var> <var>MIME-type</var>
-[<var>MIME-type</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher à côté d'un fichier en fonction de son
+type MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByType <var>icône</var> <var>type MIME</var>
+[<var>type MIME</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>This sets the icon to display next to files of type
- <var>MIME-type</var> for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>Icon</var> is either a (%-escaped) relative URL to the icon,
- a fully qualified remote URL,
- or of the format <code>(<var>alttext</var>,<var>url</var>)</code>
- where <var>alttext</var> is the text tag given for an icon for
- non-graphical browsers.</p>
-
- <p><var>MIME-type</var> is a wildcard expression matching
- required the mime types.</p>
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier de type MIME <var>type MIME</var> dans le cas d'un
+ affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>type MIME</var> est une expression avec caractères
+ génériques représentant le type MIME.</p>
<pre class="prettyprint lang-config">AddIconByType (IMG,/icons/image.png) image/*</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="defaulticon" id="defaulticon">Directive</a> <a name="DefaultIcon" id="DefaultIcon">DefaultIcon</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icon to display for files when no specific icon is
-configured</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultIcon <var>url-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher par défaut lorsqu'aucun icône spécifique
+n'est précisé</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultIcon <var>chemin URL</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">DefaultIcon</code> directive sets the icon
- to display for files when no specific icon is known, for <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>Url-path</var> is a (%-escaped) relative URL to the icon,
- or a fully qualified remote URL.</p>
+ <p>La directive <code class="directive">DefaultIcon</code> permet de définir
+ l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique
+ n'a été précisé, dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>chemin URL</var> est une URL relative (échappée par des
+ caractères '%') vers l'icône ou une URL pleinement qualifiée.</p>
<pre class="prettyprint lang-config">DefaultIcon /icon/unknown.png</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="headername" id="headername">Directive</a> <a name="HeaderName" id="HeaderName">HeaderName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the file that will be inserted at the top
-of the index listing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeaderName <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier qui sera inséré au début de la page
+contenant l'index</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeaderName <var>nom fichier</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">HeaderName</code> directive sets the name
- of the file that will be inserted at the top of the index
- listing. <var>Filename</var> is the name of the file to include.</p>
+ <p>La directive <code class="directive">HeaderName</code> permet de définir
+ le nom du fichier qui sera inséré au début de la page contenant
+ l'index. <var>nom fichier</var> est le nom du fichier à inclure.</p>
<pre class="prettyprint lang-config">HeaderName HEADER.html</pre>
<div class="note">
- <p>Both HeaderName and <code class="directive"><a href="#readmename">ReadmeName</a></code> now treat
- <var>Filename</var> as a URI path relative to the one used to
- access the directory being indexed. If <var>Filename</var> begins
- with a slash, it will be taken to be relative to the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.</p>
+ <p>Les deux directives HeaderName et <code class="directive"><a href="#readmename">ReadmeName</a></code> traitent maintenant
+ <var>nom fichier</var> comme un chemin URI relatif au chemin
+ utilisé pour accéder au répertoire faisant l'objet de l'index. Si
+ <var>nom fichier</var> commence par un slash '/', il sera
+ considéré comme relatif au répertoire défini par la directive
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.</p>
<pre class="prettyprint lang-config">HeaderName /include/HEADER.html</pre>
- <p><var>Filename</var> must resolve to a document with a major
- content type of <code>text/*</code> (<em>e.g.</em>,
- <code>text/html</code>, <code>text/plain</code>, etc.). This means
- that <var>filename</var> may refer to a CGI script if the script's
- actual file type (as opposed to its output) is marked as
- <code>text/html</code> such as with a directive like:</p>
+ <p><var>nom fichier</var> doit correspondre à un document dont le
+ type MIME est du style <code>text/*</code> (<em>par exemple</em>
+ <code>text/html</code>, <code>text/plain</code>, etc...). Cela
+ signifie que <var>nom fichier</var> peut faire référence à un
+ script CGI si le véritable type MIME du script (et non celui de sa
+ sortie) est marqué comme <code>text/html</code> par exemple à
+ l'aide d'une directive comme :</p>
<pre class="prettyprint lang-config">AddType text/html .cgi</pre>
- <p><a href="../content-negotiation.html">Content negotiation</a>
- will be performed if <code class="directive"><a href="../mod/core.html#options">Options</a></code>
- <code>MultiViews</code> is in effect. If <var>filename</var> resolves
- to a static <code>text/html</code> document (not a CGI script) and
- either one of the <code class="directive"><a href="../mod/core.html#options">options</a></code>
- <code>Includes</code> or <code>IncludesNOEXEC</code> is enabled,
- the file will be processed for server-side includes (see the
- <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> documentation).</p>
+ <p>Une <a href="../content-negotiation.html">négociation de
+ contenu</a> sera effectuée si <code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>MultiViews</code> a été
+ précisé. Si <var>nom fichier</var> correspond à un document
+ statique <code>text/html</code> (et non à un script CGI), et une
+ des deux <code class="directive"><a href="../mod/core.html#options">options</a></code>
+ <code>Includes</code> ou <code>IncludesNOEXEC</code> est activée,
+ le fichier sera traité en tant qu'inclusion côté serveur (Server
+ Side Include) (voir la documentation de
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>).</p>
</div>
- <p>If the file specified by <code class="directive">HeaderName</code> contains
- the beginnings of an HTML document (<html>, <head>, etc.)
- then you will probably want to set <a href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
- +SuppressHTMLPreamble</code></a>, so that these tags are not
- repeated.</p>
+ <p>Si le fichier spécifié par la directive
+ <code class="directive">HeaderName</code> contient les en-têtes d'un
+ document HTML ((<html>, <head>, etc...), vous serez
+ probablement amené à définir <a href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
+ +SuppressHTMLPreamble</code></a>, de manière à ce que ces balises ne
+ soient pas répétées.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="indexheadinsert" id="indexheadinsert">Directive</a> <a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inserts text in the HEAD section of an index page.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexHeadInsert <var>"markup ..."</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Insère du texte dans la section HEAD de la page
+d'index.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexHeadInsert <var>"marque ..."</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">IndexHeadInsert</code> directive specifies a
- string to insert in the <var><head></var> section of the HTML
- generated for the index page.</p>
+ <p>La directive <code class="directive">IndexHeadInsert</code> permet de
+ spécifier une chaîne de caractères à insérer dans la section
+ <var><head></var> du code HTML généré pour la page
+ d'index.</p>
<pre class="prettyprint lang-config">IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="indexignore" id="indexignore">Directive</a> <a name="IndexIgnore" id="IndexIgnore">IndexIgnore</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds to the list of files to hide when listing
-a directory</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnore <var>file</var> [<var>file</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajouts à la liste des fichiers à cacher lors de l'affichage
+de l'index d'un répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnore <var>fichier</var> [<var>fichier</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IndexIgnore "."</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">IndexIgnore</code> directive adds to the
- list of files to hide when listing a directory. <var>File</var> is a
- shell-style wildcard expression or full
- filename. Multiple IndexIgnore directives add
- to the list, rather than replacing the list of ignored
- files. By default, the list contains <code>.</code> (the current
- directory).</p>
+ <p>La directive <code class="directive">IndexIgnore</code> permet
+ d'effectuer des ajouts à la liste des fichiers à cacher lors de
+ l'affichage de l'index d'un répertoire. <var>fichier</var> est une
+ expression avec caractères génériques de style shell ou un nom de
+ fichier complet. Plusieurs directives IndexIgnore effectuent des
+ ajouts à la liste, et ne remplacent pas la liste des fichiers à
+ ignorer. Par défaut, la liste contient <code>.</code> (le répertoire
+ courant).</p>
<pre class="prettyprint lang-config">IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t</pre>
- <div class="note"><h3>Regular Expressions</h3>
- <p>This directive does not currently work in configuration sections
- that have regular expression arguments, such as <code class="directive"><a href="../mod/core.html#directorymatch"><DirectoryMatch></a></code>
- </p>
+ <div class="note"><h3>Expressions rationnelles</h3>
+ <p>Cette directive est actuellement incompatible avec les sections
+ de configuration qui comportent des arguments avec expressions
+ rationnelles comme <code class="directive"><a href="../mod/core.html#directorymatch"><DirectoryMatch></a></code></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="indexignorereset" id="indexignorereset">Directive</a> <a name="IndexIgnoreReset" id="IndexIgnoreReset">IndexIgnoreReset</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Empties the list of files to hide when listing
-a directory</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vide la liste des fichiers à cacher lors de l'affichage du
+contenu d'un répertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnoreReset ON|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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.3.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.3.10 et supérieures</td></tr>
</table>
- <p>The <code class="directive">IndexIgnoreReset</code> directive removes
- any files ignored by <code class="directive">IndexIgnore</code> otherwise
- inherited from other configuration sections. </p>
+ <p>La directive <code class="directive">IndexIgnoreReset</code> supprime
+ toute liste de fichiers définie par la directive
+ <code class="directive">IndexIgnore</code> et héritée par ailleurs d'autres
+ sections de configuration.</p>
<pre class="prettyprint lang-config"><Directory "/var/www">
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Directory></pre>
- <div class="warning"><p> Review the default configuration for a list of
- patterns that you might want to explicitly ignore after using this
- directive.</p></div>
+ <div class="warning"><p>Revoyez la configuration par défaut pour une
+ liste de modèles que vous voulez ignorer explicitement après usage
+ de cette directive.</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="indexoptions" id="indexoptions">Directive</a> <a name="IndexOptions" id="IndexOptions">IndexOptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Various configuration settings for directory
-indexing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Diverses options de configuration pour l'indexation d'un
+répertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>]
...</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>By default, no options are enabled.</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Par défaut, aucune option n'est activée.</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">IndexOptions</code> directive specifies the
- behavior of the directory indexing. <var>Option</var> can be one
- of</p>
+ <p>La directive <code class="directive">IndexOptions</code> permet de
+ spécifier les options de configuration de l'indexation du
+ répertoire. <var>option</var> peut prendre l'une des valeurs
+ suivantes :</p>
<dl>
<dt><a name="indexoptions.addaltclass" id="indexoptions.addaltclass">AddAltClass</a></dt>
- <dd>Adds an additional CSS class declaration to each row of the
- directory listing table when <code>IndexOptions HTMLTable</code>
- is in effect and an <code>IndexStyleSheet</code> is defined.
- Rather than the standard <code>even</code> and <code>odd</code>
- classes that would otherwise be applied to each row of the table,
- a class of <code>even-<em>ALT</em></code> or
- <code>odd-<em>ALT</em></code> where <em>ALT</em> is either the
- standard alt text associated with the file style (eg. <em>snd</em>,
- <em>txt</em>, <em>img</em>, etc) or the alt text defined by one of
- the various <code>AddAlt*</code> directives.
+ <dd>Ajoute une déclaration de classe CSS supplémentaire à chaque
+ enregistrement de la table du listing du répertoire dans le cas où
+ <code>IndexOptions HTMLTable</code> est activé et où un
+ <code>IndexStyleSheet</code> a été défini. Plutôt que d'appliquer
+ à chaque enregistrement de la table les classes standards
+ <code>even</code> et <code>odd</code>, c'est ici une classe
+ <code>even-<em>ALT</em></code> ou <code>odd-<em>ALT</em></code>
+ qui sera appliquée, où <em>ALT</em> sera soit le texte alternatif
+ standard associé au style du fichier (par exemple <em>snd</em>,
+ <em>txt</em>, <em>img</em>, etc...), soit le texte alternatif
+ défini par une des différentes directives <code>AddAlt*</code>.
</dd>
- <dt><a name="indexoptions.charset" id="indexoptions.charset">Charset=<var>character-set</var></a> (<em>Apache HTTP Server 2.0.61 and
- later</em>)</dt>
- <dd>The <code>Charset</code> keyword allows you to
- specify the character set of the generated page. The
- default is <code>UTF-8</code> on Windows and Mac OS X,
- and <code>ISO-8859-1</code> elsewhere.
- (It depends on whether the underlying file system
- uses Unicode filenames or not.)
+ <dt><a name="indexoptions.charset" id="indexoptions.charset">Charset=<var>jeu de caractères</var></a> (<em>Versions 2.0.61 et
+ supérieures du serveur HTTP Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>Charset</code> vous permet de spécifier le
+ jeu de caractères de la page générée. La valeur par défaut est
+ <var>UTF-8</var> sous Windows et MAC OS X, et
+ <var>ISO-8859-1</var> dans les autres cas (en fait selon que le
+ système de fichiers sous-jacent utilise les noms de fichiers en
+ Unicode ou non).
<pre class="prettyprint lang-config">IndexOptions Charset=UTF-8</pre>
<dt><a name="indexoptions.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a></dt>
- <dd>The <code>DescriptionWidth</code> keyword allows you to
- specify the width of the description column in
- characters.</dd>
+ <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de
+ spécifier la taille en caractères de la colonne description.</dd>
- <dt><code>-DescriptionWidth</code> (or unset) allows
- <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> to calculate the best width.</dt>
+ <dt>Avec <code>-DescriptionWidth</code> (ou si l'option n'est pas
+ définie), <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> calcule la meilleure
+ taille.</dt>
- <dd><code>DescriptionWidth=<var>n</var></code> fixes the column width to
- <var>n</var> bytes wide.</dd>
+ <dd><code>DescriptionWidth=<var>n</var></code> fixe la taille de
+ la colonne à <var>n</var> octets.</dd>
- <dd><code>DescriptionWidth=*</code> grows the column to the
- width necessary to accommodate the longest description
- string.
+ <dd><code>DescriptionWidth=*</code> ajuste la taille de la colonne
+ à la plus longue chaîne de description.
- <strong>See the section on <code class="directive"><a href="#adddescription">AddDescription</a></code> for dangers
- inherent in truncating descriptions.</strong></dd>
+ <strong>Voir la section concernant <code class="directive"><a href="#adddescription">AddDescription</a></code> pour les dangers
+ inhérants à la troncature des descriptions.</strong></dd>
<dt><a name="indexoptions.fancyindexing" id="indexoptions.fancyindexing">FancyIndexing</a></dt>
- <dd>This turns on fancy indexing of directories.</dd>
+ <dd>Cette option active l'indexation "améliorée" des répertoires,
+ c'est à dire avec en-têtes de colonnes sous forme d'hyper-liens
+ auto-référants.</dd>
<dt><a name="indexoptions.foldersfirst" id="indexoptions.foldersfirst">FoldersFirst</a></dt>
- <dd>If this option is enabled, subdirectory listings will
- <em>always</em> appear first, followed by normal files in the
- directory. The listing is basically broken into two
- components, the files and the subdirectories, and each is
- sorted separately and then displayed subdirectories-first.
- For instance, if the sort order is descending by name, and
- <code>FoldersFirst</code> is enabled, subdirectory
- <code>Zed</code> will be listed before subdirectory
- <code>Beta</code>, which will be listed before normal files
- <code>Gamma</code> and <code>Alpha</code>.
- <strong>
This option only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- is also enabled.</strong>
+ <dd>Lorsque cette option est activée, la liste des
+ sous-répertoires apparaîtra <em>toujours</em> en premier, suivie
+ de la liste des fichiers normaux du répertoire. Le listing
+ comporte principalement deux parties, les fichiers et les
+ sous-répertoires, chacun d'eux étant trié séparément et les
+ sous-répertoires affichés en premier. Par exemple, si l'ordre de
+ tri est décroissant par nom, et si <code>FoldersFirst</code> est
+ activé, le sous-répertoire <code>Zed</code> sera affiché avant le
+ sous-répertoire <code>Beta</code>, qui sera lui-même affiché avant
+ les fichiers normaux <code>Gamma</code> et <code>Alpha</code>.
+ <strong>
Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.htmltable" id="indexoptions.htmltable">HTMLTable</a></dt>
- <dd>This option with <code>FancyIndexing</code> constructs
- a simple table for the fancy directory listing.
- It is necessary for utf-8 enabled platforms or if file
- names or description text will alternate between
- left-to-right and right-to-left reading order.</dd>
+ <dd>Cette option pour l'affichage
+ <code>FancyIndexing</code> permet de construire une table simple
+ pour l'affichage de l'index du répertoire. Cette option s'avèrera
+ particulièrement nécessaire pour les plates-formes où utf-8 est
+ activé et dans le cas où les noms de fichiers ou les chaînes
+ de description alternent entre les ordres de lecture gauche à
+ droite et droite à gauche.</dd>
<dt><a name="indexoptions.iconsarelinks" id="indexoptions.iconsarelinks">IconsAreLinks</a></dt>
- <dd>This makes the icons part of the anchor for the filename, for
- fancy indexing.</dd>
+ <dd>Configure la partie réservée aux icônes de l'ancrage pour le
+ nom de fichier, dans le cas d'un affichage "amélioré".</dd>
<dt><a name="indexoptions.iconheight" id="indexoptions.iconheight">IconHeight[=<var>pixels</var>]</a></dt>
- <dd>Presence of this option, when used with <code>IconWidth</code>,
- will cause the server to include <code>height</code> and
- <code>width</code> attributes in the <code>img</code> tag for the file
- icon. This allows browser to precalculate the page layout without having
- to wait until all the images have been loaded. If no value is given for
- the option, it defaults to the standard height of the icons supplied
- with the Apache httpd software.
-
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
+ <dd>Si cette option est présente, en combinaison avec
+ <code>IconWidth</code>, le serveur va inclure les attributs
+ <code>height</code> et <code>width</code> dans la balise
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la hauteur standard définie par
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.
+
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.iconwidth" id="indexoptions.iconwidth">IconWidth[=<var>pixels</var>]</a></dt>
- <dd>Presence of this option, when used with <code>IconHeight</code>,
- will cause the server to include <code>height</code> and
- <code>width</code> attributes in the <code>img</code> tag for
- the file icon. This allows browser to precalculate the page
- layout without having to wait until all the images have been
- loaded. If no value is given for the option, it defaults to
- the standard width of the icons supplied with the Apache httpd
- software.</dd>
+ <dd>Si cette option est présente, en combinaison avec
+ <code>IconHeight</code>, le serveur va inclure les attributs
+ <code>height</code> et <code>width</code> dans la balise
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la largeur standard définie par
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.</dd>
<dt><a name="indexoptions.ignorecase" id="indexoptions.ignorecase">IgnoreCase</a></dt>
- <dd>If this option is enabled, names are sorted in a case-insensitive
- manner. For instance, if the sort order is ascending by name, and
- <code>IgnoreCase</code> is enabled, file Zeta will be listed after
- file alfa (Note: file GAMMA will always be listed before file gamma).
+ <dd>Si cette option est activée, les noms sont triés sans tenir
+ compte de la casse. Par exemple, si le tri s'effectue sur les noms
+ dans l'ordre croissant, et si <code>IgnoreCase</code> est activé,
+ le fichier Zeta apparaîtra après le fichier alfa (Note : le
+ fichier GAMMA apparaîtra toujours avant le fichier gamma).
</dd>
<dt><a name="indexoptions.ignoreclient" id="indexoptions.ignoreclient">IgnoreClient</a></dt>
- <dd>This option causes <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> to ignore all
- query variables from the client, including sort order (implies
- <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>.)</dd>
+ <dd>Si cette option est activée, <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> va
+ ignorer toutes les variables de requête fournies par le client, y
+ compris les informations de tri (ce qui implique l'activation de
+ l'option <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>).</dd>
<dt><a name="indexoptions.namewidth" id="indexoptions.namewidth">NameWidth=[<var>n</var>
| *]</a></dt>
- <dd>The <code>NameWidth</code> keyword allows you to specify the width
- of the filename column in bytes.</dd>
+ <dd>Le mot-clé <code>NameWidth</code> vous permet de spécifier la
+ largeur en octets de la colonne correspondant au nom du
+ fichier.</dd>
- <dd><code>-NameWidth</code> (or unset) allows <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> to calculate the best width, but only up
- to 20 bytes wide.</dd>
+ <dd>Avec <code>-NameWidth</code> (ou si l'option n'est pas
+ définie), <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> va calculer la meilleure largeur
+ possible, mais jusqu'à une largeur maximale de 20 octets.</dd>
- <dd><code>NameWidth=<var>n</var></code> fixes the column width to
- <var>n</var> bytes wide.</dd>
+ <dd><code>NameWidth=<var>n</var></code> fixe la largeur de la
+ colonne à <var>n</var> octets.</dd>
- <dd><code>NameWidth=*</code> grows the column to the necessary
- width.</dd>
+ <dd><code>NameWidth=*</code> définit la largeur de colonne à la
+ valeur nécessaire.</dd>
<dt><a name="indexoptions.scanhtmltitles" id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt>
- <dd>This enables the extraction of the title from HTML documents
- for fancy indexing. If the file does not have a description
- given by <code class="directive"><a href="#adddescription">AddDescription</a></code>
- then httpd will read the document for the value of the
- <code>title</code> element. This is CPU and disk intensive.</dd>
+ <dd>L'activation de cette option permet d'extraire le titre des
+ documents HTML dans le cas d'un affichage "amélioré". Si le fichier
+ ne possède aucune description définie par la directive <code class="directive"><a href="#adddescription">AddDescription</a></code>, httpd va lire
+ le document pour tenter d'en extraire le <code>titre</code>. Ce
+ processus est coûteux en ressources disque et CPU.</dd>
<dt><a name="indexoptions.showforbidden" id="indexoptions.showforbidden">ShowForbidden</a></dt>
- <dd>If specified, Apache httpd will show files normally hidden because
- the subrequest returned <code>HTTP_UNAUTHORIZED</code> or
- <code>HTTP_FORBIDDEN</code></dd>
+ <dd>Si cette option est activée, Apache httpd affichera les fichiers
+ normalement cachés suite au retour des valeurs
+ <code>HTTP_UNAUTHORIZED</code> ou <code>HTTP_FORBIDDEN</code> par
+ la sous-requête.</dd>
<dt><a name="indexoptions.suppresscolumnsorting" id="indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></dt>
- <dd>If specified, Apache httpd will not make the column headings in a
- FancyIndexed directory listing into links for sorting. The
- default behavior is for them to be links; selecting the
- column heading will sort the directory listing by the values
- in that column. However, query string arguments which are appended
- to the URL will still be honored. That behavior is controlled by <a href="#indexoptions.ignoreclient"><code>IndexOptions
+ <dd>Si cette option est activée, Apache httpd supprimera les liens
+ hyper-texte dans les en-têtes de colonnes dans le cas d'un
+ affichage "amélioré". Par défaut, ces en-têtes constituent des liens
+ hyper-texte, et la sélection de l'un d'entre eux va trier l'index
+ du répertoire en fonction des valeurs de la colonne
+ correspondante. Cependant, les arguments de la chaîne de
+ paramètres de la requête ajoutés à l'URL seront toujours ignorés.
+ Ce comportement est contrôlé par l'option <a href="#indexoptions.ignoreclient"><code>IndexOptions
IgnoreClient</code></a>.</dd>
<dt><a name="indexoptions.suppressdescription" id="indexoptions.suppressdescription">SuppressDescription</a></dt>
- <dd>This will suppress the file description in fancy indexing
- listings. By default, no file descriptions are defined, and
- so the use of this option will regain 23 characters of screen
- space to use for something else. See <code class="directive"><a href="#adddescription">AddDescription</a></code> for information about setting the file
- description. See also the <code><a href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
- index option to limit the size of the description column.
-
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
+ <dd>L'activation de cette option va supprimer la description des
+ fichiers dans le cas d'un affichage "amélioré". Par défaut aucune
+ description de fichier n'est définie, et par conséquent
+ l'utilisation de cette option va permettre de récupérer un espace
+ à l'écran de 23 caractères pouvant être utilisé pour autre chose.
+ Voir la directive <code class="directive"><a href="#adddescription">AddDescription</a></code> pour plus d'informations à propos de
+ la définition des descriptions de fichiers. Voir aussi l'option
+ d'index <code><a href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
+ pour limiter la taille de la colonne description.
+
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppresshtmlpreamble" id="indexoptions.suppresshtmlpreamble">SuppressHTMLPreamble</a></dt>
- <dd>If the directory actually contains a file specified by the
- <code class="directive"><a href="#headername">HeaderName</a></code>
- directive, the module usually includes the contents of the file
- after a standard HTML preamble (<code><html></code>,
- <code><head></code>, <em>et cetera</em>). The
- <code>SuppressHTMLPreamble</code> option disables this behaviour,
- causing the module to start the display with the header file
- contents. The header file must contain appropriate HTML instructions
- in this case. If there is no header file, the preamble is generated
- as usual. If you also specify a <code class="directive"><a href="#readmename">ReadmeName</a></code>, and if that file
- exists, The closing </body></html> tags are also
- ommitted from the output, under the assumption that you'll likely
- put those closing tags in that file.</dd>
+ <dd>Si le répertoire contient effectivement le fichier spécifié
+ par la directive <code class="directive"><a href="#headername">HeaderName</a></code>, le module inclut
+ en général le contenu du fichier après avoir inséré un préambule
+ HTML standard (<code><html></code>,
+ <code><head></code>, <em>etc...</em>). L'activation de
+ l'option <code>SuppressHTMLPreamble</code> supprime l'insertion de
+ ce préambule, et le module va alors commencer l'affichage
+ directement par le contenu du fichier d'en-tête. Dans ce cas par
+ contre, le fichier d'en-tête doit contenir des instructions HTML
+ appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est
+ généré comme dans le cas général. Si vous spécifiez aussi une
+ directive <code class="directive"><a href="#readmename">ReadmeName</a></code>, et si ce
+ fichier existe, les balises de fermeture closing
+ </body></html> seront aussi omises dans la sortie, en
+ supposant que vous ayez placé ces balises de fermeture dans ce
+ fichier.</dd>
<dt><a name="indexoptions.suppressicon" id="indexoptions.suppressicon">SuppressIcon</a></dt>
- <dd>This will suppress the icon in fancy indexing listings.
- Combining both <code>SuppressIcon</code> and
- <code>SuppressRules</code> yields proper HTML 3.2 output, which
- by the final specification prohibits <code>img</code> and
- <code>hr</code> elements from the <code>pre</code> block (used to
- format FancyIndexed listings.)</dd>
+ <dd>L'activation de cette option supprime l'affichage des icônes
+ dans le cas d'un affichage "amélioré". La combinaison de
+ <code>SuppressIcon</code> et <code>SuppressRules</code> permet de
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").</dd>
<dt><a name="indexoptions.suppresslastmodified" id="indexoptions.suppresslastmodified">SuppressLastModified</a></dt>
- <dd>This will suppress the display of the last modification date,
- in fancy indexing listings.
+ <dd>L'activation de cette option supprime l'affichage de la date
+ de dernière modification dans le cas d'un affichage "amélioré".
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppressrules" id="indexoptions.suppressrules">SuppressRules</a>
</dt>
- <dd>This will suppress the horizontal rule lines (<code>hr</code>
- elements) in directory listings. Combining both <code>SuppressIcon</code> and
- <code>SuppressRules</code> yields proper HTML 3.2 output, which
- by the final specification prohibits <code>img</code> and
- <code>hr</code> elements from the <code>pre</code> block (used to
- format FancyIndexed listings.)
-
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
-
+ <dd>L'activation de cette option supprime l'affichage des lignes
+ horizontales (éléments <code>hr</code>) dans les index de
+ répertoires. La combinaison de
+ <code>SuppressIcon</code> et <code>SuppressRules</code> permet de
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").
+
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppresssize" id="indexoptions.suppresssize">SuppressSize</a></dt>
- <dd>This will suppress the file size in fancy indexing listings.
+ <dd>L'activation de cette option supprime l'affichage de la taille
+ du fichier dans le cas d'un affichage "amélioré".
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.trackmodified" id="indexoptions.trackmodified">TrackModified</a></dt>
- <dd>This returns the <code>Last-Modified</code> and <code>ETag</code>
- values for the listed directory in the HTTP header. It is only valid
- if the operating system and file system return appropriate stat()
- results. Some Unix systems do so, as do OS2's JFS and Win32's
- NTFS volumes. OS2 and Win32 FAT volumes, for example, do not.
- Once this feature is enabled, the client or proxy can track
- changes to the list of files when they perform a <code>HEAD</code>
- request. Note some operating systems correctly track new and
- removed files, but do not track changes for sizes or dates of
- the files within the directory. <strong>Changes to the size
- or date stamp of an existing file will not update the
- <code>Last-Modified</code> header on all Unix platforms.</strong>
- If this is a concern, leave this option disabled.</dd>
-
- <dt><a name="indexoptions.type" id="indexoptions.type">Type=<var>MIME content-type</var></a> (<em>Apache HTTP Server 2.0.61 and
- later</em>)</dt>
-
- <dd>The <code>Type</code> keyword allows you to
- specify the MIME content-type of the generated page. The default
- is <var>text/html</var>.
+ <dd>Cette option renvoie les valeurs <code>Last-Modified</code> et
+ <code>ETag</code> pour le répertoire indexé dans l'en-tête HTTP.
+ Elle n'est valide que si le système d'exploitation et le système
+ de fichiers renvoient des résultats appropriés pour la fonction
+ stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous
+ OS/2 ou
+ les volumes NTFS sous Win32. Ce n'est par contre pas le cas
+ des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le
+ client ou le mandataire peuvent détecter les changements dans la
+ liste des fichiers lorsqu'ils effectuent une requête
+ <code>HEAD</code>. Notez que certains systèmes d'exploitation
+ détectent correctement les nouveaux fichiers et les fichiers
+ supprimés, mais ne détectent pas les modifications de tailles ou
+ de dates des fichiers du répertoire. <strong>Les modifications de
+ taille ou de date d'un fichier existant ne mettent pas à jour
+ l'en-tête <code>Last-Modified</code> sur toutes les plate-formes
+ Unix.</strong> Si c'est le cas, laissez cette option
+ désactivée.</dd>
+
+ <dt><a name="indexoptions.type" id="indexoptions.type">Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et
+ supérieures du serveur HTTP Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>Type</code> vous permet de spécifier le type
+ MIME de la page générée. La valeur par défaut est
+ <var>text/html</var>.
<pre class="prettyprint lang-config">IndexOptions Type=text/plain</pre>
</dd>
<dt><a name="indexoptions.useolddateformat" id="indexoptions.useolddateformat">UseOldDateFormat</a>
- (<em>Apache HTTP Server 2.4.26 and later</em>)</dt>
+ (<em>Apache HTTP Server versions 2.4.26 et ultérieures</em>)</dt>
- <dd>The date format used for the <code>Last Modified</code> field was
- inadvertently changed to <code>"%Y-%m-%d %H:%M"</code> from
- <code>"%d-%b-%Y %H:%M"</code> in 2.4.0. Setting this option
- restores the date format from 2.2 and earlier.</dd>
+ <dd>Le format de date utilisé dans le champ <code>Last Modified</code>
+ avait été modifié par inadvertance de <code>"%d-%b-%Y %H:%M"</code> en
+ <code>"%Y-%m-%d %H:%M"</code> dans la version 2.4.0. Cette option permet
+ de restaurer le format de date des versions 2.2 et antérieures.</dd>
<dt><a name="indexoptions.versionsort" id="indexoptions.versionsort">VersionSort</a>
- (<em>Apache HTTP Server 2.0a3 and later</em>)</dt>
+ (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt>
- <dd>The <code>VersionSort</code> keyword causes files containing
- version numbers to sort in a natural way. Strings are sorted as
- usual, except that substrings of digits in the name and
- description are compared according to their numeric value.
+ <dd>Le mot-clé <code>VersionSort</code> permet de trier les
+ fichiers contenant des numéros de version d'une manière
+ spécifique. Les chaînes sont triées comme d'habitude, excepté les
+ sous-chaînes de chiffres du nom de fichier et de sa description
+ qui sont comparées en fonction de leur valeur numérique.
- <div class="example"><h3>Ex
ample:</h3><p><code>
+ <div class="example"><h3>Ex
emple :</h3><p><code>
foo-1.7<br />
foo-1.7.2<br />
foo-1.7.12<br />
foo-1.12
</code></p></div>
- <p>If the number starts with a zero, then it is considered to
- be a fraction:</p>
+ <p>Si le nombre commence par le chiffre 0, il est considéré comme
+ la partie fractionnaire d'un nombre :</p>
<div class="example"><p><code>
foo-1.001<br />
</dd>
<dt><a name="indexoptions.xhtml" id="indexoptions.xhtml">XHTML</a>
- (<em>Apache HTTP Server 2.0.49 and later</em>)</dt>
+ (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt>
- <dd>The <code>XHTML</code> keyword forces <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>
- to emit XHTML 1.0 code instead of HTML 3.2.
- <strong>This option
- only has an effect if <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> is also enabled.</strong>
+ <dd>Le mot-clé <code>XHTML</code> enjoint
+ <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> de générer du code XHTML 1.0 au
+ lieu de HTML 3.2.
+ <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong>
</dd>
-
</dl>
- <dl><dt>Incremental IndexOptions</dt>
+ <dl><dt>Options d'index incrémentales</dt>
<dd>
- <p>Be aware of how multiple <code class="directive">IndexOptions</code> are
- handled.</p>
+ <p>Vous devez porter une attention particulière à la manière dont
+ les <code class="directive">IndexOptions</code> multiples sont traitées.</p>
<ul>
- <li>Multiple <code class="directive">IndexOptions</code> directives for a
- single directory are now merged together. The result of:
+ <li>Plusieurs directives <code class="directive">IndexOptions</code>
+ apparaissant dans la même section directory sont maintenant
+ fusionnées. Le résultat de :
<pre class="prettyprint lang-config"><Directory "/foo">
IndexOptions HTMLTable
</Directory></pre>
- <p>will be the equivalent of</p>
+ <p>est équivalent à</p>
<pre class="prettyprint lang-config">IndexOptions HTMLTable SuppressColumnsorting</pre>
</li>
- <li>The addition of the incremental syntax (<em>i.e.</em>, prefixing
- keywords with <code>+</code> or <code>-</code>).</li>
+ <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés
+ avec <code>+</code> ou <code>-</code>).</li>
</ul>
- <p>Whenever a '+' or '-' prefixed keyword is encountered, it
- is applied to the current <code class="directive">IndexOptions</code>
- settings (which may have been inherited from an upper-level
- directory). However, whenever an unprefixed keyword is processed, it
- clears all inherited options and any incremental settings encountered
- so far. Consider the following example:</p>
+ <p>Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il
+ est appliqué aux définitions des
+ <code class="directive">IndexOptions</code> courantes (qui ont été
+ éventuellement héritées d'un directory de niveau supérieur). Par
+ contre, si un mot-clé non préfixé est trouvé, il supprime toutes
+ les definitions héritées, ainsi que toute
+ définition incrémentale. Considérons l'exemple
+ suivant :</p>
<pre class="prettyprint lang-config">IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize</pre>
- <p>The net effect is equivalent to <code>IndexOptions FancyIndexing
- +SuppressSize</code>, because the unprefixed <code>FancyIndexing</code>
- discarded the incremental keywords before it, but allowed them to
- start accumulating again afterward.</p>
+ <p>L'effet global est équivalent à l'effet qu'aurait provoqué
+ <code>IndexOptions FancyIndexing +SuppressSize</code>, car l'option
+ non préfixée <code>FancyIndexing</code> annule les mots-clés
+ incrémentaux situés avant elle, mais leur permet ensuite de
+ s'incrémenter à nouveau.</p>
- <p>To unconditionally set the <code class="directive">IndexOptions</code> for
- a particular directory, clearing the inherited settings, specify
- keywords without any <code>+</code> or <code>-</code> prefixes.</p>
+ <p>Pour définir inconditionnellement les
+ <code class="directive">IndexOptions</code> pour un répertoire particulier,
+ tout en supprimant les définitions héritées, spécifiez les
+ mots-clés sans préfixe <code>+</code> ou <code>-</code></p>
</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="indexorderdefault" id="indexorderdefault">Directive</a> <a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the default ordering of the directory index</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'ordre d'affichage par défaut d'un index de
+répertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOrderDefault Ascending|Descending
Name|Date|Size|Description</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IndexOrderDefault Ascending Name</code></td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">IndexOrderDefault</code> directive is used
- in combination with the <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code> index option. By default, fancyindexed
- directory listings are displayed in ascending order by filename; the
- <code class="directive">IndexOrderDefault</code> allows you to change this
- initial display order.</p>
-
- <p><code class="directive">IndexOrderDefault</code> takes two
- arguments. The first must be either <code>Ascending</code> or
- <code>Descending</code>, indicating the direction of the sort.
- The second argument must be one of the keywords <code>Name</code>,
- <code>Date</code>, <code>Size</code>, or <code>Description</code>,
- and identifies the primary key. The secondary key is
- <em>always</em> the ascending filename.</p>
-
- <p>You can, if desired, prevent the client from reordering the list
- by also adding the <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
- index option to remove the sort link from the top of the column,
- along with the <code><a href="#indexoptions.ignoreclient">IgnoreClient</a></code> index
- option to prevent them from manually adding sort options to the
- query string in order to override your ordering preferences.</p>
+ <p>La directive <code class="directive">IndexOrderDefault</code> s'utilise
+ en combinaison avec l'option d'index <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. Par
+ défaut, les index de répertoires "améliorés" sont affichés selon l'ordre
+ croissant des noms de fichiers ; la directive
+ <code class="directive">IndexOrderDefault</code> vous permet de modifier ce
+ comportement.</p>
+
+ <p>La directive <code class="directive">IndexOrderDefault</code> accepte
+ deux arguments. Le premier est soit <code>Ascending</code>, soit
+ <code>Descending</code>, et indique l'ordre de tri. Le second doit
+ prendre une des valeurs <code>Name</code>, <code>Date</code>,
+ <code>Size</code>, ou <code>Description</code>, et permet
+ d'identifier la clé primaire. La clé secondaire est
+ <em>toujours</em> le nom du fichier selon un ordre croissant.</p>
+
+ <p>Si vous le désirez, vous pouvez empêcher le client de modifier
+ l'ordre de tri de la liste en ajoutant l'option d'index <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
+ qui supprime le lien de définition du tri de l'en-tête de la
+ colonne, ainsi que l'option <code><a href="#indexoptions.ignoreclient">IgnoreClient</a></code> qui
+ empêche ce même client de passer outre vos préférences de tri en
+ ajoutant manuellement des options de tri à la chaîne de paramètres
+ 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="indexstylesheet" id="indexstylesheet">Directive</a> <a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds a CSS stylesheet to the directory index</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexStyleSheet <var>url-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute une feuille de style CSS à l'index du
+répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexStyleSheet <var>chemin-url</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">IndexStyleSheet</code> directive sets the name of
- the file that will be used as the CSS for the index listing.
+ <p>La directive <code class="directive">IndexStyleSheet</code> permet de
+ définir le nom du fichier qui servira de feuille de style CSS pour
+ l'index.
</p>
<pre class="prettyprint lang-config">IndexStyleSheet "/css/style.css"</pre>
- <p>Using this directive in conjunction with <code>IndexOptions
- HTMLTable</code> adds a number of CSS classes to the resulting HTML.
- The entire table is given a CSS id of <code>indexlist</code> and the
- following classes are associated with the various parts of the
- listing:</p>
-
- <table class="bordered"><tr class="header"><th>Class</th><th>Definition</th></tr>
-<tr><td>tr.indexhead</td><td>Header row of listing</td></tr>
-<tr class="odd"><td>th.indexcolicon and td.indexcolicon</td> <td>Icon column</td></tr>
-<tr><td>th.indexcolname and td.indexcolname</td> <td>File name column</td></tr>
-<tr class="odd"><td>th.indexcollastmod and td.indexcollastmod</td> <td>Last modified column</td></tr>
-<tr><td>th.indexcolsize and td.indexcolsize</td> <td>File size column</td></tr>
-<tr class="odd"><td>th.indexcoldesc and td.indexcoldesc</td> <td>Description column</td></tr>
-<tr><td>tr.breakrow</td> <td>Horizontal rule at the bottom of the table</td></tr>
-<tr class="odd"><td>tr.odd and tr.even</td> <td>Alternating even and odd rows</td></tr>
+ <p>L'utilisation de cette directive en conjonction avec <code>IndexOptions
+ HTMLTable</code> ajoute plusieurs classes CSS au document HTML
+ résultant. Un identifiant CSS <code>indexlist</code> est attribué à
+ l'ensemble de la table et les classes suivantes sont associées aux
+ différentes parties du listing :</p>
+
+ <table class="bordered"><tr class="header"><th>Classe</th><th>Définition</th></tr>
+<tr><td>tr.indexhead</td><td>Ligne d'en-tête du listing</td></tr>
+<tr class="odd"><td>th.indexcolicon and td.indexcolicon</td> <td>Colonne de
+ l'icône</td></tr>
+<tr><td>th.indexcolname and td.indexcolname</td> <td>Colonne du nom
+ du fichier</td></tr>
+<tr class="odd"><td>th.indexcollastmod and td.indexcollastmod</td> <td>Colonne
+ de la date de dernière modification</td></tr>
+<tr><td>th.indexcolsize and td.indexcolsize</td> <td>Colonne de la
+ taille du fichier</td></tr>
+<tr class="odd"><td>th.indexcoldesc and td.indexcoldesc</td> <td>Colonne de la
+ description</td></tr>
+<tr><td>tr.breakrow</td> <td>Pied de page</td></tr>
+<tr class="odd"><td>tr.odd and tr.even</td> <td>Alternance des lignes paires et
+ impaires</td></tr>
</table>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="readmename" id="readmename">Directive</a> <a name="ReadmeName" id="ReadmeName">ReadmeName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the file that will be inserted at the end
-of the index listing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReadmeName <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier dont le contenu sera inséré à la fin de
+l'index</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReadmeName <var>nom-fichier</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
</table>
- <p>The <code class="directive">ReadmeName</code> directive sets the name
- of the file that will be appended to the end of the index
- listing. <var>Filename</var> is the name of the file to include, and
- is taken to be relative to the location being indexed. If
- <var>Filename</var> begins with a slash, as in example 2, it will be taken to be
- relative to the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.
+ <p>La directive <code class="directive">ReadmeName</code> permet de définir
+ le nom du fichier dont le contenu sera ajouté à la fin de l'index.
+ <var>nom-fichier</var> est le nom du fichier à inclure, et est
+ considéré comme relatif au répertoire faisant l'objet de l'index. Si
+ <var>nom-fichier</var> commence par un slash '/', comme dans
+ l'exemple 2, il sera considéré
+ comme relatif au répertoire défini par la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.
</p>
<pre class="prettyprint lang-config"># Example 1
ReadmeName /include/FOOTER.html</pre>
- <p>See also <code class="directive"><a href="#headername">HeaderName</a></code>, where this behavior is described in greater
- detail.</p>
+ <p>Voir aussi la directive <code class="directive"><a href="#headername">HeaderName</a></code>, où cette fonctionnalité est décrite plus en
+ détails.</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="buffersize" id="buffersize">Directive</a> <a name="BufferSize" id="BufferSize">BufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size in bytes to buffer by the buffer filter</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferSize integer</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale en octets du filtre par tampon</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferSize entier</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BufferSize 131072</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_buffer</td></tr>
</table>
- <p>The <code class="directive"><a href="#buffersize">BufferSize</a></code>
- directive specifies the amount of data in bytes that will be
- buffered before being read from or written to each request.
- The default is 128 kilobytes.</p>
+ <p>La directive <code class="directive"><a href="#buffersize">BufferSize</a></code> permet de spécifier la
+ quantité de données en octets qui sera mise en tampon avant d'être
+ lue depuis ou écrite vers chaque requête. La valeur par défaut est
+ 128 ko.</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="cachedefaultexpire" id="cachedefaultexpire">Directive</a> <a name="CacheDefaultExpire" id="CacheDefaultExpire">CacheDefaultExpire</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The default duration to cache a document when no expiry date is specified.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDefaultExpire <var>seconds</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDefaultExpire 3600 (one hour)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée par défaut de mise en cache d'un document
+lorsqu'aucune date d'expiration n'a été spécifiée.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDefaultExpire <var>secondes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDefaultExpire 3600 (une heure)</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheDefaultExpire</code> directive specifies a default time,
- in seconds, to cache a document if neither an expiry date nor last-modified date are provided
- with the document. The value specified with the <code class="directive">CacheMaxExpire</code>
- directive does <em>not</em> override this setting.</p>
+ <p>La directive <code class="directive">CacheDefaultExpire</code> permet de
+ spécifier un temps par défaut, en secondes, pendant lequel sera
+ conservé dans le cache un document qui ne possède ni date
+ d'expiration, ni date de dernière modification. La valeur de cette
+ directive est écrasée par la valeur de la directive
+ <code class="directive">CacheMaxExpire</code> si cette dernière est
+ utilisée.</p>
<pre class="prettyprint lang-config">CacheDefaultExpire 86400</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachedetailheader" id="cachedetailheader">Directive</a> <a name="CacheDetailHeader" id="CacheDetailHeader">CacheDetailHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add an X-Cache-Detail header to the response.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête X-Cache-Detail à la réponse.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDetailHeader <var>on|off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDetailHeader 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.9 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
</table>
- <p>When the <code class="directive"><a href="#cachedetailheader">CacheDetailHeader</a></code> directive
- is switched on, an <strong>X-Cache-Detail</strong> header will be added to the response
- containing the detailed reason for a particular caching decision.</p>
-
- <p>It can be useful during development of cached RESTful services to have additional
- information about the caching decision written to the response headers, so as to
- confirm whether <code>Cache-Control</code> and other headers have been correctly
- used by the service and client.</p>
-
- <p>If the normal handler is used, this directive may appear within a
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> or
- <code class="directive"><a href="../mod/core.html#location"><Location></a></code> directive. If the quick handler
- is used, this directive must appear within a server or virtual host context, otherwise
- the setting will be ignored.</p>
-
- <pre class="prettyprint lang-config"># Enable the X-Cache-Detail header
+ <p>Lorsque la directive <code class="directive"><a href="#cachedetailheader">CacheDetailHeader</a></code> est définie à on, un
+ en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et
+ contient les raisons précises d'une décision d'utilisation du cache
+ vis à vis de cette dernière.</p>
+
+ <p>Ceci peut s'avérer utile au cours du développement de services
+ RESTful mis en cache pour obtenir des informations supplémentaires à
+ propos des décisions vis à vis du cache écrites dans les en-têtes de
+ la réponse. Il est ainsi possible de vérifier si
+ <code>Cache-Control</code> et d'autres en-têtes ont été correctement
+ utilisés par le service et le client.</p>
+
+ <p>Si le gestionnaire normal est utilisé, cette directive peut se
+ situer dans une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Si c'est le gestionnaire
+ rapide qui est utilisé, elle doit se situer dans un contexte de
+ serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p>
+
+ <pre class="prettyprint lang-config"># Active l'en-tête X-Cache-Detail
CacheDetailHeader on</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachedisable" id="cachedisable">Directive</a> <a name="CacheDisable" id="CacheDisable">CacheDisable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable caching of specified URLs</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDisable <var>url-string</var> | <var>on</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive la mise en cache des URLs
+spécifiées</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDisable <var>chaîne-url</var> | <var>on</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheDisable</code> directive instructs
- <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to <em>not</em> cache urls at or below
- <var>url-string</var>.</p>
+ <p>La directive <code class="directive">CacheDisable</code> enjoint
+ <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de <em>ne pas</em> mettre en cache l'URL
+ spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux
+ inférieurs.</p>
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">CacheDisable /local_files</pre>
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">CacheDisable /fichiers_locaux</pre>
</div>
- <p>If used in a <code class="directive"><Location></code> directive,
- the path needs to be specified below the Location, or if the word "on"
- is used, caching for the whole location will be disabled.</p>
+ <p>Si la directive se trouve à l'intérieur d'une section <code class="directive"><Location></code>, le chemin doit être spécifié en
+ dessous de la Location, et si le mot "on" est utilisé, la mise en
+ cache sera désactivée pour l'ensemble de l'arborescence concernée
+ par la section Location.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><Location "/foo">
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><Location "/foo">
CacheDisable on
</Location></pre>
</div>
- <p>The <code>no-cache</code> environment variable can be set to
- disable caching on a finer grained set of resources in versions
- 2.2.12 and later.</p>
-
+ <p>Avec les versions 2.2.12 et ultérieures, on peut définir la
+ variable d'environnement <code>no-cache</code> pour une définition
+ plus fine des ressources à mettre en cache.</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../env.html">Environment Variables in Apache</a></li>
+<li><a href="../env.html">Les variables d'environnement dans
+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="cacheenable" id="cacheenable">Directive</a> <a name="CacheEnable" id="CacheEnable">CacheEnable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable caching of specified URLs using a specified storage
-manager</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheEnable <var>cache_type</var> [<var>url-string</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la mise en cache des URLs spécifiées en utilisant le
+gestionnaire de stockage précisé</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheEnable <var>type de cache</var> [<var>chaîne
+URL</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>A url-string of '/' applied to forward proxy content in 2.2 and
- earlier.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Une chaîne URL telle que '/' s'appliquait à tout contenu
+en mandat direct dans les versions 2.2 et antérieures.</td></tr>
</table>
- <p>The <code class="directive">CacheEnable</code> directive instructs
- <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to cache urls at or below
- <var>url-string</var>. The cache storage manager is specified with the
- <var>cache_type</var> argument. The <code class="directive">CacheEnable</code>
- directive can alternatively be placed inside either
- <code class="directive"><Location></code> or
- <code class="directive"><LocationMatch></code> sections to indicate
- the content is cacheable.
- <var>cache_type</var> <code>disk</code> instructs
- <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to use the disk based storage manager
- implemented by <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. <var>cache_type</var>
- <code>socache</code> instructs <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to use the
- shared object cache based storage manager implemented by
- <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>.</p>
- <p>In the event that the URL space overlaps between different
- <code class="directive">CacheEnable</code> directives (as in the example below),
- each possible storage manager will be run until the first one that
- actually processes the request. The order in which the storage managers are
- run is determined by the order of the <code class="directive">CacheEnable</code>
- directives in the configuration file. <code class="directive">CacheEnable</code>
- directives within <code class="directive"><Location></code> or
- <code class="directive"><LocationMatch></code> sections are processed
- before globally defined <code class="directive">CacheEnable</code> directives.</p>
-
- <p>When acting as a forward proxy server, <var>url-string</var> must
- minimally begin with a protocol for which caching should be enabled.</p>
-
- <pre class="prettyprint lang-config"># Cache content (normal handler only)
+ <p>La directive <code class="directive">CacheEnable</code> enjoint
+ <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de mettre en cache l'URL précisée par
+ <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le
+ gestionnaire de stockage du cache est spécifié à l'aide de
+ l'argument <var>type de cache</var>. La directive
+ <code class="directive">CacheEnable</code> peut être placée à l'intérieur d'une
+ section <code class="directive"><Location></code> ou <code class="directive"><LocationMatch></code> pour indiquer que le
+ contenu considéré peut être mis en cache. Si <var>type de cache</var>
+ a pour valeur <code>disk</code>, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
+ utilisera le gestionnaire de stockage sur disque implémenté par
+ <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. Pour que <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
+ utilise le gestionnaire de stockage basé sur le cache d'objets
+ partagés implémenté par <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>,
+ spécifiez <code>socache</code> comme valeur du paramètre <var>type
+ de cache</var>.</p>
+ <p>Si les différentes directives <code class="directive">CacheEnable</code>
+ spécifient des URLs qui se recoupent (comme dans l'exemple
+ ci-dessous), tous les gestionnaires de stockage possibles seront
+ lancés, jusqu'au premier d'entre eux qui traitera effectivement la
+ requête.
+ L'ordre dans lequel les gestionnaires de stockage sont lancés est
+ déterminé par l'ordre dans lequel apparaissent les directives
+ <code class="directive">CacheEnable</code> dans le fichier de
+ configuration. Les directives <code class="directive">CacheEnable</code>
+ situées à l'intérieur de sections <code class="directive"><Location></code> ou <code class="directive"><LocationMatch></code> sont traitées avant les
+ directives <code class="directive">CacheEnable</code> définies au niveau
+ global.</p>
+
+ <p>En fonctionnement du type serveur mandataire direct, <var>chaîne
+ URL</var> doit au moins débuter par un protocole pour lequel la mise
+ en cache doit être activée.</p>
+
+ <pre class="prettyprint lang-config"># Mise en cache de contenu (gestionnaire normal seulement)
CacheQuickHandler off
<Location "/foo">
CacheEnable disk
</Location>
-# Cache regex (normal handler only)
+# Mise en cache via une expression rationnelle (gestionnaire normal seulement)
CacheQuickHandler off
<LocationMatch "foo$">
CacheEnable disk
</LocationMatch>
-# Cache all but forward proxy url's (normal or quick handler)
+# Mise en cache de tous les contenus, à l'exception des URLs
+# mandatées en direct (gestionnaire normal ou rapide)
CacheEnable disk /
-# Cache FTP-proxied url's (normal or quick handler)
+# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide)
CacheEnable disk ftp://
-# Cache forward proxy content from www.example.org (normal or quick handler)
+# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide)
CacheEnable disk http://www.example.org/</pre>
- <p>A hostname starting with a <strong>"*"</strong> matches all hostnames with
- that suffix. A hostname starting with <strong>"."</strong> matches all
- hostnames containing the domain components that follow.</p>
+ <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong>
+ correspondra à tout nom d'hôte se terminant par le suffixe
+ considéré. Un nom d'hôte commençant par un caractère
+ <strong>"."</strong> correspondra à tout nom d'hôte contenant le
+ composant de nom de domaine qui suit ce caractère.</p>
- <pre class="prettyprint lang-config"># Match www.example.org, and fooexample.org
+ <pre class="prettyprint lang-config"># Correspond à www.example.org et fooexample.org
CacheEnable disk http://*example.org/
-# Match www.example.org, but not fooexample.org
+# Correspond à www.example.org, mais pas à fooexample.org
CacheEnable disk http://.example.org/</pre>
- <p> The <code>no-cache</code> environment variable can be set to
- disable caching on a finer grained set of resources in versions
- 2.2.12 and later.</p>
+ <p>Depuis la version 2.2.12, on peut définir la variable
+ d'environnement <code>no-cache</code> pour une définition plus fine
+ des ressources à mettre en cache.</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../env.html">Environment Variables in Apache</a></li>
+<li><a href="../env.html">Les variables d'environnement dans
+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="cacheheader" id="cacheheader">Directive</a> <a name="CacheHeader" id="CacheHeader">CacheHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add an X-Cache header to the response.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête X-Cache à la réponse.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheHeader <var>on|off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheHeader 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.9 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
</table>
- <p>When the <code class="directive"><a href="#cacheheader">CacheHeader</a></code> directive
- is switched on, an <strong>X-Cache</strong> header will be added to the response
- with the cache status of this response. If the normal handler is used, this
- directive may appear within a <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
- or <code class="directive"><a href="../mod/core.html#location"><Location></a></code> directive. If the quick
- handler is used, this directive must appear within a server or virtual host
- context, otherwise the setting will be ignored.</p>
+ <p>Lorsque la directive <code class="directive"><a href="#cacheheader">CacheHeader</a></code> est définie à on, un
+ en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient
+ l'état du cache pour cette dernière. Si le gestionnaire normal est
+ utilisé, cette directive peut se situer dans une section
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou
+ <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Si c'est
+ le
+ gestionnaire rapide qui est utilisé, elle doit se situer dans un
+ contexte de serveur principal ou de serveur virtuel, sinon elle sera
+ ignorée.</p>
<dl>
- <dt><strong>HIT</strong></dt><dd>The entity was fresh, and was served from
- cache.</dd>
- <dt><strong>REVALIDATE</strong></dt><dd>The entity was stale, was successfully
- revalidated and was served from cache.</dd>
- <dt><strong>MISS</strong></dt><dd>The entity was fetched from the upstream
- server and was not served from cache.</dd>
+ <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été
+ servi depuis le cache.</dd>
+ <dt><strong>REVALIDATE</strong></dt><dd>Le contenu était périmé, a
+ été mis à jour, puis a été servi depuis le cache.</dd>
+ <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas été servi
+ depuis le cache, mais directement depuis le serveur demandé.</dd>
</dl>
- <pre class="prettyprint lang-config"># Enable the X-Cache header
+ <pre class="prettyprint lang-config"># Active l'en-tête X-Cache
CacheHeader on</pre>
<pre class="prettyprint lang-config">X-Cache: HIT from localhost</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="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a> <a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore request to not serve cached content to client</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les en-têtes de requête enjoignant de ne pas servir
+le contenu au client depuis le cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreCacheControl On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreCacheControl 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Ordinarily, requests containing a Cache-Control: no-cache or
- Pragma: no-cache header value will not be served from the cache. The
- <code class="directive">CacheIgnoreCacheControl</code> directive allows this
- behavior to be overridden. <code class="directive">CacheIgnoreCacheControl On</code>
- tells the server to attempt to serve the resource from the cache even
- if the request contains no-cache header values.</p>
+ <p>Normalement, les requêtes contenant des en-têtes tels que
+ Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies
+ depuis le cache. La directive
+ <code class="directive">CacheIgnoreCacheControl</code> permet de modifier ce
+ comportement. Avec <code class="directive">CacheIgnoreCacheControl
+ On</code>, le serveur tentera de servir la ressource depuis le
+ cache, même si la requête contient un en-tête
+ no-cache.</p>
<pre class="prettyprint lang-config">CacheIgnoreCacheControl On</pre>
- <div class="warning"><h3>Warning:</h3>
- This directive will allow serving from the cache even if the client has
- requested that the document not be served from the cache. This might
- result in stale content being served.
+ <div class="warning"><h3>Avertissement :</h3>
+ Cette directive permet de servir des ressources depuis le cache,
+ même si le client a demandé à ce qu'il n'en soit pas ainsi. Le
+ contenu servi est ainsi susceptible d'être périmé.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cacheignoreheaders" id="cacheignoreheaders">Directive</a> <a name="CacheIgnoreHeaders" id="CacheIgnoreHeaders">CacheIgnoreHeaders</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Do not store the given HTTP header(s) in the cache.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache.
</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreHeaders <var>header-string</var> [<var>header-string</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreHeaders <var>en-tête</var> [<var>en-tête</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreHeaders None</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>According to RFC 2616, hop-by-hop HTTP headers are not stored in
- the cache. The following HTTP headers are hop-by-hop headers and thus
- do not get stored in the cache in <em>any</em> case regardless of the
- setting of <code class="directive">CacheIgnoreHeaders</code>:</p>
+ <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont
+ pas stockés dans le cache. Les en-têtes HTTP suivant sont des
+ en-têtes hop-by-hop, et en tant que tels, ne sont en <em>aucun</em>
+ cas stockés dans le cache, quelle que soit la définition de la
+ directive <code class="directive">CacheIgnoreHeaders</code> :</p>
<ul>
<li><code>Connection</code></li>
<li><code>Upgrade</code></li>
</ul>
- <p><code class="directive">CacheIgnoreHeaders</code> specifies additional HTTP
- headers that should not to be stored in the cache. For example, it makes
- sense in some cases to prevent cookies from being stored in the cache.</p>
-
- <p><code class="directive">CacheIgnoreHeaders</code> takes a space separated list
- of HTTP headers that should not be stored in the cache. If only hop-by-hop
- headers not should be stored in the cache (the RFC 2616 compliant
- behaviour), <code class="directive">CacheIgnoreHeaders</code> can be set to
+ <p>La directive <code class="directive">CacheIgnoreHeaders</code> permet de
+ spécifier quels en-têtes HTTP ne doivent pas être stockés dans le
+ cache. Par exemple, il peut s'avérer pertinent dans certains cas de
+ ne pas stocker les cookies dans le cache.</p>
+
+ <p>La directive <code class="directive">CacheIgnoreHeaders</code> accepte
+ une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent
+ pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les
+ seuls à ne pas devoir être stockés dans le cache (le comportement
+ compatible RFC 2616), la directive
+ <code class="directive">CacheIgnoreHeaders</code> peut être définie à
<code>None</code>.</p>
- <div class="example"><h3>Ex
ample 1</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders Set-Cookie</pre>
+ <div class="example"><h3>Ex
emple 1</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders Set-Cookie</pre>
</div>
- <div class="example"><h3>Ex
ample 2</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders None</pre>
+ <div class="example"><h3>Ex
emple 2</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders None</pre>
</div>
- <div class="warning"><h3>Warning:</h3>
- If headers like <code>Expires</code> which are needed for proper cache
- management are not stored due to a
- <code class="directive">CacheIgnoreHeaders</code> setting, the behaviour of
- mod_cache is undefined.
+ <div class="warning"><h3>Avertissement :</h3>
+ Si des en-têtes nécessaires à la bonne gestion du cache, comme
+ <code>Expires</code>, ne sont pas stockés suite à la définition
+ d'une directive <code class="directive">CacheIgnoreHeaders</code>, le
+ comportement de mod_cache sera imprévisible.
</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="cacheignorenolastmod" id="cacheignorenolastmod">Directive</a> <a name="CacheIgnoreNoLastMod" id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore the fact that a response has no Last Modified
-header.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore le fait qu'une réponse ne possède pas d'en-tête Last
+Modified.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreNoLastMod On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreNoLastMod 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Ordinarily, documents without a last-modified date are not cached.
- Under some circumstances the last-modified date is removed (during
- <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> processing for example) or not provided
- at all. The <code class="directive">CacheIgnoreNoLastMod</code> directive
- provides a way to specify that documents without last-modified dates
- should be considered for caching, even without a last-modified date.
- If neither a last-modified date nor an expiry date are provided with
- the document then the value specified by the
- <code class="directive">CacheDefaultExpire</code> directive will be used to
- generate an expiration date.</p>
+ <p>Normalement, les documents qui ne possèdent pas de date de
+ dernière modification ne sont pas mis en cache. Dans certaines
+ circonstances, la date de dernière modification est supprimée (au
+ cours des traitements liés à <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> par
+ exemple), ou n'existe tout simplement pas. La directive
+ <code class="directive">CacheIgnoreNoLastMod</code> permet de spécifier si
+ les documents ne possèdant pas de date de dernière modification
+ doivent être mis en cache, même sans date de dernière modification.
+ Si le document ne possède ni date d'expiration, ni date de dernière
+ modification, la valeur spécifiée par la directive
+ <code class="directive">CacheDefaultExpire</code> servira à générer une date
+ d'expiration.
+ </p>
<pre class="prettyprint lang-config">CacheIgnoreNoLastMod On</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cacheignorequerystring" id="cacheignorequerystring">Directive</a> <a name="CacheIgnoreQueryString" id="CacheIgnoreQueryString">CacheIgnoreQueryString</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore query string when caching</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore la chaîne de paramètres lors de la mise en
+cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreQueryString On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreQueryString 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Ordinarily, requests with query string parameters are cached separately
- for each unique query string. This is according to RFC 2616/13.9 done only
- if an expiration time is specified. The
- <code class="directive">CacheIgnoreQueryString</code> directive tells the cache to
- cache requests even if no expiration time is specified, and to reply with
- a cached reply even if the query string differs. From a caching point of
- view the request is treated as if having no query string when this
- directive is enabled.</p>
+ <p>Normalement, les requêtes comportant une chaîne de paramètres
+ sont mises en cache séparément si leurs chaînes de paramètres
+ diffèrent.
+ En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée
+ séparément que si une date d'expiration est spécifiée. La directive
+ <code class="directive">CacheIgnoreQueryString</code> permet la mise en
+ cache de requêtes même si aucune date d'expiration est spécifiée, et
+ de renvoyer une réponse depuis la cache même si les chaînes de
+ paramètres diffèrent. Du point de vue du cache, la requête est
+ traitée comme si elle ne possèdait pas de chaîne de paramètres
+ lorsque cette directive est activée.</p>
<pre class="prettyprint lang-config">CacheIgnoreQueryString On</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cacheignoreurlsessionidentifiers" id="cacheignoreurlsessionidentifiers">Directive</a> <a name="CacheIgnoreURLSessionIdentifiers" id="CacheIgnoreURLSessionIdentifiers">CacheIgnoreURLSessionIdentifiers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore defined session identifiers encoded in the URL when caching
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les identifiants de session définis encodés dans
+l'URL lors de la mise en cache
</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreURLSessionIdentifiers <var>identifier</var> [<var>identifier</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreURLSessionIdentifiers <var>identifiant</var>
+[<var>identifiant</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreURLSessionIdentifiers None</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Sometimes applications encode the session identifier into the URL like in the following
- Examples:
+ <p>Certaines applications encodent l'identifiant de session dans
+ l'URL comme dans l'exemple suivant :
</p>
<ul>
- <li><code>/someapplication/image.gif;jsessionid=123456789</code></li>
- <li><code>/someapplication/image.gif?PHPSESSIONID=12345678</code></li>
+ <li><code>/une-application/image.gif;jsessionid=123456789</code></li>
+ <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li>
</ul>
- <p>This causes cacheable resources to be stored separately for each session, which
- is often not desired. <code class="directive">CacheIgnoreURLSessionIdentifiers</code> lets
- define a list of identifiers that are removed from the key that is used to identify
- an entity in the cache, such that cacheable resources are not stored separately for
- each session.
+ <p>Ceci implique la mise en cache des ressources séparément pour
+ chaque session, ce qui n'est en général pas souhaité. La directive
+ <code class="directive">CacheIgnoreURLSessionIdentifiers</code> permet de
+ définir une liste d'identifiants qui seront supprimés de la clé
+ utilisée pour identifier une entité dans le cache, de façon à ce que
+ les ressources ne soient pas stockées séparément pour chaque
+ session.
</p>
- <p><code>CacheIgnoreURLSessionIdentifiers None</code> clears the list of ignored
- identifiers. Otherwise, each identifier is added to the list.</p>
+ <p><code>CacheIgnoreURLSessionIdentifiers None</code> vide la liste
+ des identifiants ignorés. Autrement, chaque identifiant spécifié est
+ ajouté à la liste.</p>
- <div class="example"><h3>Ex
ample 1</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers jsessionid</pre>
+ <div class="example"><h3>Ex
emple 1</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers jsessionid</pre>
</div>
- <div class="example"><h3>Ex
ample 2</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers None</pre>
+ <div class="example"><h3>Ex
emple 2</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers None</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="cachekeybaseurl" id="cachekeybaseurl">Directive</a> <a name="CacheKeyBaseURL" id="CacheKeyBaseURL">CacheKeyBaseURL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the base URL of reverse proxied cache keys.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remplace l'URL de base des clés du cache mandatées en
+inverse</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheKeyBaseURL <var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheKeyBaseURL http://example.com</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.9 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
</table>
- <p>When the <code class="directive"><a href="#cachekeybaseurl">CacheKeyBaseURL</a></code> directive
- is specified, the URL provided will be used as the base URL to calculate
- the URL of the cache keys in the reverse proxy configuration. When not specified,
- the scheme, hostname and port of the current virtual host is used to construct
- the cache key. When a cluster of machines is present, and all cached entries
- should be cached beneath the same cache key, a new base URL can be specified
- with this directive.</p>
-
- <pre class="prettyprint lang-config"># Override the base URL of the cache key.
+ <p>Lorsque la directive <code class="directive"><a href="#cachekeybaseurl">CacheKeyBaseURL</a></code> est utilisée, l'URL
+ spécifiée sera utilisée comme URL de base pour calculer l'URL des clés
+ du cache dans la configuration du mandataire inverse. Par défaut,
+ c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera
+ utilisé pour construire la clé de cache. Dans le cas d'un cluster de
+ machines, si toutes les entrées du cache doivent posséder la même clé,
+ cette directive permet de spécifier une nouvelle URL de base.</p>
+
+ <pre class="prettyprint lang-config"># Remplace l'URL de base de la clé de cache.
CacheKeyBaseURL http://www.example.com/</pre>
- <div class="warning">Take care when setting this directive. If two separate virtual
- hosts are accidentally given the same base URL, entries from one virtual host
- will be served to the other.</div>
+ <div class="warning">Prenez garde en définissant cette directive. Si
+ deux serveurs virtuels distincts possèdent accidentellement la même
+ URL de base, les entrées en provenance d'un serveur virtuel seront
+ servies par l'autre.</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="cachelastmodifiedfactor" id="cachelastmodifiedfactor">Directive</a> <a name="CacheLastModifiedFactor" id="CacheLastModifiedFactor">CacheLastModifiedFactor</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The factor used to compute an expiry date based on the
-LastModified date.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLastModifiedFactor <var>float</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le facteur utilisé pour générer une date d'expiration en
+fonction de la date de dernière modification.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLastModifiedFactor <var>flottant</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLastModifiedFactor 0.1</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>In the event that a document does not provide an expiry date but does
- provide a last-modified date, an expiry date can be calculated based on
- the time since the document was last modified. The
- <code class="directive">CacheLastModifiedFactor</code> directive specifies a
- <var>factor</var> to be used in the generation of this expiry date
- according to the following formula:
-
- <code>expiry-period = time-since-last-modified-date * <var>factor</var>
- expiry-date = current-date + expiry-period</code>
-
- For example, if the document was last modified 10 hours ago, and
- <var>factor</var> is 0.1 then the expiry-period will be set to
- 10*0.1 = 1 hour. If the current time was 3:00pm then the computed
- expiry-date would be 3:00pm + 1hour = 4:00pm.
-
- If the expiry-period would be longer than that set by
- <code class="directive">CacheMaxExpire</code>, then the latter takes
- precedence.</p>
+ <p>Si un document ne possède pas de date d'expiration, elle peut
+ être calculée en fonction de la date de dernière modification, si
+ elle existe. La directive
+ <code class="directive">CacheLastModifiedFactor</code> permet de spécifier
+ un <var>facteur</var> à utiliser pour la génération de cette date
+ d'expiration au sein de la formule suivante :
+
+ <code>délai-expiration = durée-depuis-date-dernière-modification *
+ <var>facteur</var>
+ date-expiration = date-courante + délai-expiration</code>
+
+ Par exemple, si la dernière modification du document date de 10
+ heures, et si <var>facteur</var> a pour valeur 0.1, le délai
+ d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est
+ 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =
+ 4:00pm.
+
+ Si le délai d'expiration est supérieur à celui spécifié par la
+ directive <code class="directive">CacheMaxExpire</code>, c'est ce dernier
+ qui l'emporte.</p>
<pre class="prettyprint lang-config">CacheLastModifiedFactor 0.5</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachelock" id="cachelock">Directive</a> <a name="CacheLock" id="CacheLock">CacheLock</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the thundering herd lock.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la protection contre les tempêtes de requêtes.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLock <var>on|off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLock 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheLock</code> directive enables the thundering herd lock
- for the given URL space.</p>
+ <p>La directive <code class="directive">CacheLock</code> active la protection
+ contre les tempêtes de requêtes pour l'espace d'adressage donné.</p>
- <p>In a minimal configuration the following directive is all that is needed to
- enable the thundering herd lock in the default run-time file directory.</p>
+ <p>La configuration minimale pour activer le verrouillage contre les
+ tempêtes de requêtes dans le répertoire par
+ défaut des fichiers run-time est
+ la suivante :</p>
- <pre class="prettyprint lang-config"># Enable cache lock
+ <pre class="prettyprint lang-config"># Active le verrouillage du cache
CacheLock on</pre>
- <p>Locks consist of empty files that only exist for stale URLs in flight, so this
- is significantly less resource intensive than the traditional disk cache.</p>
+ <p>Les verrous sont des fichiers vides qui n'existent que pour les
+ URLs présentes dont le contenu est périmé ; ils consomment dont bien
+ moins de ressources que le cache disque traditionnel.</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="cachelockmaxage" id="cachelockmaxage">Directive</a> <a name="CacheLockMaxAge" id="CacheLockMaxAge">CacheLockMaxAge</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum possible age of a cache lock.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockMaxAge <var>integer</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la durée de vie maximale d'un verrou de cache.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockMaxAge <var>entier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockMaxAge 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheLockMaxAge</code> directive specifies the maximum
- age of any cache lock.</p>
+ <p>La directive <code class="directive">CacheLockMaxAge</code> permet de
+ spécifier la durée de vie maximale d'un verrou de cache.</p>
- <p>A lock older than this value in seconds will be ignored, and the next
- incoming request will be given the opportunity to re-establish the lock.
- This mechanism prevents a slow client taking an excessively long time to refresh
- an entity.</p>
+ <p>Un verrou plus ancien que cette valeur exprimée en secondes sera
+ ignoré, et la prochaine requête entrante sera alors en mesure de
+ recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop
+ longues initiées par des clients lents.</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="cachelockpath" id="cachelockpath">Directive</a> <a name="CacheLockPath" id="CacheLockPath">CacheLockPath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the lock path directory.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockPath <var>directory</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le répertoire des verrous.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockPath <var>répertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockPath mod_cache-lock</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheLockPath</code> directive allows you to specify the
- directory in which the locks are created. If <var>directory</var> is not an absolute
- path, the location specified will be relative to the value of
+ <p>La directive <code class="directive">CacheLockPath</code> permet de
+ spécifier le répertoire dans lequel les verrous sont
+ créés. Si <var>répertoire</var> n'est pas un
+ chemin absolu, il sera relatif au répertoire défini par la directive
<code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</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="cachemaxexpire" id="cachemaxexpire">Directive</a> <a name="CacheMaxExpire" id="CacheMaxExpire">CacheMaxExpire</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum time in seconds to cache a document</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxExpire <var>seconds</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxExpire 86400 (one day)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée maximale en secondes de mise en cache d'un
+document</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxExpire <var>secondes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxExpire 86400 (une journée)</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheMaxExpire</code> directive specifies the maximum number of
- seconds for which cacheable HTTP documents will be retained without checking the origin
- server. Thus, documents will be out of date at most this number of seconds. This maximum
- value is enforced even if an expiry date was supplied with the document.</p>
+ <p>La directive <code class="directive">CacheMaxExpire</code> permet de
+ spécifier le nombre maximum de secondes pendant lequel les documents
+ HTTP suceptibles d'être mis en cache seront conservés sans vérifier
+ leur contenu sur le serveur d'origine. Ce nombre de secondes
+ correspond donc à la durée maximale pendant laquelle un document ne
+ sera pas à jour. L'utilisation de cette valeur maximale est forcée,
+ même si le document possède une date d'expiration.</p>
<pre class="prettyprint lang-config">CacheMaxExpire 604800</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="cacheminexpire" id="cacheminexpire">Directive</a> <a name="CacheMinExpire" id="CacheMinExpire">CacheMinExpire</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time in seconds to cache a document</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinExpire <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale en secondes de mise en cache d'un
+document</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinExpire <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinExpire 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>The <code class="directive">CacheMinExpire</code> directive specifies the minimum number of
- seconds for which cacheable HTTP documents will be retained without checking the origin
- server. This is only used if no valid expire time was supplied with the document.</p>
-
+ <p>La directive <code class="directive">CacheMaxExpire</code> permet de
+ spécifier le nombre maximum de secondes pendant lequel les documents
+ HTTP suceptibles d'être mis en cache seront conservés sans vérifier
+ leur contenu sur le serveur d'origine. Elle n'est prise en compte
+ que dans le cas où le document ne possède aucune date d'expiration
+ valide.</p>
<pre class="prettyprint lang-config">CacheMinExpire 3600</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachequickhandler" id="cachequickhandler">Directive</a> <a name="CacheQuickHandler" id="CacheQuickHandler">CacheQuickHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Run the cache from the quick handler.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Exécute le cache à partir d'un gestionnaire rapide.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheQuickHandler <var>on|off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheQuickHandler 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.3.3 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.3 du serveur HTTP
+ Apache</td></tr>
</table>
- <p>The <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> directive
- controls the phase in which the cache is handled.</p>
-
- <p>In the default enabled configuration, the cache operates within the quick
- handler phase. This phase short circuits the majority of server processing,
- and represents the most performant mode of operation for a typical server.
- The cache <strong>bolts onto</strong> the front of the server, and the
- majority of server processing is avoided.</p>
-
- <p>When disabled, the cache operates as a normal handler, and is subject to
- the full set of phases when handling a server request. While this mode is
- slower than the default, it allows the cache to be used in cases where full
- processing is required, such as when content is subject to authorization.</p>
-
- <pre class="prettyprint lang-config"># Run cache as a normal handler
+ <p>La directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> permet de contrôler
+ la phase au cours de laquelle la mise en cache est effectuée.</p>
+
+ <p>Avec la configuration par défaut, le cache agit au cours de la
+ phase du gestionnaire rapide. Cette phase court-circuite la majorité
+ des traitements du serveur, et constitue le mode d'opération le plus
+ performant pour un serveur typique. Le cache
+ <strong>s'incruste</strong> devant le serveur, et la majorité des
+ traitements du serveur est court-circuitée.</p>
+
+ <p>Lorsque cette directive est définie à off, le cache agit comme un
+ gestionnaire normal, et est concerné par toutes les phases de
+ traitement d'une requête. Bien que ce mode soit moins performant que
+ le mode par défaut, il permet d'utiliser le cache dans les cas où un
+ traitement complet de la requête est nécessaire, comme par exemple
+ lorsque le contenu est soumis à autorisation.</p>
+
+ <pre class="prettyprint lang-config"># Exécute le cache comme un gestionnaire normal
CacheQuickHandler off</pre>
- <p>It is also possible, when the quick handler is disabled, for the
- administrator to choose the precise location within the filter chain where
- caching is to be performed, by adding the <strong>CACHE</strong> filter to
- the chain.</p>
+ <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a
+ aussi la possibilité de choisir avec précision le point de la chaîne
+ de filtrage où la mise en cache sera effectuée, en utilisant le
+ filtre <strong>CACHE</strong>.</p>
- <pre class="prettyprint lang-config"># Cache content before mod_include and mod_deflate
+ <pre class="prettyprint lang-config"># Mise en cache du contenu avant l'intervention de mod_include et
+ # mod_deflate
CacheQuickHandler off
AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre>
- <p>If the CACHE filter is specified more than once, the last instance will
- apply.</p>
+ <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière
+ instance qui sera prise en compte.</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="cachestaleonerror" id="cachestaleonerror">Directive</a> <a name="CacheStaleOnError" id="CacheStaleOnError">CacheStaleOnError</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serve stale content in place of 5xx responses.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sert du contenu non à jour à la place de réponses 5xx.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStaleOnError <var>on|off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStaleOnError 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>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.9 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
</table>
- <p>When the <code class="directive"><a href="#cachestaleonerror">CacheStaleOnError</a></code> directive
- is switched on, and when stale data is available in the cache, the cache will
- respond to 5xx responses from the backend by returning the stale data instead of
- the 5xx response. While the Cache-Control headers sent by clients will be respected,
- and the raw 5xx responses returned to the client on request, the 5xx response so
- returned to the client will not invalidate the content in the cache.</p>
-
- <pre class="prettyprint lang-config"># Serve stale data on error.
+ <p>Lorsque la directive <code class="directive"><a href="#cachestaleonerror">CacheStaleOnError</a></code> est définie à on, et
+ si des données non mises à jour sont disponibles dans le cache, ce
+ dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en
+ provenance du serveur d'arrière-plan. Alors que l'en-tête
+ Cache-Control envoyé par les clients sera respecté, et que les clients
+ recevront donc dans ce cas la réponse 5xx brute à leur requête, cette
+ réponse 5xx renvoyée au client n'invalidera pas le contenu dans le
+ cache. </p>
+
+ <pre class="prettyprint lang-config"># Sert des données non mises à jour en cas d'erreur.
CacheStaleOnError on</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachestoreexpired" id="cachestoreexpired">Directive</a> <a name="CacheStoreExpired" id="CacheStoreExpired">CacheStoreExpired</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache responses that the server reports as expired</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les réponses que le serveur
+considère comme arrivées à expiration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreExpired On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreExpired 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Since httpd 2.2.4, responses which have already expired are not
- stored in the cache. The <code class="directive">CacheStoreExpired</code>
- directive allows this behavior to be overridden.
- <code class="directive">CacheStoreExpired</code> On
- tells the server to attempt to cache the resource if it is stale.
- Subsequent requests would trigger an If-Modified-Since request of
- the origin server, and the response may be fulfilled from cache
- if the backend resource has not changed.</p>
+ <p>Depuis la version 2.2.4, les réponses qui sont arrivées à
+ expiration ne sont pas stockées dans le cache. La directive
+ <code class="directive">CacheStoreExpired</code> permet de modifier ce
+ comportement. Avec <code class="directive">CacheStoreExpired</code> On, le
+ serveur tente de mettre en cache la ressource si elle est périmée.
+ Les requêtes suivantes vont déclencher une requête si-modifié-depuis
+ de la part du serveur d'origine, et la réponse sera renvoyée à
+ partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p>
<pre class="prettyprint lang-config">CacheStoreExpired On</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="cachestorenostore" id="cachestorenostore">Directive</a> <a name="CacheStoreNoStore" id="CacheStoreNoStore">CacheStoreNoStore</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache requests or responses that have been marked as no-store.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les requêtes ou réponses dont
+l'entête Cache-Control: a pour valeur no-store.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreNoStore On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreNoStore 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Ordinarily, requests or responses with Cache-Control: no-store header
- values will not be stored in the cache. The
- <code class="directive">CacheStoreNoStore</code> directive allows this
- behavior to be overridden. <code class="directive">CacheStoreNoStore</code> On
- tells the server to attempt to cache the resource even if it contains
- no-store header values.</p>
+ <p>Normalement, les requêtes ou réponses dont l'en-tête
+ Cache-Control: a pour valeur no-store ne sont pas stockées dans le
+ cache. La directive <code class="directive">CacheStoreNoStore</code> permet
+ de modifier ce comportement. Si
+ <code class="directive">CacheStoreNoStore</code> est définie à On, le
+ serveur tente de mettre la ressource en cache même si elle contient
+ un en-tête no-store.</p>
+
<pre class="prettyprint lang-config">CacheStoreNoStore On</pre>
+
- <div class="warning"><h3>Warning:</h3>
- As described in RFC 2616, the no-store directive is intended to
- "prevent the inadvertent release or retention of sensitive information
- (for example, on backup tapes)." Enabling this option could store
- sensitive information in the cache. You are hereby warned.
+ <div class="warning"><h3>Avertissement :</h3>
+ Selon la RFC 2616, la valeur d'en-tête no-store est censée
+ "prévenir la suppression ou la rétention par inadvertance
+ d'informations sensibles (par exemple, sur des bandes de
+ sauvegarde)". Autrement dit, l'activation de la directive
+ <code class="directive">CacheStoreNoCache</code> pourrait provoquer le
+ stockage d'informations sensibles dans le cache. Vous avez donc
+ été prévenus.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachestoreprivate" id="cachestoreprivate">Directive</a> <a name="CacheStorePrivate" id="CacheStorePrivate">CacheStorePrivate</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to cache responses that the server has marked as private</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache des réponses que le serveur a
+marquées comme privées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStorePrivate On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStorePrivate 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
</table>
- <p>Ordinarily, responses with Cache-Control: private header values will not
- be stored in the cache. The <code class="directive">CacheStorePrivate</code>
- directive allows this behavior to be overridden.
- <code class="directive">CacheStorePrivate</code> On
- tells the server to attempt to cache the resource even if it contains
- private header values.</p>
+ <p>Normalement, les réponse comportant un en-tête Cache-Control:
+ dont la valeur est private ne seront pas stockées dans le cache. La
+ directive <code class="directive">CacheStorePrivate</code> permet de
+ modifier ce comportement. Si
+ <code class="directive">CacheStorePrivate</code> est définie à On, le
+ serveur tentera de mettre la ressource en cache, même si elle
+ contient un en-tête private.</p>
+
<pre class="prettyprint lang-config">CacheStorePrivate On</pre>
+
- <div class="warning"><h3>Warning:</h3>
- This directive will allow caching even if the upstream server has
- requested that the resource not be cached. This directive is only
- ideal for a 'private' cache.
+ <div class="warning"><h3>Avertissement :</h3>
+ Cette directive autorise la mise en cache même si le serveur
+ indique que la ressource ne doit pas être mise en cache. Elle
+ n'est de ce fait appropriée que dans le cas d'un cache
+ 'privé'.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachedirlength" id="cachedirlength">Directive</a> <a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of characters in subdirectory names</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>length</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de caractères des noms des
+sous-répertoires</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>longueur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLength 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheDirLength</code> directive sets the number
- of characters for each subdirectory name in the cache hierarchy. It can
- be used in conjunction with <code class="directive">CacheDirLevels</code> to
- determine the approximate structure of your cache hierarchy.</p>
- <p>A high value for <code class="directive">CacheDirLength</code> combined
- with a low value for <code class="directive">CacheDirLevels</code> will result in
- a relatively flat hierarchy, with a large number of subdirectories at each
- level.</p>
+ <p>la directive <code class="directive">CacheDirLength</code> permet de
+ définir le nombre de caractères que comportera chaque nom de
+ sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
+ conjonction avec <code class="directive">CacheDirLevels</code> pour
+ déterminer une structure approximative de la hiérarchie de
+ cache.</p>
+ <p>Une valeur haute pour <code class="directive">CacheDirLength</code>
+ combinée avec une valeur basse pour
+ <code class="directive">CacheDirLevels</code> générera une hiérarchie
+ relativement peu profonde, avec un grand nombre de sous-répertoires
+ à chaque niveau.</p>
<div class="note">
- <p>The result of <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code>* <code class="directive">CacheDirLength</code>
- must not be higher than 20.</p>
+ <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
+ <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
+ doit pas dépasser 20.</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="cachedirlevels" id="cachedirlevels">Directive</a> <a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of levels of subdirectories in the
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de niveaux de sous-répertoires que comportera le
cache.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>levels</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>niveaux</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLevels 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheDirLevels</code> directive sets the number
- of subdirectory levels in the cache. Cached data will be saved this
- many directory levels below the <code class="directive"><a href="#cacheroot">CacheRoot</a></code> directory.</p>
- <p>A high value for <code class="directive">CacheDirLevels</code> combined
- with a low value for <code class="directive">CacheDirLength</code> will result in
- a relatively deep hierarchy, with a small number of subdirectories at each
- level.</p>
+ <p>La directive <code class="directive">CacheDirLevels</code> permet de
+ définir le nombre de niveaux de sous-répertoires que comportera le
+ cache. Les données du cache seront stokées au niveau correspondant
+ par rapport au répertoire <code class="directive"><a href="#cacheroot">CacheRoot</a></code>.</p>
+ <p>Une valeur haute pour <code class="directive">CacheDirLevels</code>
+ combinée avec une valeur basse pour
+ <code class="directive">CacheDirLength</code> générera une arborescence
+ très développée, avec un petit nombre de sous-répertoires à chaque
+ niveau.</p>
<div class="note">
- <p>The result of <code class="directive">CacheDirLevels</code>*
- <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> must
- not be higher than 20.</p>
+ <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
+ <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
+ doit pas dépasser 20.</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="cachemaxfilesize" id="cachemaxfilesize">Directive</a> <a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum size (in bytes) of a document to be placed in the
-cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>>La taille maximale (en octets) d'un document pour pouvoir
+être stocké dans le cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxFileSize 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheMaxFileSize</code> directive sets the
- maximum size, in bytes, for a document to be considered for storage in
- the cache.</p>
+ <p>La directive <code class="directive">CacheMaxFileSize</code> permet de
+ définir la taille maximale d'un document, en octets, pour que
+ celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
<pre class="prettyprint lang-config">CacheMaxFileSize 64000</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cacheminfilesize" id="cacheminfilesize">Directive</a> <a name="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of a document to be placed in the
-cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinFileSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille minimale (en octets) d'un document pour pouvoir
+être stocké dans le cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinFileSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinFileSize 1</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheMinFileSize</code> directive sets the
- minimum size, in bytes, for a document to be considered for storage
- in the cache.</p>
+ <p>La directive <code class="directive">CacheMinFileSize</code> permet de
+ définir la taille minimale d'un document, en octets, pour que
+ celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
<pre class="prettyprint lang-config">CacheMinFileSize 64</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachereadsize" id="cachereadsize">Directive</a> <a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of the document to read and be cached
- before sending the data downstream</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale (en octets) de données à lire et à
+mettre en cache avant de les envoyer au client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadSize 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheReadSize</code> directive sets the
- minimum amount of data, in bytes, to be read from the backend before the
- data is sent to the client. The default of zero causes all data read of
- any size to be passed downstream to the client immediately as it arrives.
- Setting this to a higher value causes the disk cache to buffer at least
- this amount before sending the result to the client. This can improve
- performance when caching content from a reverse proxy.</p>
-
- <p>This directive only takes effect when the data is being saved to the
- cache, as opposed to data being served from the cache.</p>
-
+ <p>La directive <code class="directive">CacheReadSize</code> permet de
+ définir la quantité minimale de données, en octets, à lire depuis le
+ serveur d'arrière-plan avant de les envoyer au client. Avec la
+ valeur par défaut zéro, toute donnée de toutes tailles est envoyée
+ au client dès qu'elle est disponible. Avec une valeur non nulle, le
+ cache disque met en tampon au moins la quantité de données
+ correspondante avant d'envoyer la réponse au client. Les
+ performances peuvent s'en trouver améliorées lorsqu'on met en cache
+ du contenu en provenance d'un mandataire inverse.</p>
+
+ <p>Cette directive ne prend effet que lorsque les données sont
+ enregistrées dans le cache, et non lorsque les données sont servies à
+ partir du cache.</p>
+
<pre class="prettyprint lang-config">CacheReadSize 102400</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachereadtime" id="cachereadtime">Directive</a> <a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in milliseconds) that should elapse while reading
- before data is sent downstream</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadTime <var>milliseconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le temps minimum (en millisecondes) qui doit s'écouler
+avant d'envoyer les données au client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadTime <var>millisecondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadTime 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheReadTime</code> directive sets the minimum amount
- of elapsed time that should pass before making an attempt to send data
- downstream to the client. During the time period, data will be buffered
- before sending the result to the client. This can improve performance when
- caching content from a reverse proxy.</p>
-
- <p>The default of zero disables this option.</p>
-
- <p>This directive only takes effect when the data is being saved to the
- cache, as opposed to data being served from the cache. It is recommended
- that this option be used alongside the
- <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code> directive to
- ensure that the server does not buffer excessively should data arrive faster
- than expected.</p>
+ <p>La directive <code class="directive">CacheReadTime</code> permet de
+ définir le temps minimum qui doit s'écouler avant d'essayer
+ d'envoyer des données au client. Pendant ce temps, les données sont
+ mises en tampon avant de pouvoir être envoyées au client. Les
+ performances peuvent s'en trouver améliorées lorsqu'on met en cache
+ du contenu en provenance d'un mandataire inverse.</p>
+
+ <p>La valeur par défaut zéro désactive cette option.</p>
+
+ <p>Cette directive ne prend effet que lorsque les données sont
+ enregistrées dans le cache, et non lorsque les données sont servies à
+ partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
+ directive avec celle de la directive <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code>, afin de s'assurer
+ que le serveur n'effectue pas une mise en tampon excessive au cas
+ où les données arriveraient plus vite que prévu.</p>
<pre class="prettyprint lang-config">CacheReadTime 1000</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cacheroot" id="cacheroot">Directive</a> <a name="CacheRoot" id="CacheRoot">CacheRoot</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The directory root under which cache files are
-stored</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>directory</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La racine du répertoire dans lequel les fichiers du cache
+seront stockés</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>répertoire</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
</table>
- <p>The <code class="directive">CacheRoot</code> directive defines the name of
- the directory on the disk to contain cache files. If the <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> module has been loaded or compiled in to the
- Apache server, this directive <em>must</em> be defined. Failing to
- provide a value for <code class="directive">CacheRoot</code> will result in
- a configuration file processing error. The <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code> and <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> directives define
- the structure of the directories under the specified root directory.</p>
+ <p>La directive <code class="directive">CacheRoot</code> permet de définir
+ le nom du répertoire sur disque qui contiendra les fichiers du
+ cache. Si le module <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> a été chargé ou
+ compilé dans le serveur Apache, cette directive <em>doit</em> être
+ définie. L'absence de définition de la directive
+ <code class="directive">CacheRoot</code> provoquera une erreur de traitement
+ du fichier de configuration. Les directives <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code> et <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> permettent de
+ définir la structure des sous-répertoires du répertoire racine
+ spécifié.</p>
<pre class="prettyprint lang-config">CacheRoot c:/cacheroot</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocache" id="cachesocache">Directive</a> <a name="CacheSocache" id="CacheSocache">CacheSocache</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The shared object cache implementation to use</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Implémentation du cache d'objets partagés à utiliser</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocache <var>type[:args]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocache</code> directive defines the name of
- the shared object cache implementation to use, followed by optional
- arguments for that implementation. A <a href="../socache.html">number of
- implementations</a> of shared object caches are available to choose
- from.</p>
+ <p>La directive <code class="directive">CacheSocache</code>
+ définit l'implémentation du cache d'objets partagés à utiliser,
+ suivie d'arguments optionnels. Il est
+ possible de choisir entre plusieurs <a href="../socache.html">implémentations</a> de caches d'objets
+ partagés.</p>
<pre class="prettyprint lang-config">CacheSocache shmcb</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocachemaxsize" id="cachesocachemaxsize">Directive</a> <a name="CacheSocacheMaxSize" id="CacheSocacheMaxSize">CacheSocacheMaxSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum size (in bytes) of an entry to be placed in the
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille maximale d'une entrée pouvant être placée dans le
cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMaxSize 102400</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocacheMaxSize</code> directive sets the
- maximum size, in bytes, for the combined headers and body of a document
- to be considered for storage in the cache. The larger the headers that
- are stored alongside the body, the smaller the body may be.</p>
+ <p>La directive <code class="directive">CacheSocacheMaxSize</code>
+ définit la taille maximale, en octets, de la somme des en-têtes et
+ du corps d'un document pouvant être stocké dans le cache. Bien
+ entendu, plus la taille des en-têtes sera grande, plus la taille
+ maximale du corps du document s'en trouvera réduite.</p>
- <p>The <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> module will only attempt to
- cache responses that have an explicit content length, or that are small
- enough to be written in one pass. This is done to allow the
- <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> module to have an opportunity to cache
- responses larger than those cacheable within
+ <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> ne tentera de mettre
+ en cache que des réponses qui possèdent une taille de contenu
+ explicite, ou dont la taille est suffisamment petite pour qu'elles
+ soient écrites en une seule passe. Ceci permet au module
+ <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> de mettre en cache des réponses dont
+ la taille est trop importante pour pouvoir être mises en cache par
<code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>.</p>
<pre class="prettyprint lang-config">CacheSocacheMaxSize 102400</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocachemaxtime" id="cachesocachemaxtime">Directive</a> <a name="CacheSocacheMaxTime" id="CacheSocacheMaxTime">CacheSocacheMaxTime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum time (in seconds) for a document to be placed in the
-cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxTime <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée maximale de stockage d'un document dans le cache
+avant péremption</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxTime <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMaxTime 86400</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocacheMaxTime</code> directive sets the
- maximum freshness lifetime, in seconds, for a document to be stored in
- the cache. This value overrides the freshness lifetime defined for the
- document by the HTTP protocol.</p>
+ <p>La directive <code class="directive">CacheSocacheMaxTime</code>
+ définit la durée de stockage maximale en secondes d'un document dans
+ le cache avant péremption. Cette définition l'emporte sur la durée
+ de fraîcheur définie pour le document par le protocole HTTP.</p>
<pre class="prettyprint lang-config">CacheSocacheMaxTime 86400</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocachemintime" id="cachesocachemintime">Directive</a> <a name="CacheSocacheMinTime" id="CacheSocacheMinTime">CacheSocacheMinTime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in seconds) for a document to be placed in the
-cache</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale de stockage d'un document dans le cache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMinTime <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMinTime 600</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocacheMinTime</code> directive sets the
- amount of seconds beyond the freshness lifetime of the response that the
- response should be cached for in the shared object cache. If a response is
- only stored for its freshness lifetime, there will be no opportunity to
- revalidate the response to make it fresh again.</p>
+ <p>La directive <code class="directive">CacheSocacheMinTime</code>
+ définit le nombre de secondes au delà de la durée de fraîcheur de la
+ réponse pendant lesquelles cette dernière devra être stockée dans le
+ cache d'objets partagés. En effet, si une réponse n'est stockée que
+ pour une durée égale à sa durée de fraîcheur, elle n'a pas besoin
+ d'être rafraîchie.</p>
<pre class="prettyprint lang-config">CacheSocacheMinTime 600</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocachereadsize" id="cachesocachereadsize">Directive</a> <a name="CacheSocacheReadSize" id="CacheSocacheReadSize">CacheSocacheReadSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of the document to read and be cached
- before sending the data downstream</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale de données du document à lire et
+mettre en cache avant envoi au client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheReadSize 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocacheReadSize</code> directive sets the
- minimum amount of data, in bytes, to be read from the backend before the
- data is sent to the client. The default of zero causes all data read of
- any size to be passed downstream to the client immediately as it arrives.
- Setting this to a higher value causes the disk cache to buffer at least
- this amount before sending the result to the client. This can improve
- performance when caching content from a slow reverse proxy.</p>
+ <p>La directive <code class="directive">CacheSocacheReadSize</code>
+ définit la quantité minimale de données, en octets, à lire depuis
+ l'arrière-plan avant envoi au client. Avec la valeur par défaut 0,
+ les données sont transmises au client dès leur arrivée et quelle que
+ soit leur taille. Si la valeur définie est non nulle, le cache
+ disque va mettre en tampon au moins la quantité de données
+ correspondante avant envoi au client. Ceci peut améliorer les
+ performances en cas de mise en cache de contenu en provenance d'un
+ mandataire inverse lent.</p>
- <p>This directive only takes effect when the data is being saved to the
- cache, as opposed to data being served from the cache.</p>
+ <p>Cette directive n'a d'effet qu'au moment où les données sont
+ stockées dans le cache, et non lorsqu'elles sont servies depuis le
+ cache.</p>
<pre class="prettyprint lang-config">CacheSocacheReadSize 102400</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cachesocachereadtime" id="cachesocachereadtime">Directive</a> <a name="CacheSocacheReadTime" id="CacheSocacheReadTime">CacheSocacheReadTime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in milliseconds) that should elapse while reading
- before data is sent downstream</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadTime <var>milliseconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale de lecture avant l'envoi des données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadTime <var>millisecondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheReadTime 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">CacheSocacheReadTime</code> directive sets the minimum amount
- of elapsed time that should pass before making an attempt to send data
- downstream to the client. During the time period, data will be buffered
- before sending the result to the client. This can improve performance when
- caching content from a reverse proxy.</p>
+ <p>La directive <code class="directive">CacheSocacheReadTime</code>
+ définit le temps minimal qui doit s'écouler avant de tenter
+ l'envoi des données au client. Cette durée sera mise à profit pour
+ lire et mettre en tampon les données avant leur envoi au client.
+ Ceci peut améliorer les performances en cas de mise en cache de
+ contenu en provenance d'un mandataire inverse.</p>
- <p>The default of zero disables this option.</p>
+ <p>La valeur par défaut 0 désactive cette directive.</p>
- <p>This directive only takes effect when the data is being saved to the
- cache, as opposed to data being served from the cache. It is recommended
- that this option be used alongside the
- <code class="directive"><a href="#cachesocachereadsize">CacheSocacheReadSize</a></code> directive
- to ensure that the server does not buffer excessively should data arrive faster
- than expected.</p>
+ <p>Cette directive n'a d'effet qu'au moment où les données sont
+ stockées dans le cache, et non lorsqu'elles sont servies depuis le
+ cache. Il est recommandé d'utiliser cette directive en concomitance
+ avec la directive <code class="directive"><a href="#cachesocachereadsize">CacheSocacheReadSize</a></code> afin de
+ s'assurer que le serveur ne mette pas les données en tampon de
+ manière excessive dans le cas où les données arriveraient plus vite
+ que prévu.</p>
<pre class="prettyprint lang-config">CacheSocacheReadTime 1000</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="metadir" id="metadir">Directive</a> <a name="MetaDir" id="MetaDir">MetaDir</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the directory to find CERN-style meta information
-files</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaDir <var>directory</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du répertoire où trouver les fichiers de
+métainformations dans le style du CERN</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaDir <var>répertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaDir .web</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr>
</table>
- <p>Specifies the name of the directory in which Apache can find
- meta information files. The directory is usually a 'hidden'
- subdirectory of the directory that contains the file being
- accessed. Set to "<code>.</code>" to look in the same directory
- as the file:</p>
+ <p>Spécifie le nom du répertoire dans lequel Apache pourra trouver
+ les fichiers de métainformations. Ce répertoire est en général un
+ sous-répertoire 'caché' du répertoire qui contient le fichier à
+ accéder. Définissez cette directive à "<code>.</code>" pour
+ rechercher les métafichiers dans le même répertoire que le fichier à
+ accéder :</p>
<pre class="prettyprint lang-config">MetaDir .</pre>
- <p>Or, to set it to a subdirectory of the directory containing the
- files:</p>
+ <p>Ou, pour rechercher dans un sous-répertoire du répertoire
+ contenant le fichier à accéder :</p>
<pre class="prettyprint lang-config">MetaDir .meta</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="metafiles" id="metafiles">Directive</a> <a name="MetaFiles" id="MetaFiles">MetaFiles</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activates CERN meta-file processing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le traitement des métafichiers du CERN</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaFiles on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaFiles 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr>
</table>
- <p>Turns on/off Meta file processing on a per-directory basis.</p>
+ <p>Active ou désactive le traitement des métafichiers pour certains
+ répertoires.</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="metasuffix" id="metasuffix">Directive</a> <a name="MetaSuffix" id="MetaSuffix">MetaSuffix</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File name suffix for the file containing CERN-style
-meta information</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaSuffix <var>suffix</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Suffixe du fichier contenant les métainformations dans le
+style du CERN</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaSuffix <var>suffixe</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaSuffix .meta</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr>
</table>
- <p>Specifies the file name suffix for the file containing the
- meta information. For example, the default values for the two
- directives will cause a request to
- <code>DOCUMENT_ROOT/somedir/index.html</code> to look in
- <code>DOCUMENT_ROOT/somedir/.web/index.html.meta</code> and
- will use its contents to generate additional MIME header
- information.</p>
+ <p>Spécifie le suffixe du fichier contenant les métainformations.
+ Par exemple, si on conserve les valeurs par défaut des deux
+ directives précédentes, une requête pour
+ <code>DOCUMENT_ROOT/un-rep/index.html</code> provoquera la recherche
+ du métafichier
+ <code>DOCUMENT_ROOT/un-rep/.web/index.html.meta</code>, et utilisera
+ son contenu pour générer les informations quant aux en-têtes MIME
+ additionnels.</p>
- <div class="example"><h3>Ex
ample:</h3><pre class="prettyprint lang-config">MetaSuffix .meta</pre>
+ <div class="example"><h3>Ex
emple :</h3><pre class="prettyprint lang-config">MetaSuffix .meta</pre>
</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="scriptlog" id="scriptlog">Directive</a> <a name="ScriptLog" id="ScriptLog">ScriptLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the CGI script error logfile</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLog <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier journal des erreurs du script
+CGI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLog <var>chemin fichier</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><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></td></tr>
</table>
- <p>The <code class="directive">ScriptLog</code> directive sets the CGI
- script error logfile. If no <code class="directive">ScriptLog</code> is given,
- no error log is created. If given, any CGI errors are logged into the
- filename given as argument. If this is a relative file or path it is
- taken relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.
+ <p>La directive <code class="directive">ScriptLog</code> définit
+ le chemin du fichier journal des erreurs du script CGI. Si cette
+ directive n'est pas définie, aucune journalisation des erreurs n'est
+ effectuée. Si elle est définie, toute erreur CGI sera enregistrée
+ dans le fichier dont le nom est fourni en argument. S'il s'agit d'un
+ chemin de fichier relatif, il est considéré par rapport au
+ répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.
</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">ScriptLog logs/cgi_log</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">ScriptLog logs/cgi_log</pre>
</div>
- <p>This log will be opened as the user the child processes run
- as, <em>i.e.</em> the user specified in the main <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> directive. This means that
- either the directory the script log is in needs to be writable
- by that user or the file needs to be manually created and set
- to be writable by that user. If you place the script log in
- your main logs directory, do <strong>NOT</strong> change the
- directory permissions to make it writable by the user the child
- processes run as.</p>
-
- <p>Note that script logging is meant to be a debugging feature
- when writing CGI scripts, and is not meant to be activated
- continuously on running servers. It is not optimized for speed
- or efficiency, and may have security problems if used in a
- manner other than that for which it was designed.</p>
+ <p>Ce journal sera ouvert par l'utilisateur sous lequel les
+ processus enfants s'exécutent, c'est à dire l'utilisateur spécifié
+ par la directive du serveur <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>. Ceci implique que soit le
+ répertoire dans lequel se trouve le journal doit être accessible en
+ écriture pour cet utilisateur, soit le fichier doit être créé
+ manuellement et accessible en écriture pour cet utilisateur. Si vous
+ placez le journal du script dans votre répertoire principal des
+ journaux, ne modifiez <strong>PAS</strong> les permissions de ce
+ dernier afin de le le rendre accessible en écriture par
+ l'utilisateur sous lequel les processus enfants s'exécutent.</p>
+
+ <p>Notez que l'on ne doit activer la journalisation des scripts
+ qu'à des fins de débogage lors de l'écriture de scripts CGI, et non
+ de manière permanente sur un serveur en production. Elle n'est pas
+ optimisée en ce qui concerne la vitesse et l'efficacité, et peut
+ présenter des problèmes de sécurité si on l'utilise dans un cadre
+ autre que celui pour lequel elle a été conçue.</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="scriptlogbuffer" id="scriptlogbuffer">Directive</a> <a name="ScriptLogBuffer" id="ScriptLogBuffer">ScriptLogBuffer</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of PUT or POST requests that will be recorded
-in the scriptlog</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogBuffer <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des requêtes PUT ou POST qui seront
+enregistrées dans le journal du script</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogBuffer <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptLogBuffer 1024</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><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></td></tr>
</table>
- <p>The size of any PUT or POST entity body that is logged to
- the file is limited, to prevent the log file growing too big
- too quickly if large bodies are being received. By default, up
- to 1024 bytes are logged, but this can be changed with this
- directive.</p>
+ <p>Cette directive limite la taille du corps de toute
+ entité PUT ou POST qui sera enregistrée dans le journal, afin
+ de prévenir une croissance trop importante et trop rapide du fichier
+ journal due à la réception de corps de requête de grandes tailles.
+ Cette directive modifie cette taille maximale, dont la
+ valeur par défaut est de 1024 octets.</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="scriptloglength" id="scriptloglength">Directive</a> <a name="ScriptLogLength" id="ScriptLogLength">ScriptLogLength</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size limit of the CGI script logfile</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogLength <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale du fichier journal des scripts
+CGI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogLength <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptLogLength 10385760</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><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></td></tr>
</table>
- <p><code class="directive">ScriptLogLength</code> can be used to limit the
- size of the CGI script logfile. Since the logfile logs a lot of
- information per CGI error (all request headers, all script output)
- it can grow to be a big file. To prevent problems due to unbounded
- growth, this directive can be used to set an maximum file-size for
- the CGI logfile. If the file exceeds this size, no more
- information will be written to it.</p>
+ <p>La directive <code class="directive">ScriptLogLength</code>
+ définit la taille maximale du fichier journal des scripts CGI. Comme
+ le fichier journal accumule une grande quantité d'informations par
+ erreur CGI (tous les en-têtes de la requête, toutes les sorties du
+ script), il peut vite atteindre une grande taille. En limitant la
+ taille du fichier, cette directive permet d'éviter les problèmes que
+ causerait sa croissance sans limites. Lorsque le fichier a atteint
+ cette taille maximale, plus aucune information n'y est
+ enregistrée.</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="cgidscripttimeout" id="cgidscripttimeout">Directive</a> <a name="CGIDScriptTimeout" id="CGIDScriptTimeout">CGIDScriptTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The length of time to wait for more output from the
-CGI program</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée maximale d'attente de la prochaine sortie du
+programme CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIDScriptTimeout <var>time</var>[s|ms]</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>value of <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code> directive when
-unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Valeur de la directive <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code></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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cgid</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>CGIDScriptTimeout defaults to zero in releases 2.4 and earlier
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La valeur de CGIDScriptTimeout est 0 dans les versions
+2.4 et antérieures
</td></tr>
</table>
- <p>This directive limits the length of time to wait for more output from
- the CGI program. If the time is exceeded, the request and CGI are
- terminated.</p>
+ <p>Cette directive permet de limiter la durée d'attente avant les prochaines données
+ reçues en sortie du programme CGI. Si ce temps est dépassé, la requête et le
+ programme CGI se terminent.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">CGIDScriptTimeout 20</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">CGIDScriptTimeout 20</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="scriptsock" id="scriptsock">Directive</a> <a name="ScriptSock" id="ScriptSock">ScriptSock</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The filename prefix of the socket to use for communication with
-the cgi daemon</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptSock <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le préfixe du nom de fichier du socket à utiliser pour
+communiquer avec le démon CGI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptSock <var>chemin fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptSock cgisock</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cgid</td></tr>
</table>
- <p>This directive sets the filename prefix of the socket to use for
- communication with the CGI daemon, an extension corresponding to
- the process ID of the server will be appended. The socket will be opened
- using the permissions of the user who starts Apache (usually
- root). To maintain the security of communications with CGI
- scripts, it is important that no other user has permission to
- write in the directory where the socket is located.</p>
+ <p>Cette directive permet de définir le préfixe du nom de fichier du
+ socket à utiliser pour communiquer avec le démon CGI, préfixe auquel
+ sera ajouté une extension correspondant à l'identifiant processus du
+ serveur. Le socket sera ouvert avec les permissions de l'utilisateur
+ qui a démarré Apache (en général root). Afin de préserver la
+ sécurité des communications avec les scripts CGI, il est impératif
+ de n'accorder à aucun autre utilisateur la permission d'écrire dans
+ le répertoire où se trouve le socket.</p>
- <p>If <var>file-path</var> is not an absolute path, the location specified
- will be relative to the value of
- <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
+ <p>Si <var>chemin fichier</var> n'est pas un chemin absolu, il est
+ relatif au chemin défini par la directive <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">ScriptSock /var/run/cgid.sock</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">ScriptSock /var/run/cgid.sock</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="charsetdefault" id="charsetdefault">Directive</a> <a name="CharsetDefault" id="CharsetDefault">CharsetDefault</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Charset to translate into</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CharsetDefault <var>charset</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Jeu de caractère vers lequel la traduction doit
+s'effectuer</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CharsetDefault <var>jeu de caractères</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
</table>
- <p>The <code class="directive">CharsetDefault</code> directive specifies the
- charset that content in the associated container should be
- translated to.</p>
+ <p>La directive <code class="directive">CharsetDefault</code>
+ spécifie le jeu de caractères vers lequel le contenu situé dans le
+ conteneur associé devra être traduit.</p>
- <p>The value of the <var>charset</var> argument must be accepted
- as a valid character set name by the character set support in
- <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Generally, this means that it must be
- supported by iconv.</p>
+ <p>La valeur de l'argument <var>jeu de caractères</var> doit être
+ un nom de jeu de caractères valide du point de vue du support des
+ jeux de caractères dans <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. En général, cela
+ implique qu'elle doit être reconnue par iconv.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert">
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory></pre>
</div>
- <div class="note">
- Specifying the same charset for both <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code>
- and <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code> disables translation. The charset
- need not match the charset of the response, but it must be a valid charset on the system.
+ <div class="note">
+ Spécifier le même jeu de caractères pour les deux directives
+ <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code>
+ et <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code>
+ désactive la traduction. Le jeu de caractères ne doit pas forcément
+ correspondre au jeu de caractères de la réponse, mais il doit être
+ valide du point de vue du système.
</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="charsetoptions" id="charsetoptions">Directive</a> <a name="CharsetOptions" id="CharsetOptions">CharsetOptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures charset translation behavior</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Précise les détails de la traduction du jeu de
+caractères</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CharsetOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CharsetOptions ImplicitAdd</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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
</table>
- <p>The <code class="directive">CharsetOptions</code> directive configures certain
- behaviors of <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. <var>Option</var> can
- be one of</p>
+ <p>La directive <code class="directive">CharsetOptions</code>
+ précise certains détails du comportement du module
+ <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. <var>Option</var> accepte les
+ valeurs suivantes :</p>
<dl>
<dt><code>ImplicitAdd | NoImplicitAdd</code></dt>
- <dd>The <code>ImplicitAdd</code> keyword specifies that
- <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> should implicitly insert its
- filter when the configuration specifies that the character
- set of content should be translated. If the filter chain is
- explicitly configured using the <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> directive, <code>NoImplicitAdd</code>
- should be specified so that <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>
- doesn't add its filter.</dd>
+ <dd>Le mot-clé <code>ImplicitAdd</code> indique que
+ <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> doit insérer son filtre de
+ manière implicite lorsque la configuration indique que le jeu de
+ caractère du contenu doit être traduit. Si la chaîne de filtrage
+ est configurée de manière explicite via la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, l'option
+ <code>NoImplicitAdd</code> doit être utilisée afin que
+ <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> n'ajoute pas son propre
+ filtre.</dd>
<dt><code>TranslateAllMimeTypes | NoTranslateAllMimeTypes</code></dt>
- <dd>Normally, <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> will only perform
- translation on a small subset of possible mimetypes. When the
- <code>TranslateAllMimeTypes</code> keyword is specified for a given
- configuration section, translation is performed without regard for
- mimetype.</dd>
+ <dd>Normalement, <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> n'effectuera
+ une traduction qu'en présence d'un petit nombre de types MIME
+ parmi tous les types possibles. Lorsque l'option
+ <code>TranslateAllMimeTypes</code> est utilisée pour une section
+ de configuration donnée, la traduction est effectuée sans se
+ préoccuper du type MIME.</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="charsetsourceenc" id="charsetsourceenc">Directive</a> <a name="CharsetSourceEnc" id="CharsetSourceEnc">CharsetSourceEnc</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Source charset of files</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CharsetSourceEnc <var>charset</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Jeu de caractères source des fichiers</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CharsetSourceEnc <var>jeu de caractères</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
</table>
- <p>The <code class="directive">CharsetSourceEnc</code> directive specifies the
- source charset of files in the associated container.</p>
+ <p>La directive <code class="directive">CharsetSourceEnc</code>
+ spécifie un jeu de caractères source pour les fichiers situés dans
+ le conteneur associé.</p>
- <p>The value of the <var>charset</var> argument must be accepted
- as a valid character set name by the character set support in
- <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Generally, this means that it must be
- supported by iconv.</p>
+ <p>La valeur de l'argument <var>jeu de caractères</var> doit être
+ un nom de jeu de caractères valide du point de vue du support des
+ jeux de caractères dans <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. En général, cela
+ implique qu'elle doit être reconnue par iconv.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert">
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory></pre>
</div>
- <p>The character set names in this example work with the iconv
- translation support in Solaris 8.</p>
+ <p>Les noms de jeux de caractères de cet exemple sont reconnus par
+ le mécanisme de traduction d'iconv sous Solaris 8.</p>
- <div class="note">
- Specifying the same charset for both <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code>
- and <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code> disables translation. The charset
- need not match the charset of the response, but it must be a valid charset on the system.
+ <div class="note">
+ Spécifier le même jeu de caractères pour les deux directives
+ <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code>
+ et <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code>
+ désactive la traduction. Le jeu de caractères ne doit pas forcément
+ correspondre au jeu de caractères de la réponse, mais il doit être
+ valide du point de vue du système.
</div>
-
</div>
</div>
<div class="bottomlang">
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="dav" id="dav">Directive</a> <a name="Dav" id="Dav">Dav</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable WebDAV HTTP methods</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Dav On|Off|<var>provider-name</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les méthodes HTTP WebDAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Dav On|Off|<var>nom fournisseur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Dav Off</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
</table>
- <p>Use the <code class="directive">Dav</code> directive to enable the
- WebDAV HTTP methods for the given container:</p>
+ <p>La directive <code class="directive">Dav</code> active les
+ méthodes HTTP WebDAV pour le conteneur condidéré :</p>
<pre class="prettyprint lang-config"><Location "/foo">
Dav On
</Location></pre>
- <p>The value <code>On</code> is actually an alias for the default
- provider <code>filesystem</code> which is served by the <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> module. Note, that once you have DAV enabled
- for some location, it <em>cannot</em> be disabled for sublocations.
- For a complete configuration example have a look at the <a href="#example">section above</a>.</p>
+ <p>La valeur <code>On</code> est en fait un alias vers le
+ fournisseur par défaut <code>filesystem</code> implémenté par le
+ module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Notez que lorsque DAV est activé
+ pour un conteneur, on <em>ne peut pas</em> le désactiver pour ses
+ sous-conteneurs. Pour un exemple de configuration complet,
+ reportez-vous à la <a href="#example">section précédente</a>.</p>
<div class="warning">
- Do not enable WebDAV until you have secured your server. Otherwise
- everyone will be able to distribute files on your system.
+ N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si
+ vous passez outre cette recommandation, tout le monde pourra
+ enregistrer des fichiers sur votre système.
</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="davdepthinfinity" id="davdepthinfinity">Directive</a> <a name="DavDepthInfinity" id="DavDepthInfinity">DavDepthInfinity</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow PROPFIND, Depth: Infinity requests</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autorise les requêtes PROPFIND avec en-tête Depth:
+Infinity</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavDepthInfinity on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavDepthInfinity 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
</table>
- <p>Use the <code class="directive">DavDepthInfinity</code> directive to
- allow the processing of <code>PROPFIND</code> requests containing the
- header 'Depth: Infinity'. Because this type of request could constitute
- a denial-of-service attack, by default it is not allowed.</p>
+ <p>La directive <code class="directive">DavDepthInfinity</code>
+ autorise le traitement des requêtes <code>PROPFIND</code>
+ contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête
+ n'est pas autorisé, car il peut favoriser les attaques de type Déni
+ de service.</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="davmintimeout" id="davmintimeout">Directive</a> <a name="DavMinTimeout" id="DavMinTimeout">DavMinTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum amount of time the server holds a lock on
-a DAV resource</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavMinTimeout <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée minimale pendant laquelle le serveur maintient un
+verrou sur une ressource DAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavMinTimeout <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavMinTimeout 0</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
</table>
- <p>When a client requests a DAV resource lock, it can also
- specify a time when the lock will be automatically removed by
- the server. This value is only a request, and the server can
- ignore it or inform the client of an arbitrary value.</p>
-
- <p>Use the <code class="directive">DavMinTimeout</code> directive to specify, in
- seconds, the minimum lock timeout to return to a client.
- Microsoft Web Folders defaults to a timeout of 120 seconds; the
- <code class="directive">DavMinTimeout</code> can override this to a higher value
- (like 600 seconds) to reduce the chance of the client losing
- the lock due to network latency.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><Location "/MSWord">
+ <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il
+ peut aussi spécifier une durée au bout de laquelle le verrou sera
+ automatiquement supprimé par le serveur. Cette valeur ne constitue
+ qu'une requête, et le serveur peut l'ignorer ou informer le client
+ qu'il va utiliser une valeur arbitraire.</p>
+
+ <p>La directive <code class="directive">DavMinTimeout</code>
+ spécifie, en secondes, la durée minimale de verrouillage à renvoyer
+ au client. Les Répertoires Web de Microsoft présentent une durée par
+ défaut de 120 secondes ; la directive
+ <code class="directive">DavMinTimeout</code> permet de définir une valeur
+ supérieure (par exemple 600 secondes), afin de réduire les risques
+ de perte du verrou par le client suite à une surcharge du
+ réseau.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/MSWord">
DavMinTimeout 600
</Location></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="davlockdb" id="davlockdb">Directive</a> <a name="DavLockDB" id="DavLockDB">DavLockDB</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the DAV lock database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavLockDB <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavLockDB <var>chemin fichier</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_fs</td></tr>
</table>
- <p>Use the <code class="directive">DavLockDB</code> directive to specify
- the full path to the lock database, excluding an extension. If
- the path is not absolute, it will be taken relative to <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. The implementation of
- <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> uses a SDBM database to track user
- locks.</p>
+ <p>La directive <code class="directive">DavLockDB</code> spécifie
+ le chemin complet de la base de données des verrous, sans extension.
+ Si le chemin n'est pas absolu, il sera considéré comme relatif au
+ répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. L'implémentation de
+ <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise une base de données SDBM pour
+ surveiller les verrous utilisateurs.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">DavLockDB var/DavLock</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">DavLockDB var/DavLock</pre>
</div>
- <p>The directory containing the lock database file must be
- writable by the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>
- and <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> under which
- Apache is running. For security reasons, you should create a
- directory for this purpose rather than changing the permissions on
- an existing directory. In the above example, Apache will create
- files in the <code>var/</code> directory under the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> with the base filename
- <code>DavLock</code> and extension name chosen by the server.</p>
+ <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui
+ sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> doivent pouvoir écrire dans le
+ répertoire qui contient le fichier de la base de données des
+ verrous. Pour des raisons de sécurité, il est recommandé de créer un
+ répertoire dédié à la base de données des verrous, plutôt que de
+ modifier les permissions d'un répertoire existant. Dans l'exemple
+ ci-dessus, Apache va créer des fichiers dans le répertoire
+ <code>var/</code>, lui-même sous-répertoire du répertoire défini par
+ la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base
+ <code>DavLock</code> suivi d'une extension choisie par le
+ serveur.</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="davgenericlockdb" id="davgenericlockdb">Directive</a> <a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the DAV lock database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavGenericLockDB <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavGenericLockDB <var>chemin fichier</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_lock</td></tr>
</table>
- <p>Use the <code class="directive">DavGenericLockDB</code> directive to specify
- the full path to the lock database, excluding an extension. If
- the path is not absolute, it will be interpreted relative to <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. The implementation of
- <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> uses a SDBM database to track user
- locks.</p>
+ <p>La directive <code class="directive">DavLockDB</code> spécifie
+ le chemin complet de la base de données des verrous, sans extension.
+ Si le chemin n'est pas absolu, il sera considéré comme relatif au
+ répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. L'implémentation de
+ <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> utilise une base de données SDBM pour
+ surveiller les verrous utilisateurs.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre>
</div>
- <p>The directory containing the lock database file must be
- writable by the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>
- and <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> under which
- Apache is running. For security reasons, you should create a
- directory for this purpose rather than changing the permissions on
- an existing directory. In the above example, Apache will create
- files in the <code>var/</code> directory under the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> with the base filename
- <code>DavLock</code> and an extension added by the server.</p>
+ <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui
+ sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> doivent pouvoir écrire dans le
+ répertoire qui contient le fichier de la base de données des
+ verrous. Pour des raisons de sécurité, il est recommandé de créer un
+ répertoire dédié à la base de données des verrous, plutôt que de
+ modifier les permissions d'un répertoire existant. Dans l'exemple
+ ci-dessus, Apache va créer des fichiers dans le répertoire
+ <code>var/</code>, lui-même sous-répertoire du répertoire défini par
+ la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base
+ <code>DavLock</code> suivi d'une extension choisie par le
+ serveur.</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="dbdexptime" id="dbdexptime">Directive</a> <a name="DBDExptime" id="DBDExptime">DBDExptime</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keepalive time for idle connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDExptime <var>time-in-seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de vie des connexions inactives</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDExptime <var>durée en secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DBDExptime 300</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Set the time to keep idle connections alive when the number
- of connections specified in DBDKeep has been exceeded (threaded
- platforms only).</p>
+ <p>Cette directive définit la durée de vie des connexions
+ inactives lorsque le nombre de connexions spécifié par la directive
+ DBDKeep a été dépassé (plates-formes threadées seulement).</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="dbdinitsql" id="dbdinitsql">Directive</a> <a name="DBDInitSQL" id="DBDInitSQL">DBDInitSQL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Execute an SQL statement after connecting to a database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDInitSQL <var>"SQL statement"</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Exécute une instruction SQL après connexion à une base de
+données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDInitSQL <var>"instruction SQL"</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Modules, that wish it, can have one or more SQL statements
- executed when a connection to a database is created. Example
- usage could be initializing certain values or adding a log
- entry when a new connection is made to the database.</p>
+ <p>Les modules qui le souhaitent peuvent exécuter une ou plusieurs
+ instructions SQL après connexion à une base de données. Par exemple
+ initialiser certaines valeurs, ou ajouter une entrée dans le journal
+ lors d'une nouvelle connexion à la base de donné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="dbdkeep" id="dbdkeep">Directive</a> <a name="DBDKeep" id="DBDKeep">DBDKeep</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum sustained number of connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDKeep <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions maintenues</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDKeep <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DBDKeep 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Set the maximum number of connections per process to be
- sustained, other than for handling peak demand (threaded
- platforms only).</p>
+ <p>Cette directive définit le nombre maximum de connexions
+ à maintenir par processus, en dehors de celles servant à gérer les
+ pics de demandes (plates-formes threadées seulement).</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="dbdmax" id="dbdmax">Directive</a> <a name="DBDMax" id="DBDMax">DBDMax</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMax <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMax <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DBDMax 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Set the hard maximum number of connections per process
- (threaded platforms only).</p>
+ <p>Cette directive définit le nombre maximum effectif de
+ connexions par processus (plates-formes threadées seulement).</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="dbdmin" id="dbdmin">Directive</a> <a name="DBDMin" id="DBDMin">DBDMin</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMin <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de connexions</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMin <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DBDMin 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Set the minimum number of connections per process (threaded
- platforms only).</p>
+ <p>Cette directive définit le nombre minimum de connexions
+ par processus (plates-formes threadées seulement).</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="dbdparams" id="dbdparams">Directive</a> <a name="DBDParams" id="DBDParams">DBDParams</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Parameters for database connection</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Paramètres de la connexion à la base de
+données</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDParams
-<var>param1</var>=<var>value1</var>[,<var>param2</var>=<var>value2</var>]</code></td></tr>
+<var>param1</var>=<var>valeur1</var>[,<var>param2</var>=<var>valeur2</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>As required by the underlying driver. Typically this will be
- used to pass whatever cannot be defaulted amongst username,
- password, database name, hostname and port number for connection.</p>
- <p>Connection string parameters for current drivers include:</p>
+ <p>Cette directive spécifie des paramètres selon les
+ besoins du pilote concerné. En général, les paramètres à passer
+ concernent tout ce qui n'a pas de valeur par défaut comme le nom
+ d'utilisateur, le mot de passe, le nom de la base de données, le nom
+ d'hôte et le numéro de port de la connexion.</p>
+ <p>Les paramètres de la chaîne de connexion en fonction des
+ différents pilotes comprennent :</p>
<dl>
- <dt>FreeTDS (for MSSQL and SyBase)</dt>
+ <dt>FreeTDS (pour MSSQL et SyBase)</dt>
<dd>username, password, appname, dbname, host, charset, lang, server</dd>
<dt>MySQL</dt>
<dd>host, port, user, pass, dbname, sock, flags, fldsz, group, reconnect</dd>
<dt>Oracle</dt>
<dd>user, pass, dbname, server</dd>
<dt>PostgreSQL</dt>
- <dd>The connection string is passed straight through to <code>PQconnectdb</code></dd>
+ <dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd>
<dt>SQLite2</dt>
- <dd>The connection string is split on a colon, and <code>part1:part2</code> is used as <code>sqlite_open(part1, atoi(part2), NULL)</code></dd>
+ <dd>La chaîne de connexion est scindée avec comme séparateur le
+ caractère ':', et <code>partie1:partie2</code> est utilisé dans
+ <code>sqlite_open(partie1, atoi(partie2), NULL)</code></dd>
<dt>SQLite3</dt>
- <dd>The connection string is passed straight through to <code>sqlite3_open</code></dd>
+ <dd>La chaîne de connexion est passée directement à <code>sqlite3_open</code></dd>
<dt>ODBC</dt>
<dd>datasource, user, password, connect, ctimeout, stimeout, access, txmode, bufsize</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="dbdpersist" id="dbdpersist">Directive</a> <a name="DBDPersist" id="DBDPersist">DBDPersist</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to use persistent connections</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utiliser ou non des connexions persistentes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDPersist On|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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>If set to Off, persistent and pooled connections are disabled.
- A new database connection is opened when requested by a client,
- and closed immediately on release. This option is for debugging
- and low-usage servers.</p>
+ <p>Si cette directive est définie à Off, les connexions persistentes
+ et les connexions groupées sont désactivées. À la demande d'un
+ client, une nouvelle connexion à la base de données est ouverte, et
+ fermée immédiatement à l'issue du traitement. Cette configuration ne
+ doit être utilisée qu'à des fins de débogage, ou sur des serveurs à
+ charge faible.</p>
- <p>The default is to enable a pool of persistent connections
- (or a single LAMP-style persistent connection in the case of a
- non-threaded server), and should almost always be used in operation.</p>
+ <p>Par défaut, les groupes de connexions persistentes sont activés
+ (ou une seule connexion persistente du style LAMP pour les serveurs
+ non threadés), et c'est la configuration qui devrait être utilisée
+ dans la plupart des cas sur un serveur en production.</p>
- <p>Prior to version 2.2.2, this directive accepted only the values
- <code>0</code> and <code>1</code> instead of <code>Off</code> and
- <code>On</code>, respectively.</p>
+ <p>Avant la version 2.2.2, cette directive n'acceptait que les
+ valeurs <code>0</code> et <code>1</code> au lieu de <code>Off</code>
+ et <code>On</code>, respectivement.</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="dbdpreparesql" id="dbdpreparesql">Directive</a> <a name="DBDPrepareSQL" id="DBDPrepareSQL">DBDPrepareSQL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define an SQL prepared statement</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDPrepareSQL <var>"SQL statement"</var> <var>label</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une requête SQL préparée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDPrepareSQL <var>"requête SQL"</var> <var>étiquette</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>For modules such as authentication that repeatedly use a
- single SQL statement, optimum performance is achieved by preparing
- the statement at startup rather than every time it is used.
- This directive prepares an SQL statement and assigns it a label.</p>
+ <p>Pour les modules tels que les modules d'authentification, qui
+ utilisent de manière répétée la même requête SQL, on peut optimiser
+ les performances en préparant la requête une fois pour toutes au
+ démarrage, plutôt qu'à chaque utilisation. Cette directive permet de
+ préparer une requête SQL et de lui assigner une étiquette.</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="dbdriver" id="dbdriver">Directive</a> <a name="DBDriver" id="DBDriver">DBDriver</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify an SQL driver</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDriver <var>name</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie un pilote SQL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDriver <var>nom</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
</table>
- <p>Selects an apr_dbd driver by name. The driver must be installed
- on your system (on most systems, it will be a shared object or dll).
- For example, <code>DBDriver mysql</code> will select the MySQL
- driver in apr_dbd_mysql.so.</p>
+ <p>Cette directive spécifie un pilote apr_dbd par son
+ nom. Le pilote doit être installé sur votre système (sur la plupart
+ des systèmes, il s'agit d'un objet partagé ou d'une dll). Par
+ exemple, <code>DBDriver mysql</code> va sélectionner le pilote MySQL
+ dans la bibliothèque apr_dbd_mysql.so.</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="deflatealteretag" id="deflatealteretag">Directive</a> <a name="DeflateAlterETag" id="DeflateAlterETag">DeflateAlterETag</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How the outgoing ETag header should be modified during compression</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Comment l'en-tête sortant ETag doit être modifié au cours
+de la compression</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateAlterETag AddSuffix|NoChange|Remove</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateAlterETag AddSuffix</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateAlterETag</code> directive specifies
- how the ETag hader should be altered when a response is compressed.</p>
+ <p>La directive <code class="directive">DeflateAlterETag</code> permet de
+ spécifier comment l'en-tête ETag doit être modifié lorsqu'une
+ réponse est compressée.</p>
<dl>
<dt>AddSuffix</dt>
- <dd><p>Append the compression method onto the end of the ETag, causing
- compressed and uncompressed representations to have unique ETags.
- This has been the default since 2.4.0, but prevents serving
- "HTTP Not Modified" (304) responses to conditional requests for
- compressed content.</p></dd>
+ <dd><p>Ajoute la méthode de compression à la fin de l'en-tête, ce
+ qui a pour effet d'attribuer un en-tête ETag unique aux
+ représentations compressées et non compressées. C'est l'option par
+ défaut depuis la version 2.4.0, mais empêche de servir des
+ codes d'état "HTTP Not Modified" (304) en réponse aux requêtes pour un
+ contenu compressé.</p></dd>
<dt>NoChange</dt>
- <dd><p>Don't change the ETag on a compressed response. This was the default
- prior to 2.4.0, but does not satisfy the HTTP/1.1 property that all
- representations of the same resource have unique ETags. </p></dd>
+ <dd><p>Ne modifie pas l'en-tête ETag dans une réponse compressée.
+ C'était l'option par
+ défaut avant la version 2.4.0, mais cela ne respectait pas la
+ préconisation HTTP/1.1 selon laquelle chaque représentation de la
+ même ressource doit posséder un en-tête ETag unique.</p></dd>
<dt>Remove</dt>
- <dd><p>Remove the ETag header from compressed responses. This prevents
- some conditional requests from being possible, but avoids the
- shortcomings of the preceding options. </p></dd>
+ <dd><p>Supprime l'en-tête ETag dans les réponses compressées, ce qui
+ a pour effet de rendre impossibles certaines requêtes
+ conditionnelles, mais permet d'éviter les inconvénients des options
+ précédentes.</p></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="deflatebuffersize" id="deflatebuffersize">Directive</a> <a name="DeflateBufferSize" id="DeflateBufferSize">DeflateBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fragment size to be compressed at one time by zlib</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateBufferSize <var>value</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du fragment que zlib devra comprimer en une seule
+fois</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateBufferSize <var>valeur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateBufferSize 8096</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateBufferSize</code> directive specifies
- the size in bytes of the fragments that zlib should compress at one
- time. If the compressed response size is bigger than the one specified
- by this directive then httpd will switch to chunked encoding
- (HTTP header <code>Transfer-Encoding</code> set to <code>Chunked</code>), with the
- side effect of not setting any <code>Content-Length</code> HTTP header. This is particularly
- important when httpd works behind reverse caching proxies or when httpd is configured with
- <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> and <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> because
- HTTP responses without any <code>Content-Length</code> header might not be cached.
- </p>
+ <p>La directive <code class="directive">DeflateBufferSize</code> permet de
+ spécifier la taille en octets du fragment que zlib devra comprimer
+ en une seule fois. Si la taille de la réponse compressée est supérieure à
+ celle spécifiée par cette directive, httpd passera à un mode d'encodage
+ fragmenté (l'en-tête HTTP <code>Transfer-Encoding</code> prend la valeur
+ <code>Chunked</code>), ceci ayant comme effet de bord de ne définir aucun
+ en-tête HTTP <code>Content-Length</code>. Il est important de connaître ce
+ comportement, particulièrement lorsque httpd travaille derrière des
+ mandataires inverses avec mise en cache, ou lorsque httpd est configuré pour
+ utiliser <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> et <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> car
+ les réponses HTTP sans en-tête <code>Content-Length</code> peuvent ne pas
+ être mises en cache.</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="deflatecompressionlevel" id="deflatecompressionlevel">Directive</a> <a name="DeflateCompressionLevel" id="DeflateCompressionLevel">DeflateCompressionLevel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much compression do we apply to the output</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateCompressionLevel <var>value</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Zlib's default</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le niveau de compression que nous appliquons à la
+sortie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateCompressionLevel <var>valeur</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>La valeur par défaut de zlib</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateCompressionLevel</code> directive specifies
- what level of compression should be used, the higher the value,
- the better the compression, but the more CPU time is required to
- achieve this.</p>
- <p>The value must between 1 (less compression) and 9 (more compression).</p>
+ <p>La directive <code class="directive">DeflateCompressionLevel</code>
+ permet de spécifier le niveau de compression à utiliser ; plus
+ grande est la valeur, meilleure sera la compression, mais plus grand
+ sera aussi le temps CPU nécessaire pour effectuer le
+ traitement.</p>
+ <p>La valeur doit être comprise entre 1 (compression minimale) et 9
+ (compression maximale).</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="deflatefilternote" id="deflatefilternote">Directive</a> <a name="DeflateFilterNote" id="DeflateFilterNote">DeflateFilterNote</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Places the compression ratio in a note for logging</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateFilterNote [<var>type</var>] <var>notename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre le taux de compression sous la forme d'une note
+à des fins de journalisation</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateFilterNote [<var>type</var>] <var>nom de la note</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateFilterNote</code> directive
- specifies that a note about compression ratios should be attached
- to the request. The name of the note is the value specified for
- the directive. You can use that note for statistical purposes by
- adding the value to your <a href="../logs.html#accesslog">access log</a>.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"> DeflateFilterNote ratio
+ <p>La directive <code class="directive">DeflateFilterNote</code> permet de
+ spécifier qu'une note à propos du taux de compression doit être
+ attachée à la requête. Le nom de la note est passé sous la forme
+ d'un argument de la directive. Vous pouvez utiliser cette note à des
+ fins statistiques en enregistrant sa valeur dans votre <a href="../logs.html#accesslog">journal des accès</a>.</p>
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> DeflateFilterNote ratio
+
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog "logs/deflate_log" deflate</pre>
</div>
- <p>If you want to extract more accurate values from your logs, you
- can use the <var>type</var> argument to specify the type of data
- left as a note for logging. <var>type</var> can be one of:</p>
+ <p>Pour extraire des informations plus précises de vos journaux,
+ vous pouvez utiliser l'argument <var>type</var> pour spécifier le
+ type de données de la note enregistrée dans le journal.
+ <var>type</var> peut prendre une des valeurs suivantes :</p>
<dl>
<dt><code>Input</code></dt>
- <dd>Store the byte count of the filter's input stream in the note.</dd>
+ <dd>Enregistre dans la note la taille en octets du flux en entrée
+ du filtre.</dd>
<dt><code>Output</code></dt>
- <dd>Store the byte count of the filter's output stream in the note.</dd>
+ <dd>Enregistre dans la note la taille en octets du flux en sortie
+ du filtre.</dd>
<dt><code>Ratio</code></dt>
- <dd>Store the compression ratio (<code>output/input * 100</code>)
- in the note. This is the default, if the <var>type</var> argument
- is omitted.</dd>
+ <dd>Enregistre le taux de compression (<code>sortie/entrée *
+ 100</code>) dans la note. Il s'agit de la valeur par défaut si
+ l'argument <var>type</var> est omis.</dd>
</dl>
- <p>Thus you may log it this way:</p>
+ <p>Vous pouvez donc configurer votre journalisation de la manière
+ suivante :</p>
- <div class="example"><h3>
Accurate Logging</h3><pre class="prettyprint lang-config">DeflateFilterNote Input instream
+ <div class="example"><h3>
Journalisation détaillée</h3><pre class="prettyprint lang-config">DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="deflateinflatelimitrequestbody" id="deflateinflatelimitrequestbody">Directive</a> <a name="DeflateInflateLimitRequestBody" id="DeflateInflateLimitRequestBody">DeflateInflateLimitRequestBody</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size of inflated request bodies</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des corps de requête décompressés</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateLimitRequestBody<var>value</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None, but LimitRequestBody applies after deflation</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucune limite, mais LimitRequestBody s'applique après la
+compression</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">DeflateInflateLimitRequestBody</code> directive
- specifies the maximum size of an inflated request body. If it is unset,
- <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> is applied to the
- inflated body.</p>
+ <p>La directive
+ <code class="directive">DeflateInflateLimitRequestBody</code> permet de
+ spécifier la taille maximale d'un corps de requête décompressé. Si
+ elle n'est pas définie, c'est la valeur de la directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> qui s'applique au corps
+ de requête décompressé.</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="deflateinflateratioburst" id="deflateinflateratioburst">Directive</a> <a name="DeflateInflateRatioBurst" id="DeflateInflateRatioBurst">DeflateInflateRatioBurst</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of times the inflation ratio for request bodies
- can be crossed</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de fois que le ratio de décompression d'un
+corps de requête peut être dépassé</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateRatioBurst <var>value</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>3</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">DeflateInflateRatioBurst</code> directive
- specifies the maximum number of times the
- <code class="directive">DeflateInflateRatioLimit</code> can be crossed before
- terminating the request.</p>
+ <p>La directive <code class="directive">DeflateInflateRatioBurst</code>
+ permet de spécifier le nombre maximal de fois que la valeur de la
+ directive <code class="directive">DeflateInflateRatioLimit</code> peut être
+ dépassé avant l'arrêt du traitement 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="deflateinflateratiolimit" id="deflateinflateratiolimit">Directive</a> <a name="DeflateInflateRatioLimit" id="DeflateInflateRatioLimit">DeflateInflateRatioLimit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum inflation ratio for request bodies</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ratio de décompression maximum pour les corps de requêtes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateRatioLimit <var>value</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>200</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
+Apache</td></tr>
</table>
- <p>The <code class="directive">DeflateInflateRatioLimit</code> directive
- specifies the maximum ratio of deflated to inflated size of an
- inflated request body. This ratio is checked as the body is
- streamed in, and if crossed more than
- <code class="directive">DeflateInflateRatioBurst</code> times, the request
- will be terminated.</p>
+ <p>La directive <code class="directive">DeflateInflateRatioLimit</code>
+ permet de définir le ratio maximum entre la taille d'un corps de
+ requête compressé et sa taille décompressée. Ce ratio est vérifié au
+ fur et à mesure de
+ l'arrivée du corps de requête, et s'il est dépassé plus de
+ <code class="directive">DeflateInflateRatioBurst</code> fois, le traitement
+ de la requête est interrompu.</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="deflatememlevel" id="deflatememlevel">Directive</a> <a name="DeflateMemLevel" id="DeflateMemLevel">DeflateMemLevel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much memory should be used by zlib for compression</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateMemLevel <var>value</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité de mémoire utilisable par zlib pour la
+compression</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateMemLevel <var>valeur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateMemLevel 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateMemLevel</code> directive specifies
- how much memory should be used by zlib for compression
- (a value between 1 and 9).</p>
+ <p>La directive <code class="directive">DeflateMemLevel</code> permet de
+ spécifier la quantité de mémoire utilisable par zlib pour la
+ compression (une valeur comprise entre 1 et 9).</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="deflatewindowsize" id="deflatewindowsize">Directive</a> <a name="DeflateWindowSize" id="DeflateWindowSize">DeflateWindowSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Zlib compression window size</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateWindowSize <var>value</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille de la fenêtre de compression zlib</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateWindowSize <var>valeur</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateWindowSize 15</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
</table>
- <p>The <code class="directive">DeflateWindowSize</code> directive specifies the
- zlib compression window size (a value between 1 and 15). Generally, the
- higher the window size, the higher can the compression ratio be expected.</p>
+ <p>La directive <code class="directive">DeflateWindowSize</code> permet de
+ spécifier la fenêtre de compression zlib (une valeur comprise entre
+ 1 et 15). En général, plus grande sera la taille de la fenêtre, plus
+ grand sera le taux de compression auquel on pourra s'attendre.</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="modemstandard" id="modemstandard">Directive</a> <a name="ModemStandard" id="ModemStandard">ModemStandard</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modem standard to simulate</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Standard de modem à simuler</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ModemStandard V.21|V.26bis|V.32|V.34|V.92</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dialup</td></tr>
</table>
-<p>Specify what modem standard you wish to simulate.</p>
+<p>Cette directive permet de spécifier le standard de modem que vous
+souhaitez simuler.</p>
<pre class="prettyprint lang-config"><Location "/mysite">
ModemStandard "V.26bis"
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="directorycheckhandler" id="directorycheckhandler">Directive</a> <a name="DirectoryCheckHandler" id="DirectoryCheckHandler">DirectoryCheckHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle how this module responds when another handler is configured</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la réponse de ce module lorsqu'un autre
+gestionnaire est utilisé</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DirectoryCheckHandler On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DirectoryCheckHandler 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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in 2.4.8 and later. Releases prior to 2.4 implicitly
-act as if "DirectoryCheckHandler ON" was specified.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.8 du serveur HTTP
+Apache. Les versions antérieures à 2.4 se comportaient implicitement
+comme si "DirectoryCheckHandler ON" avait été spécifié.</td></tr>
</table>
- <p>The <code class="directive">DirectoryCheckHandler</code> directive determines
- whether <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> should check for directory indexes or
- add trailing slashes when some other handler has been configured for
- the current URL. Handlers can be set by directives such as
- <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> or by other modules at
- runtime. </p>
-
- <p> In releases prior to 2.4, this module did not take any action if any
- other handler was configured for a URL. This allows directory indexes to
- be served even when a <code class="directive">SetHandler</code> directive is
- specified for an entire directory, but it can also result in some conflicts
- with other modules.</p>
+ <p>La directive <code class="directive">DirectoryCheckHandler</code> permet
+ de faire en sorte que <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> recherche un index
+ de répertoire ou ajoute des slashes de fin lorsqu'un autre
+ gestionnaire à été défini pour l'URL considérée. Les gestionnaires
+ peuvent être définis à l'exécution via des directives telles que
+ <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou par d'autres
+ modules.</p>
+
+ <p>Dans les versions antérieures à 2.4, ce module ne modifiait pas
+ son comportement si un autre gestionnaire avait été défini pour
+ l'URL considérée. Ceci permettait de servir des index de répertoires
+ même si une directive <code class="directive">SetHandler</code> avait été
+ définie pour un répertoire entier, mais pouvait aussi être à
+ l'origine de conflits avec d'autres modules.</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="directoryindex" id="directoryindex">Directive</a> <a name="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of resources to look for when the client requests
-a directory</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liste des fichiers ressources à rechercher lorsque le
+client envoie une requête pour un répertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DirectoryIndex
- disabled | <var>local-url</var> [<var>local-url</var>] ...</code></td></tr>
+ disabled | <var>url locale</var> [<var>url locale</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DirectoryIndex index.html</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
</table>
- <p>The <code class="directive">DirectoryIndex</code> directive sets the
- list of resources to look for, when the client requests an index
- of the directory by specifying a / at the end of the directory
- name. <var>Local-url</var> is the (%-encoded) URL of a document on
- the server relative to the requested directory; it is usually the
- name of a file in the directory. Several URLs may be given, in
- which case the server will return the first one that it finds. If
- none of the resources exist and the <code>Indexes</code> option is
- set, the server will generate its own listing of the
- directory.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DirectoryIndex index.html</pre>
+ <p>La directive <code class="directive">DirectoryIndex</code> permet de
+ définir une liste de fichiers ressources à rechercher lorsqu'un
+ client envoie une requête pour l'index d'un répertoire, en ajoutant
+ un '/' à la fin du nom de ce dernier. <var>url locale</var> est
+ l'URL (codée avec caractères '%') d'un document du serveur, relative
+ au répertoire faisant l'objet de la requête ; il s'agit en général
+ du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont
+ fournies, le serveur renverra la première d'entre elles qui
+ correspond à une ressource existante. Si aucune ressource ne
+ correspond à la liste des URLs spécifiées, et si l'option
+ <code>Indexes</code> est définie, le serveur générera son propre
+ listing du répertoire.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DirectoryIndex index.html</pre>
</div>
- <p>then a request for <code>http://example.com/docs/</code> would
- return <code>http://example.com/docs/index.html</code> if it
- exists, or would list the directory if it did not.</p>
+ <p>Avec cette configuration, une requête pour l'URL
+ <code>http://example.com/docs/</code> renverrait au client la
+ ressource <code>http://example.com/docs/index.html</code> si elle
+ existe, ou provoquerait la génération du listing du répertoire si la
+ ressource n'existe pas.</p>
- <p>Note that the documents do not need to be relative to the
- directory;</p>
+ <p>Notez qu'il n'est pas nécessaire que les documents soient
+ relatifs au répertoire ;</p>
<pre class="prettyprint lang-config">DirectoryIndex index.html index.txt /cgi-bin/index.pl</pre>
- <p>would cause the CGI script <code>/cgi-bin/index.pl</code> to be
- executed if neither <code>index.html</code> or <code>index.txt</code>
- existed in a directory.</p>
+ <p>provoquerait l'exécution du script CGI
+ <code>/cgi-bin/index.pl</code> si aucun des fichiers
+ <code>index.html</code> ou <code>index.txt</code> n'existe dans le
+ répertoire considéré.</p>
- <p>A single argument of "disabled" prevents <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> from
- searching for an index. An argument of "disabled" will be interpreted
- literally if it has any arguments before or after it, even if they are "disabled"
- as well.</p>
+ <p>La spécification du seul argument "disabled" empêche
+ <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> de rechercher un index. Un argument
+ "disabled" sera interprété de manière littérale si d'autres
+ arguments sont présents avant ou après lui, même s'ils sont
+ eux-mêmes des arguments "disabled".</p>
- <p><strong>Note:</strong> Multiple <code class="directive">DirectoryIndex</code>
- directives within the <a href="../sections.html"><em>same context</em></a> will add
- to the list of resources to look for rather than replace:
+ <p><strong>Note :</strong>La définition de plusieurs directives
+ <code class="directive">DirectoryIndex</code> au sein d'un <a href="../sections.html"><em>même
+ contexte</em></a> permet d'ajouter des ressources à rechercher plutôt
+ que de remplacer celle déjà définies :
</p>
- <pre class="prettyprint lang-config"># Example A: Set index.html as an index page, then add index.php to that list as well.
+ <pre class="prettyprint lang-config"># Exemple A: définit index.html comme page d'index, ainsi qu'index.php.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex index.php
</Directory>
-# Example B: This is identical to example A, except it's done with a single directive.
+# Exemple B: identique à l'exemple A, mais avec une seule directive.
<Directory "/foo">
DirectoryIndex index.html index.php
</Directory>
-# Example C: To replace the list, you must explicitly reset it first:
-# In this example, only index.php will remain as an index resource.
+# Exemple C: pour remplacer la liste des pages d'index par une autre,
+# vous devez tout d'abord supprimer la première liste : dans l'exemple
+# suivant, il ne restera qu'index.php comme page d'index.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex disabled
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="directoryindexredirect" id="directoryindexredirect">Directive</a> <a name="DirectoryIndexRedirect" id="DirectoryIndexRedirect">DirectoryIndexRedirect</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures an external redirect for directory indexes.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une redirection externe pour les index de
+répertoires.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DirectoryIndexRedirect on | off | permanent | temp | seeother |
<var>3xx-code</var>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.14 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.14</td></tr>
</table>
- <p>By default, the <code class="directive">DirectoryIndex</code> is selected
- and returned transparently to the client. <code class="directive">DirectoryIndexRedirect</code> causes an external redirect
- to instead be issued.</p>
+ <p>Par défaut, c'est la page définie par la directive
+ <code class="directive">DirectoryIndex</code> qui est sélectionnée et
+ renvoyée de manière transparente au client. La directive
+ <code class="directive">DirectoryIndexRedirect</code> permet de rediriger le
+ client via une redirection de type 3xx.</p>
- <p>The argument can be:</p>
+ <p>Les arguments acceptés sont :</p>
<ul>
- <li><code>on</code>: issues a 302 redirection to the index resource.</li>
- <li><code>off</code>: does not issue a redirection. This is the legacy behaviour of mod_dir.</li>
- <li><code>permanent</code>: issues a 301 (permanent) redirection to the index resource.</li>
- <li><code>temp</code>: this has the same effect as <code>on</code></li>
- <li><code>seeother</code>: issues a 303 redirection (also known as "See Other") to the index resource.</li>
- <li><var>3xx-code</var>: issues a redirection marked by the chosen 3xx code.</li>
+ <li><code>on</code> : envoie une redirection 302 vers l'index choisi.</li>
+ <li><code>off</code> : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.</li>
+ <li><code>permanent</code> : envoie une redirection 301 (permanent) vers l'index choisi.</li>
+ <li><code>temp</code> : ceci est équivalent à <code>on</code></li>
+ <li><code>seeother</code> : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.</li>
+ <li><var>3xx-code</var> : envoie une redirection accompagnée du code 3xx choisi.</li>
</ul>
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DirectoryIndexRedirect on</pre>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DirectoryIndexRedirect on</pre>
</div>
- <p>A request for <code>http://example.com/docs/</code> would
- return a temporary redirect to <code>http://example.com/docs/index.html</code>
- if it exists.</p>
+ <p>Une requête pour <code>http://example.com/docs/</code> se
+ solderait par une redirection temporaire vers
+ <code>http://example.com/docs/index.html</code> si cette ressource
+ existe.</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="directoryslash" id="directoryslash">Directive</a> <a name="DirectorySlash" id="DirectorySlash">DirectorySlash</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle trailing slash redirects on or off</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/Désactivation de la redirection "slash de
+fin"</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DirectorySlash On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DirectorySlash 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>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
</table>
- <p>The <code class="directive">DirectorySlash</code> directive determines whether
- <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> should fixup URLs pointing to a directory or
- not.</p>
+ <p>La directive <code class="directive">DirectorySlash</code> permet de
+ déterminer si <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> doit corriger ou non les URLs
+ pointant vers un répertoire.</p>
- <p>Typically if a user requests a resource without a trailing slash, which
- points to a directory, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> redirects him to the same
- resource, but <em>with</em> trailing slash for some good reasons:</p>
+ <p>En général, si un utilisateur envoie une requête pour une
+ ressource sans slash de fin, cette ressource représentant un
+ répertoire, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> le redirige vers la même
+ ressource, mais <em>en ajoutant</em> un slash de fin, et ceci pour
+ plusieurs bonnes raisons :</p>
<ul>
- <li>The user is finally requesting the canonical URL of the resource</li>
- <li><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> works correctly. Since it doesn't emit
- the path in the link, it would point to the wrong path.</li>
- <li><code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> will be evaluated
- <em>only</em> for directories requested with trailing slash.</li>
- <li>Relative URL references inside html pages will work correctly.</li>
+ <li>La requête de l'utilisateur contiendra finalement l'URL
+ canonique de la ressource</li>
+ <li><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> fonctionnera correctement. Comme
+ il n'indique pas le chemin dans le lien, le chemin de l'URL serait
+ incorrect.</li>
+ <li>La directive <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> n'est évaluée
+ <em>que</em> pour les répertoires se terminant par un slash.</li>
+ <li>Les références à des URLs relatives dans les pages html
+ fonctionneront alors correctement.</li>
</ul>
- <p>If you don't want this effect <em>and</em> the reasons above don't
- apply to you, you can turn off the redirect as shown below. However,
- be aware that there are possible security implications to doing
- this.</p>
+ <p>Si vous ne souhaitez pas voir ces effets, <em>et</em> si
+ les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous
+ pouvez désactiver la redirection comme indiqué ci-dessous.
+ Gardez cependant à l'esprit que ceci peut avoir des répercutions en
+ matière de sécurité.</p>
- <pre class="prettyprint lang-config"># see security warning below!
+ <pre class="prettyprint lang-config"># voir l'avertissement de sécurité ci-dessous !
<Location "/some/path">
DirectorySlash Off
SetHandler some-handler
</Location></pre>
- <div class="warning"><h3>Security Warning</h3>
- <p>Turning off the trailing slash redirect may result in an information
- disclosure. Consider a situation where <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> is
- active (<code>Options +Indexes</code>) and <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> is set to a valid resource (say,
- <code>index.html</code>) and there's no other special handler defined for
- that URL. In this case a request with a trailing slash would show the
- <code>index.html</code> file. <strong>But a request without trailing slash
- would list the directory contents</strong>.</p>
+ <div class="warning"><h3>Avertissement de sécurité</h3>
+ <p>La désactivation de la redirection "slash de fin" peut entraîner
+ la divulgation d'informations. Considérons la situation où
+ <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> est actif (<code>Options
+ +Indexes</code>), où la directive <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> a pour valeur une ressource valide (par
+ exemple <code>index.html</code>), et où aucun gestionnaire
+ particulier n'a été défini pour cette URL. Dans ce cas, une requête
+ avec slash de fin afficherait le contenu du fichier
+ <code>index.html</code> ; <strong>par contre, une requête sans slash
+ de fin afficherait un listing du contenu du
+ répertoire</strong>.</p>
</div>
- <p>Also note that some browsers may erroneously change POST requests into GET
- (thus discarding POST data) when a redirect is issued.</p>
+ <p>Notez aussi que certains navigateurs peuvent modifier par erreur
+ des requêtes POST en requêtes GET lors d'une redirection, les
+ données POST étant alors perdues.</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="fallbackresource" id="fallbackresource">Directive</a> <a name="FallbackResource" id="FallbackResource">FallbackResource</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a default URL for requests that don't map to a file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FallbackResource disabled | <var>local-url</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>disabled - httpd will return 404 (Not Found)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une URL par défaut pour les requêtes qui ne ciblent
+aucun fichier</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FallbackResource disabled | <var>url-locale</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Désactivé - httpd renvoie un code d'erreur 404 (Not Found)</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The <code>disabled</code> argument is available in version 2.4.4 and
-later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'argument <code>disabled</code> est disponible depuis la
+version 2.4.4 du serveur HTTP Apache</td></tr>
</table>
- <p>Use this to set a handler for any URL that doesn't map to anything
- in your filesystem, and would otherwise return HTTP 404 (Not Found).
- For example</p>
+ <p>Cette directive permet de définir un traitement pour toute URL
+ qui ne correspond à aucune ressource de votre système de fichiers,
+ et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404
+ (Not Found).
+ Par exemple</p>
<pre class="prettyprint lang-config">FallbackResource /not-404.php</pre>
- <p>will cause requests for non-existent files to be handled by
- <code>not-404.php</code>, while requests for files that exist
- are unaffected.</p>
- <p>It is frequently desirable to have a single file or resource
- handle all requests to a particular directory, except those requests
- that correspond to an existing file or script. This is often
- referred to as a 'front controller.'</p>
- <p>In earlier versions of httpd, this effect typically required
- <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and
- <code>-d</code> tests for file and directory existence. This now
- requires only one line of configuration.</p>
+ <p>fait en sorte que les requêtes ne correspondant à aucun fichier
+ soient traitées par <code>non-404.php</code>, sans affecter les
+ requêtes pour des fichiers existants.</p>
+ <p>Il est souvent souhaitable qu'un seul fichier ou ressource traite
+ toutes les requêtes à destination d'un répertoire
+ particulier, sauf pour les requêtes qui correspondent à un fichier
+ ou script existant. On y fait souvent référence sous le terme
+ 'contrôleur frontal'.</p>
+ <p>Dans les versions plus anciennes de httpd, cet effet nécessitait
+ en général <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, et l'utilisation des tests
+ conditionnels <code>-f</code> et <code>-d</code> pour vérifier
+ l'existence des fichiers et répertoires. Maintenant, une seule ligne
+ de configuration est nécessaire.</p>
<pre class="prettyprint lang-config">FallbackResource /index.php</pre>
- <p>Existing files, such as images, css files, and so on, will be
- served normally.</p>
- <p>Use the <code>disabled</code> argument to disable that feature
- if inheritance from a parent directory is not desired.</p>
- <p>In a sub-URI, such as <em>http://example.com/blog/</em> this
- <em>sub-URI</em> has to be supplied as <var>local-url</var>:</p>
+ <p>Les fichiers existants comme des images, des fichiers css, etc...
+ seront traités normalement.</p>
+ <p>Utilisez l'argument <code>disabled</code> pour désactiver cette
+ fonctionnalité si l'héritage d'un répertoire parent n'est pas
+ souhaité.</p>
+ <p>Pour un URI intermédiaire tel que
+ <em>http://example.com/blog/</em>, cet URI intermédiaire doit être
+ spécifié en tant que <var>url-locale</var> :</p>
<pre class="prettyprint lang-config"><Directory "/web/example.com/htdocs/blog">
FallbackResource /blog/index.php
</Directory>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="dumpioinput" id="dumpioinput">Directive</a> <a name="DumpIOInput" id="DumpIOInput">DumpIOInput</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all input data to the error log</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre toutes les entrées dans le journal des
+erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DumpIOInput On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DumpIOInput 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr>
</table>
- <p>Enable dumping of all input.</p>
+ <p>Active la journalisation de toutes les entrées.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">DumpIOInput On</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">DumpIOInput On</pre>
</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="dumpiooutput" id="dumpiooutput">Directive</a> <a name="DumpIOOutput" id="DumpIOOutput">DumpIOOutput</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dump all output data to the error log</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre toutes les sorties dans le journal des
+erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DumpIOOutput On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DumpIOOutput 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dumpio</td></tr>
</table>
- <p>Enable dumping of all output.</p>
+ <p>Active la journalisation de toutes les sorties.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">DumpIOOutput On</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">DumpIOOutput On</pre>
</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="protocolecho" id="protocolecho">Directive</a> <a name="ProtocolEcho" id="ProtocolEcho">ProtocolEcho</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turn the echo server on or off</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive le serveur d'écho</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProtocolEcho On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProtocolEcho 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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_echo</td></tr>
</table>
- <p>The <code class="directive">ProtocolEcho</code> directive enables or
- disables the echo server.</p>
+ <p>La directive <code class="directive">ProtocolEcho</code> permet d'activer
+ ou de désactiver le serveur d'écho.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">ProtocolEcho On</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">ProtocolEcho On</pre>
</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="passenv" id="passenv">Directive</a> <a name="PassEnv" id="PassEnv">PassEnv</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Passes environment variables from the shell</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PassEnv <var>env-variable</var> [<var>env-variable</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Transmet des variables d'environnement depuis le
+shell</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PassEnv <var>var-env</var> [<var>var-env</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_env</td></tr>
</table>
- <p>Specifies one or more native system environment variables to make available
- as internal environment variables, which are available to Apache HTTP Server modules
- as well as propagated to CGI scripts and SSI pages. Values come from the
- native OS environment of the shell which invoked the
- <code class="program"><a href="../programs/httpd.html">httpd</a></code> process.</p>
+ <p>Cette directive permet de spécifier quelles variables
+ d'environnement système natives doivent être disponibles en tant que
+ variables d'environnement internes pour les modules du serveur HTTP
+ Apache, et propagées vers les scripts CGI et les pages SSI. Leurs
+ valeurs sont issues de l'environnement natif de l'OS associé au
+ shell qui a invoqué le processus <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">PassEnv LD_LIBRARY_PATH</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">PassEnv LD_LIBRARY_PATH</pre>
</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="setenv" id="setenv">Directive</a> <a name="SetEnv" id="SetEnv">SetEnv</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnv <var>env-variable</var> [<var>value</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnv <var>var-env</var> [<var>valeur</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_env</td></tr>
</table>
- <p>Sets an internal environment variable, which is then available to Apache
- HTTP Server modules, and passed on to CGI scripts and SSI pages.</p>
+ <p>Définit une variable d'environnement interne, cette dernière étant
+ ensuite disponible pour les modules du serveur HTTP Apache et
+ transmise aux scripts CGI et aux pages SSI.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SetEnv SPECIAL_PATH /foo/bin</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SetEnv SPECIAL_PATH /foo/bin</pre>
</div>
- <p> If you omit the <var>value</var> argument, the variable is set to
- an empty string.</p>
+ <p>Si l'argument <var>valeur</var> est absent, la variable est
+ définie à la valeur d'une chaîne vide.</p>
- <div class="note"><p>The internal environment variables set by this directive are set
- <em>after</em> most early request processing directives are run, such as access
- control and URI-to-filename mapping. If the environment variable you're
- setting is meant as input into this early phase of processing such as the
- <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directive, you should
- instead set the environment variable with
- <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>.</p>
+ <div class="note"><p>Les variables d'environnement internes définies par cette
+ directive le sont <em>après</em> l'exécution de la plupart des
+ directives du traitement initial des requêtes, comme les contrôles
+ d'accès et la mise en correspondance des URIs avec les noms de
+ fichiers. Si la variable d'environnement est sensée intervenir au
+ cours de cette phase initiale du traitement, par exemple pour la
+ directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>,
+ vous devez plutôt utiliser la directive <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> pour définir cette
+ variable.</p>
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../env.html">Environment Variables</a></li>
+<li><a href="../env.html">Variables d'environnement</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="unsetenv" id="unsetenv">Directive</a> <a name="UnsetEnv" id="UnsetEnv">UnsetEnv</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes variables from the environment</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnsetEnv <var>env-variable</var> [<var>env-variable</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime des variables de l'environnement</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnsetEnv <var>var-env</var> [<var>var-env</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_env</td></tr>
</table>
- <p>Removes one or more internal environment variables from those passed
- on to CGI scripts and SSI pages.</p>
+ <p>Supprime une ou plusieurs variables d'environnement internes parmi celles
+ qui sont transmises aux scripts CGI et aux pages SSI.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">UnsetEnv LD_LIBRARY_PATH</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">UnsetEnv LD_LIBRARY_PATH</pre>
</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="example" id="example">Directive</a> <a name="Example" id="Example">Example</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Demonstration directive to illustrate the Apache module
-API</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directive de démonstration pour illustrer l'API des modules
+Apache</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Example</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>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_example_hooks</td></tr>
</table>
- <p>The <code class="directive">Example</code> directive just sets a demonstration
- flag which the example module's content handler displays. It
- takes no arguments. If you browse to an URL to which the
- example-hooks content-handler applies, you will get a display of the
- routines within the module and how and in what order they were
- called to service the document request. The effect of this
- directive one can observe under the point "<code>Example
+ <p>La directive <code class="directive">Example</code> n'a pour fonction que
+ de définir un drapeau de démonstration que le gestionnaire de
+ contenu du module example_hooks va afficher. Elle ne possède aucun
+ argument. Si vous naviguez vers une URL à laquelle le gestionnaire
+ de contenu example_hooks s'applique, vous verrez s'afficher les routines
+ du module, ainsi que l'ordre dans lequel elles ont été appelées pour
+ servir le document demandé. On peut observer l'effet de cette
+ directive dans la phrase "<code>Example
directive declared here: YES/NO</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="expiresactive" id="expiresactive">Directive</a> <a name="ExpiresActive" id="ExpiresActive">ExpiresActive</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables generation of <code>Expires</code>
-headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d'en-têtes
+<code>Expires</code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresActive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExpiresActive 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
</table>
- <p>This directive enables or disables the generation of the
- <code>Expires</code> and <code>Cache-Control</code> headers for
- the document realm in question. (That is, if found in an
- <code>.htaccess</code> file, for instance, it applies only to
- documents generated from that directory.) If set to
- <code>Off</code>, the headers will not be generated for any
- document in the realm (unless overridden at a lower level, such as
- an <code>.htaccess</code> file overriding a server config
- file). If set to <code>On</code>, the headers will be added to
- served documents according to the criteria defined by the
- <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> and
- <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>
- directives (<em>q.v.</em>).</p>
+ <p>Cette directive permet d'activer ou de désactiver la génération
+ des en-têtes <code>Expires</code> et <code>Cache-Control</code> pour
+ les documents concernés ; en d'autres termes, si cette directive se
+ trouve dans un fichier <code>.htaccess</code>, par exemple, elle ne
+ s'applique qu'aux documents générés à partir du répertoire
+ considéré. Si elle est définie à <code>Off</code>, les en-têtes ne
+ seront générés pour aucun document du domaine considéré (sauf
+ surcharge de la configuration à un niveau inférieur, comme un
+ fichier <code>.htaccess</code> qui l'emporterait sur le fichier de
+ configuration du serveur). Si elle est définie à <code>On</code>,
+ les en-têtes seront ajoutés aux documents servis en fonction des
+ critères définis par les directives <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> et <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> (<em>voir plus
+ loin</em>).</p>
- <p>Note that this directive does not guarantee that an
- <code>Expires</code> or <code>Cache-Control</code> header will be
- generated. If the criteria aren't met, no header will be sent, and
- the effect will be as though this directive wasn't even
- specified.</p>
+ <p>Notez que cette directive ne permet pas de garantir qu'un en-tête
+ <code>Expires</code> ou <code>Cache-Control</code> sera généré. Si
+ les critères ne sont pas respectés, aucun en-tête ne sera généré, et
+ la directive produira le même effet que si elle n'avait pas été
+ définie.</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="expiresbytype" id="expiresbytype">Directive</a> <a name="ExpiresByType" id="ExpiresByType">ExpiresByType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Value of the <code>Expires</code> header configured
-by MIME type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresByType <var>MIME-type</var>
-<var><code>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définition de la valeur de l'en-tête <code>Expires</code>
+en fonction du type MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresByType <var>type MIME</var>
+<var><code>secondes</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
</table>
- <p>This directive defines the value of the <code>Expires</code>
- header and the <code>max-age</code> directive of the
- <code>Cache-Control</code> header generated for documents of the
- specified type (<em>e.g.</em>, <code>text/html</code>). The second
- argument sets the number of seconds that will be added to a base
- time to construct the expiration date. The <code>Cache-Control:
- max-age</code> is calculated by subtracting the request time from
- the expiration date and expressing the result in seconds.</p>
+ <p>Cette directive permet de définir la valeur de l'en-tête
+ <code>Expires</code> et de la directive <code>max-age</code> de
+ l'en-tête <code>Cache-Control</code> générés pour les documents du
+ type MIME spécifié (par exemple, <code>text/html</code>). Le second
+ argument définit le nombre de secondes qui seront ajoutées à un
+ temps de base pour calculer la date d'expiration.
+ <code>Cache-Control: max-age</code> se calcule en soustrayant la
+ date de la requête de la date d'expiration et s'exprime en
+ secondes.</p>
- <p>The base time is either the last modification time of the
- file, or the time of the client's access to the document. Which
- should be used is specified by the
- <code><var><code></var></code> field; <code>M</code>
- means that the file's last modification time should be used as
- the base time, and <code>A</code> means the client's access
- time should be used.</p>
+ <p>Le champ <code><var><code></var></code> permet de spécifier
+ quel temps doit être utilisé comme temps de base; <code>M</code>
+ signifie que c'est la date
+ de dernière modification du fichier qui doit être utilisée comme
+ temps de base, alors que <code>A</code> signifie que c'est le moment
+ où le client a accédé au document qui doit être utilisé comme temps
+ de base.</p>
- <p>The difference in effect is subtle. If <code>M</code> is used,
- all current copies of the document in all caches will expire at
- the same time, which can be good for something like a weekly
- notice that's always found at the same URL. If <code>A</code> is
- used, the date of expiration is different for each client; this
- can be good for image files that don't change very often,
- particularly for a set of related documents that all refer to
- the same images (<em>i.e.</em>, the images will be accessed
- repeatedly within a relatively short timespan).</p>
+ <p>La différence d'effet est subtile. Si on utilise <code>M</code>,
+ toutes les copies existantes du document dans tous les caches
+ expireront au même moment, ce qui peut convenir par exemple pour une
+ notice hebdomadaire qui correspond toujours à la même URL. Si on
+ utilise <code>A</code>, la date d'expiration sera différente pour
+ chaque client, ce qui peut convenir pour des fichiers d'images qui
+ ne changent pas très souvent, et en particulier pour un ensemble de
+ documents en relation qui se réfèrent tous aux mêmes images (ces
+ images sont alors accédées de manière répétitive dans un intervalle
+ de temps assez court).</p>
- <div class="example"><h3>Example:</h3><pre class="prettyprint lang-config"># enable expirations
+ <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config"># active la génération des en-têtes Expires
ExpiresActive On
-# expire GIF images after a month in the client's cache
+# les images GIF expirent au bout d'un mois dans le cache du
+# client
ExpiresByType image/gif A2592000
-# HTML documents are good for a week from the
-# time they were changed
+# les documents HTML restent valables une semaine après leur date
+# de dernière modification
ExpiresByType text/html M604800</pre>
</div>
- <p>Note that this directive only has effect if
- <code>ExpiresActive On</code> has been specified. It overrides,
- for the specified MIME type <em>only</em>, any expiration date
- set by the <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>
- directive.</p>
+ <p>Notez que cette directive ne produit d'effet que si
+ <code>ExpiresActive On</code> a été spécifié. Elle l'emporte, mais
+ <em>seulement</em> pour le type MIME spécifié, sur toute date
+ d'expiration définie par la directive <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>.</p>
- <p>You can also specify the expiration time calculation using
- an <a href="#AltSyn">alternate syntax</a>, described earlier in
- this document.</p>
+ <p>Vous pouvez aussi définir le mode de calcul de la date
+ d'expiration en utilisant une <a href="#AltSyn">syntaxe
+ alternative</a>, comme décrit plus haut dans ce document.</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="expiresdefault" id="expiresdefault">Directive</a> <a name="ExpiresDefault" id="ExpiresDefault">ExpiresDefault</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default algorithm for calculating expiration time</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresDefault <var><code>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mode de calcul par défaut de la date
+d'expiration</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresDefault <var><code>secondes</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
</table>
- <p>This directive sets the default algorithm for calculating the
- expiration time for all documents in the affected realm. It can be
- overridden on a type-by-type basis by the <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> directive. See the
- description of that directive for details about the syntax of the
- argument, and the <a href="#AltSyn">alternate syntax</a>
- description as well.</p>
+ <p>Cette directive permet de définir le mode de calcul par défaut de
+ la date d'expiration pour tous les documents du domaine considéré.
+ Elle peut être annulée pour certains types de documents par la
+ directive <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code>. Voir la description
+ de cette dernière directive pour plus de détails à propos de la
+ syntaxe de l'argument, ainsi que la description de la <a href="#AltSyn">syntaxe alternative</a>.</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="extfilterdefine" id="extfilterdefine">Directive</a> <a name="ExtFilterDefine" id="ExtFilterDefine">ExtFilterDefine</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define an external filter</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtFilterDefine <var>filtername</var> <var>parameters</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit un filtre externe</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtFilterDefine <var>nom_filtre</var> <var>paramètres</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ext_filter</td></tr>
</table>
- <p>The <code class="directive">ExtFilterDefine</code> directive defines the
- characteristics of an external filter, including the program to
- run and its arguments.</p>
-
- <p><var>filtername</var> specifies the name of the filter being
- defined. This name can then be used in <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>
- directives. It must be unique among all registered filters.
- <em>At the present time, no error is reported by the
- register-filter API, so a problem with duplicate names isn't
- reported to the user.</em></p>
-
- <p>Subsequent parameters can appear in any order and define the
- external command to run and certain other characteristics. The
- only required parameter is <code>cmd=</code>. These parameters
- are:</p>
+ <p>La directive <code class="directive">ExtFilterDefine</code>
+ définit les caractéristiques d'un filtre externe, et en particulier
+ le programme à exécuter ainsi que ses arguments.</p>
+
+ <p><var>nom_filtre</var> spécifie le nom du filtre en cours de
+ définition. On peut ensuite utiliser ce nom pour référencer le
+ filtre dans les directives <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>. Il doit être unique parmi les noms de
+ tous les filtres enregistrés. <em>Pour le moment, aucune erreur
+ n'est signalée par l'API register-filter, si bien qu'un problème de
+ noms dupliqués ne sera pas porté à la connaissance de
+ l'utilisateur.</em></p>
+
+ <p>Viennent ensuite un ou plusieurs paramètres dans un ordre
+ indéfini, qui permettent de spécifier la commande externe à exécuter
+ et certaines autres caractéristiques. Le seul paramètre obligatoire
+ est <code>cmd=</code>. Voici la liste de ces paramètres :</p>
<dl>
- <dt><code>cmd=<var>cmdline</var></code></dt>
-
- <dd>The <code>cmd=</code> keyword allows you to specify the
- external command to run. If there are arguments after the
- program name, the command line should be surrounded in
- quotation marks (<em>e.g.</em>, <code>cmd="<var>/bin/mypgm</var>
- <var>arg1</var> <var>arg2</var>"</code>.) Normal shell quoting is
- not necessary since the program is run directly, bypassing the shell.
- Program arguments are blank-delimited. A backslash can be used to
- escape blanks which should be part of a program argument. Any
- backslashes which are part of the argument must be escaped with
- backslash themselves. In addition to the standard CGI environment
- variables, DOCUMENT_URI, DOCUMENT_PATH_INFO, and
- QUERY_STRING_UNESCAPED will also be set for the program.</dd>
+ <dt><code>cmd=<var>ligne de commande</var></code></dt>
+
+ <dd>Le mot-clé <code>cmd=</code> spécifie la commande
+ externe à exécuter. Si la ligne de commande comporte des
+ arguments, elle doit être entourée de guillemets (par exemple
+ <code>cmd="<var>/bin/mypgm</var> <var>arg1</var>
+ <var>arg2</var>"</code>). Les guillemets habituels du shell ne
+ sont pas nécessaires car le programme est lancé directement, sans
+ passer par le shell. Les arguments du programme doivent être
+ séparés par des espaces. Si un argument contient des espaces, ces
+ derniers doivent être échappés par un antislash '\'. Si un
+ argument contient des antislashes '\', ces derniers doivent être
+ eux-mêmes échappés par un antislash '\'. Outre les variables
+ d'environnement CGI standards, les variables DOCUMENT_URI,
+ DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
+ définies pour le programme.</dd>
<dt><code>mode=<var>mode</var></code></dt>
- <dd>Use <code>mode=output</code> (the default) for filters which
- process the response. Use <code>mode=input</code> for filters
- which process the request. <code>mode=input</code> is available
- in Apache 2.1 and later.</dd>
+ <dd>Utilisez <code>mode=output</code> (valeur par défaut) pour les
+ filtres qui traitent les réponses. Utilisez
+ <code>mode=input</code> pour les filtres qui traitent les
+ requêtes. <code>mode=input</code> est disponible depuis la version
+ 2.1 d'Apache.</dd>
- <dt><code>intype=<var>imt</var></code></dt>
+ <dt><code>intype=<var>type MIME</var></code></dt>
- <dd>This parameter specifies the internet media type (<em>i.e.</em>,
- MIME type) of documents which should be filtered. By default,
- all documents are filtered. If <code>intype=</code> is
- specified, the filter will be disabled for documents of other
- types.</dd>
+ <dd>Ce paramètre spécifie le type de médium Internet
+ (c'est à dire le type MIME) des documents qui doivent être
+ filtrés. Par défaut, tous les documents sont filtrés. Aucun des
+ documents possédant un type MIME autre que celui spécifié par
+ <code>intype=</code> ne sera filtré.</dd>
- <dt><code>outtype=<var>imt</var></code></dt>
+ <dt><code>outtype=<var>type MIME</var></code></dt>
- <dd>This parameter specifies the internet media type (<em>i.e.</em>,
- MIME type) of filtered documents. It is useful when the
- filter changes the internet media type as part of the
- filtering operation. By default, the internet media type is
- unchanged.</dd>
+ <dd>Ce paramètre spécifie le type de médium Internet
+ (c'est à dire le type MIME) des documents filtrés. Il intervient
+ lorsque les opérations de filtrage comprennent une modification du
+ type MIME. Par défaut, le type MIME n'est pas modifié.</dd>
<dt><code>PreservesContentLength</code></dt>
- <dd>The <code>PreservesContentLength</code> keyword specifies
- that the filter preserves the content length. This is not the
- default, as most filters change the content length. In the
- event that the filter doesn't modify the length, this keyword
- should be specified.</dd>
+ <dd>Le mot-clé <code>PreservesContentLength</code> indique que le
+ filtre doit conserver la taille du contenu. Ce n'est pas le
+ comportement par défaut, car la plupart des filtres modifient cette
+ taille. Ce mot-clé doit être spécifié si le filtre ne doit pas
+ modifier la taille du contenu.</dd>
- <dt><code>ftype=<var>filtertype</var></code></dt>
+ <dt><code>ftype=<var>type de filtre</var></code></dt>
- <dd>This parameter specifies the numeric value for filter type
- that the filter should be registered as. The default value,
- AP_FTYPE_RESOURCE, is sufficient in most cases. If the filter
- needs to operate at a different point in the filter chain than
- resource filters, then this parameter will be necessary. See
- the AP_FTYPE_foo definitions in util_filter.h for appropriate
- values.</dd>
+ <dd>Ce paramètre spécifie une valeur numérique
+ représentant le type de filtre sous lequel le filtre doit être
+ enregistré. La valeur par défaut, AP_FTYPE_RESOURCE, convient dans
+ la plupart des situations. Ce paramètre devient nécessaire dès lors
+ que le filtre doit opérer à un autre point de la chaîne de filtrage
+ que les filtres de ressources.
+ Voir les définitions de AP_FTYPE_...
+ dans util_filter.h pour trouver une valeur appropriée.</dd>
<dt><code>disableenv=<var>env</var></code></dt>
- <dd>This parameter specifies the name of an environment variable
- which, if set, will disable the filter.</dd>
+ <dd>Ce paramètre spécifie le nom d'une variable
+ d'environnement qui, si elle est définie, va désactiver le
+ filtre.</dd>
<dt><code>enableenv=<var>env</var></code></dt>
- <dd>This parameter specifies the name of an environment variable
- which must be set, or the filter will be disabled.</dd>
+ <dd>Ce paramètre spécifie le nom d'une variable
+ d'environnement qui doit être définie pour que le filtre ne soit
+ pas désactivé.</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="extfilteroptions" id="extfilteroptions">Directive</a> <a name="ExtFilterOptions" id="ExtFilterOptions">ExtFilterOptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> options</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les options de
+<code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtFilterOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtFilterOptions NoLogStderr</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ext_filter</td></tr>
</table>
- <p>The <code class="directive">ExtFilterOptions</code> directive specifies
- special processing options for <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>.
- <var>Option</var> can be one of</p>
+ <p>La directive <code class="directive">ExtFilterOptions</code>
+ spécifie des options de traitement particulières pour
+ <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>. Les arguments <var>option</var>
+ peuvent contenir :</p>
<dl>
<dt><code>LogStderr | NoLogStderr</code></dt>
- <dd>The <code>LogStderr</code> keyword specifies that
- messages written to standard error by the external filter
- program will be saved in the Apache error log.
- <code>NoLogStderr</code> disables this feature.</dd>
+ <dd>Le mot-clé <code>LogStderr</code> indique que les messages
+ envoyés par le programme de filtrage externe sur la sortie
+ d'erreurs standard doivent être enregistrés dans le journal des
+ erreurs d'Apache. <code>NoLogStderr</code> inverse ce
+ comportement.</dd>
<dt><code>Onfail=[abort|remove]</code></dt>
- <dd>Determines how to proceed if the external filter program
- cannot be started. With <code>abort</code> (the default value)
- the request will be aborted. With <code>remove</code>, the
- filter is removed and the request continues without it.</dd>
+ <dd>Indique la marche à suivre si le programme de filtrage externe
+ ne peut pas démarrer. Avec <code>abort</code> (la valeur par
+ défaut), le traitement de la requête sera abandonné. Avec <code>remove</code>, le
+ filtre est supprimé, et le traitement de la requête se poursuit
+ sans lui.</dd>
</dl>
<pre class="prettyprint lang-config">ExtFilterOptions LogStderr</pre>
- <p>Messages written to the filter's standard error will be stored
- in the Apache error log.</p>
+ <p>Les messages envoyés vers la sortie d'erreurs standard du filtre
+ seront enregistrés dans le journal des erreurs d'Apache.</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="cachefile" id="cachefile">Directive</a> <a name="CacheFile" id="CacheFile">CacheFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cache a list of file handles at startup time</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en cache une liste de gestionnaires de fichiers au
+démarrage</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheFile <var>chemin_fichier</var> [<var>chemin fichier</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_file_cache</td></tr>
</table>
- <p>The <code class="directive">CacheFile</code> directive opens handles to
- one or more files (given as whitespace separated arguments) and
- places these handles into the cache at server startup
- time. Handles to cached files are automatically closed on a server
- shutdown. When the files have changed on the filesystem, the
- server should be restarted to re-cache them.</p>
+ <p>La directive <code class="directive">CacheFile</code> associe
+ des gestionnaires à un ou plusieurs fichiers (séparés par des
+ espaces), et place ceux-ci dans le cache au démarrage du
+ serveur. Les gestionnaires des fichiers mis en cache sont
+ automatiquement fermés à l'arrêt du serveur. Lorsqu'un ou plusieurs
+ fichiers ont été modifiés sur disque, le serveur doit être redémarré
+ afin que les modifications soient prises en compte par le cache.</p>
- <p>Be careful with the <var>file-path</var> arguments: They have
- to literally match the filesystem path Apache's URL-to-filename
- translation handlers create. We cannot compare inodes or other
- stuff to match paths through symbolic links <em>etc.</em>
- because that again would cost extra <code>stat()</code> system
- calls which is not acceptable. This module may or may not work
- with filenames rewritten by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> or
+ <p>Soyez prudent avec les arguments <var>chemin_fichier</var> : ils
+ doivent correspondre exactement au chemin du système de fichier que
+ créent les gestionnaires de traduction URL-vers-nom-fichier
+ d'Apache. On ne peut pas comparer des inodes ou autres identifiants
+ pour mettre en correspondance des chemins à l'aide de liens
+ symboliques <em>(etc...)</em>, car là encore, ceci nécessiterait un
+ appel à <code>stat()</code> supplémentaire, ce qui est inacceptable.
+ Il n'est pas garanti que ce module fonctionne avec des noms de
+ fichiers réécrits par <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> ou
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">CacheFile /usr/local/apache/htdocs/index.html</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">CacheFile /usr/local/apache/htdocs/index.html</pre>
</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="mmapfile" id="mmapfile">Directive</a> <a name="MMapFile" id="MMapFile">MMapFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map a list of files into memory at startup time</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MMapFile <var>file-path</var> [<var>file-path</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Charge au démarrage une liste de fichiers en
+mémoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MMapFile <var>chemin fichier</var> [<var>chemin_fichier</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_file_cache</td></tr>
</table>
- <p>The <code class="directive">MMapFile</code> directive maps one or more files
- (given as whitespace separated arguments) into memory at server
- startup time. They are automatically unmapped on a server
- shutdown. When the files have changed on the filesystem at
- least a <code>HUP</code> or <code>USR1</code> signal should be send to
- the server to re-<code>mmap()</code> them.</p>
+ <p>La directive <code class="directive">MMapFile</code> provoque le chargement d'un
+ ou plusieurs fichiers (séparés par des espaces) en mémoire au
+ démarrage du serveur. Ceux-ci sont automatiquement déchargés de la
+ mémoire à l'arrêt du serveur. Lorsqu'un ou plusieurs fichiers ont
+ été modifiés sur disque, on doit au minimum envoyer un signal
+ <code>HUP</code> ou <code>USR1</code> au serveur afin de les
+ re<code>mmap()</code>er.</p>
- <p>Be careful with the <var>file-path</var> arguments: They have
- to literally match the filesystem path Apache's URL-to-filename
- translation handlers create. We cannot compare inodes or other
- stuff to match paths through symbolic links <em>etc.</em>
- because that again would cost extra <code>stat()</code> system
- calls which is not acceptable. This module may or may not work
- with filenames rewritten by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> or
+ <p>Soyez prudent avec les arguments <var>chemin_fichier</var> : ils
+ doivent correspondre exactement au chemin du système de fichier que
+ créent les gestionnaires de traduction URL-vers-nom-fichier
+ d'Apache. On ne peut pas comparer des inodes ou autres identifiants
+ pour mettre en correspondance des chemins à l'aide de liens
+ symboliques <em>(etc...)</em>, car là encore, ceci nécessiterait un
+ appel à <code>stat()</code> supplémentaire, ce qui est inacceptable.
+ Il n'est pas garanti que ce module fonctionne avec des noms de
+ fichiers réécrits par <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> ou
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">MMapFile /usr/local/apache/htdocs/index.html</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">MMapFile /usr/local/apache/htdocs/index.html</pre>
</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="header" id="header">Directive</a> <a name="Header" id="Header">Header</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP response headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-têtes d'une réponse HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|setifempty|unset|note
-<var>header</var> [[expr=]<var>value</var> [<var>replacement</var>]
-[early|env=[!]<var>varname</var>|expr=<var>expression</var>]]
+<var>en-tête</var> [[expr=]<var>valeur</var>
+[<var>remplacement</var>]
+[early|env=[!]<var>variable</var>|expr=<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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>SetIfEmpty available in 2.4.7 and later, expr=value
-available in 2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>SetIfEmpty est disponible depuis la version 2.4.7 du
+serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la
+version 2.4.10</td></tr>
</table>
- <p>This directive can replace, merge or remove HTTP response
- headers. The header is modified just after the content handler
- and output filters are run, allowing outgoing headers to be
- modified.</p>
-
- <p> The optional <var>condition</var> argument determines which internal
- table of responses headers this directive will operate against. Despite the
- name, the default value of <code>onsuccess</code> does <em>not</em> limit
- an <var>action</var> to responses with a 2xx status code. Headers set under
- this condition are still used when, for example, a request is <em>successfully</em>
- proxied or generated by CGI, even when they have generated a failing status code.</p>
-
- <p>When your action is a function of an existing header, you may need to specify
- a condition of <code>always</code>, depending on which internal table the
- original header was set in. The table that corresponds to <code>always</code> is
- used for locally generated error responses as well as successful responses.
- Note also that repeating this directive with both conditions makes sense in
- some scenarios because <code>always</code> is not a superset of
- <code>onsuccess</code> with respect to existing headers:</p>
+ <p>Cette directive permet de remplacer, fusionner, ou
+ supprimer des en-têtes de réponse HTTP. L'en-tête est modifié juste
+ après que le gestionnaire de contenu et les filtres en sortie ne
+ s'exécutent, ce qui permet la modification des en-têtes
+ sortants.</p>
+
+ <p>L'argument optionnel <var>condition</var> permet de déterminer
+ sur quelle table interne d'en-têtes de réponses cette directive va
+ opérer. En dépit du nom, la valeur par défaut de
+ <code>onsuccess</code> ne limite <em>pas</em> une <var>action</var>
+ aux réponses avec un code d'état de 2xx. Les en-têtes définis sous
+ cette condition sont encore utilisés quand par exemple une requête
+ est mandatée ou générée par un programme CGI avec <em>succès</em>,
+ et ceci même dans le cas où ils ont généré un code d'échec.</p>
+
+ <p>Lorsque votre action est une fonction agissant sur un en-tête
+ existant, vous pourrez être amené à spécifier une condition
+ <code>always</code>, en fonction de la table interne dans laquelle
+ l'en-tête original a été défini. La table qui correspond à
+ <code>always</code> est utilisée pour les réponses d'erreur générées
+ localement ainsi que pour les réponses qui ont abouti.
+ Notez aussi que la répétition
+ de cette directive avec les deux conditions peut être pertinente
+ dans certains scénarios, car <code>always</code> n'englobe pas
+ <code>onsuccess</code> en ce qui concerne les en-têtes existants :</p>
<ul>
- <li> You're adding a header to a locally generated non-success (non-2xx) response, such
- as a redirect, in which case only the table corresponding to
- <code>always</code> is used in the ultimate response.</li>
- <li> You're modifying or removing a header generated by a CGI script,
- in which case the CGI scripts are in the table corresponding to
- <code>always</code> and not in the default table.</li>
- <li> You're modifying or removing a header generated by some piece of
- the server but that header is not being found by the default
- <code>onsuccess</code> condition.</li>
+ <li>Vous ajoutez un en-tête à une réponse
+ générée localement et échouée (non-2xx),
+ une redirection par exemple, et dans ce cas, seule la table
+ correspondant à <code>always</code> est utilisée dans la réponse
+ définitive.</li>
+ <li>Vous modifiez ou supprimez un en-tête généré par un script
+ CGI, et dans ce cas, les scripts CGI sont dans la table
+ correspondant à <code>always</code> et non dans la table par
+ défaut.</li>
+ <li>Vous modifiez ou supprimez un en-tête généré par tel ou tel
+ composant du serveur, mais cet en-tête n'est pas trouvé par la
+ condition par défaut <code>onsuccess</code>.</li>
</ul>
- <p>Separately from the <var>condition</var> parameter described above, you
- can limit an action based on HTTP status codes for e.g. proxied or CGI
- requests. See the example that uses %{REQUEST_STATUS} in the section above.</p>
+ <p>Outre le paramètre <var>condition</var> décrit ci-dessus, vous
+ pouvez limiter une action en fonction de codes d'état HTTP, par
+ exemple pour les requêtes mandatées ou générées par un programme
+ CGI. Voir l'exemple qui utilise %{REQUEST_STATUS} dans la section
+ ci-dessus.</p>
- <p>The action it performs is determined by the first
- argument (second argument if a <var>condition</var> is specified).
- This can be one of the following values:</p>
+ <p>L'action que cette directive provoque est déterminée par le
+ premier argument (ou par le second argument si une
+ <var>condition</var> est spécifiée). Il peut prendre
+ une des valeurs suivantes :</p>
<dl>
<dt><code>add</code></dt>
- <dd>The response header is added to the existing set of headers,
- even if this header already exists. This can result in two
- (or more) headers having the same name. This can lead to
- unforeseen consequences, and in general <code>set</code>,
- <code>append</code> or <code>merge</code> should be used instead.</dd>
+ <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il
+ existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs)
+ en-têtes possèdant le même nom et donc induire des conséquences
+ imprévues ; en général, il est préférable d'utiliser
+ <code>set</code>, <code>append</code> ou <code>merge</code>.</dd>
<dt><code>append</code></dt>
- <dd>The response header is appended to any existing header of
- the same name. When a new value is merged onto an existing
- header it is separated from the existing header with a comma.
- This is the HTTP standard way of giving a header multiple values.</dd>
+ <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même
+ nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée
+ de celles qui sont déjà présentes par une virgule. Il s'agit de la
+ méthode HTTP standard permettant d'affecter plusieurs valeurs à un
+ en-tête.</dd>
<dt><code>echo</code></dt>
- <dd>Request headers with this name are echoed back in the
- response headers. <var>header</var> may be a
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>.
- <var>value</var> must be omitted.</dd>
+ <dd>Les en-têtes de la requête possédant le nom spécifié sont
+ recopiés vers les en-têtes de la réponse. <var>en-tête</var> peut
+ être une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
+ <var>valeur</var> ne doit pas être présent.</dd>
<dt><code>edit</code></dt>
<dt><code>edit*</code></dt>
- <dd>If this response header exists, its value is transformed according
- to a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>
- search-and-replace. The <var>value</var> argument is a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>, and the <var>replacement</var>
- is a replacement string, which may contain backreferences or format specifiers.
- The <code>edit</code> form will match and replace exactly once
- in a header value, whereas the <code>edit*</code> form will replace
- <em>every</em> instance of the search pattern if it appears more
- than once.</dd>
+ <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type
+ recherche/remplacement. L'argument <var>valeur</var> est une
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
+ l'argument <var>remplacement</var> une chaîne de caractères de
+ remplacement qui peut contenir des références
+ arrières ou des spécificateurs de format. La forme <code>edit</code> n'effectuera une
+ recherche/remplacement qu'une seule fois dans la valeur de
+ l'en-tête, alors que la forme <code>edit*</code> en effectuera autant
+ que le nombre d'apparition de la chaîne à remplacer.</dd>
<dt><code>merge</code></dt>
- <dd>The response header is appended to any existing header of
- the same name, unless the value to be appended already appears in the
- header's comma-delimited list of values. When a new value is merged onto
- an existing header it is separated from the existing header with a comma.
- This is the HTTP standard way of giving a header multiple values.
- Values are compared in a case sensitive manner, and after
- all format specifiers have been processed. Values in double quotes
- are considered different from otherwise identical unquoted values.</dd>
+ <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf
+ si elle apparaît déjà dans la liste des valeurs préexistantes de
+ l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est
+ ainsi ajoutée, elle est séparée de celles qui sont déjà présentes
+ par une virgule. Il s'agit de la méthode HTTP standard permettant
+ d'affecter plusieurs valeurs à un en-tête. Les valeurs sont
+ comparées en tenant compte de la casse, et après le traitement de
+ tous les spécificateurs de format. Une valeur entourée de guillemets
+ est considérée comme différente de la même valeur mais sans
+ guillemets.</dd>
<dt><code>set</code></dt>
- <dd>The response header is set, replacing any previous header
- with this name. The <var>value</var> may be a format string.</dd>
+ <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec
+ le même nom. L'argument <var>valeur</var> peut être une chaîne de
+ formatage.</dd>
<dt><code>setifempty</code></dt>
- <dd>The request header is set, but only if there is no previous header
- with this name.
+ <dd>L'en-tête est défini, mais seulement s'il n'existe
+ aucun en-tête avec le même nom.
<div class="note">
- The Content-Type header is a special use case since there might be
- the chance that its value have been determined but the header is not part
- of the response when <code>setifempty</code> is evaluated.
- It is safer to use <code>set</code> for this use case like in the
- following example:
+ L'en-tête Content-Type est un cas particulier car il est possible que sa
+ valeur ait été déterminée mais que l'en-tête ne soit pas présent dans la
+ réponse lorsque <code>setifempty</code> est évalué. Dans ce cas, il est
+ préférable d'utiliser <code>set</code> comme dans l'exemple suivant :
<pre class="prettyprint lang-config">Header set Content-Type "text/plain" "expr=-z %{CONTENT_TYPE}"</pre>
</div></dd>
<dt><code>unset</code></dt>
- <dd>The response header of this name is removed, if it exists.
- If there are multiple headers of the same name, all will be
- removed. <var>value</var> must be omitted.</dd>
+ <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
+ possèdent le même nom, ils seront tous supprimés. L'argument
+ <var>value</var> ne doit pas apparaître.</dd>
<dt><code>note</code></dt>
- <dd>The value of the named response <var>header</var> is copied into an
- internal note whose name is given by <var>value</var>. This is useful
- if a header sent by a CGI or proxied resource is configured to be unset
- but should also be logged.<br />
- Available in 2.4.7 and later.</dd>
-
- </dl>
-
- <p>This argument is followed by a <var>header</var> name, which
- can include the final colon, but it is not required. Case is
- ignored for <code>set</code>, <code>append</code>, <code>merge</code>,
- <code>add</code>, <code>unset</code> and <code>edit</code>.
- The <var>header</var> name for <code>echo</code>
- is case sensitive and may be a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular
- expression</a>.</p>
-
- <p>For <code>set</code>, <code>append</code>, <code>merge</code> and
- <code>add</code> a <var>value</var> is specified as the next argument.
- If <var>value</var>
- contains spaces, it should be surrounded by double quotes.
- <var>value</var> may be a character string, a string containing
- <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> specific format specifiers (and character
- literals), or an <a href="../expr.html">ap_expr</a> expression prefixed
- with <em>expr=</em></p>
-
- <p> The following format specifiers are supported in <var>value</var>:</p>
+ <dd>La valeur de l'<var>en-tête</var> considéré est copiée dans une
+ note interne dont le nom est spécifié via l'argument
+ <var>valeur</var>. Ceci permet de journaliser la valeur d'un en-tête
+ envoyé par un programme CGI ou une ressource mandatée, même s'il
+ est prévu de l'effacer.<br />
+ Disponible à partir de la version 2.4.7 du serveur HTTP Apache.</dd>
+
+ </dl>
+
+ <p>Cet argument est suivi d'un nom d'<var>en-tête</var> qui peut se
+ terminer par un caractère ':', mais ce n'est pas obligatoire. La
+ casse est ignorée avec <code>set</code>, <code>append</code>,
+ <code>merge</code>, <code>add</code>, <code>unset</code> et
+ <code>edit</code>. Le nom d'<var>en-tête</var> est sensible à la
+ casse pour <code>echo</code> et peut être une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p>
+
+ <p>Avec <code>set</code>, <code>append</code>, <code>merge</code> et
+ <code>add</code>, une <var>valeur</var> est spécifiée comme
+ argument suivant. Si <var>valeur</var> contient des espaces, elle
+ doit être entourée de guillemets. <var>valeur</var> peut être une
+ chaîne de caractères, une chaîne contenant des spécificateurs de
+ format propres à <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> (et des caractères
+ littéraux), ou une expression <a href="../expr.html">ap_expr</a>
+ préfixée par <em>expr=</em>.</p>
+
+ <p><var>valeur</var> supporte les spécificateurs de format suivants :</p>
<table class="bordered"><tr class="header"><th>Format</th><th>Description</th></tr>
<tr><td><code>%%</code></td>
- <td>The percent sign</td></tr>
+ <td>Le caractère pourcentage</td></tr>
<tr class="odd"><td><code>%t</code></td>
- <td>The time the request was received in Universal Coordinated Time
- since the epoch (Jan. 1, 1970) measured in microseconds. The value
- is preceded by <code>t=</code>.</td></tr>
+ <td>Le moment de réception de la requête en temps
+ universel coordonné depuis le temps epoch (Jan. 1, 1970) et
+ exprimé en microsecondes. La valeur est précédée de
+ <code>t=</code>.</td></tr>
<tr><td><code>%D</code></td>
- <td>The time from when the request was received to the time the
- headers are sent on the wire. This is a measure of the duration
- of the request. The value is preceded by <code>D=</code>.
- The value is measured in microseconds.</td></tr>
+ <td>Le temps écoulé entre la réception de la requête et l'envoi
+ des en-têtes sur le réseau. Il s'agit de la durée de traitement
+ de la requête. La valeur est précédée de <code>D=</code>. La
+ valeur est exprimée en microsecondes.</td></tr>
<tr class="odd"><td><code>%l</code></td>
- <td>The current load averages of the actual server itself. It is
- designed to expose the values obtained by <code>getloadavg()</code>
- and this represents the current load average, the 5 minute average, and
- the 15 minute average. The value is preceded by <code>l=</code> with each
- average separated by <code>/</code>.<br />
- Available in 2.4.4 and later.
+ <td>La charge moyenne courante du serveur proprement dit. Ce
+ sont les valeurs obtenues par <code>getloadavg()</code> qui
+ représentent la charge moyenne courante, sur 5 minutes et sur 15
+ minutes. Chaque valeur est précédée de <code>l=</code> et
+ séparée de la suivante par un <code>/</code>.<br />
+ Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<tr><td><code>%i</code></td>
- <td>The current idle percentage of httpd (0 to 100) based on available
- processes and threads. The value is preceded by <code>i=</code>.<br />
- Available in 2.4.4 and later.
+ <td>Le pourcentage courant de httpd au repos (de 0 à 100)
+ en se basant sur le nombre de processus et threads disponibles.
+ La valeur est précédée de <code>i=</code>.<br />
+ Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<tr class="odd"><td><code>%b</code></td>
- <td>The current busy percentage of httpd (0 to 100) based on available
- processes and threads. The value is preceded by <code>b=</code>.<br />
- Available in 2.4.4 and later.
+ <td>Le pourcentage courant de httpd utilisé (de 0 à 100)
+ en se basant sur le nombre de processus et threads disponibles.
+ La valeur est précédée de <code>b=</code>.<br />
+ Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
-<tr><td><code>%{VARNAME}e</code></td>
- <td>The contents of the <a href="../env.html">environment
- variable</a> <code>VARNAME</code>.</td></tr>
-<tr class="odd"><td><code>%{VARNAME}s</code></td>
- <td>The contents of the <a href="mod_ssl.html#envvars">SSL environment
- variable</a> <code>VARNAME</code>, if <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is enabled.</td></tr>
+<tr><td><code>%{NOM_VARIABLE}e</code></td>
+ <td>Le contenu de la <a href="../env.html">variable
+ d'environnement</a> <code>NOM_VARIABLE</code>.</td></tr>
+<tr class="odd"><td><code>%{NOM_VARIABLE}s</code></td>
+ <td>Le contenu de la <a href="../env.html">variable
+ d'environnement SSL</a> <code>NOM_VARIABLE</code>, si
+ <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> est activé.</td></tr>
</table>
<div class="note"><h3>Note</h3>
- <p>The <code>%s</code> format specifier is only available in
- Apache 2.1 and later; it can be used instead of <code>%e</code>
- to avoid the overhead of enabling <code>SSLOptions
- +StdEnvVars</code>. If <code>SSLOptions +StdEnvVars</code> must
- be enabled anyway for some other reason, <code>%e</code> will be
- more efficient than <code>%s</code>.</p>
+ <p>Le spécificateur de format <code>%s</code> est disponible
+ depuis la version 2.1 d'Apache ; il peut être utilisé à la place
+ de <code>%e</code> pour éviter de devoir spécifier
+ <code>SSLOptions +StdEnvVars</code>. Cependant, si
+ <code>SSLOptions +StdEnvVars</code> doit tout de même être
+ spécifié pour une raison quelconque, <code>%e</code> sera plus
+ efficace que <code>%s</code>.</p>
</div>
- <div class="note"><h3>Note on expression values</h3>
- <p> When the value parameter uses the <a href="../expr.html">ap_expr</a>
- parser, some expression syntax will differ from examples that evaluate
- <em>boolean</em> expressions such as <If>:</p>
+ <div class="note"><h3>Note à propos des valeurs des expressions</h3>
+ <p>Lorsque le paramètre valeur utilise l'interpréteur <a href="../expr.html">ap_expr</a>, certaines syntaxes d'expressions
+ seront différentes des exemples qui évaluent des expressions
+ <em>booléennes</em> telles que <If> :</p>
<ul>
- <li>The starting point of the grammar is 'string' rather than 'expr'.</li>
- <li>Function calls use the %{funcname:arg} syntax rather than
- funcname(arg).</li>
- <li>Multi-argument functions are not currently accessible from this
- starting point</li>
- <li>Quote the entire parameter, such as
+ <li>Le point de départ de la syntaxe est 'string' au lieu de
+ 'expr'.</li>
+ <li>Les appels de fonction utilisent la syntaxe %{funcname:arg} au
+ lieu de funcname(arg).</li>
+ <li>Les fonctions multi-arguments ne sont pas encore disponibles
+ depuis le point de départ 'string'.</li>
+ <li>Il faut mettre entre guillemets l'ensemble du paramètre, comme
+ dans l'exemple suivant :
<pre class="prettyprint lang-config">Header set foo-checksum "expr=%{md5:foo}"</pre>
</li>
-
+
</ul>
</div>
- <p>For <code>edit</code> there is both a <var>value</var> argument
- which is a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>,
- and an additional <var>replacement</var> string. As of version 2.4.7
- the replacement string may also contain format specifiers.</p>
+ <p><code>edit</code>nécessite les deux arguments
+ <var>valeur</var>, qui est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression
+ rationnelle</a>, et une chaîne additionnelle
+ <var>remplacement</var>. Depuis la version 2.4.7, la chaîne de
+ remplacement peut aussi
+ contenir des spécificateurs de format.</p>
+
+ <p>La directive <code class="directive">Header</code> peut être suivie d'un
+ argument additionnel qui peut prendre les valeurs suivantes :</p>
- <p>The <code class="directive">Header</code> directive may be followed by
- an additional argument, which may be any of:</p>
<dl>
<dt><code>early</code></dt>
- <dd>Specifies <a href="#early">early processing</a>.</dd>
- <dt><code>env=[!]<var>varname</var></code></dt>
- <dd>The directive is applied if and only if the <a href="../env.html">environment variable</a> <code>varname</code> exists.
- A <code>!</code> in front of <code>varname</code> reverses the test,
- so the directive applies only if <code>varname</code> is unset.</dd>
+ <dd>Spécifie <a href="#early">traitement préalable</a>.</dd>
+ <dt><code>env=[!]<var>variable</var></code></dt>
+ <dd>La directive est appliquée si et seulement si la <a href="../env.html">variable d'environnement</a>
+ <code>variable</code> existe. Un <code>!</code> devant
+ <code>variable</code> inverse le test, et la directive ne
+ s'appliquera alors que si <code>variable</code> n'est pas définie.</dd>
<dt><code>expr=<var>expression</var></code></dt>
- <dd>The directive is applied if and only if <var>expression</var>
- evaluates to true. Details of expression syntax and evaluation are
- documented in the <a href="../expr.html">ap_expr</a> documentation.
- <pre class="prettyprint lang-config"># This delays the evaluation of the condition clause compared to <If>
-Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path.php$#"</pre>
-
- </dd>
+ <dd>La directive s'applique si et seulement si <var>expression</var>
+ est évaluée à true. Vous trouverez plus de détails à propos de la
+ syntaxe et de l'évaluation des expressions dans la documentation <a href="../expr.html">ap_expr</a>.
+ <pre class="prettyprint lang-config"> # Cet exemple retarde l'évaluation de la clause de condition par
+ # rapport à <If>
+ Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path.php$#"</pre>
+
+ </dd>
</dl>
- <p>Except in <a href="#early">early</a> mode, the
- <code class="directive">Header</code> directives are processed just
- before the response is sent to the network. This means that it is
- possible to set and/or override most headers, except for some headers
- added by the HTTP header filter. Prior to 2.2.12, it was not possible
- to change the Content-Type header with this directive.</p>
-
+ <p>Excepté le cas du mode <a href="#early">précoce</a>, les
+ directives <code class="directive">Header</code> sont traitées juste avant
+ l'envoi de la réponse sur le réseau. Cela signifie qu'il est
+ possible de définir et/ou modifier la plupart des en-têtes, à
+ l'exception de certains en-têtes qui sont ajoutés par le filtre
+ d'en-tête HTTP. Avant la version 2.2.12, il n'était pas
+ possible de modifier l'en-tête Content-Type avec cette directive.</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="requestheader" id="requestheader">Directive</a> <a name="RequestHeader" id="RequestHeader">RequestHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP request headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-têtes d'une requête HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RequestHeader add|append|edit|edit*|merge|set|setifempty|unset
-<var>header</var> [[expr=]<var>value</var> [<var>replacement</var>]
-[early|env=[!]<var>varname</var>|expr=<var>expression</var>]]
+<var>en-tête</var> [[expr=]<var>valeur</var>
+[<var>remplacement</var>]
+[early|env=[!]<var>variable</var>|expr=<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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>SetIfEmpty available in 2.4.7 and later, expr=value
-available in 2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>SetIfEmpty est disponible depuis la version 2.4.7 du
+serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la
+version 2.4.10</td></tr>
</table>
- <p>This directive can replace, merge, change or remove HTTP request
- headers. The header is modified just before the content handler
- is run, allowing incoming headers to be modified. The action it
- performs is determined by the first argument. This can be one
- of the following values:</p>
+ <p>Cette directive permet de remplacer, fusionner, modifier ou
+ supprimer des en-têtes de requête HTTP. L'en-tête est modifié juste
+ avant que le gestionnaire de contenu ne s'exécute, ce qui permet la
+ modification des en-têtes entrants. L'action effectuée est
+ déterminée par le premier argument. Ce dernier accepte les valeurs
+ suivantes :</p>
<dl>
<dt><code>add</code></dt>
- <dd>The request header is added to the existing set of headers,
- even if this header already exists. This can result in two
- (or more) headers having the same name. This can lead to
- unforeseen consequences, and in general <code>set</code>,
- <code>append</code> or <code>merge</code> should be used instead.</dd>
+ <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il
+ existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs)
+ en-têtes possèdant le même nom et donc induire des conséquences
+ imprévues ; en général, il est préférable d'utiliser
+ <code>set</code>, <code>append</code> ou <code>merge</code>.</dd>
<dt><code>append</code></dt>
- <dd>The request header is appended to any existing header of the
- same name. When a new value is merged onto an existing header
- it is separated from the existing header with a comma. This
- is the HTTP standard way of giving a header multiple
- values.</dd>
+ <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même
+ nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée
+ de celles qui sont déjà présentes par une virgule. Il s'agit de la
+ méthode HTTP standard permettant d'affecter plusieurs valeurs à un
+ en-tête.</dd>
<dt><code>edit</code></dt>
<dt><code>edit*</code></dt>
- <dd>If this request header exists, its value is transformed according
- to a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>
- search-and-replace. The <var>value</var> argument is a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>, and the <var>replacement</var>
- is a replacement string, which may contain backreferences or format specifiers.
- The <code>edit</code> form will match and replace exactly once
- in a header value, whereas the <code>edit*</code> form will replace
- <em>every</em> instance of the search pattern if it appears more
- than once.</dd>
+ <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type
+ recherche/remplacement. L'argument <var>valeur</var> est une
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
+ l'argument <var>remplacement</var> une chaîne de caractères de
+ remplacement qui peut contenir des références
+ arrières ou des spécificateurs de format. Avec
+ <code>edit</code>, la chaîne de l'en-tête correspondant au modèle ne
+ sera recherchée et remplacée qu'une seule fois, alors qu'avec
+ <code>edit*</code>, elle le sera pour chacune de ses instances si
+ elle apparaît plusieurs fois.</dd>
<dt><code>merge</code></dt>
- <dd>The request header is appended to any existing header of
- the same name, unless the value to be appended already appears in the
- existing header's comma-delimited list of values. When a new value is
- merged onto an existing header it is separated from the existing header
- with a comma. This is the HTTP standard way of giving a header multiple
- values. Values are compared in a case sensitive manner, and after
- all format specifiers have been processed. Values in double quotes
- are considered different from otherwise identical unquoted values.</dd>
+ <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf
+ si elle apparaît déjà dans la liste des valeurs préexistantes de
+ l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est
+ ainsi ajoutée, elle est séparée de celles qui sont déjà présentes
+ par une virgule. Il s'agit de la méthode HTTP standard permettant
+ d'affecter plusieurs valeurs à un en-tête. Les valeurs sont
+ comparées en tenant compte de la casse, et après le traitement de
+ tous les spécificateurs de format. Une valeur entourée de guillemets
+ est considérée comme différente de la même valeur mais sans
+ guillemets.</dd>
<dt><code>set</code></dt>
- <dd>The request header is set, replacing any previous header
- with this name</dd>
+ <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec
+ le même nom.</dd>
<dt><code>setifempty</code></dt>
- <dd>The request header is set, but only if there is no previous header
- with this name.<br />
- Available in 2.4.7 and later.</dd>
+ <dd>L'en-tête est défini, mais seulement s'il n'existe
+ aucun en-tête avec le même nom.<br />
+ Disponible depuis la version 2.4.7 du serveur HTTP Apache.</dd>
<dt><code>unset</code></dt>
- <dd>The request header of this name is removed, if it exists. If
- there are multiple headers of the same name, all will be removed.
- <var>value</var> must be omitted.</dd>
+ <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
+ possèdent le même nom, ils seront tous supprimés. L'argument
+ <var>value</var> ne doit pas apparaître.</dd>
</dl>
- <p>This argument is followed by a header name, which can
- include the final colon, but it is not required. Case is
- ignored. For <code>set</code>, <code>append</code>, <code>merge</code> and
- <code>add</code> a <var>value</var> is given as the third argument. If a
- <var>value</var> contains spaces, it should be surrounded by double
- quotes. For <code>unset</code>, no <var>value</var> should be given.
- <var>value</var> may be a character string, a string containing format
- specifiers or a combination of both. The supported format specifiers
- are the same as for the <code class="directive"><a href="#header">Header</a></code>,
- please have a look there for details. For <code>edit</code> both
- a <var>value</var> and a <var>replacement</var> are required, and are
- a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a> and a
- replacement string respectively.</p>
-
- <p>The <code class="directive">RequestHeader</code> directive may be followed by
- an additional argument, which may be any of:</p>
+ <p>Cet argument est suivi d'un nom d'en-tête qui peut se terminer
+ par un caractère ':', mais ce n'est pas obligatoire. La casse est
+ ignorée. Avec <code>set</code>, <code>append</code>,
+ <code>merge</code> et <code>add</code>, une <var>valeur</var> est
+ fournie en troisième argument. Si une <var>valeur</var> contient des
+ espaces, elle doit être entourée de guillemets. Avec
+ <code>unset</code>, aucune <var>valeur</var> ne doit apparaître.
+ <var>valeur</var> peut être une chaîne de caractères, une chaîne
+ contenant des spécificateurs de format, ou une combinaison des deux.
+ Les spécificateurs de format supportés sont les mêmes que ceux de la
+ directive <code class="directive"><a href="#header">Header</a></code>, à
+ laquelle vous pouvez vous reporter pour plus de détails. Avec
+ <code>edit</code>, les deux arguments <var>valeur</var> et
+ <var>remplacement</var> sont obligatoires, et correspondent
+ respectivement à une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression
+ rationnelle</a> et à une chaîne de remplacement.</p>
+
+ <p>La directive <code class="directive">RequestHeader</code> peut être
+ suivie d'un argument supplémentaire, qui pourra prendre les valeurs
+ suivantes :</p>
<dl>
<dt><code>early</code></dt>
- <dd>Specifies <a href="#early">early processing</a>.</dd>
- <dt><code>env=[!]<var>varname</var></code></dt>
- <dd>The directive is applied if and only if the <a href="../env.html">environment variable</a> <code>varname</code> exists.
- A <code>!</code> in front of <code>varname</code> reverses the test,
- so the directive applies only if <code>varname</code> is unset.</dd>
+ <dd>Spécifie <a href="#early">traitement préalable</a>.</dd>
+ <dt><code>env=[!]<var>variable</var></code></dt>
+ <dd>La directive est appliquée si et seulement si la <a href="../env.html">variable d'environnement</a>
+ <code>variable</code> existe. Un <code>!</code> devant
+ <code>variable</code> inverse le test, et la directive ne
+ s'appliquera alors que si <code>variable</code> n'est pas définie.</dd>
<dt><code>expr=<var>expression</var></code></dt>
- <dd>The directive is applied if and only if <var>expression</var>
- evaluates to true. Details of expression syntax and evaluation are
- documented in the <a href="../expr.html">ap_expr</a> documentation.</dd>
+ <dd>La directive s'applique si et seulement si <var>expression</var>
+ est évaluée à true. Vous trouverez plus de détails à propos de la
+ syntaxe et de l'évaluation des expressions dans la documentation <a href="../expr.html">ap_expr</a>.</dd>
</dl>
- <p>Except in <a href="#early">early</a> mode, the
- <code class="directive">RequestHeader</code> directive is processed
- just before the request is run by its handler in the fixup phase.
- This should allow headers generated by the browser, or by Apache
- input filters to be overridden or modified.</p>
+ <p>Excepté le cas du mode <a href="#early">précoce</a>, la directive
+ <code class="directive">RequestHeader</code> est traitée juste avant la
+ prise en compte de la requête par son gestionnaire, au cours de la
+ phase de vérification. Ceci permet la modification des en-têtes
+ générés par le navigateur, ou par les filtres en entrée
+ d'Apache.</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="heartbeataddress" id="heartbeataddress">Directive</a> <a name="HeartbeatAddress" id="HeartbeatAddress">HeartbeatAddress</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Multicast address for heartbeat packets</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adresse multicast à laquelle envoyer les requêtes
+heartbeat</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatAddress <var>addr:port</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>disabled</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_heartbeat</td></tr>
</table>
-<p>The <code class="directive">HeartbeatAddress</code> directive specifies the
-multicast address to which <code class="module"><a href="../mod/mod_heartbeat.html">mod_heartbeat</a></code> will send
-status information. This address will usually correspond to a configured
- <code class="directive"><a href="../mod/mod_heartmonitor.html#heartbeatlisten">HeartbeatListen</a></code> on a
-frontend proxy system.</p>
-<pre class="prettyprint lang-config">HeartbeatAddress 239.0.0.1:27999</pre>
+ <p>La directive <code class="directive">HeartbeatAddress</code> permet de
+ spécifier l'adresse multicast à laquelle <code class="module"><a href="../mod/mod_heartbeat.html">mod_heartbeat</a></code> va
+ envoyer ses informations. En général, cette adresse correspond à la
+ valeur définie par la directive <code class="directive"><a href="../mod/mod_heartmonitor.html#heartbeatlisten">HeartbeatListen</a></code> sur le serveur
+ mandataire frontal.</p>
+
<pre class="prettyprint lang-config">HeartbeatAddress 239.0.0.1:27999</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="heartbeatlisten" id="heartbeatlisten">Directive</a> <a name="HeartbeatListen" id="HeartbeatListen">HeartbeatListen</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>multicast address to listen for incoming heartbeat requests </td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adresse multicast d'écoute des requêtes entrantes heartbeat</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatListen<var>addr:port</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>disabled</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_heartmonitor</td></tr>
</table>
- <p>The <code class="directive">HeartbeatListen</code> directive specifies the
- multicast address on which the server will listen for status information from
- <code class="module"><a href="../mod/mod_heartbeat.html">mod_heartbeat</a></code>-enabled servers. This
- address will usually correspond to a configured <code class="directive"><a href="../mod/mod_heartbeat.html#heartbeataddress">HeartbeatAddress</a></code> on an origin server.
+ <p>La directive <code class="directive">HeartbeatListen</code> permet de
+ spécifier l'adresse multicast sur laquelle le serveur va surveiller les
+ informations d'état en provenance de serveurs où
+ <code class="module"><a href="../mod/mod_heartbeat.html">mod_heartbeat</a></code> est activé. Cette adresse correspond
+ en général à la valeur de la directive <code class="directive"><a href="../mod/mod_heartbeat.html#heartbeataddress">HeartbeatAddress</a></code> sur le serveur
+ d'origine.
</p>
<pre class="prettyprint lang-config">HeartbeatListen 239.0.0.1:27999</pre>
- <p> This module is inactive until this directive is used.</p>
+ <p>Tant que cette directive n'est pas utilisée, le module est
+ désactivé.</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="heartbeatmaxservers" id="heartbeatmaxservers">Directive</a> <a name="HeartbeatMaxServers" id="HeartbeatMaxServers">HeartbeatMaxServers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the maximum number of servers that will be sending
-heartbeat requests to this server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatMaxServers <var>number-of-servers</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le nombre maximal de serveurs qui pourront envoyer
+des requêtes heartbeat à ce serveur.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatMaxServers <var>nombre-de-serveurs</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HeartbeatMaxServers 10</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_heartmonitor</td></tr>
</table>
- <p>The <code class="directive">HeartbeatMaxServers</code> directive specifies the
- maximum number of servers that will be sending requests to this monitor
- server. It is used to control the size of the shared memory allocated
- to store the heartbeat info when <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code> is in use.</p>
+ <p>La directive <code class="directive">HeartbeatMaxServers</code>
+ spécifie le nombre maximal de serveurs qui pourront envoyer des
+ requêtes heartbeat à ce serveur de monitoring. Elle permet ainsi de
+ contrôler la quantité de mémoire partagée allouée pour le stockage
+ des données heartbeat lorsqu'on utilise
+ <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</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="heartbeatstorage" id="heartbeatstorage">Directive</a> <a name="HeartbeatStorage" id="HeartbeatStorage">HeartbeatStorage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to store heartbeat data</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatStorage <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin vers le stockage des données heartbeat</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatStorage <var>chemin fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HeartbeatStorage logs/hb.dat</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_heartmonitor</td></tr>
</table>
- <p>The <code class="directive">HeartbeatStorage</code> directive specifies the
- path to store heartbeat data. This flat-file is used only when
- <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code> is not loaded.</p>
+ <p>La directive <code class="directive">HeartbeatStorage</code> permet de
+ spécifier le chemin de stockage des données heartbeat. Ce fichier
+ texte n'est utilisé que si <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code> n'est
+ pas chargé.</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="identitycheck" id="identitycheck">Directive</a> <a name="IdentityCheck" id="IdentityCheck">IdentityCheck</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables logging of the RFC 1413 identity of the remote
-user</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la journalisation de l'identité RFC 1413 de
+l'utilisateur distant</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IdentityCheck On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IdentityCheck 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ident</td></tr>
</table>
- <p>This directive enables <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>-compliant logging of the remote user name for each
- connection, where the client machine runs identd or something similar.
- This information is logged in the access log using the <code>%...l</code>
- <a href="mod_log_config.html#formats">format string</a>.</p>
+ <p>Cette directive permet d'activer la journalisation compatible <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> du nom de
+ l'utilisateur distant pour chaque connexion, si la machine du client
+ exécute identd ou un démon similaire. Cette information est
+ enregistrée dans le journal des accès en utilisant la <a href="mod_log_config.html#formats">chaîne de formatage</a>
+ <code>%...l</code>.</p>
<div class="note">
- The information should not be trusted in any way except for
- rudimentary usage tracking.
+ Cette information ne doit pas faire l'objet d'une confiance
+ absolue, et elle ne doit être utilisée que dans le cadre d'un
+ traçage grossier.
</div>
- <p>Note that this can cause serious latency problems accessing
- your server since every request requires one of these lookups
- to be performed. When firewalls or proxy servers are involved,
- each lookup might possibly fail and add a latency duration as
- defined by the <code class="directive"><a href="#identitychecktimeout">IdentityCheckTimeout</a></code> directive to each hit. So in
- general this is not very useful on public servers accessible from
- the Internet.</p>
+ <p>Notez que de sérieux problèmes de délais peuvent survenir lors
+ des accès à votre serveur, car chaque requête nécessite l'exécution
+ d'un de ces processus de recherche. Lorsque des pare-feu ou des
+ serveurs mandataires sont impliqués, chaque recherche est
+ susceptible d'échouer et ajouter un temps de latence conformément
+ à la directive <code class="directive"><a href="#identitychecktimeout">IdentityCheckTimeout</a></code>. En général, ces
+ recherches ne se révèlent donc pas très utiles sur des serveurs
+ publics accessibles depuis l'Internet.</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="identitychecktimeout" id="identitychecktimeout">Directive</a> <a name="IdentityCheckTimeout" id="IdentityCheckTimeout">IdentityCheckTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the timeout duration for ident requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IdentityCheckTimeout <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le délai d'attente pour les requêtes
+ident</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IdentityCheckTimeout <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IdentityCheckTimeout 30</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ident</td></tr>
</table>
- <p>This directive specifies the timeout duration of an ident
- request. The default value of 30 seconds is recommended by <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>, mainly because
- of possible network latency. However, you may want to adjust the
- timeout value according to your local network speed.</p>
+ <p>Cette directive permet de spécifier le délai d'attente d'une
+ requête ident. Une valeur par défaut de 30 secondes est recommandée
+ par la <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>,
+ principalement pour prévenir les problèmes qui pourraient être
+ induits par la charge du réseau. Vous pouvez cependant ajuster la
+ valeur de ce délai en fonction du débit de votre réseau local.</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="imapbase" id="imapbase">Directive</a> <a name="ImapBase" id="ImapBase">ImapBase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default <code>base</code> for imagemap files</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Valeur par défaut de la directive <code>base</code> des
+fichiers imagemap</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapBase map|referer|<var>URL</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapBase http://servername/</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapBase http://nom_serveur/</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>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
- <p>The <code class="directive">ImapBase</code> directive sets the default
- <code>base</code> used in the imagemap files. Its value is
- overridden by a <code>base</code> directive within the imagemap
- file. If not present, the <code>base</code> defaults to
- <code>http://<var>servername</var>/</code>.</p>
+ <p>La directive <code class="directive">ImapBase</code> permet de définir la
+ valeur par défaut de la directive <code>base</code> des fichiers
+ imagemap. Sa valeur est écrasée par la présence éventuelle d'une
+ directive <code>base</code> dans le fichier imagemap. Si cette
+ directive est absente, la valeur par défaut de la directive
+ <code>base</code> est
+ <code>http://<var>nom_serveur</var>/</code>.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="imapdefault" id="imapdefault">Directive</a> <a name="ImapDefault" id="ImapDefault">ImapDefault</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default action when an imagemap is called with coordinates
-that are not explicitly mapped</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre par défaut lorsqu'un fichier imagemap
+est invoqué avec des coordonnées qui ne correspondent à aucune
+cible</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapDefault error|nocontent|map|referer|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapDefault nocontent</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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
- <p>The <code class="directive">ImapDefault</code> directive sets the default
- <code>default</code> used in the imagemap files. Its value is
- overridden by a <code>default</code> directive within the
- imagemap file. If not present, the <code>default</code> action
- is <code>nocontent</code>, which means that a <code>204 No
- Content</code> is sent to the client. In this case, the client
- should continue to display the original page.</p>
+ <p>La directive <code class="directive">ImapDefault</code> permet de définir
+ la valeur par défaut de la directive <code>default</code> utilisée
+ dans les fichiers imagemap. Sa valeur est écrasée par la présence
+ éventuelle d'une directive <code>default</code> dans le fichier
+ imagemap. Si cette directive est absente, l'action associée à
+ <code>default</code> est <code>nocontent</code>, ce qui implique
+ l'envoi d'un code de statut <code>204 No Content</code> au client.
+ Dans ce cas, le client doit continuer à afficher la même page.</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="imapmenu" id="imapmenu">Directive</a> <a name="ImapMenu" id="ImapMenu">ImapMenu</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action if no coordinates are given when calling
-an imagemap</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si aucune coordonnée n'est fournie
+lorsqu'on invoque un fichier imagemap</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapMenu none|formatted|semiformatted|unformatted</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapMenu formatted</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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
- <p>The <code class="directive">ImapMenu</code> directive determines the
- action taken if an imagemap file is called without valid
- coordinates.</p>
+ <p>La directive <code class="directive">ImapMenu</code> permet de spécifier
+ l'action à entreprendre lorsqu'un fichier imagemap est invoqué sans
+ coordonnées valides.</p>
<dl>
<dt><code>none</code></dt>
- <dd>If ImapMenu is <code>none</code>, no menu is generated,
- and the <code>default</code> action is performed.</dd>
+ <dd>Si l'argument d'ImapMenu est <code>none</code>, aucun menu
+ n'est généré, et l'action <code>default</code> est effectuée.</dd>
<dt><code>formatted</code></dt>
- <dd>A <code>formatted</code> menu is the simplest menu.
- Comments in the imagemap file are ignored. A level one header
- is printed, then an hrule, then the links each on a separate
- line. The menu has a consistent, plain look close to that of
- a directory listing.</dd>
+ <dd>Le menu <code>formatted</code> est le menu le plus simple. Les
+ commentaires du fichier imagemap sont ignorés. Un en-tête de
+ niveau un est affiché, puis un séparateur horizontal, puis chacun
+ des liens sur une ligne séparée. L'aspect du menu est similaire à
+ celui d'un listing de répertoire.</dd>
<dt><code>semiformatted</code></dt>
- <dd>In the <code>semiformatted</code> menu, comments are
- printed where they occur in the imagemap file. Blank lines
- are turned into HTML breaks. No header or hrule is printed,
- but otherwise the menu is the same as a
- <code>formatted</code> menu.</dd>
+ <dd>Dans le menu <code>semiformatted</code>, les commentaires sont
+ affichés au moment où ils apparaissent dans le fichier imagemap.
+ Les lignes vides sont interprètées comme des lignes de séparation
+ HTML. Aucun en-tête ni séparateur horizontal n'est affiché. À part
+ ces différences, le menu <code>semiformatted</code> est identique
+ au menu <code>formatted</code>.</dd>
<dt><code>unformatted</code></dt>
- <dd>Comments are printed, blank lines are ignored. Nothing is
- printed that does not appear in the imagemap file. All breaks
- and headers must be included as comments in the imagemap
- file. This gives you the most flexibility over the appearance
- of your menus, but requires you to treat your map files as
- HTML instead of plaintext.</dd>
+ <dd>Les commentaires sont affichés et les lignes vides sont
+ ignorées. N'est affiché que ce qui apparait dans le fichier
+ imagemap. Toutes les lignes de séparation HTML et les
+ en-têtes doivent être inclus en tant que commentaires dans le
+ fichier imagemap. Cela vous procure une grande souplesse pour
+ définir l'apparence de vos menus, mais vous oblige à rédiger vos
+ fichiers imagemap en HTML, et non en texte plat.</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="ssiendtag" id="ssiendtag">Directive</a> <a name="SSIEndTag" id="SSIEndTag">SSIEndTag</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String that ends an include element</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chaîne qui termine l'élément include</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIEndTag <var>tag</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSIEndTag "-->"</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>This directive changes the string that <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
- looks for to mark the end of an include element.</p>
+ <p>Cette directive permet de modifier la chaîne que
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interprète comme la fin d'un élément
+ include.</p>
<pre class="prettyprint lang-config">SSIEndTag "%>"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssierrormsg" id="ssierrormsg">Directive</a> <a name="SSIErrorMsg" id="SSIErrorMsg">SSIErrorMsg</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Error message displayed when there is an SSI
-error</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Message d'erreur affiché lorsqu'une erreur SSI
+survient</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIErrorMsg <var>message</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSIErrorMsg "[an error occurred while processing this
directive]"</code></td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>The <code class="directive">SSIErrorMsg</code> directive changes the error
- message displayed when <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> encounters an
- error. For production servers you may consider changing the default
- error message to <code>"<!-- Error -->"</code> so that
- the message is not presented to the user.</p>
+ <p>La directive <code class="directive">SSIErrorMsg</code> permet de
+ modifier le message d'erreur affiché lorsqu'une erreur SSI survient.
+ Pour les serveurs en production, il est recommandé de modifier le
+ message d'erreur par défaut en <code>"<!-- Error
+ -->"</code>, de façon à ce que le message ne soit pas
+ présenté à l'utilisateur.</p>
- <p>This directive has the same effect as the <code><!--#config
- errmsg=<var>message</var> --></code> element.</p>
+ <p>Cette directive a le même effet que l'élément
+ <code><!--#config errmsg=<var>message</var> --></code>.</p>
<pre class="prettyprint lang-config">SSIErrorMsg "<!-- Error -->"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssietag" id="ssietag">Directive</a> <a name="SSIETag" id="SSIETag">SSIETag</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether ETags are generated by the server.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si des en-têtes ETags sont générés par le serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIETag on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSIETag 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>Under normal circumstances, a file filtered by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
- may contain elements that are either dynamically generated, or that may
- have changed independently of the original file. As a result, by default
- the server is asked not to generate an <code>ETag</code> header for the
- response by adding <code>no-etag</code> to the request notes.</p>
-
- <p>The <code class="directive">SSIETag</code> directive suppresses this
- behaviour, and allows the server to generate an <code>ETag</code> header.
- This can be used to enable caching of the output. Note that a backend server
- or dynamic content generator may generate an ETag of its own, ignoring
- <code>no-etag</code>, and this ETag will be passed by
- <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> regardless of the value of this setting.
- <code class="directive">SSIETag</code> can take on the following values:</p>
+ <p>Dans le cas général, un fichier filtré par
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des éléments soit
+ générés dynamiquement, soit éventuellement modifiés indépendemment
+ du fichier original. En conséquence, il est demandé par défaut au
+ serveur de ne pas générer d'en-tête <code>ETag</code> à la réponse
+ en ajoutant <code>no-etag</code> aux informations de requête.</p>
+
+ <p>Ce comportement peut être modifié via la directive
+ <code class="directive">SSIETag</code> qui permet au serveur de générer un
+ en-tête <code>ETag</code>. On peut aussi l'utiliser pour la mise
+ en cache de la sortie. Notez qu'un serveur d'arrière-plan ou un
+ générateur de contenu dynamique peut lui-même générer un en-tête
+ <code>ETag</code>, en ignorant l'information <code>no-etag</code>,
+ cet en-tête <code>ETag</code> étant transmis par
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sans tenir compte de la définition de
+ la présente directive. La directive <code class="directive">SSIETag</code>
+ peut prendre une des valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
- <dd><code>no-etag</code> will be added to the request notes, and the server
- is asked not to generate an ETag. Where a server ignores the value of
- <code>no-etag</code> and generates an ETag anyway, the ETag will be
- respected.</dd>
+ <dd><code>no-etag</code> sera ajouté aux informations de
+ requête, et il sera demandé au serveur de ne pas générer
+ d'en-tête <code>ETag</code>. Lorsqu'un serveur ignore la valeur
+ de <code>no-etag</code> et génère tout de même un en-tête
+ <code>ETag</code>, ce dernier sera respecté.</dd>
<dt><code>on</code></dt>
- <dd>Existing ETags will be respected, and ETags generated by the server will
- be passed on in the response.</dd>
+ <dd>Les en-têtes <code>ETag</code> existants seront respectés,
+ et ceux générés par le serveur seront ajoutés à la réponse.</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssilastmodified" id="ssilastmodified">Directive</a> <a name="SSILastModified" id="SSILastModified">SSILastModified</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls whether <code>Last-Modified</code> headers are generated by the
-server.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si des en-têtes <code>Last-Modified</code> sont
+générés par le serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSILastModified on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSILastModified 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>Under normal circumstances, a file filtered by <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
- may contain elements that are either dynamically generated, or that may
- have changed independently of the original file. As a result, by default
- the <code>Last-Modified</code> header is stripped from the response.</p>
-
- <p>The <code class="directive">SSILastModified</code> directive overrides this
- behaviour, and allows the <code>Last-Modified</code> header to be respected
- if already present, or set if the header is not already present. This can
- be used to enable caching of the output. <code class="directive">SSILastModified</code>
- can take on the following values:</p>
+ <p>Dans le cas général, un fichier filtré par
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des éléments soit
+ générés dynamiquement, soit éventuellement modifiés indépendemment
+ du fichier original. En conséquence, l'en-tête
+ <code>Last-Modified</code> est supprimé par défaut de la réponse.</p>
+
+ <p>La directive <code class="directive">SSILastModified</code> permet de
+ modifier ce comportement en faisant en sorte que l'en-tête
+ <code>Last-Modified</code> soit respecté s'il est déjà présent, ou
+ défini dans le cas contraire. On peut aussi l'utiliser pour la mise
+ en cache de la sortie. La directive
+ <code class="directive">SSILastModified</code> peut prendre une des
+ valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
- <dd>The <code>Last-Modified</code> header will be stripped from responses,
- unless the <code class="directive"><a href="#xbithack">XBitHack</a></code> directive
- is set to <code>full</code> as described below.</dd>
+ <dd>L'en-tête <code>Last-Modified</code> sera supprimé des
+ réponses, à moins que la directive <code class="directive"><a href="#xbithack">XBitHack</a></code> ne soit définie à
+ <code>full</code> comme décrit plus loin.</dd>
<dt><code>on</code></dt>
- <dd>The <code>Last-Modified</code> header will be respected if already
- present in a response, and added to the response if the response is a
- file and the header is missing. The
- <code class="directive"><a href="#ssilastmodified">SSILastModified</a></code> directive
- takes precedence over <code class="directive"><a href="#xbithack">XBitHack</a></code>.</dd>
+ <dd>L'en-tête <code>Last-Modified</code> sera respecté s'il est
+ déjà présent, et ajouté à la réponse si cette dernière est un
+ fichier et si l'en-tête est manquant. La directive <code class="directive"><a href="#ssilastmodified">SSILastModified</a></code> l'emporte sur
+ la directive <code class="directive"><a href="#xbithack">XBitHack</a></code>.</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssilegacyexprparser" id="ssilegacyexprparser">Directive</a> <a name="SSILegacyExprParser" id="SSILegacyExprParser">SSILegacyExprParser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable compatibility mode for conditional expressions.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le mode de compatibilité pour les expressions
+conditionnelles.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSILegacyExprParser on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSILegacyExprParser 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>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.13 and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13.</td></tr>
</table>
- <p>As of version 2.3.13, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> has switched to the
- new <a href="../expr.html">ap_expr</a> syntax for conditional expressions
- in <code>#if</code> flow control elements. This directive allows to
- switch to the <a href="#legacyexpr">old syntax</a> which is compatible
- with Apache HTTPD version 2.2.x and earlier.
+ <p>Depuis la version 2.3.13, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> a adopté
+ la nouvelle syntaxe <a href="../expr.html">ap_expr</a> pour ses
+ expressions conditionnelles dans les éléments de contrôle de flux
+ <code>#if</code>. Cette directive permet de réactiver l'<a href="#legacyexpr">ancienne syntaxe</a> qui est compatible avec les
+ versions 2.2.x et antérieures d'Apache HTTPD.
</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="ssistarttag" id="ssistarttag">Directive</a> <a name="SSIStartTag" id="SSIStartTag">SSIStartTag</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String that starts an include element</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chaîne qui marque le début d'un élément
+include</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIStartTag <var>tag</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSIStartTag "<!--#"</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>This directive changes the string that <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
- looks for to mark an include element to process.</p>
+ <p>Cette directive permet de modifier la chaîne que
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interprète comme le début d'un élément
+ include.</p>
- <p>You may want to use this option if you have 2 servers parsing the
- output of a file each processing different commands (possibly at
- different times).</p>
+ <p>Cette option peut vous être utile si vous avez deux serveurs qui
+ interprètent un fichier avec des commandes différentes (et
+ éventuellement à des moments différents).</p>
<pre class="prettyprint lang-config">SSIStartTag "<%"
SSIEndTag "%>"</pre>
- <p>The example given above, which also specifies a matching
- <code class="directive"><a href="#ssiendtag">SSIEndTag</a></code>, will
- allow you to use SSI directives as shown in the example
- below:</p>
+ <p>Avec l'exemple ci-dessus, qui définit aussi une directive
+ <code class="directive"><a href="#ssiendtag">SSIEndTag</a></code>, vous pourrez
+ inscrire des directives SSI comme dans l'exemple suivant :</p>
- <div class="example"><h3>SSI directives with alternate start and end tags</h3><p><code>
+ <div class="example"><h3>Directives SSI avec marques de début et de fin
+ personnalisées</h3><p><code>
<%printenv %>
</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="ssitimeformat" id="ssitimeformat">Directive</a> <a name="SSITimeFormat" id="SSITimeFormat">SSITimeFormat</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the format in which date strings are
-displayed</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSITimeFormat <var>formatstring</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration du format d'affichage des dates</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSITimeFormat <var>chaîne de formatage</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z"</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
-<p>This directive changes the format in which date strings are displayed
- when echoing <code>DATE</code> environment variables. The
- <var>formatstring</var> is as in <code>strftime(3)</code> from the
- C standard library.</p>
+<p>Cette directive permet de modifier le format d'affichage des
+variables d'environnement <code>DATE</code>. La <var>chaîne de
+formatage</var> est identique à celle de la fonction
+<code>strftime(3)</code> de la bibliothèque C standard.</p>
- <p>This directive has the same effect as the <code><!--#config
- timefmt=<var>formatstring</var> --></code> element.</p>
+ <p>Cette directive a le même effet que l'élément
+ <code><!--#config timefmt=<var>chaîne de formatage</var>
+ --></code>.</p>
<pre class="prettyprint lang-config">SSITimeFormat "%R, %B %d, %Y"</pre>
- <p>The above directive would cause times to be displayed in the
- format "22:26, June 14, 2002".</p>
+ <p>Avec l'exemple ci-dessus, les dates seront affichées dans le
+ style "22:26, June 14, 2002".</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="ssiundefinedecho" id="ssiundefinedecho">Directive</a> <a name="SSIUndefinedEcho" id="SSIUndefinedEcho">SSIUndefinedEcho</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String displayed when an unset variable is echoed</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIUndefinedEcho <var>string</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chaîne à afficher lorsqu'on tente d'extraire le contenu
+d'une variable non définie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIUndefinedEcho <var>chaîne</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSIUndefinedEcho "(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>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>This directive changes the string that <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
- displays when a variable is not set and "echoed".</p>
+ <p>Cette directive permet de modifier la chaîne affichée par
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> lorsqu'on tente d'extraire le contenu
+ d'une variable non définie.</p>
- <pre class="prettyprint lang-config">SSIUndefinedEcho "<!-- undef -->"</pre>
+ <pre class="prettyprint lang-config">SSIUndefinedEcho "<!-- nondef -->"</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="xbithack" id="xbithack">Directive</a> <a name="XBitHack" id="XBitHack">XBitHack</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Parse SSI directives in files with the execute bit
-set</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interprète les directives SSI dans les fichiers dont le bit
+d'exécution est positionné</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>XBitHack on|off|full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>XBitHack 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
- <p>The <code class="directive">XBitHack</code> directive controls the parsing
- of ordinary html documents. This directive only affects files associated
- with the <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">MIME-type</a> <code>text/html</code>. <code class="directive">XBitHack</code> can take on the following values:</p>
+ <p>La directive <code class="directive">XBitHack</code> permet de contrôler
+ l'interprétation des documents html standards. Elle n'affecte que
+ les fichiers dont le <a class="glossarylink" href="../glossary.html#type mime" title="voir glossaire">type MIME</a> est
+ <code>text/html</code>. <code class="directive">XBitHack</code> peut prendre
+ les valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
- <dd>No special treatment of executable files.</dd>
+ <dd>Aucun traitement particulier pour les fichiers
+ exécutables.</dd>
<dt><code>on</code></dt>
- <dd>Any <code>text/html</code> file that has the user-execute bit
- set will be treated as a server-parsed html document.</dd>
+ <dd>Tout fichier <code>text/html</code> dont le bit d'exécution
+ est positionné pour le propriétaire sera traité en tant que
+ document html interprété par le serveur.</dd>
<dt><code>full</code></dt>
- <dd>As for <code>on</code> but also test the group-execute bit.
- If it is set, then set the <code>Last-modified</code> date of the
- returned file to be the last modified time of the file. If
- it is not set, then no last-modified date is sent. Setting
- this bit allows clients and proxies to cache the result of
- the request.
+ <dd>Identique à <code>on</code>, avec test du bit d'exécution pour
+ le groupe. Si ce dernier est positionné, la date de <code>dernière
+ modification</code> du fichier renvoyé est définie à la date de
+ dernière modification du fichier. Dans le cas contraire, aucune
+ date de dernière modification n'est renvoyée. Le positionnement de
+ ce bit permet aux clients et aux mandataires de gérer la mise en
+ cache du résultat de la requête.
<div class="note"><h3>Note</h3>
- <p>You would not want to use the full option, unless you assure the
- group-execute bit is unset for every SSI script which might <code>#include</code> a CGI or otherwise produces different output on
- each hit (or could potentially change on subsequent requests).</p>
-
- <p>The <code class="directive"><a href="#ssilastmodified">SSILastModified</a></code>
- directive takes precedence over the
- <code class="directive"><a href="#xbithack">XBitHack</a></code> directive when
- <code class="directive"><a href="#ssilastmodified">SSILastModified</a></code> is set to
- <code>on</code>.</p>
+ <p>Il est recommandé de n'utiliser l'option full que dans le cas
+ où vous êtes certain que le bit d'exécution du groupe est non
+ positionné pour les scripts SSI qui pourraient effectuer l'<code>#include</code> d'un programme CGI ou bien produire des sorties
+ différentes à chaque accès (ou seraient susceptibles d'être
+ modifiées au cours des requêtes ultérieures).</p>
+
+ <p>Lorsqu'elle est définie à <code>on</code>, la directive
+ <code class="directive"><a href="#ssilastmodified">SSILastModified</a></code>
+ l'emporte sur la directive <code class="directive"><a href="#xbithack">XBitHack</a></code>.</p>
</div>
</dd>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addmoduleinfo" id="addmoduleinfo">Directive</a> <a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adds additional information to the module
-information displayed by the server-info handler</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>module-name</var> <var>string</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
+module affichées par le gestionnaire server-info</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>nom-module</var> <var>chaîne</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
</table>
- <p>This allows the content of <var>string</var> to be shown as
- HTML interpreted, <strong>Additional Information</strong> for
- the module <var>module-name</var>. Example:</p>
+ <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
+ en tant qu'<strong>Information supplémentaire</strong> interprétée
+ en HTML pour le module <var>nom-module</var>. Exemple :</p>
<pre class="prettyprint lang-config">AddModuleInfo mod_deflate.c 'See <a \
href="http://httpd.apache.org/docs/trunk/mod/mod_deflate.html">\
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="isapiappendlogtoerrors" id="isapiappendlogtoerrors">Directive</a> <a name="ISAPIAppendLogToErrors" id="ISAPIAppendLogToErrors">ISAPIAppendLogToErrors</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
-ISAPI extensions to the error log</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistrement des requêtes
+<code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions ISAPI
+dans le journal des erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIAppendLogToErrors on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ISAPIAppendLogToErrors 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI
- extensions to the server error log.</p>
+ <p>Cette directive permet d'enregistrer les requêtes
+ <code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions
+ ISAPI dans le journal des erreurs.</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="isapiappendlogtoquery" id="isapiappendlogtoquery">Directive</a> <a name="ISAPIAppendLogToQuery" id="ISAPIAppendLogToQuery">ISAPIAppendLogToQuery</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
-ISAPI extensions to the query field</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les requêtes
+<code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions ISAPI
+dans la partie arguments de la requête</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIAppendLogToQuery on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ISAPIAppendLogToQuery 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>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI
- extensions to the query field (appended to the <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> <code>%q</code>
- component).</p>
+ <p>Cette directive permet d'enregistrer les requêtes
+ <code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions
+ ISAPI dans la partie arguments de la requête (ajouté au composant
+ <code>%q</code> de la directive <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</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="isapicachefile" id="isapicachefile">Directive</a> <a name="ISAPICacheFile" id="ISAPICacheFile">ISAPICacheFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>ISAPI .dll files to be loaded at startup</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPICacheFile <var>file-path</var> [<var>file-path</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichiers .dll ISAPI devant être chargés au
+démarrage</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPICacheFile <var>chemin-fichier</var>
+[<var>chemin-fichier</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>Specifies a space-separated list of file names to be loaded
- when the Apache server is launched, and remain loaded until the
- server is shut down. This directive may be repeated for every
- ISAPI .dll file desired. The full path name of each file should
- be specified. If the path name is not absolute, it will be treated
- relative to <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
+ <p>Cette directive permet de spécifier une liste, séparés par des
+ espaces, de noms de fichiers devant être chargés au démarrage
+ du serveur Apache, et rester en mémoire jusqu'à l'arrêt du serveur.
+ Cette directive peut être répétée pour chaque fichier .dll ISAPI
+ souhaité. Le chemin complet du fichier doit être spécifié. Si le
+ chemin n'est pas absolu, il sera considéré comme relatif au
+ répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</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="isapifakeasync" id="isapifakeasync">Directive</a> <a name="ISAPIFakeAsync" id="ISAPIFakeAsync">ISAPIFakeAsync</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake asynchronous support for ISAPI callbacks</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Emulation du support des entrées/sorties asynchrones pour
+les appels ISAPI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIFakeAsync on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ISAPIFakeAsync 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>While set to on, asynchronous support for ISAPI callbacks is
- simulated.</p>
+ <p>Lorsquelle est définie à "on", cette directive permet d'émuler le
+ support des entrées/sorties asynchrones pour les appels ISAPI.</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="isapilognotsupported" id="isapilognotsupported">Directive</a> <a name="ISAPILogNotSupported" id="ISAPILogNotSupported">ISAPILogNotSupported</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Log unsupported feature requests from ISAPI
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Journalisation des demandes de fonctionnalités non
+supportées de la part des extensions ISAPI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPILogNotSupported on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ISAPILogNotSupported 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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>Logs all requests for unsupported features from ISAPI
- extensions in the server error log. This may help administrators
- to track down problems. Once set to on and all desired ISAPI modules
- are functioning, it should be set back to off.</p>
+ <p>Cette directive permet d'enregistrer dans le journal des erreurs
+ toutes les demandes de fonctionnalités non supportées de la part des
+ extensions ISAPI. Ceci peut aider les administrateurs à décortiquer
+ certains problèmes. Lorsqu'elle a été définie à "on" et si tous les
+ modules ISAPI fonctionnent, elle peut être redéfinie à "off".</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="isapireadaheadbuffer" id="isapireadaheadbuffer">Directive</a> <a name="ISAPIReadAheadBuffer" id="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size of the Read Ahead Buffer sent to ISAPI
-extensions</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIReadAheadBuffer <var>size</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon de lecture anticipée envoyé aux extensions
+ISAPI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIReadAheadBuffer <var>taille</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ISAPIReadAheadBuffer 49152</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
</table>
- <p>Defines the maximum size of the Read Ahead Buffer sent to
- ISAPI extensions when they are initially invoked. All remaining
- data must be retrieved using the <code>ReadClient</code> callback; some
- ISAPI extensions may not support the <code>ReadClient</code> function.
- Refer questions to the ISAPI extension's author.</p>
+ <p>Cette directive permet de définir la taille maximale du tampon de
+ lecture anticipée envoyé aux extensions ISAPI lorsqu'elles sont
+ initialement invoquées. Toute donnée restante doit être extraite en
+ faisant appel à <code>ReadClient</code> ; certaines extensions ISAPI
+ peuvent ne pas supporter la fonction <code>ReadClient</code>.
+ Pour plus de détails, veuillez vous adresser à l'auteur de
+ l'extension ISAPI.</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="heartbeatstorage" id="heartbeatstorage">Directive</a> <a name="HeartbeatStorage" id="HeartbeatStorage">HeartbeatStorage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to read heartbeat data</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatStorage <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Indique le chemin permettant de lire les données
+heartbeat</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeartbeatStorage <var>chemin-fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HeartbeatStorage logs/hb.dat</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lbmethod_heartbeat</td></tr>
</table>
- <p>The <code class="directive">HeartbeatStorage</code> directive specifies the
- path to read heartbeat data. This flat-file is used only when
- <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code> is not loaded.</p>
+ <p>La directive <code class="directive">HeartbeatStorage</code> permet de
+ spécifier le chemin d'accès aux données heartbeat. Ce fichier texte
+ n'est utilisé que si le module <code class="module"><a href="../mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code>
+ n'est pas chargé.</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="ldapcacheentries" id="ldapcacheentries">Directive</a> <a name="LDAPCacheEntries" id="LDAPCacheEntries">LDAPCacheEntries</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of entries in the primary LDAP cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheEntries <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum d'entrées dans le cache LDAP
+primaire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheEntries <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPCacheEntries 1024</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies the maximum size of the primary LDAP cache. This
- cache contains successful search/binds. Set it to 0 to turn off
- search/bind caching. The default size is 1024 cached
- searches.</p>
+ <p>Cette directive permet de spécifier la taille maximale du cache
+ LDAP primaire. Ce cache contient les résultats de
+ recherche/identification positifs. Définissez-la à 0 pour désactiver
+ la mise en cache des résultats de recherche/identification positifs.
+ La taille par défaut est de 1024 recherches en cache.</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="ldapcachettl" id="ldapcachettl">Directive</a> <a name="LDAPCacheTTL" id="LDAPCacheTTL">LDAPCacheTTL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time that cached items remain valid</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheTTL <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle les entrées du cache restent
+valides.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheTTL <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPCacheTTL 600</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies the time (in seconds) that an item in the
- search/bind cache remains valid. The default is 600 seconds (10
+ <p>Cette directive permet de spécifier la durée (en secondes)
+ pendant laquelle une entrée du cache de recherche/identification
+ reste valide. La valeur par défaut est de 600 secondes (10
minutes).</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="ldapconnectionpoolttl" id="ldapconnectionpoolttl">Directive</a> <a name="LDAPConnectionPoolTTL" id="LDAPConnectionPoolTTL">LDAPConnectionPoolTTL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Discard backend connections that have been sitting in the connection pool too long</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive les connexions d'arrière-plan qui sont restées
+inactives trop longtemps au sein du jeu de connexions.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPConnectionPoolTTL <var>n</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPConnectionPoolTTL -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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.3.12 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.12 du serveur HTTP
+Apache</td></tr>
</table>
- <p>Specifies the maximum age, in seconds, that a pooled LDAP connection can remain idle
- and still be available for use. Connections are cleaned up when they are next needed,
- not asynchronously.</p>
-
- <p>A setting of 0 causes connections to never be saved in the backend
- connection pool. The default value of -1, and any other negative value,
- allows connections of any age to be reused.</p>
-
- <p>For performance reasons, the reference time used by this directive is
- based on when the LDAP connection is returned to the pool, not the time
- of the last successful I/O with the LDAP server. </p>
-
- <p>Since 2.4.10, new measures are in place to avoid the reference time
- from being inflated by cache hits or slow requests. First, the reference
- time is not updated if no backend LDAP conncetions were needed. Second,
- the reference time uses the time the HTTP request was received instead
- of the time the request is completed.</p>
-
- <div class="note"><p>This timeout defaults to units of seconds, but accepts
- suffixes for milliseconds (ms), minutes (min), and hours (h).
+ <p>Cette directive permet de spécifier la durée maximale, en
+ secondes, pendant laquelle une connexion LDAP du jeu de connexions
+ peut demeurer inactive, mais rester quand-même disponible pour une
+ utilisation éventuelle. Le jeu de connexions est nettoyé au fur et à
+ mesure des besoins, de manière non asynchrone.</p>
+
+ <p>Si cette directive est définie à 0, les connexions ne sont jamais
+ sauvegardées dans le jeu de connexions d'arrière-plan. Avec la
+ valeur par défaut -1, ou toute autre valeur négative, les connexions
+ peuvent être réutilisées sans limite de durée.</p>
+
+ <p>Dans le but d'améliorer les performances, le temps de référence
+ qu'utilise cette directive correspond au moment où la connexion LDAP
+ est enregistrée ou remise dans le jeu de connexions, et non au
+ moment du dernier échange réussi avec le serveur LDAP.</p>
+
+ <p>La version 2.4.10 a introduit de nouvelles mesures permettant
+ d'éviter une augmentation excessive du temps de référence due à des
+ correspondances positives dans le cache ou des requêtes lentes. A
+ cet effet, le temps de référence n'est pas réactualisé si aucune
+ connexion LDAP d'arrière-plan n'est requise ; d'autre part, le temps
+ de référence se base sur le moment où la requête HTTP est reçue, et
+ non sur le moment où la requête a été traitée.</p>
+
+ <div class="note"><p>Cette durée de vie s'exprime par défaut en secondes, mais
+ il est possible d'utiliser d'autres unités en ajoutant un suffixe :
+ millisecondes (ms), minutes (min), ou heures (h).
</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="ldapconnectiontimeout" id="ldapconnectiontimeout">Directive</a> <a name="LDAPConnectionTimeout" id="LDAPConnectionTimeout">LDAPConnectionTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the socket connection timeout in seconds</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPConnectionTimeout <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le délai d'attente en secondes de la socket de
+connexion</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPConnectionTimeout <var>secondes</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>This directive configures the LDAP_OPT_NETWORK_TIMEOUT (or LDAP_OPT_CONNECT_TIMEOUT)
- option in the underlying LDAP client library, when available. This value
- typically controls how long the LDAP client library will wait for the TCP
- connection to the LDAP server to complete.</p>
-
- <p> If a connection is not successful with the timeout period, either an error will be
- returned or the LDAP client library will attempt to connect to a secondary LDAP
- server if one is specified (via a space-separated list of hostnames in the
- <code class="directive"><a href="../mod/mod_authnz_ldap.html#authldapurl">AuthLDAPURL</a></code>).</p>
-
- <p>The default is 10 seconds, if the LDAP client library linked with the
- server supports the LDAP_OPT_NETWORK_TIMEOUT option.</p>
-
- <div class="note">LDAPConnectionTimeout is only available when the LDAP client library linked
- with the server supports the LDAP_OPT_NETWORK_TIMEOUT
- (or LDAP_OPT_CONNECT_TIMEOUT) option, and the ultimate behavior is
- dictated entirely by the LDAP client library.
+ <p>Cette directive configure l'option LDAP_OPT_NETWORK_TIMEOUT (ou
+ LDAP_OPT_CONNECT_TIMEOUT) dans la bibliothèque client LDAP
+ sous-jacente, si elle est disponible. Cette valeur représente la
+ durée pendant laquelle la bibliothèque client LDAP va attendre que
+ le processus de connexion TCP au serveur LDAP soit achevé.</p>
+
+ <p>Si la connexion n'a pas réussi avant ce délai, une erreur sera
+ renvoyée, ou la bibliothèque client LDAP tentera de se connecter à
+ un second serveur LDAP, s'il en a été défini un (via une liste de
+ noms d'hôtes séparés par des espaces dans la directive <code class="directive"><a href="../mod/mod_authnz_ldap.html#authldapurl">AuthLDAPURL</a></code>).</p>
+
+ <p>La valeur par défaut est 10 secondes, si la bibliothèque client
+ LDAP liée avec le serveur supporte l'option
+ LDAP_OPT_NETWORK_TIMEOUT.</p>
+
+ <div class="note">LDAPConnectionTimeout n'est disponible que si la bibliothèque client
+ LDAP liée avec le serveur supporte l'option
+ LDAP_OPT_NETWORK_TIMEOUT (ou LDAP_OPT_CONNECT_TIMEOUT), et le
+ comportement final est entièrement dicté par la bibliothèque client
+ LDAP.
</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="ldaplibrarydebug" id="ldaplibrarydebug">Directive</a> <a name="LDAPLibraryDebug" id="LDAPLibraryDebug">LDAPLibraryDebug</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable debugging in the LDAP SDK</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le débogage dans le SDK LDAP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPLibraryDebug <var>7</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>disabled</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Turns on SDK-specific LDAP debug options that generally cause the LDAP
- SDK to log verbose trace information to the main Apache error log.
- The trace messages from the LDAP SDK provide gory details that
- can be useful during debugging of connectivity problems with backend LDAP servers</p>
-
- <p>This option is only configurable when Apache HTTP Server is linked with
- an LDAP SDK that implements <code>LDAP_OPT_DEBUG</code> or
- <code>LDAP_OPT_DEBUG_LEVEL</code>, such as OpenLDAP (a value of 7 is verbose)
- or Tivoli Directory Server (a value of 65535 is verbose).</p>
+ <p>Active les options de débogage LDAP spécifiques au SDK, qui
+ entraînent en général une journalisation d'informations verbeuses du
+ SDK LDAP dans le journal principal des erreurs d'Apache. Les
+ messages de traces en provenance du SDK LDAP fournissent des
+ informations très détaillées qui peuvent s'avérer utiles lors du
+ débogage des problèmes de connexion avec des serveurs LDAP
+ d'arrière-plan.</p>
+
+ <p>Cette option n'est configurable que lorsque le serveur HTTP
+ Apache est lié avec un SDK LDAP qui implémente
+ <code>LDAP_OPT_DEBUG</code> ou <code>LDAP_OPT_DEBUG_LEVEL</code>,
+ comme OpenLDAP (une valeur de 7 est verbeuse) ou Tivoli Directory
+ Server (une valeur de 65535 est verbeuse).</p>
<div class="warning">
- <p>The logged information will likely contain plaintext credentials being used or
- validated by LDAP authentication, so care should be taken in protecting and purging
- the error log when this directive is used.</p>
+ <p>Les informations journalisées peuvent contenir des données
+ d'authentification en clair utilisées ou validées lors de
+ l'authentification LDAP ; vous devez donc prendre soin de protéger
+ et de purger le journal des erreurs lorsque cette directive est
+ 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="ldapopcacheentries" id="ldapopcacheentries">Directive</a> <a name="LDAPOpCacheEntries" id="LDAPOpCacheEntries">LDAPOpCacheEntries</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of entries used to cache LDAP compare
-operations</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheEntries <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre d'entrées utilisées pour mettre en cache les
+opérations de comparaison LDAP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheEntries <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPOpCacheEntries 1024</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>This specifies the number of entries <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>
- will use to cache LDAP compare operations. The default is 1024
- entries. Setting it to 0 disables operation caching.</p>
+ <p>Cette directive permet de spécifier le nombre d'entrées que
+ <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> va utiliser pour mettre en cache les
+ opérations de comparaison LDAP. La valeur par défaut est de 1024
+ entrées. Si elle est définie à 0, la mise en cache des opérations de
+ comparaison LDAP est désactivé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="ldapopcachettl" id="ldapopcachettl">Directive</a> <a name="LDAPOpCacheTTL" id="LDAPOpCacheTTL">LDAPOpCacheTTL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Time that entries in the operation cache remain
-valid</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheTTL <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle les entrées du cache d'opérations
+restent valides</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheTTL <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPOpCacheTTL 600</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies the time (in seconds) that entries in the
- operation cache remain valid. The default is 600 seconds.</p>
+ <p>Cette directive permet de spécifier la durée (en secondes)
+ pendant laquelle les entrées du cache d'opérations restent valides.
+ La valeur par défaut est de 600 secondes.</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="ldapreferralhoplimit" id="ldapreferralhoplimit">Directive</a> <a name="LDAPReferralHopLimit" id="LDAPReferralHopLimit">LDAPReferralHopLimit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum number of referral hops to chase before terminating an LDAP query.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPReferralHopLimit <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SDK dependent, typically between 5 and 10</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre maximum de redirections vers des serveurs
+alternatifs (referrals) avant l'abandon de la requête
+LDAP.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPReferralHopLimit <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Dépend du SDK, en général entre 5 et 10</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>This directive, if enabled by the <code class="directive">LDAPReferrals</code> directive,
- limits the number of referral hops that are followed before terminating an
- LDAP query.</p>
+ <p>Si elle est activée par la directive <code class="directive">LDAPReferrals</code>,
+ cette directive permet de définir le nombre maximum de sauts vers
+ des serveurs alternatifs (referrals) avant l'abandon de la requête
+ LDAP.</p>
<div class="warning">
-<p> Support for this tunable is uncommon in LDAP SDKs.</p>
+<p>L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.</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="ldapreferrals" id="ldapreferrals">Directive</a> <a name="LDAPReferrals" id="LDAPReferrals">LDAPReferrals</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable referral chasing during queries to the LDAP server.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la redirection vers des serveurs alternatifs au
+cours des requêtes vers le serveur LDAP.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPReferrals <var>On|Off|default</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPReferrals On</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The <var>default</var> parameter is available in Apache 2.4.7 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le paramètre <var>default</var> est disponible depuis la
+version 2.4.7 du serveur HTTP Apache.</td></tr>
</table>
- <p>Some LDAP servers divide their directory among multiple domains and use referrals
- to direct a client when a domain boundary is crossed. This is similar to a HTTP redirect.
- LDAP client libraries may or may not chase referrals by default. This directive
- explicitly configures the referral chasing in the underlying SDK.</p>
+ <p>Certains serveurs LDAP partagent leur annuaire en plusieurs
+ domaines et utilisent le système des redirections (referrals) pour
+ aiguiller un client lorsque les limites d'un domaine doivent être
+ franchies. Ce processus est similaire à une redirection HTTP. Les
+ bibliothèques client LDAP ne respectent pas forcément ces
+ redirections par défaut. Cette directive permet de configurer
+ explicitement les redirections LDAP dans le SDK sous-jacent.</p>
+ <p>La directive <code class="directive">LDAPReferrals</code> accepte les
+ valeurs suivantes :</p>
- <p><code class="directive">LDAPReferrals</code> takes the following values:</p>
<dl>
<dt>"on"</dt>
- <dd> <p> When set to "on", the underlying SDK's referral chasing state
- is enabled, <code class="directive">LDAPReferralHopLimit</code> is used to
- override the SDK's hop limit, and an LDAP rebind callback is
- registered.</p></dd>
+ <dd> <p>Avec la valeur "on", la prise en compte des redirections
+ LDAP par le SDK sous-jacent est activée, la directive
+ <code class="directive">LDAPReferralHopLimit</code> permet de surcharger la
+ "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.</p></dd>
<dt>"off"</dt>
- <dd> <p> When set to "off", the underlying SDK's referral chasing state
- is disabled completely.</p></dd>
+ <dd> <p>Avec la valeur "off", la prise en compte des redirections
+ LDAP par le SDK sous-jacent est complètement désactivée.</p></dd>
<dt>"default"</dt>
- <dd> <p> When set to "default", the underlying SDK's referral chasing state
- is not changed, <code class="directive">LDAPReferralHopLimit</code> is not
- used to overide the SDK's hop limit, and no LDAP rebind callback is
- registered.</p></dd>
+ <dd> <p>Avec la valeur "default", la prise en compte des redirections
+ LDAP par le SDK sous-jacent n'est pas modifiée, la directive
+ <code class="directive">LDAPReferralHopLimit</code> ne permet pas de surcharger la
+ "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.</p></dd>
</dl>
-
- <p>The directive <code class="directive">LDAPReferralHopLimit</code> works in conjunction with
- this directive to limit the number of referral hops to follow before terminating the LDAP query.
- When referral processing is enabled by a value of "On", client credentials will be provided,
- via a rebind callback, for any LDAP server requiring them.</p>
+
+ <p>La directive <code class="directive">LDAPReferralHopLimit</code> travaille en
+ conjonction avec cette directive pour limiter le nombre de
+ redirections à suivre pour achever le traitement de la requête LDAP.
+ Lorsque le processus de redirection est activé par la valeur "On",
+ les données d'authentification du client sont transmises via un
+ "rebind callback" à tout serveur LDAP qui en fait la demande.</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="ldapretries" id="ldapretries">Directive</a> <a name="LDAPRetries" id="LDAPRetries">LDAPRetries</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the number of LDAP server retries.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetries <var>number-of-retries</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nombre maximum de tentatives de connexions au
+serveur LDAP.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetries <var>nombre d'essais</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPRetries 3</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>The server will retry failed LDAP requests up to
- <code class="directive">LDAPRetries</code> times. Setting this
- directive to 0 disables retries.</p>
- <p>LDAP errors such as timeouts and refused connections are retryable.</p>
+ <p>Suite à des échecs de connexion au serveur LDAP, le serveur
+ tentera de se connecter autant de fois qu'indiqué par la directive
+ <code class="directive">LDAPRetries</code>. Si cette directive est définie à
+ 0, le serveur ne tentera pas d'autre connexion après un échec.</p>
+ <p>Il est possible d'effectuer une autre tentative de connexion en
+ cas d'erreurs LDAP du type délai dépassé ou connexion refusé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="ldapretrydelay" id="ldapretrydelay">Directive</a> <a name="LDAPRetryDelay" id="LDAPRetryDelay">LDAPRetryDelay</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the delay between LDAP server retries.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetryDelay <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le temps d'attente avant un autre essai de connexion au
+serveur LDAP.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetryDelay <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPRetryDelay 0</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>If <code class="directive">LDAPRetryDelay</code> is set to a non-zero
- value, the server will delay retrying an LDAP request for the
- specified amount of time. Setting this directive to 0 will
- result in any retry to occur without delay.</p>
+ <p>Si la directive <code class="directive">LDAPRetryDelay</code> est définie
+ à une valeur différente de 0, le serveur attendra pendant la durée
+ spécifiée pour envoyer à nouveau sa requête LDAP. Une valeur de 0
+ implique une absence de délai pour les essais successifs.</p>
- <p>LDAP errors such as timeouts and refused connections are retryable.</p>
+ <p>Il est possible d'effectuer une autre tentative de connexion en
+ cas d'erreurs LDAP du type délai dépassé ou connexion refusé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="ldapsharedcachefile" id="ldapsharedcachefile">Directive</a> <a name="LDAPSharedCacheFile" id="LDAPSharedCacheFile">LDAPSharedCacheFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the shared memory cache file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le fichier du cache en mémoire
+partagée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheFile <var>chemin-fichier</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies the path of the shared memory cache file. If not set,
- anonymous shared memory will be used if the platform supports it.</p>
+ <p>Cette directive permet de spécifier le chemin du
+ fichier du cache en mémoire partagée. Si elle n'est pas définie, la
+ mémoire partagée anonyme sera utilisée si la plate-forme la
+ supporte.</p>
- <p>If <var>file-path</var> is not an absolute path, the location specified
- will be relative to the value of
- <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
+ <p>Si <var>chemin-fichier</var> n'est pas un chemin absolu, il sera
+ relatif au répertoire défini via la directive <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</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="ldapsharedcachesize" id="ldapsharedcachesize">Directive</a> <a name="LDAPSharedCacheSize" id="LDAPSharedCacheSize">LDAPSharedCacheSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Size in bytes of the shared-memory cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille en octets du cache en mémoire partagée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPSharedCacheSize 500000</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies the number of bytes to allocate for the shared
- memory cache. The default is 500kb. If set to 0, shared memory
- caching will not be used and every HTTPD process will create its
- own cache.</p>
+ <p>Cette directive permet de spécifier le nombre d'octets à allouer
+ pour le cache en mémoire partagée. La valeur par
+ défaut est 500kb.
+ Si elle est définie à 0, le cache en mémoire partagée ne sera pas
+ utilisé et chaque processus HTTPD va créer son propre cache.</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="ldaptimeout" id="ldaptimeout">Directive</a> <a name="LDAPTimeout" id="LDAPTimeout">LDAPTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the timeout for LDAP search and bind operations, in seconds</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTimeout <var>seconds</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le délai d'attente pour les opérations de
+recherche et d'identification LDAP en secondes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTimeout <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPTimeout 60</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.3.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.5 du serveur HTTP
+Apache</td></tr>
</table>
- <p>This directive configures the timeout for bind and search operations, as well as
- the LDAP_OPT_TIMEOUT option in the underlying LDAP client library, when available.</p>
+ <p>Cette directive permet de spécifier le délai d'attente pour les
+ opérations de recherche et d'identification, ainsi que l'option
+ LDAP_OPT_TIMEOUT dans la bibliothèque LDAP client sous-jacente,
+ lorsqu'elle est disponible.</p>
- <p> If the timeout expires, httpd will retry in case an existing connection has
- been silently dropped by a firewall. However, performance will be much better if
- the firewall is configured to send TCP RST packets instead of silently dropping
- packets.</p>
+ <p>Lorsque le délai est atteint, httpd va refaire un essai dans le
+ cas où une connexion existante a été silencieusement fermée par un
+ pare-feu. Les performances seront cependant bien meilleures si le
+ pare-feu est configuré pour envoyer des paquets TCP RST au lieu de
+ rejeter silencieusement les paquets.</p>
<div class="note">
- <p>Timeouts for ldap compare operations requires an SDK with LDAP_OPT_TIMEOUT, such as OpenLDAP >= 2.4.4.</p>
+ <p>Les délais pour les opérations de comparaison LDAP nécessitent un
+ SDK avec LDAP_OPT_TIMEOUT, comme OpenLDAP >= 2.4.4.</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="ldaptrustedclientcert" id="ldaptrustedclientcert">Directive</a> <a name="LDAPTrustedClientCert" id="LDAPTrustedClientCert">LDAPTrustedClientCert</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the file containing or nickname referring to a per
-connection client certificate. Not all LDAP toolkits support per
-connection client certificates.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedClientCert <var>type</var> <var>directory-path/filename/nickname</var> <var>[password]</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#Description">Description:</a></th><td>Définit le nom de fichier contenant un certificat client ou
+un alias renvoyant vers un certificat client spécifique à une connexion.
+Tous les SDK LDAP ne supportent pas les certificats clients par
+connexion.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedClientCert <var>type</var>
+<var>chemin/nom-fichier/alias</var> <var>[mot de passe]</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>It specifies the directory path, file name or nickname of a
- per connection client certificate used when establishing an SSL
- or TLS connection to an LDAP server. Different locations or
- directories may have their own independent client certificate
- settings. Some LDAP toolkits (notably Novell)
- do not support per connection client certificates, and will throw an
- error on LDAP server connection if you try to use this directive
- (Use the LDAPTrustedGlobalCert directive instead for Novell client
- certificates - See the SSL/TLS certificate guide above for details).
- The type specifies the kind of certificate parameter being
- set, depending on the LDAP toolkit being used. Supported types are:</p>
+ <p>Cette directive permet de spécifier le chemin et le nom de
+ fichier ou l'alias d'un certificat client par connexion utilisé lors
+ de l'établissement d'une connexion SSL ou TLS avec un serveur LDAP.
+ Les sections directory ou location peuvent posséder leurs propres
+ configurations de certificats clients. Certains SDK LDAP (en
+ particulier Novell) ne supportent pas les certificats clients par
+ connexion, et renvoient une erreur lors de la connexion au serveur
+ LDAP si vous tenter d'utiliser cette directive (Utilisez à la place
+ la directive LDAPTrustedGlobalCert pour les certificats clients sous
+ Novell - Voir plus haut le guide des certificats SSL/TLS pour plus
+ de détails). Le paramètre type spécifie le type du certificat en
+ cours de définition, en fonction du SDK LDAP utilisé. Les types
+ supportés sont :</p>
<ul>
- <li>CA_DER - binary DER encoded CA certificate</li>
- <li>CA_BASE64 - PEM encoded CA certificate</li>
- <li>CERT_DER - binary DER encoded client certificate</li>
- <li>CERT_BASE64 - PEM encoded client certificate</li>
- <li>CERT_NICKNAME - Client certificate "nickname" (Netscape SDK)</li>
- <li>KEY_DER - binary DER encoded private key</li>
- <li>KEY_BASE64 - PEM encoded private key</li>
+ <li>CA_DER - certificat de CA codé en binaire DER</li>
+ <li>CA_BASE64 - certificat de CA codé en PEM</li>
+ <li>CERT_DER - certificat client codé en binaire DER</li>
+ <li>CERT_BASE64 - certificat client codé en PEM</li>
+ <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li>
+ <li>KEY_DER - clé privée codée en binaire DER</li>
+ <li>KEY_BASE64 - clé privée codée en PEM</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="ldaptrustedglobalcert" id="ldaptrustedglobalcert">Directive</a> <a name="LDAPTrustedGlobalCert" id="LDAPTrustedGlobalCert">LDAPTrustedGlobalCert</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the file or database containing global trusted
-Certificate Authority or global client certificates</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedGlobalCert <var>type</var> <var>directory-path/filename</var> <var>[password]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom de fichier ou la base de données contenant
+les Autorités de Certification de confiance globales ou les certificats
+clients globaux</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedGlobalCert <var>type</var>
+<var>chemin/nom-fichier</var> <var>[mot de passe]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>It specifies the directory path and file name of the trusted CA
- certificates and/or system wide client certificates <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>
- should use when establishing an SSL or TLS connection to an LDAP
- server. Note that all certificate information specified using this directive
- is applied globally to the entire server installation. Some LDAP toolkits
- (notably Novell) require all client certificates to be set globally using
- this directive. Most other toolkits require clients certificates to be set
- per Directory or per Location using LDAPTrustedClientCert. If you get this
- wrong, an error may be logged when an attempt is made to contact the LDAP
- server, or the connection may silently fail (See the SSL/TLS certificate
- guide above for details).
- The type specifies the kind of certificate parameter being
- set, depending on the LDAP toolkit being used. Supported types are:</p>
+ <p>Cette directive permet de spécifier le chemin et le nom du
+ fichier contenant les certificats des CA de confiance et/ou les
+ certificats clients du système global que <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>
+ utilisera pour établir une connexion SSL ou TLS avec un serveur
+ LDAP. Notez que toute information relative aux certificats spécifiée
+ en utilisant cette directive s'applique globalement à l'ensemble de
+ l'installation du serveur. Certains SDK LDAP (en particulier Novell)
+ nécessitent la définition globale de tous les certificats clients en
+ utilisant cette directive. La plupart des autres SDK nécessitent la
+ définition des certificats clients dans une section Directory ou
+ Location en utilisant la directive LDAPTrustedClientCert. Si vous ne
+ définissez pas ces directives correctement, une erreur sera générée
+ lors des tentatives de contact avec un serveur LDAP, ou la connexion
+ échouera silencieusement (Voir plus haut le guide des certificats
+ SSL/TLS pour plus de détails). Le paramètre type spécifie le type de
+ certificat en cours de définition, en fonction du SDK LDAP utilisé.
+ Les types supportés sont :</p>
<ul>
- <li>CA_DER - binary DER encoded CA certificate</li>
- <li>CA_BASE64 - PEM encoded CA certificate</li>
- <li>CA_CERT7_DB - Netscape cert7.db CA certificate database file</li>
- <li>CA_SECMOD - Netscape secmod database file</li>
- <li>CERT_DER - binary DER encoded client certificate</li>
- <li>CERT_BASE64 - PEM encoded client certificate</li>
- <li>CERT_KEY3_DB - Netscape key3.db client certificate database file</li>
- <li>CERT_NICKNAME - Client certificate "nickname" (Netscape SDK)</li>
- <li>CERT_PFX - PKCS#12 encoded client certificate (Novell SDK)</li>
- <li>KEY_DER - binary DER encoded private key</li>
- <li>KEY_BASE64 - PEM encoded private key</li>
- <li>KEY_PFX - PKCS#12 encoded private key (Novell SDK)</li>
+ <li>CA_DER - certificat de CA codé en binaire DER</li>
+ <li>CA_BASE64 - certificat de CA codé en PEM</li>
+ <li>CA_CERT7_DB - fichier de base de données des certificats de CA
+ de Netscape cert7.db</li>
+ <li>CA_SECMOD - fichier de base de données secmod de Netscape</li>
+ <li>CERT_DER - certificat client codé en binaire DER</li>
+ <li>CERT_BASE64 - certificat client codé en PEM</li>
+ <li>CERT_KEY3_DB - fichier de base de données des certificats
+ clients de Netscape key3.db</li>
+ <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li>
+ <li>CERT_PFX - certificat client codé en PKCS#12 (SDK Novell)</li>
+ <li>KEY_DER - clé privée codée en binaire DER</li>
+ <li>KEY_BASE64 - clé privée codée en PEM</li>
+ <li>KEY_PFX - clé privée codée en PKCS#12 (SDK Novell)</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="ldaptrustedmode" id="ldaptrustedmode">Directive</a> <a name="LDAPTrustedMode" id="LDAPTrustedMode">LDAPTrustedMode</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specifies the SSL/TLS mode to be used when connecting to an LDAP server.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le mode (SSL ou TLS) à utiliser lors de la
+connexion à un serveur LDAP.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedMode <var>type</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>The following modes are supported:</p>
+ <p>Les modes suivants sont supportés :</p>
<ul>
- <li>NONE - no encryption</li>
- <li>SSL - ldaps:// encryption on default port 636</li>
- <li>TLS - STARTTLS encryption on default port 389</li>
+ <li>NONE - aucun chiffrement</li>
+ <li>SSL - chiffrement ldaps:// sur le port par défaut 636</li>
+ <li>TLS - chiffrement STARTTLS sur le port par défaut 389</li>
</ul>
- <p>Not all LDAP toolkits support all the above modes. An error message
- will be logged at runtime if a mode is not supported, and the
- connection to the LDAP server will fail.
+ <p>Les modes ci-dessus ne sont pas supportés par tous les SDK LDAP.
+ Un message d'erreur sera généré à l'exécution si un mode n'est pas
+ supporté, et la connexion au serveur LDAP échouera.
</p>
- <p>If an ldaps:// URL is specified, the mode becomes SSL and the setting
- of LDAPTrustedMode is ignored.</p>
+ <p>Si une URL de type ldaps:// est spécifiée, le mode est forcé à
+ SSL et la définition de LDAPTrustedMode est ignoré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="ldapverifyservercert" id="ldapverifyservercert">Directive</a> <a name="LDAPVerifyServerCert" id="LDAPVerifyServerCert">LDAPVerifyServerCert</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force server certificate verification</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force la vérification du certificat du
+serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPVerifyServerCert <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LDAPVerifyServerCert On</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr>
</table>
- <p>Specifies whether to force the verification of a
- server certificate when establishing an SSL connection to the
- LDAP server.</p>
+ <p>Cette directive permet de spécifier s'il faut forcer la
+ vérification d'un certificat de serveur lors de l'établissement
+ d'une connexion SSL avec un serveur LDAP.</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="bufferedlogs" id="bufferedlogs">Directive</a> <a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Buffer log entries in memory before writing to disk</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les entrées du journal dans un tampon en mémoire
+avant de les écrire sur disque</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferedLogs On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BufferedLogs 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
- <p>The <code class="directive">BufferedLogs</code> directive causes
- <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> to store several log entries in
- memory and write them together to disk, rather than writing them
- after each request. On some systems, this may result in more
- efficient disk access and hence higher performance. It may be
- set only once for the entire server; it cannot be configured
- per virtual-host.</p>
-
- <div class="note">This directive should be used with caution as a crash might
- cause loss of logging data.</div>
+ <p>Lorsque la directive <code class="directive">BufferedLogs</code> est à
+ "on", <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> stocke de nombreuses entrées
+ du journal en mémoire, et les écrit d'un seul bloc sur disque,
+ plutôt que de les écrire après chaque requête. Sur certains
+ systèmes, ceci peut améliorer l'efficacité des accès disque, et par
+ conséquent les performances. La directive ne peut être définie
+ qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas être
+ définie au niveau d'un serveur virtuel.</p>
+
+ <div class="note">Cette directive doit être utilisée avec
+ précautions car un crash peut provoquer la perte de données de
+ journalisation.</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="customlog" id="customlog">Directive</a> <a name="CustomLog" id="CustomLog">CustomLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CustomLog <var>file</var>|<var>pipe</var>|<var>provider</var>
-<var>format</var>|<var>nickname</var>
-[env=[!]<var>environment-variable</var>|
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom et le format du fichier
+journal</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CustomLog <var>fichier</var>|<var>pipe</var>|<var>provider</var>
+<var>format</var>|<var>alias</var>
+[env=[!]<var>variable-environnement</var>|
expr=<var>expression</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
- <p>The <code class="directive">CustomLog</code> directive is used to
- log requests to the server. A log format is specified, and the
- logging can optionally be made conditional on request
- characteristics using environment variables.</p>
+ <p>La directive <code class="directive">CustomLog</code> permet de contrôler
+ la journalisation des requêtes destinées au serveur. Un format de
+ journal est spécifié, et la journalisation peut s'effectuer de
+ manière conditionnelle en fonction des caractéristiques de la
+ requête en utilisant des variables d'environnement.</p>
- <p>The first argument, which specifies the location to which
- the logs will be written, can take one of the following two
- types of values:</p>
+ <p>Le premier argument, qui spécifie l'emplacement où les journaux
+ seront écrits, accepte deux types de valeurs :</p>
<dl>
- <dt><var>file</var></dt>
- <dd>A filename, relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
+ <dt><var>fichier</var></dt>
+ <dd>Un nom de fichier, relatif au répertoire défini par la
+ directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
<dt><var>pipe</var></dt>
- <dd>The pipe character "<code>|</code>", followed by the path
- to a program to receive the log information on its standard
- input. See the notes on <a href="../logs.html#piped">piped logs</a>
- for more information.
-
- <div class="warning"><h3>Security:</h3>
- <p>If a program is used, then it will be run as the user who
- started <code class="program"><a href="../programs/httpd.html">httpd</a></code>. This will be root if the server was
- started by root; be sure that the program is secure.</p>
+ <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un
+ programme qui recevra les informations de la journalisation sur
+ son entrée standard. Voir les notes à propos de la <a href="../logs.html#piped">journalisation redirigée</a> pour plus
+ d'informations.
+
+ <div class="warning"><h3>Sécurité :</h3>
+ <p>Si les journaux sont redirigés vers un programme, ce dernier
+ s'exécutera sous l'utilisateur qui a démarré
+ <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur
+ a été démarré par root ; vérifiez que le programme est
+ sécurisé.</p>
</div>
<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 slashed 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
+ plate-formes non-Unix, il faut prendre soin de ne pas oublier
+ que seuls les slashes directs doivent être utilisés, même si la
+ plate-forme autorise l'emploi d'anti-slashes. D'une manière
+ générale, c'est une bonne idée que de n'utiliser que des slashes
+ directs dans les fichiers de configuration.</p>
</div></dd>
<dt><var>provider</var></dt>
- <dd>Modules implementing ErrorLog providers can also be used as a target
- for CustomLog messages. To use ErrorLog provider as a target,
- "provider:argument" syntax must be used. You can for example use
- <code class="module"><a href="../mod/mod_journald.html">mod_journald</a></code> or <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code>
- as a provider:
- <pre class="prettyprint lang-config"># CustomLog logging to journald
+ <dd>Les messages CustomLog peuvent aussi utiliser comme cible les
+ modules qui implémentent des fournisseurs ErrorLog. A cet effet,
+ utilisez la syntaxe "provider:argument". Comme fournisseur, vous
+ pouvez par exemple utiliser <code class="module"><a href="../mod/mod_journald.html">mod_journald</a></code> ou
+ <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code> :
+ <pre class="prettyprint lang-config"># Journalisation CustomLog vers journald
CustomLog "journald" "%h %l %u %t \"%r\" %>s %b"
-# CustomLog logging to syslog with "user" facility
+# Journalisation CustomLog vers syslog avec l'option "user"
CustomLog "syslog:user" "%h %l %u %t \"%r\" %>s %b"</pre>
</dd>
</dl>
- <p>The second argument specifies what will be written to the
- log file. It can specify either a <var>nickname</var> defined by
- a previous <code class="directive"><a href="#logformat">LogFormat</a></code>
- directive, or it can be an explicit <var>format</var> string as
- described in the <a href="#formats">log formats</a> section.</p>
+ <p>Le second argument permet de définir ce qui va être écrit dans le
+ fichier journal. Il peut contenir soit un <var>alias</var> prédéfini
+ par une directive <code class="directive"><a href="#logformat">LogFormat</a></code>, soit une chaîne de
+ <var>format</var> explicite comme décrit dans la section <a href="#formats">formats de journaux</a>.</p>
- <p>For example, the following two sets of directives have
- exactly the same effect:</p>
+ <p>Par exemple, les deux blocs de directives suivants produisent le
+ même effet :</p>
- <pre class="prettyprint lang-config"># CustomLog with format nickname
+ <pre class="prettyprint lang-config"># Journal personnalisé avec alias de format
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog "logs/access_log" common
-# CustomLog with explicit format string
+# Journal personnalisé avec chaîne de format explicite
CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"</pre>
- <p>The third argument is optional and controls whether or
- not to log a particular request. The condition can be the
- presence or absence (in the case of a '<code>env=!<var>name</var></code>'
- clause) of a particular variable in the server
- <a href="../env.html">environment</a>. Alternatively, the condition
- can be expressed as arbitrary boolean <a href="../expr.html">expression</a>. If the condition is not satisfied, the request
- will not be logged. References to HTTP headers in the expression
- will not cause the header names to be added to the Vary header.</p>
-
- <p>Environment variables can be set on a per-request
- basis using the <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>
- and/or <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modules. For
- example, if you want to record requests for all GIF
- images on your server in a separate logfile but not in your main
- log, you can use:</p>
+ <p>Le troisième argument est optionnel et permet de contrôler si une
+ requête doit être ou non journalisée. Dans le cas d'une clause
+ '<code>env=!<var>nom</var></code>', la condition peut être la
+ présence ou l'absence d'une variable particulière dans
+ l'<a href="../env.html">environnement du serveur</a>. Dans le cas
+ d'une clause 'expr=<var>expression</var>', la condition consiste
+ en une <a href="../expr.html">expression</a> booléenne
+ quelconque. Si la condition n'est pas vérifiée, la requête ne sera
+ pas journalisée. D'éventuelles références à des en-têtes HTTP dans
+ l'expression rationnelle n'entraîneront pas l'ajout des noms
+ d'en-tête correspondants à l'en-tête Vary.</p>
+
+ <p>Les variables d'environnement peuvent être définies au niveau de
+ chaque requête en utilisant les modules
+ <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> et/ou <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.
+ Par exemple, si vous voulez enregistrer les requêtes pour toutes les
+ images GIF sur votre serveur dans un fichier journal séparé, et pas
+ dans votre journal principal, vous pouvez utiliser :</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image
CustomLog "gif-requests.log" common env=gif-image
CustomLog "nongif-requests.log" common env=!gif-image</pre>
- <p>Or, to reproduce the behavior of the old RefererIgnore
- directive, you might use the following:</p>
+ <p>Ou, pour reproduire le comportement de l'ancienne directive
+ RefererIgnore, vous pouvez utiliser :</p>
<pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer
CustomLog "referer.log" referer env=!localreferer</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="globallog" id="globallog">Directive</a> <a name="GlobalLog" id="GlobalLog">GlobalLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom et le format du fichier journal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GlobalLog <var>file</var>|<var>pipe</var>|<var>provider</var>
<var>format</var>|<var>nickname</var>
[env=[!]<var>environment-variable</var>|
<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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.4.19 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.19 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">GlobalLog</code> directive defines a log shared
- by the main server configuration and all defined virtual hosts.</p>
+ <p>La directive <code class="directive">GlobalLog</code> permet de spécifier un
+ journal partagé entre le serveur principal et tous les serveurs virtuels
+ définis.</p>
- <p>The <code class="directive">GlobalLog</code> directive is identical to
- the <code class="directive">CustomLog</code> directive, apart from the following
- differences:</p>
+ <p>Elle est identique à la directive <code class="directive">CustomLog</code> à ces
+ différences près : </p>
<ul>
- <li><code class="directive">GlobalLog</code> is not valid in virtual host
- context.</li>
- <li><code class="directive">GlobalLog</code> is used by virtual hosts that
- define their own <code class="directive">CustomLog</code>, unlike a
- globally specified <code class="directive">CustomLog</code>.</li>
+ <li>Elle n'est pas valide dans un contexte de serveur virtuel.</li>
+ <li>A la différence d'une directive <code class="directive">CustomLog</code>
+ définie globalement, elle est prise en compte par les serveurs virtuels
+ qui définissent leur propre directive <code class="directive">CustomLog</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="logformat" id="logformat">Directive</a> <a name="LogFormat" id="LogFormat">LogFormat</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Describes a format for use in a log file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var>
-[<var>nickname</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Décrit un format utilisable dans un fichier
+journal</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogFormat <var>format</var>|<var>alias</var>
+[<var>alias</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
- <p>This directive specifies the format of the access log
- file.</p>
-
- <p>The <code class="directive">LogFormat</code> directive can take one of two
- forms. In the first form, where only one argument is specified,
- this directive sets the log format which will be used by logs
- specified in subsequent <code class="directive">TransferLog</code>
- directives. The single argument can specify an explicit
- <var>format</var> as discussed in the <a href="#formats">custom log
- formats</a> section above. Alternatively, it can use a
- <var>nickname</var> to refer to a log format defined in a
- previous <code class="directive">LogFormat</code> directive as described
- below.</p>
-
- <p>The second form of the <code class="directive">LogFormat</code>
- directive associates an explicit <var>format</var> with a
- <var>nickname</var>. This <var>nickname</var> can then be used in
- subsequent <code class="directive">LogFormat</code> or
- <code class="directive"><a href="#customlog">CustomLog</a></code> directives
- rather than repeating the entire format string. A
- <code class="directive">LogFormat</code> directive that defines a nickname
- <strong>does nothing else</strong> -- that is, it <em>only</em>
- defines the nickname, it doesn't actually apply the format and make
- it the default. Therefore, it will not affect subsequent
- <code class="directive"><a href="#transferlog">TransferLog</a></code> directives.
- In addition, <code class="directive">LogFormat</code> cannot use one nickname
- to define another nickname. Note that the nickname should not contain
- percent signs (<code>%</code>).</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common</pre>
+ <p>Cette directive permet de spécifier le format du fichier journal
+ des accès.</p>
+
+ <p>La directive <code class="directive">LogFormat</code> se présente sous
+ deux formes. Sous la première forme, qui ne possède qu'un seul
+ argument, la directive définit le format qui sera utilisé dans les
+ journaux spécifiés par les directives
+ <code class="directive">TransferLog</code> ultérieures. L'argument unique
+ peut contenir un <var>format</var> explicite comme décrit dans la
+ section <a href="#formats">formats de journaux personnalisés</a>
+ ci-dessus. Il peut aussi contenir un <var>alias</var> faisant
+ référence à un format de journal prédéfini par une directive
+ <code class="directive">LogFormat</code> comme décrit plus loin.</p>
+
+ <p>Sous sa seconde forme, la directive
+ <code class="directive">LogFormat</code> associe un <var>format</var>
+ explicite à un <var>alias</var>. Cet <var>alias</var> peut
+ ensuite s'utiliser dans les directives
+ <code class="directive">LogFormat</code> ou <code class="directive"><a href="#customlog">CustomLog</a></code> ultérieures, ce qui
+ évite d'avoir à répéter l'ensemble de la chaîne de format. Une
+ directive <code class="directive">LogFormat</code> qui définit un alias
+ <strong>ne fait rien d'autre</strong> -- c'est à dire qu'<em>elle ne
+ fait que</em> définir l'alias, elle n'applique pas le format et n'en
+ fait pas le format par défaut. Par conséquent, elle n'affecte pas
+ les directives <code class="directive"><a href="#transferlog">TransferLog</a></code> ultérieures. En
+ outre, la directive <code class="directive">LogFormat</code> ne peut pas
+ utiliser un alias pour en définir un autre. Notez que l'alias ne
+ doit pas contenir de caractère pourcent (<code>%</code>).</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun</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="transferlog" id="transferlog">Directive</a> <a name="TransferLog" id="TransferLog">TransferLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify location of a log file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie l'emplacement d'un fichier journal</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TransferLog <var>fichier</var>|<var>pipe</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
- <p>This directive has exactly the same arguments and effect as
- the <code class="directive"><a href="#customlog">CustomLog</a></code>
- directive, with the exception that it does not allow the log format
- to be specified explicitly or for conditional logging of requests.
- Instead, the log format is determined by the most recently specified
- <code class="directive"><a href="#logformat">LogFormat</a></code> directive
- which does not define a nickname. Common Log Format is used if no
- other format has been specified.</p>
-
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
+ <p>Cette directive possède exactement les mêmes arguments et produit
+ les mêmes effets que la directive <code class="directive"><a href="#customlog">CustomLog</a></code>, à l'exception qu'elle
+ ne permet pas de spécifier un format de journal explicite ou la
+ journalisation conditionnelle des requêtes. En l'occurrence, le
+ format de journal est déterminé par la dernière définition d'une
+ directive <code class="directive"><a href="#logformat">LogFormat</a></code>
+ qui ne définit pas d'alias. Si aucun format particulier n'a été
+ spécifié, c'est le Common Log Format qui sera utilisé.</p>
+
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog "logs/access_log"</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="logmessage" id="logmessage">Directive</a> <a name="LogMessage" id="LogMessage">LogMessage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Log user-defined message to error log
-</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre des messages personnalisés dans le journal des
+erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogMessage <var>message</var>
[hook=<var>hook</var>] [expr=<var>expression</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éfini</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_debug</td></tr>
</table>
- <p>This directive causes a user defined message to be logged to the
- error log. The message can use variables and functions from the
- <a href="../expr.html">ap_expr syntax</a>. References to HTTP headers
- will not cause header names to be added to the Vary header. The
- messages are logged at loglevel info.</p>
-
- <p>The hook specifies before which phase of request processing the message
- will be logged. The following hooks are supported:</p>
-
- <table class="bordered"><tr class="header"><th>Name</th></tr>
+ <p>Cette directive permet d'enregistrer un message personnalisé dans
+ le journal des erreurs. Ce message peut utiliser des variables et
+ des fonctions dans la <a href="../expr.html">syntaxe ap_expr</a>.
+ D'éventuelles références à des en-têtes HTTP dans l'expression
+ rationnelle n'entraîneront pas l'ajout des noms d'en-tête
+ correspondants à l'en-tête Vary.
+ Les messages sont enregistrés au loglevel info.</p>
+
+ <p>Le branchement (hook) précise la phase du traitement de la
+ requête avant laquelle le message sera enregistré. Les branchements
+ suivants sont supportés :</p>
+
+ <table class="bordered"><tr class="header"><th>Nom</th></tr>
<tr><td><code>translate_name</code></td></tr>
<tr class="odd"><td><code>type_checker</code></td></tr>
<tr><td><code>quick_handler</code></td></tr>
<tr class="odd"><td><code>log_transaction</code></td></tr>
</table>
- <p>The default is <code>log_transaction</code>. The special value
- <code>all</code> is also supported, causing a message to be logged at each
- phase. Not all hooks are executed for every request.</p>
-
- <p>The optional expression allows to restrict the message if a
- condition is met. The details of the expression syntax are described in
- the <a href="../expr.html">ap_expr documentation</a>. References to HTTP
- headers will not cause the header names to be added to the Vary header.</p>
+ <p>Le branchement par défaut est <code>log_transaction</code>. La
+ valeur spéciale <code>all</code> est aussi supportée ; dans ce cas,
+ le message sera enregistré à chaque phase. Tous les branchements ne
+ sont pas exécutés pour chaque requête.</p>
+
+ <p>L'expression optionnelle permet de restreindre l'enregistrement
+ du message en fonction d'une certaine condition. La syntaxe de
+ l'expression est décrite dans la <a href="../expr.html">documentation ap_expr</a>. D'éventuelles
+ références à des en-têtes HTTP dans l'expression
+ rationnelle n'entraîneront pas l'ajout des noms d'en-tête
+ correspondants à l'en-tête Vary.</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="forensiclog" id="forensiclog">Directive</a> <a name="ForensicLog" id="ForensicLog">ForensicLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename of the forensic log</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForensicLog <var>filename</var>|<var>pipe</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom de fichier du journal légal</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForensicLog <var>nom-fichier</var>|<var>pipe</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_forensic</td></tr>
</table>
- <p>The <code class="directive">ForensicLog</code> directive is used to
- log requests to the server for forensic analysis. Each log entry
- is assigned a unique ID which can be associated with the request
- using the normal <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>
- directive. <code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> creates a token called
- <code>forensic-id</code>, which can be added to the transfer log
- using the <code>%{forensic-id}n</code> format string.</p>
-
- <p>The argument, which specifies the location to which
- the logs will be written, can take one of the following two
- types of values:</p>
+ <p>La directive <code class="directive">ForensicLog</code> permet de
+ contrôler la journalisation des requêtes à des fins d'analyse
+ légale. Chaque entrée du journal se voit assigner un identifiant
+ unique qui peut être associé à la requête en utilisant la directive
+ <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> habituelle.
+ <code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> crée un élément nommé
+ <code>forensic-id</code>, qui peut être ajouté au journal standard
+ en utilisant l'élément de format <code>%{forensic-id}n</code>.</p>
+
+ <p>L'argument, qui permet de spécifier l'emplacement vers lequel le
+ journal légal sera écrit, peut contenir les deux types de valeurs
+ suivants :</p>
<dl>
- <dt><var>filename</var></dt>
- <dd>A filename, relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
+ <dt><var>nom-fichier</var></dt>
+ <dd>Un nom de fichier relatif au répertoire défini par la
+ directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
<dt><var>pipe</var></dt>
- <dd>The pipe character "<code>|</code>", followed by the path
- to a program to receive the log information on its standard
- input. The program name can be specified relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive.
-
- <div class="warning"><h3>Security:</h3>
- <p>If a program is used, then it will be run as the user who
- started <code class="program"><a href="../programs/httpd.html">httpd</a></code>. This will be root if the server was
- started by root; be sure that the program is secure or switches to a
- less privileged user.</p>
+ <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un
+ programme qui recevra les informations de la journalisation sur
+ son entrée standard. Le nom du programme peut être relatif au
+ répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.
+
+ <div class="warning"><h3>Sécurité :</h3>
+ <p>Si les journaux sont redirigés vers un programme, ce dernier
+ s'exécutera sous l'utilisateur qui a démarré
+ <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur
+ a été démarré par root ; vérifiez que le programme est
+ sécurisé ou passe sous le contrôle d'un utilisateur possédant des
+ droits restreints.</p>
</div>
<div class="note"><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
+ plate-formes non-Unix, il faut prendre soin de ne pas oublier
+ que seuls les slashes directs doivent être utilisés, même si la
+ plate-forme autorise l'emploi d'anti-slashes. D'une manière
+ générale, c'est une bonne idée que de n'utiliser que des slashes
+ directs dans les fichiers de configuration.</p>
</div></dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="logiotrackttfb" id="logiotrackttfb">Directive</a> <a name="LogIOTrackTTFB" id="LogIOTrackTTFB">LogIOTrackTTFB</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable tracking of time to first byte (TTFB)</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'enregistrer le délai avant le premier octet (time
+to first byte - TTFB)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogIOTrackTTFB ON|OFF</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogIOTrackTTFB 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>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_logio</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>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>This directive configures whether this module tracks the delay
- between the request being read and the first byte of the response
- headers being written. The resulting value may be logged with the
- <code>%^FB</code> format.</p>
+ <p>Cette directive permet de définir si ce module mesure le délai
+ entre la lecture de la requête et l'écriture du premier octet des
+ en-têtes de la réponse. La valeur obtenue peut être enregistrée dans
+ le journal via le format <code>%^FB</code>.</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="luaauthzprovider" id="luaauthzprovider">Directive</a> <a name="LuaAuthzProvider" id="LuaAuthzProvider">LuaAuthzProvider</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>
Plug an authorization provider function into <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>
Branche une fonction fournisseur d'autorisation dans <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaAuthzProvider provider_name /path/to/lua/script.lua function_name</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.3 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.3 du serveur HTTP Apache</td></tr>
</table>
-<p>After a lua function has been registered as authorization provider, it can be used
-with the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive:</p>
+<p>Lorsqu'une fonction lua a été enregistrée en tant que fournisseur
+d'autorisation, elle peut être appelée via la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> :</p>
+
<pre class="prettyprint lang-config">LuaRoot /usr/local/apache2/lua
LuaAuthzProvider foo authz.lua authz_check_foo
-
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="luacodecache" id="luacodecache">Directive</a> <a name="LuaCodeCache" id="LuaCodeCache">LuaCodeCache</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure the compiled code cache.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure le cache de code compilé.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaCodeCache stat|forever|never</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LuaCodeCache stat</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#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table><p>
- Specify the behavior of the in-memory code cache. The default
- is stat, which stats the top level script (not any included
- ones) each time that file is needed, and reloads it if the
- modified time indicates it is newer than the one it has
- already loaded. The other values cause it to keep the file
- cached forever (don't stat and replace) or to never cache the
- file.</p>
-
- <p>In general stat or forever is good for production, and stat or never
- for development.</p>
-
- <div class="example"><h3>Examples:</h3><pre class="prettyprint lang-config">LuaCodeCache stat
+ Cette directive permet de définir le comportement du cache de code
+ en mémoire. La valeur par défaut est stat ; dans ce cas, le script
+ du niveau le plus haut (et pas les scripts inclus) est vérifié à
+ chaque fois que ce fichier est nécessaire, et est rechargé si la
+ date de modification est plus récente que celle du script déjà
+ chargé. Les autres valeurs permettent respectivement de garder le
+ fichier en cache perpétuellement (forever - jamais vérifié ni
+ remplacé), ou de ne jamais le mettre en cache (never).</p>
+
+ <p>En général, les valeurs stat et forever sont utilisées pour un
+ serveur en production, et les valeurs stat ou never pour un serveur
+ en développement.</p>
+
+ <div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">LuaCodeCache stat
LuaCodeCache forever
LuaCodeCache never</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="luahookaccesschecker" id="luahookaccesschecker">Directive</a> <a name="LuaHookAccessChecker" id="LuaHookAccessChecker">LuaHookAccessChecker</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the access_checker phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase access_checker du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAccessChecker /chemin/vers/lua/script.lua hook_function_name [early|late]</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The optional third argument is supported in 2.3.15 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le troisième argument optionnel est disponible depuis la
+version 2.3.15 du serveur HTTP Apache.</td></tr>
</table>
-<p>Add your hook to the access_checker phase. An access checker
-hook function usually returns OK, DECLINED, or HTTP_FORBIDDEN.</p>
- <div class="note"><h3>Ordering</h3><p>The optional arguments "early" or "late"
- control when this script runs relative to other modules.</p></div>
+<p>Ajoute votre fonction d'accroche à la phase access_checker. Une
+fonction d'accroche access checker renvoie en général OK, DECLINED, ou
+HTTP_FORBIDDEN.</p>
+<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
+ "early" ou "late" permettent de contrôler le moment auquel ce script
+ s'exécute par rapport aux autres modules.</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="luahookauthchecker" id="luahookauthchecker">Directive</a> <a name="LuaHookAuthChecker" id="LuaHookAuthChecker">LuaHookAuthChecker</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the auth_checker phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase auth_checker du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookAuthChecker /chemin/vers/lua/script.lua hook_function_name [early|late]</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The optional third argument is supported in 2.3.15 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le troisième argument optionnel est disponible depuis la
+version 2.3.15 du serveur HTTP Apache.</td></tr>
</table>
-<p>Invoke a lua function in the auth_checker phase of processing
-a request. This can be used to implement arbitrary authentication
-and authorization checking. A very simple example:
+<p>Invoque une fonction lua au cours de la phase auth_checker du
+traitement de la requête. Cette directive peut s'utiliser pour
+implémenter une vérification arbitraire de l'authentification et de
+l'autorisation. Voici un exemple très simple :
</p>
<pre class="prettyprint lang-lua">require 'apache2'
--- fake authcheck hook
--- If request has no auth info, set the response header and
--- return a 401 to ask the browser for basic auth info.
--- If request has auth info, don't actually look at it, just
--- pretend we got userid 'foo' and validated it.
--- Then check if the userid is 'foo' and accept the request.
+-- fonction d'accroche authcheck fictive
+-- Si la requête ne contient aucune donnée d'authentification, l'en-tête
+-- de la réponse est défini et un code 401 est renvoyé afin de demander au
+-- navigateur d'effectuer une authentification basique. Si la requête
+-- comporte des données d'authentification, elles ne sont pas vraiment
+-- consultées, mais on admet la prise en compte de l'utilisateur 'foo' et
+-- on la valide. On vérifie ensuite si l'utilisateur est bien 'foo' et on
+-- accepte la requête.
function authcheck_hook(r)
- -- look for auth info
+ -- recherche des informations d'authentification
auth = r.headers_in['Authorization']
if auth ~= nil then
- -- fake the user
+ -- définition d'un utilisateur par défaut
r.user = 'foo'
end
return apache2.OK
end</pre>
- <div class="note"><h3>Ordering</h3><p>The optional arguments "early" or "late"
- control when this script runs relative to other modules.</p></div>
+<div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
+ "early" ou "late" permettent de contrôler le moment auquel ce script
+ s'exécute par rapport aux autres modules.</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="luahookcheckuserid" id="luahookcheckuserid">Directive</a> <a name="LuaHookCheckUserID" id="LuaHookCheckUserID">LuaHookCheckUserID</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the check_user_id phase of request processing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase check_user_id du
+traitement de la requête</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookCheckUserID /path/to/lua/script.lua hook_function_name</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>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="luahookfixups" id="luahookfixups">Directive</a> <a name="LuaHookFixups" id="LuaHookFixups">LuaHookFixups</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the fixups phase of a request
-processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookFixups /path/to/lua/script.lua hook_function_name</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase de correction du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookFixups /chemin/vers/lua/script.lua hook_function_name</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
<p>
- Just like LuaHookTranslateName, but executed at the fixups phase
+ Idem LuaHookTranslateName, mais s'exécute durant la phase de
+ correction.
</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="luahookinsertfilter" id="luahookinsertfilter">Directive</a> <a name="LuaHookInsertFilter" id="LuaHookInsertFilter">LuaHookInsertFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the insert_filter phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookInsertFilter /path/to/lua/script.lua hook_function_name</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase insert_filter du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookInsertFilter /chemin/vers/lua/script.lua hook_function_name</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-</table><p>Not Yet Implemented</p>
+</table><p>Non encore implémenté</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="luahooklog" id="luahooklog">Directive</a> <a name="LuaHookLog" id="LuaHookLog">LuaHookLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the access log phase of a request
-processing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet une insertion dans la phase de journalisation du
+traitement d'une requête</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookLog /path/to/lua/script.lua log_function_name</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#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
<p>
- This simple logging hook allows you to run a function when httpd enters the
- logging phase of a request. With it, you can append data to your own logs,
- manipulate data before the regular log is written, or prevent a log entry
- from being created. To prevent the usual logging from happening, simply return
- <code>apache2.DONE</code> in your logging handler, otherwise return
- <code>apache2.OK</code> to tell httpd to log as normal.
+ Ce dispositif d'insertion simple permet d'exécuter une fonction
+ lorsque httpd entre dans la phase de journalisation du traitement
+ d'une requête. Vous pouvez ainsi ajouter des données à vos propres
+ entrées de journalisation, manipuler les entrées du journal standard
+ avant leur enregistrement ou empêcher l'enregistrement d'une entrée
+ dans le journal. Pour empêcher l'enregistrement normal des entrées
+ du journal, renvoyez simplement <code>apache2.DONE</code> dans votre
+ gestionnaire de journalisation, ou au contraire, renvoyez
+ <code>apache2.OK</code> pour que httpd effectue une journalisation
+ normale.
</p>
-<p>Example:</p>
+<p>Exemple :</p>
<pre class="prettyprint lang-config">LuaHookLog /path/to/script.lua logger</pre>
<pre class="prettyprint lang-lua">-- /path/to/script.lua --
function logger(r)
- -- flip a coin:
- -- If 1, then we write to our own Lua log and tell httpd not to log
- -- in the main log.
- -- If 2, then we just sanitize the output a bit and tell httpd to
- -- log the sanitized bits.
+ -- on joue à pile ou face :
+ -- Si on obtient 1, on écrit dans notre propre journal Lua et on dit
+ -- à httpd de ne pas enregistrer d'entrée dans le journal standard..
+ -- Si on obtient 2, on nettoie un peu les données avant que httpd ne
+ -- les enregistre dans le journal standard.
if math.random(1,2) == 1 then
- -- Log stuff ourselves and don't log in the regular log
+ -- On effectue notre propre journalisation et le journal
+ -- standard n'est pas alimenté
local f = io.open("/foo/secret.log", "a")
if f then
- f:write("Something secret happened at " .. r.uri .. "\n")
+ f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n")
f:close()
end
- return apache2.DONE -- Tell httpd not to use the regular logging functions
+ return apache2.DONE -- On dit à httpd de ne rien enregistrer
+ --dans le journal standard
else
- r.uri = r.uri:gsub("somesecretstuff", "") -- sanitize the URI
- return apache2.OK -- tell httpd to log it.
+ r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données
+ return apache2.OK -- et httpd doit alors les enregistrer.
end
end</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="luahookmaptostorage" id="luahookmaptostorage">Directive</a> <a name="LuaHookMapToStorage" id="LuaHookMapToStorage">LuaHookMapToStorage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the map_to_storage phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookMapToStorage /path/to/lua/script.lua hook_function_name</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase map_to_storage du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookMapToStorage /chemin/vers/lua/script.lua hook_function_name</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>Like <code class="directive">LuaHookTranslateName</code> but executed at the
- map-to-storage phase of a request. Modules like mod_cache run at this phase,
- which makes for an interesting example on what to do here:</p>
+ <p>Identique à la directive
+ <code class="directive">LuaHookTranslateName</code>, mais s'exécute à la
+ phase map-to-storage du traitement de la requête. Les modules comme
+ mod_cache agissent pendant cette phase, ce qui permet de présenter
+ un exemple intéressant de ce que l'on peut faire ici :</p>
<pre class="prettyprint lang-config">LuaHookMapToStorage /path/to/lua/script.lua check_cache</pre>
<pre class="prettyprint lang-lua">require"apache2"
end
function check_cache(r)
- if r.filename:match("%.png$") then -- Only match PNG files
- local file = cached_files[r.filename] -- Check cache entries
+ if r.filename:match("%.png$") then -- Ne concerne que les fichiers PNG
+ local file = cached_files[r.filename] -- Vérifie les entrées du cache
if not file then
- file = read_file(r.filename) -- Read file into cache
+ file = read_file(r.filename) -- Lit le fichier vers le cache
end
- if file then -- If file exists, write it out
+ if file then -- Si le fichier existe, on l'envoie
r.status = 200
r:write(file)
- r:info(("Sent %s to client from cache"):format(r.filename))
- return apache2.DONE -- skip default handler for PNG files
+ r:info(("%s a été envoyé au client depuis le cache"):format(r.filename))
+ return apache2.DONE -- cout-circuite le gestionnaire par défaut des fichiers PNG
end
end
- return apache2.DECLINED -- If we had nothing to do, let others serve this.
+ return apache2.DECLINED -- Si nous n'avons rien eu à faire, nous laissons les autres s'en charger
end</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="luahooktranslatename" id="luahooktranslatename">Directive</a> <a name="LuaHookTranslateName" id="LuaHookTranslateName">LuaHookTranslateName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the translate name phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée à la phase du nom de
+traduction du traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early|late]</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#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The optional third argument is supported in 2.3.15 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le troisième argument optionnel est disponible depuis la
+version 2.3.15 du serveur HTTP Apache.</td></tr>
</table><p>
- Add a hook (at APR_HOOK_MIDDLE) to the translate name phase of
- request processing. The hook function receives a single
- argument, the request_rec, and should return a status code,
- which is either an HTTP error code, or the constants defined
- in the apache2 module: apache2.OK, apache2.DECLINED, or
- apache2.DONE. </p>
-
- <p>For those new to hooks, basically each hook will be invoked
- until one of them returns apache2.OK. If your hook doesn't
- want to do the translation it should just return
- apache2.DECLINED. If the request should stop processing, then
- return apache2.DONE.</p>
-
- <p>Example:</p>
+ Cette directive permet d'ajouter un point d'entrée (à
+ APR_HOOK_MIDDLE) à la phase du nom de traduction du traitement de la
+ requête. La fonction hook accepte un seul argument, le request_rec,
+ et doit renvoyer un code d'état qui est soit un code d'erreur HTTP,
+ ou une constante définie dans le module apache2 : apache2.OK,
+ apache2.DECLINED, ou apache2.DONE.</p>
+
+ <p>Pour ceux qui ne sont pas familiers avec les points d'entrée
+ (hook), en gros, chaque hook sera invoqué jusqu'à ce que l'un
+ d'entre eux renvoie apache2.OK. Si un hook n'effectuer pas la
+ traduction, il doit juste renvoyer apache2.DECLINED. Si le
+ traitement de la requête doit être interrompu, la valeur renvoyée
+ doit être apache2.DONE.</p>
+
+ <p>Exemple :</p>
<pre class="prettyprint lang-config"># httpd.conf
LuaHookTranslateName /scripts/conf/hooks.lua silly_mapper</pre>
end</pre>
- <div class="note"><h3>Context</h3><p>This directive is not valid in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, or htaccess
- context.</p></div>
-
- <div class="note"><h3>Ordering</h3><p>The optional arguments "early" or "late"
- control when this script runs relative to other modules.</p></div>
+ <div class="note"><h3>Contexte</h3><p>Cette directive ne peut être
+ utilisée ni à l'intérieur d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ni dans un fichier htaccess.</p></div>
+ <div class="note"><h3>Ordonnancement</h3><p>Les arguments optionnels
+ "early" ou "late" permettent de contrôler le moment auquel ce script
+ s'exécute par rapport aux autres modules.</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="luahooktypechecker" id="luahooktypechecker">Directive</a> <a name="LuaHookTypeChecker" id="LuaHookTypeChecker">LuaHookTypeChecker</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the type_checker phase of request processing</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTypeChecker /path/to/lua/script.lua hook_function_name</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la phase type_checker du
+traitement de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaHookTypeChecker /chemin/vers/lua/script.lua hook_function_name</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table><p>
- This directive provides a hook for the type_checker phase of the request processing.
- This phase is where requests are assigned a content type and a handler, and thus can
- be used to modify the type and handler based on input:
+ Cette directive fournit un point d'entrée pour la phase
+ type_checker du traitement de la requête. Cette phase
+ correspond au moment où la requête se voit assigner un type et un
+ gestionnaire de contenu, et peut donc être utilisée pour modifier le
+ type et le gestionnaire en fonction de l'entrée :
</p>
- <pre class="prettyprint lang-config">LuaHookTypeChecker /path/to/lua/script.lua type_checker</pre>
+ <pre class="prettyprint lang-config">LuaHookTypeChecker "/path/to/lua/script.lua" type_checker</pre>
<pre class="prettyprint lang-lua"> function type_checker(r)
- if r.uri:match("%.to_gif$") then -- match foo.png.to_gif
- r.content_type = "image/gif" -- assign it the image/gif type
- r.handler = "gifWizard" -- tell the gifWizard module to handle this
- r.filename = r.uri:gsub("%.to_gif$", "") -- fix the filename requested
+ if r.uri:match("%.to_gif$") then -- foo.png.to_gif convient
+ r.content_type = "image/gif" -- affectation du type image/gif
+ r.handler = "gifWizard" -- force le traitement de la requête par le module gifWizard
+ r.filename = r.uri:gsub("%.to_gif$", "") -- corrige le nom du fichier demandé
return apache2.OK
end
return apache2.DECLINED
end</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="luainherit" id="luainherit">Directive</a> <a name="LuaInherit" id="LuaInherit">LuaInherit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Controls how parent configuration sections are merged into children</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la manière dont les sections de configuration
+parentes sont fusionnées dans les enfants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaInherit none|parent-first|parent-last</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LuaInherit parent-first</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.0 and later</td></tr>
-</table><p>By default, if LuaHook* directives are used in overlapping
- Directory or Location configuration sections, the scripts defined in the
- more specific section are run <em>after</em> those defined in the more
- generic section (LuaInherit parent-first). You can reverse this order, or
- make the parent context not apply at all.</p>
-
- <p> In previous 2.3.x releases, the default was effectively to ignore LuaHook*
- directives from parent configuration sections.</p>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.4.0 et supérieures</td></tr>
+</table><p>Par défaut, si des directives LuaHook* se trouvent dans
+ des sections de configuration Directory ou Location qui se
+ chevauchent, les scripts
+ définis dans les sections les plus spécifiques s'exécutent
+ <em>après</em> ceux définis dans les sections plus génériques
+ (LuaInherit parent-first). Vous pouvez inverser cet ordre, ou faire
+ en sorte que le contexte parent ne s'applique pas du tout.</p>
+
+ <p>Jusqu'aux versions 2.3.x, le comportement par défaut consistait à
+ ignorer les directives LuaHook* situées dans les sections de
+ configuration parentes.</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="luainputfilter" id="luainputfilter">Directive</a> <a name="LuaInputFilter" id="LuaInputFilter">LuaInputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a Lua function for content input filtering</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit une fonction Lua pour le filtrage en entrée</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaInputFilter filter_name /path/to/lua/script.lua function_name</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#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
-<p>Provides a means of adding a Lua function as an input filter.
-As with output filters, input filters work as coroutines,
-first yielding before buffers are sent, then yielding whenever
-a bucket needs to be passed down the chain, and finally (optionally)
-yielding anything that needs to be appended to the input data. The
-global variable <code>bucket</code> holds the buckets as they are passed
-onto the Lua script:
+<p>Cette directive permet d'ajouter un filtre en entrée sous la forme
+d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
+entrée fonctionnent comme des sous-routines, intervenant dans un premier
+temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
+paquet de données doit être transmis à la chaîne, et éventuellement
+produisant toute donnée à ajouter aux données en entrée. La variable
+globale <code>bucket</code> contient les paquets de données tels qu'ils
+sont transmis au script Lua :
</p>
<pre class="prettyprint lang-config">LuaInputFilter myInputFilter /www/filter.lua input_filter
</Files></pre>
<pre class="prettyprint lang-lua">--[[
- Example input filter that converts all POST data to uppercase.
+ Exemple de filtre en entrée qui convertit toutes les données POST en
+ majuscules.
]]--
function input_filter(r)
- print("luaInputFilter called") -- debug print
- coroutine.yield() -- Yield and wait for buckets
- while bucket do -- For each bucket, do...
- local output = string.upper(bucket) -- Convert all POST data to uppercase
- coroutine.yield(output) -- Send converted data down the chain
+ print("luaInputFilter called") -- pour débogage
+ coroutine.yield() -- attend des paquets de données
+ while bucket do -- Pour chaque paquet, faire ...
+ local output = string.upper(bucket) -- Convertit toutes les données POST en majuscules
+ coroutine.yield(output) -- Envoie les données traitées à la chaîne de filtrage
end
- -- No more buckets available.
- coroutine.yield("&filterSignature=1234") -- Append signature at the end
+ -- plus aucune donnée à traiter.
+ coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin
end</pre>
<p>
-The input filter supports denying/skipping a filter if it is deemed unwanted:
+Le filtre en entrée peut interdire ou sauter un filtre s'il est
+considéré comme indésirable :
</p>
<pre class="prettyprint lang-lua">function input_filter(r)
if not good then
- return -- Simply deny filtering, passing on the original content instead
+ return -- Empêche tout simplement le filtrage et transmet le contenu original
end
- coroutine.yield() -- wait for buckets
- ... -- insert filter stuff here
+ coroutine.yield() -- attend des paquets de données
+ ... -- insert les filtres ici
end</pre>
<p>
-See "<a href="#modifying_buckets">Modifying contents with Lua
-filters</a>" for more information.
+Voir "<a href="#modifying_buckets">Modification de contenu avec les
+filtres Lua</a>" pour plus de détails.
</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="luamaphandler" id="luamaphandler">Directive</a> <a name="LuaMapHandler" id="LuaMapHandler">LuaMapHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map a path to a lua handler</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance un chemin avec un gestionnaire lua</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaMapHandler modele-uri /chemin/vers/lua/script.lua
+[nom-fonction]</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>This directive matches a uri pattern to invoke a specific
- handler function in a specific file. It uses PCRE regular
- expressions to match the uri, and supports interpolating
- match groups into both the file path and the function name.
- Be careful writing your regular expressions to avoid security
- issues.</p>
- <div class="example"><h3>Examples:</h3><pre class="prettyprint lang-config">LuaMapHandler /(\w+)/(\w+) /scripts/$1.lua handle_$2</pre>
+ <p>Cette directive permet de faire correspondre un modèle d'uri avec
+ une fonction de gestionnaire située dans un fichier spécifique. Elle
+ utilise les expressions rationnelles PCRE pour mettre en
+ correspondance l'uri, et supporte les groupes de correspondance
+ d'interpolation dans le chemin du fichier et le nom de la fonction.
+ Prenez garde aux problèmes de sécurité en écrivant vos expressions
+ rationnelles.</p>
+ <div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">LuaMapHandler /(\w+)/(\w+) /scripts/$1.lua handle_$2</pre>
</div>
- <p>This would match uri's such as /photos/show?id=9
- to the file /scripts/photos.lua and invoke the
- handler function handle_show on the lua vm after
- loading that file.</p>
+ <p>Cette directive va faire correspondre des uri comme
+ /photos/show?id=9 au fichier /scripts/photos.lua, et invoquera la
+ fonction de gestionnaire handle_show au niveau de la vm lua
+ après chargement de ce fichier.</p>
<pre class="prettyprint lang-config">LuaMapHandler /bingo /scripts/wombat.lua</pre>
- <p>This would invoke the "handle" function, which
- is the default if no specific function name is
- provided.</p>
+ <p>Cette directive invoquera la fonction "handle" qui est la
+ valeur par défaut si aucun nom de fonction spécifique n'est
+ spécifié.</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="luaoutputfilter" id="luaoutputfilter">Directive</a> <a name="LuaOutputFilter" id="LuaOutputFilter">LuaOutputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a Lua function for content output filtering</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit une fonction Lua pour le filtrage de contenu en
+sortie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaOutputFilter filter_name /path/to/lua/script.lua function_name</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#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
-<p>Provides a means of adding a Lua function as an output filter.
-As with input filters, output filters work as coroutines,
-first yielding before buffers are sent, then yielding whenever
-a bucket needs to be passed down the chain, and finally (optionally)
-yielding anything that needs to be appended to the input data. The
-global variable <code>bucket</code> holds the buckets as they are passed
-onto the Lua script:
+<p>>Cette directive permet d'ajouter un filtre en sortie sous la forme
+d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
+entrée fonctionnent comme des sous-routines, intervenant dans un premier
+temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
+paquet de données doit être transmis à la chaîne, et éventuellement
+produisant toute donnée à ajouter aux données en sortie. La variable
+globale <code>bucket</code> contient les paquets de données tels qu'ils
+sont transmis au script Lua :
</p>
<pre class="prettyprint lang-config">LuaOutputFilter myOutputFilter /www/filter.lua output_filter
</Files></pre>
<pre class="prettyprint lang-lua">--[[
- Example output filter that escapes all HTML entities in the output
+ Exemple de filtre en sortie qui échappe toutes les entités HTML en
+ sortie
]]--
function output_filter(r)
- coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Prepend some data to the output,
- -- yield and wait for buckets.
- while bucket do -- For each bucket, do...
- local output = r:escape_html(bucket) -- Escape all output
- coroutine.yield(output) -- Send converted data down the chain
+ coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie,
+ -- puis attend des paquets de données à traiter
+ while bucket do -- Pour chaque paquet, faire ...
+ local output = r:escape_html(bucket) -- Echappe les données en sortie
+ coroutine.yield(output) -- Envoie les données traitées à la chaîne
end
- -- No more buckets available.
+ -- plus aucune donnée à traiter.
end</pre>
<p>
-As with the input filter, the output filter supports denying/skipping a filter
-if it is deemed unwanted:
+Comme les filres en entrée, le filtre en sortie peut interdire ou sauter un filtre s'il est
+considéré comme indésirable :
</p>
<pre class="prettyprint lang-lua">function output_filter(r)
if not r.content_type:match("text/html") then
- return -- Simply deny filtering, passing on the original content instead
+ return -- Empêche tout simplement le filtrage et transmet le contenu original
end
- coroutine.yield() -- wait for buckets
- ... -- insert filter stuff here
+ coroutine.yield() -- attend des paquets de données
+ ... -- insert les filtres ici
end</pre>
-<div class="note"><h3>Lua filters with <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></h3>
-<p> When a Lua filter is used as the underlying provider via the
-<code class="directive"><a href="../mod/mod_filter.html#filterprovider">FilterProvider</a></code> directive, filtering
-will only work when the <var>filter-name</var> is identical to the <var>provider-name</var>.
+<div class="note"><h3>Les filtres Lua avec <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></h3>
+<p>Lorsqu'on utilise un filtre Lua comme fournisseur sous-jacent via la
+directive <code class="directive"><a href="../mod/mod_filter.html#filterprovider">FilterProvider</a></code>, le
+filtrage ne fonctionnera que si <var>filter-name</var> est identique à
+<var>provider-name</var>.
</p> </div>
<p>
-See "<a href="#modifying_buckets">Modifying contents with Lua filters</a>" for more
-information.
+Voir "<a href="#modifying_buckets">Modification de contenu avec les
+filtres Lua</a>" pour plus de détails.
</p>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="luapackagecpath" id="luapackagecpath">Directive</a> <a name="LuaPackageCPath" id="LuaPackageCPath">LuaPackageCPath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a directory to lua's package.cpath</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackageCPath /path/to/include/?.soa</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un répertoire au package.cpath de lua</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackageCPath /chemin/vers/include/?.soa</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>Add a path to lua's shared library search path. Follows the same
- conventions as lua. This just munges the package.cpath in the
- lua vms.</p>
+ <p>Cette directive permet d'ajouter un chemin à la liste des chemins
+ de recherche des bibliothèques partagées de lua. Ceci modifie le
+ package.cpath dans les vms lua.</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="luapackagepath" id="luapackagepath">Directive</a> <a name="LuaPackagePath" id="LuaPackagePath">LuaPackagePath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a directory to lua's package.path</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackagePath /path/to/include/?.lua</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un répertoire au package.path de lua</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaPackagePath /chemin/vers/include/?.lua</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
-</table><p>Add a path to lua's module search path. Follows the same
- conventions as lua. This just munges the package.path in the
- lua vms.</p>
+</table><p>Cette directive permet d'ajouter un chemin à la liste des
+ chemins de recherche du module lua. Elle suit les mêmes conventions
+ que lua. Ceci modifie le package.path dans les vms lua.</p>
- <div class="example"><h3>Ex
amples:</h3><pre class="prettyprint lang-config">LuaPackagePath /scripts/lib/?.lua
+ <div class="example"><h3>Ex
emples :</h3><pre class="prettyprint lang-config">LuaPackagePath /scripts/lib/?.lua
LuaPackagePath /scripts/lib/?/init.lua</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="luaquickhandler" id="luaquickhandler">Directive</a> <a name="LuaQuickHandler" id="LuaQuickHandler">LuaQuickHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Provide a hook for the quick handler of request processing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un point d'entrée pour la gestion rapide du
+traitement de la requête</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaQuickHandler /path/to/script.lua hook_function_name</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#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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>
- This phase is run immediately after the request has been mapped to a virtal host,
- and can be used to either do some request processing before the other phases kick
- in, or to serve a request without the need to translate, map to storage et cetera.
- As this phase is run before anything else, directives such as <code class="directive"><a href="../mod/core.html#location"><Location></a></code> or <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> are void in this phase, just as
- URIs have not been properly parsed yet.
+ <p>Cette phase s'exécute juste après l'attribution de la requête à
+ un serveur virtuel, et permet d'effectuer certains traitements avant
+ le déroulement des autres phases, ou de servir une requête sans
+ avoir à la traduire, l'associer à un espace de stockage, etc...
+ Comme cette phase s'exécute avant toute autre, les directives telles
+ que <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ne
+ sont pas encore prises en compte, car Les URI n'ont pas encore été
+ entièrement interprétés.
</p>
- <div class="note"><h3>Context</h3><p>This directive is not valid in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, or htaccess
- context.</p></div>
+ <div class="note"><h3>Contexte</h3><p>Cette directive ne peut être
+ utilisée ni à l'intérieur d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ni dans un fichier htaccess.</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="luaroot" id="luaroot">Directive</a> <a name="LuaRoot" id="LuaRoot">LuaRoot</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the base path for resolving relative paths for mod_lua directives</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaRoot /path/to/a/directory</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le chemin de base pour la résolution des chemins
+relatifs dans les directives de mod_lua</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaRoot /chemin/vers/un/répertoire</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>Specify the base path which will be used to evaluate all
- relative paths within mod_lua. If not specified they
- will be resolved relative to the current working directory,
- which may not always work well for a server.</p>
+ <p>Cette directive permet de spécifier le chemin de base qui sera
+ utilisé pour évaluer tous les chemins relatifs dans mod_lua. En
+ l'absence de cette directive, les chemins relatifs sont résolus par
+ rapport au répertoire de travail courant, ce qui ne sera pas
+ toujours approprié pour un serveur.</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="luascope" id="luascope">Directive</a> <a name="LuaScope" id="LuaScope">LuaScope</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>One of once, request, conn, thread -- default is once</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Une valeur parmi once, request, conn, thread -- la valeur par défaut est once</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LuaScope once|request|conn|thread|server [min] [max]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LuaScope once</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#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_lua</td></tr>
</table>
- <p>Specify the life cycle scope of the Lua interpreter which will
- be used by handlers in this "Directory." The default is "once"</p>
+ <p>Cette directive permet de spécifier la durée de vie de
+ l'interpréteur Lua qui sera utilisé dans ce "répertoire". La valeur
+ par défaut est "once".</p>
<dl>
- <dt>once:</dt> <dd>use the interpreter once and throw it away.</dd>
+ <dt>once:</dt> <dd>utilise l'interpréteur une fois.</dd>
- <dt>request:</dt> <dd>use the interpreter to handle anything based on
- the same file within this request, which is also
- request scoped.</dd>
+ <dt>request:</dt> <dd>utilise l'interpréteur pour traiter tout ce
+ qui est basé sur le même fichier dans la requête, et qui se trouve
+ aussi dans la portée de la requête.</dd>
- <dt>conn:</dt> <dd>Same as request but attached to the connection_rec</dd>
+ <dt>conn:</dt> <dd>idem request, mais attaché à connection_rec</dd>
- <dt>thread:</dt> <dd>Use the interpreter for the lifetime of the thread
- handling the request (only available with threaded MPMs).</dd>
+ <dt>thread:</dt> <dd>Utilise l'interpréteur pendant toute la durée
+ de vie du thread qui traite la requête (disponible seulement avec
+ les MPMs threadés).</dd>
- <dt>server:</dt> <dd>This one is different than others because the
- server scope is quite long lived, and multiple threads
- will have the same server_rec. To accommodate this,
- server scoped Lua states are stored in an apr
- resource list. The <code>min</code> and <code>max</code> arguments
- specify the minimum and maximum number of Lua states to keep in the
- pool.</dd>
+ <dt>server:</dt> <dd>Le comportement est ici différent, car la
+ portée du serveur présente une durée de vie assez longue, et
+ plusieurs threads vont partager le même server_rec. Pour gérer tout
+ ceci, les états lua du serveur sont stockés dans une liste de ressources
+ apr. Les arguments <code>min</code> et <code>max</code> permettent
+ de spécifier les nombres minimaux et maximaux d'états lua à stocker
+ dans la liste.</dd>
</dl>
- <p>
- Generally speaking, the <code>thread</code> and <code>server</code> scopes
- execute roughly 2-3 times faster than the rest, because they don't have to
- spawn new Lua states on every request (especially with the event MPM, as
- even keepalive requests will use a new thread for each request). If you are
- satisfied that your scripts will not have problems reusing a state, then
- the <code>thread</code> or <code>server</code> scopes should be used for
- maximum performance. While the <code>thread</code> scope will provide the
- fastest responses, the <code>server</code> scope will use less memory, as
- states are pooled, allowing f.x. 1000 threads to share only 100 Lua states,
- thus using only 10% of the memory required by the <code>thread</code> scope.
+ <p>En général, les portées <code>thread</code> et <code>server</code>
+ sont 2 à 3 fois plus rapides que les autres, car elles n'ont pas besoin
+ de régénérer de nouveaux états Lua à chaque requête (comme c'est le
+ cas avec le MPM event, où même les connexions persistantes utilisent un
+ nouveau thread pour chaque requête). Si vous pensez que vos scripts
+ n'auront pas de problème s'il réutilisent un état, alors les portées
+ <code>thread</code> ou <code>server</code> doivent être utilisées car
+ elles présenteront de meilleures performances. Alors que la portée
+ <code>thread</code> fournira les réponses les plus rapides, la portée
+ <code>server</code> utilisera moins de mémoire car les états sont
+ rassemblés dans des jeux, permettant par exemple à 1000 threads de
+ partager 100 états Lua, ne nécessitant ainsi que 10% de la mémoire
+ requise par la portée <code>thread</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="macro" id="macro">Directive</a> <a name="Macro" id="Macro"><Macro></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a configuration file macro</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définition d'une macro dans un fichier de configuration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>
-<Macro <var>name</var> [<var>par1</var> .. <var>parN</var>]>
+<Macro <var>nom</var> [<var>par1</var> .. <var>parN</var>]>
... </Macro></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>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr>
</table>
- <p>The <code class="directive"><Macro></code> directive controls the
- definition of a macro within the server runtime configuration files.
- The first argument is the name of the macro.
- Other arguments are parameters to the macro. It is good practice to prefix
- parameter names with any of '<code>$%@</code>', and not macro names
- with such characters.
+ <p>La directive <code class="directive"><Macro></code> permet de définir une macro
+ dans un fichier de configuration Apache. Le premier argument est le nom
+ de la macro, et les arguments suivants sont les paramètres. Il
+ est de bon aloi de préfixer les noms des paramètres d'une macro
+ avec un caractère parmi '<code>$%@</code>', et d'éviter d'en faire
+ de même avec les noms de macros.
</p>
<pre class="prettyprint lang-config"><Macro LocalAccessPolicy>
- Require ip 10.2.16.0/24
+ Require ip 10.2.16.0/24
</Macro>
<Macro RestrictedAccessPolicy $ipnumbers>
- Require ip $ipnumbers
+ Require ip $ipnumbers
</Macro></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="macroignorebadnesting" id="macroignorebadnesting">Directive</a> <a name="MacroIgnoreBadNesting" id="MacroIgnoreBadNesting">MacroIgnoreBadNesting</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore warnings, and does not log, about bad nesting of Macros</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les avertissements et n'inscrit rien dans le journal à
+propos d'une imbrication de Macros non conforme</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MacroIgnoreBadNesting</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>All</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="macroignoreemptyargs" id="macroignoreemptyargs">Directive</a> <a name="MacroIgnoreEmptyArgs" id="MacroIgnoreEmptyArgs">MacroIgnoreEmptyArgs</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore warnings, and does not log, about empty Macro argument(s)</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les avertissements et n'inscrit rien dans le journal à
+propos des arguments de Macro vides</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MacroIgnoreEmptyArgs</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>All</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="undefmacro" id="undefmacro">Directive</a> <a name="UndefMacro" id="UndefMacro">UndefMacro</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Undefine a macro</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UndefMacro <var>name</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime une macro</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UndefMacro <var>nom</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#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr>
</table>
- <p>The <code class="directive">UndefMacro</code> directive undefines a macro
- which has been defined before hand.</p>
+ <p>La directive <code class="directive">UndefMacro</code> annule la définition
+ d'une macro qui doit avoir été définie auparavant.</p>
<pre class="prettyprint lang-config">UndefMacro LocalAccessPolicy
UndefMacro RestrictedAccessPolicy</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="use" id="use">Directive</a> <a name="Use" id="Use">Use</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use a macro</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Use <var>name</var> [<var>value1</var> ... <var>valueN</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilisation d'une macro</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Use <var>nom</var> [<var>valeur1</var> ... <var>valeurN</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#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_macro</td></tr>
</table>
- <p>The <code class="directive">Use</code> directive controls the use of a macro.
- The specified macro is expanded. It must be given the same number of
- arguments as in the macro definition. The provided values are
- associated to their corresponding initial parameters and are substituted
- before processing.</p>
+ <p> La directive <code class="directive">Use</code> permet d'utiliser une macro.
+ La macro considérée est expansée. Son nombre d'arguments doit être égal au
+ nombre de paramètres précisés dans sa définition. Les valeurs passées en
+ argument sont attribuées aux paramètres correspondants et
+ substituées avant l'interprétation du texte de la macro.</p>
<pre class="prettyprint lang-config">Use LocalAccessPolicy
...
Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"</pre>
- <p>is equivalent, with the macros defined above, to:</p>
+ <p>est équivalent, avec les macros définies ci-dessus à :</p>
<pre class="prettyprint lang-config">Require ip 10.2.16.0/24
...
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addcharset" id="addcharset">Directive</a> <a name="AddCharset" id="AddCharset">AddCharset</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified content
-charset</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddCharset <var>charset</var> <var>extension</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers spécifiées au
+jeu de caractères spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddCharset <var>jeu-car</var> <var>extension</var>
[<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">AddCharset</code> directive maps the given
- filename extensions to the specified content charset (the Internet
- registered name for a given character encoding). <var>charset</var>
- is the <a href="http://www.iana.org/assignments/character-sets">media
- type's charset parameter</a> for resources with filenames containing
- <var>extension</var>. This mapping is added to any already in force,
- overriding any mappings that already exist for the same
- <var>extension</var>.</p>
-
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">AddLanguage ja .ja
+ <p>La directive <code class="directive">AddCharset</code> permet d'associer
+ les extensions de noms de fichiers spécifiées au jeu de caractères
+ spécifié (le nom enregistré sur l'Internet d'un codage de caractères
+ donné). <var>jeu-car</var> est le <a href="http://www.iana.org/assignments/character-sets">paramètre jeu
+ de caractères du type de médium</a> pour les ressources dont le nom
+ de fichier contient <var>extension</var>. Cette association est
+ ajoutée à toutes les autres déjà en vigueur, et écrase toute
+ association préexistante pour la même <var>extension</var>.</p>
+
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis</pre>
</div>
- <p>Then the document <code>xxxx.ja.jis</code> will be treated
- as being a Japanese document whose charset is <code>ISO-2022-JP</code>
- (as will the document <code>xxxx.jis.ja</code>). The
- <code class="directive">AddCharset</code> directive is useful for both to
- inform the client about the character encoding of the document so that
- the document can be interpreted and displayed appropriately, and for <a href="../content-negotiation.html">content negotiation</a>,
- where the server returns one from several documents based on
- the client's charset preference.</p>
+ <p>Avec cet exemple, le document <code>xxxx.ja.jis</code> sera
+ traité en tant que document japonais dont le jeu de caractère est
+ <code>ISO-2022-JP</code> (idem pour le document
+ <code>xxxx.jis.ja</code>). La directive
+ <code class="directive">AddCharset</code> sert à la fois à informer le
+ client sur le codage des caractères du document afin que ce dernier
+ puisse être interprété et affiché correctement, et à la <a href="../content-negotiation.html">négociation de contenu</a>, au
+ cours de laquelle le serveur décide lequels parmi plusieurs
+ documents possibles il renvoie au client en fonction des préférences
+ de ce dernier en matière de jeu de caractères.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addencoding" id="addencoding">Directive</a> <a name="AddEncoding" id="AddEncoding">AddEncoding</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified encoding
-type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddEncoding <var>encoding</var> <var>extension</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers données au type
+de codage spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddEncoding <var>codage</var> <var>extension</var>
[<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">AddEncoding</code> directive maps the given
- filename extensions to the specified HTTP content-encoding.
- <var>encoding</var> is the HTTP content coding to append to the
- value of the Content-Encoding header field for documents named with the
- <var>extension</var>. This mapping is added to any already in force,
- overriding any mappings that already exist for the same
- <var>extension</var>.</p>
-
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">AddEncoding x-gzip .gz
+ <p>La directive <code class="directive">AddEncoding</code> permet d'associer
+ les extensions de noms de fichiers données au codage de contenu HTTP
+ spécifié. <var>codage</var> est le codage de contenu HTTP à ajouter
+ à la valeur du champ d'en-tête Content-Encoding pour les documents
+ possédant l'<var>extension</var> spécifiée. Cette association est
+ ajoutée à toutes les autres déjà en vigueur, et écrase toute
+ association préexistante pour la même <var>extension</var>.</p>
+
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">AddEncoding x-gzip .gz
AddEncoding x-compress .Z</pre>
</div>
- <p>This will cause filenames containing the <code>.gz</code> extension
- to be marked as encoded using the <code>x-gzip</code> encoding, and
- filenames containing the <code>.Z</code> extension to be marked as
- encoded with <code>x-compress</code>.</p>
-
- <p>Old clients expect <code>x-gzip</code> and <code>x-compress</code>,
- however the standard dictates that they're equivalent to
- <code>gzip</code> and <code>compress</code> respectively. Apache does
- content encoding comparisons by ignoring any leading <code>x-</code>.
- When responding with an encoding Apache will use whatever form
- (<em>i.e.</em>, <code>x-foo</code> or <code>foo</code>) the
- client requested. If the client didn't specifically request a
- particular form Apache will use the form given by the
- <code>AddEncoding</code> directive. To make this long story
- short, you should always use <code>x-gzip</code> and
- <code>x-compress</code> for these two specific encodings. More
- recent encodings, such as <code>deflate</code>, should be
- specified without the <code>x-</code>.</p>
-
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>Avec cet exemple, les noms de fichiers possédant l'extension
+ <code>.gz</code> seront marqués comme codés à l'aide du codage
+ <code>x-gzip</code>, et les noms de fichiers possédant l'extension
+ <code>.Z</code> comme codés avec <code>x-compress</code>.</p>
+
+ <p>Les clients anciens n'acceptent que <code>x-gzip</code> et
+ <code>x-compress</code>, bien que les standards stipulent qu'ils
+ sont respectivement équivalents à <code>gzip</code> et
+ <code>compress</code>. Apache effectue ses comparaisons de codages
+ de contenu en ignorant tout préfixe <code>x-</code>. Lorsqu'il
+ répond avec un codage, Apache utilise l'une ou l'autre forme (c'est
+ à dire <code>x-foo</code> ou <code>foo</code>) selon les besoins du
+ client. Si le client n'a pas besoin d'une forme particulière, Apache
+ utilisera la forme employée par la directive
+ <code>AddEncoding</code>. Pour résumer, vous devez toujours utiliser
+ <code>x-gzip</code> et <code>x-compress</code> pour ces deux
+ codages spécifiques. Certains codages plus récents, comme
+ <code>deflate</code>, doivent être spécifiés sans le préfixe
+ <code>x-</code>.</p>
+
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</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="addhandler" id="addhandler">Directive</a> <a name="AddHandler" id="AddHandler">AddHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the filename extensions to the specified
-handler</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddHandler <var>handler-name</var> <var>extension</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers données au
+gestionnaire spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddHandler <var>nom-gestionnaire</var> <var>extension</var>
[<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>Files having the name <var>extension</var> will be served by the
- specified <var><a href="../handler.html">handler-name</a></var>. This
- mapping is added to any already in force, overriding any mappings that
- already exist for the same <var>extension</var>. For example, to
- activate CGI scripts with the file extension <code>.cgi</code>, you
- might use:</p>
+ <p>Les fichiers dont le nom a pour extension <var>extension</var>
+ seront servis par le <var><a href="../handler.html">nom-gestionnaire</a></var> spécifié. Cette
+ association est ajoutée à toutes les autres déjà en vigueur, et
+ écrase toute association préexistante pour la même
+ <var>extension</var>. Par exemple, pour associer les scripts CGI
+ avec l'extension de fichier <code>.cgi</code>, vous pouvez utiliser
+ :</p>
<pre class="prettyprint lang-config">AddHandler cgi-script .cgi</pre>
- <p>Once that has been put into your httpd.conf file, any file containing
- the <code>.cgi</code> extension will be treated as a CGI program.</p>
+ <p>Une fois cette ligne insérée dans votre fichier httpd.conf, tout
+ fichier possédant l'extension <code>.cgi</code> sera traité en tant
+ que programme CGI.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addinputfilter" id="addinputfilter">Directive</a> <a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
-client requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddInputFilter <var>filter</var>[;<var>filter</var>...]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers aux
+filtres spécifiés qui traiteront les requêtes clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddInputFilter <var>filtre</var>[;<var>filtre</var>...]
<var>extension</var> [<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p><code class="directive">AddInputFilter</code> maps the filename extension
- <var>extension</var> to the <a href="../filter.html">filters</a> 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/core.html#setinputfilter">SetInputFilter</a></code>
- directive. This mapping is merged over any already in force, overriding
- any mappings that already exist for the same <var>extension</var>.</p>
+ <p>La directive <code class="directive">AddInputFilter</code> permet
+ d'associer l'extension de nom de fichier <var>extension</var> aux <a href="../filter.html">filtres</a> spécifiésqui traiteront les
+ requêtes clients et les entrées POST à leur réception par le
+ serveur. Ceci s'ajoute à toute définition de filtre préexistante, y
+ compris la directive <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>. Cette
+ association est ajoutée à toutes les autres déjà en vigueur, et
+ écrase toute association préexistante pour la même
+ <var>extension</var>.</p>
- <p>If more than one <var>filter</var> is specified, they must be separated
- by semicolons in the order in which they should process the
- content. The <var>filter</var> is case-insensitive.</p>
+ <p>Si plusieurs <var>filtres</var> sont spécifiés, ils doivent être
+ séparés par des points-virgules et inscrits dans l'ordre selon
+ lequel ils devront traiter le contenu. L'argument <var>filtre</var>
+ est insensible à la casse.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addlanguage" id="addlanguage">Directive</a> <a name="AddLanguage" id="AddLanguage">AddLanguage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extension to the specified content
-language</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddLanguage <var>language-tag</var> <var>extension</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe l'extension de nom de fichier donnée au langage
+spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddLanguage <var>symbole-langage</var> <var>extension</var>
[<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">AddLanguage</code> directive maps the given
- filename extension to the specified content language. Files with the
- filename <var>extension</var> are assigned an HTTP Content-Language
- value of <var>language-tag</var> corresponding to the language
- identifiers defined by RFC 3066.
- This directive overrides any mappings that already exist for the same
- <var>extension</var>.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">AddEncoding x-compress .Z
+ <p>La directive <code class="directive">AddLanguage</code> permet d'associer
+ l'extension de nom de fichier donnée au langage spécifié. Les
+ fichiers dont l'extension correspond à la valeur
+ de l'argument <var>extension</var> se voient attribuer la valeur de
+ l'argument <var>symbole-langage</var> comme en-tête HTTP
+ Content-Language en accord avec les identifiants de langages définis
+ par la RFC 3066. Cette directive l'emporte sur toute association
+ préexistante pour la même <var>extension</var>.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr</pre>
</div>
- <p>Then the document <code>xxxx.en.Z</code> will be treated as
- being a compressed English document (as will the document
- <code>xxxx.Z.en</code>). Although the content language is
- reported to the client, the browser is unlikely to use this
- information. The <code class="directive">AddLanguage</code> directive is
- more useful for <a href="../content-negotiation.html">content
- negotiation</a>, where the server returns one from several documents
- based on the client's language preference.</p>
+ <p>Avec cet exemple, le document <code>xxxx.en.Z</code> sera traité
+ en tant que document compressé de langue anglaise (idem pour le
+ document <code>xxxx.Z.en</code>). Bien que le langage soit fourni au
+ client, le navigateur n'utilise habituellement pas cette
+ information. La directive <code class="directive">AddLanguage</code> est
+ principalement utilisée au cours de la <a href="../content-negotiation.html">négociation de contenu</a>, où le
+ serveur choisit d'envoyer un document parmi plusieurs documents
+ possibles en fonction de la préférence du client en matière de
+ langage.</p>
- <p>If multiple language assignments are made for the same
- extension, the last one encountered is the one that is used.
- That is, for the case of:</p>
+ <p>Si une extension fait l'objet de plusieurs associations de
+ langages, c'est la dernière qui sera utilisée. Ainsi, dans le cas
+ suivant,</p>
<pre class="prettyprint lang-config">AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en</pre>
- <p>documents with the extension <code>.en</code> would be treated as
- being <code>en-us</code>.</p>
+ <p>les documents possédant l'extension <code>.en</code> seront
+ traités en tant que documents de langage <code>en-us</code>.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addoutputfilter" id="addoutputfilter">Directive</a> <a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
-responses from the server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilter <var>filter</var>[;<var>filter</var>...]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers aux
+filtres spécifiés qui traiteront les réponses en provenance du
+serveur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilter <var>filtre</var>[;<var>filtre</var>...]
<var>extension</var> [<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">AddOutputFilter</code> directive maps the
- filename extension <var>extension</var> to the <a href="../filter.html">filters</a> which will process responses
- from the server before they are sent to the client. This is in
- addition to any filters defined elsewhere, including <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> and <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> directive. This mapping is merged
- over any already in force, overriding any mappings that already exist
- for the same <var>extension</var>.</p>
+ <p>La directive <code class="directive">AddOutputFilter</code> permet
+ d'associer l'extension de nom de fichier définie par l'argument
+ <var>extension</var> aux <a href="../filter.html">filtres</a> qui traiteront les réponses en
+ provenance du serveur avant de les envoyer au client. Ces filtres
+ s'ajoutent à tout filtre défini par d'autres directives comme
+ <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> et <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Cette association
+ est fusionnée avec toute autre association en vigueur, et l'emporte
+ sur toute association préexistante pour la même
+ <var>extension</var>.</p>
- <p>For example, the following configuration will process all
- <code>.shtml</code> files for server-side includes and will then
- compress the output using <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
+ <p>Avec l'exemple suivant, tous les fichiers <code>.shtml</code>
+ seront traités en tant qu'inclusions côté serveur (SSI), et la
+ sortie sera compressée à l'aide du module
+ <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
<pre class="prettyprint lang-config">AddOutputFilter INCLUDES;DEFLATE shtml</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. The <var>filter</var> argument is case-insensitive.</p>
+ <p>Si plusieurs <var>filtres</var> sont spécifiés, ils doivent être
+ séparés par des points-virgules et inscrits dans l'ordre selon
+ lequel il devront traiter le contenu. L'argument <var>filtre</var>
+ est insensible à la casse.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
- <p>Note that when defining a set of filters using the
- <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> directive,
- any definition made will replace any previous definition made by
- the <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code>
- directive.</p>
+ <p>Notez que toute définition de filtres via la directive <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> remplace toutes les
+ définitions précédentes effectuées via cette même directive.</p>
- <pre class="prettyprint lang-config"># Effective filter "DEFLATE"
+ <pre class="prettyprint lang-config"># Filtre spécifié "DEFLATE"
AddOutputFilter DEFLATE shtml
<Location "/foo">
- # Effective filter "INCLUDES", replacing "DEFLATE"
+ # Filtre spécifié "INCLUDES", remplace "DEFLATE"
AddOutputFilter INCLUDES shtml
</Location>
<Location "/bar">
- # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE"
+ # Filtre spécifié "INCLUDES;DEFLATE", remplace "DEFLATE"
AddOutputFilter INCLUDES;DEFLATE shtml
</Location>
<Location "/bar/baz">
- # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE"
+ # Filtre spécifié "BUFFER", remplace "INCLUDES;DEFLATE"
AddOutputFilter BUFFER shtml
</Location>
<Location "/bar/baz/buz">
- # No effective filter, replacing "BUFFER"
+ # Pas de filtre spécifié, suppression de "BUFFER"
RemoveOutputFilter shtml
</Location></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="addtype" id="addtype">Directive</a> <a name="AddType" id="AddType">AddType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions onto the specified content
-type</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddType <var>media-type</var> <var>extension</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers au type de
+contenu spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddType <var>type-médium</var> <var>extension</var>
[<var>extension</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">AddType</code> directive maps the given
- filename extensions onto the specified content
- type. <var>media-type</var> is the <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">media
- type</a> to use for filenames containing
- <var>extension</var>. This mapping is added to any already in
- force, overriding any mappings that already exist for the same
- <var>extension</var>.</p>
+ <p>La directive <code class="directive">AddType</code> permet d'associer les
+ extensions de noms fichiers données au type de contenu spécifié.
+ <var>type-médium</var> est le <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">Type
+ MIME</a> à utiliser pour les fichiers dont le nom possède
+ l'extension <var>extension</var>. Cette association s'ajoute à toute
+ autre association en vigueur, et l'emporte sur toute association
+ préexistante pour la même <var>extension</var>.</p>
<div class="note">
- It is recommended that new media types be added using the
- <code class="directive">AddType</code> directive rather than changing the
- <code class="directive"><a href="#typesconfig">TypesConfig</a></code> file.
+ Plutôt que d'éditer directement le fichier <code class="directive"><a href="#typesconfig">TypesConfig</a></code>, il est recommandé
+ d'utiliser la directive <code class="directive">AddType</code> pour
+ ajouter de nouveaux types de médias.
</div>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">AddType image/gif .gif</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">AddType image/gif .gif</pre>
</div>
- <p>Or, to specify multiple file extensions in one directive:</p>
+ <p>Ou, pour spécifier plusieurs extensions dans une seule directive
+ :</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">AddType image/jpeg jpeg jpg jpe</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">AddType image/jpeg jpeg jpg jpe</pre>
</div>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
- <var>extension</var> argument will be compared against each of
- them.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial. Les noms de fichiers
+ peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
+ l'argument <var>extension</var> sera comparé à chacune d'entre
+ elles.</p>
- <p>A simmilar effect to <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>'s
- <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
- can be achieved by qualifying a <var>media-type</var> with
- <code>qs</code>:</p>
+ <p>Il est possible d'obtenir un effet similaire à celui de la
+ directive <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code> du module
+ <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> en qualifiant un <var>type de
+ média</var> avec <code>qs</code> :</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">AddType application/rss+xml;qs=0.8 .xml</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">AddType application/rss+xml;qs=0.8 .xml</pre>
</div>
- <p>This is useful in situations, <em>e.g.</em> when a client
- requesting <code>Accept: */*</code> can not actually processes
- the content returned by the server.</p>
-
- <p>This directive primarily configures 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>Ceci peut s'avérer utile dans certaines situations, par exemple
+ lorsqu'un client qui a ajouté un en-tête <code>Accept: */*</code> à
+ sa requête n'est pas en mesure de traiter le contenu renvoyé par le
+ serveur.</p>
+ <p>A la base, cette directive configure le type de contenu généré
+ pour les fichiers statiques servis à partir du système de fichiers.
+ Dans le cas des ressources autres que les fichiers statiques pour
+ lesquelles le générateur de la réponse spécifie en général un
+ Content-Type, cette directive n'a aucun effet.</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'a été explicitement défini pour une
+ requête, c'est le type de contenu spécifié qui sera utilisé comme
+ nom de gestionnaire.</p>
- <p>When explicit directives such as
- <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> or
- <code class="directive"><a href="#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>Lorsqu'aucune directive comme <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou
+ <code class="directive"><a href="#addhandler">AddHandler</a></code> ne s'applique à
+ une requête, le nom de gestionnaire interne qui aurait du être
+ défini par une de ces directives correspond alors au type de contenu
+ spécifié par la directive AddType.
</p>
<p>
- This is a historical behavior that may be used by some third-party modules
- (such as mod_php) for taking responsibility for the matching request.
+ Pour des raisons historiques, certains modules tiers comme mod_php
+ peuvent adopter ce comportement pour forcer la prise en compte de la
+ requête concernée.
</p>
- <p>Configurations that rely on such "synthetic" types should be avoided.
- Additionally, configurations that restrict access to
- <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> or
- <code class="directive"><a href="#addhandler">AddHandler</a></code> should
- restrict access to this directive as well.</p>
+ <p>Il est conseillé d'éviter les configurations qui reposent sur de
+ tels types "synthétiques". En outre, les configurations qui
+ limitent l'accès aux directives <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou <code class="directive"><a href="#addhandler">AddHandler</a></code> doivent aussi limiter
+ l'accès à la directive AddType.</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="defaultlanguage" id="defaultlanguage">Directive</a> <a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a default language-tag to be sent in the Content-Language
-header field for all resources in the current context that have not been
-assigned a language-tag by some other means.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultLanguage <var>language-tag</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Défini un symbole de langage par défaut à affecter au champ
+d'en-tête Content-Language pour toutes les ressources dans le contexte
+courant auxquelles aucun symbole de langage n'a été
+associé.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultLanguage <var>symbole-langage</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">DefaultLanguage</code> directive tells Apache
- that all resources in the directive's scope (<em>e.g.</em>, all resources
- covered by the current <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> container) that don't have an explicit language
- extension (such as <code>.fr</code> or <code>.de</code> as configured
- by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>) should be
- assigned a Content-Language of <var>language-tag</var>. This allows
- entire directory trees to be marked as containing Dutch content, for
- instance, without having to rename each file. Note that unlike using
- extensions to specify languages, <code class="directive">DefaultLanguage</code>
- can only specify a single language.</p>
-
- <p>If no <code class="directive">DefaultLanguage</code> directive is in force
- and a file does not have any language extensions as configured
- by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, then no
- Content-Language header field will be generated.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DefaultLanguage en</pre>
+ <p>La directive <code class="directive">DefaultLanguage</code> permet
+ d'indiquer à Apache que toutes les ressources du contexte courant
+ (par exemple, toutes les ressources concernées par le conteneur
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
+ courant) qui ne possèdent pas d'extension de langage explicite
+ (comme <code>.fr</code> ou <code>.de</code> tel que défini par la
+ directive <code class="directive"><a href="#addlanguage">AddLanguage</a></code>),
+ verront leur en-tête HTTP Content-Language affecté du langage
+ <var>symbole-langage</var>. Ceci permet de marquer des arborescences
+ de répertoires entières comme contenant des documents en français,
+ par exemple, sans avoir à renommer chaque fichier. Notez qu'à la
+ différence de l'utilisation des extensions pour spécifier des
+ langages, <code class="directive">DefaultLanguage</code> ne permet de
+ spécifier qu'un seul langage.</p>
+
+ <p>Si aucune directive <code class="directive">DefaultLanguage</code> n'est
+ en vigueur, et si un fichier ne possède pas d'extension configurée
+ par la directive <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, aucun champ d'en-tête
+ Content-Language ne sera généré.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DefaultLanguage en</pre>
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a> <a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code>
-components as part of the filename</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Indique à <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> de traiter les éléments
+de <code>path_info</code> en tant que parties du nom de
+fichier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ModMimeUsePathInfo Off</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">ModMimeUsePathInfo</code> directive is used to
- combine the filename with the <code>path_info</code> URL component to
- apply <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>'s directives to the request. The default
- value is <code>Off</code> - therefore, the <code>path_info</code>
- component is ignored.</p>
+ <p>La directive <code class="directive">ModMimeUsePathInfo</code> permet de
+ combiner le nom de fichier avec la partie <code>path_info</code> de
+ l'URL pour appliquer les directives <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> à la
+ requête. La valeur par défaut est <code>Off</code> - situation dans
+ laquelle l'élément <code>path_info</code> est ignoré.</p>
- <p>This directive is recommended when you have a virtual filesystem.</p>
+ <p>L'utilisation de cette directive est conseillée si vous utilisez
+ un système de fichiers virtuel.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">ModMimeUsePathInfo On</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">ModMimeUsePathInfo On</pre>
</div>
- <p>If you have a request for <code>/index.php/foo.shtml</code>
- <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> will now treat the
- incoming request as <code>/index.php/foo.shtml</code> and directives
- like <code>AddOutputFilter INCLUDES .shtml</code> will add the
- <code>INCLUDES</code> filter to the request. If <code class="directive">ModMimeUsePathInfo</code> is not set, the
- <code>INCLUDES</code> filter will not be added. This will work
- analogously for virtual paths, such as those defined by
- <code class="directive"><Location></code></p>
+ <p>Considérons une requête pour <code>/index.php/foo.shtml</code>,
+ <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> ne traitera pas la requête entrante comme
+ <code>/index.php/foo.shtml</code> et les directives comme
+ <code>AddOutputFilter INCLUDES .shtml</code> ajouteront le filtre
+ <code>INCLUDES</code> à la requête. Si la directive
+ <code class="directive">ModMimeUsePathInfo</code> n'est pas définie, le
+ filtre <code>INCLUDES</code> ne sera pas ajouté. Le fonctionnement
+ sera identique dans le cas des chemins virtuels, tels que ceux
+ définis par la directive <code class="directive"><Location></code></p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="multiviewsmatch" id="multiviewsmatch">Directive</a> <a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
-a matching file with MultiViews</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les types de fichiers qui seront inclus lors d'une
+recherche de correspondance de fichier avec les vues multiples
+(MultiViews)</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
[Handlers|Filters]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p><code class="directive">MultiviewsMatch</code> permits three different
- behaviors for <a href="mod_negotiation.html">mod_negotiation</a>'s
- Multiviews feature. Multiviews allows a request for a file,
- <em>e.g.</em> <code>index.html</code>, to match any negotiated
- extensions following the base request, <em>e.g.</em>
- <code>index.html.en</code>, <code>index.html.fr</code>, or
+ <p>La directive <code class="directive">MultiviewsMatch</code> permet trois
+ comportements différents pour la fonctionnalité Multiviews du module
+ <a href="mod_negotiation.html">mod_negotiation</a>. Les vues
+ multiples permettent d'associer une requête pour un fichier, par
+ exemple <code>index.html</code>, à toute extension négotiée
+ s'ajoutant à la requête de base, par exemple
+ <code>index.html.en</code>, <code>index.html.fr</code>, ou
<code>index.html.gz</code>.</p>
- <p>The <code>NegotiatedOnly</code> option provides that every extension
- following the base name must correlate to a recognized
- <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> extension for content negotiation, <em>e.g.</em>
- Charset, Content-Type, Language, or Encoding. This is the strictest
- implementation with the fewest unexpected side effects, and is the
- default behavior.</p>
-
- <p>To include extensions associated with Handlers and/or Filters,
- set the <code class="directive">MultiviewsMatch</code> directive to either
- <code>Handlers</code>, <code>Filters</code>, or both option keywords.
- If all other factors are equal, the smallest file will be served,
- <em>e.g.</em> in deciding between <code>index.html.cgi</code> of 500
- bytes and <code>index.html.pl</code> of 1000 bytes, the <code>.cgi</code>
- file would win in this example. Users of <code>.asis</code> files
- might prefer to use the Handler option, if <code>.asis</code> files are
- associated with the <code>asis-handler</code>.</p>
-
- <p>You may finally allow <code>Any</code> extensions to match, even if
- <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> doesn't recognize the extension. This can cause
- unpredictable results, such as serving .old or .bak files the webmaster
- never expected to be served.</p>
-
- <p>For example, the following configuration will allow handlers
- and filters to participate in Multviews, but will exclude unknown
- files:</p>
+ <p>L'option <code>NegotiatedOnly</code> implique que toute extension
+ s'ajoutant au nom de base doit correspondre à une extension de
+ <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> reconnue pour la négociation de contenu,
+ par exemple Charset, Content-Type, Language, ou Encoding. C'est la
+ valeur d'option par défaut, et la contrainte la plus stricte
+ dont les effets de bord inattendus sont les moins nombreux.</p>
+
+ <p>Pour inclure des extensions associées avec des gestionnaires
+ et/ou des filtres, définissez la directive
+ <code class="directive">MultiviewsMatch</code> avec les mots-clés
+ <code>Handlers</code>, <code>Filters</code>, ou les deux. Si tous
+ les autres facteurs sont égaux, c'est le fichier de plus petite
+ taille qui sera servi ; par exemple, si le choix doit s'opérer entre
+ <code>index.html.cgi</code> de 500 octets et
+ <code>index.html.pl</code> de 1000 octets, c'est le fichier
+ <code>.cgi</code> qui l'emportera dans cet exemple. Les utilisateurs
+ de fichiers <code>.asis</code> auront avantage à utiliser l'option
+ Handler, si les fichiers <code>.asis</code> sont associés au
+ gestionnaire <code>asis-handler</code>.</p>
+
+ <p>Vous pouvez enfin autoriser l'association de toute extension avec
+ l'option <code>Any</code>, même si <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> ne
+ reconnaît pas l'extension. Ceci
+ peut conduire à des résultats imprévisibles, comme l'envoi de
+ fichiers .old ou .bak contrairement aux souhaits du webmaster.</p>
+
+ <p>Par exemple, la configuration suivante va permettre l'inclusion
+ des extensions associées aux gestionnaires et aux filtres dans les
+ vues multiples, tout en excluant les fichiers de type inconnu :</p>
<pre class="prettyprint lang-config">MultiviewsMatch Handlers Filters</pre>
- <p><code class="directive">MultiviewsMatch</code> is not allowed in a
- <code class="directive"><a href="../mod/core.html#location"><Location></a></code> or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> section.</p>
+ <p>L'utilisation de la directive
+ <code class="directive">MultiviewsMatch</code> dans une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> n'est pas
+ permise.</p>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="removecharset" id="removecharset">Directive</a> <a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de jeu de caractères pour un
+ensemble d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveCharset</code> directive removes any
- character set associations for files with the given extensions.
- This allows <code>.htaccess</code> files in subdirectories to
- undo any associations inherited from parent directories or the
- server config files.</p>
+ <p>La directive <code class="directive">RemoveCharset</code> permet de
+ supprimer toute association de jeu de caractères pour les fichiers
+ dont les noms possèdent les extensions spécifiées. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">RemoveCharset .html .shtml</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">RemoveCharset .html .shtml</pre>
</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="removeencoding" id="removeencoding">Directive</a> <a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de codage de contenu pour un
+ensemble d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveEncoding</code> directive removes any
- encoding associations for files with the given extensions. This
- allows <code>.htaccess</code> files in subdirectories to undo
- any associations inherited from parent directories or the
- server config files. An example of its use might be:</p>
+ <p>La directive <code class="directive">RemoveEncoding</code> permet de
+ supprimer toute association de codage pour les fichiers dont les
+ noms possèdent les extensions spécifiées. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier. Voici un exemple
+ d'utilisation de cette directive :</p>
<div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">AddEncoding x-gzip .gz
AddType text/plain .asc
</Files></pre>
</div>
- <p>This will cause <code>foo.gz</code> to be marked as being
- encoded with the gzip method, but <code>foo.gz.asc</code> as an
- unencoded plaintext file.</p>
+ <p>Avec cette configuration, le fichier <code>foo.gz</code> sera
+ marqué comme codé avec gzip, mais <code>foo.gz.asc</code> sera
+ marqué comme fichier texte non codé.</p>
<div class="note"><h3>Note</h3>
- <p><code class="directive">RemoveEncoding</code> directives are processed
- <em>after</em> any <code class="directive"><a href="#addencoding">AddEncoding</a></code>
- directives, so it is possible they may undo the effects of the latter
- if both occur within the same directory configuration.</p>
+ <p>Les directives <code class="directive">RemoveEncoding</code> étant
+ traitées <em>après</em> toute directive <code class="directive"><a href="#addencoding">AddEncoding</a></code>, il est possible
+ qu'elles annulent les effets de ces dernières si les deux
+ apparaissent dans la configuration du même répertoire.</p>
</div>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</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="removehandler" id="removehandler">Directive</a> <a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de gestionnaire à un ensemble
+d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveHandler</code> directive removes any
- handler associations for files with the given extensions. This allows
- <code>.htaccess</code> files in subdirectories to undo any
- associations inherited from parent directories or the server
- config files. An example of its use might be:</p>
+ <p>La directive <code class="directive">RemoveHandler</code> permet de
+ supprimer toute association de gestionnaire à des fichiers dont le
+ nom possède l'extension donnée. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier. Voici un exemple
+ d'utilisation de cette directive :</p>
<div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">AddHandler server-parsed .html</pre>
</div>
<div class="example"><h3>/foo/bar/.htaccess:</h3><pre class="prettyprint lang-config">RemoveHandler .html</pre>
</div>
- <p>This has the effect of returning <code>.html</code> files in
- the <code>/foo/bar</code> directory to being treated as normal
- files, rather than as candidates for parsing (see the <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> module).</p>
+ <p>Avec cette dernière ligne, les fichiers <code>.html</code> du
+ répertoire <code>/foo/bar</code> seront traités en tant que fichiers
+ normaux, au lieu d'être traités en tant que candidats à
+ l'interprétation (voir le module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
+ module).</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</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="removeinputfilter" id="removeinputfilter">Directive</a> <a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de filtre en entrée à un
+ensemble d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveInputFilter</code> directive removes any
- input <a href="../filter.html">filter</a> associations for files with
- the given extensions.
- This allows <code>.htaccess</code> files in subdirectories to
- undo any associations inherited from parent directories or the
- server config files.</p>
+ <p>La directive <code class="directive">RemoveInputFilter</code> permet de
+ supprimer toute association de <a href="../filter.html">filtre</a>
+ en entrée à des fichiers dont le nom possède l'extension donnée.
+ Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="removelanguage" id="removelanguage">Directive</a> <a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de langage à un ensemble
+d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveLanguage</code> directive removes any
- language associations for files with the given extensions. This
- allows <code>.htaccess</code> files in subdirectories to undo
- any associations inherited from parent directories or the
- server config files.</p>
+ <p>La directive <code class="directive">RemoveLanguage</code> permet de
+ supprimer toute association de langage à des fichiers dont le nom
+ possède l'extension donnée. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</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="removeoutputfilter" id="removeoutputfilter">Directive</a> <a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de filtre en sortie à un
+ensemble d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveOutputFilter</code> directive removes any
- output <a href="../filter.html">filter</a> associations for files with
- the given extensions.
- This allows <code>.htaccess</code> files in subdirectories to
- undo any associations inherited from parent directories or the
- server config files.</p>
+ <p>La directive <code class="directive">RemoveOutputFilter</code> permet de
+ supprimer toute association de <a href="../filter.html">filtre</a>
+ en sortie à des fichiers dont le nom possède l'extension donnée. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier.</p>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">RemoveOutputFilter shtml</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">RemoveOutputFilter shtml</pre>
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="removetype" id="removetype">Directive</a> <a name="RemoveType" id="RemoveType">RemoveType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
-extensions</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de type de contenu à un ensemble
+d'extensions de noms de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">RemoveType</code> directive removes any
- <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">media type</a> associations for files with
- the given extensions. This allows <code>.htaccess</code> files in
- subdirectories to undo any associations inherited from parent
- directories or the server config files. An example of its use
- might be:</p>
+ <p>La directive <code class="directive">RemoveType</code> permet de
+ supprimer toute association de <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">type de
+ médium</a> à des fichiers dont le nom possède l'extension
+ donnée. Ceci permet, au
+ sein des fichiers <code>.htaccess</code>, d'annuler toute
+ association héritée du répertoire parent ou de la configuration du
+ serveur pour un répertoire particulier. Voici un exemple
+ d'utilisation de cette directive :</p>
<div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">RemoveType .cgi</pre>
</div>
- <p>This will remove any special handling of <code>.cgi</code>
- files in the <code>/foo/</code> directory and any beneath it,
- causing responses containing those files to omit the HTTP
- Content-Type header field.</p>
+ <p>Cette ligne aura pour effet de supprimer tout traitement
+ spécifique des fichiers <code>.cgi</code> dans le répertoire
+ <code>/foo/</code> et ses sous-répertoires, et les réponses
+ contenant ce type de fichier ne possèderont pas de champ d'en-tête
+ HTTP Content-Type.</p>
<div class="note"><h3>Note</h3>
- <p><code class="directive">RemoveType</code> directives are processed
- <em>after</em> any <code class="directive"><a href="#addtype">AddType</a></code>
- directives, so it is possible they may undo the effects of the
- latter if both occur within the same directory configuration.</p>
+ <p>Les directives <code class="directive">RemoveType</code> sont traitées
+ <em>après</em> toutes les directives <code class="directive"><a href="#addtype">AddType</a></code>, et il est possible que les
+ effets de ces dernières soient annulés si les deux types de
+ directives sont présents au sein de la configuration du même
+ répertoire.</p>
</div>
- <p>The <var>extension</var> argument is case-insensitive and can
- be specified with or without a leading dot.</p>
+ <p>L'argument <var>extension</var> est insensible à la casse et peut
+ être spécifié avec ou sans le point initial.</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="typesconfig" id="typesconfig">Directive</a> <a name="TypesConfig" id="TypesConfig">TypesConfig</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the <code>mime.types</code> file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le chemin du fichier <code>mime.types</code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TypesConfig <var>chemin-fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TypesConfig conf/mime.types</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
</table>
- <p>The <code class="directive">TypesConfig</code> directive sets the
- location of the <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">media types</a>
- configuration file. <var>File-path</var> is relative to the
- <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. This file sets
- the default list of mappings from filename extensions to content
- types. Most administrators use the <code>mime.types</code> file
- provided by their OS, which associates common filename
- extensions with the official list of IANA registered media types
- maintained at <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>
- as well as a large number of unofficial types. This
- simplifies the <code>httpd.conf</code> file by providing the
- majority of media-type definitions, and may be overridden by
- <code class="directive"><a href="#addtype">AddType</a></code> directives as
- needed. You should not edit the <code>mime.types</code> file,
- because it may be replaced when you upgrade your server.</p>
-
- <p>The file contains lines in the format of the arguments to
- an <code class="directive"><a href="#addtype">AddType</a></code> directive:</p>
+ <p>La directive <code class="directive">TypesConfig</code> permet de définir
+ le chemin du fichier de configuration des <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">types de média</a>. L'argument
+ <var>chemin-fichier</var> est un chemin relatif au répertoire défini
+ par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Ce
+ fichier contient la liste des associations par défaut des extensions
+ de noms de fichiers aux types de contenus. La plupart des
+ administrateurs utilisent le fichier <code>mime.types</code> fourni
+ par leur OS,
+ qui associe les extensions de noms de fichiers courantes à la liste
+ officielle des types de média enregistrés par l'IANA et maintenue à
+ <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>, ainsi
+ qu'un grand nombre de types non officiels. Ce fichier permet de
+ simplifier le fichier <code>httpd.conf</code> en fournissant la
+ majorité des définitions de types de média, et ses définitions
+ peuvent être écrasées par des directives <code class="directive"><a href="#addtype">AddType</a></code>, selon les besoins. Il est
+ déconseillé de modifier le contenu du fichier
+ <code>mime.types</code> car il peut être remplacé lors d'une mise à
+ jour du serveur.</p>
+
+ <p>Le fichier contient des lignes dont le format est identique à
+ celui des arguments d'une directive <code class="directive"><a href="#addtype">AddType</a></code> :</p>
<div class="example"><p><code>
- <var>media-type</var> [<var>extension</var>] ...
+ <var>type-médium</var> [<var>extension</var>] ...
</code></p></div>
- <p>The case of the extension does not matter. Blank lines, and lines
- beginning with a hash character (<code>#</code>) are ignored.
- Empty lines are there for completeness (of the mime.types file).
- Apache httpd can still determine these types with <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.
- </p>
+ <p>Les extensions sont insensibles à la casse. Les lignes vides et
+ les lignes commençant par un dièse (<code>#</code>) sont
+ ignorées. Les lignes vides servent à compléter le fichier
+ mime.types. Apache httpd peut encore déterminer ces types via le
+ module <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.</p>
<div class="note">
- Please do <strong>not</strong> send requests to the Apache HTTP
- Server Project to add any new entries in the distributed
- <code>mime.types</code> file unless (1) they are already
- registered with IANA, and (2) they use widely accepted,
- non-conflicting filename extensions across platforms.
- <code>category/x-subtype</code> requests will be automatically
- rejected, as will any new two-letter extensions as they will
- likely conflict later with the already crowded language and
- character set namespace.
+ Merci de <strong>ne pas</strong> soumettre de requêtes au Projet
+ de Serveur HTTP Apache pour ajouter une entrée dans le fichier
+ <code>mime.types</code> fourni, sauf si :
+ 1) le type de médium est déjà enregistré à l'IANA
+ 2) et si l'extension est largement acceptée et ne provoque pas de
+ conflits d'extensions entre les différentes plate-formes. Les
+ requêtes du type <code>catégorie/x-sous-type</code> seront
+ systématiquement rejetées, ainsi que toute nouvelle extension de
+ deux lettres, car elle ont de fortes chances d'entrer en conflit
+ par la suite avec les innombrables langages préexistants et les
+ espaces de nommage des jeux de caractères.
</div>
<h3>Voir aussi</h3>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="mimemagicfile" id="mimemagicfile">Directive</a> <a name="MimeMagicFile" id="MimeMagicFile">MimeMagicFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable MIME-type determination based on file contents
-using the specified magic file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MimeMagicFile <var>file-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la détermination du type MIME en se basant sur le
+contenu du fichier et en utilisant le fichier magique
+spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MimeMagicFile <var>chemin-fichier</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime_magic</td></tr>
</table>
- <p>The <code class="directive">MimeMagicFile</code> directive can be used to
- enable this module, the default file is distributed at
- <code>conf/magic</code>. Non-rooted paths are relative to the
- <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Virtual hosts will use
- the same file as the main server unless a more specific setting is
- used, in which case the more specific setting overrides the main
- server's file.</p>
-
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">MimeMagicFile conf/magic</pre>
+ <p>La directive <code class="directive">MimeMagicFile</code> permet
+ d'activer ce module, le fichier par défaut fourni étant
+ <code>conf/magic</code>. Les chemins sans slash '/' de début sont
+ relatifs au répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Les serveurs virtuels
+ utilisent le même fichier que le serveur principal sauf si un
+ fichier spécifique a été défini pour ce serveur virtuel, auquel cas
+ c'est ce dernier fichier qui sera utilisé.</p>
+
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">MimeMagicFile conf/magic</pre>
</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="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a> <a name="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows content-negotiated documents to be
-cached by proxy servers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet la mise en cache au niveau des serveurs mandataires
+des documents dont le contenu a été négocié</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheNegotiatedDocs On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheNegotiatedDocs 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
</table>
- <p>If set, this directive allows content-negotiated documents
- to be cached by proxy servers. This could mean that clients
- behind those proxys could retrieve versions of the documents
- that are not the best match for their abilities, but it will
- make caching more efficient.</p>
+ <p>Si elle est définie à "on", cette directive permet la mise en
+ cache au niveau des serveurs mandataires des documents dont le
+ contenu a été négocié. Le processus de mise en cache sera alors plus
+ efficace, mais des clients se trouvant derrière le mandataire
+ seront alors susceptibles de se voir servir des versions de
+ documents qui ne correspondent pas forcément à leurs attentes.</p>
- <p>This directive only applies to requests which come from
- HTTP/1.0 browsers. HTTP/1.1 provides much better control over
- the caching of negotiated documents, and this directive has no
- effect in responses to HTTP/1.1 requests.</p>
+ <p>Cette directive ne s'applique qu'aux requêtes en provenance de
+ navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de
+ la mise en cache des documents au contenu négocié, et cette
+ directive n'a aucun effet sur les réponses aux requêtes
+ HTTP/1.1.</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="forcelanguagepriority" id="forcelanguagepriority">Directive</a> <a name="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action to take if a single acceptable document is not
-found</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si un document acceptable unique
+n'est pas trouvé</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ForceLanguagePriority Prefer</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#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
</table>
- <p>The <code class="directive">ForceLanguagePriority</code> directive uses
- the given <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> to satisfy
- negotiation where the server could otherwise not return a single
- matching document.</p>
-
- <p><code>ForceLanguagePriority Prefer</code> uses
- <code>LanguagePriority</code> to serve a one valid result, rather
- than returning an HTTP result 300 (MULTIPLE CHOICES) when there
- are several equally valid choices. If the directives below were
- given, and the user's <code>Accept-Language</code> header assigned
- <code>en</code> and <code>de</code> each as quality <code>.500</code>
- (equally acceptable) then the first matching variant, <code>en</code>,
- will be served.</p>
+ <p>La directive <code class="directive">ForceLanguagePriority</code> utilise
+ le langage défini par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> pour terminer
+ la négociation lorsque le serveur n'est pas en mesure de trouver une
+ solution satisfaisante unique.</p>
+
+ <p><code>ForceLanguagePriority Prefer</code> utilise la directive
+ <code>LanguagePriority</code> pour servir le résultat d'un choix
+ unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES),
+ lorsque que plusieurs choix équivalents sont disponibles. Par
+ exemple, avec les deux directives ci-dessous, si l'en-tête
+ <code>Accept-Language</code> de l'utilisateur assigne à
+ <code>en</code> et <code>de</code> une qualité de <code>.500</code>
+ (les deux langages sont également acceptables), alors c'est la
+ première variante acceptable de langue <code>en</code> qui sera
+ servie.</p>
<pre class="prettyprint lang-config">LanguagePriority en fr de
ForceLanguagePriority Prefer</pre>
- <p><code>ForceLanguagePriority Fallback</code> uses
- <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> to
- serve a valid result, rather than returning an HTTP result 406
- (NOT ACCEPTABLE). If the directives below were given, and the user's
- <code>Accept-Language</code> only permitted an <code>es</code>
- language response, but such a variant isn't found, then the first
- variant from the <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> list below will be served.</p>
+ <p><code>ForceLanguagePriority Fallback</code> utilise la directive
+ <code class="directive"><a href="#languagepriority">LanguagePriority</a></code>
+ pour servir un résultat valide, au lieu de renvoyer un résultat HTTP
+ 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
+ l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne
+ que les réponses de langage <code>es</code>, et si aucune variante
+ dans cette langue n'est trouvée, c'est la première variante de la
+ liste définie par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> qui sera servie.</p>
<pre class="prettyprint lang-config">LanguagePriority en fr de
ForceLanguagePriority Fallback</pre>
- <p>Both options, <code>Prefer</code> and <code>Fallback</code>, may be
- specified, so either the first matching variant from <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> will be served if
- more than one variant is acceptable, or first available document will
- be served if none of the variants matched the client's acceptable list
- of languages.</p>
+ <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
+ peuvent être spécifiées, de façon à ce que la variante servie soit
+ la première variante qui convient définie par la directive
+ <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> si
+ plusieurs variantes sont également acceptables, ou le premier
+ document disponible si aucune variante ne convient à la liste de
+ langages acceptables fournie par le client.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="languagepriority" id="languagepriority">Directive</a> <a name="LanguagePriority" id="LanguagePriority">LanguagePriority</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The precedence of language variants for cases where
-the client does not express a preference</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>MIME-lang</var> [<var>MIME-lang</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'ordre de priorité des variantes de langages pour les
+cas où le client n'a pas formulé de préférences</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
</table>
- <p>The <code class="directive">LanguagePriority</code> sets the precedence
- of language variants for the case where the client does not
- express a preference, when handling a Multiviews request. The list
- of <var>MIME-lang</var> are in order of decreasing preference.</p>
+ <p>La directive <code class="directive">LanguagePriority</code> permet de
+ définir, au cours du traitement d'une requête Multivues, l'ordre de
+ priorité des variantes de langages pour les cas
+ où le client n'a pas formulé de préférences. La liste énumère les
+ <var>langages-MIME</var> dans un ordre de préférences
+ décroissantes.</p>
<pre class="prettyprint lang-config">LanguagePriority en fr de</pre>
- <p>For a request for <code>foo.html</code>, where
- <code>foo.html.fr</code> and <code>foo.html.de</code> both
- existed, but the browser did not express a language preference,
- then <code>foo.html.fr</code> would be returned.</p>
+ <p>Dans le cas d'une requête pour <code>foo.html</code>, si
+ <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
+ le client n'a pas formulé de préférences, c'est le fichier
+ <code>foo.html.fr</code> qui sera renvoyé.</p>
- <p>Note that this directive only has an effect if a 'best'
- language cannot be determined by any other means or the <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> directive
- is not <code>None</code>. In general, the client determines the
- language preference, not the server.</p>
+ <p>Notez que cette directive n'a d'effet que si le 'meilleur'
+ langage n'a pas pu être déterminé d'une autre manière ou si la
+ valeur de la directive <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> est
+ différente de <code>None</code>. En général, c'est le client qui
+ détermine le langage préféré, non le serveur.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="nwssltrustedcerts" id="nwssltrustedcerts">Directive</a> <a name="NWSSLTrustedCerts" id="NWSSLTrustedCerts">NWSSLTrustedCerts</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of additional client certificates</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NWSSLTrustedCerts <var>filename</var> [<var>filename</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liste de certificats clients supplémentaires</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NWSSLTrustedCerts <var>nom-fichier</var>
+[<var>nom-fichier</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_nw_ssl</td></tr>
</table>
- <p>Specifies a list of client certificate files (DER format)
- that are used when creating a proxied SSL connection. Each
- client certificate used by a server must be listed separately
- in its own <code>.der</code> file.</p>
+ <p>Cette directive permet de spécifier une liste de fichiers (au
+ format DER) contenant des certificats clients utilisés lors de
+ l'établissement d'une connexion SSL mandatée. Chaque certificat
+ client utilisé par un serveur doit être enregistré séparément dans
+ son propre fichier <code>.der</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="nwsslupgradeable" id="nwsslupgradeable">Directive</a> <a name="NWSSLUpgradeable" id="NWSSLUpgradeable">NWSSLUpgradeable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows a connection to be upgraded to an SSL connection upon request</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NWSSLUpgradeable [<var>IP-address</var>:]<var>portnumber</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de promouvoir une connexion non SSL au statut de
+connexion SSL à la demande</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NWSSLUpgradeable [<var>adresse-IP</var>:]<var>num-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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_nw_ssl</td></tr>
</table>
- <p>Allow a connection that was created on the specified address
- and/or port to be upgraded to an SSL connection upon request from
- the client. The address and/or port must have already be defined
- previously with a <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
- directive.</p>
+ <p>Cette directive permet de promouvoir une connexion établie sur
+ l'adresse IP et/ou le port spécifiés au statut de connexion SSL à la
+ demande du client. L'adresse et/ou le port doivent avoir été définis
+ au préalable par une directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</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="securelisten" id="securelisten">Directive</a> <a name="SecureListen" id="SecureListen">SecureListen</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables SSL encryption for the specified port</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SecureListen [<var>IP-address</var>:]<var>portnumber</var>
-<var>Certificate-Name</var> [MUTUAL]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le chiffrement SSL pour le port
+spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SecureListen [<var>adresse-IP</var>:]<var>num-port</var>
+<var>nom-certificat</var> [MUTUAL]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_nw_ssl</td></tr>
</table>
- <p>Specifies the port and the eDirectory based certificate name
- that will be used to enable SSL encryption. An optional third
- parameter also enables mutual authentication.</p>
+ <p>Cette directive permet de spécifier le port et le nom de
+ certificat de style eDirectory qui seront utilisés pour activer le
+ chiffrement SSL. En outre, un troisième paramètre optionnel permet
+ d'activer l'authentification mutuelle.</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="dtraceprivileges" id="dtraceprivileges">Directive</a> <a name="DTracePrivileges" id="DTracePrivileges">DTracePrivileges</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the privileges required by dtrace are enabled.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les privilèges requis par dtrace sont
+activés.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DTracePrivileges On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DTracePrivileges 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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé).</td></tr>
</table>
- <p>This server-wide directive determines whether Apache will run with
- the <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privileges</a> required to run
- <a href="http://sosc-dr.sun.com/bigadmin/content/dtrace/">dtrace</a>.
- Note that <var>DTracePrivileges On</var> will not in itself
- activate DTrace, but <var>DTracePrivileges Off</var> will prevent
- it working.</p>
+ <p>Cette directive qui s'applique à l'ensemble du serveur permet de
+ déterminer si Apache s'exécutera avec les <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privilèges</a> requis pour exécuter <a href="http://sosc-dr.sun.com/bigadmin/content/dtrace/">dtrace</a>.
+ Notez que la définition <var>DTracePrivileges On</var> n'activera
+ pas à elle-seule DTrace, mais que <var>DTracePrivileges Off</var>
+ l'empêchera de fonctionner.</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="privilegesmode" id="privilegesmode">Directive</a> <a name="PrivilegesMode" id="PrivilegesMode">PrivilegesMode</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Trade off processing speed and efficiency vs security against
-malicious privileges-aware code.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait un compromis entre d'une part l'efficacité et la
+vitesse de traitement et d'autre part la sécurité à l'encontre des codes
+malicieux supportant les privilèges.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PrivilegesMode FAST|SECURE|SELECTIVE</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>PrivilegesMode FAST</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
-</table><p>This directive trades off performance vs security against
-malicious, privileges-aware code. In <var>SECURE</var> mode, each request
-runs in a secure subprocess, incurring a substantial performance penalty.
-In <var>FAST</var> mode, the server is not protected against escalation
-of privileges as discussed above.</p>
-<p>This directive differs slightly between a <code><Directory></code>
- context (including equivalents such as Location/Files/If) and a
- top-level or <code><VirtualHost></code>.</p>
-<p>At top-level, it sets a default that will be inherited by virtualhosts.
- In a virtual host, FAST or SECURE mode acts on the entire
- HTTP request, and any settings in a <code><Directory></code>
- context will be <strong>ignored</strong>. A third pseudo-mode
- SELECTIVE defers the choice of FAST vs SECURE to directives in a
- <code><Directory></code> context.</p>
-<p>In a <code><Directory></code> context, it is applicable only
- where SELECTIVE mode was set for the VirtualHost. Only
- FAST or SECURE can be set in this context (SELECTIVE would be
-meaningless).</p>
-<div class="warning"><h3>Warning</h3>
- Where SELECTIVE mode is selected for a virtual host, the activation
- of privileges must be deferred until <em>after</em> the mapping
- phase of request processing has determined what
- <code><Directory></code> context applies to the request.
- This might give an attacker opportunities to introduce
- code through a <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
- running at top-level or <code><VirtualHost></code> context
- <em>before</em> privileges have been dropped and userid/gid set.
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec des
+modules MPMs non threadés (comme <code class="module"><a href="../mod/prefork.html">prefork</a></code> ou un module
+personnalisé).</td></tr>
+</table><p>Cette directive permet de faire un compromis entre les
+performances et la sécurité à l'encontre des codes malicieux supportant
+les privilèges. En mode <var>SECURE</var>, chaque requête est traitée
+dans un sous-processus sécurisé, ce qui induit une dégradation sensible
+des performances. En mode <var>FAST</var>, le serveur n'est pas protégé
+contre l'augmentation de privilège comme décrit plus haut.</p>
+<p>Cette directive est sensiblement différente selon qu'elle se trouve
+dans une section <code><Directory></code> (ou Location/Files/If)
+ou au niveau global ou dans un <code><VirtualHost></code>.</p>
+<p>Au niveau global, elle définit un comportement par défaut dont
+hériteront les serveurs virtuels. Dans un serveur virtuel, les modes
+FAST ou SECURE agissent sur l'ensemble de la requête HTTP, et toute
+définition de ces modes dans une section <code><Directory></code>
+sera <strong>ignorée</strong>. Le pseudo-mode SELECTIVE confie le choix
+du mode FAST ou SECURE aux directives contenues dans une
+section<code><Directory></code>.</p>
+<p>Dans une section <code><Directory></code>, elle ne s'applique
+que lorsque le mode SELECTIVE a été défini pour le serveur virtuel.
+Seuls FAST ou SECURE peuvent être définis dans ce contexte (SELECTIVE
+n'aurait pas de sens).</p>
+<div class="warning"><h3>Avertissement</h3>
+ Lorsque le mode SELECTIVE a été défini pour un serveur virtuel,
+ l'activation des privilèges doit être reportée <em>après</em>
+ la détermination, par la phase de comparaison du traitement de
+ la requête, du contexte <code><Directory></code> qui
+ s'applique à la requête. Ceci peut donner à un attaquant
+ l'opportunité d'introduire du code via une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> s'exécutant au
+ niveau global ou d'un serveur virtuel <em>avant</em> que les
+ privilèges n'aient été supprimés et l'uid/gid défini.
</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="vhostcgimode" id="vhostcgimode">Directive</a> <a name="VHostCGIMode" id="VHostCGIMode">VHostCGIMode</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the virtualhost can run
-subprocesses, and the privileges available to subprocesses.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le serveur virtuel peut exécuter des
+sous-processus, et définit les privilèges disponibles pour ces
+dernier.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostCGIMode On|Off|Secure</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VHostCGIMode On</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé).</td></tr>
</table>
- <p>Determines whether the virtual host is allowed to run fork and exec,
- the <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privileges</a> required to run subprocesses. If this is set to
- <var>Off</var> the virtualhost is denied the privileges and will not
- be able to run traditional CGI programs or scripts under the traditional
- <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, nor similar external programs such as those
- created by <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> or
- <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> <var>prog</var>.
- Note that it does not prevent CGI programs running under alternative
- process and security models such as <a href="https://httpd.apache.org/mod_fcgid/">mod_fcgid</a>, which is a recommended solution in Solaris.</p>
- <p>If set to <var>On</var> or <var>Secure</var>, the virtual host
- is permitted to run external programs and scripts as above.
- Setting <code class="directive">VHostCGIMode</code> <var>Secure</var> has
- the effect of denying privileges to the subprocesses, as described
- for <code class="directive">VHostSecure</code>.</p>
+ <p>Détermine si le serveur virtuel est autorisé à exécuter fork et
+ exec, et définit les <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privilèges</a> requis pour exécuter des sous-processus. Si cette
+ directive est définie à <var>Off</var> le serveur virtuel ne
+ disposera d'aucun privilège et ne pourra exécuter ni des programmes
+ ou scripts CGI classiques via le module traditionnel
+ <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, ni des programmes externes similaires tels
+ que ceux créés via le module <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> ou les
+ programmes de réécriture externes utilisés par la directive
+ <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. Notez que
+ ceci n'empêche pas l'exécution de programmes CGI via d'autres
+ processus et sous d'autres modèles de sécurité comme <a href="https://httpd.apache.org/mod_fcgid/">mod_fcgid</a>, ce qui est la
+ solution recommandée sous Solaris.</p>
+ <p>Si cette directive est définie à <var>On</var> ou
+ <var>Secure</var>, le serveur virtuel pourra exécuter les scripts et
+ programmes externes cités ci-dessus. Définir la directive
+ <code class="directive">VHostCGIMode</code> à <var>Secure</var> a pour effet
+ supplémentaire de n'accorder aucun privilège aux sous-processus,
+ comme décrit dans la directive
+ <code class="directive">VHostSecure</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="vhostcgiprivs" id="vhostcgiprivs">Directive</a> <a name="VHostCGIPrivs" id="VHostCGIPrivs">VHostCGIPrivs</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assign arbitrary privileges to subprocesses created
-by a virtual host.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostPrivs [+-]?<var>privilege-name</var> [[+-]?privilege-name] ...</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assigne des privilèges au choix aux sous-processus créés
+par un serveur virtuel.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostPrivs [+-]?<var>nom-privilège</var> [[+-]?nom-privilège] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucun</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM)
-and when <code class="module"><a href="../mod/mod_privileges.html">mod_privileges</a></code> is compiled with the
-<var>BIG_SECURITY_HOLE</var> compile-time option.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé) et lorsque <code class="module"><a href="../mod/mod_privileges.html">mod_privileges</a></code> est construit
+avec l'option de compilation
+<var>BIG_SECURITY_HOLE</var>.</td></tr>
</table>
- <p><code class="directive">VHostCGIPrivs</code> can be used to assign arbitrary <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privileges</a> to subprocesses created by a virtual host, as discussed
- under <code class="directive">VHostCGIMode</code>. Each <var>privilege-name</var>
- is the name of a Solaris privilege, such as <var>file_setid</var>
- or <var>sys_nfs</var>.</p>
+ <p>La directive <code class="directive">VHostCGIPrivs</code> permet
+ d'assigner des <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privilèges</a> au choix aux sous-processus créés par un serveur
+ virtuel, comme décrit dans la directive
+ <code class="directive">VHostCGIMode</code>. Chaque
+ <var>nom-privilège</var> correspond à un privilège Solaris tel que
+ <var>file_setid</var> ou <var>sys_nfs</var>.</p>
- <p>A <var>privilege-name</var> may optionally be prefixed by
- + or -, which will respectively allow or deny a privilege.
- If used with neither + nor -, all privileges otherwise assigned
- to the virtualhost will be denied. You can use this to override
- any of the default sets and construct your own privilege set.</p>
+ <p><var>nom-privilège</var> peut être éventuellement préfixé par +
+ ou -, ce qui va respectivement accorder ou refuser le privilège. Si
+ <var>nom-privilège</var> est spécifié sans + ni -, tous les autres
+ privilèges préalablement assignés au serveur virtuel seront refusés.
+ Cette directive permet de construire aisément votre propre jeu de
+ privilèges en annulant tout réglage par défaut.</p>
- <div class="warning"><h3>Security</h3>
- <p>This directive can open huge security holes in apache subprocesses,
- up to and including running them with root-level powers. Do not
- use it unless you fully understand what you are doing!</p></div>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>L'utilisation de cette directive peut ouvrir d'immenses trous de
+ sécurité dans les sous-processus Apache, jusqu'à leur exécution avec les
+ droits de root. Ne l'utilisez que si vous êtes absolument sûr de
+ comprendre ce que vous faites !</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="vhostgroup" id="vhostgroup">Directive</a> <a name="VHostGroup" id="VHostGroup">VHostGroup</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the Group ID under which a virtual host runs.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostGroup <var>unix-groupid</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Inherits the group id specified in
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'identifiant du groupe sous lequel s'exécute un
+serveur virtuel.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostGroup <var>identifiant-groupe-unix</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Hérite de l'identifiant du groupe spécifié par la directive
<code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code></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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé).</td></tr>
</table>
- <p>The <code class="directive">VHostGroup</code> directive sets the Unix group
- under which the server will process requests to a virtualhost.
- The group is set before the request is processed and reset afterwards
- using <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Solaris Privileges</a>. Since the setting applies to the
- <em>process</em>, this is not compatible with threaded MPMs.</p>
- <p><var>Unix-group</var> is one of:</p>
+ <p>La directive <code class="directive">VHostGroup</code> permet de définir
+ l'identifiant du groupe unix sous lequel le serveur va traiter les
+ requêtes par l'intermédiaire d'un serveur virtuel. L'identifiant
+ du groupe est défini avant le traitement de la requête, puis
+ restauré à sa valeur de départ via les <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Privilèges
+ Solaris</a>. Comme la définition
+ s'applique au <em>processus</em>, cette directive est incompatible
+ avec les modules MPM threadés.</p>
+ <p><var>Unix-group</var> peut être :</p>
<dl>
- <dt>A group name</dt>
- <dd>Refers to the given group by name.</dd>
+ <dt>Un nom de groupe</dt>
+ <dd>Fait référence au groupe donné par son nom.</dd>
- <dt><code>#</code> followed by a group number.</dt>
- <dd>Refers to a group by its number.</dd>
+ <dt><code>#</code> suivi d'un numéro de groupe.</dt>
+ <dd>Fait référence au groupe donné par son numéro.</dd>
</dl>
- <div class="warning"><h3>Security</h3>
- <p>This directive cannot be used to run apache as root!
- Nevertheless, it opens potential security issues similar to
- those discussed in the <a href="../suexec.html">suexec</a>
- documentation.</p></div>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Cette directive ne peut pas être utilisée pour exécuter Apache en
+ tant que root ! Elle est tout de même susceptible de poser des
+ problèmes de sécurité similaires à ceux décrits dans la
+ documentation de <a href="../suexec.html">suexec</a>.</p></div>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="vhostprivs" id="vhostprivs">Directive</a> <a name="VHostPrivs" id="VHostPrivs">VHostPrivs</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assign arbitrary privileges to a virtual host.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostPrivs [+-]?<var>privilege-name</var> [[+-]?privilege-name] ...</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Assigne des privilèges à un serveur virtuel.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostPrivs [+-]?<var>nom-privilège</var> [[+-]?nom-privilège] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucun</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM)
-and when <code class="module"><a href="../mod/mod_privileges.html">mod_privileges</a></code> is compiled with the
-<var>BIG_SECURITY_HOLE</var> compile-time option.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé) et lorsque <code class="module"><a href="../mod/mod_privileges.html">mod_privileges</a></code> est construit
+avec l'option de compilation
+<var>BIG_SECURITY_HOLE</var>.</td></tr>
</table>
- <p><code class="directive">VHostPrivs</code> can be used to assign arbitrary <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privileges</a> to a virtual host. Each <var>privilege-name</var>
- is the name of a Solaris privilege, such as <var>file_setid</var>
- or <var>sys_nfs</var>.</p>
+ <p>La directive <code class="directive">VHostPrivs</code> permet d'assigner
+ des <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">privilèges</a> au choix à un serveur virtuel. Chaque
+ <var>nom-privilège</var> correspond à un privilège Solaris tel que
+ <var>file_setid</var> ou <var>sys_nfs</var>.</p>
- <p>A <var>privilege-name</var> may optionally be prefixed by
- + or -, which will respectively allow or deny a privilege.
- If used with neither + nor -, all privileges otherwise assigned
- to the virtualhost will be denied. You can use this to override
- any of the default sets and construct your own privilege set.</p>
+ <p><var>nom-privilège</var> peut être éventuellement préfixé par +
+ ou -, ce qui va respectivement accorder ou refuser le privilège. Si
+ <var>nom-privilège</var> est spécifié sans + ni -, tous les autres
+ privilèges préalablement assignés au serveur virtuel seront refusés.
+ Cette directive permet de construire aisément votre propre jeu de
+ privilèges en annulant tout réglage par défaut.</p>
- <div class="warning"><h3>Security</h3>
- <p>This directive can open huge security holes in apache, up to
- and including running requests with root-level powers. Do not
- use it unless you fully understand what you are doing!</p></div>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>L'utilisation de cette directive peut ouvrir d'immenses trous de
+ sécurité dans Apache, jusqu'au traitement de requêtes avec les
+ droits de root. Ne l'utilisez que si vous êtes absolument sûr de
+ comprendre ce que vous faites !</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="vhostsecure" id="vhostsecure">Directive</a> <a name="VHostSecure" id="VHostSecure">VHostSecure</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether the server runs with enhanced security
-for the virtualhost.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le serveur s'exécute avec une sécurité avancée
+pour les serveurs virtuels.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostSecure On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VHostSecure On</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé).</td></tr>
</table>
- <p>Determines whether the virtual host processes requests with
- security enhanced by removal of <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Privileges</a> that are rarely needed in a webserver, but which are
- available by default to a normal Unix user and may therefore
- be required by modules and applications. It is recommended that
- you retain the default (On) unless it prevents an application running.
- Since the setting applies to the <em>process</em>, this is not
- compatible with threaded MPMs.</p>
+ <p>Détermine si les serveurs virtuels traitent les requêtes avec une
+ sécurité avancée en supprimant les <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Privilèges</a> rarement requis par un serveur web, mais disponibles
+ par défaut pour un utilisateur Unix standard, et donc susceptibles
+ d'être demandés par des modules et des applications. Il est
+ recommandé de conserver la définition par défaut (On), sauf si elle
+ empêche une application de fonctionner. Comme la définition
+ s'applique au <em>processus</em>, cette directive est incompatible
+ avec les modules MPM threadés.</p>
<div class="note"><h3>Note</h3>
- <p>If <code class="directive">VHostSecure</code> prevents an application
- running, this may be a warning sign that the application should be
- reviewed for security.</p></div>
+ <p>Le fait que la directive <code class="directive">VHostSecure</code>
+ empêche une application de fonctionner peut constituer un signal
+ d'avertissement indiquant que la sécurité de l'application doit être
+ revue.</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="vhostuser" id="vhostuser">Directive</a> <a name="VHostUser" id="VHostUser">VHostUser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the User ID under which a virtual host runs.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostUser <var>unix-userid</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Inherits the userid specified in
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'identifiant utilisateur sous lequel s'exécute un
+serveur virtuel.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VHostUser <var>identifiant-utilisateur-unix</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Hérite de l'identifiant utilisateur spécifié par la directive
<code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code></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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_privileges</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available on Solaris 10 and OpenSolaris with
-non-threaded MPMs (<code class="module"><a href="../mod/prefork.html">prefork</a></code> or custom MPM).</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible sous Solaris 10 et OpenSolaris avec les
+modules MPM non-threadés (<code class="module"><a href="../mod/prefork.html">prefork</a></code> ou MPM
+personnalisé).</td></tr>
</table>
- <p>The <code class="directive">VHostUser</code> directive sets the Unix userid
- under which the server will process requests to a virtualhost.
- The userid is set before the request is processed and reset afterwards
- using <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Solaris Privileges</a>. Since the setting applies to the
- <em>process</em>, this is not compatible with threaded MPMs.</p>
- <p><var>Unix-userid</var> is one of:</p>
+ <p>La directive <code class="directive">VHostUser</code> permet de définir
+ l'identifiant utilisateur unix sous lequel le serveur va traiter les
+ requêtes par l'intermédiaire d'un serveur virtuel. L'identifiant
+ utilisateur est défini avant le traitement de la requête, puis
+ restauré à sa valeur de départ via les <a href="http://sosc-dr.sun.com/bigadmin/features/articles/least_privilege.jsp">Privilèges
+ Solaris</a>. Comme la définition
+ s'applique au <em>processus</em>, cette directive est incompatible
+ avec les modules MPM threadés.</p>
+ <p><var>identifiant-utilisateur-unix</var> peut être :</p>
<dl>
- <dt>A username</dt>
- <dd>Refers to the given user by name.</dd>
+ <dt>Un nom d'utilisateur</dt>
+ <dd>Fait référence à l'utilisateur donné par son nom.</dd>
- <dt><code>#</code> followed by a user number.</dt>
- <dd>Refers to a user by its number.</dd>
+ <dt><code>#</code> suivi d'un numéro d'utilisateur.</dt>
+ <dd>Fait référence à l'utilisateur donné par son numéro.</dd>
</dl>
- <div class="warning"><h3>Security</h3>
- <p>This directive cannot be used to run apache as root!
- Nevertheless, it opens potential security issues similar to
- those discussed in the <a href="../suexec.html">suexec</a>
- documentation.</p></div>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Cette directive ne peut pas être utilisée pour exécuter Apache en
+ tant que root ! Elle est tout de même susceptible de poser des
+ problèmes de sécurité similaires à ceux décrits dans la
+ documentation de <a href="../suexec.html">suexec</a>.</p></div>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="balancergrowth" id="balancergrowth">Directive</a> <a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of additional Balancers that can be added Post-configuration</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de membres supplémentaires pouvant être ajoutés
+après la configuration initiale</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BalancerGrowth 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerGrowth is only available in Apache HTTP Server 2.3.13
- and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerGrowth est disponible depuis la version 2.3.13 du
+serveur HTTP Apache</td></tr>
</table>
- <p>This directive allows for growth potential in the number of
- Balancers available for a virtualhost in addition to the
- number pre-configured. It only takes effect if there is at
- least one pre-configured Balancer.</p>
+ <p>Cette directive permet de définir le nombre de
+ répartiteurs de charge pouvant
+ être ajoutés à ceux déjà configurés pour un
+ serveur virtuel. Elle n'est active que si au minimum un répartiteur
+ a été préconfiguré.</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="balancerinherit" id="balancerinherit">Directive</a> <a name="BalancerInherit" id="BalancerInherit">BalancerInherit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inherit proxy Balancers/Workers defined from the main server</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Héritage des membres du groupes de répartition de
+ charge du mandataire définis au niveau du serveur principal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerInherit On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BalancerInherit 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerInherit is only available in Apache HTTP Server 2.4.5 and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur
+ HTTP Apache.</td></tr>
</table>
- <p>This directive will cause the current server/vhost to "inherit"
- Balancers and Workers defined in the main server. This can cause issues and
- inconsistent behavior if using the Balancer Manager for dynamic changes
- and so should be disabled if using that feature.</p>
- <p>The setting in the global server defines the default for all vhosts.</p>
- <p>Disabling <code class="directive"><a href="#proxypassinherit">ProxyPassInherit</a></code> also disables BalancerInherit.</p>
+ <p>Cette directive permet d'attribuer au serveur virtuel courant
+ l'héritage des membres de groupes de répartition de charge
+ définis au niveau du serveur
+ principal. Elle ne doit pas être activée si vous
+ utilisez la fonctionnalité de modifications dynamiques du
+ gestionnaire de répartition de charge (Balancer Manager) pour
+ éviter des problèmes et des comportements inattendus.</p>
+ <p>Les définitions au niveau du serveur principal constituent
+ les définitions par défaut au niveau des serveurs virtuels.</p>
+ <p>La désactivation de ProxyPassInherit désactive aussi la
+ directive <code class="directive"><a href="#balancerinherit">BalancerInherit</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="balancermember" id="balancermember">Directive</a> <a name="BalancerMember" id="BalancerMember">BalancerMember</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a member to a load balancing group</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var>key=value [key=value ...]]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un membre à un groupe de répartition de
+charge</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var>clé=valeur [clé=valeur ...]]</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive adds a member to a load balancing group. It can be used
- within a <code><Proxy <var>balancer://</var>...></code> container
- directive and can take any of the key value pair parameters available to
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> directives.</p>
- <p>One additional parameter is available only to <code class="directive">BalancerMember</code> directives:
- <var>loadfactor</var>. This is the member load factor - a decimal between 1.0
- (default) and 100.0, which defines the weighted load to be applied to the
- member in question.</p>
- <p>The <var>balancerurl</var> is only needed when not within a
- <code><Proxy <var>balancer://</var>...></code>
- container directive. It corresponds to the url of a balancer defined in
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive.</p>
- <p>The path component of the balancer URL in any
- <code><Proxy <var>balancer://</var>...></code> container directive
- is ignored.</p>
- <p>Trailing slashes should typically be removed from the URL of a
- <code class="directive">BalancerMember</code>.</p>
-
+ <p>Cette directive permet d'ajouter un membre à un groupe de
+ répartition de charge. Elle peut se trouver dans un conteneur
+ <code><Proxy <var>balancer://</var>...></code>, et accepte
+ tous les paramètres de paires clé/valeur que supporte la directive
+ <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
+ <p>La directive <code class="directive">BalancerMember</code> accepte un paramètre
+ supplémentaire : <var>loadfactor</var>. Il s'agit du facteur de
+ charge du membre - un nombre entre 1.0 (valeur par défaut) et 100.0, qui
+ définit la charge à appliquer au membre en question.</p>
+ <p>L'argument <var>balancerurl</var> n'est requis que s'il ne se trouve pas
+ dèjà dans la directive de conteneur <code><Proxy
+ <var>balancer://</var>...></code>. Il correspond à l'URL d'un
+ répartiteur de charge défini par une directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
+ <p>La partie chemin de l'URL du membre du groupe de répartition de
+ charge dans toute directive de conteneur <code><Proxy
+ <var>balancer://</var>...></code> est ignorée.</p>
+ <p>Les slashes de fin doivent normalement être supprimés de l'URL
+ d'un <code class="directive">BalancerMember</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="balancerpersist" id="balancerpersist">Directive</a> <a name="BalancerPersist" id="BalancerPersist">BalancerPersist</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Attempt to persist changes made by the Balancer Manager across restarts.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de conserver les changements effectués par le
+ gestionnaire de répartition de charge après un redémarrage du
+ serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerPersist On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BalancerPersist 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerPersist is only available in Apache HTTP Server 2.4.4 and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerPersist n'est disponible qu'à partir de la
+ version 2.4.4 du serveur HTTP Apache.</td></tr>
</table>
- <p>This directive will cause the shared memory storage associated
- with the balancers and balancer members to be persisted across
- restarts. This allows these local changes to not be lost during the
- normal restart/graceful state transitions.</p>
+ <p>Cette directive permet de conserver le contenu de l'espace
+ mémoire partagé associé aux répartiteurs de charge et à leurs
+ membres après un redémarrage du serveur. Ces modifications
+ locales ne sont ainsi pas perdues lors des transitions d'état
+ dues à un redémarrage.</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="noproxy" id="noproxy">Directive</a> <a name="NoProxy" id="NoProxy">NoProxy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Hosts, domains, or networks that will be connected to
-directly</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>host</var> [<var>host</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serveurs, domaines ou réseaux auquels on se connectera
+directement</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>domaine</var> [<var>domaine</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive is only useful for Apache httpd proxy servers within
- intranets. The <code class="directive">NoProxy</code> directive specifies a
- list of subnets, IP addresses, hosts and/or domains, separated by
- spaces. A request to a host which matches one or more of these is
- always served directly, without forwarding to the configured
- <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> proxy server(s).</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyRemote * http://firewall.example.com:81
+ <p>Cette directive n'a d'utilité que pour les serveurs mandataires
+ Apache httpd au sein d'Intranets. La directive
+ <code class="directive">NoProxy</code> permet de spécifier une liste de
+ sous-réseaux, d'adresses IP, de serveurs et/ou de domaines séparés
+ par des espaces. Une requête pour un serveur qui correspond à un ou
+ plusieurs critères sera toujours servie par ce serveur directement,
+ sans être redirigée vers le(s) serveur(s) mandataire(s) défini(s) par
+ la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyRemote * http://firewall.example.com:81
NoProxy .example.com 192.168.112.0/21</pre>
</div>
- <p>The <var>host</var> arguments to the <code class="directive">NoProxy</code>
- directive are one of the following type list:</p>
+ <p>Le type des arguments <var>serveur</var> de la directive
+ <code class="directive">NoProxy</code> appartiennent à la liste suivante
+ :</p>
<dl>
- <dt><var><a name="domain" id="domain">Domain</a></var></dt>
+ <dt><var><a name="domain" id="domain">Domaine</a></var></dt>
<dd>
- <p>A <dfn>Domain</dfn> is a partially qualified DNS domain name, preceded
- by a period. It represents a list of hosts which logically belong to the
- same DNS domain or zone (<em>i.e.</em>, the suffixes of the hostnames are
- all ending in <var>Domain</var>).</p>
+ <p>Un <dfn>domaine</dfn> est ici un nom de domaine DNS partiellement
+ qualifié précédé d'un point. Il représente une liste de serveurs qui
+ appartiennent logiquement au même domaine ou à la même zonz DNS
+ (en d'autres termes, les nom des serveurs se terminent tous par
+ <var>domaine</var>).</p>
- <div class="example"><h3>Ex
amples</h3><p><code>
+ <div class="example"><h3>Ex
emple</h3><p><code>
.com .example.org.
</code></p></div>
- <p>To distinguish <var>Domain</var>s from <var><a href="#hostname">Hostname</a></var>s (both syntactically and semantically; a DNS domain can
- have a DNS A record, too!), <var>Domain</var>s are always written with a
- leading period.</p>
+ <p>Pour faire la distinction entre <var>domaine</var>s et <var><a href="#hostname">nom d'hôte</a></var>s (des points de vue à la fois
+ syntaxique et
+ sémantique, un domaine DNS pouvant aussi avoir un enregistrement DNS
+ de type A !), les <var>domaine</var>s sont toujours spécifiés en les
+ préfixant par un point.</p>
<div class="note"><h3>Note</h3>
- <p>Domain name comparisons are done without regard to the case, and
- <var>Domain</var>s are always assumed to be anchored in the root of the
- DNS tree; therefore, the two domains <code>.ExAmple.com</code> and
- <code>.example.com.</code> (note the trailing period) are considered
- equal. Since a domain comparison does not involve a DNS lookup, it is much
- more efficient than subnet comparison.</p>
+ <p>Les comparaisons de noms de domaines s'effectuent sans tenir
+ compte de la casse, et les parties droites des <var>Domaine</var>s
+ sont toujours censées correspondre à la racine de l'arborescence
+ DNS, si bien que les domaines <code>.ExEmple.com</code> et
+ <code>.example.com.</code> (notez le point à la fin du nom) sont
+ considérés comme identiques. Comme une comparaison de domaines ne
+ nécessite pas de recherche DNS, elle est beaucoup plus efficace
+ qu'une comparaison de sous-réseaux.</p>
</div></dd>
- <dt><var><a name="subnet" id="subnet">SubNet</a></var></dt>
+ <dt><var><a name="subnet" id="subnet">Sous-réseau</a></var></dt>
<dd>
- <p>A <dfn>SubNet</dfn> is a partially qualified internet address in
- numeric (dotted quad) form, optionally followed by a slash and the netmask,
- specified as the number of significant bits in the <var>SubNet</var>. It is
- used to represent a subnet of hosts which can be reached over a common
- network interface. In the absence of the explicit net mask it is assumed
- that omitted (or zero valued) trailing digits specify the mask. (In this
- case, the netmask can only be multiples of 8 bits wide.) Examples:</p>
+ <p>Un <dfn>Sous-réseau</dfn> est une adresse internet partiellement
+ qualifiée sous forme numérique (quatre nombres séparés par des
+ points), optionnellement suivie d'un slash et du masque de
+ sous-réseau spécifiant le nombre de bits significatifs dans le
+ <var>Sous-réseau</var>. Il représente un sous-réseau de serveurs qui
+ peuvent être atteints depuis la même interface réseau. En l'absence
+ de masque de sous-réseau explicite, il est sous-entendu que les
+ digits manquants (ou caractères 0) de fin spécifient le masque de
+ sous-réseau (Dans ce cas, le masque de sous-réseau ne peut être
+ qu'un multiple de 8). Voici quelques exemples :</p>
<dl>
- <dt><code>192.168</code> or <code>192.168.0.0</code></dt>
- <dd>the subnet 192.168.0.0 with an implied netmask of 16 valid bits
- (sometimes used in the netmask form <code>255.255.0.0</code>)</dd>
+ <dt><code>192.168</code> ou <code>192.168.0.0</code></dt>
+ <dd>le sous-réseau 192.168.0.0 avec un masque de sous-réseau
+ implicite de 16 bits significatifs (parfois exprimé sous la forme
+ <code>255.255.0.0</code>)</dd>
<dt><code>192.168.112.0/21</code></dt>
- <dd>the subnet <code>192.168.112.0/21</code> with a netmask of 21
- valid bits (also used in the form <code>255.255.248.0</code>)</dd>
+ <dd>le sous-réseau <code>192.168.112.0/21</code> avec un masque de
+ sous-réseau implicite de 21 bits significatifs (parfois exprimé
+ sous la forme<code>255.255.248.0</code>)</dd>
</dl>
- <p>As a degenerate case, a <em>SubNet</em> with 32 valid bits is the
- equivalent to an <var><a href="#ipaddr">IPAddr</a></var>, while a <var>SubNet</var> with zero
- valid bits (<em>e.g.</em>, 0.0.0.0/0) is the same as the constant
- <var>_Default_</var>, matching any IP address.</p></dd>
+ <p>Comme cas extrêmes, un <em>Sous-réseau</em> avec un masque de
+ sous-réseau de 32 bits significatifs est équivalent à une <var><a href="#ipaddr">adresse IP</a></var>, alors qu'un <em>Sous-réseau</em> avec un masque de
+ sous-réseau de 0 bit significatif (c'est à dire 0.0.0.0/0) est
+ identique à la constante <var>_Default_</var>, et peut correspondre
+ à toute adresse IP.</p></dd>
- <dt><var><a name="ipaddr" id="ipaddr">IPAddr</a></var></dt>
+ <dt><var><a name="ipaddr" id="ipaddr">Adresse IP</a></var></dt>
<dd>
- <p>A <dfn>IPAddr</dfn> represents a fully qualified internet address in
- numeric (dotted quad) form. Usually, this address represents a host, but
- there need not necessarily be a DNS domain name connected with the
- address.</p>
- <div class="example"><h3>Ex
ample</h3><p><code>
+ <p>Une <dfn>Adresse IP</dfn> est une adresse internet pleinement
+ qualifiée sous forme numérique (quatre nombres séparés par des
+ points). En général, cette adresse représente un serveur, mais elle
+ ne doit pas nécessairement correspondre à un nom de domaine DNS.</p>
+ <div class="example"><h3>Ex
emple</h3><p><code>
192.168.123.7
</code></p></div>
<div class="note"><h3>Note</h3>
- <p>An <var>IPAddr</var> does not need to be resolved by the DNS system, so
- it can result in more effective apache performance.</p>
+ <p>Une <dfn>Adresse IP</dfn> ne nécessite pas de résolution DNS,
+ et peut ainsi s'avérer plus efficace quant aux performances
+ d'Apache.</p>
</div></dd>
- <dt><var><a name="hostname" id="hostname">Hostname</a></var></dt>
+ <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt>
<dd>
- <p>A <dfn>Hostname</dfn> is a fully qualified DNS domain name which can
- be resolved to one or more <var><a href="#ipaddr">IPAddrs</a></var> via the
- DNS domain name service. It represents a logical host (in contrast to
- <var><a href="#domain">Domain</a></var>s, see above) and must be resolvable
- to at least one <var><a href="#ipaddr">IPAddr</a></var> (or often to a list
- of hosts with different <var><a href="#ipaddr">IPAddr</a></var>s).</p>
-
- <div class="example"><h3>Examples</h3><p><code>
+ <p>Un <dfn>Nom de serveur</dfn> est un nom de domaine DNS pleinement
+ qualifié qui peut être résolu en une ou plusieurs adresses IP par le
+ service de noms de domaines DNS. Il représente un hôte logique (par
+ opposition aux <var><a href="#domain">Domaine</a></var>s, voir
+ ci-dessus), et doit pouvoir être résolu en une ou plusieurs <var><a href="#ipaddr">adresses IP</a></var> (ou souvent en une liste
+ d'hôtes avec différentes <var><a href="#ipaddr">adresses
+ IP</a></var>).</p>
+
+ <div class="example"><h3>Exemples</h3><p><code>
prep.ai.example.edu<br />
www.example.org
</code></p></div>
<div class="note"><h3>Note</h3>
- <p>In many situations, it is more effective to specify an <var><a href="#ipaddr">IPAddr</a></var> in place of a <var>Hostname</var> since a
- DNS lookup can be avoided. Name resolution in Apache httpd can take a remarkable
- deal of time when the connection to the name server uses a slow PPP
- link.</p>
- <p><var>Hostname</var> comparisons are done without regard to the case,
- and <var>Hostname</var>s are always assumed to be anchored in the root
- of the DNS tree; therefore, the two hosts <code>WWW.ExAmple.com</code>
- and <code>www.example.com.</code> (note the trailing period) are
- considered equal.</p>
+ <p>Dans de nombreuses situations, il est plus efficace de
+ spécifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un
+ <var>Nom de serveur</var> car cela évite d'avoir à effectuer une
+ recherche DNS. La résolution de nom dans Apache httpd peut prendre un
+ temps très long lorsque la connexion avec le serveur de noms
+ utilise une liaison PPP lente.</p>
+ <p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir
+ compte de la casse, et les parties droites des <var>Noms de serveur</var>
+ sont toujours censées correspondre à la racine de l'arborescence
+ DNS, si bien que les domaines <code>WWW.ExEmple.com</code> et
+ <code>www.example.com.</code> (notez le point à la fin du nom) sont
+ considérés comme identiques.</p>
</div></dd>
</dl>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../dns-caveats.html">DNS Issues</a></li>
+<li><a href="../dns-caveats.html">Problèmes liés au DNS</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="proxy" id="proxy">Directive</a> <a name="Proxy" id="Proxy"><Proxy></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Container for directives applied to proxied resources</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Proxy <var>wildcard-url</var>> ...</Proxy></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant à des ressources
+mandatées</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Proxy <var>url-avec-jokers</var>> ...</Proxy></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>Directives placed in <code class="directive"><Proxy></code>
- sections apply only to matching proxied content. Shell-style wildcards are
- allowed.</p>
+ <p>Les directives situées dans une section <code class="directive"><Proxy></code> ne s'appliquent qu'au contenu
+ mandaté concerné. Les jokers de style shell sont autorisés.</p>
- <p>For example, the following will allow only hosts in
- <code>yournetwork.example.com</code> to access content via your proxy
- server:</p>
+ <p>Par exemple, les lignes suivantes n'autoriseront à accéder à un
+ contenu via votre serveur mandataire que les hôtes appartenant à
+ <code>votre-reseau.example.com</code> :</p>
<pre class="prettyprint lang-config"><Proxy *>
- Require host yournetwork.example.com
+ Require host votre-reseau.example.com
</Proxy></pre>
- <p>The following example will process all files in the <code>foo</code>
- directory of <code>example.com</code> through the <code>INCLUDES</code>
- filter when they are sent through the proxy server:</p>
+ <p>Dans l'exemple suivant, tous les fichiers du répertoire
+ <code>foo</code> de <code>example.com</code> seront traités par le
+ filtre <code>INCLUDES</code> lorsqu'ils seront envoyés par
+ l'intermédiaire du serveur mandataire :</p>
- <pre class="prettyprint lang-config"><Proxy http://example.com/foo/*>
+
<pre class="prettyprint lang-config"><Proxy http://example.com/foo/*>
SetOutputFilter INCLUDES
</Proxy></pre>
- <p>The next example will allow web clients from the specified IP
- addresses to issue <code>CONNECT</code> requests to access the
- <code>https://www.example.com/</code> SSL server if
- <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> is enabled.
+ <p>Dans l'exemple suivant, les clients web possédant l'adresse IP
+ spécifiée seront autorisés à effectuer des requêtes
+ <code>CONNECT</code> pour accéder au serveur
+ <code>https://www.example.com/</code>, sous réserve que le module
+ <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> soit chargé.
</p>
<pre class="prettyprint lang-config"><Proxy www.example.com:443>
</Proxy></pre>
- <div class="note"><h3>Differences from the Location configuration section</h3>
- <p>A backend URL matches the configuration section if it begins with the
- the <var>wildcard-url</var> string, even if the last path segment in the
- directive only matches a prefix of the backend URL. For example,
- <Proxy http://example.com/foo> matches all of
- http://example.com/foo, http://example.com/foo/bar, and
- http://example.com/foobar. The matching of the final URL differs
- from the behavior of the <code class="directive"><a href="../mod/core.html#location"><Location></a></code> section, which for purposes of this note
- treats the final path component as if it ended in a slash.</p>
- <p>For more control over the matching, see <code class="directive"><ProxyMatch></code>.</p>
+ <div class="note"><h3>Différences avec la section de configuration Location</h3>
+ <p>Une URL d'arrière-plan sera concernée par le conteneur Proxy si
+ elle commence par la <var>url-avec-jokers</var>, même si le
+ dernier segment de chemin de la directive ne correspond qu'à un
+ préfixe de segment dee chemin de l'URL d'arrière-plan. Par exemple, <Proxy
+ http://example.com/foo> correspondra entre autres aux URLs
+ http://example.com/foo, http://example.com/foo/bar, et
+ http://example.com/foobar. La correspondance de l'URL finale
+ diffère du comportement de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> qui, pour le cas de cette note,
+ traitera le segment de chemin final comme s'il se terminait par un
+ slash.</p>
+ <p>Pour un contrôle plus fin de la correspondance des URL, voir la
+ directive <code class="directive"><ProxyMatch></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="proxyaddheaders" id="proxyaddheaders">Directive</a> <a name="ProxyAddHeaders" id="ProxyAddHeaders">ProxyAddHeaders</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add proxy information in X-Forwarded-* headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des informations à propos du mandataire aux
+en-têtes X-Forwarded-*</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyAddHeaders Off|On</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyAddHeaders On</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.10</td></tr>
</table>
- <p>This directive determines whether or not proxy related information should be passed to the
- backend server through X-Forwarded-For, X-Forwarded-Host and X-Forwarded-Server HTTP headers.</p>
- <div class="note"><h3>Effectiveness</h3>
- <p>This option is of use only for HTTP proxying, as handled by <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
+ <p>Cette directive permet de passer au serveur d'arrière-plan des
+ informations à propos du mandataire via les en-têtes HTTP
+ X-Forwarded-For, X-Forwarded-Host et X-Forwarded-Server.</p>
+ <div class="note"><h3>Utilité</h3>
+ <p>Cette option n'est utile que dans le cas du mandat HTTP traité
+ par <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</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="proxybadheader" id="proxybadheader">Directive</a> <a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines how to handle bad header lines in a
-response</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la manière de traiter les lignes d'en-tête
+incorrectes d'une réponse</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyBadHeader IsError</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyBadHeader</code> directive determines the
- behavior of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> if it receives syntactically invalid
- response header lines (<em>i.e.</em> containing no colon) from the origin
- server. The following arguments are possible:</p>
+ <p>La directive <code class="directive">ProxyBadHeader</code> permet de
+ déterminer le comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> lorsqu'il
+ reçoit des lignes d'en-tête de réponse dont la syntaxe n'est pas valide (c'est
+ à dire ne contenant pas de caractère ':') en provenance du serveur
+ original. Les arguments disponibles sont :</p>
<dl>
<dt><code>IsError</code></dt>
- <dd>Abort the request and end up with a 502 (Bad Gateway) response. This is
- the default behavior.</dd>
+ <dd>Annule la requête et renvoie une réponse de code 502 (mauvaise
+ passerelle). C'est le comportement par défaut.</dd>
<dt><code>Ignore</code></dt>
- <dd>Treat bad header lines as if they weren't sent.</dd>
+ <dd>Traite les lignes d'en-tête incorrectes comme si elles n'avaient
+ pas été envoyées.</dd>
<dt><code>StartBody</code></dt>
- <dd>When receiving the first bad header line, finish reading the headers and
- treat the remainder as body. This helps to work around buggy backend servers
- which forget to insert an empty line between the headers and the body.</dd>
+ <dd>A la réception de la première ligne d'en-tête incorrecte, les
+ autres en-têtes sont lus et ce qui reste est traité en tant que
+ corps. Ceci facilite la prise en compte des serveurs d'arrière-plan
+ bogués qui oublient d'insérer une ligne vide entre les
+ en-têtes et le corps.</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="proxyblock" id="proxyblock">Directive</a> <a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disallow proxy requests to certain hosts</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>hostname</var>|<var>partial-hostname</var> [<var>hostname</var>|<var>partial-hostname</var>]...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interdit les requêtes mandatées vers certains hôtes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>nom d'hôte</var>|<var>nom d'hôte partiel</var>
+[<var>nom d'hôte</var>|<var>nom d'hôte partiel</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyBlock</code> directive can be used to
- block FTP or HTTP access to certain hosts via the proxy, based on
- a full or partial hostname match, or, if applicable, an IP address
- comparison.</p>
-
- <p>Each of the arguments to the <code class="directive">ProxyBlock</code>
- directive can be either <code>*</code> or a alphanumeric string.
- At startup, the module will attempt to resolve every alphanumeric
- string from a DNS name to a set of IP addresses, but any DNS errors
- are ignored.</p>
-
- <p>If an asterisk "<code>*</code>" argument is specified,
- <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> will deny access to all FTP or HTTP
- sites.</p>
-
- <p>Otherwise, for any request for an HTTP or FTP resource via the
- proxy, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> will check the hostname of the
- request URI against each specified string. If a partial string
- match is found, access is denied. If no matches against hostnames
- are found, and a remote (forward) proxy is configured using
- <code class="directive">ProxyRemote</code> or
- <code class="directive">ProxyRemoteMatch</code>, access is allowed. If no
- remote (forward) proxy is configured, the IP address of the
- hostname from the URI is compared against all resolved IP
- addresses determined at startup. Access is denied if any match is
- found.</p>
-
- <p>Note that the DNS lookups may slow down the startup time of the
- server.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyBlock news.example.com auctions.example.com friends.example.com</pre>
+ <p>La directive <code class="directive">ProxyBlock</code> permet d'interdire
+ l'accès FTP ou HTTP via le mandataire à certains hôtes en fonction
+ d'une correspondance exacte ou partielle avec un nom d'hôte, ou dans
+ la mesure du possible en fonction d'une comparaison d'adresses IP.</p>
+
+ <p>Chaque paramètre de la directive
+ <code class="directive">ProxyBlock</code> accepte comme valeur soit
+ <code>*</code>, soit une chaîne alphanumérique. Au démarrage, le
+ module tente de résoudre toute chaîne alphanumérique depuis un nom
+ DNS vers un jeu d'adresses IP, mais toute erreur de DNS est ignorée.</p>
+
+ <p>Si un paramètre a pour valeur "<code>*</code>",
+ <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> interdira l'accès à tout site FTP ou
+ HTTP.</p>
+
+ <p>Dans le cas contraire, pour toute requête vers une ressource FTP
+ ou HTTP via le mandataire, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> va comparer le
+ nom d'hôte de l'URI de la requête avec chaque chaîne alphanumérique
+ spécifiée. Si une chaîne correspond, même partiellement, l'accès est
+ refusé. Si aucune chaîne ne correspond, et si un mandataire distant
+ (forward) est configuré via la directive
+ <code class="directive">ProxyRemote</code> ou
+ <code class="directive">ProxyRemoteMatch</code>, l'accès est autorisé. Si
+ aucun mandataire distant (forward) n'est configuré, l'adresse IP
+ correspondant au nom d'hôte de l'URI est comparée à toutes les
+ adresses IP résolues au démarrage, et l'accès est refusé si une
+ correspondance est trouvée.</p>
+
+ <p>Notez que les recherches DNS peuvent ralentir le processus de
+ démarrage du serveur.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyBlock news.example.com auctions.example.com friends.example.com</pre>
</div>
- <p>Note that <code>example</code> would also be sufficient to match any
- of these sites.</p>
+ <p>Notez qu'<code>example</code> suffirait aussi pour atteindre
+ ces sites.</p>
- <p>Hosts would also be matched if referenced by IP address.</p>
+ <p>Hosts conviendrait aussi s'il était référencé par adresse IP.</p>
- <p>Note also that</p>
+ <p>Notez aussi que</p>
<pre class="prettyprint lang-config">ProxyBlock *</pre>
- <p>blocks connections to all sites.</p>
+ <p>bloque les connexions vers tous les sites.</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="proxydomain" id="proxydomain">Directive</a> <a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Default domain name for proxied requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domain</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de domaine par défaut pour les requêtes
+mandatées</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domaine</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive is only useful for Apache httpd proxy servers within
- intranets. The <code class="directive">ProxyDomain</code> directive specifies
- the default domain which the apache proxy server will belong to. If a
- request to a host without a domain name is encountered, a redirection
- response to the same host with the configured <var>Domain</var> appended
- will be generated.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyRemote "*" "http://firewall.example.com:81"
+ <p>Cette directive n'a d'utilité que pour les serveurs mandataires
+ Apache httpd au sein d'un Intranet. La directive
+ <code class="directive">ProxyDomain</code> permet de spécifier le domaine
+ par défaut auquel le serveur mandataire apache appartient. Si le
+ serveur reçoit une requête pour un hôte sans nom de domaine, il va
+ générer une réponse de redirection vers le même hôte suffixé par le
+ <var>Domaine</var> spécifié.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyRemote "*" "http://firewall.example.com:81"
NoProxy ".example.com" "192.168.112.0/21"
ProxyDomain ".example.com"</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="proxyerroroverride" id="proxyerroroverride">Directive</a> <a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override error pages for proxied content</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Outrepasser les pages d'erreur pour les contenus
+mandatés</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyErrorOverride 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive is useful for reverse-proxy setups where you want to
- have a common look and feel on the error pages seen by the end user.
- This also allows for included files (via
- <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>'s SSI) to get
- the error code and act accordingly. (Default behavior would display
- the error page of the proxied server. Turning this on shows the SSI
- Error message.)</p>
-
- <p>This directive does not affect the processing of informational (1xx),
- normal success (2xx), or redirect (3xx) responses.</p>
+ <p>Cette directive est utile pour les configurations de mandataires
+ inverses, lorsque vous souhaitez que les pages d'erreur envoyées
+ aux utilisateurs finaux présentent un aspect homogène. Elle permet
+ aussi l'inclusion de fichiers (via les SSI de
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>) pour obtenir le code d'erreur et agir
+ en conséquence (le comportement par défaut afficherait la page
+ d'erreur du serveur mandaté, alors que c'est le message d'erreur SSI
+ qui sera affiché si cette directive est à "on").</p>
+
+ <p>Cette directive n'affecte pas le traitement des réponses
+ informatives (1xx), de type succès normal (2xx), ou de redirection
+ (3xx).</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="proxyiobuffersize" id="proxyiobuffersize">Directive</a> <a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determine size of internal data throughput buffer</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la taille du tampon interne de transfert de
+données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyIOBufferSize 8192</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyIOBufferSize</code> directive adjusts the size
- of the internal buffer which is used as a scratchpad for the data between
- input and output. The size must be at least <code>512</code>.</p>
-
- <p>In almost every case, there's no reason to change that value.</p>
-
- <p>If used with AJP, this directive sets the maximum AJP packet size in
- bytes. Values larger than 65536 are set to 65536. If you change it from
- the default, you must also change the <code>packetSize</code> attribute of
- your AJP connector on the Tomcat side! The attribute
- <code>packetSize</code> is only available in Tomcat <code>5.5.20+</code>
- and <code>6.0.2+</code></p>
-
- <p>Normally it is not necessary to change the maximum packet size.
- Problems with the default value have been reported when sending
- certificates or certificate chains.</p>
+ <p>La directive <code class="directive">ProxyIOBufferSize</code> permet
+ d'ajuster la taille du tampon interne utilisé comme bloc-note pour
+ les transferts de données entre entrée et sortie. La taille minimale
+ est de <code>512</code> octets.</p>
+
+ <p>Dans la plupart des cas, il n'y a aucune raison de modifier cette
+ valeur.</p>
+
+ <p>Si elle est utilisée avec AJP, cette directive permet de définir
+ la taille maximale du paquet AJP en octets. Si la valeur spécifiée
+ est supérieure à 65536, elle est corrigée et prend la valeur 65536.
+ Si vous ne conservez pas
+ la valeur par défaut, vous devez aussi modifier l'attribut
+ <code>packetSize</code> de votre connecteur AJP du côté de Tomcat !
+ L'attribut <code>packetSize</code> n'est disponible que dans Tomcat
+ <code>5.5.20+</code> et <code>6.0.2+</code>.</p>
+ <p>Il n'est normalement pas nécessaire de modifier la taille
+ maximale du paquet. Des problèmes ont cependant été rapportés avec
+ la valeur par défaut lors de l'envoi de certificats ou de chaînes de
+ certificats.</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="proxymatch" id="proxymatch">Directive</a> <a name="ProxyMatch" id="ProxyMatch"><ProxyMatch></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Container for directives applied to regular-expression-matched
-proxied resources</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant à des ressources
+mandatées correspondant à une expression rationnelle</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ProxyMatch <var>regex</var>> ...</ProxyMatch></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive"><ProxyMatch></code> directive is
- identical to the <code class="directive"><a href="#proxy"><Proxy></a></code> directive, except that it matches URLs
- using <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>.</p>
-
- <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>
+ <p>La directive <code class="directive"><ProxyMatch></code> est
+ identique à la directive <code class="directive"><a href="#proxy"><Proxy></a></code>, à l'exception qu'elle définit
+ les URLs auxquelles elle s'applique en utilisant une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</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"><ProxyMatch ^http://(?<sitename>[^/]+)>
require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxymaxforwards" id="proxymaxforwards">Directive</a> <a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximium number of proxies that a request can be forwarded
-through</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de mandataires à travers lesquelles une
+requête peut être redirigée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyMaxForwards -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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyMaxForwards</code> directive specifies the
- maximum number of proxies through which a request may pass if there's no
- <code>Max-Forwards</code> header supplied with the request. This may
- be set to prevent infinite proxy loops or a DoS attack.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyMaxForwards 15</pre>
+ <p>La directive <code class="directive">ProxyMaxForwards</code> permet de
+ spécifier le nombre maximum de mandataires à travers lesquels une
+ requête peut passer dans le cas où la la requête ne contient pas
+ d'en-tête <code>Max-Forwards</code>. Ceci permet de se prémunir
+ contre les boucles infinies de mandataires ou contre les attaques de
+ type déni de service.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyMaxForwards 15</pre>
</div>
- <p>Note that setting <code class="directive">ProxyMaxForwards</code> is a
- violation of the HTTP/1.1 protocol (RFC2616), which forbids a Proxy
- setting <code>Max-Forwards</code> if the Client didn't set it.
- Earlier Apache httpd versions would always set it. A negative
- <code class="directive">ProxyMaxForwards</code> value, including the
- default -1, gives you protocol-compliant behavior but may
- leave you open to loops.</p>
+ <p>Notez que la définition de la directive
+ <code class="directive">ProxyMaxForwards</code> constitue une violation du
+ protocole HTTP/1.1 (RFC2616), qui interdit à un mandataire de
+ définir <code>Max-Forwards</code> si le client ne l'a pas fait
+ lui-même. Les versions précédentes d'Apache httpd la définissaient
+ systématiquement. Une valeur négative de
+ <code class="directive">ProxyMaxForwards</code>, y compris la valeur par
+ défaut -1, implique un comportement compatible avec le protocole,
+ mais vous expose aux bouclages infinis.</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="proxypass" id="proxypass">Directive</a> <a name="ProxyPass" id="ProxyPass">ProxyPass</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps remote servers into the local server URL-space</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>path</var>] !|<var>url</var> [<var>key=value</var>
- <var>[key=value</var> ...]] [nocanon] [interpolate] [noquery]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Référencer des serveurs distants depuis
+l'espace d'URLs du serveur local</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>clé=valeur</var>
+ <var>[clé=valeur</var> ...]] [nocanon] [interpolate] [noquery]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Unix Domain Socket (UDS) support added in 2.4.7</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les Sockets de style Unix (Unix Domain Socket - UDS) sont supportés à partir
+de la version 2.4.7 du serveur HTTP Apache</td></tr>
</table>
- <p>This directive allows remote servers to be mapped into the
- space of the local server. The local server does not act as a
- proxy in the conventional sense but appears to be a mirror of the
- remote server. The local server is often called a <dfn>reverse
- proxy</dfn> or <dfn>gateway</dfn>. The <var>path</var> is the name of
- a local virtual path; <var>url</var> is a partial URL for the
- remote server and cannot include a query string.</p>
-
- <div class="note">It is strongly suggested to review the concept of a
- <a href="#workers">Worker</a> before proceeding any further
- with this section.</div>
-
- <div class="note">This directive is not supported within
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> and
- <code class="directive"><a href="../mod/core.html#files"><Files></a></code> containers.</div>
-
- <div class="warning">The <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> directive should
- usually be set <strong>off</strong> when using
+ <p>Cette directive permet de référencer des serveurs distants depuis
+ l'espace d'URLs du serveur local ; le serveur
+ local n'agit pas en tant que mandataire au sens conventionnel, mais
+ plutôt comme miroir du serveur distant. Le serveur local est
+ souvent nommé <dfn>mandataire inverse</dfn> ou
+ <dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un
+ chemin virtuel local ; <var>url</var> est une URL partielle pour le
+ serveur distant et ne doit pas contenir de chaîne d'arguments.</p>
+
+ <div class="note">Il est fortement recommandé de revoir le concept de <a href="#workers">Worker</a> avant d'aller plus loin.</div>
+
+ <div class="note">Cette directive n'est pas supportée au sein
+ des sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
+ et <code class="directive"><a href="../mod/core.html#files"><Files></a></code>.</div>
+
+ <div class="warning">En général, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit être définie à
+ <strong>off</strong> lorsqu'on utilise la directive
<code class="directive">ProxyPass</code>.</div>
- <p>In 2.4.7 and later, support for using a Unix Domain Socket is available by using a target
- which prepends <code>unix:/path/lis.sock|</code>. For example, to proxy
- HTTP and target the UDS at /home/www/socket, you would use
- <code>unix:/home/www.socket|http://localhost/whatever/</code>. Since
- the socket is local, the hostname used (in this case <code>localhost</code>)
- is moot, but it is passed as the Host: header value of the request.</p>
-
- <div class="note"><strong>Note:</strong> The path associated with the <code>unix:</code>
- URL is <code class="directive">DefaultRuntimeDir</code> aware.</div>
-
- <div class="note"><strong>Note:</strong> <code class="directive">RewriteRule</code> requires
- the <code>[P,NE]</code> option to prevent the <code>'|'</code> character
- from being escaped.</div>
-
- <p>When used inside a <code class="directive"><a href="../mod/core.html#location"><Location></a></code> section, the first argument is omitted and the local
- directory is obtained from the <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. The same will occur inside a
- <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> section;
- however, ProxyPass does not interpret the regexp as such, so it is necessary
- to use <code class="directive">ProxyPassMatch</code> in this situation instead.</p>
-
- <p>Suppose the local server has address <code>http://example.com/</code>;
- then</p>
+ <p>Les sockets de style Unix sont supportés à partir de la version
+ 2.4.7 du serveur HTTP Apache ; pour utiliser cette fonctionnalité,
+ il suffit d'utiliser une URL cible préfixée par
+ <code>unix:/path/lis.sock|</code>. Par exemple, pour mandater HTTP
+ et cibler l'UDS /home/www/socket, vous devez utiliser
+ <code>unix:/home/www.socket|http://localhost/whatever/</code>. Comme
+ le socket est local, le nom d'hôte utilisé (ici
+ <code>localhost</code>) peut être sujet à discussion, mais il est
+ transmis dans l'en-tête Host: de la requête.</p>
+
+ <div class="note"><strong>Note :</strong>Le chemin associé à l'URL
+ <code>unix:</code> tient compte de la directive
+ <code class="directive">DefaultRuntimeDir</code>.</div>
+
+ <div class="note"><strong>Note :</strong>Afin d'éviter l'échappement du
+ caractère <code>'|'</code>, la directive
+ <code class="directive">RewriteRule</code> doit posséder l'option
+ <code>[P,NE]</code>.</div>
+
+ <p>Lorsque la directive ProxyPass est utilisée à l'intérieur d'une
+ section <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, le premier argument est omis et le répertoire
+ local est obtenu à partir de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Il en sera de même dans une
+ section <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> ; cependant, ProxyPass
+ n'interprète pas les expressions rationnelles, et il sera ici
+ nécessaire d'utiliser la directive
+ <code class="directive">ProxyPassMatch</code> à la place.</p>
+
+ <p>Supposons que le serveur local a pour adresse
+ <code>http://example.com/</code> ; alors la ligne</p>
<pre class="prettyprint lang-config"><Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location></pre>
- <p>will cause a local request for
- <code>http://example.com/mirror/foo/bar</code> to be internally converted
- into a proxy request to <code>http://backend.example.com/bar</code>.</p>
+ <p>va convertir en interne toute requête pour
+ <code>http://example.com/miroir/foo/bar</code> en une requête
+ mandatée pour <code>http://backend.example.com/bar</code>.</p>
- <p>If you require a more flexible reverse-proxy configuration, see the
- <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directive with the
- <code>[P]</code> flag.</p>
+ <p>Si vous avez besoin d'un configuration de mandataire inverse plus
+ souple, reportez-vous à la documentation de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau
+ <code>[P]</code>.</p>
- <p>The following alternative syntax is possible; however, it can carry a
- performance penalty when present in very large numbers. The advantage of
- the below syntax is that it allows for dynamic control via the
- <a href="mod_proxy_balancer.html#balancer_manager">Balancer Manager</a> interface:</p>
+ <p>La syntaxe alternative suivante est valide, bien qu'elle puisse
+ induire une dégradation des performances lorsqu'elle est
+ présente en très grand nombre. Elle possède l'avantage de
+ permettre un contrôle dynamique via l'interface <a href="mod_proxy_balancer.html#balancer_manager">Balancer Manager</a> :</p>
- <pre class="prettyprint lang-config">ProxyPass "/mirror/foo/" "http://backend.example.com/"</pre>
+ <pre class="prettyprint lang-config">ProxyPass "/miroir/foo/" "http://backend.example.com/"</pre>
<div class="warning">
- <p>If the first argument ends with a trailing <strong>/</strong>, the second
- argument should also end with a trailing <strong>/</strong>, and vice
- versa. Otherwise, the resulting requests to the backend may miss some
- needed slashes and do not deliver the expected results.
+ <p>Si le premier argument se termine par un slash
+ <strong>/</strong>, il doit en être de même pour le second argument
+ et vice versa. Dans le cas contraire, il risque de manquer des
+ slashes nécessaires dans la requête résultante vers le serveur
+ d'arrière-plan et les résulats ne seront pas ceux attendus.
</p>
</div>
- <p>The <code>!</code> directive is useful in situations where you don't want
- to reverse-proxy a subdirectory, <em>e.g.</em></p>
+ <p>Le drapeau <code>!</code> permet de soustraire un sous-répertoire
+ du mandat inverse, comme dans l'exemple suivant :</p>
<pre class="prettyprint lang-config"><Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
<pre class="prettyprint lang-config">ProxyPass "/mirror/foo/i" "!"
-ProxyPass "/mirror/foo" "http://backend.example.com"</pre>
-
-
- <p>will proxy all requests to <code>/mirror/foo</code> to
- <code>backend.example.com</code> <em>except</em> requests made to
- <code>/mirror/foo/i</code>.</p>
-
- <div class="warning"><h3>Ordering ProxyPass Directives</h3>
- <p>The configured <code class="directive"><a href="#proxypass">ProxyPass</a></code>
- and <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code>
- rules are checked in the order of configuration. The first rule that
- matches wins. So usually you should sort conflicting
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> rules starting with the
- longest URLs first. Otherwise, later rules for longer URLS will be hidden
- by any earlier rule which uses a leading substring of the URL. Note that
- there is some relation with worker sharing. In contrast, only one
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive can be placed
- in a <code class="directive"><a href="../mod/core.html#location">Location</a></code> block, and the most
- specific location will take precedence.</p>
-
- <p>For the same reasons, exclusions must come <em>before</em> the
- general <code class="directive">ProxyPass</code> directives. In 2.4.26 and later, the "no-proxy"
- environment variable is an alternative to exclusions, and is the only
- way to configure an exclusion of a <code class="directive">ProxyPass</code>
- directive in <code class="directive"><a href="../mod/core.html#location">Location</a></code> context.
- This variable should be set with <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, as <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>
- is not evaluated early enough.
- </p>
+ProxyPass "/mirror/foo" "http://backend.example.com"</pre>
+
+
+ <p>va mandater toutes les requêtes pour <code>/miroir/foo</code>
+ vers <code>backend.example.com</code>, <em>sauf</em> les requêtes
+ pour <code>/miroir/foo/i</code>.</p>
+
+ <div class="warning"><h3>Ordre de classement des directives ProxyPass</h3>
+ <p>Les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> et <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> sont évaluées dans
+ l'ordre de leur apparition dans le fichier de configuration. La
+ première règle qui correspond s'applique. Vous devez donc en
+ général classer les règles <code class="directive"><a href="#proxypass">ProxyPass</a></code> qui entrent en conflit de
+ l'URL la plus longue à la plus courte. Dans le cas contraire, les
+ règles situées après une règle dont l'URL correspond au début de
+ leur propre URL seront ignorées. Notez que tout ceci est en
+ relation avec le partage de workers. Par contre, on ne peut placer
+ qu'une seule directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> dans une section
+ <code class="directive"><a href="../mod/core.html#location">Location</a></code>, et c'est la section
+ la plus spécifique qui l'emportera.</p>
+
+ <p>Pour les mêmes raisons, les exclusions doivent se situer <em>avant</em>
+ les directives <code class="directive">ProxyPass</code> générales. A partir de la
+ version 2.4.26 du serveur HTTP Apache, la variable
+ d'environnement "no-proxy" est une alternative aux exclusions et constitue
+ le seul moyen de configurer une exclusion pour une directive
+ <code class="directive">ProxyPass</code> dans le contexte d'une section <code class="directive"><a href="../mod/core.html#location">Location</a></code>. Cette variable doit être définie via
+ la directive <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> car la
+ directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code> n'est pas évaluée
+ assez tôt.</p>
</div>
- <p><strong>ProxyPass <code>key=value</code> Parameters</strong></p>
-
- <p>In Apache HTTP Server 2.1 and later, mod_proxy supports pooled
- connections to a backend server. Connections created on demand
- can be retained in a pool for future use. Limits on the pool size
- and other settings can be coded on
- the <code class="directive">ProxyPass</code> directive
- using <code>key=value</code> parameters, described in the tables
- below.</p>
-
- <div class="warning"><h3>Maximum connections to the backend</h3>
- <p>By default, mod_proxy will allow and retain the maximum number of
- connections that could be used simultaneously by that web server child
- process. Use the <code>max</code> parameter to reduce the number from
- the default. The pool of connections is maintained per web server child
- process, and <code>max</code> and other settings are not coordinated
- among all child processes, except when only one child process is allowed
- by configuration or MPM design.</p>
- </div>
-
- <p>Use the <code>ttl</code> parameter to set an optional
- time to live; connections which have been unused for at least
- <code>ttl</code> seconds will be closed. <code>ttl</code> can be used
- to avoid using a connection which is subject to closing because of the
- backend server's keep-alive timeout.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300</pre>
+ <p><strong>ProxyPass <code>clé=valeur</code> Paramètres</strong></p>
+
+ <p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
+ les groupements de connexions vers un serveur d'arrière-plan. Les
+ connexions créées à la demande peuvent être enregistrées dans un
+ groupement pour une utilisation ultérieure. La taille du groupe
+ ainsi que d'autres caractéristiques peuvent être définies via la
+ directive <code class="directive">ProxyPass</code> au moyen de paramètres
+ <code>clé=valeur</code> dont la description fait l'objet du tableau
+ ci-dessous.</p>
+
+ <div class="warning"><h3>Nombre maximum de connexions vers
+ l'arrière-plan</h3>
+ <p>Par défaut, mod_proxy permet et met en réserve le
+ nombre maximum de connexions pouvant être utilisées simultanément par le
+ processus enfant concerné du serveur web. Le paramètre <code>max</code>
+ permet de réduire cette valeur par défaut. Le jeu de connexions est maintenu
+ au niveau de chaque processus enfant du serveur web, <code>max</code> et les
+ autres réglages n'étant pas coordonnés entre ces différents processus, sauf
+ bien entendu lorsqu'un seul processus enfant n'est autorisé par la
+ configuration ou le MPM utilisé.</p> </div>
+
+ <p>Le paramètre <code>ttl</code>, quant à lui, permet de définir une durée
+ de vie optionnelle ; les connexions qui n'ont pas été utilisées pendant au
+ moins <code>ttl</code> secondes seront fermées. <code>ttl</code> permet
+ aussi d'empêcher l'utilisation d'une connexion susceptible d'être fermée
+ suite à une fin de vie de connexion persistante sur le serveur
+ d'arrière-plan.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300</pre>
</div>
- <table class="bordered"><tr><th>Worker|BalancerMember parameters</th></tr></table>
+ <table class="bordered"><tr><th>Paramètres du worker (directive BalancerMember)</th></tr></table>
<table>
- <tr><th>Parameter</th>
- <th>Default</th>
+ <tr><th>Paramètre</th>
+ <th>Défaut</th>
<th>Description</th></tr>
<tr><td>min</td>
<td>0</td>
- <td>Minimum number of connection pool entries, unrelated to the
- actual number of connections. This only needs to be modified from the
- default for special circumstances where heap memory associated with the
- backend connections should be preallocated or retained.</td></tr>
+ <td>Nombre minimum d'entrées dans le pool de connexions,
+ distinct du nombre de connexions effectif. La valeur par défaut
+ ne doit être modifiée que dans des circonstances particulières
+ où la mémoire associée aux connexions avec le serveur
+ d'arrière-plan doit être préallouée ou réservée dans le tas.</td></tr>
<tr><td>max</td>
<td>1...n</td>
- <td>Maximum number of connections that will be allowed to the
- backend server. The default for this limit is the number of threads
- per process in the active MPM. In the Prefork MPM, this is always 1;
- while with other MPMs, it is controlled by the
- <code class="directive">ThreadsPerChild</code> directive.</td></tr>
+ <td>Nombre maximum de connexions autorisées vers le serveur
+ d'arrière-plan. La valeur par défaut correspond au nombre de
+ threads par processus pour le MPM (Module Multi Processus)
+ actif. La valeur sera toujours 1 pour le MPM Prefork, alors
+ qu'elle dépendra de la définition de la directive
+ <code class="directive">ThreadsPerChild</code> pour les autres MPMs.</td></tr>
<tr><td>smax</td>
<td>max</td>
- <td>Retained connection pool entries above this limit are freed
- during certain operations if they have been unused for longer than
- the time to live, controlled by the <code>ttl</code> parameter. If
- the connection pool entry has an associated connection, it will be
- closed. This only needs to be modified from the default for special
- circumstances where connection pool entries and any associated
- connections which have exceeded the time to live need to be freed or
- closed more aggressively.</td></tr>
+ <td>Les entrées du pool de connexions conservées au delà de
+ cette limite sont libérées au cours de certaines opérations si
+ elles n'ont pas été utilisées au cours de leur durée de vie,
+ définie par le paramètre <code>ttl</code>. Si l'entrée du pool
+ de connexions est associée à une connexion, cette dernière sera
+ fermée. La valeur par défaut ne doit être modifiée que dans des
+ circonstances particulières où les entrées du pool de connexions
+ et toutes connexions associées qui ont dépassé leur durée de vie
+ doivent être libérées ou fermées de manière plus autoritaire.</td></tr>
<tr><td>acquire</td>
<td>-</td>
- <td>If set, this will be the maximum time to wait for a free
- connection in the connection pool, in milliseconds. If there are no free
- connections in the pool, the Apache httpd will return <code>SERVER_BUSY</code>
- status to the client.
+ <td>Cette clé permet de définir le délai maximum d'attente pour
+ une connexion libre dans le jeu de connexions, en millisecondes.
+ S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
+ l'état <code>SERVER_BUSY</code> au client.
</td></tr>
<tr><td>connectiontimeout</td>
<td>timeout</td>
- <td>Connect timeout in seconds.
- The number of seconds Apache httpd waits for the creation of a connection to
- the backend to complete. By adding a postfix of ms, the timeout can be
- also set in milliseconds. Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax
+ <td>Délai d'attente d'une connexion en secondes.
+ La durée en secondes pendant laquelle Apache httpd va attendre pour
+ l'établissement d'une connexion vers le serveur d'arrière-plan.
+ Le délai peut être spécifié en millisecondes en ajoutant le
+ suffixe ms. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>disablereuse</td>
<td>Off</td>
- <td>This parameter should be used when you want to force mod_proxy
- to immediately close a connection to the backend after being used, and
- thus, disable its persistent connection and pool for that backend.
- This helps in various situations where a firewall between Apache
- httpd and
- the backend server (regardless of protocol) tends to silently
- drop connections or when backends themselves may be under round-
- robin DNS.
- When connection reuse is enabled each backend domain is resolved
- (with a DNS query) only once per child process and cached for all further
- connections until the child is recycled. To disable connection reuse,
- set this property value to <code>On</code>.
+ <td>Vous pouvez utiliser cette clé pour forcer mod_proxy à
+ fermer immédiatement une connexion vers le serveur
+ d'arrière-plan après utilisation, et ainsi désactiver le jeu de
+ connexions permanentes vers ce serveur. Ceci peut s'avérer utile
+ dans des situations où un pare-feu situé entre Apache httpd et le
+ serveur d'arrière-plan (quelque soit le protocole) interrompt
+ des connexions de manière silencieuse, ou lorsque le serveur
+ d'arrière-plan lui-même est accessible par rotation de DNS
+ (round-robin DNS). Lorsque la réutilisation des connexions est activée,
+ chaque domaine d'arrière-plan n'est résolu (via une requête DNS) qu'une
+ seule fois par chaque processus enfant et mis en cache pour toutes les
+ connexions ultérieures jusqu'au recyclage du processus concerné.
+ Pour désactiver la réutilisation du jeu de
+ connexions, définissez cette clé à <code>On</code>.
</td></tr>
<tr><td>enablereuse</td>
<td>On</td>
- <td>This is the inverse of 'disablereuse' above, provided as a
- convenience for scheme handlers that require opt-in for connection
- reuse (such as <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>).
+ <td>Fournie à l'intention des gestionnaires de projet
+ qui nécessitent un accord pour la réutilisation des connexions
+ (tels que <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>),
+ cette option est l'inverse de l'option 'disablereuse' ci-dessus.
</td></tr>
<tr><td>flushpackets</td>
<td>off</td>
- <td>Determines whether the proxy module will auto-flush the output
- brigade after each "chunk" of data. 'off' means that it will flush
- only when needed; 'on' means after each chunk is sent; and
- 'auto' means poll/wait for a period of time and flush if
- no input has been received for 'flushwait' milliseconds.
- Currently, this is in effect only for mod_proxy_ajp and mod_proxy_fcgi.
+ <td>Permet de définir si le module mandataire doit vider
+ automatiquement le tampon de sortie après chaque tronçon de
+ données. 'off' signifie que le tampon sera vidé si nécessaire,
+ 'on' que le tampon sera vidé après chaque envoi d'un
+ tronçon de données, et 'auto' que le tampon sera vidé après un
+ délai de 'flushwait' millisecondes si aucune entrée n'est reçue.
+ Actuellement, cette clé n'est supportée que par mod_proxy_ajp et
+ mod_proxy_fcgi.
</td></tr>
<tr><td>flushwait</td>
<td>10</td>
- <td>The time to wait for additional input, in milliseconds, before
- flushing the output brigade if 'flushpackets' is 'auto'.
- Uses <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Le délai d'attente pour une entrée additionnelle, en
+ millisecondes, avant le vidage du tampon en sortie dans le cas
+ où 'flushpackets' est à 'auto'. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>iobuffersize</td>
<td>8192</td>
- <td>Adjusts the size of the internal scratchpad IO buffer. This allows you
- to override the <code class="directive">ProxyIOBufferSize</code> for a specific worker.
- This must be at least 512 or set to 0 for the system default of 8192.
+ <td>Permet de définir la taille du tampon d'entrées/sorties du
+ bloc-notes interne. Cette clé vous permet d'outrepasser la
+ directive <code class="directive">ProxyIOBufferSize</code> pour un
+ serveur cible spécifique. La valeur doit être au minimum 512 ou définie
+ à 0 pour la valeur par défaut du système de 8192.
</td></tr>
<tr><td>keepalive</td>
<td>Off</td>
- <td><p>This parameter should be used when you have a firewall between your
- Apache httpd and the backend server, which tends to drop inactive connections.
- This flag will tell the Operating System to send <code>KEEP_ALIVE</code>
- messages on inactive connections and thus prevent the firewall
- from dropping the connection.
- To enable keepalive, set this property value to <code>On</code>. </p>
- <p>The frequency of initial and subsequent TCP keepalive probes
- depends on global OS settings, and may be as high as 2 hours. To be useful,
- the frequency configured in the OS must be smaller than the threshold used
- by the firewall. Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.</p>
+ <td><p>Cette clé doit être utilisée lorsque vous avez un pare-feu
+ entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
+ à interrompre les connexions inactives. Cette clé va faire en
+ sorte que le système d'exploitation envoie des messages
+ <code>KEEP_ALIVE</code> sur chacune des connexions inactives et
+ ainsi éviter la fermeture de la connexion par le pare-feu.
+ Pour conserver les connexions persistantes, definissez cette
+ propriété à <code>On</code>.</p>
+ <p>La fréquence de vérification des connexions TCP persistantes
+ initiale et subséquentes dépend de la configuration globale de l'OS,
+ et peut atteindre 2 heures. Pour être utile, la fréquence configurée
+ dans l'OS doit être inférieure au seuil utilisé par le pare-feu. Utilise la
+ syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.</p>
+
</td></tr>
<tr><td>lbset</td>
<td>0</td>
- <td>Sets the load balancer cluster set that the worker is a member
- of. The load balancer will try all members of a lower numbered
- lbset before trying higher numbered ones.
+ <td>Définit le groupe de répartition de charge dont le serveur cible
+ est membre. Le répartiteur de charge va essayer tous les membres
+ d'un groupe de répartition de charge de numéro inférieur avant
+ d'essayer ceux dont le groupe possède un numéro supérieur.
</td></tr>
<tr><td>ping</td>
<td>0</td>
- <td>Ping property tells the webserver to "test" the connection to
- the backend before forwarding the request. For negative values,
- the test is a simple socket check; for positive values, it's
- a more functional check, dependent upon the protocol. For AJP, it causes
- <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> to send a <code>CPING</code>
- request on the ajp13 connection (implemented on Tomcat 3.3.2+, 4.1.28+
- and 5.0.13+). For HTTP, it causes <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>
- to send a <code>100-Continue</code> to the backend (only valid for
- HTTP/1.1 - for non HTTP/1.1 backends, this property has no
- effect). In both cases, the parameter is the delay in seconds to wait
- for the reply.
- This feature has been added to avoid problems with hung and
- busy backends.
- This will increase the network traffic during the normal operation
- which could be an issue, but it will lower the
- traffic in case some of the cluster nodes are down or busy.
- By adding a postfix of ms, the delay can be also set in
- milliseconds. Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Avec la clé Ping, le serveur web va "tester" la connexion
+ vers le serveur d'arrière-plan avant de transmettre la requête.
+ Pour les valeurs négatives, le test est une simple vérification
+ de socket, alors que pour les valeurs positives, il s'agit d'une
+ vérification plus approfondie dépendant du protocole.
+ Avec AJP, <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> envoie une requête
+ <code>CPING</code> sur la connexion ajp13 (implémenté sur Tomcat
+ 3.3.2+, 4.1.28+ et 5.0.13+). Avec HTTP,
+ <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> envoie <code>100-Continue</code>
+ au serveur d'arrière-plan (seulement avecHTTP/1.1 - pour les
+ serveurs d'arrière-plan non HTTP/1.1, cette clé ne produit
+ aucun effet). Dans les deux cas, ce paramètre correspond au
+ délai en secondes pour l'attente de la réponse. Cette
+ fonctionnalité a été ajoutée pour éviter les problèmes avec les
+ serveurs d'arrière-plan bloqués ou surchargés.
+
+ Le trafic
+ réseau peut s'en trouver augmenté en fonctionnement normal, ce
+ qui peut poser problème, mais peut s'en trouver diminué dans les
+ cas où les noeuds de cluster sont arrêtés ou
+ surchargés. Le délai peut
+ aussi être défini en millisecondes en ajoutant le suffixe
+ ms. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>receivebuffersize</td>
<td>0</td>
- <td>Adjusts the size of the explicit (TCP/IP) network buffer size for
- proxied connections. This allows you to override the
- <code class="directive">ProxyReceiveBufferSize</code> for a specific worker.
- This must be at least 512 or set to 0 for the system default.
+ <td>Définit la taille du tampon réseau explicite (TCP/IP) pour
+ les connexions mandatées. Cette clé vous permet d'outrepasser la
+ directive <code class="directive">ProxyReceiveBufferSize</code> pour un
+ serveur cible spécifique. Sa valeur doit être au minimum 512 ou définie
+ à 0 pour la valeur par défaut du système.
</td></tr>
<tr><td>redirect</td>
<td>-</td>
- <td>Redirection Route of the worker. This value is usually
- set dynamically to enable safe removal of the node from
- the cluster. If set, all requests without session id will be
- redirected to the BalancerMember that has route parameter
- equal to this value.
+ <td>Route pour la redirection du serveur cible. Cette valeur est en
+ général définie dynamiquement pour permettre une suppression
+ sécurisée du noeud du cluster. Si cette clé est définie, toutes
+ les requêtes sans identifiant de session seront redirigées vers
+ le membre de groupe de répartition de charge dont la route
+ correspond à la valeur de la clé.
</td></tr>
<tr><td>retry</td>
<td>60</td>
- <td>Connection pool worker retry timeout in seconds.
- If the connection pool worker to the backend server is in the error state,
- Apache httpd will not forward any requests to that server until the timeout
- expires. This enables to shut down the backend server for maintenance
- and bring it back online later. A value of 0 means always retry workers
- in an error state with no timeout.
- Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Délai entre deux essais du serveur cible du jeu de connexions en
+ secondes. Si le serveur cible du jeu de connexions vers le serveur
+ d'arrière-plan est dans un état d'erreur, Apache httpd ne redirigera
+ pas de requête vers ce serveur avant l'expiration du délai
+ spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
+ maintenance, et de le remettre en ligne plus tard. Une valeur de
+ 0 implique de toujours essayer les serveurs cibles dans un état d'erreur
+ sans délai. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>route</td>
<td>-</td>
- <td>Route of the worker when used inside load balancer.
- The route is a value appended to session id.
+ <td>La route du serveur cible lorsqu'il est utilisé au sein d'un
+ répartiteur de charge. La route est une valeur ajoutée à
+ l'identifiant de session.
</td></tr>
<tr><td>status</td>
<td>-</td>
- <td>Single letter value defining the initial status of
- this worker.
- <table class="bordered">
- <tr><td><code>D</code></td><td>Worker is disabled and will not accept any requests; will be
- automatically retried.</td></tr>
- <tr><td><code>S</code></td><td>Worker is administratively stopped; will not accept requests
- and will not be automatically retried</td></tr>
- <tr><td><code>I</code></td><td>Worker is in ignore-errors mode and will always be considered available.</td></tr>
- <tr><td><code>H</code></td><td>Worker is in hot-standby mode and will only be used if no other
- viable workers are available.</td></tr>
- <tr><td><code>E</code></td><td>Worker is in an error state.</td></tr>
- <tr><td><code>N</code></td><td>Worker is in drain mode and will only accept existing sticky sessions
- destined for itself and ignore all other requests.</td></tr>
+ <td>Valeur constituée d'une simple lettre et définissant l'état
+ initial de ce serveur cible.
+ <table class="bordered">
+ <tr><td><code>D</code></td><td>le serveur cible est
+ désactivé et n'accepte aucune requête ; sa
+ réactivation sera automatiquement relancée.</td></tr>
+ <tr><td><code>S</code></td><td>le serveur cible est arrêté
+ ; il n'accepte plus de requête et sa réactivation ne sera pas
+ automatiquement relancée.</td></tr>
+ <tr><td><code>I</code></td><td>le serveur cible est en mode "erreurs ignorées",
+ et sera toujours considéré comme disponible.</td></tr>
+ <tr><td><code>H</code></td><td>le serveur cible est en mode d'attente et ne sera
+ utilisé que si aucun autre serveur n'est disponible.</td></tr>
+ <tr><td><code>E</code></td><td>le serveur cible est en erreur.</td></tr>
+ <tr><td><code>N</code></td><td>le serveur cible est en mode vidage, n'acceptera que
+ les sessions persistantes qui lui appartiennent, et refusera
+ toutes les autres requêtes.</td></tr>
</table>
- Status can be set (which is the default) by prepending with '+' or
- cleared by prepending with '-'.
- Thus, a setting of 'S-E' sets this worker to Stopped and
- clears the in-error flag.
+ Une valeur d'état peut être définie (ce qui
+ correspond au comportement par défaut) en préfixant la valeur
+ par '+', ou annulée en préfixant la valeur par '-'. Ainsi, la
+ valeur 'S-E' définit l'état de ce serveur cible à "arrêté" et supprime
+ le drapeau "en-erreur".
</td></tr>
<tr><td>timeout</td>
<td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td>
- <td>Connection timeout in seconds.
- The number of seconds Apache httpd waits for data sent by / to the backend.
- Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Délai d'attente de la connexion en secondes. Le nombre de
+ secondes pendant lesquelles Apache httpd attend l'envoi de
+ données vers le serveur d'arrière-plan. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>ttl</td>
<td>-</td>
- <td>Time to live for inactive connections and associated connection
- pool entries, in seconds. Once reaching this limit, a
- connection will not be used again; it will be closed at some
- later time. Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Durée de vie des connexions inactives et des entrées du pool
+ de connexions associées en secondes. Une fois cette
+ limite atteinte, une connexion ne sera pas réutilisée ; elle
+ sera fermée après un délai variable. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>flusher</td>
<td>flush</td>
- <td><p>
Name of the provider used by <code class="module"><a href="../mod/mod_proxy_fdpass.html">mod_proxy_fdpass</a></code>.
- See the documentation of this module for more details.</p>
+ <td><p>
Le fournisseur utilisé par <code class="module"><a href="../mod/mod_proxy_fdpass.html">mod_proxy_fdpass</a></code>.
+ Se référer à la documentation de ce module pour plus de détails.</p>
</td></tr>
<tr><td>secret</td>
<td>-</td>
- <td><p>Value of secret used by <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>.
- See the documentation of this module for more details.</p>
+ <td><p>Le mot de passe utilisé par <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>. Voir
+ la documentation de ce module pour plus de détails.</p>
</td></tr>
<tr><td>upgrade</td>
<td>WebSocket</td>
- <td><p>Protocol accepted in the Upgrade header by <code class="module"><a href="../mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code>.
- See the documentation of this module for more details.</p>
+ <td><p>Le protocol accepté par <code class="module"><a href="../mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code> dans
+ l'en-tête Upgrade. Voir la documentation de ce module pour plus de
+ détails.</p>
</td></tr>
</table>
- <p>If the Proxy directive scheme starts with the
- <code>balancer://</code> (eg: <code>balancer://cluster</code>,
- any path information is ignored), then a virtual worker that does not really
- communicate with the backend server will be created. Instead, it is responsible
- for the management of several "real" workers. In that case, the special set of
- parameters can be added to this virtual worker. See <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>
- for more information about how the balancer works.
+ <p>Si l'URL de la directive Proxy débute par
+ <code>balancer://</code> (par exemple:
+ <code>balancer://cluster</code>, toute information relative au
+ chemin est ignorée), alors un serveur cible virtuel ne communiquant pas
+ réellement avec le serveur d'arrière-plan sera créé. Celui-ci sera
+ en fait responsable de la gestion de plusieurs serveurs cibles "réels". Dans
+ ce cas, un jeu de paramètres particuliers s'applique à ce serveur cible
+ virtuel. Voir <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus
+ d'informations à propos du fonctionnement du répartiteur de
+ charge.
</p>
- <table class="bordered"><tr><th>Balancer parameters</th></tr></table>
+ <table class="bordered"><tr><th>Paramètres du répartiteur</th></tr></table>
<table>
- <tr><th>Parameter</th>
- <th>Default</th>
+ <tr><th>Paramètre</th>
+ <th>Défaut</th>
<th>Description</th></tr>
<tr><td>lbmethod</td>
<td>byrequests</td>
- <td>Balancer load-balance method. Select the load-balancing scheduler
- method to use. Either <code>byrequests</code>, to perform weighted
- request counting; <code>bytraffic</code>, to perform weighted
- traffic byte count balancing; or <code>bybusyness</code>, to perform
- pending request balancing. The default is <code>byrequests</code>.
+ <td>Méthode de répartition de charge utilisée. Permet de
+ sélectionner la méthode de planification de la répartition de
+ charge à utiliser. La valeur est soit <code>byrequests</code>,
+ pour effectuer un décompte de requêtes pondérées, soit
+ <code>bytraffic</code>, pour effectuer une répartition en
+ fonction du décompte des octets transmis, soit
+ <code>bybusyness</code>, pour effectuer une répartition en
+ fonction des requêtes en attente. La valeur par défaut est
+ <code>byrequests</code>.
</td></tr>
<tr><td>maxattempts</td>
- <td>One less than the number of workers, or 1 with a single worker.</td>
- <td>Maximum number of failover attempts before giving up.
+ <td>1 de moins que le nombre de workers, ou 1 avec un seul
+ worker</td>
+ <td>Nombre maximum d'échecs avant abandon.
</td></tr>
<tr><td>nofailover</td>
<td>Off</td>
- <td>If set to <code>On</code>, the session will break if the worker is in
- error state or disabled. Set this value to <code>On</code> if backend
- servers do not support session replication.
+ <td>Si ce paramètre est défini à <code>On</code>, la session va
+ s'interrompre si le serveur cible est dans un état d'erreur ou
+ désactivé. Définissez ce paramètre à <code>On</code> si le serveur
+ d'arrière-plan ne supporte pas la réplication de session.
</td></tr>
<tr><td>stickysession</td>
<td>-</td>
- <td>Balancer sticky session name. The value is usually set to something
- like <code>JSESSIONID</code> or <code>PHPSESSIONID</code>,
- and it depends on the backend application server that support sessions.
- If the backend application server uses different names for cookies
- and url encoded id (like servlet containers), use | to separate them.
- The first part is for the cookie; the second is for the path.<br />
- Available in Apache HTTP Server 2.4.4 and later.
+ <td>Nom de session persistant du répartiteur. La valeur est
+ généralement du style <code>JSESSIONID</code> ou
+ <code>PHPSESSIONID</code>, et dépend du serveur d'application
+ d'arrière-plan qui supporte les sessions. Si le serveur
+ d'application d'arrière-plan utilise des noms différents pour
+ les cookies et les identifiants codés d'URL (comme les
+ conteneurs de servlet), séparez-les par le caractère '|'. La
+ première partie contient le cookie et la seconde le chemin.<br />
+ Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<tr><td>stickysessionsep</td>
<td>"."</td>
- <td>Sets the separation symbol in the session cookie. Some backend application servers
- do not use the '.' as the symbol. For example, the Oracle Weblogic server uses
- '!'. The correct symbol can be set using this option. The setting of 'Off'
- signifies that no symbol is used.
+ <td>Permet de définir le caractère de séparation dans le cookie
+ de session. En effet, certains serveurs d'application d'arrière-plan
+ n'utilisent pas le '.' comme caractère de séparation. Par
+ exemple, le serveur Oracle Weblogic utilise le caractère '!'.
+ Cette option permet donc de définir le caractère de séparation à
+ une valeur appropriée. Si elle est définie à 'Off', aucun
+ caractère de séparation ne sera utilisé.
</td></tr>
<tr><td>scolonpathdelim</td>
<td>Off</td>
- <td>If set to <code>On</code>, the semi-colon character ';' will be
- used as an additional sticky session path delimiter/separator. This
- is mainly used to emulate mod_jk's behavior when dealing with paths such
- as <code>JSESSIONID=6736bcf34;foo=aabfa</code>
+ <td>Si ce paramètre est défini à <code>On</code>, le caractère
+ ';' sera utilisé comme séparateur de chemin de session
+ persistante additionnel. Ceci permet principalement de simuler
+ le comportement de mod_jk lorsqu'on utilise des chemins du style
+ <code>JSESSIONID=6736bcf34;foo=aabfa</code>.
</td></tr>
<tr><td>timeout</td>
<td>0</td>
- <td>Balancer timeout in seconds. If set, this will be the maximum time
- to wait for a free worker. The default is to not wait.
- Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.
+ <td>Délai du répartiteur en secondes. Si ce paramètre est
+ défini, sa valeur correspond à la durée maximale d'attente pour
+ un serveur cible libre. Le comportement par défaut est de ne pas
+ attendre. Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>failonstatus</td>
<td>-</td>
- <td>A single or comma-separated list of HTTP status codes. If set, this will
- force the worker into error state when the backend returns any status code
- in the list. Worker recovery behaves the same as other worker errors.
+ <td>Une liste de codes d'état HTTP séparés par des virgules. Si
+ ce paramètre est présent, le worker se mettra en erreur si le
+ serveur d'arrière-plan renvoie un des codes d'état spécifiés
+ dans la liste. La récupération du worker s'effectue comme dans
+ le cas des autres erreurs de worker.
</td></tr>
+
<tr><td>failontimeout</td>
<td>Off</td>
- <td>If set, an IO read timeout after a request is sent to the backend will
- force the worker into error state. Worker recovery behaves the same as other
- worker errors.<br />
- Available in Apache HTTP Server 2.4.5 and later.
+ <td>Si ce paramètre est défini à "On", un délai d'attente
+ dépassé en entrée/sortie après envoi d'une requête au serveur
+ d'arrière-plan va mettre le processus en état d'erreur. La
+ sortie de cet état d'erreur se passe de la même façon que pour
+ les autres erreurs.<br />
+ Disponible depuis la version 2.4.5 du serveur HTTP Apache.
</td></tr>
+
<tr><td>nonce</td>
<td><auto></td>
- <td>The protective nonce used in the <code>balancer-manager</code> application page.
- The default is to use an automatically determined UUID-based
- nonce, to provide for further protection for the page. If set,
- then the nonce is set to that value. A setting of <code>None</code>
- disables all nonce checking.
+ <td>Le nombre à usage unique de protection utilisé dans la page
+ de l'application <code>balancer-manager</code>. Par défaut, la
+ protection de la page est assurée par un nombre à usage unique
+ automatique à base d'UUID. Si une valeur est précisée, elle sera
+ utilisée comme nombre à usage unique. La valeur
+ <code>None</code> désactive la vérification du nombre à usage
+ unique.
<div class="note"><h3>Note</h3>
- <p>In addition to the nonce, the <code>balancer-manager</code> page
- should be protected via an ACL.</p>
+ <p>En plus du nombre à usage unique, la page de l'application
+ <code>balancer-manager</code> peut être protégée par une ACL.</p>
</div>
</td></tr>
<tr><td>growth</td>
<td>0</td>
- <td>Number of additional BalancerMembers to allow to be added
- to this balancer in addition to those defined at configuration.
+ <td>Nombre de membres supplémentaires que l'on peut ajouter à ce
+ répartiteur en plus de ceux définis au niveau de la
+ configuration.
</td></tr>
<tr><td>forcerecovery</td>
<td>On</td>
- <td>Force the immediate recovery of all workers without considering the
- retry parameter of the workers if all workers of a balancer are
- in error state. There might be cases where an already overloaded backend
- can get into deeper trouble if the recovery of all workers is enforced
- without considering the retry parameter of each worker. In this case,
- set to <code>Off</code>.<br />
- Available in Apache HTTP Server 2.4.2 and later.
+ <td>Force la relance immédiate de tous les membres sans tenir
+ compte de leur paramètre retry dans le cas où ils sont tous en
+ état d'erreur. Il peut cependant arriver qu'un membre déjà
+ surchargé entre dans une situation critique si la relance de
+ tous les membres est forcée sans tenir compte du paramètre retry
+ de chaque membre. Dans ce cas, définissez ce paramètre à
+ <code>Off</code>.<br />
+ Disponible depuis la version 2.4.2 du serveur HTTP Apache.
</td></tr>
</table>
- <p>A sample balancer setup:</p>
+ <p>Exemple de configuration d'un répartiteur de charge</p>
<pre class="prettyprint lang-config">ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
-ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
+ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
<Proxy balancer://mycluster>
BalancerMember ajp://1.2.3.4:8009
BalancerMember ajp://1.2.3.5:8009 loadfactor=20
- # Less powerful server, don't send as many requests there,
+ # Le serveur suivant est moins puissant ; on lui envoie moins de requêtes,
BalancerMember ajp://1.2.3.6:8009 loadfactor=5
</Proxy></pre>
- <p>Setting up a hot-standby that will only be used if no other
- members are available:</p>
- <pre class="prettyprint lang-config">ProxyPass "/" "balancer://hotcluster/"
+ <p>Configuration d'un serveur cible de réserve qui ne sera utilisé que si
+ aucun autre serveur cible n'est disponible :</p>
+ <pre class="prettyprint lang-config">ProxyPass "/" "balancer://hotcluster/ "
<Proxy balancer://hotcluster>
BalancerMember ajp://1.2.3.4:8009 loadfactor=1
BalancerMember ajp://1.2.3.5:8009 loadfactor=2.25
- # The server below is on hot standby
+ # Le serveur suivant est en mode hot standby
BalancerMember ajp://1.2.3.6:8009 status=+H
ProxySet lbmethod=bytraffic
</Proxy></pre>
- <p><strong>Additional ProxyPass Keywords</strong></p>
-
- <p>Normally, mod_proxy will canonicalise ProxyPassed URLs.
- But this may be incompatible with some backends, particularly those
- that make use of <var>PATH_INFO</var>. The optional <var>nocanon</var>
- keyword suppresses this and passes the URL path "raw" to the
- backend. Note that this keyword may affect the security of your backend,
- as it removes the normal limited protection against URL-based attacks
- provided by the proxy.</p>
-
- <p>Normally, mod_proxy will include the query string when
- generating the <var>SCRIPT_FILENAME</var> environment variable.
- The optional <var>noquery</var> keyword (available in
- httpd 2.4.1 and later) prevents this.</p>
-
- <p>The optional <var>interpolate</var> keyword, in combination with
- <code class="directive">ProxyPassInterpolateEnv</code>, causes the ProxyPass
- to interpolate environment variables, using the syntax
- <var>${VARNAME}</var>. Note that many of the standard CGI-derived
- environment variables will not exist when this interpolation happens,
- so you may still have to resort to <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
- for complex rules. Also note that interpolation is not supported
- within the scheme portion of a URL. Dynamic determination of the
- scheme can be accomplished with <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> as in the
- following example.</p>
+ <p><strong>Mot-clés supplémentaires de ProxyPass</strong></p>
+
+ <p>Normalement, mod_proxy va mettre sous leur forme canonique les
+ URLs traitées par ProxyPass. Mais ceci peut être incompatible avec
+ certains serveurs d'arrière-plan, et en particulier avec ceux qui
+ utilisent <var>PATH_INFO</var>. Le mot-clé optionnel
+ <var>nocanon</var> modifie ce comportement et permet de transmettre
+ le chemin d'URL sous sa forme brute au serveur d'arrière-plan. Notez
+ que ce mot-clé peut affecter la sécurité de votre serveur d'arrière-plan,
+ car la protection limitée contre les attaques à base d'URL que
+ fournit le mandataire est alors supprimée.</p>
+
+ <p>Par défaut, mod_proxy inclut la chaîne de paramètres lors de la
+ génération de la variable d'environnement
+ <var>SCRIPT_FILENAME</var>. Le mot-clé optionnel <var>noquery</var>
+ (disponible à partir de la version 2.4.1) permet d'exclure cette
+ chaîne.</p>
+
+
+
+
+
+ <p>Le mot-clé optionnel <var>interpolate</var>, en combinaison avec la directive
+ <code class="directive">ProxyPassInterpolateEnv</code>, permet à ProxyPass
+ d'interpoler les variables d'environnement à l'aide de la syntaxe
+ <var>${VARNAME}</var>. Notez que de nombreuses variables
+ d'environnement standard dérivées de CGI n'existeront pas lorsque
+ l'interpolation se produit ; vous devrez alors encore avoir avoir
+ recours à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour des règles
+ complexes. Notez aussi que l'interpolation n'est pas supportée dans
+ la partie protocole d'une URL. La détermination dynamique du
+ protocole peut être effectuée à l'aide de
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> comme dans l'exemple suivant :</p>
<pre class="prettyprint lang-config">RewriteEngine On
ProxyPassReverse "/mirror/foo/" "https://backend.example.com/"</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="proxypassinherit" id="proxypassinherit">Directive</a> <a name="ProxyPassInherit" id="ProxyPassInherit">ProxyPassInherit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inherit ProxyPass directives defined from the main server</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Héritage des directives ProxyPass définies au niveau du
+serveur principal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInherit On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyPassInherit 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>ProxyPassInherit is only available in Apache HTTP Server 2.4.5 and later.
- </td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur
+HTTP Apache.</td></tr>
</table>
- <p>This directive will cause the current server/vhost to "inherit"
- <code class="directive"><a href="#proxypass">ProxyPass</a></code>
- directives defined in the main server. This can cause issues and
- inconsistent behavior if using the Balancer Manager for dynamic changes
- and so should be disabled if using that feature.</p>
- <p>The setting in the global server defines the default for all vhosts.</p>
- <p>Disabling ProxyPassInherit also disables <code class="directive"><a href="#balancerinherit">BalancerInherit</a></code>.</p>
+ <p>Cette directive permet à un serveur virtuel d'hériter des
+ directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> définies
+ au niveau du serveur principal. Si vous utilisez la fonctionnalité de
+ modifications dynamiques du Balancer Manager, cette directive peut
+ causer des problèmes et des comportements inattendus et doit donc
+ être désactivée.</p>
+ <p>Les valeurs définies au niveau du serveur principal
+ constituent les valeurs par défaut pour tous les serveurs virtuels.</p>
+ <p>La désactivation de ProxyPassInherit désactive aussi la
+ directive <code class="directive"><a href="#balancerinherit">BalancerInherit</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="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a> <a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable Environment Variable interpolation in Reverse Proxy configurations</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'interpolation des variables d'environnement dans
+les configurations de mandataires inverses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyPassInterpolateEnv 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive, together with the <var>interpolate</var> argument to
- <code class="directive">ProxyPass</code>, <code class="directive">ProxyPassReverse</code>,
- <code class="directive">ProxyPassReverseCookieDomain</code>, and
- <code class="directive">ProxyPassReverseCookiePath</code>,
- enables reverse proxies to be dynamically
- configured using environment variables which may be set by
- another module such as <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.
- It affects the <code class="directive">ProxyPass</code>,
+ <p>Cette directive, ainsi que l'argument <var>interpolate</var> des
+ directives <code class="directive">ProxyPass</code>,
<code class="directive">ProxyPassReverse</code>,
- <code class="directive">ProxyPassReverseCookieDomain</code>, and
- <code class="directive">ProxyPassReverseCookiePath</code> directives
- and causes them to substitute the value of an environment
- variable <code>varname</code> for the string <code>${varname}</code>
- in configuration directives if the <var>interpolate</var> option is set.</p>
- <p>Keep this turned off (for server performance) unless you need it!</p>
+ <code class="directive">ProxyPassReverseCookieDomain</code> et
+ <code class="directive">ProxyPassReverseCookiePath</code>, permet de
+ configurer dynamiquement un mandataire inverse à l'aide de
+ variables d'environnement, ces dernières pouvant être définies par un
+ autre module comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Elle affecte les
+ directives <code class="directive">ProxyPass</code>,
+ <code class="directive">ProxyPassReverse</code>,
+ <code class="directive">ProxyPassReverseCookieDomain</code>, et
+ <code class="directive">ProxyPassReverseCookiePath</code>, en leur indiquant
+ de remplacer la chaîne <code>${nom_var}</code> dans les directives
+ de configuration par la valeur de la variable d'environnement
+ <code>nom_var</code> si l'option <var>interpolate</var> est
+ spécifiée.</p>
+ <p>Conservez cette directive à off (pour les performances du
+ serveur), sauf si vous en avez réellement besoin.</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="proxypassmatch" id="proxypassmatch">Directive</a> <a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps remote servers into the local server URL-space using regular expressions</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var> [<var>key=value</var>
- <var>[key=value</var> ...]]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre des serveurs distants dans l'espace d'URL
+du serveur local en utilisant des expressions rationnelles</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var>
+[<var>clé=valeur</var>
+ <var>[clé=valeur</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive is equivalent to <code class="directive"><a href="#proxypass">ProxyPass</a></code>
- but makes use of regular expressions instead of simple prefix matching. The
- supplied regular expression is matched against the <var>url</var>, and if it
- matches, the server will substitute any parenthesized matches into the given
- string and use it as a new <var>url</var>.</p>
+ <p>Cette directive est identique à la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des
+ expressions rationnelles, au lieu d'une simple comparaison de
+ préfixes. L'expression rationnelle spécifiée est comparée à
+ l'<var>url</var>, et si elle correspond, le serveur va substituer
+ toute correspondance entre parenthèses dans la chaîne donnée et
+ l'utiliser comme nouvelle <var>url</var>.</p>
+
+ <div class="note"><strong>Note : </strong>Cette directive ne peut pas être
+ utilisée dans un contexte de niveau répertoire.</div>
- <div class="note"><strong>Note: </strong>This directive cannot be used within a
- <code><Directory></code> context.</div>
+ <p>Supposons que le serveur local a pour adresse
+ <code>http://example.com/</code> ; alors</p>
- <p>Suppose the local server has address <code>http://example.com/</code>;
- then</p>
+ <pre class="prettyprint lang-config">ProxyPassMatch "^(/.*\.gif)$" "http://backend.example.com/$1"</pre>
- <pre class="prettyprint lang-config">ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com/$1"</pre>
+ <p>va provoquer la conversion interne de la requête locale
+ <code>http://example.com/foo/bar.gif</code> en une requête mandatée
+ pour <code>http://backend.example.com/foo/bar.gif</code>.</p>
- <p>will cause a local request for
- <code>http://example.com/foo/bar.gif</code> to be internally converted
- into a proxy request to <code>http://backend.example.com/foo/bar.gif</code>.</p>
<div class="note"><h3>Note</h3>
- <p>The URL argument must be parsable as a URL <em>before</em> regexp
- substitutions (as well as after). This limits the matches you can use.
- For instance, if we had used</p>
- <pre class="prettyprint lang-config">ProxyPassMatch "^(/.*\.gif)$" "http://backend.example.com:8000$1"</pre>
-
- <p>in our previous example, it would fail with a syntax error
- at server startup. This is a bug (PR 46665 in the ASF bugzilla),
- and the workaround is to reformulate the match:</p>
+ <p>L'argument URL doit pouvoir être interprété en tant qu'URL
+ <em>avant</em> les substitutions d'expressions rationnelles (et
+ doit aussi l'être après). Ceci limite les correspondances que vous
+ pouvez utiliser. Par exemple, si l'on avait utilisé</p>
+ <pre class="prettyprint lang-config"> ProxyPassMatch "^(/.*\.gif)$"
+ "http://backend.example.com:8000$1"</pre>
+
+ <p>dans l'exemple précédent, nous aurions provoqué une erreur de
+ syntaxe au démarrage du serveur. C'est une bogue (PR 46665 dans
+ ASF bugzilla), et il est possible de la contourner en reformulant
+ la correspondance :</p>
<pre class="prettyprint lang-config">ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com:8000/$1"</pre>
</div>
- <p>The <code>!</code> directive is useful in situations where you don't want
- to reverse-proxy a subdirectory.</p>
- <p>When used inside a <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> section, the first argument is omitted and the
- regexp is obtained from the <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>.</p>
+ <p>Le drapeau <code>!</code> vous permet de ne pas mandater un
+ sous-répertoire donné.</p>
+
+ <p>Dans une section <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>, le premier argument est
+ omis et l'expression rationnelle est obtenue à partir de la directive
+ <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>.</p>
- <p>If you require a more flexible reverse-proxy configuration, see the
- <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directive with the
- <code>[P]</code> flag.</p>
+ <p>Si vous avez besoin d'une configuration du mandataire inverse
+ plus flexible, voyez la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> avec le drapeau
+ <code>[P]</code>.</p>
<div class="note">
- <h3>Default Substitution</h3>
- <p>When the URL parameter doesn't use any backreferences into the regular
- expression, the original URL will be appended to the URL parameter.
- </p>
- </div>
+ <h3>Substitution par défaut</h3>
+ <p>Lorsque le paramètre URL n'utilise pas de références arrières
+ dans l'expression rationnelle, l'URL originale sera ajoutée au
+ paramètre URL.
+ </p>
+ </div>
<div class="warning">
- <h3>Security Warning</h3>
- <p>Take care when constructing the target URL of the rule, considering
- the security impact from allowing the client influence over the set of
- URLs to which your server will act as a proxy. Ensure that the scheme
- and hostname part of the URL is either fixed or does not allow the
- client undue influence.</p>
+ <h3>Avertissement à propos de la sécurité</h3>
+ <p>Lors de la construction de l'URL cible de la règle, il convient
+ de prendre en compte l'impact en matière de sécurité qu'aura le
+ fait de permettre au client d'influencer le jeu d'URLs pour
+ lesquelles votre serveur agira en tant que mandataire.
+ Assurez-vous que la partie protocole://nom-serveur de l'URL soit
+ fixe, ou ne permette pas au client de l'influencer induement.</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="proxypassreverse" id="proxypassreverse">Directive</a> <a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the URL in HTTP response headers sent from a reverse
-proxied server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>path</var>] <var>url</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste l'URL dans les en-têtes de la réponse HTTP envoyée
+par un serveur mandaté en inverse</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>chemin</var>] <var>url</var>
[<var>interpolate</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive lets Apache httpd adjust the URL in the <code>Location</code>,
- <code>Content-Location</code> and <code>URI</code> headers on HTTP
- redirect responses. This is essential when Apache httpd is used as a
- reverse proxy (or gateway) to avoid bypassing the reverse proxy
- because of HTTP redirects on the backend servers which stay behind
- the reverse proxy.</p>
-
- <p>Only the HTTP response headers specifically mentioned above
- will be rewritten. Apache httpd will not rewrite other response
- headers, nor will it by default rewrite URL references inside HTML pages.
- This means that if the proxied content contains absolute URL
- references, they will bypass the proxy. To rewrite HTML content to
- match the proxy, you must load and enable <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code>.
+ <p>Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
+ dans les en-têtes <code>Location</code>,
+ <code>Content-Location</code> et <code>URI</code> des réponses de
+ redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilisé en
+ tant que mandataire inverse (ou passerelle), afin d'éviter de
+ court-circuiter le mandataire inverse suite aux redirections HTTP
+ sur le serveur d'arrière-plan qui restent derrière le mandataire
+ inverse.</p>
+
+ <p>Seuls les en-têtes de réponse HTTP spécialement mentionnés
+ ci-dessus seront réécrits. Apache httpd ne réécrira ni les autres en-têtes
+ de réponse, ni par défaut les références d'URLs dans les pages HTML. Cela
+ signifie que dans le cas où un contenu mandaté contient des
+ références à des URLs absolues, elles court-circuiteront le
+ mandataire. Pour réécrire un contenu HTML afin qu'il corresponde au
+ mandataire, vous devez charger et activer le module
+ <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code>.
</p>
- <p><var>path</var> is the name of a local virtual path; <var>url</var> is a
- partial URL for the remote server. These parameters are used the same way as
- for the <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive.</p>
+ <p><var>chemin</var> est le nom d'un chemin virtuel local.
+ <var>url</var> est une URL partielle pour le serveur distant. Ces
+ paramètres s'utilisent de la même façon qu'avec la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
- <p>For example, suppose the local server has address
- <code>http://example.com/</code>; then</p>
+ <p>Supposons par exemple que le serveur local a pour adresse
+ <code>http://example.com/</code> ; alors</p>
<pre class="prettyprint lang-config">ProxyPass "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre>
- <p>will not only cause a local request for the
- <code>http://example.com/mirror/foo/bar</code> to be internally converted
- into a proxy request to <code>http://backend.example.com/bar</code>
- (the functionality which <code>ProxyPass</code> provides here).
- It also takes care of redirects which the server <code>backend.example.com</code> sends
- when redirecting <code>http://backend.example.com/bar</code> to
- <code>http://backend.example.com/quux</code> . Apache httpd adjusts this to
- <code>http://example.com/mirror/foo/quux</code> before forwarding the HTTP
- redirect response to the client. Note that the hostname used for
- constructing the URL is chosen in respect to the setting of the <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> directive.</p>
-
- <p>Note that this <code class="directive">ProxyPassReverse</code> directive can
- also be used in conjunction with the proxy feature
- (<code>RewriteRule ... [P]</code>) from <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
- because it doesn't depend on a corresponding <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive.</p>
-
- <p>The optional <var>interpolate</var> keyword, used together with
- <code class="directive">ProxyPassInterpolateEnv</code>, enables interpolation
- of environment variables specified using the format <var>${VARNAME}</var>.
- Note that interpolation is not supported within the scheme portion of a
- URL.</p>
-
- <p>When used inside a <code class="directive"><a href="../mod/core.html#location"><Location></a></code> section, the first argument is omitted and the local
- directory is obtained from the <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. The same occurs inside a <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> section, but will probably not work as
- intended, as ProxyPassReverse will interpret the regexp literally as a
- path; if needed in this situation, specify the ProxyPassReverse outside
- the section or in a separate <code class="directive"><a href="../mod/core.html#location"><Location></a></code> section.</p>
-
- <p>This directive is not supported in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> or <code class="directive"><a href="../mod/core.html#files"><Files></a></code> sections.</p>
+ <p>ne va pas seulement provoquer la conversion interne d'une requête
+ locale pour <code>http://example.com/miroir/foo/bar</code> en une
+ requête mandatée pour <code>http://backend.example.com/bar</code>
+ (la fonctionnalité fournie par <code>ProxyPass</code>). Il va
+ aussi s'occuper des redirections que le serveur
+ <code>backend.example.com</code> envoie lorsque
+ <code>http://backend.example.com/bar</code> est redirigé par
+ celui-ci vers <code>http://backend.example.com/quux</code>, Apache
+ httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
+ avant de faire suivre la redirection HTTP au client. Notez que le
+ nom d'hôte utilisé pour construire l'URL est choisi en respectant la
+ définition de la directive <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</p>
+
+ <p>Notez que la directive <code class="directive">ProxyPassReverse</code>
+ peut aussi être utilisée en conjonction avec la
+ fonctionnalité de mandataire
+ (<code>RewriteRule ... [P]</code>) du module
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, car elle ne dépend pas d'une directive
+ <code class="directive"><a href="#proxypass">ProxyPass</a></code>
+ correspondante.</p>
+
+ <p>Le mot-clé optionnel <var>interpolate</var>,
+ utilisé en combinaison avec la directive
+ <code class="directive">ProxyPassInterpolateEnv</code>, permet
+ l'interpolation des variables d'environnement spécifiées en
+ utilisant le format <var>${VARNAME}</var>. Notez que l'interpolation
+ n'est pas supportée dans la partie protocole d'une URL.
+ </p>
+
+ <p>Lorsque cette directive est utilisée dans une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, le premier
+ argument est omis et le répertoire local est obtenu à partir de
+ l'argument de la directive <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Il en est de même à l'intérieur
+ d'une section <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>, mais le résultat ne sera
+ probablement pas celui attendu car ProxyPassReverse va interpréter
+ l'expression rationnelle littéralement comme un chemin ; si besoin
+ est dans ce cas, définissez la directive ProxyPassReverse en dehors
+ de la section, ou dans une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> séparée.</p>
+
+ <p>Cette directive ne peut pas être placée dans une section
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou
+ <code class="directive"><a href="../mod/core.html#files"><Files></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="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a> <a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the Domain string in Set-Cookie headers from a reverse-
-proxied server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>internal-domain</var>
-<var>public-domain</var> [<var>interpolate</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la chaîne correspondant au domaine dans les en-têtes
+Set-Cookie en provenance d'un serveur mandaté</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>domaine-interne</var>
+<var>domaine-public</var> [<var>interpolate</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
-<p>Usage is basically similar to
-<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, but instead of
-rewriting headers that are a URL, this rewrites the <code>domain</code>
-string in <code>Set-Cookie</code> headers.</p>
+<p>L'utilisation de cette directive est similaire à celle de la
+directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>,
+mais au lieu de réécrire des en-têtes qui contiennent des URLs, elle
+réécrit la chaîne correspondant au domaine dans les en-têtes
+<code>Set-Cookie</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="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a> <a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adjusts the Path string in Set-Cookie headers from a reverse-
-proxied server</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>internal-path</var>
-<var>public-path</var> [<var>interpolate</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la chaîne correspondant au chemin dans les en-têtes
+Set-Cookie en provenance d'un serveur mandaté</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>chemin-interne</var>
+<var>chemin-public</var> [<var>interpolate</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
<p>
-Useful in conjunction with
-<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>
-in situations where backend URL paths are mapped to public paths on the
-reverse proxy. This directive rewrites the <code>path</code> string in
-<code>Set-Cookie</code> headers. If the beginning of the cookie path matches
-<var>internal-path</var>, the cookie path will be replaced with
-<var>public-path</var>.
+Cette directive s'avère utile en conjonction avec la directive
+<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> dans les
+situations où les chemins d'URL d'arrière-plan correspondent à des
+chemins publics sur le mandataire inverse. Cette directive permet de
+réécrire la chaîne <code>path</code> dans les en-têtes
+<code>Set-Cookie</code>. Si le début du chemin du cookie correspond à
+<var>chemin-interne</var>, le chemin du cookie sera remplacé par
+<var>chemin-public</var>.
</p><p>
-In the example given with
-<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, the directive:
+Dans l'exemple fourni avec la directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, la directive :
</p>
<pre class="prettyprint lang-config">ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre>
<p>
-will rewrite a cookie with backend path <code>/</code> (or
-<code>/example</code> or, in fact, anything) to <code>/mirror/foo/</code>.
+va réécrire un cookie possédant un chemin d'arrière-plan <code>/</code>
+(ou <code>/example</code> ou en fait tout chemin)
+en <code>/mirror/foo/</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="proxypreservehost" id="proxypreservehost">Directive</a> <a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use incoming Host HTTP request header for proxy
-request</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise l'en-tête de requête entrante Host pour la requête
+du mandataire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyPreserveHost 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Usable in directory
-context in 2.3.3 and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Utilisable
+dans un contexte de répertoire depuis la version 2.3.3.</td></tr>
</table>
- <p>When enabled, this option will pass the Host: line from the incoming
- request to the proxied host, instead of the hostname specified in the
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> line.</p>
+ <p>Lorsqu'elle est activée, cette directive va transmettre l'en-tête
+ Host: de la requête entrante vers le serveur mandaté, au lieu du nom
+ d'hôte spécifié par la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
- <p>This option should normally be turned <code>Off</code>. It is mostly
- useful in special configurations like proxied mass name-based virtual
- hosting, where the original Host header needs to be evaluated by the
- backend server.</p>
+ <p>Cette directive est habituellement définie à <code>Off</code>.
+ Elle est principalement utile dans les configurations particulières
+ comme l'hébergement virtuel mandaté en masse à base de nom, où
+ l'en-tête Host d'origine doit être évalué par le serveur
+ d'arrière-plan.</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="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a> <a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Network buffer size for proxied HTTP and FTP
-connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon réseau pour les connexions mandatées HTTP
+et FTP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyReceiveBufferSize 0</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyReceiveBufferSize</code> directive specifies an
- explicit (TCP/IP) network buffer size for proxied HTTP and FTP connections,
- for increased throughput. It has to be greater than <code>512</code> or set
- to <code>0</code> to indicate that the system's default buffer size should
- be used.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ProxyReceiveBufferSize 2048</pre>
+ <p>La directive <code class="directive">ProxyReceiveBufferSize</code> permet
+ de spécifier une taille de tampon réseau explicite (TCP/IP) pour les
+ connexions mandatées HTTP et FTP, afin d'améliorer le débit de
+ données. Elle doit être supérieure à <code>512</code> ou définie à
+ <code>0</code> pour indiquer que la taille de tampon par défaut du
+ système doit être utilisée.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyReceiveBufferSize 2048</pre>
</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="proxyremote" id="proxyremote">Directive</a> <a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remote proxy used to handle certain requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>match</var> <var>remote-server</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mandataire distant à utiliser pour traiter certaines
+requêtes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>comparaison</var> <var>serveur-distant</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This defines remote proxies to this proxy. <var>match</var> is either the
- name of a URL-scheme that the remote server supports, or a partial URL
- for which the remote server should be used, or <code>*</code> to indicate
- the server should be contacted for all requests. <var>remote-server</var> is
- a partial URL for the remote server. Syntax:</p>
+ <p>Cette directive permet de définir des mandataires distants pour
+ ce mandataire. <var>comparaison</var> est soit le nom d'un protocole
+ que supporte le serveur distant, soit une URL partielle pour
+ laquelle le serveur distant devra être utilisé, soit <code>*</code>
+ pour indiquer que le serveur distant doit être utilisé pour toutes
+ les requêtes. <var>serveur-distant</var> est une URL partielle
+ correspondant au serveur distant. Syntaxe : </p>
<div class="example"><p><code>
- <dfn>remote-server</dfn> =
- <var>scheme</var>://<var>hostname</var>[:<var>port</var>]
+ <dfn>serveur-distant</dfn> =
+ <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
</code></p></div>
- <p><var>scheme</var> is effectively the protocol that should be used to
- communicate with the remote server; only <code>http</code> and <code>https</code>
- are supported by this module. When using <code>https</code>, the requests
- are forwarded through the remote proxy using the HTTP CONNECT method.</p>
+ <p><var>protocole</var> est effectivement le protocole à utiliser
+ pour communiquer avec le serveur distant ; ce module ne supporte que
+ <code>http</code> et <code>https</code>. Lorsqu'on utilise
+ <code>https</code>, les requêtes sont redirigées par le mandataire
+ distant en utilisant la méthode HTTP CONNECT.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">ProxyRemote http://goodguys.example.com/ http://mirrorguys.example.com:8000
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">ProxyRemote http://goodguys.example.com/ http://mirrorguys.example.com:8000
ProxyRemote * http://cleverproxy.localdomain
ProxyRemote ftp http://ftpproxy.mydomain:8080</pre>
</div>
- <p>In the last example, the proxy will forward FTP requests, encapsulated
- as yet another HTTP proxy request, to another proxy which can handle
- them.</p>
+ <p>Dans la dernière ligne de l'exemple, le mandataire va faire
+ suivre les requêtes FTP, encapsulées dans une autre requête mandatée
+ HTTP, vers un autre mandataire capable de les traiter.</p>
- <p>This option also supports reverse proxy configuration; a backend
- webserver can be embedded within a virtualhost URL space even if that
- server is hidden by another forward proxy.</p>
+ <p>Cette directive supporte aussi les configurations de mandataire
+ inverse ; un serveur web d'arrière-plan peut être intégré dans
+ l'espace d'URL d'un serveur virtuel, même si ce serveur est caché
+ par un autre mandataire direct.</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="proxyremotematch" id="proxyremotematch">Directive</a> <a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remote proxy used to handle requests matched by regular
-expressions</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>remote-server</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le mandataire distant à utiliser pour traiter les requêtes
+correspondant à une expression rationnelle</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>The <code class="directive">ProxyRemoteMatch</code> is identical to the
- <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> directive, except that
- the first argument is a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>
- match against the requested URL.</p>
+ <p>La directive <code class="directive">ProxyRemoteMatch</code> est
+ identique à la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, à l'exception du
+ premier argument qui est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression
+ rationnelle</a> à mettre en correspondance avec l'URL 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="proxyrequests" id="proxyrequests">Directive</a> <a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables forward (standard) proxy requests</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalité (standard) de mandataire
+direct</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyRequests 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This allows or prevents Apache httpd from functioning as a forward proxy
- server. (Setting ProxyRequests to <code>Off</code> does not disable use of
- the <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive.)</p>
+ <p>Cette directive permet d'activer/désactiver la fonctionnalité de
+ serveur mandataire direct d'Apache httpd. Définir ProxyRequests à
+ <code>Off</code> n'interdit pas l'utilisation de la directive
+ <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
- <p>In a typical reverse proxy or gateway configuration, this
- option should be set to
+ <p>Pour une configuration typique de mandataire inverse ou
+ passerelle, cette directive doit être définie à
<code>Off</code>.</p>
- <p>In order to get the functionality of proxying HTTP or FTP sites, you
- need also <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> or <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>
- (or both) present in the server.</p>
+ <p>Afin d'activer la fonctionnalité de mandataire pour des sites
+ HTTP et/ou FTP, les modules <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> et/ou
+ <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> doivent également être chargés dans le
+ serveur.</p>
- <p>In order to get the functionality of (forward) proxying HTTPS sites, you
- need <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> enabled in the server.</p>
+ <p>Pour activer la fonctionnalité de mandataire sur les sites chiffrés en HTTPS, le module
+ <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> doit également être chargé dans le serveur.</p>
- <div class="warning"><h3>Warning</h3>
- <p>Do not enable proxying with <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> until you have <a href="#access">secured your server</a>. Open proxy servers are dangerous
- both to your network and to the Internet at large.</p>
+ <div class="warning"><h3>Avertissement</h3>
+ <p>N'activez pas la fonctionnalité de mandataire avec la directive
+ <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
+ d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
+ mandataires ouverts sont dangereux non seulement pour votre
+ réseau, mais aussi pour l'Internet au sens large.</p>
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="#forwardreverse">Forward and Reverse Proxies/Gateways</a></li>
+<li><a href="#forwardreverse">Mandataires/Passerelles directs et
+inverses</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="proxyset" id="proxyset">Directive</a> <a name="ProxySet" id="ProxySet">ProxySet</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set various Proxy balancer or member parameters</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySet <var>url</var> <var>key=value [key=value ...]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit différents paramètres relatifs à la répartition de
+charge des mandataires et aux membres des groupes de répartition de
+charge</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySet <var>url</var> <var>clé=valeur [clé=valeur ...]</var></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive is used as an alternate method of setting any of the
- parameters available to Proxy balancers and workers normally done via the
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive. If used
- within a <code><Proxy <var>balancer url|worker url</var>></code>
- container directive, the <var>url</var> argument is not required. As a side
- effect the respective balancer or worker gets created. This can be useful
- when doing reverse proxying via a
- <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> instead of a
- <code class="directive"><a href="#proxypass">ProxyPass</a></code> directive.</p>
+ <p>Cette directive propose une méthode alternative pour définir tout
+ paramètre relatif aux répartiteurs de charge et serveurs cibles de
+ mandataires normalement définis via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Si elle se trouve dans un
+ conteneur <code><Proxy <var>url de répartiteur|url de
+ serveur cible</var>></code>, l'argument <var>url</var> n'est pas
+ nécessaire. Comme effet de bord, le répartiteur ou serveur cible respectif
+ est créé. Ceci peut s'avérer utile pour la mise en oeuvre d'un
+ mandataire inverse via une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> au lieu de <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
<div class="example"><pre class="prettyprint lang-config"><Proxy balancer://hotcluster>
BalancerMember http://www2.example.com:8080 loadfactor=1
<pre class="prettyprint lang-config">ProxySet ajp://backend:7001 timeout=15</pre>
- <div class="warning"><h3>Warning</h3>
- <p>Keep in mind that the same parameter key can have a different meaning
- depending whether it is applied to a balancer or a worker, as shown by
- the two examples above regarding timeout.</p>
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Gardez à l'esprit qu'une même clé de paramètre peut avoir
+ différentes significations selon qu'elle s'applique à un
+ répartiteur ou à un serveur cible, et ceci est illustré par les deux
+ exemples précédents où il est question d'un timeout.</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="proxysourceaddress" id="proxysourceaddress">Directive</a> <a name="ProxySourceAddress" id="ProxySourceAddress">ProxySourceAddress</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set local IP address for outgoing proxy connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySourceAddress <var>address</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'adresse IP locale pour les connexions mandatées
+sortantes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySourceAddress <var>adresse</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.3.9 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9</td></tr>
</table>
- <p>This directive allows to set a specific local address to bind to when connecting
- to a backend server.</p>
+ <p>Cette directive permet de définir une adresse IP locale
+ spécifique à laquelle faire référence lors d'une connexion à un
+ serveur d'arrière-plan.</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="proxystatus" id="proxystatus">Directive</a> <a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Show Proxy LoadBalancer status in mod_status</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Affiche l'état du répartiteur de charge du mandataire dans
+mod_status</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyStatus 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive determines whether or not proxy
- loadbalancer status data is displayed via the <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>
- server-status page.</p>
+ <p>Cette directive permet de spécifier si les données d'état du
+ répartiteur de charge du mandataire doivent être affichées via la
+ page d'état du serveur du module <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</p>
<div class="note"><h3>Note</h3>
- <p><strong>Full</strong> is synonymous with <strong>On</strong></p>
+ <p>L'argument <strong>Full</strong> produit le même effet que
+ l'argument <strong>On</strong>.</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="proxytimeout" id="proxytimeout">Directive</a> <a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Network timeout for proxied requests</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Délai d'attente réseau pour les requêtes
+mandatées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyTimeout <var>time-interval</var>[s]</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Val
ue of <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Val
eur de la directive <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive allows a user to specifiy a timeout on proxy requests.
- This is useful when you have a slow/buggy appserver which hangs, and you
- would rather just return a timeout and fail gracefully instead of waiting
- however long it takes the server to return.</p>
+ <p>Cette directive permet à l'utilisateur de spécifier un délai pour
+ les requêtes mandatées. Ceci s'avère utile dans le cas d'un serveur
+ d'applications lent et bogué qui a tendance à se bloquer, et si vous
+ préférez simplement renvoyer une erreur timeout et abandonner la
+ connexion en douceur plutôt que d'attendre jusqu'à ce que le serveur
+ veuille bien répondre.</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="proxyvia" id="proxyvia">Directive</a> <a name="ProxyVia" id="ProxyVia">ProxyVia</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information provided in the <code>Via</code> HTTP response
-header for proxied requests</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information fournie dans l'en-tête de réponse HTTP
+<code>Via</code> pour les requêtes mandatées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyVia 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
- <p>This directive controls the use of the <code>Via:</code> HTTP
- header by the proxy. Its intended use is to control the flow of
- proxy requests along a chain of proxy servers. See <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1), section
- 14.45 for an explanation of <code>Via:</code> header lines.</p>
+ <p>Cette directive permet de contrôler l'utilisation de l'en-tête
+ HTTP <code>Via:</code> par le mandataire. Le but recherché est de
+ contrôler le flux des requêtes mandatées tout au long d'une chaîne
+ de serveurs mandataires. Voir <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1),
+ section 14.45 pour une description des lignes d'en-tête
+ <code>Via:</code>.</p>
<ul>
- <li>If set to <code>Off</code>, which is the default, no special processing
- is performed. If a request or reply contains a <code>Via:</code> header,
- it is passed through unchanged.</li>
-
- <li>If set to <code>On</code>, each request and reply will get a
- <code>Via:</code> header line added for the current host.</li>
-
- <li>If set to <code>Full</code>, each generated <code>Via:</code> header
- line will additionally have the Apache httpd server version shown as a
- <code>Via:</code> comment field.</li>
-
- <li>If set to <code>Block</code>, every proxy request will have all its
- <code>Via:</code> header lines removed. No new <code>Via:</code> header will
- be generated.</li>
+ <li>Si elle est définie à <code>Off</code>, valeur par défaut, cette
+ directive n'effectue aucun traitement particulier. Si une requête ou
+ une réponse contient un en-tête <code>Via:</code>, il est transmis
+ sans modification.</li>
+
+ <li>Si elle est définie à <code>On</code>, chaque requête ou réponse
+ se verra ajouter une ligne d'en-tête <code>Via:</code> pour le
+ serveur courant.</li>
+
+ <li>Si elle est définie à <code>Full</code>, chaque ligne d'en-tête
+ <code>Via:</code> se verra ajouter la version du serveur Apache
+ httpd sous la forme d'un champ de commentaire <code>Via:</code>.</li>
+
+ <li>Si elle est définie à <code>Block</code>, chaque requête
+ mandatée verra ses lignes d'en-tête <code>Via:</code> supprimées.
+ Aucun nouvel en-tête <code>Via:</code> ne sera généré.</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="allowconnect" id="allowconnect">Directive</a> <a name="AllowCONNECT" id="AllowCONNECT">AllowCONNECT</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ports that are allowed to <code>CONNECT</code> through the
-proxy</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ports autorisés à se <code>CONNECT</code>er à travers le
+mandataire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowCONNECT <var>port</var>[-<var>port</var>]
[<var>port</var>[-<var>port</var>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowCONNECT 443 563</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_connect</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Moved from <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> in Apache 2.3.5.
-Port ranges available since Apache 2.3.7.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Déplacé depuis <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> à partir
+d'Apache 2.3.5. Tranches de ports disponibles depuis Apache 2.3.7.</td></tr>
</table>
- <p>The <code class="directive">AllowCONNECT</code> directive specifies a list
- of port numbers or ranges to which the proxy <code>CONNECT</code> method
- may connect. Today's browsers use this method when a <code>https</code>
- connection is requested and proxy tunneling over HTTP is in effect.</p>
+ <p>La directive <code class="directive">AllowCONNECT</code> permet de
+ spécifier une liste de numéros ou de tranches de ports auxquels la
+ méthode de mandataire <code>CONNECT</code> pourra se connecter. Les
+ navigateurs d'aujourd'hui utilisent cette méthode dans le cas où une
+ connexion <code>https</code> est requise et où le tunneling
+ mandataire sur HTTP est en service.</p>
- <p>By default, only the default https port (<code>443</code>) and the
- default snews port (<code>563</code>) are enabled. Use the
- <code class="directive">AllowCONNECT</code> directive to override this default and
- allow connections to the listed ports only.</p>
+ <p>Par défaut, seuls les ports par défauts https (<code>443</code>)
+ et snews (<code>563</code>) sont pris en compte. Vous pouvez
+ utiliser la directive <code class="directive">AllowCONNECT</code> pour
+ outrepasser ces valeurs par défaut et n'autoriser les connexions que
+ vers les ports spécifiés.</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="proxyexpressdbmfile" id="proxyexpressdbmfile">Directive</a> <a name="ProxyExpressDBMFile" id="ProxyExpressDBMFile">ProxyExpressDBMFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pathname to DBM file.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressDBMFile <pathname></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier DBM.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressDBMFile <chemin></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</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#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.13 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyExpressDBMFile</code> directive
- points to the location of the Express map DBM file. This
- file serves to map the incoming server name, obtained from
- the Host: header, to a backend URL.</p>
+ <p>La directive <code class="directive">ProxyExpressDBMFile</code> permet de
+ définir le chemin du fichier DBM de correspondance Express. Ce fichier
+ permet de faire correspondre le nom de serveur extrait de l'en-tête
+ Host: de la requête entrante avec une URL d'arrière-plan.</p>
<div class="note"><h3>Note</h3>
- <p>The file is constructed from a plain text file format using
- the <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>
- utility.</p>
+ <p>Ce fichier est élaboré à partir d'un fichier texte à l'aide de
+ l'utilitaire <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
- <div class="example"><h3>
ProxyExpress map file</h3><p><code>
+ <div class="example"><h3>
Fichier de correspondances ProxyExpress</h3><p><code>
##<br />
##express-map.txt:<br />
##<br />
www3.example.com http://192.168.212.10<br />
</code></p></div>
- <div class="example"><h3>Cr
eate DBM file</h3><p><code>
+ <div class="example"><h3>Cr
éation du fichier DBM</h3><p><code>
httxt2dbm -i express-map.txt -o emap<br />
</code></p></div>
<div class="example"><h3>Configuration</h3><p><code>
ProxyExpressEnable on<br />
- ProxyExpressDBMFile emap<br />
+ ProxyExpressDBMFile emap<br />
</code></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="proxyexpressdbmtype" id="proxyexpressdbmtype">Directive</a> <a name="ProxyExpressDBMType" id="ProxyExpressDBMType">ProxyExpressDBMType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>DBM type of file.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type de fichier DBM.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressDBMFile <type></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>"default"</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#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.13 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyExpressDBMType</code> directive
- controls the DBM type expected by the module. The default
- is the default DBM type created with <code>
- <a href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
- <p>Possible values are (not all may be available at run time):</p>
+ <p>La directive <code class="directive">ProxyExpressDBMType</code> permet de
+ définir le type de fichier DBM requis par le module. La valeur par
+ défaut correspond au type DBM par défaut du fichier créé par
+ l'utilitaire <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
+ <p>Les valeurs possibles sont (mais toutes ne seront pas disponibles à
+ l'exécution) :</p>
<table class="bordered"><tr class="header"><th>Value</th><th>Description</th></tr>
-<tr><td><code>db</code></td><td> Berkeley DB files</td></tr>
-<tr class="odd"><td><code>gdbm</code></td><td> GDBM files</td></tr>
-<tr><td><code>ndbm</code></td><td> NDBM files</td></tr>
-<tr class="odd"><td><code>sdbm</code></td><td> SDBM files (always available)</td></tr>
-<tr><td><code>default</code></td><td> default DBM type</td></tr>
+<tr><td><code>db</code></td><td>Fichiers Berkeley DB</td></tr>
+<tr class="odd"><td><code>gdbm</code></td><td>Fichiers GDBM</td></tr>
+<tr><td><code>ndbm</code></td><td>Fichiers NDBM</td></tr>
+<tr class="odd"><td><code>sdbm</code></td><td>Fichiers SDBM (toujours disponible)</td></tr>
+<tr><td><code>default</code></td><td>type DBM par défaut</td></tr>
</table>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxyexpressenable" id="proxyexpressenable">Directive</a> <a name="ProxyExpressEnable" id="ProxyExpressEnable">ProxyExpressEnable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable the module functionality.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalité du module.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressEnable [on|off]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.13 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyExpressEnable</code> directive
- controls whether the module will be active.</p>
+ <p>La directive <code class="directive">ProxyExpressEnable</code> permet
+ d'activer/désactiver le module.</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="proxyfcgibackendtype" id="proxyfcgibackendtype">Directive</a> <a name="ProxyFCGIBackendType" id="ProxyFCGIBackendType">ProxyFCGIBackendType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify the type of backend FastCGI application</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le type de l'application FastCGI d'arrière-plan</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGIBackendType FPM|GENERIC</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyFCGIBackendType FPM</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.4.26 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
-<p>This directive allows the type of backend FastCGI application to be
-specified. Some FastCGI servers, such as PHP-FPM, use historical quirks of
-environment variables to identify the type of proxy server being used. Set
-this directive to "GENERIC" if your non PHP-FPM application has trouble
-interpreting environment variables such as SCRIPT_FILENAME or PATH_TRANSLATED
-as set by the server.</p>
+<p>Cette directive permet de spécifier le type de l'application FastCGI
+d'arrière-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de manière
+historique des variables d'environnement exotiques pour identifier le type du
+serveur mandataire utilisé. Définissez cette directive à "GENERIC" si votre
+application n'est pas de type PHP-FPM et n'interpréter pas correctement des
+variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles
+qu'elles sont définies par le serveur.</p>
-<p>One example of values that change based on the setting of this directive is
-SCRIPT_FILENAME. When using <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> historically,
-SCRIPT_FILENAME was prefixed with the string "proxy:fcgi://". This variable is
-what some generic FastCGI applications would read as their script input, but
-PHP-FPM would strip the prefix then remember it was talking to Apache. In
-2.4.21 through 2.4.25, this prefix was automatically stripped by the server,
-breaking the ability of PHP-FPM to detect and interoperate with Apache in some
-scenarios.</p>
+<p>SCRIPT_FILENAME est un exemple de valeur modifiée par la définition de cette
+directive. Historiquement, lorsqu'on utilisait le module
+<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>, SCRIPT_FILENAME était préfixé par la chaîne
+"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
+génériques en tant que valeur en entrée pour leur script ; cependant, PHP-FPM
+peut supprimer le préfixe, puis garder en mémoire qu'il communique avec Apache.
+Avec les versions 2.4.21 à 2.4.25, ce préfixe était automatiquement supprimé par
+le serveur, empêchant ainsi PHP-FPM de détecter et interopérer avec Apache dans
+certains scénarios.</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="proxyfcgisetenvif" id="proxyfcgisetenvif">Directive</a> <a name="ProxyFCGISetEnvIf" id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow variables sent to FastCGI servers to be fixed up</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'adapter la valeur des variables envoyées aux serveurs
+FastCGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGISetEnvIf <var>conditional-expression</var>
[!]<var>environment-variable-name</var>
[<var>value-expression</var>]</code></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in version 2.4.26 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache.</td></tr>
</table>
-<p>Just before passing a request to the configured FastCGI server, the core of
-the web server sets a number of environment variables based on details of the
-current request. FastCGI programs often uses these environment variables
-as inputs that determine what underlying scripts they will process, or what
-output they directly produce.</p>
-<p>Examples of noteworthy environment variables are:</p>
+<p>Juste avant la transmission d'une requête au serveur FastCGI configuré, le
+coeur du programme du serveur web définit un certain nombre de variables
+d'environnement en fonction de certains détails de la requête considérée. Les
+programmes FastCGI utilisent souvent ces variables comme données en entrée afin
+de déterminer quels scripts sous-jacents ils vont exécuter, ou quelles données
+en sortie doivent être produites.</p>
+<p>Voici quelques exemples de variables d'environnement importantes :</p>
<ul>
<li>SCRIPT_NAME</li>
<li>SCRIPT_FILENAME</li>
<li>PATH_TRANSLATED</li>
</ul>
-<p>This directive allows the environment variables above, or any others of
-interest, to be overridden. This directive is evaluated after the initial
-values for these variables are set, so they can be used as input into both
-the condition expressions and value expressions.</p>
-<p>Parameter syntax:</p>
+<p>Cette directive permet de passer outre les variables d'environnement
+ci-dessus, entre autres. Elle est évaluée après la définition de la valeur
+initiale de ces variables ; elle peuvent donc être utilisées comme entrées dans
+les expressions définissants les conditions et les valeurs.</p>
+<p>Syntaxe des paramètres :</p>
<dl>
-<dt>conditional-expression</dt>
-<dd>Specifies an expression that controls whether the environment variable that
- follows will be modified. For information on the expression syntax, see
- the examples that follow or the full specification at the
- <a href="../expr.html">ap_expr</a> documentation.
+<dt>conditional-expression</dt>
+<dd>Définit une condition en fonction de laquelle la
+variable d'environnement qui suit sera modifiée ou non. Pour la syntaxe de cette
+expression, reportez-vous aux exemples qui suivent ou à la spécification
+détaillée dans le document <a href="../expr.html">ap_expr</a>.
</dd>
-<dt>environment-variable-name</dt>
-<dd> Specifies the CGI environment variable to change,
- such as PATH_INFO. If preceded by an exclamation point, the variable
- will be unset.</dd>
+<dt>environment-variable-name</dt>
+<dd>Spécifie le nom de la variable d'environnement à modifier, par exemple
+PATH_INFO. Si elle est précédée d'un point d'exclamation, la définition de la
+variable sera annulée.</dd>
<dt>value-expression</dt>
-<dd>Specifies the replacement value for the preceding environment variable.
- Backreferences, such as "$1", can be included from regular expression
- captures in <var>conditional-expression</var>. If omitted, the variable is
- set (or overridden) to an empty string — but see the Note below.</dd>
+<dd>Spécifie la nouvelle valeur de la variable "environment-variable-name". On
+peut inclure des
+références arrières, comme "$1", issues de captures en provenance de
+l'expression rationnelle <var>conditional-expression</var>. Si cette valeur est
+omise, la variable est définie (ou sa valeur est écrasée) par une chaîne vide
+— voir cependant la note ci-après.</dd>
</dl>
-
-<div class="example"><pre class="prettyprint lang-config"># A basic, unconditional override
+
+<div class="example"><pre class="prettyprint lang-config"># Une modification basique, inconditionnelle
ProxyFCGISetEnvIf "true" PATH_INFO "/example"
-# Use an environment variable in the value
+# Utilisation d'une variable d'environnement pour spécifier la nouvelle valeur
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
-
-# Use captures in the conditions and backreferences in the replacement
-ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m|(/.*prefix)(\d+)(.*)|" PATH_TRANSLATED "$1$3"</pre>
+<br />
+# Utilisation de captures dans la condition et de références arrières dans la
+# nouvelle valeur
+ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"</pre>
</div>
-<div class="note"><h3>Note: Unset vs. Empty</h3>
- The following will unset <code>VARIABLE</code>, preventing it from being sent
- to the FastCGI server:
+<div class="note"><h3>Note : Annulation définition ou valeur vide</h3>
+ La ligne suivante annule la définition de la variable <code>VARIABLE</code>,
+ ce qui l'empêche d'être envoyée au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true !VARIABLE</pre>
- Whereas the following will erase any existing <em>value</em> of
- <code>VARIABLE</code> (by setting it to the empty string), but the empty
- <code>VARIABLE</code> will still be sent to the server:
+ La ligne suivante, quant à elle, efface la <em>valeur</em> de la variable
+ <code>VARIABLE</code> en lui affectant la chaîne vide ; cette variable
+ <code>VARIABLE</code> sera alors tout de même envoyée au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true VARIABLE</pre>
- The CGI/1.1 specification
- <a href="https://tools.ietf.org/html/rfc3875#section-4.1">does not
- distinguish</a> between a variable with an empty value and a variable that
- does not exist. However, many CGI and FastCGI implementations distinguish (or
- allow scripts to distinguish) between the two. The choice of which to use is
- dependent upon your implementation and your reason for modifying the variable.
+ La spécification CGI/1.1 <a href="https://tools.ietf.org/html/rfc3875#section-4.1">ne fait pas de
+ distinction</a> entre une variable contenant une chaîne vide et une variable qui
+ n'existe pas. De nombreuses implémentations CGI et FastCGI font cependant
+ cette distinction (ou permettent aux scripts de la faire). Le choix de celle
+ que vous allez utiliser dépend de votre implémentation et de la raison qui
+ vous pousse à modifier cette variable.
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a> <a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the character set for proxied FTP listings</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>character set</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le jeu de caractères des listings FTP
+mandatés</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caractères</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Moved from <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> in Apache 2.3.5.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Déplacé
+depuis <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> à partir de la version 2.3.5 d'Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyFtpDirCharset</code> directive defines the
- character set to be set for FTP directory listings in HTML generated by
- <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.</p>
+ <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de
+ définir le jeu de caractères à utiliser pour les listings FTP en
+
HTML générés par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</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="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a> <a name="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether wildcards in requested filenames are escaped when sent to the FTP server</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
+doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpEscapeWildcards [on|off]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.3 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyFtpEscapeWildcards</code> directive
- controls whether wildcard characters ("*?[{~") in requested
- filenames are escaped with backslash before sending them to the
- FTP server. That is the default behavior, but many FTP servers
- don't know about the escaping and try to serve the literal filenames
- they were sent, including the backslashes in the names. </p>
- <p>Set to "off" to allow downloading files with wildcards
- in their names from FTP servers that don't understand wildcard
- escaping.</p>
+ <p>La directive <code class="directive">ProxyFtpEscapeWildcards</code> permet
+ de déterminer si les caractères génériques ("*?[{~") que contiennent
+ les noms de fichiers demandés doivent être échappés pas un slash
+ inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement
+ par défaut ; cependant, de nombreux serveurs FTP n'ont aucune
+ connaissance de la notion d'échappement, et tentent de servir le
+ fichier demandé sous sa forme littérale, en incluant les slashes
+ inversés dans son nom.</p>
+ <p>Définissez cette directive à "off" pour permettre le
+ téléchargement de fichiers dont les noms contiennent des caractères
+ génériques depuis des serveurs FTP qui ne connaissent pas
+ l'échappement des caractères génériques.</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="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a> <a name="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether wildcards in requested filenames trigger a file listing</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
+demandés doivent-ils déclencher l'affichage d'un listing ?</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpListOnWildcard [on|off]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.3 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">ProxyFtpListOnWildcard</code> directive
- controls whether wildcard characters ("*?[{~") in requested
- filenames cause <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> to return a listing
- of files instead of downloading a file. By default (value on),
- they do. Set to "off" to allow downloading files even if they
- have wildcard characters in their names.</p>
+ <p>La directive <code class="directive">ProxyFtpListOnWildcard</code> permet
+ de déterminer si les caractères génériques ("*?[{~") que contiennent
+ les noms de fichiers demandés provoquent l'affichage d'un listing de
+ fichiers par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> au lieu de télécharger un
+ fichier. Il s'agit de leur comportement par défaut (valeur on).
+ Définissez cette directive à "off" pour permettre le téléchargement de
+ fichiers même si leur nom contient des caractères génériques.</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="proxyhtmlbufsize" id="proxyhtmlbufsize">Directive</a> <a name="ProxyHTMLBufSize" id="ProxyHTMLBufSize">ProxyHTMLBufSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the buffer size increment for buffering inline scripts and
-stylesheets.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLBufSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'incrément de la taille du tampon, ainsi que sa
+taille initiale, pour la mise en
+tampon des scripts en ligne et des feuilles de style.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLBufSize <var>nb-octets</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>In order to parse non-HTML content (stylesheets and scripts) embedded
-in HTML documents, mod_proxy_html
-has to read the entire script or stylesheet into a buffer. This buffer will
-be expanded as necessary to hold the largest script or stylesheet in a page,
-in increments of <var>bytes</var> as set by this directive.</p>
-<p>The default is 8192, and will work well for almost all pages. However,
-if you know you're proxying pages containing stylesheets and/or
-scripts bigger than 8K (that is, for a single script or stylesheet,
-NOT in total), it will be more efficient to set a larger buffer
-size and avoid the need to resize the buffer dynamically during a request.
+<p>Pour pouvoir interpréter du contenu non HTML (feuilles de style et
+scripts) embarqué dans des documents HTML, mod_proxy_html doit le lire
+et le mémoriser en entier dans un
+tampon. Ce tampon devra être étendu autant que nécessaire afin de
+pouvoir accueillir le plus grand script ou la plus grande feuille de
+style de la page, selon un incrément de <var>nb-octets</var> que cette
+directive permet de définir.</p>
+<p>La valeur par défaut est 8192 et sera suffisante pour la plupart des
+pages. Cependant, si vous savez que vous allez mandater des
+pages contenant des feuilles de style et/ou scripts plus grands que 8k
+(cette taille s'entend pour chaque script ou feuilles de style, non pour
+leur ensemble), il sera plus efficace de définir une taille de
+tampon initiale plus grande afin d'éviter d'avoir à le redimensionner
+dynamiquement au cours du traitement d'une 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="proxyhtmlcharsetout" id="proxyhtmlcharsetout">Directive</a> <a name="ProxyHTMLCharsetOut" id="ProxyHTMLCharsetOut">ProxyHTMLCharsetOut</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a charset for mod_proxy_html output.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLCharsetOut <var>Charset | *</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie un jeu de caractères pour la sortie de
+mod_proxy_html.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLCharsetOut <var>jeu-de-caractères | *</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>This selects an encoding for mod_proxy_html output. It should not
-normally be used, as any change from the default <code>UTF-8</code>
-(Unicode - as used internally by libxml2) will impose an additional
-processing overhead. The special token <code>ProxyHTMLCharsetOut *</code>
-will generate output using the same encoding as the input.</p>
-<p>Note that this relies on <code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> being loaded.</p>
+<p>Cette directive permet de spécifier un jeu de caractères pour la
+sortie de mod_proxy_html. Elle ne devrait jamais être utilisée, car tout
+changement par rapport à la valeur par défaut <code>UTF-8</code> (Unicode -
+utilisé en interne par libxml2) induit une charge supplémentaire de
+traitement. La définition spéciale <code>ProxyHTMLCharsetOut *</code>
+permet de générer une sortie qui utilisera le même encodage que
+l'entrée.</p>
+<p>Notez que tout ceci ne fonctionne que si le module
+<code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> est chargé.</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="proxyhtmldoctype" id="proxyhtmldoctype">Directive</a> <a name="ProxyHTMLDocType" id="ProxyHTMLDocType">ProxyHTMLDocType</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets an HTML or XHTML document type declaration.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLDocType <var>HTML|XHTML [Legacy]</var><br /><strong>OR</strong>
-<br />ProxyHTMLDocType <var>fpi [SGML|XML]</var><br /><strong>OR</strong>
-<br />ProxyHTMLDocType <var>html5</var><br /><strong>OR</strong>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une déclaration de type de document HTML ou XHTML.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLDocType <var>HTML|XHTML [Legacy]</var><br /><strong>OU</strong>
+<br />ProxyHTMLDocType <var>fpi [SGML|XML]</var><br /><strong>OU</strong>
+<br />ProxyHTMLDocType <var>html5</var><br /><strong>OU</strong>
<br />ProxyHTMLDocType <var>auto</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLDocType auto (2.5/trunk versions); no FPI (2.4.x)</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>In the first form, documents will be declared as HTML 4.01 or XHTML 1.0
-according to the option selected. This option also determines whether
-HTML or XHTML syntax is used for output. Note that the format of the
-documents coming from the backend server is immaterial: the parser will
-deal with it automatically. If the optional second argument is set to
-"Legacy", documents will be declared "Transitional", an option that may
-be necessary if you are proxying pre-1998 content or working with defective
-authoring/publishing tools.</p>
-<p>In the second form, it will insert your own FPI. The optional second
-argument determines whether SGML/HTML or XML/XHTML syntax will be used.</p>
-<p>The third form declares documents as HTML 5.</p>
-<p>The fourth form is new in HTTPD trunk and not yet available in released
-versions, and uses libxml2's HTML parser to detect the doctype.</p>
-<p>If the first form is used, mod_proxy_html
-will also clean up the HTML to the specified standard. It cannot
-fix every error, but it will strip out bogus elements and attributes.
-It will also optionally log other errors at <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> Debug.</p>
+<p>Avec la première syntaxe, les documents seront déclarés de type HTML
+4.01 ou XHTML 1.0 selon l'option spécifiée. Cette option détermine aussi
+si la syntaxe utilisée en sortie est HTML ou XHTML. Notez que le format
+des documents en provenance du serveur d'arrière-plan n'est pas
+important, car l'interpréteur le détectera automatiquement. Si le
+second argument optionnel est défini à "Legacy", les documents seront
+déclarés de type "Transitional" ; cette option peut être nécessaire si
+vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
+des outils de création/publication déficients.</p>
+<p>Avec la deuxième syntaxe, cette directive vous permet d'insérer votre
+propre FPI (Formal Public Identifier). Le second argument optionnel
+détermine si la syntaxe utilisée sera SGML/HTML ou XML/XHTML.</p>
+<p>La troisième syntaxe attribue le type HTML 5 aux documents.</p>
+<p>La quatrième syntaxe est nouvelle dans la branche trunk de HTTPD et
+n'est pas encore disponible dans les versions stables ; elle utilise
+l'interpréteur HTML de libxml2 pour déterminer le type de document.</p>
+<p>Avec la première syntaxe, mod_proxy_html va aussi mettre le code HTML
+en conformité avec le standard spécifié. Il ne pourra pas corriger
+toutes les erreurs, mais il va supprimer les éléments et attributs non
+conformes. Il peut aussi journaliser les autres erreurs si la directive
+<code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> est définie à
+Debug.</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="proxyhtmlenable" id="proxyhtmlenable">Directive</a> <a name="ProxyHTMLEnable" id="ProxyHTMLEnable">ProxyHTMLEnable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turns the proxy_html filter on or off.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'activer/désactiver le filtre proxy_html.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLEnable <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLEnable 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-module for earlier 2.x versions.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
- <p>A simple switch to enable or disable the proxy_html filter.
- If <code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> is loaded it will also automatically
- set up internationalisation support.</p>
- <p>Note that the proxy_html filter will only act on HTML data
- (Content-Type text/html or application/xhtml+xml) and when the
- data are proxied. You can override this (at your own risk) by
- setting the <var>PROXY_HTML_FORCE</var> environment variable.</p>
+ <p>Cette directive est un simple commutateur permettant
+ d'activer/désactiver le filtre proxy_html. Si
+ <code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> est chargé, elle va aussi activer
+ automatiquement le support de l'internationalisation.</p>
+ <p>Notez que le filtre proxy_html s'agira que si les données sont de
+ type HTML (Content-Type text/html ou application/xhtml+xml), et si
+ elles passent par un mandataire. Vous pouvez passer outre ces
+ contraintes (à vos risques et périls) en définissant la variable
+ d'environnement <var>PROXY_HTML_FORCE</var>.</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="proxyhtmlevents" id="proxyhtmlevents">Directive</a> <a name="ProxyHTMLEvents" id="ProxyHTMLEvents">ProxyHTMLEvents</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify attributes to treat as scripting events.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLEvents <var>attribute [attribute ...]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie les attributs à traiter comme des évènements de
+type scripting.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLEvents <var>attribut [attribut ...]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>Specifies one or more attributes to treat as scripting events and
-apply <code class="directive">ProxyHTMLURLMap</code>s to where enabled.
-You can specify any number of attributes in one or more
-<code>ProxyHTMLEvents</code> directives.</p>
-<p>Normally you'll set this globally. If you set ProxyHTMLEvents in more than
-one scope so that one overrides the other, you'll need to specify a complete
-set in each of those scopes.</p>
-<p>A default configuration is supplied in <var>proxy-html.conf</var>
-and defines the events in standard HTML 4 and XHTML 1.</p>
+<p>Cette directive permet de spécifier un ou plusieurs attributs à
+traiter comme
+des évènements de type scripting et de leur appliquer les règles
+<code class="directive">ProxyHTMLURLMap</code> lorsqu'elles ont été définies. Vous
+pouvez spécifier un nombre quelconque d'attributs dans une ou plusieurs
+directives <code>ProxyHTMLEvents</code>.</p>
+<p>Normalement, cette directive est définie globalement. Si vous
+définissez ProxyHTMLEvents à plusieurs niveaux, certains niveaux
+l'emportant sur d'autres, vous devrez spécifier un jeu complet
+d'évènements pour chaque niveau.</p>
+<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
+défaut et définit les évènements selon les standards
+HTML 4 et XHTML 1.</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="proxyhtmlextended" id="proxyhtmlextended">Directive</a> <a name="ProxyHTMLExtended" id="ProxyHTMLExtended">ProxyHTMLExtended</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to fix links in inline scripts, stylesheets,
-and scripting events.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si l'on doit corriger les liens dans les scripts
+en ligne, les feuilles de style et les évènements de type scripting.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLExtended <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLExtended 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>Set to <code>Off</code>, HTML links are rewritten according to the
-<code class="directive">ProxyHTMLURLMap</code> directives, but links appearing
-in Javascript and CSS are ignored.</p>
-<p>Set to <code>On</code>, all scripting events (as determined by
-<code class="directive">ProxyHTMLEvents</code>) and embedded scripts or
-stylesheets are also processed by the <code class="directive">ProxyHTMLURLMap</code>
-rules, according to the flags set for each rule. Since this requires more
-parsing, performance will be best if you only enable it when strictly necessary.
-</p><p>
-You'll also need to take care over patterns matched, since the parser has no
-knowledge of what is a URL within an embedded script or stylesheet.
-In particular, extended matching of <code>/</code> is likely to lead to
-false matches.
-</p>
+<p>Si cette directive est définie à <code>Off</code>, les liens HTML
+sont réécrits en fonction des directives
+<code class="directive">ProxyHTMLURLMap</code>, mais les liens qui apparaissent
+dans le code Javascript et les feuilles de style restent inchangés.</p>
+<p>Si elle est définie à <code>On</code>, tous les évènements de type
+scripting (définis par la directive
+<code class="directive">ProxyHTMLEvents</code>) et les scripts inclus ou les
+feuilles de style sont aussi
+traités par les règles <code class="directive">ProxyHTMLURLMap</code>, en
+fonction des drapeaux définis pour chacune d'entre elles. Ne définissez
+cette directive à <code>On</code> qu'en cas de nécessité absolue, car la
+charge supplémentaire induite impacte les performances.</p>
+<p>Vous devez aussi prêter attention aux modèles de comparaison, car
+l'interpréteur n'a aucune notion de la forme que pourrait prendre une URL dans un
+script embarqué ou une feuille de style. En particulier, la comparaison
+étendus du caractère <code>/</code> a de fortes chances d'induire des
+correspondances erroné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="proxyhtmlfixups" id="proxyhtmlfixups">Directive</a> <a name="ProxyHTMLFixups" id="ProxyHTMLFixups">ProxyHTMLFixups</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fixes for simple HTML errors.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Corrige les erreurs HTML simples.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLFixups <var>[lowercase] [dospath] [reset]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>This directive takes one to three arguments as follows:</p>
+<p>Cette directive accepte un à trois arguments parmi les suivants :</p>
<ul>
-<li><code>lowercase</code> Urls are rewritten to lowercase</li>
-<li><code>dospath</code> Backslashes in URLs are rewritten to forward slashes.</li>
-<li><code>reset</code> Unset any options set at a higher level in the configuration.</li>
+<li><code>lowercase</code>Les Urls sont réécrites en minuscules</li>
+<li><code>dospath</code>Les slashes inversés dans les URLs sont
+remplacés par des slashes directs.</li>
+<li><code>reset</code>Annule toute option définie à un niveau supérieur
+dans la configuration</li>
</ul>
-<p>Take care when using these. The fixes will correct certain authoring
-mistakes, but risk also erroneously fixing links that were correct to start with.
-Only use them if you know you have a broken backend server.</p>
+<p>Cette directive doit être utilisée avec prudence. Elle peut corriger
+certaines erreurs de création, mais risque aussi de modifier par erreur
+des liens corrects. Ne l'utilisez que si vous êtes sûr que le serveur
+d'arrière-plan est déficient.</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="proxyhtmlinterp" id="proxyhtmlinterp">Directive</a> <a name="ProxyHTMLInterp" id="ProxyHTMLInterp">ProxyHTMLInterp</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables per-request interpolation of
-<code class="directive">ProxyHTMLURLMap</code> rules.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la réinterprétation des règles
+<code class="directive">ProxyHTMLURLMap</code> pour chaque requête.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLInterp <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLInterp 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
- <p>This enables per-request interpolation in
- <code class="directive">ProxyHTMLURLMap</code> to- and from- patterns.</p>
- <p>If interpolation is not enabled, all rules are pre-compiled at startup.
- With interpolation, they must be re-compiled for every request, which
- implies an extra processing overhead. It should therefore be
- enabled only when necessary.</p>
+ <p>Cette directive permet d'activer le réinterprétation pour chaque
+ requête des modèles source et cible de la directive
+ <code class="directive">ProxyHTMLURLMap</code>.</p>
+ <p>Si la réinterprétation n'est pas activée, toutes les règles sont
+ précompilées au démarrage du serveur. Si elle est activée, les
+ règles doivent être recompilées pour chaque requête, ce qui induit
+ une charge de traitement supplémentaire. Elle ne doit donc être activée que si
+ cela s'avère nécessaire.</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="proxyhtmllinks" id="proxyhtmllinks">Directive</a> <a name="ProxyHTMLLinks" id="ProxyHTMLLinks">ProxyHTMLLinks</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify HTML elements that have URL attributes to be rewritten.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLLinks <var>element attribute [attribute2 ...]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie les éléments HTML dont les attributs d'URL doivent
+être réécrits.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLLinks <var>élément attribut [attribut2 ...]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>Specifies elements that have URL attributes that should be rewritten
-using standard <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>s.
-You will need one ProxyHTMLLinks directive per element,
-but it can have any number of attributes.</p>
-<p>Normally you'll set this globally. If you set ProxyHTMLLinks in more than
-one scope so that one overrides the other, you'll need to specify a complete
-set in each of those scopes.</p>
-<p>A default configuration is supplied in <var>proxy-html.conf</var>
-and defines the HTML links for standard HTML 4 and XHTML 1.</p>
-<div class="example"><h3>Ex
amples from proxy-html.conf</h3><pre class="prettyprint lang-config">ProxyHTMLLinks a href
+<p>Cette directive permet de spécifier les éléments dont les attributs d'URL
+doivent être réécrits en utilisant les règles standards <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>. Vous devez définir une
+directive ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
+spécifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
+est définie globalement. Si vous définissez ProxyHTMLLinks à plusieurs niveaux,
+certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
+de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
+fournit une configuration par défaut et définit les liens HTML selon les
+standards HTML 4 et XHTML 1.</p>
+<div class="example"><h3>Ex
emples issus de proxy-html.conf</h3><pre class="prettyprint lang-config">ProxyHTMLLinks a href
ProxyHTMLLinks area href
ProxyHTMLLinks link href
ProxyHTMLLinks img src longdesc usemap
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxyhtmlmeta" id="proxyhtmlmeta">Directive</a> <a name="ProxyHTMLMeta" id="ProxyHTMLMeta">ProxyHTMLMeta</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Turns on or off extra pre-parsing of metadata in HTML
-<code><head></code> sections.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive une préinterprétation supplémentaire
+des métadonnées dans les sections HTML <code><head></code>.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLMeta <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLMeta 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-module for earlier 2.x versions.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4 du serveur HTTP
+Apache ; proposé en tant que module tiers dans les versions 2.x
+précédentes.</td></tr>
</table>
- <p>This turns on or off pre-parsing of metadata in HTML
- <code><head></code> sections.</p>
- <p>If not required, turning ProxyHTMLMeta Off will give a small
- performance boost by skipping this parse step. However, it
- is sometimes necessary for internationalisation to work correctly.</p>
- <p>ProxyHTMLMeta has two effects. Firstly and most importantly
- it enables detection of character encodings declared in the form</p>
+ <p>Cette directive permet d'activer ou désactiver une
+ préinterprétation supplémentaire des métadonnées dans les sections
+ HTML <code><head></code>. Si cette préinterprétation n'est pas
+ requise, définissez ProxyHTMLMeta à Off et les performances
+ seront légèrement améliorées. Cependant, elle s'avère parfois
+ nécessaire pour assurer un fonctionnement correct de l'internationalisation.</p>
+ <p>La directive ProxyHTMLMeta a deux effets. Le premier et le plus
+ important est la détection des codages de caractères déclarés sous
+ la forme</p>
<pre><meta http-equiv="Content-Type" content="text/html;charset=<var>foo</var>"></pre>
- <p>or, in the case of an XHTML document, an XML declaration.
- It is NOT required if the charset is declared in a real HTTP header
- (which is always preferable) from the backend server, nor if the
- document is <var>utf-8</var> (unicode) or a subset such as ASCII.
- You may also be able to dispense with it where documents use a
- default declared using <code class="directive"><a href="../mod/mod_xml2enc.html#xml2encdefault">xml2EncDefault</a></code>, but that risks propagating an
- incorrect declaration. A <code class="directive">ProxyHTMLCharsetOut</code>
- can remove that risk, but is likely to be a bigger processing
- overhead than enabling ProxyHTMLMeta.</p>
- <p>The other effect of enabling ProxyHTMLMeta is to parse all
- <code><meta http-equiv=...></code> declarations and convert
- them to real HTTP headers, in keeping with the original purpose
- of this form of the HTML <meta> element.</p>
+ <p>ou, dans le cas d'un document XHTML, sous la forme d'une
+ déclaration XML. Elle n'est pas nécessaire si le jeu de caractères
+ est déclaré explicitement dans un en-tête HTTP (ce qui est
+ préférable) en provenance du serveur d'arrière-plan, ou si le
+ document est en <var>utf-8</var> (unicode) ou un de ses
+ sous-ensembles comme ASCII. Vous pourrez aussi vous en passer
+ lorsque le document utilise une valeur par défaut déclarée via la
+ directive <code class="directive"><a href="../mod/mod_xml2enc.html#xml2encdefault">xml2EncDefault</a></code>, avec le risque de
+ propager une déclaration incorrecte. Une directive
+ <code class="directive">ProxyHTMLCharsetOut</code> permettra d'annuler ce
+ risque, mais pourra induire une surcharge de traitement supérieure à
+ celle de ProxyHTMLMeta.</p>
+ <p>Le deuxième effet est l'interprétation de toutes les déclarations
+ <code><meta http-equiv=...></code> et leur conversion en
+ en-têtes HTTP, afin de conserver le but original de cette forme
+ de métaélément HTML.</p>
- <div class="warning"><h3>Warning</h3>
- Because ProxyHTMLMeta promotes <strong>all</strong>
- <code>http-equiv</code> elements to HTTP headers, it is important that you
- only enable it in cases where you trust the HTML content as much as you
- trust the upstream server. If the HTML is controlled by bad actors, it
- will be possible for them to inject arbitrary, possibly malicious, HTTP
- headers into your server's responses.
+ <div class="warning"><h3>Avertissement</h3> Compte tenu du fait que la
+ directive ProxyHTMLMeta promeut <strong>tous</strong> les éléments
+ <code>http-equiv</code> au rang d'en-têtes HTTP, il est conseillé de ne
+ l'activer que si vous faites autant confiance au contenu HTML qu'à votre
+ serveur mandataire. Avec cette directive en effet, si ce contenu est géré
+ par des gens malintentionnés, ces derniers seront en mesure d'injecter des
+ en-têtes HTTP arbitraires et peut-être malveillants dans les réponses de
+ votre serveur.
</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="proxyhtmlstripcomments" id="proxyhtmlstripcomments">Directive</a> <a name="ProxyHTMLStripComments" id="ProxyHTMLStripComments">ProxyHTMLStripComments</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines whether to strip HTML comments.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les commentaires HTML doivent être supprimés.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLStripComments <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyHTMLStripComments 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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>This directive will cause mod_proxy_html to strip HTML comments.
-Note that this will also kill off any scripts or styles embedded in
-comments (a bogosity introduced in 1995/6 with Netscape 2 for the
-benefit of then-older browsers, but still in use today).
-It may also interfere with comment-based processors such as SSI or ESI:
-be sure to run any of those <em>before</em> mod_proxy_html in the
-filter chain if stripping comments!</p>
+<p>Si cette directive est définie à <code>On</code>, mod_proxy_html
+supprimera les commentaires HTML. Notez que cela supprimera aussi tout
+script ou style inclus dans les commentaires (une monstruosité
+introduite en 1995/1996 avec Netscape 2 pour les navigateurs plus
+anciens, et encore utilisée de nos jours). Cette directive peut aussi
+interférer avec des processeurs basés sur les commentaires comme SSI ou
+ESI : assurez-vous d'exécuter ces derniers <em>avant</em> mod_proxy_html
+dans la chaîne de filtrage si vous supprimez les commentaires !</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="proxyhtmlurlmap" id="proxyhtmlurlmap">Directive</a> <a name="ProxyHTMLURLMap" id="ProxyHTMLURLMap">ProxyHTMLURLMap</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a rule to rewrite HTML links</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLURLMap <var>from-pattern to-pattern [flags] [cond]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une règle de réécriture des liens HTML</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLURLMap <var>modèle-source modèle-cible [drapeaux] [cond]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Version 2.4 and later; available as a third-party
-module for earlier 2.x versions.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
+Disponible en tant que module tiers dans les versions 2.x antérieures.</td></tr>
</table>
-<p>This is the key directive for rewriting HTML links. When parsing a document,
-whenever a link target matches <var>from-pattern</var>, the matching
-portion will be rewritten to <var>to-pattern</var>, as modified by any
-flags supplied and by the
-<code class="directive"><a href="#proxyhtmlextended">ProxyHTMLExtended</a></code> directive.
-Only the elements specified using
-the <code class="directive"><a href="#proxyhtmllinks">ProxyHTMLLinks</a></code> directive
-will be considered as HTML links.</p>
+<p>Il s'agit de la directive la plus importante pour la réécriture des
+liens HTML. Lors de l'interprétation d'un document, chaque fois qu'un
+lien correspond à <var>modèle-source</var>, la partie du lien concernée
+sera réécrite en <var>modèle-cible</var>, en tenant compte des
+modifications induites par les drapeaux éventuellement spécifiés et par
+la directive <code class="directive"><a href="#proxyhtmlextended">ProxyHTMLExtended</a></code>.
+Ne seront considérés comme des liens HTML que les éléments spécifiés via la
+directive <code class="directive"><a href="#proxyhtmllinks">ProxyHTMLLinks</a></code>.</p>
-<p>The optional third argument may define any of the following
-<strong>Flags</strong>. Flags are case-sensitive.</p>
+<p>Le troisième argument optionnel permet de définir un des drapeaux
+suivants (les drapeaux sont sensibles à la casse) :</p>
<dl>
<dt>h</dt>
-<dd><p>Ignore HTML links (pass through unchanged)</p></dd>
+<dd><p>Ignore les liens HTML (les traverse sans les modifier)</p></dd>
<dt>e</dt>
-<dd><p>Ignore scripting events (pass through unchanged)</p></dd>
+<dd><p>Ignore les évènements de scripting (les traverse sans les
+modifier)</p></dd>
<dt>c</dt>
-<dd><p>Pass embedded script and style sections through untouched.</p></dd>
+<dd><p>Traverse les sections de type style ou script sans les modifier.</p></dd>
<dt>L</dt>
-<dd><p>Last-match. If this rule matches, no more rules are applied
-(note that this happens automatically for HTML links).</p></dd>
+<dd><p>Last-match. Si cette règle s'applique, aucune autre règle ne sera
+prise en compte (notez qu'il s'agit du comportement automatique pour les
+liens HTML).</p></dd>
<dt>l</dt>
-<dd><p>Opposite to L. Overrides the one-change-only default
-behaviour with HTML links.</p></dd>
+<dd><p>L'opposé de L. Passe outre le comportement par défaut du
+changement unique pour les liens HTML.</p></dd>
<dt>R</dt>
-<dd><p>Use Regular Expression matching-and-replace. <code>from-pattern</code>
-is a regexp, and <code>to-pattern</code> a replacement string that may be
-based on the regexp. Regexp memory is supported: you can use brackets ()
-in the <code>from-pattern</code> and retrieve the matches with $1 to $9
-in the <code>to-pattern</code>.</p>
+<dd><p>Utilise des expressions rationnelles pour les modèles.
+<code>modèle-source</code> est une expression rationnelle, et
+<code>modèle-cible</code> une chaîne de remplacement qui peut être basée
+elle aussi sur une expression rationnelle. La mémorisation dans les
+expressions rationnelles est supportée : vous pouvez utiliser des
+parenthèses () dans le <code>modèle-source</code>, et récupérer la
+correspondance de leur contenu via les variables $1 à $9 dans le
+<code>modèle-cible</code>.</p>
-<p>If R is not set, it will use string-literal search-and-replace.
-The logic is <em>starts-with</em> in HTML links, but
-<em>contains</em> in scripting events and embedded script and style sections.
+<p>Si le drapeau R n'est pas fourni, la directive utilisera des chaînes
+littérales pour les différents modèles de recherche/remplacement. La
+logique de recherche est <em>"commence par"</em> dans les liens HTML, et
+<em>"contient"</em> dans les évènements de scripting et les sections de
+type style ou script.
</p>
</dd>
<dt>x</dt>
-<dd><p>Use POSIX extended Regular Expressions. Only applicable with R.</p></dd>
+<dd><p>Utilise les expressions rationnelles étendues POSIX. Ne
+s'applique qu'avec R.</p></dd>
<dt>i</dt>
-<dd><p>Case-insensitive matching. Only applicable with R.</p></dd>
+<dd><p>Recherche de correspondance sensible à la casse. Ne
+s'applique qu'avec R.</p></dd>
<dt>n</dt>
-<dd><p>Disable regexp memory (for speed). Only applicable with R.</p></dd>
+<dd><p>Désactive la mémorisation dans les expressions rationnelles (pour
+améliorer les performances). Ne s'applique qu'avec R.</p></dd>
<dt>s</dt>
-<dd><p>Line-based regexp matching. Only applicable with R.</p></dd>
+<dd><p>Recherche de correspondance dans les expressions rationnelles
+basée sur la ligne. Ne s'applique qu'avec R.</p></dd>
<dt>^</dt>
-<dd><p>Match at start only. This applies only to string matching
-(not regexps) and is irrelevant to HTML links.</p></dd>
+<dd><p>Recherche de correspondance au début seulement. Ne concerne que
+les recherches de correspondance par rapport à des chaînes, et ne
+s'applique pas aux liens HTML.</p></dd>
<dt>$</dt>
-<dd><p>Match at end only. This applies only to string matching
-(not regexps) and is irrelevant to HTML links.</p></dd>
+<dd><p>Recherche de correspondance à la fin seulement. Ne concerne que
+les recherches de correspondance par rapport à des chaînes, et ne
+s'applique pas aux liens HTML.</p></dd>
<dt>V</dt>
-<dd><p>Interpolate environment variables in <code>to-pattern</code>.
-A string of the form <code>${varname|default}</code> will be replaced by the
-value of environment variable <code>varname</code>. If that is unset, it
-is replaced by <code>default</code>. The <code>|default</code> is optional.</p>
-<p>NOTE: interpolation will only be enabled if
-<code class="directive">ProxyHTMLInterp</code> is <var>On</var>.</p>
+<dd><p>Insère des variables d'environnement dans le
+<code>modèle-cible</code>. Un <code>modèle-cible</code> de la forme
+<code>${varname|default}</code> sera remplacé par la valeur de la
+variable d'environnement <code>varname</code>. Si cette dernière n'est
+pas définie, <code>modèle-cible</code> sera remplacé par
+<code>default</code>. La spécification de <code>|default</code> est
+facultative.</p>
+<p>NOTE: l'insertion de variables d'environnement n'est possible que si
+la directive <code class="directive">ProxyHTMLInterp</code> a été définie à
+<var>On</var>.</p>
</dd>
<dt>v</dt>
-<dd><p>Interpolate environment variables in <code>from-pattern</code>.
-Patterns supported are as above.</p>
-<p>NOTE: interpolation will only be enabled if
-<code class="directive">ProxyHTMLInterp</code> is <var>On</var>.</p>
+<dd><p>Insère des variables d'environnement dans le
+<code>modèle-source</code>. La syntaxe du modèle est identique à la
+syntaxe précédente.</p>
+<p>NOTE: l'insertion de variables d'environnement n'est possible que si
+la directive <code class="directive">ProxyHTMLInterp</code> a été définie à
+<var>On</var>.</p>
</dd>
</dl>
-<p>The optional fourth <strong>cond</strong> argument defines a condition
-that will be evaluated per Request, provided
-<code class="directive">ProxyHTMLInterp</code> is <var>On</var>.
-If the condition evaluates FALSE the map will not be applied in this request.
-If TRUE, or if no condition is defined, the map is applied.</p>
-<p>A <strong>cond</strong> is evaluated by the <a href="../expr.html">Expression Parser</a>. In addition, the simpler syntax of conditions
-in mod_proxy_html 3.x for HTTPD 2.0 and 2.2 is also supported.</p>
+<p>Le quatrième argument optionnel <strong>cond</strong> définit une
+condition qui sera évaluée pour chaque requête, sous réserve que la
+directive <code class="directive">ProxyHTMLInterp</code> ait été définie à
+<var>On</var>. Si la condition est évaluée à FALSE, la règle ne sera pas
+appliquée à la requête. Si elle est évaluée à TRUE, ou si aucune
+condition n'est définie, la règle s'applique.</p>
+<p>La <strong>condition</strong> est évaluée par l'<a href="../expr.html">interpréteur d'expression</a>. La syntaxe simple des
+conditions dans mod_proxy_html 3.x pour HTTPD 2.0 et 2.2 est aussi
+supportée.</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="proxyscgiinternalredirect" id="proxyscgiinternalredirect">Directive</a> <a name="ProxySCGIInternalRedirect" id="ProxySCGIInternalRedirect">ProxySCGIInternalRedirect</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable internal redirect responses from the
-backend</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive les réponses de redirection interne en
+provenance du serveur cible.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySCGIInternalRedirect On|Off|<var>Headername</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxySCGIInternalRedirect On</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_scgi</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>The <var>Headername</var> feature is available in Apache
-httpd 2.4.13 and later.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le paramètre <var>Headername</var> est disponible depuis
+la version 2.4.13 du serveur HTTP Apache.</td></tr>
</table>
- <p>The <code class="directive">ProxySCGIInternalRedirect</code> enables the backend
- to internally redirect the gateway to a different URL. This feature
- originates in <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, which internally redirects the
- response if the response status is <code>OK</code> (<code>200</code>) and
- the response contains a <code>Location</code> (or configured alternate
- header) and its value starts with a slash (<code>/</code>). This value is
- interpreted as a new local URL that Apache httpd internally redirects to.</p>
-
- <p><code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> does the same as
- <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> in this regard, except that you can turn off the
- feature or specify the use of a header other than <code>Location</code>.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"> ProxySCGIInternalRedirect Off
-
-# Django and some other frameworks will fully qualify "local URLs"
-# set by the application, so an alternate header must be used.
+ <p>La directive <code class="directive">ProxySCGIInternalRedirect</code>
+ permet au serveur cible de rediriger en interne la passerelle vers
+ une URL différente. Cette fonctionnalité trouve son origine dans
+ <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> qui redirige la réponse en interne si
+ l'état de la réponse est <code>OK</code> (<code>200</code>), et si
+ la réponse contient un en-tête <code>Location</code> (ou un autre
+ en-tête défini) dont la valeur
+ débute par un slash (<code>/</code>). Cette valeur est interprétée
+ comme une nouvelle URL locale vers laquelle Apache httpd effectue sa
+ redirection.</p>
+
+ <p>De ce point de vue, <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> fait la même
+ chose que <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, mais vous pouvez en plus
+ désactiver la fonctionnalité ou spécifier l'utilisation d'un en-tête
+ autre que <code>Location</code>.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> ProxySCGIInternalRedirect Off
+# Django et certains autres frameworks qualifient pleinement les "URLs
+# locales" définies par l'application ; il faut donc utiliser un autre
+# en-tête.
<Location /django-app/>
ProxySCGIInternalRedirect X-Location
</Location></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxyscgisendfile" id="proxyscgisendfile">Directive</a> <a name="ProxySCGISendfile" id="ProxySCGISendfile">ProxySCGISendfile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable evaluation of <var>X-Sendfile</var> pseudo response
-header</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySCGISendfile On|Off|<var>Headername</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'évaluation du pseudo en-tête de réponse
+<var>X-Sendfile</var></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySCGISendfile On|Off|<var>nom-en-tête</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxySCGISendfile 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_scgi</td></tr>
</table>
- <p>The <code class="directive">ProxySCGISendfile</code> directive enables the
- SCGI backend to let files be served directly by the gateway. This is useful
- for performance purposes — httpd can use <code>sendfile</code> or other
- optimizations, which are not possible if the file comes over the backend
- socket. Additionally, the file contents are not transmitted twice.</p>
- <p>The <code class="directive">ProxySCGISendfile</code> argument determines the
- gateway behaviour:</p>
+ <p>La directive <code class="directive">ProxySCGISendfile</code> permet au
+ serveur cible SCGI de faire servir les fichiers directement par la
+ passerelle. Ceci s'avère bénéfique en matière de performances —
+ httpd peut alors utiliser <code>sendfile</code> ou d'autres
+ optimisations, ce qui n'est pas possible si les fichiers passent par
+ le socket du serveur cible. En outre, les fichiers ne sont transmis
+ qu'une seule fois.</p>
+ <p>L'argument de la directive
+ <code class="directive">ProxySCGISendfile</code> détermine le comportement
+ de la passerelle :</p>
<dl>
<dt><code>Off</code></dt>
- <dd>No special handling takes place.</dd>
+ <dd>Aucun traitement particulier n'est effectué.</dd>
<dt><code>On</code></dt>
- <dd>The gateway looks for a backend response header called
- <code>X-Sendfile</code> and interprets the value as the filename to serve.
- The header is removed from the final response headers. This is equivalent to
+ <dd>La passerelle recherche un en-tête dans la réponse du serveur
+ cible nommé <code>X-Sendfile</code>, et interprète sa valeur comme
+ le nom du fichier à servir. L'en-tête est ensuite supprimé de la
+ réponse finale. Cet argument produit le même effet que
<code>ProxySCGISendfile X-Sendfile</code>.</dd>
- <dt>anything else</dt>
- <dd>Similar to <code>On</code>, but instead of the hardcoded header name
- <code>X-Sendfile</code>, the argument is used as the header name.</dd>
+ <dt>toute autre valeur</dt>
+ <dd>Identique à <code>On</code>, mais au lieu de rechercher le nom
+ d'en-tête codé en dur <code>X-Sendfile</code>, c'est la valeur de
+ l'argument qui constitue le nom de l'en-tête à rechercher.</dd>
</dl>
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"># Use the default header (X-Sendfile)
-ProxySCGISendfile On
-
-# Use a different header
-ProxySCGISendfile X-Send-Static</pre>
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> # Utilise le nom d'en-tête par défaut (X-Sendfile)
+ ProxySCGISendfile On
+
+ # Utilise un nom d'en-tête différent
+ ProxySCGISendfile X-Send-Static</pre>
</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="reflectorheader" id="reflectorheader">Directive</a> <a name="ReflectorHeader" id="ReflectorHeader">ReflectorHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Reflect an input header to the output headers</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReflectorHeader <var>inputheader</var> <var>[outputheader]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Renvoie un en-tête d'entrée dans les en-têtes de sortie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReflectorHeader <var>en-tête-entrée</var> <var>[en-tête-sortie]</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>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_reflector</td></tr>
</table>
- <p>This directive controls the reflection of request headers to the response.
- The first argument is the name of the request header to copy. If the optional
- second argument is specified, it will be used as the name of the response
- header, otherwise the original request header name will be used.</p>
+ <p>Cette directive permet de contrôler la répercution des en-têtes
+ de la requête dans la réponse. Le premier argument correspond au nom
+ de l'en-tête à copier. Si le second argument (optionnel) est
+ spécifié, il définit le nom sous lequel l'en-tête sera répercuté
+ dans la réponse ; dans le cas contraire, c'est le nom de l'en-tête
+ original qui sera utilisé.</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="remoteipheader" id="remoteipheader">Directive</a> <a name="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which should be parsed for useragent IP addresses</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>header-field</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le champ d'en-tête qui contiendra les adresses IP
+du client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>en-tête</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> directive triggers
- <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> to treat the value of the specified
- <var>header-field</var> header as the useragent IP address, or list
- of intermediate useragent IP addresses, subject to further configuration
- of the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> and
- <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directives.</p>
-
- <div class="warning"> Unless these other directives are used, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
- will trust all hosts presenting a non internal address in the
- <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header value.
- </div>
-
- <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP</pre>
+ <p>La directive <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> indique à
+ <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> de traiter la valeur de
+ l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme
+ une liste d'adresses IP clients intermédiaires, en fonction de la
+ configuration des directives
+ <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> et
+ <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>.</p>
+
+ <div class="warning">Si ces deux dernières
+ directives ne sont pas utilisées, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
+ traitera tout hôte présentant une adresse non interne
+ dans l'en-tête <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> comme hôte de
+ confiance.</div>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP</pre>
</div>
- <div class="example"><h3>
Proxy Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For</pre>
+ <div class="example"><h3>
Exemple dans le cas d'un mandataire</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For</pre>
</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="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a> <a name="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive adds one
- or more addresses (or address blocks) to trust as presenting a valid
- RemoteIPHeader value of the useragent IP. Unlike the
- <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directive, any IP address
- presented in this header, including private intranet addresses, are
- trusted when passed from these proxies.</p>
-
- <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
+ <p>La directive <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> permet
+ d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client. A la différence de la directive
+ <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>, toute adresse IP
+ présentée dans cet en-tête, y comprises les adresses intranet
+ privées, sont considérées comme dignes de confiance lorsqu'elles
+ sont indiquées par ces mandataires.</p>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
RemoteIPInternalProxy 10.0.2.0/24
RemoteIPInternalProxy gateway.localdomain</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="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a> <a name="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>nom-fichier</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></code> directive specifies
- a file parsed at startup, and builds a list of addresses (or address blocks)
- to trust as presenting a valid RemoteIPHeader value of the useragent IP.</p>
-
- <p>The '<code>#</code>' hash character designates a comment line, otherwise
- each whitespace or newline separated entry is processed identically to
- the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive.</p>
-
- <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
+ <p>La directive <code class="directive"><a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></code>
+ permet de spécifier un fichier parcouru au démarrage du serveur pour
+ construire une liste d'adresses (ou blocs d'adresses), auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+ sinon, toutes les lignes séparées par un caractère <code>nouvelle
+ ligne</code> ou
+ tous les éléments d'une ligne séparés par un espace sont traités de
+ la même façon qu'avec la directive
+ <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>.</p>
+
+ <div class="example"><h3>Exemple à usage interne (répartiteur de
+ charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
RemoteIPInternalProxyList conf/trusted-proxies.lst</pre>
</div>
- <div class="example"><h3>conf/trusted-proxies.lst contents</h3><pre># Our internally trusted proxies;
-10.0.2.0/24 #Everyone in the testing group
-gateway.localdomain #The front end balancer</pre></div>
+ <div class="example"><h3>contenu de conf/mandataires-de-confiance.lst</h3><pre> # Nos mandataires internes de confiance
+ 10.0.2.0/24 # Tout le monde dans le groupe de test
+ passerelle.domaine-local # Le frontal répartiteur de charge</pre></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="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a> <a name="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which will record all intermediate IP addresses</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>HeaderFieldName</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare le champ d'en-tête qui contiendra toutes les
+adresses IP intermédiaires</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>Nom_en-tête</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code> directive specifies
- a header into which <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> will collect a list of
- all of the intermediate client IP addresses trusted to resolve the useragent
- IP of the request. Note that intermediate
- <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> addresses are recorded in
- this header, while any intermediate
- <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> addresses are discarded.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+ <p>La directive <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code> permet
+ de spécifier l'en-tête dans lequel <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> va
+ collecter une liste de toutes les adresses IP clients intermédiaires
+ auxquelles on pourra faire confiance pour résoudre l'adresse IP
+ client de la requête. Notez que les adresses intermédiaires
+ <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> sont enregistrées dans
+ cet en-tête, alors que toute adresse intermédiaire
+ <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> est omise.</p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
RemoteIPProxiesHeader X-Forwarded-By</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="remoteipproxyprotocol" id="remoteipproxyprotocol">Directive</a> <a name="RemoteIPProxyProtocol" id="RemoteIPProxyProtocol">RemoteIPProxyProtocol</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable PROXY protocol handling</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive la gestion du protocole PROXY</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxyProtocol On|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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocol is only available in httpd 2.4.26 and newer</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">RemoteIPProxyProtocol</code> directive enables or
- disables the reading and handling of the PROXY protocol connection header.
- If enabled with the <code>On</code> flag, the upstream client <em>must</em>
- send the header every time it opens a connection or the connection will
- be aborted unless it is in the list of disabled hosts provided by <code class="directive"><a href="#remoteipproxyprotocolexceptions">RemoteIPProxyProtocolExceptions</a></code>
- directive.</p>
-
- <p>While this directive may be specified in any virtual host, it is
- important to understand that because the PROXY protocol is connection
- based and protocol agnostic, the enabling and disabling is actually based
- on ip-address and port. This means that if you have multiple name-based
- virtual hosts for the same host and port, and you enable it any one of
- them, then it is enabled for all them (with that host and port). It also
- means that if you attempt to enable the PROXY protocol in one and disable
- in the other, that won't work; in such a case the last one wins and a
- notice will be logged indicating which setting was being overridden.</p>
+ <p>La directive <code class="directive">RemoteIPProxyProtocol</code> permet
+ d'activer ou de désactiver la prise en compte et la gestion de l'en-tête de
+ connexion du protocole PROXY. Si elle est définie à <code>On</code>, la
+ demande du client <em>doit</em> envoyer l'en-tête approprié pour chaque
+ nouvelle connexion, sinon cette dernière sera fermée à moins qu'il ne fasse
+ partie de la liste, définie via la directive <code class="directive"><a href="#remoteipproxyprotocoldisablehosts">RemoteIPProxyProtocolDisableHosts</a></code>, des
+ hôtes pour lesquels le protocole PROXY est désactivé.</p>
+
+ <p>Bien que cette directive peut être définie au niveau de n'importe quel
+ serveur virtuel, il est important de garder à l'esprit que, étant donné que
+ le protocole PROXY est basé sur la connexion et agnostique quant au
+ protocle, son activation/désactivation est basée sur le couple adresse
+ IP/port. Cela signifie que si plusieurs serveurs virtuels à base de nom sont
+ configurés avec le même couple adresse IP/port, et si vous activez le
+ protocole PROXY pour l'un d'entre eux, il le sera aussi pour tous les autres
+ (avec le même couple adresse IP/port). Cela signifie aussi que si vous
+ tentez d'activer le protocole PROXY pour un serveur virtuel et de le
+ désactiver pour un autre, cela ne marchera pas ; dans ce dernier cas, la
+ dernière directive l'emporte sur les autres et une notification sera
+ enregistrée dans le journal pour indiquer les réglages qui ont été annulés.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost *:80>
ServerName www.example.com
RemoteIPProxyProtocol On
- #Requests to this virtual host must have a PROXY protocol
- # header provided. If it is missing, the connection will
- # be aborted
+ #Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
+ #protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée.
</VirtualHost>
Listen 8080
RemoteIPProxyProtocol On
RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8
- #Requests to this virtual host must have a PROXY protocol
- # header provided. If it is missing, the connection will
- # be aborted except when coming from localhost or the
- # 10.x.x.x RFC1918 range
+ #Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
+ #protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée à moins
+ que sa source ne soit localhost ou la gamme d'adresses RFC1918 10.x.x.x
</VirtualHost></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="remoteipproxyprotocolexceptions" id="remoteipproxyprotocolexceptions">Directive</a> <a name="RemoteIPProxyProtocolExceptions" id="RemoteIPProxyProtocolExceptions">RemoteIPProxyProtocolExceptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable processing of PROXY header for certain hosts or networks</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive la prise en compte de l'en-tête PROXY pour certains hôtes
+ou réseaux</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxyProtocolExceptions host|range [host|range] [host|range]</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocolExceptions is only available in httpd 2.4.26 and newer</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocolExceptions est disponible à partir de la
+version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">RemoteIPProxyProtocol</code> directive enables or
- disables the reading and handling of the PROXY protocol connection header.
- Sometimes it is desirable to require clients to provide the PROXY header, but
- permit other clients to connect without it. This directive allows a server
- administrator to configure a single host or CIDR range of hosts that may do
- so.</p>
+ <p>La directive <code class="directive">RemoteIPProxyProtocol</code> permet de
+ contrôler la prise en compte de l'en-tête de connexion du protocole PROXY.
+ Il est parfois souhaitable d'exiger pour certains clients la
+ présence de l'en-tête PROXY, mais aussi de permettre aux autres clients de
+ se connecter sans ce dernier. Cette directive permet à l'administrateur du
+ serveur d'autoriser cette possibilité à un hôte isolé ou à une gamme d'hôtes
+ au format CIDR.</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="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a> <a name="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint les adresses IP clients dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>
- directive restricts which peer IP addresses (or address blocks) will be
- trusted to present a valid RemoteIPHeader value of the useragent IP.</p>
-
- <p> Unlike the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive, any intranet
- or private IP address reported by such proxies, including the 10/8, 172.16/12,
- 192.168/16, 169.254/16 and 127/8 blocks (or outside of the IPv6 public
- 2000::/3 block) are not trusted as the useragent IP, and are left in the
- <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header's value.</p>
-
- <div class="warning">By default, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> will trust
- all hosts presenting a non internal address in the
- <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header value.
+ <p>La directive <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> permet
+ de définir quelles adresses IP (ou blocs d'adresses) seront
+ considérées comme de confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>A la différence de la directive
+ <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>, toutes les adresses IP
+ intranet ou privées indiquées par de tels mandataires, y compris les
+ blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
+ (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
+ dignes de confiance en tant qu'adresses IP clientes, et se situent
+ à gauche dans le contenu de l'en-tête
+ <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.</p>
+
+ <div class="warning">Par défaut, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
+ considérera comme de confiance tout hôte présentant une adresse non
+ interne dans l'en-tête <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.
</div>
- <div class="example"><h3>Trusted (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+ <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+ charge</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
RemoteIPTrustedProxy 10.0.2.16/28
RemoteIPTrustedProxy proxy.example.com</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="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a> <a name="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint les adresses IP clients dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>nom-fichier</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
</table>
- <p>The <code class="directive"><a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></code> directive specifies
- a file parsed at startup, and builds a list of addresses (or address blocks)
- to trust as presenting a valid RemoteIPHeader value of the useragent IP.</p>
-
- <p>The '<code>#</code>' hash character designates a comment line, otherwise
- each whitespace or newline separated entry is processed identically to
- the <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directive.</p>
-
- <div class="example"><h3>Trusted (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+ <p>La directive <code class="directive"><a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></code>
+ permet de spécifier un fichier parcouru au démarrage du serveur pour
+ construire une liste d'adresses (ou blocs d'adresses), auxquelles
+ on peut faire confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+ sinon, toutes les lignes séparées par un caractère nouvelle ligne ou
+ tous les éléments d'une ligne séparés par un espace sont traités de
+ la même façon qu'avec la directive
+ <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>.</p>
+
+ <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+ charge</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
RemoteIPTrustedProxyList conf/trusted-proxies.lst</pre>
</div>
- <div class="example"><h3>conf/
trusted-proxies.lst contents</h3><p><code>
- # Identified external proxies;<br />
- 192.0.2.16/28 #wap phone group of proxies<br />
- proxy.isp.example.com #some well known ISP
+ <div class="example"><h3>conf/
mandataires-de-confiance.lst contents</h3><p><code>
+ # Mandataires externes identifiés<br />
+ 192.0.2.16/28 #groupe wap phone de mandataires<br />
+ proxy.isp.example.com #un FAI bien connu
</code></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="requestreadtimeout" id="requestreadtimeout">Directive</a> <a name="RequestReadTimeout" id="RequestReadTimeout">RequestReadTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set timeout values for receiving request headers and body from client.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des délais maximums pour la réception des en-têtes
+et corps des requêtes en provenance du client.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RequestReadTimeout
-[header=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]
-[body=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]
+[header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
+[body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>header=20-40,MinRate=500 body=20,MinRate=500</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_reqtimeout</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Defaulted to disabled in
-version 2.3.14 and earlier.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Désactivée par défaut jusqu'à la version 2.3.14.</td></tr>
</table>
- <p>This directive can set various timeouts for receiving the request headers
- and the request body from the client. If the client fails to send headers or
- body within the configured time, a <code>408 REQUEST TIME OUT</code> error
- is sent.</p>
-
- <p>For SSL virtual hosts, the header timeout values include the time needed
- to do the initial SSL handshake. If the user's browser is configured to
- query certificate revocation lists and the CRL server is not reachable, the
- initial SSL handshake may take a significant time until the browser gives up
- waiting for the CRL. Therefore the header timeout values should not be set
- to very low values for SSL virtual hosts.
- The body timeout values include the time needed for SSL renegotiation
- (if necessary).</p>
-
- <p>When an <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> is in use
- (usually the case on Linux and FreeBSD), the socket is not sent to the
- server process before at least one byte (or the whole request for
- <code>httpready</code>) is received. The header timeout configured with
- <code>RequestReadTimeout</code> is only effective after the server process has
- received the socket.</p>
-
- <p>For each of the two timeout types (header or body), there are three ways
- to specify the timeout:
+ <p>Cette directive permet de définir différents délais pour la
+ réception des en-têtes et corps des requêtes en provenance du
+ client. Si le client ne parvient pas à respecter ces délais, un code
+ d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>
+
+ <p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes
+ inclut le temps nécessaire à la négociation SSL initiale. Si le
+ navigateur du client est configuré pour demander des listes de
+ révocations de certificats, et si le serveur correspondant n'est pas
+ disponible, le délai avant lequel le navigateur va abandonner son
+ attente de CRL au cours de la négociation SSL initiale peut être
+ assez important. Par conséquent, les valeurs de délais d'en-têtes ne
+ doivent pas être trop basses pour les serveurs virtuels SSL. Le délai
+ concernant le corps inclut le temps nécessaire à la renégociation
+ SSL (si elle est nécessaire).</p>
+
+ <p>Lorsqu'une directive <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> est active (ce qui est en
+ général le cas sous Linux et FreeBSD), le socket n'est envoyé au
+ processus du serveur qu'après la réception du premier octet (ou de
+ l'ensemble de la requête si <code>httpready</code> est défini). Le
+ délai configuré pour les en-têtes via la directive
+ <code>RequestReadTimeout</code> n'entre en ligne de compte qu'une fois
+ le socket reçu par le processus du serveur.</p>
+
+ <p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
+ ou le corps) :
</p>
<ul>
- <li><strong>Fixed timeout value</strong>:<br />
+ <li><strong>Valeur de délai fixe</strong>:<br />
- <div class="example"><p><code><var>type</var>=<var>timeout</var></code></p></div>
+ <div class="example"><p><code><var>type</var>=<var>délai</var></code></p></div>
- <p>The time in seconds allowed for reading all of the request headers or
- body, respectively. A value of 0 means no limit.</p>
+ <p>Le temps en secondes alloué pour la lecture des en-têtes ou du
+ corps de la requête. La valeur 0 signifie aucune limite.</p>
</li>
- <li><strong>Disable module for a vhost:</strong>:<br />
+ <li><strong>Désactivation du module pour un serveur virtuel :</strong>:<br />
<div class="example"><p><code>header=0 body=0</code></p></div>
- <p>This disables <code class="module"><a href="../mod/mod_reqtimeout.html">mod_reqtimeout</a></code> completely.</p>
+ <p>Avec cet exemple, le module <code class="module"><a href="../mod/mod_reqtimeout.html">mod_reqtimeout</a></code> est
+ complètement désactivé.</p>
</li>
- <li><strong>Timeout value that is increased when data is
- received</strong>:<br />
+ <li><strong>La valeur du délai qui est augmentée lorsque des données
+ sont reçues</strong> :<br />
<div class="example"><p><code>
- <var>type</var>=<var>timeout</var>,MinRate=<var>data_rate</var>
+ <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
</code></p></div>
- <p>Same as above, but whenever data is received, the timeout value is
- increased according to the specified minimum data rate (in bytes per
- second).</p>
+ <p>Identique à ce qui précède, mais chaque fois que des données sont
+ reçues, la valeur du délai est augmentée en fonction du taux-mini
+ spécifié (en octets par seconde).</p>
</li>
- <li><strong>Timeout value that is increased when data is received, with an
- upper bound</strong>:<br />
+ <li><strong>La valeur du délai augmente lorsque des données sont
+ reçues, jusqu'à une limite supérieure</strong>:<br />
<div class="example"><p><code>
- <var>type</var>=<var>timeout</var>-<var>maxtimeout</var>,MinRate=<var>data_rate</var>
+ <var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>
</code></p></div>
- <p>Same as above, but the timeout will not be increased above the second
- value of the specified timeout range.</p>
+ <p>Identique à ce qui précède, mais le délai n'augmentera pas au
+ delà de la borne supérieure du délai spécifiée.</p>
</li>
</ul>
+
+
+
</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="keptbodysize" id="keptbodysize">Directive</a> <a name="KeptBodySize" id="KeptBodySize">KeptBodySize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep the request body instead of discarding it up to
-the specified maximum size, for potential use by filters such as
-mod_include.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeptBodySize <var>maximum size in bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conserve le corps de la requête à concurrence de la taille
+maximale spécifiée, pour une utilisation éventuelle par des filtres
+comme mod_include.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeptBodySize <var>taille maximale en octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeptBodySize 0</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_request</td></tr>
</table>
- <p>Under normal circumstances, request handlers such as the
- default handler for static files will discard the request body
- when it is not needed by the request handler. As a result,
- filters such as mod_include are limited to making <code>GET</code> requests
- only when including other URLs as subrequests, even if the
- original request was a <code>POST</code> request, as the discarded
- request body is no longer available once filter processing is
- taking place.</p>
+ <p>Dans une situation normale, les gestionnaires de requête tels que
+ le gestionnaire par défaut des fichiers statiques suppriment le
+ corps de la requête s'il n'est pas nécessaire au gestionnaire de
+ requête. Il en résulte que les filtres comme mod_include sont
+ limités à des requêtes <code>GET</code> lors de l'inclusion d'autres
+ URLs en tant que sous-requêtes, et ceci même si la requête originale
+ était une requête <code>POST</code>, car le corps de la requête a
+ été supprimé et n'est donc plus disponible une fois le traitement du
+ filtre mis en oeuvre.</p>
- <p>When this directive has a value greater than zero, request
- handlers that would otherwise discard request bodies will
- instead set the request body aside for use by filters up to
- the maximum size specified. In the case of the mod_include
- filter, an attempt to <code>POST</code> a request to the static
- shtml file will cause any subrequests to be <code>POST</code>
- requests, instead of <code>GET</code> requests as before.</p>
+ <p>Lorsque l'argument de cette directive a une valeur supérieure à
+ zéro, les gestionnaires de requête qui suppriment habituellement les
+ corps de requête vont alors conserver ces corps de requête, à
+ concurrence de la taille maximale spécifiée, pour être
+ éventuellement utilisés par des filtres. Dans le cas du filtre
+ mod_include, une tentative de requête <code>POST</code> pour un
+ fichier shtml statique se traduira par des sous-requêtes
+ <code>POST</code>, et non par des sous-requêtes <code>GET</code>
+ comme avant.</p>
- <p>This feature makes it possible to break up complex web pages and
- web applications into small individual components, and combine
- the components and the surrounding web page structure together
- using <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. The components can take the
- form of CGI programs, scripted languages, or URLs reverse proxied
- into the URL space from another server using
- <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
+ <p>Cette fonctionnalité permet de découper des pages web complexes
+ et des applications web en petits éléments individuels, et de
+ combiner ces éléments avec la structure de la page web sous-jacente
+ en utilisant <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. Les éléments peuvent se
+ présenter sous la forme de programmes CGI, de langages de scripts,
+ ou d'URLs issues d'un mandataire inverse dans l'espace d'URL d'un
+
autre serveur en utilisant <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
- <p><strong>Note:</strong> Each request set aside has to be set
- aside in temporary RAM until the request is complete. As a result,
- care should be taken to ensure sufficient RAM is available on the
- server to support the intended load. Use of this directive
- should be limited to where needed on targeted parts of your
- URL space, and with the lowest possible value that is still big
- enough to hold a request body.</p>
+ <p><strong>Note :</strong> Chaque requête dont le corps est ainsi
+ conservé doit être enregistrée temporairement en mémoire vive
+ jusqu'à la fin du traitement de la requête. Il faut donc s'assurer
+ que la mémoire RAM du serveur est suffisante pour pouvoir supporter
+ la charge induite. L'utilisation de cette directive doit être
+ limitée à certaines portions de votre espace d'URL bien précises qui
+ le nécessitent, et en spécifiant comme taille maximale une valeur la
+ plus petite possible, mais tout de même suffisante pour un corps de
+ requête.</p>
- <p>If the request size sent by the client exceeds the maximum
- size allocated by this directive, the server will return
+ <p>Si la taille de la requête envoyée par le client dépasse la taille
+ maximale autorisée par cette directive, le serveur renverra l'erreur
<code>413 Request Entity Too Large</code>.</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="mod_include.html">mod_include</a> documentation</li>
-<li><a href="mod_auth_form.html">mod_auth_form</a> documentation</li>
+<li>la documentation de <a href="mod_include.html">mod_include</a></li>
+<li>la documentation de <a href="mod_auth_form.html">mod_auth_form</a></li>
</ul>
</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="rewritebase" id="rewritebase">Directive</a> <a name="RewriteBase" id="RewriteBase">RewriteBase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the base URL for per-directory rewrites</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteBase <em>URL-path</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'URL de base pour les réécritures au niveau
+répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteBase <em>chemin_URL</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Pas de valeur par défaut</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteBase</code> directive specifies the
- URL prefix to be used for per-directory (htaccess)
- <code class="directive"><a href="#rewriterule">RewriteRule</a></code> directives that
- substitute a relative path.</p>
- <p> This directive is <em>required</em> when you use a relative path
- in a substitution in per-directory (htaccess) context unless any
- of the following conditions are true:</p>
+ <p>La directive <code class="directive">RewriteBase</code> permet de
+ spécifier le préfixe d'URL à utiliser dans un contexte de
+ répertoire (htaccess) pour les directives
+ <code class="directive"><a href="#rewriterule">RewriteRule</a></code> qui réécrivent vers un chemin
+ relatif.</p>
+ <p>Cette directive est <em>obligatoire</em> si vous utilisez un
+ chemin relatif dans une substitution, et dans un contexte de
+ répertoire (htaccess), sauf si au moins une de ces conditions est
+ vérifiée :</p>
<ul>
- <li> The original request, and the substitution, are underneath the
- <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
- (as opposed to reachable by other means, such as
- <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>).</li>
- <li> The <em>filesystem</em> path to the directory containing the
- <code class="directive"><a href="#rewriterule">RewriteRule</a></code>,
- suffixed by the relative
- substitution is also valid as a URL path on the server
- (this is rare).</li>
- <li> In Apache HTTP Server 2.4.16 and later, this directive may be
- omitted when the request is mapped via
- <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>
- or <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</li>
+ <li>La requête initiale, ainsi que la substitution, se
+ situent par raport à la valeur de la directive
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est à
+ dire que pour y accéder, il n'est pas nécessaire d'utiliser
+ une directive telle qu'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>).</li>
+ <li>Le chemin du système de fichiers vers le répertoire
+ contenant la <code class="directive"><a href="#rewriterule">RewriteRule</a></code>, suffixé par
+ la substitution relative est aussi valide en tant qu'URL sur
+ le serveur (ce qui est rare).</li>
+ <li>A partir de la version 2.4.16 du serveur HTTP Apache,
+ cette directive peut être omise lorsque la requête est mise en
+ correspondance avec le système de fichiers via la directive
+ <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
+ <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</li>
</ul>
-<p> In the example below, <code class="directive">RewriteBase</code> is necessary
- to avoid rewriting to http://example.com/opt/myapp-1.2.3/welcome.html
- since the resource was not relative to the document root. This
- misconfiguration would normally cause the server to look for an "opt"
- directory under the document root.</p>
+<p>Dans l'exemple ci-dessous, la directive
+<code class="directive">RewriteBase</code> est nécessaire afin d'éviter une
+réécriture en http://example.com/opt/myapp-1.2.3/welcome.html car la
+ressource n'était pas relative à la racine des documents. Cette erreur
+de configuration aurait conduit le serveur à rechercher un répertoire
+"opt" à la racine des documents.</p>
+
<pre class="prettyprint lang-config">DocumentRoot "/var/www/example.com"
AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<Directory "/opt/myapp-1.2.3">
- RewriteEngine On
+ RewriteEngine On
RewriteBase "/myapp/"
RewriteRule "^index\.html$" "welcome.html"
</Directory></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="rewritecond" id="rewritecond">Directive</a> <a name="RewriteCond" id="RewriteCond">RewriteCond</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a condition under which rewriting will take place
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une condition qui devra être satisfaite pour que
+la réécriture soit effectuée
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
- <em>TestString</em> <em>CondPattern</em> [<em>flags</em>]</code></td></tr>
+ <em>chaîne_de_test</em> <em>expression_de_comparaison</em> [<em>drapeaux</em>]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteCond</code> directive defines a
- rule condition. One or more <code class="directive">RewriteCond</code>
- can precede a <code class="directive"><a href="#rewriterule">RewriteRule</a></code>
- directive. The following rule is then only used if both
- the current state of the URI matches its pattern, <strong>and</strong> if these conditions are met.</p>
+ <p>La directive <code class="directive">RewriteCond</code> permet de définir une
+ condition d'exécution d'une règle. Une ou plusieurs conditions
+ <code class="directive">RewriteCond</code> peuvent précéder une
+ directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code>. La règle de réécriture correspondante n'est
+ ainsi exécutée que si ces conditions sont satisfaites,
+ <strong>et</strong> si l'URI correspond au modèle spécifié dans la
+ règle.</p>
- <p><em>TestString</em> is a string which can contain the
- following expanded constructs in addition to plain text:</p>
+ <p><em>TestString</em> est une chaîne qui peut contenir les
+ extensions suivantes en plus du texte simple :</p>
<ul>
<li>
- <strong>RewriteRule backreferences</strong>: These are
- backreferences of the form <strong><code>$N</code></strong>
- (0 <= N <= 9). $1 to $9 provide access to the grouped
- parts (in parentheses) of the pattern, from the
- <code>RewriteRule</code> which is subject to the current
- set of <code>RewriteCond</code> conditions. $0 provides
- access to the whole string matched by that pattern.
- </li>
+ <strong>références arrières de règle de réécriture</strong> :
+ ce sont des références arrières de la forme
+ <strong><code>$N</code></strong> (0 <= N <= 9). $1 à $9
+ permettent d'accéder aux parties regroupées (entre
+ parenthèses) du modèle, issues de la <code>RewriteRule</code>
+ concernée par le jeu de conditions <code>RewriteCond</code>
+ courant. $0 donne accès à l'ensemble de la chaîne
+ correspondant au modèle.</li>
<li>
- <strong>RewriteCond backreferences</strong>: These are
- backreferences of the form <strong><code>%N</code></strong>
- (0 <= N <= 9). %1 to %9 provide access to the grouped
- parts (again, in parentheses) of the pattern, from the last matched
- <code>RewriteCond</code> in the current set
- of conditions. %0 provides access to the whole string matched by
- that pattern.
- </li>
+ <strong>Références arrières de condition de réécriture
+ </strong> : ce sont des références arrières de la forme
+ <strong><code>%N</code></strong> (0 <= N <= 9). %1 à %9
+ permettent d'accéder aux parties regroupées (entre
+ parenthèses) du modèle, issues de la dernière
+ condition <code>RewriteCond</code> satisfaite du jeu de conditions <code>RewriteCond</code>
+ courant. %0 donne accès à l'ensemble de la chaîne
+ correspondant au modèle.</li>
<li>
- <strong>RewriteMap expansions</strong>: These are
- expansions of the form <strong><code>${mapname:key|default}</code></strong>.
- See <a href="#mapfunc">the documentation for
- RewriteMap</a> for more details.
+ <strong>extensions de table de réécriture</strong> :
+ ce sont des extensions de la forme <strong><code>${nomTable:clé|défaut}</code></strong>. Voir la <a>href="#mapfunc">documentation sur RewriteMap</a>
+ pour plus de détails.
</li>
<li>
- <strong>Server-Variables</strong>: These are variables of
- the form
- <strong><code>%{</code> <em>NAME_OF_VARIABLE</em>
- <code>}</code></strong>
- where <em>NAME_OF_VARIABLE</em> can be a string taken
- from the following list:
+ <strong>Variables du serveur</strong> :
+ ce sont des variables de la forme
+ <strong><code>%{</code> <em>NAME_OF_VARIABLE</em> <code>}</code></strong>,
+ où <em>NOM_DE_VARIABLE</em> peut contenir une chaîne issue
+ de la liste suivante :
<table>
<tr>
- <th>HTTP headers:</th> <th>connection & request:</th> <th />
- </tr>
+ <th>En-têtes HTTP :</th> <th>connexion & requête:</th> <th />
+ </tr>
<tr>
- <td>
- HTTP_ACCEPT<br />
+ <td>
+ HTTP_ACCEPT<br />
HTTP_COOKIE<br />
HTTP_FORWARDED<br />
HTTP_HOST<br />
<td>
AUTH_TYPE<br />
- CONN_REMOTE_ADDR<br />
- CONTEXT_PREFIX<br />
+ CONN_REMOTE_ADDR<br />
+ CONTEXT_PREFIX<br />
CONTEXT_DOCUMENT_ROOT<br />
IPV6<br />
PATH_INFO<br />
QUERY_STRING<br />
REMOTE_ADDR<br />
REMOTE_HOST<br />
- REMOTE_IDENT<br />
+ REMOTE_IDENT<br />
REMOTE_PORT<br />
REMOTE_USER<br />
REQUEST_METHOD<br />
SCRIPT_FILENAME<br />
</td>
- <td />
+ <td />
</tr>
<tr>
- <th>server internals:</th> <th>date and time:</th> <th>specials:</th>
- </tr>
+ <th>variables internes au serveur :</th> <th>date et heure :</th> <th>spéciaux :</th>
+ </tr>
<tr>
- <td>
- DOCUMENT_ROOT<br />
- SCRIPT_GROUP<br />
+ <td>
+ DOCUMENT_ROOT<br />
+ SCRIPT_GROUP<br />
SCRIPT_USER<br />
SERVER_ADDR<br />
SERVER_ADMIN<br />
<td>
API_VERSION<br />
- CONN_REMOTE_ADDR<br />
+ CONN_REMOTE_ADDR<br />
HTTPS<br />
- IS_SUBREQ<br />
- REMOTE_ADDR<br />
+ IS_SUBREQ<br />
+ REMOTE_ADDR<br />
REQUEST_FILENAME<br />
REQUEST_SCHEME<br />
REQUEST_URI<br />
</tr>
</table>
- <p>These variables all
- correspond to the similarly named HTTP
- MIME-headers, C variables of the Apache HTTP Server or
- <code>struct tm</code> fields of the Unix system.
- Most are documented <a href="../expr.html#vars">here</a>
- or elsewhere in the Manual or in the CGI specification.</p>
+ <p>Ces variables correspondent toutes aux en-têtes MIME
+ HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
+ aux champs <code>struct tm</code> du système Unix. La
+ plupart d'entre elles sont documentées <a href="../expr.html#vars">ici</a>, dans la
+ spécification CGI ou ailleurs dans le
+ manuel.</p>
- <p>SERVER_NAME and SERVER_PORT depend on the values of
- <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
- <code class="directive"><a href="../mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
- respectively.</p>
+ <p>SERVER_NAME et SERVER_PORT dépendent respectivement
+ des valeurs des directives <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> et <code class="directive"><a href="../mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>.</p>
- <p>Those that are special to mod_rewrite include those below.</p>
+ <p>Parmi les variables
+ spécifiques à mod_rewrite, ou trouve les suivantes :</p>
+
<dl>
<dt><code>API_VERSION</code></dt>
- <dd>This is the version of the Apache httpd module API
- (the internal interface between server and
- module) in the current httpd build, as defined in
- include/ap_mmn.h. The module API version
- corresponds to the version of Apache httpd in use (in
- the release version of Apache httpd 1.3.14, for
- instance, it is 19990320:10), but is mainly of
- interest to module authors.</dd>
+ <dd>C'est la version de l'API des modules Apache httpd
+ (l'interface interne entre le serveur et les modules)
+ pour la construction courante de httpd, telle qu'elle
+ est définie dans include/ap_mmn.h. La version de l'API
+ des modules correspond à la version du serveur Apache
+ httpd
+ utilisé (par exemple, pour la version 1.3.14 d'Apache
+ httpd,
+ il s'agit de la version 19990320:10), mais intéresse
+ principalement les auteurs de modules.</dd>
<dt><code>CONN_REMOTE_ADDR</code></dt>
- <dd>Since 2.4.8: The peer IP address of the connection (see the
- <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module).</dd>
-
- <dt><code>HTTPS</code></dt>
+ <dd>A partir de la version 2.4.8 : l'adresse IP distante de
+ la connexion (voir le module
+ <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>).</dd>
- <dd>Will contain the text "on" if the connection is
- using SSL/TLS, or "off" otherwise. (This variable
- can be safely used regardless of whether or not
- <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is loaded).</dd>
+ <dt><code>HTTPS</code></dt>
- <dt><code>IS_SUBREQ</code></dt>
+ <dd>Contient le texte "on" si la connexion
+ utilise SSL/TLS, "off" dans le cas contraire
+ (Cette variable peut être utilisée sans problème, que
+ <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> soit chargé ou non).</dd>
- <dd>Will contain the text "true" if the request
- currently being processed is a sub-request,
- "false" otherwise. Sub-requests may be generated
- by modules that need to resolve additional files
- or URIs in order to complete their tasks.</dd>
+ <dt><code>IS_SUBREQ</code></dt>
- <dt><code>REMOTE_ADDR</code></dt>
+ <dd>Contient le texte "true" si la requête en cours
+ de traitement est une sous-requête, "false" dans le
+ cas contraire. Une sous-requête est générée quand un
+ module a besoin de se référer à des fichiers ou URIs
+ addidionnels pour pouvoir mener à bien sa tâche.</dd>
- <dd>The IP address of the remote host (see the
- <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module).</dd>
+ <dt><code>REMOTE_ADDR</code></dt>
+ <dd>L'adresse IP de l'hôte distant (se référer au
+ module <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>).</dd>
<dt><code>REQUEST_FILENAME</code></dt>
- <dd>The full local filesystem path to the file or
- script matching the request, if this has already
- been determined by the server at the time
- <code>REQUEST_FILENAME</code> is referenced. Otherwise,
- such as when used in virtual host context, the same
- value as <code>REQUEST_URI</code>. Depending on the value of
- <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code>, the
- server may have only used some leading components of the
- <code>REQUEST_URI</code> to map the request to a file.
- </dd>
+ <dd>Le chemin complet local au système de fichiers
+ du fichier ou du script correspondant
+ à la requête, s'il a déjà été déterminé par le serveur
+ au moment où on y fait référence. Dans le cas
+ contraire, et en particulier dans le cas d'un serveur
+ virtuel, <code>REQUEST_FILENAME</code> contient la
+ valeur de <code>REQUEST_URI</code>. En fonction de la
+ valeur de la directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code>, le serveur
+ peut n'utiliser que certains éléments de tête du
+ <code>REQUEST_URI</code> pour déterminer à quel
+ fichier correspond la requête.</dd>
- <dt><code>REQUEST_SCHEME</code></dt>
+ <dt><code>REQUEST_SCHEME</code></dt>
- <dd>Will contain the scheme of the request (usually
- "http" or "https"). This value can be influenced with
- <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</dd>
+ <dd>Contient le protocole de la requête (en général
+ "http" ou "https"). La valeur peut être modifiée par
+
la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</dd>
- <dt><code>REQUEST_URI</code></dt>
+ <dt><code>REQUEST_URI</code></dt>
- <dd>The path component of the requested URI,
- such as "/index.html". This notably excludes the
- query string which is available as its own variable
- named <code>QUERY_STRING</code>.</dd>
+ <dd>La partie chemin de l'URI de la requête, comme
+ "/index.html". Ceci exclut en particulier la chaîne de
+ paramètres de la requête qui est contenue dans la
+ variable <code>QUERY_STRING</code>.</dd>
<dt><code>THE_REQUEST</code></dt>
- <dd>The full HTTP request line sent by the
- browser to the server (e.g., "<code>GET
- /index.html HTTP/1.1</code>"). This does not
- include any additional headers sent by the
- browser. This value has not been unescaped
- (decoded), unlike most other variables below.</dd>
-
+ <dd>La ligne de requête HTTP complète envoyée par le
+ navigateur au serveur (par exemple, "<code>GET
+ /index.html HTTP/1.1</code>"), à l'exclusion de tout
+ en-tête ajouté par le navigateur. Cette
+ valeur n'a pas été déséchappée (décodée), à la
+ différence de la plupart des variables suivantes.</dd>
</dl>
+
</li>
</ul>
- <p>If the <em>TestString</em> has the special value <code>expr</code>,
- the <em>CondPattern</em> will be treated as an
- <a href="../expr.html">ap_expr</a>. HTTP headers referenced in the
- expression will be added to the Vary header if the <code>novary</code>
- flag is not given.</p>
-
- <p>Other things you should be aware of:</p>
+ <p>Si la <em>chaîne_de_test</em> contient la valeur spéciale
+ <code>expr</code>, <em>expression_de_comparaison</em> sera traité
+ en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>. Si des en-têtes HTTP sont
+ référencés dans l'expression rationnelle, et si le drapeau
+ <code>novary</code> n'est pas activé, ils seront ajoutés à
+ l'en-tête Vary.</p>
+ <p>Autres points à connaître ::</p>
<ol>
<li>
- <p>The variables SCRIPT_FILENAME and REQUEST_FILENAME
- contain the same value - the value of the
- <code>filename</code> field of the internal
- <code>request_rec</code> structure of the Apache HTTP Server.
- The first name is the commonly known CGI variable name
- while the second is the appropriate counterpart of
- REQUEST_URI (which contains the value of the
- <code>uri</code> field of <code>request_rec</code>).</p>
- <p>If a substitution occurred and the rewriting continues,
- the value of both variables will be updated accordingly.</p>
- <p>If used in per-server context (<em>i.e.</em>, before the
- request is mapped to the filesystem) SCRIPT_FILENAME and
- REQUEST_FILENAME cannot contain the full local filesystem
- path since the path is unknown at this stage of processing.
- Both variables will initially contain the value of REQUEST_URI
- in that case. In order to obtain the full local filesystem
- path of the request in per-server context, use an URL-based
- look-ahead <code>%{LA-U:REQUEST_FILENAME}</code> to determine
- the final value of REQUEST_FILENAME.</p></li>
+ <p>Les variables <code>SCRIPT_FILENAME</code> et
+ <code>REQUEST_FILENAME</code> contiennent toutes deux la valeur
+ du champ <code>filename</code> de la
+ structure interne <code>request_rec</code>du serveur HTTP Apache.
+ Le premier nom correspond au nom de variable bien connu CGI,
+ alors que le second est l'équivalent de REQUEST_URI (qui
+ contient la valeur du champ <code>uri</code> de
+ <code>request_rec</code>).</p>
+ <p>Si une substitution intervient et si la réécriture se
+ poursuit, la valeur des deux variables sera mise à jour en
+ conséquence.</p>
+ <p>Dans le contexte du serveur principal (c'est à dire avant que
+ la requête ne soit mise en correspondance avec le système de
+ fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
+ contenir le chemin entier dans le système de fichiers local car
+ ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
+ les deux variables contiendront la valeur de REQUEST_URI. Pour
+ obtenir le chemin complet de la requête dans le système de
+ fichiers local dans le contexte du serveur principal, utilisez une
+ référence avant à base d'URL
+ <code>%{LA-U:REQUEST_FILENAME}</code> pour déterminer la valeur
+ finale de REQUEST_FILENAME.</p></li>
- <li>
- <code>%{ENV:variable}</code>, where <em>variable</em> can be
- any environment variable, is also available.
- This is looked-up via internal
- Apache httpd structures and (if not found there) via
- <code>getenv()</code> from the Apache httpd server process.</li>
<li>
- <code>%{SSL:variable}</code>, where <em>variable</em> is the
- name of an <a href="mod_ssl.html#envvars">SSL environment
- variable</a>, can be used whether or not
- <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is loaded, but will always expand to
- the empty string if it is not. Example:
- <code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> may expand to
- <code>128</code>. These variables are available even without
- setting the <code>StdEnvVars</code> option of the
- <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code> directive.</li>
+ <code>%{ENV:<em>variable</em>}</code>, où <em>variable</em> peut
+ correspondre à une variable d'environnement quelconque.</li>
+ <li>
+ <code>%{ENV:variable}</code> est aussi disponible, où
+ <em>variable</em> peut correspondre à toute variable
+ d'environnement. Peut être consulté via des structures internes
+ d'Apache httpd et (si on ne les trouve pas ici) via la fonction
+ <code>getenv()</code> à partir du processus du serveur Apache
+ httpd.</li>
+
+ <li>Que <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> soit chargé ou non, on peut
+ utiliser <code>%{SSL:variable}</code>, où <em>variable</em>
+ peut être remplacé par le nom d'une
+ <a href="mod_ssl.html#envvars">variable
+ d'environnement SSL</a> . Si <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> n'est pas
+ chargé, cette variable contiendra toujours une chaîne vide.
+ Exemple : <code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> pourra
+ contenir la valeur <code>128</code>. Ces variables sont
+ disponibles même si l'option <code>StdEnvVars</code> de la
+ directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code> n'a
+ pas été définie.</li>
+
+ <li>
+ On peut utiliser <code>%{HTTP:en-tête}</code>, où
+ <em>en-tête</em> peut correspondre à tout nom d'en-tête MIME
+ HTTP, pour extraire la valeur d'un en-tête envoyé dans la
+ requête HTTP. Par exemple, <code>%{HTTP:Proxy-Connection}</code>
+ contiendra la valeur de l'en-tête HTTP
+ "<code>Proxy-Connection:</code>".
+ Si on utilise un en-tête HTTP
+ dans une condition, et si cette condition est évaluée à
+ <code>vrai</code> pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
+ la réponse. Il ne le sera pas si la condition est évaluée à
+ <code>faux</code>. L'ajout de l'en-tête HTTP à l'en-tête Vary
+ est nécessaire à une mise en cache appropriée.
+ <p>Il faut garder à l'esprit que les conditions suivent une
+ logique de cout-circuit si le drapeau
+ '<strong><code>ornext|OR</code></strong>' est utilisé, et que de
+ ce fait, certaines d'entre elles ne seront pas évaluées.</p>
+ </li>
+
+ <li>A des fins de référence avant, on peut utiliser,
+ <a id="LA-U" name="LA-U"><code>%{LA-U:variable}</code></a>, qui
+ permet d'effectuer une sous-requête interne à base d'URL, afin
+ de déterminer la valeur finale de <em>variable</em>. Ceci permet
+ d'accéder à la valeur d'une variable pour la réécriture inconnue
+ à ce stade du traitement, mais qui sera définie au
+ cours d'une phase ultérieure.
+ <p>Par exemple, pour effectuer une réécriture dépendant de la
+ variable <code>REMOTE_USER</code> dans le contexte du serveur
+ principal (fichier <code>httpd.conf</code>), vous devez utiliser
+ <code>%{LA-U:REMOTE_USER}</code> - cette variable est définie
+ par la phase d'autorisation qui intervient <em>après</em> la
+ phase de traduction d'URL (pendant laquelle mod_rewrite opère).</p>
+ <p>Par contre, comme mod_rewrite implémente son contexte de
+ répertoire (fichier <code>.htaccess</code>) via la phase Fixup
+ de l'API, et comme la phase d'autorisation intervient
+ <em>avant</em> cette dernière, vous pouvez vous contenter
+ d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</p></li>
<li>
- <code>%{HTTP:header}</code>, where <em>header</em> can be
- any HTTP MIME-header name, can always be used to obtain the
- value of a header sent in the HTTP request.
- Example: <code>%{HTTP:Proxy-Connection}</code> is
- the value of the HTTP header
- ``<code>Proxy-Connection:</code>''.
- <p>If a HTTP header is used in a condition this header is added to
- the Vary header of the response in case the condition evaluates
- to true for the request. It is <strong>not</strong> added if the
- condition evaluates to false for the request. Adding the HTTP header
- to the Vary header of the response is needed for proper caching.</p>
- <p>It has to be kept in mind that conditions follow a short circuit
- logic in the case of the '<strong><code>ornext|OR</code></strong>' flag
- so that certain conditions might not be evaluated at all.</p></li>
-
- <li>
- <a id="LA-U" name="LA-U"><code>%{LA-U:variable}</code></a>
- can be used for look-aheads which perform
- an internal (URL-based) sub-request to determine the final
- value of <em>variable</em>. This can be used to access
- variable for rewriting which is not available at the current
- stage, but will be set in a later phase.
- <p>For instance, to rewrite according to the
- <code>REMOTE_USER</code> variable from within the
- per-server context (<code>httpd.conf</code> file) you must
- use <code>%{LA-U:REMOTE_USER}</code> - this
- variable is set by the authorization phases, which come
- <em>after</em> the URL translation phase (during which mod_rewrite
- operates).</p>
- <p>On the other hand, because mod_rewrite implements
- its per-directory context (<code>.htaccess</code> file) via
- the Fixup phase of the API and because the authorization
- phases come <em>before</em> this phase, you just can use
- <code>%{REMOTE_USER}</code> in that context.</p></li>
-
- <li>
- <code>%{LA-F:variable}</code> can be used to perform an internal
- (filename-based) sub-request, to determine the final value
- of <em>variable</em>. Most of the time, this is the same as
- LA-U above.</li>
+ <code>%{LA-F:variable}</code> peut être utilisée pour effectuer
+ une sous-requête interne (basée sur le nom de fichier), afin de
+ déterminer la valeur finale de <em>variable</em>. La plupart du
+ temps, elle est identique à LA-U (voir ci-dessus).</li>
</ol>
- <p><em>CondPattern</em> is the condition pattern,
- a regular expression which is applied to the
- current instance of the <em>TestString</em>.
- <em>TestString</em> is first evaluated, before being matched against
- <em>CondPattern</em>.</p>
- <p><em>CondPattern</em> is usually a
- <em>perl compatible regular expression</em>, but there is
- additional syntax available to perform other useful tests against
- the <em>Teststring</em>:</p>
+ <p><em>expression_de_comparaison</em> est une expression
+ rationnelle qui est appliquée à l'instance actuelle de
+ <em>chaîne_de_test</em>. <em>chaîne_de_test</em> est d'abord
+ évaluée, puis comparée à
+ l'<em>expression_de_comparaison</em>.</p>
- <ol>
- <li>You can prefix the pattern string with a
- '<code>!</code>' character (exclamation mark) to negate the result
- of the condition, no matter what kind of <em>CondPattern</em> is used.
- </li>
-
- <li>
- You can perform lexicographical string comparisons:
+ <p><em>expression_de_comparaison</em> est en général une
+ <em>expression rationnelle compatible perl</em>, mais vous
+ disposez des syntaxes supplémentaires suivantes pour effectuer
+ d'autres tests utiles sur <em>chaîne_de_test</em> :
+ </p>
- <dl>
- <dt><strong><CondPattern</strong></dt>
- <dd>Lexicographically precedes<br />
- Treats the <em>CondPattern</em> as a plain string and
- compares it lexicographically to <em>TestString</em>. True if
- <em>TestString</em> lexicographically precedes
- <em>CondPattern</em>.</dd>
-
- <dt><strong>>CondPattern</strong></dt>
- <dd>Lexicographically follows<br />
- Treats the <em>CondPattern</em> as a plain string and
- compares it lexicographically to <em>TestString</em>. True if
- <em>TestString</em> lexicographically follows
- <em>CondPattern</em>.</dd>
-
- <dt><strong>=CondPattern</strong></dt>
- <dd>Lexicographically equal<br />
- Treats the <em>CondPattern</em> as a plain string and
- compares it lexicographically to <em>TestString</em>. True if
- <em>TestString</em> is lexicographically equal to
- <em>CondPattern</em> (the two strings are exactly
- equal, character for character). If <em>CondPattern</em>
- is <code>""</code> (two quotation marks) this
- compares <em>TestString</em> to the empty string.</dd>
-
- <dt><strong><=CondPattern</strong></dt>
- <dd>Lexicographically less than or equal to<br />
- Treats the <em>CondPattern</em> as a plain string and
- compares it lexicographically to <em>TestString</em>. True
- if <em>TestString</em> lexicographically precedes
- <em>CondPattern</em>, or is equal to <em>CondPattern</em>
- (the two strings are equal, character for character).</dd>
-
- <dt><strong>>=CondPattern</strong></dt>
- <dd>Lexicographically greater than or equal to<br />
- Treats the <em>CondPattern</em> as a plain string and
- compares it lexicographically to <em>TestString</em>. True
- if <em>TestString</em> lexicographically follows
- <em>CondPattern</em>, or is equal to <em>CondPattern</em>
- (the two strings are equal, character for character).</dd>
+ <ol>
+ <li>Vous pouvez préfixer l'expression avec un caractère
+ '<code>!</code>' (point d'exclamation) pour inverser le résultat
+ de la condition, quelle que soit l'<em>expression de
+ comparaison</em> utilisée.</li>
+
+ <li>Vous pouvez effectuer des comparaisons lexicographiques de
+ chaînes :
+
+ <dl>
+ <dt><strong><expression</strong></dt>
+ <dd>inférieur au sens lexicographique<br />
+ Traite l'<em>expression</em> comme une chaîne de
+ caractères et la compare lexicographiquement à
+ <em>chaîne_de_test</em>. La condition est satisfaite si
+ <em>chaîne_de_test</em> est inférieure au sens
+ lexicographique à l'<em>expression</em>.</dd>
+
+ <dt><strong>>expression</strong></dt>
+ <dd>supérieur au sens lexicographique<br />
+ Traite l'<em>expression</em> comme une chaîne de
+ caractères et la compare lexicographiquement à
+ <em>chaîne_de_test</em>. La condition est satisfaite si
+ <em>chaîne_de_test</em> est supérieure au sens
+ lexicographique à l'<em>expression</em>.</dd>
+
+ <dt><strong>=expression</strong></dt>
+ <dd>égal au sens lexicographique<br />
+ Traite l'<em>expression</em> comme une chaîne de
+ caractères et la compare lexicographiquement à
+ <em>chaîne_de_test</em>. La condition est satisfaite si
+ <em>chaîne_de_test</em> est égale au sens
+ lexicographique à l'<em>expression</em> (les deux chaînes
+ sont exactement identiques, caractère pour caractère). Si
+ <em>expression</em> est <code>""</code> (deux guillemets),
+ <em>chaîne_de_test</em> est comparée à la
+ chaîne vide.</dd>
+
+ <dt><strong><=expression de comparaison</strong></dt>
+ <dd>inférieur ou égal à au sens lexicographique<br />
+ Considère l'<em>expression_de_comparaison</em> comme une
+ chaîne de caractères et la compare au sens lexicographique à
+ la <em>chaîne_de_test</em>. Vrai si <em>chaîne_de_test</em>
+ précède lexicographiquement <em>expression_de_comparaison</em>, ou est
+ égale à <em>expression_de_comparaison</em> (les deux chaînes
+ sont identiques, caractère pour caractère).</dd>
+
+ <dt><strong>>=expression de comparaison</strong></dt>
+ <dd>supérieur ou égal à au sens lexicographique<br />
+ Considère l'<em>expression_de_comparaison</em> comme une
+ chaîne de caractères et la compare au sens lexicographique à
+ la <em>chaîne_de_test</em>. Vrai si <em>chaîne_de_test</em>
+ suit lexicographiquement <em>expression_de_comparaison</em>, ou est
+ égale à <em>expression_de_comparaison</em> (les deux chaînes
+ sont identiques, caractère pour caractère).</dd>
</dl>
- </li>
+ </li>
<li>
- You can perform integer comparisons:
+ Vous pouvez effectuer des comparaisons d'entiers :
<dl>
<dt><strong>-eq</strong></dt>
- <dd>Is numerically <strong>eq</strong>ual to<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the two are numerically equal.</dd>
+ <dd>est numériquement égal à<br />
+ La <em>chaîne_de_test</em> est considérée comme un entier,
+ et est comparée numériquement à l'<em>expression de
+ comparaison</em>. Vrai si les deux expressions sont
+ numériquement égales.</dd>
<dt><strong>-ge</strong></dt>
- <dd>Is numerically <strong>g</strong>reater than or <strong>e</strong>qual to<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the <em>TestString</em> is numerically greater than or equal
- to the <em>CondPattern</em>.</dd>
-
- <dt><strong>-gt</strong></dt>
- <dd>Is numerically <strong>g</strong>reater <strong>t</strong>han<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the <em>TestString</em> is numerically greater than
- the <em>CondPattern</em>.</dd>
+ <dd>est numériquement supérieur ou égal à<br />
+ La <em>chaîne_de_test</em> est considérée comme un entier,
+ et est comparée numériquement à l'<em>expression de
+ comparaison</em>. Vrai si <em>chaîne_de_test</em> est
+ numériquement supérieure ou égale à
+ <em>expression_de_comparaison</em>.</dd>
+
+ <dt><strong>-gt</strong></dt>
+ <dd>est numériquement supérieur à<br />
+ La <em>chaîne_de_test</em> est considérée comme un entier,
+ et est comparée numériquement à l'<em>expression de
+ comparaison</em>. Vrai si <em>chaîne_de_test</em> est
+ numériquement
+ supérieure à <em>expression_de_comparaison</em>.</dd>
<dt><strong>-le</strong></dt>
- <dd>Is numerically <strong>l</strong>ess than or <strong>e</strong>qual to<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the <em>TestString</em> is numerically less than or equal
- to the <em>CondPattern</em>. Avoid confusion with the
- <strong>-l</strong> by using the <strong>-L</strong> or
- <strong>-h</strong> variant.</dd>
-
- <dt><strong>-lt</strong></dt>
- <dd>Is numerically <strong>l</strong>ess <strong>t</strong>han<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the <em>TestString</em> is numerically less than
- the <em>CondPattern</em>. Avoid confusion with the
- <strong>-l</strong> by using the <strong>-L</strong> or
- <strong>-h</strong> variant.</dd>
+ <dd>est numériquement inférieur ou égal à<br />
+ La <em>chaîne_de_test</em> est considérée comme un entier,
+ et est comparée numériquement à l'<em>expression de
+ comparaison</em>. Vrai si <em>chaîne_de_test</em> est
+ numériquement
+ inférieure ou égale à <em>expression_de_comparaison</em>.
+ Attention à la confusion avec le drapeau <strong>-l</strong>
+ en utilisant la variante the <strong>-L</strong> ou
+ <strong>-h</strong>.</dd>
+
+ <dt><strong>-lt</strong></dt>
+ <dd>est numériquement inférieur à<br />
+ La <em>chaîne_de_test</em> est considérée comme un entier,
+ et est comparée numériquement à l'<em>expression de
+ comparaison</em>. Vrai si <em>chaîne_de_test</em> est
+ numériquement
+ inférieure à <em>expression_de_comparaison</em>.
+ Attention à la confusion avec le drapeau <strong>-l</strong>
+ en utilisant la variante the <strong>-L</strong> ou
+ <strong>-h</strong>.</dd>
<dt><strong>-ne</strong></dt>
- <dd>Is numerically <strong>n</strong>ot <strong>e</strong>qual to<br />
- The <em>TestString</em> is treated as an integer, and is
- numerically compared to the <em>CondPattern</em>. True if
- the two are numerically different. This is equivalent to
- <code>!-eq</code>.</dd>
+ <dd>Est numériquement <strong>n</strong>on <strong>é</strong>gal à<br />
+ La <em>Chaîne de test</em> est considérée comme un entier et est
+ numériquement comparée à l'<em>expression de comparaison</em>. Vrai
+ si les deux éléments comparés sont numériquement différents.
+ Equivalent à <code>!-eq</code>.</dd>
</dl>
</li>
- <li>You can perform various file attribute tests:
-
-
+ <li>Vous pouvez effectuer différents tests sur les attributs de
+ fichier :
<dl>
- <dt><strong>-d</strong></dt>
-
- <dd>Is <strong>d</strong>irectory.<br />
- Treats the <em>TestString</em> as a pathname and tests
- whether or not it exists, and is a directory.
- </dd>
-
- <dt><strong>-f</strong></dt>
-
- <dd>Is regular <strong>f</strong>ile.<br />
-
- Treats the <em>TestString</em> as a pathname and tests
- whether or not it exists, and is a regular file.
- </dd>
-
- <dt><strong>-F</strong></dt>
-
- <dd>Is existing file, via subrequest.<br />
- Checks whether or not <em>TestString</em> is a valid file,
- accessible via all the server's currently-configured
- access controls for that path. This uses an internal
- subrequest to do the check, so use it with care -
- it can impact your server's performance!
- </dd>
-
- <dt><strong>-h</strong></dt>
- <dd>Is symbolic link, bash convention.<br />
- See <strong>-l</strong>.
- </dd>
+ <dt><strong>-d</strong></dt>
+ <dd>est un <strong>r</strong>épertoire<br />
+ Traite <em>chaîne_de_test</em> comme un chemin et vérifie
+ s'il existe ou pas, et s'il s'agit d'un répertoire.</dd>
+
+ <dt><strong>-f</strong></dt>
+ <dd>est un <strong>f</strong>ichier régulier<br />
+ Traite <em>chaîne_de_test</em> comme un chemin et vérifie
+ s'il existe ou pas, et s'il s'agit d'un fichier régulier.</dd>
+
+ <dt><strong>-F</strong></dt>
+ <dd>test de l'existence d'un fichier via une sous-requête<br />
+ Vérifie si <em>chaîne_de_test</em> est un fichier valide,
+ accessible à travers tous les contrôles d'accès du serveur
+ actuellement configurés pour ce chemin. C'est une
+ sous-requête interne qui effectue cette vérification - à
+ utiliser avec précautions car les performances du serveur
+ peuvent s'en trouver affectées !</dd>
+
+ <dt><strong>-h</strong></dt>
+ <dd>est un lien symbolique, selon la convention bash<br />
+ Voir <strong>-l</strong>.</dd>
<dt><strong>-l</strong></dt>
-
- <dd>Is symbolic <strong>l</strong>ink.<br />
- Treats the <em>TestString</em> as a pathname and tests
- whether or not it exists, and is a symbolic link. May also
- use the bash convention of <strong>-L</strong> or
- <strong>-h</strong> if there's a possibility of confusion
- such as when using the <strong>-lt</strong> or
- <strong>-le</strong> tests.
- </dd>
+ <dd>est un <strong>l</strong>ien symbolique<br />
+ Considère la <em>chaîne_de_test</em> comme un chemin et
+ vérifie son existence et si elle est un lien symbolique. On
+ peut aussi utiliser la convention bash <strong>-L</strong>
+ ou <strong>-h</strong> lorsqu'il y a risque de confusion
+ avec les tests <strong>-lt</strong> ou <strong>-le</strong>.</dd>
<dt><strong>-L</strong></dt>
- <dd>Is symbolic link, bash convention.<br />
- See <strong>-l</strong>.</dd>
+ <dd>est un lien symbolique, selon la convention bash<br />
+ Voir <strong>-l</strong>.</dd>
<dt><strong>-s</strong></dt>
- <dd>Is regular file, with <strong>s</strong>ize.<br />
- Treats the <em>TestString</em> as a pathname and tests
- whether or not it exists, and is a regular file with size greater
- than zero.</dd>
+ <dd>est un fichier régulier d'une certaine taille<br />
+ Considère la <em>chaîne_de_test</em> comme un chemin et
+ vérifie son existence et si elle est un fichier régulier
+ d'une taille supérieure à zéro.</dd>
<dt><strong>-U</strong></dt>
- <dd><p>Is existing URL, via subrequest.<br />
- Checks whether or not <em>TestString</em> is a valid URL,
- accessible via all the server's currently-configured
- access controls for that path. This uses an internal
- subrequest to do the check, so use it with care -
- it can impact your server's performance!</p>
- <p> This flag <em>only</em> returns information about things
- like access control, authentication, and authorization. This flag
- <em>does not</em> return information about the status code the
- configured handler (static file, CGI, proxy, etc.) would have
- returned.</p> </dd>
-
- <dt><strong>-x</strong></dt>
- <dd>Has e<strong>x</strong>ecutable permissions.<br />
- Treats the <em>TestString</em> as a pathname and tests
- whether or not it exists, and has executable permissions.
- These permissions are determined according to
- the underlying OS.</dd>
-
- </dl>
-
- For example:
+ <dd><p>test de l'existence d'une
+ URL via une sous-requête<br />
+ Vérifie si <em>chaîne_de_test</em> est une URL valide,
+ accessible à travers tous les contrôles d'accès du serveur
+ actuellement configurés pour ce chemin. C'est une
+ sous-requête interne qui effectue cette vérification - à
+ utiliser avec précautions car les performances du serveur
+ peuvent s'en trouver affectées !</p>
+ <p>Ce drapeau ne renvoie <em>que</em> des informations
+ concernant le contrôle d'accès, l'authentification et
+ l'autorisation. Il ne renvoie <em>pas</em> d'informations
+ concernant le code d'état que le gestionnaire configuré
+ (static file, CGI, proxy, etc...) aurait, quant à lui,
+ retourné.</p></dd>
+
+ <dt><strong>-x</strong></dt>
+ <dd>a l'attribut d'exécution positionné<br />
+ Considère la <em>chaîne_de_test</em> comme un chemin et
+ vérifie son existence et si elle a son attribut d'exécution
+ positionné. Ce positionnement est déterminé en fonction de
+ l'OS sous-jacent.</dd>
+
+ </dl>
+
+ Par exemple:
<pre class="prettyprint lang-config">RewriteCond /var/www/%{REQUEST_URI} !-f
RewriteRule ^(.+) /other/archive/$1 [R]</pre>
</li>
- <li>
- <p>If the <em>TestString</em> has the special value <code>expr</code>, the
- <em>CondPattern</em> will be treated as an
- <a href="../expr.html">ap_expr</a>.</p>
-
- <p>
- In the below example, <code>-strmatch</code> is used to
- compare the <code>REFERER</code> against the site hostname,
- to block unwanted hotlinking.
+ <li>
+ <p>Si la <em>chaîne_de_test</em> contient la valeur spéciale
+ <code>expr</code>, la <em>chaîne de comparaison</em> sera
+ traitée en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>.</p>
+
+ <p>
+ Dans l'exemple ci-dessous, on utilise <code>-strmatch</code>
+ pour comparer le <code>REFERER</code> avec le nom d'hôte du
+ site afin de bloquer le hotlinking (référencement direct)
+ non désiré.
</p>
- <pre class="prettyprint lang-config">RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
-RewriteRule "^/images" "-" [F]</pre>
+ <pre class="prettyprint lang-config"> RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
+ RewriteRule "^/images" "-" [F]</pre>
</li>
- </ol>
+ </ol>
+
+ <p>Vous pouvez aussi définir certains drapeaux pour
+ l'<em>expression_de_comparaison</em> en ajoutant ces
+ <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
+ comme troisième argument de la directive
+ <code>RewriteCond</code>, où <em>drapeaux</em> est un
+ sous-ensemble séparé par des virgules des drapeaux suivants :</p>
- <p>You can also set special flags for <em>CondPattern</em> by appending
- <strong><code>[</code><em>flags</em><code>]</code></strong>
- as the third argument to the <code>RewriteCond</code>
- directive, where <em>flags</em> is a comma-separated list of any of the
- following flags:</p>
-
<ul>
<li>'<strong><code>nocase|NC</code></strong>'
- (<strong>n</strong>o <strong>c</strong>ase)<br />
- This makes the test case-insensitive - differences
- between 'A-Z' and 'a-z' are ignored, both in the
- expanded <em>TestString</em> and the <em>CondPattern</em>.
- This flag is effective only for comparisons between
- <em>TestString</em> and <em>CondPattern</em>. It has no
- effect on filesystem and subrequest checks.</li>
+ (<strong>n</strong>o <strong>c</strong>ase)<br />
+ Rend le test insensible à la casse - il n'est pas fait de
+ distinction entre majuscules et minuscules, à la fois dans le
+ développement de <em>chaîne_de_test</em> et dans
+ <em>expression_de_comparaison</em>. Ce drapeau n'est pris en
+ compte que lors d'une comparaison entre <em>chaîne_de_test</em>
+ et <em>expression_de_comparaison</em>. Il ne l'est pas pour les
+ vérification par sous-requêtes ou sur le système de
+ fichiers.</li>
<li>
'<strong><code>ornext|OR</code></strong>'
- (<strong>or</strong> next condition)<br />
- Use this to combine rule conditions with a local OR
- instead of the implicit AND. Typical example:
+ (<strong>ou</strong> condition suivante)<br />
+ Permet de chaîner les conditions de règles avec un OU au
+ lieu du AND implicite. Exemple typique :
<pre class="prettyprint lang-config">RewriteCond "%{REMOTE_HOST}" "^host1" [OR]
RewriteCond "%{REMOTE_HOST}" "^host2" [OR]
RewriteCond "%{REMOTE_HOST}" "^host3"
-RewriteRule ...some special stuff for any of these hosts...</pre>
+RewriteRule ...règles concernant tous ces hôtes...</pre>
- Without this flag you would have to write the condition/rule
- pair three times.
+ Sans ce drapeau, les paires
+ condition/règle devraient être écrites trois fois.
</li>
<li>'<strong><code>novary|NV</code></strong>'
- (<strong>n</strong>o <strong>v</strong>ary)<br />
- If a HTTP header is used in the condition, this flag prevents
- this header from being added to the Vary header of the response. <br />
- Using this flag might break proper caching of the response if
- the representation of this response varies on the value of this header.
- So this flag should be only used if the meaning of the Vary header
- is well understood.
+ (<strong>n</strong>o <strong>v</strong>ary)<br />
+ Si la condition contient un en-tête HTTP, ce drapeau empêche
+ ce dernier d'être ajouté à l'en-tête Vary de la réponse. <br />
+ L'utilisation de ce drapeau peut provoquer une mise en cache
+ incorrecte de la réponse, si la représentation de cette réponse
+ varie avec la valeur de l'en-tête considéré. Ce drapeau ne
+ devrait donc être utilisé que si l'on maîtrise parfaitement le
+ fonctionnement de l'en-tête Vary.
</li>
</ul>
+
- <p><strong>Example:</strong></p>
+ <p><strong>Exemple :</strong></p>
- <p>To rewrite the Homepage of a site according to the
- ``<code>User-Agent:</code>'' header of the request, you can
- use the following: </p>
+ <p>Pour réécrire la page d'accueil d'un site en fonction de
+ l'en-tête ``<code>User-Agent:</code>'' de la requête, vous
+ pouvez utiliser ce qui suit : </p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)"
-RewriteRule "^/$" "/homepage.mobile.html" [L]
+RewriteRule "^/$" "/homepage.mobile.html" [L]
-RewriteRule "^/$" "/homepage.std.html" [L]</pre>
+RewriteRule "^/$" "/homepage.std.html" [L]</pre>
- <p>Explanation: If you use a browser which identifies itself
- as a mobile browser (note that the example is incomplete, as
- there are many other mobile platforms), the mobile version of
- the homepage is served. Otherwise, the standard page is served.
- </p>
+ <p>Explications : si vous utilisez un navigateur
+ qui s'identifie comme un
+ navigateur de plateforme mobile (notez que l'exemple est
+ incomplet car il existe de nombreuses autres plateformes
+ mobiles), c'est la version pour mobile de la page d'accueil qui
+ sera renvoyée. Dans le cas contraire, ce sera la page d'accueil
+ standard.</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="rewriteengine" id="rewriteengine">Directive</a> <a name="RewriteEngine" id="RewriteEngine">RewriteEngine</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables or disables runtime rewriting engine</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive l'exécution du
+moteur de réécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteEngine on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>RewriteEngine 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#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteEngine</code> directive enables or
- disables the runtime rewriting engine. If it is set to
- <code>off</code> this module does no runtime processing at
- all. It does not even update the <code>SCRIPT_URx</code>
- environment variables.</p>
+ <p>La directive <code class="directive">RewriteEngine</code> active ou
+ désactive l'exécution du moteur de réécriture. Si sa valeur est
+ <code>off</code>, ce module n'exécutera aucun traitement et ne
+ mettra pas à jour les variables d'environnement
+ <code>SCRIPT_URx</code>.</p>
+
+ <p>Plutôt que de commenter toutes les directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code>, il est préférable
+ d'utiliser cette directive si l'on souhaite désactiver les
+ règles de réécriture dans un contexte particulier.</p>
- <p>Use this directive to disable rules in a particular context,
- rather than commenting out all the <code class="directive"><a href="#rewriterule">RewriteRule</a></code> directives.</p>
+ <p>Notez que les hôtes virtuels n'héritent pas des
+ configurations de réécriture. Ceci implique que vous devez
+ insérer une directive <code>RewriteEngine on</code> dans chaque
+ hôte virtuel pour lequel vous souhaitez utiliser des règles
+ de réécriture.</p>
- <p>Note that rewrite configurations are not
- inherited by virtual hosts. This means that you need to have a
- <code>RewriteEngine on</code> directive for each virtual host
- in which you wish to use rewrite rules.</p>
+ <p>Les directives <code class="directive"><a href="#rewritemap">RewriteMap</a></code> du type
+ <code>prg</code> ne sont pas prises en compte au cours de
+ l'initialisation du serveur si elle ont été définies dans un
+ contexte où la directive <code class="directive">RewriteEngine</code> n'a
+ pas été définie à <code>on</code>.</p>
- <p><code class="directive"><a href="#rewritemap">RewriteMap</a></code> directives
- of the type <code>prg</code>
- are not started during server initialization if they're defined in a
- context that does not have <code class="directive">RewriteEngine</code> set to
- <code>on</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="rewritemap" id="rewritemap">Directive</a> <a name="RewriteMap" id="RewriteMap">RewriteMap</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a mapping function for key-lookup</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>
- <em>MapTypeOptions</em>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une fonction de mise en correspondance pour la
+recherche de mots-clés</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> <em>MapTypeOptions</em>
</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteMap</code> directive defines a
- <em>Rewriting Map</em> which can be used inside rule
- substitution strings by the mapping-functions to
- insert/substitute fields through a key lookup. The source of
- this lookup can be of various types.</p>
-
- <p>The <a id="mapfunc" name="mapfunc"><em>MapName</em></a> is
- the name of the map and will be used to specify a
- mapping-function for the substitution strings of a rewriting
- rule via one of the following constructs:</p>
+ <p>La directive <code class="directive">RewriteMap</code> définit une
+ <em>Table de correspondance pour la réécriture</em> que les
+ fonctions de mise en correspondance
+ peuvent utiliser dans les chaînes de substitution des règles
+ pour insérer/substituer des champs en recherchant des mots-clés.
+ La source utilisée pour cette recherche peut être de plusieurs
+ types.</p>
+
+ <p><a id="mapfunc" name="mapfunc"><em>MapName</em></a> est le nom de la table de correspondance
+ et servira à spécifier une fonction de mise en correspondance
+ pour les chaînes de substitution d'une règle de réécriture selon
+ une des constructions suivantes :</p>
<p class="indent">
<strong><code>${</code> <em>MapName</em> <code>:</code>
- <em>LookupKey</em> <code>}</code><br />
+ <em>mot-clé</em> <code>}</code><br />
<code>${</code> <em>MapName</em> <code>:</code>
- <em>LookupKey</em> <code>|</code> <em>DefaultValue</em>
+ <em>mot-clé</em> <code>|</code> <em>valeur par défaut</em>
<code>}</code></strong>
</p>
- <p>When such a construct occurs, the map <em>MapName</em> is
- consulted and the key <em>LookupKey</em> is looked-up. If the
- key is found, the map-function construct is substituted by
- <em>SubstValue</em>. If the key is not found then it is
- substituted by <em>DefaultValue</em> or by the empty string
- if no <em>DefaultValue</em> was specified. Empty values
- behave as if the key was absent, therefore it is not possible
- to distinguish between empty-valued keys and absent keys.</p>
-
- <p>For example, you might define a
- <code class="directive">RewriteMap</code> as:</p>
+ <p>Lorsqu'une telle construction est rencontrée, la table de
+ correspondance <em>MapName</em> est consultée
+ et la clé <em>mot-clé</em> recherchée. Si la clé est trouvée, la
+ construction est remplacée par
+ la <em>valeur de remplacement</em>. Si la clé n'est pas trouvée,
+ elle est remplacée par la <em>valeur par défaut</em>, ou par une
+ chaîne vide si aucune <em>valeur par défaut</em> n'est
+ spécifiée. La valeur vide se comporte comme si la
+ clé était absente ; il est donc impossible de distinguer une
+ valeur vide d'une absence de clé.</p>
- <pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre>
+ <p>Par exemple, vous pouvez définir une directive
+ <code class="directive">RewriteMap</code> comme suit </p>
+ <pre class="prettyprint lang-config">RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"</pre>
- <p>You would then be able to use this map in a
- <code class="directive">RewriteRule</code> as follows:</p>
- <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre>
+ <p>Vous pourrez ensuite utiliser cette table dans une
+ directive <code class="directive">RewriteRule</code> comme suit :</p>
+ <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${map-exemple:$1}"</pre>
- <p>The meaning of the <em>MapTypeOptions</em> argument depends on
- particular <em>MapType</em>. See the
- <a href="../rewrite/rewritemap.html">Using RewriteMap</a> for
- more information.</p>
- <p>The following combinations for <em>MapType</em> and
- <em>MapSource</em> can be used:</p>
+ <p>La signification de l'argument <em>MapTypeOptions</em> dépend du <em>MapType</em>
+ spécifié. Veuillez vous référer au document <a href="../rewrite/rewritemap.html">Utiliser RewriteMap</a> pour
+ plus de détails.</p>
- <dl>
+ <p>Les combinaisons suivantes pour <em>type de correspondance</em>
+ et <em>MapSource</em>
+ peuvent être utilisées :</p>
+<dl>
<dt>txt</dt>
- <dd>A plain text file containing space-separated key-value
- pairs, one per line. (<a href="../rewrite/rewritemap.html#txt">Details ...</a>)</dd>
+ <dd>Un fichier texte contenant des paires clé-valeur séparées
+ par des espaces, une paire par ligne (<a href="../rewrite/rewritemap.html#txt">Détails ...</a>).</dd>
<dt>rnd</dt>
- <dd>Randomly selects an entry from a plain text file (<a href="../rewrite/rewritemap.html#rnd">Details ...</a>)</dd>
+ <dd>Sélection aléatoire d'une entrée depuis un fichier texte (<a href="../rewrite/rewritemap.html#rnd">Détails ...</a>).</dd>
<dt>dbm</dt>
- <dd>Looks up an entry in a dbm file containing name, value
- pairs. Hash is constructed from a plain text file format using
- the <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>
- utility. (<a href="../rewrite/rewritemap.html#dbm">Details ...</a>)</dd>
+ <dd>Recherche une entrée dans un fichier dbm contenant des
+ paires nom-valeur. Le condensé hash est élaboré à partir d'un
+ format de fichier texte via l'utilitaire <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code> (<a href="../rewrite/rewritemap.html#dbm">Détails ...</a>).</dd>
<dt>int</dt>
- <dd>One of the four available internal functions provided by
- <code>RewriteMap</code>: toupper, tolower, escape or
- unescape. (<a href="../rewrite/rewritemap.html#int">Details ...</a>)</dd>
+ <dd>Une des quatre fonctions internes disponibles que fournit
+ <code>RewriteMap</code>: toupper, tolower, escape ou unescape
+ (<a href="../rewrite/rewritemap.html#int">Détails ...</a>).</dd>
<dt>prg</dt>
- <dd>Calls an external program or script to process the
- rewriting. (<a href="../rewrite/rewritemap.html#prg">Details ...</a>)</dd>
+ <dd>Appelle un programme externe ou un script pour effectuer la
+ réécriture (<a href="../rewrite/rewritemap.html#prg">Détails
+ ...</a>).</dd>
<dt>dbd or fastdbd</dt>
- <dd>A SQL SELECT statement to be performed to look up the
- rewrite target. (<a href="../rewrite/rewritemap.html#dbd">Details ...</a>)</dd>
+ <dd>Une commande SQL SELECT à exécuter pour rechercher la cible
+ de réécriture (<a href="../rewrite/rewritemap.html#dbd">Détails
+ ...</a>).</dd>
</dl>
- <p>Further details, and numerous examples, may be found in the <a href="../rewrite/rewritemap.html">RewriteMap HowTo</a></p>
+<p>Vous trouverez plus de détails et de nombreux exemples dans le <a href="../rewrite/rewritemap.html">RewriteMap HowTo</a>.</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="rewriteoptions" id="rewriteoptions">Directive</a> <a name="RewriteOptions" id="RewriteOptions">RewriteOptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets some special options for the rewrite engine</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure certaines options spéciales
+pour le moteur de réécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteOptions <var>Options</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#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteOptions</code> directive sets some
- special options for the current per-server or per-directory
- configuration. The <em>Option</em> string can currently
- only be one of the following:</p>
+ <p>La directive <code class="directive">RewriteOptions</code> définit
+ certaines options spéciales pour la configuration au niveau du
+ serveur ou du répertoire. La chaîne de caractères <em>Option</em>
+ ne peut actuellement prendre qu'une des valeurs suivantes :</p>
<dl>
<dt><code>Inherit</code></dt>
<dd>
- <p>This forces the current configuration to inherit the
- configuration of the parent. In per-virtual-server context,
- this means that the maps, conditions and rules of the main
- server are inherited. In per-directory context this means
- that conditions and rules of the parent directory's
- <code>.htaccess</code> configuration or
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
- sections are inherited. The inherited rules are virtually copied
- to the section where this directive is being used. If used in
- combination with local rules, the inherited rules are copied behind
- the local rules. The position of this directive - below or above
- of local rules - has no influence on this behavior. If local
- rules forced the rewriting to stop, the inherited rules won't
- be processed.</p>
+ <p>Ceci force la configuration locale à hériter de la
+ configuration du niveau supérieur. Dans le contexte des hôtes
+ virtuels, cela signifie que les correspondances, conditions et
+ règles du serveur principal sont héritées. Dans le contexte des
+ répertoires, cela signifie que les conditions et règles de la
+ configuration <code>.htaccess</code> ou les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> du répertoire
+ parent sont héritées. Les règles héritées sont virtuellement
+ copiées dans la section où cette directive est utilisée. Si elles
+ sont utilisées avec des règles locales, les règles héritées sont
+ placées après ces dernières. La place de cette directive - avant
+ ou après les règles locales - n'a aucune influence sur ce
+ comportement. Si des règles locales ont forcé l'arrêt de la
+ réécriture, les règles héritées ne seront pas traitées.</p>
<div class="warning">
- Rules inherited from the parent scope are applied
- <strong>after</strong> rules specified in the child scope.
+ Les règles héritées du niveau parent sont appliquées
+ <strong>after</strong> après les règles spécifiées dans le niveau
+ enfant.
</div>
</dd>
<dt><code>InheritBefore</code></dt>
<dd>
- <p> Like <code>Inherit</code> above, but the rules from the parent scope
- are applied <strong>before</strong> rules specified in the child scope.<br />
- Available in Apache HTTP Server 2.3.10 and later.</p>
+ <p>Même effet que l'option <code>Inherit</code> ci-dessus, mais
+ les règles spécifiées dans le niveau parent s'appliquent
+ <strong>avant</strong> les règles spécifiées dans le niveau
+ enfant.<br />
+ Disponible depuis la version 2.3.10 du serveur HTTP Apache.</p>
</dd>
<dt><code>InheritDown</code></dt>
<dd>
- <p>If this option is enabled, all child configurations will inherit
- the configuration of the current configuration. It is equivalent to
- specifying <code>RewriteOptions Inherit</code> in all child
- configurations. See the <code>Inherit</code> option for more details
- on how the parent-child relationships are handled.<br />
- Available in Apache HTTP Server 2.4.8 and later.</p>
+ <p>Si cette option est activée, toutes les configurations enfants
+ hériteront de la configuration courante. Il en est de même si l'on
+ spécifie <code>RewriteOptions Inherit</code> dans toutes les
+ configurations enfants. Voir l'option <code>Inherit</code> pour
+ plus de détails à propos de la manière dont les relations
+ parent-enfants sont traitées.<br />
+ Cette option est disponible à partir
+ de la version 2.4.8 du serveur HTTP Apache.</p>
</dd>
<dt><code>InheritDownBefore</code></dt>
<dd>
- <p>Like <code>InheritDown</code> above, but the rules from the current
- scope are applied <strong>before</strong> rules specified in any child's
- scope.<br />
- Available in Apache HTTP Server 2.4.8 and later.</p>
+ <p>L'effet de cette option est équivalent à celui de l'option
+ <code>InheritDown</code> ci-dessus, mais les règles de la
+ configuration parente s'appliquent <strong>avant</strong> toute
+ règle de la configuration enfant.<br />
+ Cette option est disponible à partir
+ de la version 2.4.8 du serveur HTTP Apache.</p>
</dd>
<dt><code>IgnoreInherit</code></dt>
<dd>
- <p>This option forces the current and child configurations to ignore
- all rules that would be inherited from a parent specifying
- <code>InheritDown</code> or <code>InheritDownBefore</code>.<br />
- Available in Apache HTTP Server 2.4.8 and later.</p>
+ <p>Si cette option est activée, les configurations courante et
+ enfants ignoreront toute règle héritée d'une configuration parente
+ via les options <code>InheritDown</code> ou
+ <code>InheritDownBefore</code>.<br />
+ Cette option est disponible à partir
+ de la version 2.4.8 du serveur HTTP Apache.</p>
</dd>
-
+
<dt><code>AllowNoSlash</code></dt>
<dd>
- <p>By default, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> will ignore URLs that map to a
- directory on disk but lack a trailing slash, in the expectation that
- the <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> module will issue the client with a redirect to
- the canonical URL with a trailing slash.</p>
-
- <p>When the <code class="directive"><a href="../mod/mod_dir.html#directoryslash">DirectorySlash</a></code> directive
- is set to off, the <code>AllowNoSlash</code> option can be enabled to ensure
- that rewrite rules are no longer ignored. This option makes it possible to
- apply rewrite rules within .htaccess files that match the directory without
- a trailing slash, if so desired.<br />
- Available in Apache HTTP Server 2.4.0 and later.</p>
+ <p>Par défaut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ignore les URLs qui
+ correspondent à un répertoire sur disque, mais ne comportent pas
+ de slash final, afin que le module <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>
+ redirige le client vers l'URL canonique avec un slash final.</p>
+
+ <p>Lorsque la directive <code class="directive"><a href="../mod/mod_dir.html#directoryslash">DirectorySlash</a></code> est définie à off, il
+ est possible de spécifier l'option <code>AllowNoSlash</code> pour
+ s'assurer que les règles de réécriture ne soient plus ignorées.
+ Si on le souhaite, cette option permet de faire s'appliquer des
+ règles de réécriture qui correspondent à un répertoire sans slash
+ final au sein de fichiers .htaccess.<br />
+ Elle est disponible à
+ partir de la version 2.4.0 du serveur HTTP Apache.</p>
</dd>
<dt><code>AllowAnyURI</code></dt>
<dd>
- <p>When <code class="directive"><a href="#rewriterule">RewriteRule</a></code>
- is used in <code>VirtualHost</code> or server context with
- version 2.2.22 or later of httpd, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
- will only process the rewrite rules if the request URI is a <a href="directive-dict.html#Syntax">URL-path</a>. This avoids
- some security issues where particular rules could allow
- "surprising" pattern expansions (see <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-3368">CVE-2011-3368</a>
- and <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-4317">CVE-2011-4317</a>).
- To lift the restriction on matching a URL-path, the
- <code>AllowAnyURI</code> option can be enabled, and
- <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> will apply the rule set to any
- request URI string, regardless of whether that string matches
- the URL-path grammar required by the HTTP specification.<br />
- Available in Apache HTTP Server 2.4.3 and later.</p>
+ <p>A partir de la version 2.2.22 de httpd, lorsqu'une directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code> se situe dans un
+ contexte de <code>serveur virtuel</code> ou de serveur principal,
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ne traitera les règles de réécriture
+ que si l'URI de la requête respecte la syntaxe d'un <a href="directive-dict.html#Syntax">chemin URL</a>. Ceci permet
+ d'éviter certains problèmes de sécurité où des règles
+ particulières pourraient permettre des développements de modèles
+ inattendus (voir <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-3368">CVE-2011-3368</a>
+ et <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-4317">CVE-2011-4317</a>).
+ Pour s'affranchir de la restriction relative à la syntaxe des chemins URL, on peut
+ utiliser l'option <code>AllowAnyURI</code>, afin de permettre à
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> d'appliquer le jeu de règles à toute
+ chaîne de requête URI, sans vérifier si cette dernière respecte la
+ grammaire des chemins URL définie dans la spécification HTTP.<br />
+ Disponible depuis la version 2.4.3 du serveur HTTP Apache.</p>
<div class="warning">
- <h3>Security Warning</h3>
-
- <p>Enabling this option will make the server vulnerable to
- security issues if used with rewrite rules which are not
- carefully authored. It is <strong>strongly recommended</strong>
- that this option is not used. In particular, beware of input
- strings containing the '<code>@</code>' character which could
- change the interpretation of the transformed URI, as per the
- above CVE names.</p>
+ <h3>Avertissement à propos de la sécurité</h3>
+
+ <p>L'utilisation de cette option rendra le serveur vulnérable à
+ certains problèmes de sécurité si les règles de réécritures
+ concernées n'ont pas été rédigées avec soin. Il est par conséquent
+ <strong>fortement recommandé</strong> de ne pas utiliser cette
+ option. En particulier, prêtez attention aux chaînes en entrée contenant le
+ caractère '<code>@</code>', qui peuvent modifier l'interprétation
+ de l'URI réécrite, comme indiqué dans les liens ci-dessus.</p>
</div>
</dd>
<dt><code>MergeBase</code></dt>
<dd>
- <p>With this option, the value of <code class="directive"><a href="#rewritebase">RewriteBase</a></code> is copied from where it's explicitly defined
- into any sub-directory or sub-location that doesn't define its own
- <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. This was the
- default behavior in 2.4.0 through 2.4.3, and the flag to restore it is
- available Apache HTTP Server 2.4.4 and later.</p>
+ <p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est recopiée depuis
+ une valeur explicitement définie dans tout sous-répertoire qui ne
+ définit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. Il s'agissait du
+ comportement par défaut avec les versions 2.4.0 à 2.4.3, et ce
+ drapeau qui permet de retrouver ce comportement est disponible
+ depuis la version 2.4.4 du serveur HTTP Apache.</p>
</dd>
<dt><code>IgnoreContextInfo</code></dt>
<dd>
- <p>When a relative substitution is made
- in directory (htaccess) context and <code class="directive"><a href="#rewritebase">RewriteBase</a></code> has not been set, this module uses some
- extended URL and filesystem context information to change the
- relative substitution back into a URL. Modules such as
- <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> and <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>
- supply this extended context info. Available in 2.4.16 and later.</p>
+ <p>Lors d'une
+ substitution relative dans un contexte de répertoire (htaccess),
+ et si la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> n'a pas été définie,
+ ce module utilise des informations en provenance d'une extension
+ d'URL et du contexte du système de fichiers pour transformer la
+ sustitution relative en URL. Par exemple, les modules
+ <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> et <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>
+ utilisent ces informations de contexte étendu. Disponible à partir de la
+ version 2.4.16 du serveur HTTP Apache.</p>
</dd>
-
<dt><code>LegacyPrefixDocRoot</code></dt>
<dd>
- <p>Prior to 2.4.26, if a substitution was an absolute URL that matched
- the current virtual host, the URL might first be reduced to a URL-path
- and then later reduced to a local path. Since the URL can be reduced
- to a local path, the path should be prefixed with the document root.
- This prevents a file such as /tmp/myfile from being accessed when a
- request is made to http://host/file/myfile with the following
- <code class="directive"><a href="#rewriterule">RewriteRule</a></code>.</p>
+ <p>Avant la version 2.4.26, si une substitution était une URL absolue qui
+ correspondait au serveur virtuel courant, l'URL pouvait être tout d'abord
+ réduite à sa partie chemin, puis enfin en chemin local. Comme l'URL peut
+ être réduite en chemin local, le chemin doit être préfixé par la
+ valeur de la directive DocumentRoot, ce qui permet d'interdire l'accès à
+ un fichier tel que /tmp/myfile suite à une requête pour
+ http://host/file/myfile avec la <code class="directive"><a href="#rewriterule">RewriteRule</a></code> suivante :</p>
<pre class="prettyprint lang-config">RewriteRule /file/(.*) http://localhost/tmp/$1</pre>
- <p>This option allows the old behavior to be used where the document
- root is not prefixed to a local path that was reduced from a
- URL. Available in 2.4.26 and later.</p>
+ <p>Cette option permet de restaurer l'ancien comportement lorsqu'un chemin
+ local obtenu à partir de la réduction d'une URL n'est pas préfixé par la
+ valeur de la directive DocumentRoot. Disponible à partir de la version
+ 2.4.26 du serveur HTTP Apache.</p>
</dd>
<dt><code>LongURLOptimization</code></dt>
<dd>
- <p>This option reduces memory usage of long, unoptimized rule sets
- that repeatedly expand long values in RewriteCond and RewriteRule
- variables. Available in 2.5 and later.</p>
+ <p>Cette option permet de réduire la consommation de mémoire des jeux de
+ règles longs et non optimisés qui enregistrent de manière répétitive de
+ longues valeurs dans des variables au sein des directives RewriteCond et
+ RewriteRule. Disponible à partir de la version 2.5 du serveur HTTP Apache.</p>
</dd>
</dl>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="rewriterule" id="rewriterule">Directive</a> <a name="RewriteRule" id="RewriteRule">RewriteRule</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines rules for the rewriting engine</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les règles pour le moteur de réécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteRule
- <em>Pattern</em> <em>Substitution</em> [<em>flags</em>]</code></td></tr>
+ <em>Modèle</em> <em>Substitution</em> [<em>drapeaux</em>]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
- <p>The <code class="directive">RewriteRule</code> directive is the real
- rewriting workhorse. The directive can occur more than once,
- with each instance defining a single rewrite rule. The
- order in which these rules are defined is important - this is the order
- in which they will be applied at run-time.</p>
+ <p>La directive <code class="directive">RewriteRule</code> est le
+ véritable cheval de trait de la réécriture. La directive peut
+ apparaître plusieurs fois, chaque instance définissant une
+ règle de réécriture particulière. L'ordre dans lequel ces règles
+ sont définies est important - il s'agit de l'ordre dans lequel
+ les règles seront appliquées au cours du processus de
+ réécriture.</p>
- <p><a id="patterns" name="patterns"><em>Pattern</em></a> is
- a perl compatible <a id="regexp" name="regexp">regular
- expression</a>. What this pattern is compared against varies depending
- on where the <code class="directive">RewriteRule</code> directive is defined. </p>
+ <p><a id="patterns" name="patterns"><em>Modèle</em></a> est une
+ <a id="regexp" name="regexp">expression rationnelle</a>
+ compatible perl. Ce avec quoi ce modèle est comparé dépend de l'endroit où
+ la directive <code class="directive">RewriteRule</code> est définie.</p>
-<div class="note"><h3><a id="what_is_matched" name="what_is_matched">What is matched?</a></h3>
+<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est comparé ?</a></h3>
<ul>
- <li><p>In <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> context,
- The <em>Pattern</em> will initially be matched against the part of the
- URL after the hostname and port, and before the query string (e.g. "/app1/index.html").
- This is the (%-decoded) <a href="directive-dict.html#Syntax">URL-path</a>.</p></li>
-
- <li><p>In per-directory context (<code class="directive"><a href="../mod/core.html#directory">Directory</a></code> and .htaccess),
- the <em>Pattern</em> is matched against only a partial path, for example a request
- of "/app1/index.html" may result in comparison against "app1/index.html"
- or "index.html" depending on where the <code class="directive">RewriteRule</code> is
- defined.</p>
-
- <p>The directory path where the rule is defined is stripped from the currently mapped
- filesystem path before comparison (up to and including a trailing slash).
- The net result of this per-directory prefix stripping is that rules in
- this context only match against the portion of the currently mapped filesystem path
- "below" where the rule is defined.</p>
-
- <p>Directives such as <code class="directive">DocumentRoot</code> and <code class="directive">Alias</code>, or even the
- result of previous <code class="directive">RewriteRule</code> substitutions, determine
- the currently mapped filesystem path.
+ <li><p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le <em>modèle</em> est tout
+ d'abord comparé à la portion de l'URL située entre le nom d'hôte
+ éventuellement accompagné du port, et la chaîne de paramètres (par
+ exemple "/app1/index.html"). Il s'agit du <a href="directive-dict.html#Syntax">URL-path</a> décodé de sa valeur "%xx".</p></li>
+
+ <li><p>Dans un contexte de répertoire (sections <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et fichiers .htaccess), le
+ <em>Modèle</em> est comparé avec une partie de chemin ; par exemple une
+ requête pour "/app1/index.html" entraînera une comparaison avec
+ "app1/index.html" ou "index.html" selon l'endroit où la directive
+ <code class="directive">RewriteRule</code> est définie.</p>
+
+ <p>Le chemin où la règle est défini est supprimé du chemin correspondant
+ du système de fichiers avant comparaison (jusqu'au slash final compris).
+ En conséquence de cette suppression, les règles définies dans
+ ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
+ du système de fichiers "en dessous" de l'endroit où la règle est définie.</p>
+
+ <p>Le chemin correspondant actuel du système de fichiers est déterminé par
+ des directives telles que <code class="directive">DocumentRoot</code> et
+ <code class="directive">Alias</code>, ou même le résultat de substitutions dans
+ des règles <code class="directive">RewriteRule</code> précédentes.
</p>
</li>
- <li><p>If you wish to match against the hostname, port, or query string, use a
- <code class="directive"><a href="#rewritecond">RewriteCond</a></code> with the
- <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, or
- <code>%{QUERY_STRING}</code> variables respectively.</p></li>
+ <li><p>Si vous souhaitez faire une comparaison sur le nom
+ d'hôte, le port, ou la chaîne de requête, utilisez une
+ directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
+ comportant respectivement les variables
+ <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
+ <code>%{QUERY_STRING}</code>.</p></li>
</ul>
+
</div>
-<div class="note"><h3>Per-directory Rewrites</h3>
+<div class="note"><h3>Réécritures dans un contexte de répertoire</h3>
<ul>
-<li>The rewrite engine may be used in <a href="../howto/htaccess.html">.htaccess</a> files and in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections, with some additional
-complexity.</li>
-
-<li>To enable the rewrite engine in this context, you need to set
-"<code>RewriteEngine On</code>" <strong>and</strong>
-"<code>Options FollowSymLinks</code>" must be enabled. If your
-administrator has disabled override of <code>FollowSymLinks</code> for
-a user's directory, then you cannot use the rewrite engine. This
-restriction is required for security reasons.</li>
-
-<li>See the <code class="directive"><a href="#rewritebase">RewriteBase</a></code>
-directive for more information regarding what prefix will be added back to
-relative substitutions.</li>
-
-<li> If you wish to match against the full URL-path in a per-directory
-(htaccess) RewriteRule, use the <code>%{REQUEST_URI}</code> variable in
-a <code class="directive"><a href="#rewritecond">RewriteCond</a></code>.</li>
-
-<li>The removed prefix always ends with a slash, meaning the matching occurs against a string which
-<em>never</em> has a leading slash. Therefore, a <em>Pattern</em> with <code>^/</code> never
-matches in per-directory context.</li>
-
-<li>Although rewrite rules are syntactically permitted in <code class="directive"><a href="../mod/core.html#location"><Location></a></code> and <code class="directive"><a href="../mod/core.html#files"><Files></a></code> sections
-(including their regular expression counterparts), this
-should never be necessary and is unsupported. A likely feature
-to break in these contexts is relative substitutions.</li>
+<li>L'utilisation du moteur de réécriture dans les
+fichiers <a href="../howto/htaccess.html">.htaccess</a> et les sections
+<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> est un peu plus
+complexe.</li>
+
+<li>Pour activer le moteur de réécriture dans ces contextes, vous devez
+définir "<code>RewriteEngine On</code>" <strong>et</strong>
+"<code>Options FollowSymLinks</code>". Si l'administrateur a désactivé
+la possibilité de modifier l'option <code>FollowSymLinks</code> au
+niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
+moteur de réécriture. Cette restriction a été instaurée à des fins de
+sécurité.</li>
+
+<li>Voir la directive
+<code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de détails à
+propos de l'ajout du préfixe après les substitutions relatives.</li>
+
+<li>Si vous souhaitez effectuer une comparaison en prenant en compte
+l'intégralité du
+chemin de l'URL dans un contexte de répertoire (htaccess), vous devez
+utiliser la variable <code>%{REQUEST_URI}</code> dans la directive
+<code class="directive"><a href="#rewritecond">RewriteCond</a></code>.</li>
+
+<li>Le prefixe supprimé se termine toujours par un slash, ce qui
+signifie que la comparaison s'effectue avec une chaîne qui ne comporte
+<em>jamais</em> de slash de début. Ainsi, un <em>modèle</em> contenant
+<code>^/</code> ne correspondra jamais dans un contexte de répertoire.</li>
+
+<li>Bien que les règles de réécriture soient permises du point de vue de
+la syntaxe dans les sections <code class="directive"><a href="../mod/core.html#location"><Location></a></code> et <code class="directive"><a href="../mod/core.html#files"><Files></a></code> (y compris leurs versions sous forme
+d'expression rationnelle), elles n'y sont pas prises en compte, et
+n'y sont à priori d'aucune utilité. Les substitutions
+relatives sont une fonctionnalité qui n'est, elle non-plus pas supportée
+dans ce genre de contexte.</li>
</ul>
</div>
- <p>For some hints on <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular
- expressions</a>, see
- the <a href="../rewrite/intro.html#regex">mod_rewrite
- Introduction</a>.</p>
+ <p>Pour quelques conseils à propos des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, voir le
+ document <a href="../rewrite/intro.html#regex">Introduction à
+ mod_rewrite</a>.</p>
- <p>In mod_rewrite, the NOT character
- ('<code>!</code>') is also available as a possible pattern
- prefix. This enables you to negate a pattern; to say, for instance:
- ``<em>if the current URL does <strong>NOT</strong> match this
- pattern</em>''. This can be used for exceptional cases, where
- it is easier to match the negative pattern, or as a last
- default rule.</p>
+ <p>Dans mod_rewrite, on peut aussi utiliser le caractère NON
+ ('<code>!</code>') comme préfixe de modèle. Ceci vous permet
+ d'inverser la signification d'un modèle, soit pour dire
+ ``<em>si l'URL considérée ne correspond <strong>PAS</strong> à
+ ce modèle</em>''. Le caractère NON peut donc être utilisé à
+ titre exceptionnel, lorsqu'il est plus simple d'effectuer une
+ comparaison avec le modèle inversé, ou dans la dernière règle
+ par défaut.</p>
<div class="note"><h3>Note</h3>
-When using the NOT character to negate a pattern, you cannot include
-grouped wildcard parts in that pattern. This is because, when the
-pattern does NOT match (ie, the negation matches), there are no
-contents for the groups. Thus, if negated patterns are used, you
-cannot use <code>$N</code> in the substitution string!
+Si vous utilisez le caractère NON pour inverser la signification d'un
+modèle, vous ne pouvez pas inclure de parties génériques groupées dans
+le modèle. Ceci est dû au fait que, lorsque le modèle ne correspond
+pas (autrement dit, sa négation correspond), les groupes sont vides.
+Ainsi, si vous utilisez des modèles inversés, vous ne pouvez
+pas vous référer aux groupes par <code>$N</code> dans la chaîne de
+substitution !
</div>
- <p>The <a id="rhs" name="rhs"><em>Substitution</em></a> of a
- rewrite rule is the string that replaces the original URL-path that
- was matched by <em>Pattern</em>. The <em>Substitution</em> may
- be a:</p>
+ <p>Dans une règle de réécriture,
+ <a id="rhs" name="rhs"><em>Substitution</em></a> est la chaîne
+ de caractères qui remplace le chemin de l'URL original qui
+ correspondait au <em>Modèle</em>. <em>Substitution</em> peut
+ être :</p>
<dl>
- <dt>file-system path</dt>
-
- <dd>Designates the location on the file-system of the resource
- to be delivered to the client. Substitutions are only
- treated as a file-system path when the rule is configured in
- server (virtualhost) context and the first component of the
- path in the substitution exists in the file-system</dd>
-
- <dt>URL-path</dt>
-
- <dd>A <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>-relative path to the
- resource to be served. Note that <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
- tries to guess whether you have specified a file-system path
- or a URL-path by checking to see if the first segment of the
- path exists at the root of the file-system. For example, if
- you specify a <em>Substitution</em> string of
- <code>/www/file.html</code>, then this will be treated as a
- URL-path <em>unless</em> a directory named <code>www</code>
- exists at the root or your file-system (or, in the case of
- using rewrites in a <code>.htaccess</code> file, relative to
- your document root), in which case it will
- be treated as a file-system path. If you wish other
- URL-mapping directives (such as <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>) to be applied to the
- resulting URL-path, use the <code>[PT]</code> flag as
- described below.</dd>
-
- <dt>Absolute URL</dt>
-
- <dd>If an absolute URL is specified,
- <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> checks to see whether the
- hostname matches the current host. If it does, the scheme and
- hostname are stripped out and the resulting path is treated as
- a URL-path. Otherwise, an external redirect is performed for
- the given URL. To force an external redirect back to the
- current host, see the <code>[R]</code> flag below.</dd>
-
- <dt><code>-</code> (dash)</dt>
-
- <dd>A dash indicates that no substitution should be performed
- (the existing path is passed through untouched). This is used
- when a flag (see below) needs to be applied without changing
- the path.</dd>
+ <dt>un chemin du système de fichiers</dt>
+
+ <dd>Il indique alors la localisation dans le système de
+ fichiers de la ressource qui doit être envoyée au
+ client. Les substitutions ne sont traitées en tant que chemins du
+ système de fichiers que si la règle est configurée dans un
+ contexte de serveur (serveur virtuel), et si le premier
+ composant du chemin dans la substitution existe dans le système
+ de fichiers.</dd>
+
+ <dt>chemin d'URL</dt>
+
+ <dd>Un chemin relatif à la valeur de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> vers la ressource qui
+ doit être servie. Notez que <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
+ essaie de deviner si vous avez spécifié un chemin du système
+ de fichiers ou un chemin d'URL en vérifiant si la première
+ partie du chemin existe à la racine du système de fichiers.
+ Par exemple, si vous avez spécifié comme chaîne de
+ <em>Substitution</em> <code>/www/file.html</code>, cette
+ dernière sera traitée comme un chemin d'URL <em>à moins</em>
+ qu'un répertoire nommé <code>www</code> n'existe à la racine
+ de votre système de fichiers (ou dans le cas d'une
+ réécriture au sein d'un fichier <code>.htaccess</code>,
+ relativement à la racine des documents), auquel cas la chaîne de
+ substitution sera traitée comme un chemin du système de
+ fichiers. Si vous désirez que d'autres directives de
+ correspondance d'URL (comme la directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>) soient appliquées au
+ chemin d'URL résultant, utilisez le drapeau <code>[PT]</code>
+ comme décrit ci-dessous.</dd>
+
+ <dt>URL absolue</dt>
+
+ <dd>Si une URL absolue est spécifiée,
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> vérifie si le nom d'hôte
+ correspond à celui de l'hôte local. Si c'est le cas, le
+ protocole et le nom d'hôte sont supprimés, et ce qui reste est
+ traité comme un chemin d'URL. Dans le cas contraire, une
+ redirection externe vers l'URL indiquée est effectuée. Pour
+ forcer une redirection externe vers l'hôte local, voir le
+ drapeau <code>[R]</code> ci-dessous.</dd>
+
+ <dt><code>-</code> (tiret)</dt>
+
+ <dd>Un tiret indique qu'aucune substitution ne doit être
+ effectuée (le chemin considéré est transmis sans changement).
+ Ceci est utile quand un drapeau doit être appliqué sans
+ modifier le chemin (voir ci-dessous).</dd>
</dl>
- <p>In addition to plain text, the <em>Substitution</em> string can include</p>
+ <p>En plus du texte, la chaîne <em>Substitution</em> peut
+ comporter :</p>
<ol>
- <li>back-references (<code>$N</code>) to the RewriteRule
- pattern</li>
+ <li>des références arrières (<code>$N</code>) vers le modèle
+ d'une directive RewriteRule</li>
- <li>back-references (<code>%N</code>) to the last matched
- RewriteCond pattern</li>
+ <li>des références arrières (<code>%N</code>) vers le dernier
+ modèle d'une directive RewriteCond qui correspondait</li>
- <li>server-variables as in rule condition test-strings
- (<code>%{VARNAME}</code>)</li>
+ <li>des variables du serveur comme dans les chaînes de test de
+ condition d'une règle (<code>%{VARNAME}</code>)</li>
- <li><a href="#mapfunc">mapping-function</a> calls
- (<code>${mapname:key|default}</code>)</li>
+ <li>des appels de
+ <a href="#mapfunc">fonctions de comparaison</a>
+ (<code>${nom correspondance:clé|défaut}</code>)</li>
</ol>
- <p>Back-references are identifiers of the form
- <code>$</code><strong>N</strong>
- (<strong>N</strong>=0..9), which will be replaced
- by the contents of the <strong>N</strong>th group of the
- matched <em>Pattern</em>. The server-variables are the same
- as for the <em>TestString</em> of a
- <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
- directive. The mapping-functions come from the
- <code class="directive"><a href="#rewritemap">RewriteMap</a></code>
- directive and are explained there.
- These three types of variables are expanded in the order above.</p>
-
- <p>Rewrite rules are applied to the results of previous rewrite
- rules, in the order in which they are defined
- in the config file. The URL-path or file-system path (see <a href="#what_is_matched">"What is matched?"</a>, above) is <strong>completely
- replaced</strong> by the <em>Substitution</em> and the
- rewriting process continues until all rules have been applied,
- or it is explicitly terminated by an
- <a href="../rewrite/flags.html#flag_l"><code><strong>L</strong></code> flag</a>,
- or other flag which implies immediate termination, such as
- <code><strong>END</strong></code> or
+ <p>Les références arrières sont des identificateurs de la forme
+ <code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
+ seront remplacés par le contenu du <strong>N</strong>ème groupe
+ du <em>Modèle</em> qui correspondait. Les variables du serveur
+ sont les mêmes que dans la <em>Chaîne_de_test</em> d'une
+ directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>. Les
+ fonctions de comparaison sont issues de la directive <code class="directive"><a href="#rewritemap">RewriteMap</a></code> dans la
+ section de laquelle elles sont décrites. Ces trois types de
+ variables sont évaluées dans l'ordre ci-dessus.</p>
+
+ <p>Chaque règle de réécriture s'applique au résultat de la règle
+ précédente, selon l'ordre dans lequel elles ont été définies dans
+ le fichier de configuration. Le chemin de l'URL ou du système de fichier (voir
+ ci-dessus <a href="#what_is_matched">Qu'est-ce qui est
+ comparé ?</a>) est <strong>intégralement
+ remplacée</strong> par la chaîne de <em>Substitution</em> et le
+ processus de réécriture se poursuit jusqu'à ce que toutes les
+ règles aient été appliquées, ou qu'il soit explicitement stoppé
+ par un drapeau <a href="../rewrite/flags.html#flag_l"><code><strong>L</strong></code></a>,
+ ou par un autre drapeau qui implique un arrêt immédiat, comme
+ <code><strong>END</strong></code> ou
<code><strong>F</strong></code>.</p>
- <div class="note"><h3>Modifying the Query String</h3>
- <p>By default, the query string is passed through unchanged. You
- can, however, create URLs in the substitution string containing
- a query string part. Simply use a question mark inside the
- substitution string to indicate that the following text should
- be re-injected into the query string. When you want to erase an
- existing query string, end the substitution string with just a
- question mark. To combine new and old query strings, use the
- <code>[QSA]</code> flag.</p>
+ <div class="note"><h3>Modifier la chaîne de requête</h3>
+ <p>Par défaut, la chaîne de requête est transmise sans
+ modification. Vous pouvez cependant créer dans la chaîne de
+ substitution des URLs dont une partie constitue une chaîne de
+ requête. Pour cela, ajoutez simplement un point d'interrogation
+ dans la chaîne de substitution pour indiquer que le texte qui
+ suit doit être réinjecté dans la chaîne de requête. Pour
+ supprimer une chaîne de requête, terminez simplement la chaîne de
+ substitution par un point d'interrogation. Pour combiner les
+ nouvelles chaînes de requête avec les anciennes, utilisez le
+ drapeau <code>[QSA]</code>.</p>
</div>
- <p>Additionally you can set special <a name="rewriteflags" id="rewriteflags">actions</a> to be performed by
- appending <strong><code>[</code><em>flags</em><code>]</code></strong>
- as the third argument to the <code class="directive">RewriteRule</code>
- directive. <em>Flags</em> is a comma-separated list, surround by square
- brackets, of any of the flags in the following table. More
- details, and examples, for each flag, are available in the <a href="../rewrite/flags.html">Rewrite Flags document</a>.</p>
- <table class="bordered"><tr class="header"><th>Flag and syntax</th>
- <th>Function</th>
+ <p>En outre, vous pouvez spécifier des <a name="rewriteflags" id="rewriteflags">actions</a> spéciales à effectuer en ajoutant
+ des
+ <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
+ comme troisième argument de la directive
+ <code class="directive">RewriteRule</code>. Séparés par des virgules au sein d'une
+ liste encadrée par des crochets, les <em>drapeaux</em> peuvent
+ être choisis dans la table suivante. Vous trouverez plus de
+ détails, et des exemples pour chaque drapeau dans le <a href="../rewrite/flags.html">document à propos des drapeaux de
+ réécriture.</a></p>
+
+ <table class="bordered"><tr class="header"><th>Drapeaux et syntaxe</th>
+ <th>Fonction</th>
</tr>
<tr>
<td>B</td>
- <td>Escape non-alphanumeric characters in backreferences <em>before</em>
- applying the transformation. <em><a href="../rewrite/flags.html#flag_b">details ...</a></em></td>
+ <td>Echappe les caractères non-alphanumériques
+ dans les références arrières <em>avant</em>
+ d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>backrefnoplus|BNP</td>
- <td>If backreferences are being escaped, spaces should be escaped to
- %20 instead of +. Useful when the backreference will be used in the
- path component rather than the query string.<em><a href="../rewrite/flags.html#flag_bnp">details ...</a></em></td>
+ <td>Avec ce drapeau, si les références arrières sont échappées,
+ les espaces seront échappés en %20 au lieu de +. Ceci s'avère
+ utile lorsqu'une référence arrière est utilisée dans la partie
+ chemin, et non dans la chaîne de paramètres de la requête ;
+ pour plus de détails, voir <em><a href="../rewrite/flags.html#flag_bnp">ici.</a></em></td>
</tr>
-<tr>
- <td>chain|C</td>
- <td>Rule is chained to the following rule. If the rule fails,
- the rule(s) chained to it will be skipped. <em><a href="../rewrite/flags.html#flag_c">details ...</a></em></td>
+<tr>
+ <td>chain|C</td>
+ <td>La règle est chaînée avec la règle suivante. Si la règle
+ échoue, la ou les règles avec lesquelles elle est est chaînée
+ seront sautées. <em><a href="../rewrite/flags.html#flag_c">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>cookie|CO=<em>NAME</em>:<em>VAL</em></td>
- <td>Sets a cookie in the client browser. Full syntax is:
- CO=<em>NAME</em>:<em>VAL</em>:<em>domain</em>[:<em>lifetime</em>[:<em>path</em>[:<em>secure</em>[:<em>httponly</em>]]]] <em><a href="../rewrite/flags.html#flag_co">details ...</a></em>
+ <td>Définit un cookie au niveau du navigateur client. La syntaxe
+ complète est :
+ CO=<em>NAME</em>:<em>VAL</em>:<em>domain</em>[:<em>lifetime</em>[:<em>path</em>[:<em>secure</em>[:<em>httponly</em>]]]] <em><a href="../rewrite/flags.html#flag_co">details ...</a></em>
+ <em><a href="../rewrite/flags.html#flag_co">détails ...</a></em>
</td>
</tr>
<tr>
<td>discardpath|DPI</td>
- <td>Causes the PATH_INFO portion of the rewritten URI to be
- discarded. <em><a href="../rewrite/flags.html#flag_dpi">details
+ <td>Supprime la partie PATH_INFO de l'URI réécrit. <em><a href="../rewrite/flags.html#flag_dpi">détails
...</a></em></td>
</tr>
<tr class="odd">
<td>END</td>
- <td>Stop the rewriting process immediately and don't apply any
- more rules. Also prevents further execution of rewrite rules
- in per-directory and .htaccess context. (Available in 2.3.9 and later)
- <em><a href="../rewrite/flags.html#flag_end">details ...</a></em></td>
+ <td>Stoppe le processus de réécriture immédiatement et
+ n'applique plus aucune règle. Empêche aussi l'application
+ ultérieure de règles de réécriture dans les contextes de
+ répertoire et de fichier .htaccess (disponible à partir de la
+ version 2.3.9 du serveur HTTP Apache). <em><a href="../rewrite/flags.html#flag_end">détails ...</a></em></td>
</tr>
-<tr>
+<tr>
<td>env|E=[!]<em>VAR</em>[:<em>VAL</em>]</td>
- <td>Causes an environment variable <em>VAR</em> to be set (to the
- value <em>VAL</em> if provided). The form !<em>VAR</em> causes
- the environment variable <em>VAR</em> to be unset.
- <em><a href="../rewrite/flags.html#flag_e">details ...</a></em></td>
+ <td>Définit la variable d'environnement <em>VAR</em> (à la valeur
+ <em>VAL</em> si elle est fournie). La variante !<em>VAR</em>
+ annule la définition de la variable <em>VAR</em>.<em><a href="../rewrite/flags.html#flag_e">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>forbidden|F</td>
- <td>Returns a 403 FORBIDDEN response to the client browser.
- <em><a href="../rewrite/flags.html#flag_f">details ...</a></em></td>
+ <td>Renvoie une réponse 403 FORBIDDEN au navigateur client.
+ <em><a href="../rewrite/flags.html#flag_f">détails ...</a></em></td>
</tr>
<tr>
<td>gone|G</td>
- <td>Returns a 410 GONE response to the client browser. <em><a href="../rewrite/flags.html#flag_g">details ...</a></em></td>
+ <td>Renvoie un message d'erreur 410 GONE au navigateur client. <em><a href="../rewrite/flags.html#flag_g">détails ...</a></em></td>
</tr>
<tr class="odd">
- <td>Handler|H=<em>Content-handler</em></td>
- <td>Causes the resulting URI to be sent to the specified
- <em>Content-handler</em> for processing. <em><a href="../rewrite/flags.html#flag_h">details ...</a></em></td>
+ <td>Handler|H=<em>Gestionnaire de contenu</em></td>
+ <td>L'URI résultant est envoyé au <em>Gestionnaire de
+ contenu</em> pour traitement. <em><a href="../rewrite/flags.html#flag_h">détails ...</a></em></td>
</tr>
<tr>
<td>last|L</td>
- <td>Stop the rewriting process immediately and don't apply any
- more rules. Especially note caveats for per-directory and
- .htaccess context (see also the END flag). <em><a href="../rewrite/flags.html#flag_l">details ...</a></em></td>
+ <td>Arrête le processus de réécriture immédiatement et n'applique
+ plus aucune règle. Prêtez une attention particulière aux mises
+ en garde concernant les contextes de niveau répertoire et
+ .htaccess (voir aussi le drapeau END). <em><a href="../rewrite/flags.html#flag_l">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>next|N</td>
- <td>Re-run the rewriting process, starting again with the first
- rule, using the result of the ruleset so far as a starting
- point. <em><a href="../rewrite/flags.html#flag_n">details
+ <td>Réexécute le processus de réécriture à partir de la première
+ règle, en utilisant le résultat du jeu de règles, sous réserve
+ qu'il y ait un point de départ. <em><a href="../rewrite/flags.html#flag_n">détails
...</a></em></td>
</tr>
<tr>
<td>nocase|NC</td>
- <td>Makes the pattern comparison case-insensitive.
- <em><a href="../rewrite/flags.html#flag_nc">details ...</a></em></td>
+ <td>Rend la comparaison entre modèles insensible à la casse.
+ <em><a href="../rewrite/flags.html#flag_nc">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>noescape|NE</td>
- <td>Prevent mod_rewrite from applying hexcode escaping of
- special characters in the result of the rewrite. <em><a href="../rewrite/flags.html#flag_ne">details ...</a></em></td>
+ <td>Empêche mod_rewrite d'effectuer un échappement hexadécimal
+ des caractères spéciaux dans le résultat de la réécriture. <em><a href="../rewrite/flags.html#flag_ne">détails ...</a></em></td>
</tr>
<tr>
<td>nosubreq|NS</td>
- <td>Causes a rule to be skipped if the current request is an
- internal sub-request. <em><a href="../rewrite/flags.html#flag_ns">details ...</a></em></td>
+ <td>La règle est sautée si la requête courante est une
+ sous-requête interne. <em><a href="../rewrite/flags.html#flag_ns">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>proxy|P</td>
- <td>Force the substitution URL to be internally sent as a proxy
- request. <em><a href="../rewrite/flags.html#flag_p">details
+ <td>Force l'envoi en interne de l'URL de substitution en tant
+ que requête mandataire. <em><a href="../rewrite/flags.html#flag_p">détails
...</a></em></td>
</tr>
<tr>
<td>passthrough|PT</td>
- <td>Forces the resulting URI to be passed back to the URL
- mapping engine for processing of other URI-to-filename
- translators, such as <code>Alias</code> or
- <code>Redirect</code>. <em><a href="../rewrite/flags.html#flag_pt">details ...</a></em></td>
+ <td>L'URI résultant est repassé au moteur de mise en
+ correspondance des URLs pour y être traité par d'autres
+ traducteurs URI-vers-nom de fichier, comme <code>Alias</code> ou
+ <code>Redirect</code>. <em><a href="../rewrite/flags.html#flag_pt">détails ...</a></em></td>
</tr>
<tr class="odd">
<td>qsappend|QSA</td>
- <td>Appends any query string from the original request URL to
- any query string created in the rewrite target.<em><a href="../rewrite/flags.html#flag_qsa">details ...</a></em></td>
+ <td>Ajoute toute chaîne de paramètres présente dans l'URL de la
+ requête originale à toute chaîne de paramètres créée dans la
+ cible de réécriture. <em><a href="../rewrite/flags.html#flag_qsa">détails ...</a></em></td>
</tr>
<tr>
<td>qsdiscard|QSD</td>
- <td>Discard any query string attached to the incoming URI.
- <em><a href="../rewrite/flags.html#flag_qsd">details
+ <td>Supprime toute chaîne de paramètres de l'URI entrant. <em><a href="../rewrite/flags.html#flag_qsd">détails
...</a></em></td>
</tr>
<tr class="odd">
<td>qslast|QSL</td>
- <td>Interpret the last (right-most) question mark as the query string
- delimiter, instead of the first (left-most) as normally used.
- Available in 2.4.19 and later.
- <em><a href="../rewrite/flags.html#flag_qsl">details
- ...</a></em></td>
+ <td>Interprète le dernier (le plus à droite) point d'interrogation comme
+ le délimiteur de la chaîne de paramètres de la requête, au lieu du
+ premier (le plus à gauche) comme c'est le cas habituellement. Disponble
+ à partir de la version 2.4.19 du serveur HTTP Apache. <em><a href="../rewrite/flags.html#flag_qsl">détails ...</a></em></td>
</tr>
<tr>
- <td>redirect|R[=<em>code</em>]</td>
- <td>Forces an external redirect, optionally with the specified
- HTTP status code. <em><a href="../rewrite/flags.html#flag_r">details ...</a></em>
+ <td>redirect|R[=<em>code</em>]</td>
+ <td>Force une redirection externe, avec un code de statut HTTP
+ optionnel. <em><a href="../rewrite/flags.html#flag_r">détails ...</a></em>
</td>
</tr>
<tr class="odd">
- <td>skip|S=<em>num</em></td>
- <td>Tells the rewriting engine to skip the next <em>num</em>
- rules if the current rule matches. <em><a href="../rewrite/flags.html#flag_s">details ...</a></em></td>
+ <td>skip|S=<em>nombre</em></td>
+ <td>Si la règle courante s'applique, le moteur de réécriture
+ doit sauter les <em>nombre</em> règles suivantes. <em><a href="../rewrite/flags.html#flag_s">détails ...</a></em></td>
</tr>
<tr>
<td>type|T=<em>MIME-type</em></td>
- <td>Force the <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">MIME-type</a> of the target file
- to be the specified type. <em><a href="../rewrite/flags.html#flag_t">details ...</a></em></td>
+ <td>Force l'attribution du <a class="glossarylink" href="../glossary.html#type-mime" title="voir glossaire">Type-MIME</a>
+ spécifié au fichier cible. <em><a href="../rewrite/flags.html#flag_t">détails ...</a></em></td>
</tr>
</table>
-<div class="note"><h3>Home directory expansion</h3>
-<p> When the substitution string begins with a string
-resembling "/~user" (via explicit text or backreferences), mod_rewrite performs
-home directory expansion independent of the presence or configuration
-
of <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</p>
+<div class="note"><h3>Développement du répertoire home</h3>
+<p> Quand la chaîne de substitution commence par quelque chose comme
+"/~user" (de manière explicite ou par références arrières), mod_rewrite
+développe le répertoire home sans tenir compte de la présence ou de la
+
configuration du module <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</p>
-<p> This expansion does not occur when the <em>PT</em>
-flag is used on the <code class="directive"><a href="#rewriterule">RewriteRule</a></code>
-directive.</p>
+<p> Ce développement n'est pas effectué si le drapeau <em>PT</em> est
+utilisé dans la directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code></p>
</div>
+ <p>Voici toutes les combinaisons de substitution et leurs
+ significations :</p>
- <p>Here are all possible substitution combinations and their
- meanings:</p>
-
- <p><strong>Inside per-server configuration
+ <p><strong>Dans la configuration au niveau du serveur principal
(<code>httpd.conf</code>)<br />
- for request ``<code>GET
- /somepath/pathinfo</code>'':</strong><br />
+ pour la requête ``<code>GET
+ /chemin/infochemin</code>'':</strong><br />
</p>
<table class="bordered"><tr class="header">
-<th>Given Rule</th>
-<th>Resulting Substitution</th>
+<th>Règle</th>
+<th>Résultat de la substitution</th>
</tr>
<tr>
-<td>^/somepath(.*) otherpath$1</td>
-<td>invalid, not supported</td>
+<td>^/un_chemin(.*) autre_chemin$1</td>
+<td>invalide, non supporté</td>
</tr>
<tr class="odd">
-<td>^/somepath(.*) otherpath$1 [R]</td>
-<td>invalid, not supported</td>
+<td>^/un_chemin(.*) autre_chemin$1 [R]</td>
+<td>invalide, non supporté</td>
</tr>
<tr>
-<td>^/somepath(.*) otherpath$1 [P]</td>
-<td>invalid, not supported</td>
+<td>^/un_chemin(.*) autre_chemin$1 [P]</td>
+<td>invalide, non supporté</td>
</tr>
<tr class="odd">
-<td>^/somepath(.*) /otherpath$1</td>
-<td>/otherpath/pathinfo</td>
+<td>^/un_chemin(.*) /autre_chemin$1</td>
+<td>/autre_chemin/info_chemin</td>
</tr>
<tr>
-<td>^/somepath(.*) /otherpath$1 [R]</td>
-<td>http://thishost/otherpath/pathinfo via external redirection</td>
+<td>^/un_chemin(.*) /autre_chemin$1 [R]</td>
+<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr class="odd">
-<td>^/somepath(.*) /otherpath$1 [P]</td>
-<td>doesn't make sense, not supported</td>
+<td>^/un_chemin(.*) /autre_chemin$1 [P]</td>
+<td>sans objet, non supporté</td>
</tr>
<tr>
-<td>^/somepath(.*) http://thishost/otherpath$1</td>
-<td>/otherpath/pathinfo</td>
+<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1</td>
+<td>/autre_chemin/info_chemin</td>
</tr>
<tr class="odd">
-<td>^/somepath(.*) http://thishost/otherpath$1 [R]</td>
-<td>http://thishost/otherpath/pathinfo via external redirection</td>
+<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [R]</td>
+<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr>
-<td>^/somepath(.*) http://thishost/otherpath$1 [P]</td>
-<td>doesn't make sense, not supported</td>
+<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P]</td>
+<td>sans objet, non supporté</td>
</tr>
<tr class="odd">
-<td>^/somepath(.*) http://otherhost/otherpath$1</td>
-<td>http://otherhost/otherpath/pathinfo via external redirection</td>
+<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1</td>
+<td>http://autre_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr>
-<td>^/somepath(.*) http://otherhost/otherpath$1 [R]</td>
-<td>http://otherhost/otherpath/pathinfo via external redirection (the [R] flag is redundant)</td>
+<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1 [R]</td>
+<td>http://autre_hote/autre_chemin/info_chemin (le drapeau [R] est
+redondant)</td>
</tr>
<tr class="odd">
<td>^/somepath(.*) http://otherhost/otherpath$1 [P]</td>
</tr>
</table>
- <p><strong>Inside per-directory configuration for
- <code>/somepath</code><br />
- (<code>/physical/path/to/somepath/.htaccess</code>, with
- <code>RewriteBase "/somepath"</code>)<br />
- for request ``<code>GET
- /somepath/localpath/pathinfo</code>'':</strong><br />
+ <p><strong>Dans une configuration de niveau répertoire pour
+ <code>/chemin</code><br />
+ (<code>/chemin/physique/vers/chemin/.htacccess</code>, avec
+ <code>RewriteBase "/chemin"</code>)<br />
+ pour la requête ``<code>GET
+ /chemin/chemin-local/infochemin</code>'':</strong><br />
</p>
<table class="bordered"><tr class="header">
-<th>Given Rule</th>
-<th>Resulting Substitution</th>
+<th>Règle</th>
+<th>Résultat de la substitution</th>
</tr>
<tr>
-<td>^localpath(.*) otherpath$1</td>
-<td>/somepath/otherpath/pathinfo</td>
+<td>^chemin-local(.*) autre-chemin$1</td>
+<td>/chemin/autre-chemin/infochemin</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) otherpath$1 [R]</td>
-<td>http://thishost/somepath/otherpath/pathinfo via external
-redirection</td>
+<td>^chemin-local(.*) autre-chemin$1 [R]</td>
+<td>http://cet-hôte/chemin/autre-chemin/infochemin via redirection
+externe</td>
</tr>
<tr>
-<td>^localpath(.*) otherpath$1 [P]</td>
-<td>doesn't make sense, not supported</td>
+<td>^chemin-local(.*) autre-chemin$1 [P]</td>
+<td>n'a pas lieu d'être, non supporté</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) /otherpath$1</td>
-<td>/otherpath/pathinfo</td>
+<td>^chemin-local(.*) /autre-chemin$1</td>
+<td>/autre-chemin/infochemin</td>
</tr>
<tr>
-<td>^localpath(.*) /otherpath$1 [R]</td>
-<td>http://thishost/otherpath/pathinfo via external redirection</td>
+<td>^chemin-local(.*) /autre-chemin$1 [R]</td>
+<td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) /otherpath$1 [P]</td>
-<td>doesn't make sense, not supported</td>
+<td>^chemin-local(.*) /autre-chemin$1 [P]</td>
+<td>n'a pas lieu d'être, non supporté</td>
</tr>
<tr>
-<td>^localpath(.*) http://thishost/otherpath$1</td>
-<td>/otherpath/pathinfo</td>
+<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1</td>
+<td>/autre-chemin/infochemin</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) http://thishost/otherpath$1 [R]</td>
-<td>http://thishost/otherpath/pathinfo via external redirection</td>
+<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R]</td>
+<td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr>
-<td>^localpath(.*) http://thishost/otherpath$1 [P]</td>
-<td>doesn't make sense, not supported</td>
+<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P]</td>
+<td>n'a pas lieu d'être, non supporté</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) http://otherhost/otherpath$1</td>
-<td>http://otherhost/otherpath/pathinfo via external redirection</td>
+<td>^chemin-local(.*) http://autre hôte/autre-chemin$1</td>
+<td>http://autre hôte/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr>
-<td>^localpath(.*) http://otherhost/otherpath$1 [R]</td>
-<td>http://otherhost/otherpath/pathinfo via external redirection (the [R] flag is redundant)</td>
+<td>^chemin-local(.*) http://autre hôte/autre-chemin$1 [R]</td>
+<td>http://autre hôte/autre-chemin/infochemin via redirection externe
+(le drapeau [R] est redondant)</td>
</tr>
<tr class="odd">
-<td>^localpath(.*) http://otherhost/otherpath$1 [P]</td>
-<td>http://otherhost/otherpath/pathinfo via internal proxy</td>
+<td>^chemin-local(.*) http://autre hôte/autre-chemin$1 [P]</td>
+<td>http://autre hôte/autre-chemin/infochemin via un mandataire interne</td>
</tr>
</table>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="inputsed" id="inputsed">Directive</a> <a name="InputSed" id="InputSed">InputSed</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command to filter request data (typically <code>POST</code> data)</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>InputSed <var>sed-command</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Commande sed à exécuter pour le filtrage des données d'une
+requête (en général des données <code>POST</code>)</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>InputSed <var>commande-sed</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#Status">Statut:</a></th><td>Expérimental</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td /></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_sed</td></tr>
</table>
- <p>The <code class="directive">InputSed</code> directive specifies the <code>sed</code> command
- to execute on the request data e.g., <code>POST</code> data.
+ <p>La directive <code class="directive">InputSed</code> permet de spécifier
+ la commande sed à exécuter pour le filtrage des données (en général
+ des données <code>POST</code>) d'une 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="outputsed" id="outputsed">Directive</a> <a name="OutputSed" id="OutputSed">OutputSed</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command for filtering response content</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>OutputSed <var>sed-command</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Commande sed pour le filtrage des contenus de type
+réponse</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>OutputSed <var>commande-sed</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#Status">Statut:</a></th><td>Expérimental</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td /></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_sed</td></tr>
</table>
- <p>The <code class="directive">OutputSed</code> directive specifies the <code>sed</code>
- command to execute on the response.
+ <p>La directive <code class="directive">OutputSed</code> permet de spécifier
+ la commande <code>sed</code> à exécuter dans le cadre du traitement
+ d'une réponse.
</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="session" id="session">Directive</a> <a name="Session" id="Session">Session</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables a session for the current directory or location</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ouvre une session pour le contexte courant</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Session On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Session 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">Session</code> directive enables a session for the
- directory or location container. Further directives control where the
- session will be stored and how privacy is maintained.</p>
+ <p>La directive <code class="directive">Session</code> permet d'ouvrir une
+ session pour le contexte ou conteneur courant. Les directives
+ suivantes permettent de définir où la session sera stockée et
+ comment sera assurée la confidentialité.</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="sessionenv" id="sessionenv">Directive</a> <a name="SessionEnv" id="SessionEnv">SessionEnv</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control whether the contents of the session are written to the
-<var>HTTP_SESSION</var> environment variable</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si le contenu de la session doit être enregistré
+dans la variable d'environnement <var>HTTP_SESSION</var></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionEnv On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionEnv 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>If set to <var>On</var>, the <code class="directive">SessionEnv</code> directive
- causes the contents of the session to be written to a CGI environment
- variable called <var>HTTP_SESSION</var>.</p>
+ <p>Lorsque la directive <code class="directive">SessionEnv</code> est
+ définie à <var>On</var>, le contenu de la session est enregistré
+ dans une variable d'environnement CGI nommée
+ <var>HTTP_SESSION</var>.</p>
- <p>The string is written in the URL query format, for example:</p>
+ <p>La chaîne est écrite sous le même format que celui de la chaîne
+ d'arguments d'une URL, comme dans l'exemple suivant :</p>
<div class="example"><p><code>
- <code>key1=foo&key3=bar</code>
+ <code>clé1=foo&clé3=bar</code>
</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="sessionexclude" id="sessionexclude">Directive</a> <a name="SessionExclude" id="SessionExclude">SessionExclude</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define URL prefixes for which a session is ignored</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionExclude <var>path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les préfixes d'URLs pour lesquels une session sera
+ignorée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionExclude <var>chemin</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">SessionExclude</code> directive allows sessions to
- be disabled relative to URL prefixes only. This can be used to make a
- website more efficient, by targeting a more precise URL space for which
- a session should be maintained. By default, all URLs within the directory
- or location are included in the session. The
- <code class="directive"><a href="#sessionexclude">SessionExclude</a></code> directive takes
- precedence over the
- <code class="directive"><a href="#sessioninclude">SessionInclude</a></code> directive.</p>
-
- <div class="warning"><h3>Warning</h3>
- <p>This directive has a similar purpose to the <var>path</var> attribute
- in HTTP cookies, but should not be confused with this attribute. This
- directive does not set the <var>path</var> attribute, which must be
- configured separately.</p></div>
+ <p>La directive <code class="directive">SessionExclude</code> permet de
+ définir les préfixes d'URLs pour lesquels la session sera
+ désactivée. Ceci peut améliorer l'efficacité d'un site web, en
+ ciblant de manière plus précise l'espace d'URL pour lequel une
+ session devra être maintenue. Par défaut, toutes les URLs du
+ contexte ou du conteneur courant sont incluses dans la session. La
+ directive <code class="directive"><a href="#sessionexclude">SessionExclude</a></code>
+ l'emporte sur la directive <code class="directive"><a href="#sessioninclude">SessionInclude</a></code>.</p>
+
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Cette directive a un comportement similaire à celui de l'attribut
+ <var>chemin</var> des cookies HTTP, mais ne doit pas être confondue
+ avec cet attribut. En effet, cette directive ne définit pas
+ l'attribut <var>chemin</var>, qui doit être configuré
+ séparément.</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="sessionexpiryupdateinterval" id="sessionexpiryupdateinterval">Directive</a> <a name="SessionExpiryUpdateInterval" id="SessionExpiryUpdateInterval">SessionExpiryUpdateInterval</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the number of seconds a session's expiry may change without
-the session being updated</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nombre de secondes dont la durée d'expiration d'une
+session peut changer sans que cette session soit mise à jour</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionExpiryUpdateInterval <var>interval</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionExpiryUpdateInterval 0 (always update)</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionExpiryUpdateInterval 0 (mise à jour systématique)</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">SessionExpiryUpdateInterval</code> directive allows
- sessions to avoid the cost associated with writing the session each request
- when only the expiry time has changed. This can be used to make a website
- more efficient or reduce load on a database when using
- <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code>. The session is always written if the data
- stored in the session has changed or the expiry has changed by more than the
- configured interval.</p>
-
- <p>Setting the interval to zero disables this directive, and the session
- expiry is refreshed for each request.</p>
-
- <p>This directive only has an effect when combined with
- <code class="directive"><a href="#sessionmaxage">SessionMaxAge</a></code> to enable session
- expiry. Sessions without an expiry are only written when the data stored in
- the session has changed.</p>
-
- <div class="warning"><h3>Warning</h3>
- <p>Because the session expiry may not be refreshed with each request, it's
- possible for sessions to expire up to <var>interval</var> seconds early.
- Using a small interval usually provides sufficient savings while having a
- minimal effect on expiry resolution.</p></div>
+ <p>La directive <code class="directive">SessionExpiryUpdateInterval</code>
+ permet d'éviter le coût de l'écriture d'une session pour chaque
+ requête en n'effectuant cette mise à jour que lorsque la date
+ d'expiration a changé. Ceci permet d'améliorer les performances d'un
+ site web ou de réduire la charge d'une base de données lorsqu'on
+ utilise <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code>. La session est
+ systématiquement mise à jour si les données stockées dans la session
+ ont été modifiées ou si la durée d'expiration a été modifiée d'une
+ durée supérieure à l'intervalle spécifié.</p>
+
+ <p>Définir l'intervalle à 0 désactive cette directive, et
+ l'expiration de la session sera alors rafraîchie pour chaque requête.</p>
+
+ <p>Cette directive n'a d'effet que si on l'utilise en combinaison
+ avec la directive <code class="directive"><a href="#sessionmaxage">SessionMaxAge</a></code> qui active
+ l'expiration des sessions. Les sessions sans date d'expiration ne
+ sont écrites que lorsque les données qu'elles renferment ont été
+ modifiées.</p>
+
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Comme l'expiration de la session n'est pas systématiquement
+ rafraîchie à chaque requête, une session peut arriver à expiration
+ plus tôt d'un nombre de secondes spécifié dans le paramètre
+ <var>interval</var>. Définir un petit intervalle est en général
+ assez sur, mais en revenche n'a qu'un effet minime sur la prise en
+ compte des durées d'expiration.</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="sessionheader" id="sessionheader">Directive</a> <a name="SessionHeader" id="SessionHeader">SessionHeader</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Import session updates from a given HTTP response header</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionHeader <var>header</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Importation des mises à jour de session depuis l'en-tête de
+réponse HTTP spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionHeader <var>en-tête</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">SessionHeader</code> directive defines the name of an
- HTTP response header which, if present, will be parsed and written to the
- current session.</p>
+ <p>La directive <code class="directive">SessionHeader</code> permet de
+ définir le nom d'un en-tête de réponse HTTP qui, s'il est présent,
+ sera lu et son contenu écrit dans la session courante.</p>
- <p>The header value is expected to be in the URL query format, for example:</p>
+ <p>Le contenu de l'en-tête doit se présenter sous le même format que
+ celui de la chaîne d'arguments d'une URL, comme dans l'exemple
+ suivant :</p>
<div class="example"><p><code>
- <code>key1=foo&key2=&key3=bar</code>
+ <code>clé1=foo&clé2=&clé3=bar</code>
</code></p></div>
- <p>Where a key is set to the empty string, that key will be removed from the
- session.</p>
+ <p>Si une clé a pour valeur la chaîne vide, elle sera supprimée de
+ la session.</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="sessioninclude" id="sessioninclude">Directive</a> <a name="SessionInclude" id="SessionInclude">SessionInclude</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define URL prefixes for which a session is valid</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionInclude <var>path</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>all URLs</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les préfixes d'URL pour lesquels une session est
+valide</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionInclude <var>chemin</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>toutes URLs</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">SessionInclude</code> directive allows sessions to
- be made valid for specific URL prefixes only. This can be used to make a
- website more efficient, by targeting a more precise URL space for which
- a session should be maintained. By default, all URLs within the directory
- or location are included in the session.</p>
-
- <div class="warning"><h3>Warning</h3>
- <p>This directive has a similar purpose to the <var>path</var> attribute
- in HTTP cookies, but should not be confused with this attribute. This
- directive does not set the <var>path</var> attribute, which must be
- configured separately.</p></div>
+ <p>La directive <code class="directive">SessionInclude</code> permet de
+ définir les préfixes d'URL spécifiques pour lesquels une session
+ sera valide. Ceci peut améliorer l'efficacité d'un site web, en
+ ciblant de manière plus précise l'espace d'URL pour lequel une
+ session devra être maintenue. Par défaut, toutes les URLs du
+ contexte ou du conteneur courant sont incluses dans la session.</p>
+
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Cette directive a un comportement similaire à celui de l'attribut
+ <var>chemin</var> des cookies HTTP, mais ne doit pas être confondue
+ avec cet attribut. En effet, cette directive ne définit pas
+ l'attribut <var>chemin</var>, qui doit être configuré séparément.</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="sessionmaxage" id="sessionmaxage">Directive</a> <a name="SessionMaxAge" id="SessionMaxAge">SessionMaxAge</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a maximum age in seconds for a session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionMaxAge <var>maxage</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une durée de vie maximale pour la session en
+secondes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionMaxAge <var>durée de vie maximale</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionMaxAge 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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session</td></tr>
</table>
- <p>The <code class="directive">SessionMaxAge</code> directive defines a time limit
- for which a session will remain valid. When a session is saved, this time
- limit is reset and an existing session can be continued. If a session
- becomes older than this limit without a request to the server to refresh
- the session, the session will time out and be removed. Where a session is
- used to stored user login details, this has the effect of logging the user
- out automatically after the given time.</p>
-
- <p>Setting the maxage to zero disables session expiry.</p>
+ <p>La directive <code class="directive">SessionMaxAge</code> permet de
+ définir la durée maximale pendant laquelle une session restera
+ valide. Lorsqu'une session est sauvegardée, cette durée est
+ réinitialisée et la session peut continuer d'exister. Si la durée
+ d'une session dépasse cette limite sans qu'une requête au serveur ne
+ vienne la rafraîchir, la session va passer hors délai et sera
+ supprimée. Lorsqu'une session est utilisée pour stocker les
+ informations de connexion d'un utilisateur, ceci aura pour effet de
+ le déconnecter automatiquement après le délai spécifié.</p>
+
+ <p>Donner à cette directive la valeur 0 empêche l'expiration de la
+ session.</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="sessioncookiename" id="sessioncookiename">Directive</a> <a name="SessionCookieName" id="SessionCookieName">SessionCookieName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2109 cookie storing the session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCookieName <var>name</var> <var>attributes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom et attributs du cookie RFC2109 dans lequel la session
+est stockée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCookieName <var>nom</var> <var>attributs</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_cookie</td></tr>
</table>
- <p>The <code class="directive">SessionCookieName</code> directive specifies the name and
- optional attributes of an RFC2109 compliant cookie inside which the session will
- be stored. RFC2109 cookies are set using the <code>Set-Cookie</code> HTTP header.
+ <p>La directive <code class="directive">SessionCookieName</code> permet de
+ spécifier le nom et les attributs optionnels d'un cookie compatible
+ RFC2109 dans lequel la session sera stockée. Les cookies RFC2109
+ sont définis en utilisant l'en-tête HTTP <code>Set-Cookie</code>.
</p>
- <p>An optional list of cookie attributes can be specified, as per the example below.
- These attributes are inserted into the cookie as is, and are not interpreted by
- Apache. Ensure that your attributes are defined correctly as per the cookie specification.
+ <p>Une liste optionnelle d'attributs peut être spécifiée, comme dans
+ l'exemple suivant. Ces attributs sont insérés tel quel dans le
+ cookie, et ne sont pas interprétés par Apache. Assurez-vous que vos
+ attributs soient définis correctement selon la spécification des
+ cookies.
</p>
- <div class="example"><h3>Cookie
with attributes</h3><pre class="prettyprint lang-config">Session On
+ <div class="example"><h3>Cookie
avec attributs</h3><pre class="prettyprint lang-config">Session On
SessionCookieName session path=/private;domain=example.com;httponly;secure;version=1;</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="sessioncookiename2" id="sessioncookiename2">Directive</a> <a name="SessionCookieName2" id="SessionCookieName2">SessionCookieName2</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2965 cookie storing the session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCookieName2 <var>name</var> <var>attributes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom et attributs pour le cookie RFC2965 dans lequel est
+stockée la session</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCookieName2 <var>nom</var> <var>attributs</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_cookie</td></tr>
</table>
- <p>The <code class="directive">SessionCookieName2</code> directive specifies the name and
- optional attributes of an RFC2965 compliant cookie inside which the session will
- be stored. RFC2965 cookies are set using the <code>Set-Cookie2</code> HTTP header.
+ <p>La directive <code class="directive">SessionCookieName2</code> permet de
+ spécifier le nom et les attributs optionnels d'un cookie compatible
+ RFC2965 dans lequel la session sera stockée. Les cookies RFC2965
+ sont définis en utilisant l'en-tête HTTP
+ <code>Set-Cookie2</code>.
</p>
- <p>An optional list of cookie attributes can be specified, as per the example below.
- These attributes are inserted into the cookie as is, and are not interpreted by
- Apache. Ensure that your attributes are defined correctly as per the cookie specification.
+ <p>Une liste optionnelle d'attributs peut être spécifiée, comme dans
+ l'exemple suivant. Ces attributs sont insérés tel quel dans le
+ cookie, et ne sont pas interprétés par Apache. Assurez-vous que vos
+ attributs soient définis correctement selon la spécification des
+ cookies.
</p>
- <div class="example"><h3>Cookie2
with attributes</h3><pre class="prettyprint lang-config">Session On
+ <div class="example"><h3>Cookie2
avec attributs</h3><pre class="prettyprint lang-config">Session On
SessionCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;</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="sessioncookieremove" id="sessioncookieremove">Directive</a> <a name="SessionCookieRemove" id="SessionCookieRemove">SessionCookieRemove</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control for whether session cookies should be removed from incoming HTTP headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les cookies de session doivent être supprimés
+des en-têtes HTTP entrants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCookieRemove On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionCookieRemove 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_cookie</td></tr>
</table>
- <p>The <code class="directive">SessionCookieRemove</code> flag controls whether the cookies
- containing the session will be removed from the headers during request processing.</p>
-
- <p>In a reverse proxy situation where the Apache server acts as a server frontend for
- a backend origin server, revealing the contents of the session cookie to the backend
- could be a potential privacy violation. When set to on, the session cookie will be
- removed from the incoming HTTP headers.</p>
+ <p>La directive <code class="directive">SessionCookieRemove</code> permet de
+ déterminer si les cookies contenant la session doivent être
+ supprimés des en-têtes pendant le traitement de la requête.</p>
+
+ <p>Dans le cas d'un mandataire inverse où le serveur Apache sert de
+ frontal à un serveur d'arrière-plan, révéler le contenu du cookie de
+ session à ce dernier peut conduire à une violation de la
+ confidentialité. A ce titre, si cette directive est définie à "on",
+ le cookie de session sera supprimé des en-têtes HTTP entrants.</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="sessioncryptocipher" id="sessioncryptocipher">Directive</a> <a name="SessionCryptoCipher" id="SessionCryptoCipher">SessionCryptoCipher</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The crypto cipher to be used to encrypt the session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoCipher <var>name</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'algorithme à utiliser pour le chiffrement de la session</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoCipher <var>algorithme</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>aes256</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_crypto</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">SessionCryptoCipher</code> directive allows the cipher to
- be used during encryption. If not specified, the cipher defaults to
- <code>aes256</code>.</p>
+ <p>La directive <code class="directive">SessionCryptoCipher</code> permet de
+ spécifier l'algorithme à utiliser pour le chiffrement. En l'absence
+ de spécification, l'algorithme par défaut est <code>aes256</code>.</p>
- <p>Possible values depend on the crypto driver in use, and could be one of:</p>
+ <p>L'algorithme peut être choisi, en fonction du moteur de chiffrement
+ utilisé, parmi les valeurs suivantes :</p>
- <ul><li>3des192</li><li>aes128</li><li>aes192</li><li>aes256</li></ul>
+ <ul><li>3des192</li><li>aes128</li><li>aes192</li><li>aes256</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="sessioncryptodriver" id="sessioncryptodriver">Directive</a> <a name="SessionCryptoDriver" id="SessionCryptoDriver">SessionCryptoDriver</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The crypto driver to be used to encrypt the session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoDriver <var>name</var> <var>[param[=value]]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le pilote de chiffrement à utiliser pour chiffrer les
+sessions</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoDriver <var>nom</var> <var>[param[=valeur]]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_crypto</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0
+d'Apache</td></tr>
</table>
- <p>The <code class="directive">SessionCryptoDriver</code> directive specifies the name of
- the crypto driver to be used for encryption. If not specified, the driver defaults
- to the recommended driver compiled into APR-util.</p>
+ <p>La directive <code class="directive">SessionCryptoDriver</code> permet de
+ spécifier le nom du pilote à utiliser pour le chiffrement. Si aucun
+ pilote n'est spécifié, le pilote utilisé par défaut sera le pilote
+ recommandé compilé avec APR-util.</p>
- <p>The <var>NSS</var> crypto driver requires some parameters for configuration,
- which are specified as parameters with optional values after the driver name.</p>
+ <p>Le pilote de chiffrement <var>NSS</var> nécessite certains
+ paramètres de configuration, qui seront spécifiés comme arguments de
+ la directive avec des valeurs optionnelles après le nom du
+ pilote.</p>
- <div class="example"><h3>NSS
without a certificate database</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss</pre>
+ <div class="example"><h3>NSS
sans base de données de certificats</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss</pre>
</div>
- <div class="example"><h3>NSS
with certificate database</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss dir=certs</pre>
+ <div class="example"><h3>NSS
avec base de données de certificats</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss dir=certs</pre>
</div>
- <div class="example"><h3>NSS with certificate database and parameters</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss dir=certs key3=key3.db cert7=cert7.db secmod=secmod</pre>
+ <div class="example"><h3>NSS avec base de données de certificats et
+ paramètres</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss dir=certs clé3=clé3.db cert7=cert7.db secmod=secmod</pre>
</div>
- <div class="example"><h3>NSS
with paths containing spaces</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss "dir=My Certs" key3=key3.db cert7=cert7.db secmod=secmod</pre>
+ <div class="example"><h3>NSS
avec chemins contenant des espaces</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss "dir=My Certs" key3=key3.db cert7=cert7.db secmod=secmod</pre>
</div>
- <p>The <var>NSS</var> crypto driver might have already been
- configured by another part of the server, for example from
- <code>mod_nss</code> or <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. If found to
- have already been configured, a warning will be logged, and the
- existing configuration will have taken affect. To avoid this
- warning, use the noinit parameter as follows.</p>
+ <p>Le pilote de chiffrement <var>NSS</var> peut avoir été configuré
+ au préalable dans une autre partie du serveur, par exemple depuis
+ <code class="module"><a href="../mod/mod_nss.html">mod_nss</a></code> ou <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. Si c'est le
+ cas, un avertissement sera enregistré dans le journal, et la
+ configuration existante s'en trouvera affectée. Pour éviter cet
+ avertissement, utilisez le paramètre noinit comme suit :</p>
- <div class="example"><h3>NSS
with certificate database</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss noinit</pre>
+ <div class="example"><h3>NSS
avec base de données de certificats</h3><pre class="prettyprint lang-config">SessionCryptoDriver nss noinit</pre>
</div>
- <p>To prevent confusion, ensure that all modules requiring NSS are configured with
- identical parameters.</p>
+ <p>Pour éviter la confusion, assurez-vous que tous les modules
+ utilisant NSS soient configurés avec des paramètres identiques.</p>
- <p>The <var>openssl</var> crypto driver supports an optional parameter to specify
- the engine to be used for encryption.</p>
+ <p>Le pilote de chiffrement <var>openssl</var> accepte un paramètre
+ optionnel permettant de spécifier le moteur de chiffrement à
+ utiliser.</p>
- <div class="example"><h3>OpenSSL with engine support</h3><pre class="prettyprint lang-config">SessionCryptoDriver openssl engine=name</pre>
+ <div class="example"><h3>OpenSSL avec spécification du moteur de chiffrement</h3><pre class="prettyprint lang-config">SessionCryptoDriver openssl engine=nom-moteur</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="sessioncryptopassphrase" id="sessioncryptopassphrase">Directive</a> <a name="SessionCryptoPassphrase" id="SessionCryptoPassphrase">SessionCryptoPassphrase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The key used to encrypt the session</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La clé utilisée pour chiffrer la session</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoPassphrase <var>secret</var> [ <var>secret</var> ... ] </code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_crypto</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0
+d'Apache</td></tr>
</table>
- <p>The <code class="directive">SessionCryptoPassphrase</code> directive specifies the keys
- to be used to enable symmetrical encryption on the contents of the session before
- writing the session, or decrypting the contents of the session after reading the
- session.</p>
-
- <p>Keys are more secure when they are long, and consist of truly random characters.
- Changing the key on a server has the effect of invalidating all existing sessions.</p>
-
- <p>Multiple keys can be specified in order to support key rotation. The first key
- listed will be used for encryption, while all keys listed will be attempted for
- decryption. To rotate keys across multiple servers over a period of time, add a new
- secret to the end of the list, and once rolled out completely to all servers, remove
- the first key from the start of the list.</p>
-
- <p>As of version 2.4.7 if the value begins with <var>exec:</var> the resulting command
- will be executed and the first line returned to standard output by the program will be
- used as the key.</p>
-<div class="example"><pre>#key used as-is
+ <p>La directive <code class="directive">SessionCryptoPassphrase</code>
+ permet de spécifier les clés à utiliser pour chiffrer de manière
+ symétrique le contenu de la session avant de l'enregistrer, ou pour
+ déchiffrer le contenu de la session après sa lecture.</p>
+
+ <p>L'utilisation de clés longues et composées de caractères vraiment
+ aléatoires est plus performant en matière de sécurité. Modifier une
+ clé sur un serveur a pour effet d'invalider toutes les sessions
+ existantes.</p>
+
+ <p>Il est possible de spécifier plusieurs clés afin de mettre en
+ oeuvre la rotation de clés. La première clé spécifiée sera utilisée
+ pour le chiffrement, alors que l'ensemble des clés spécifiées le
+ sera pour le déchiffrement. Pour effectuer une rotation périodique
+ des clés sur plusieurs serveurs, ajoutez une nouvelle clé en fin de
+ liste, puis, une fois la rotation complète effectuée, supprimez la
+ première clé de la liste.</p>
+
+ <p>Depuis la version 2.4.7, si la valeur de l'argument commence par
+ <var>exec:</var> , la commande
+ spécifiée sera exécutée, et la première ligne que cette dernière
+ renverra sur la sortie standard sera utilisée comme clé.</p>
+<div class="example"><pre># clé spécifiée et utilisée en tant que tel
SessionCryptoPassphrase secret
-#Run /path/to/program to get key
+# exécution de /path/to/program pour générer la clé
SessionCryptoPassphrase exec:/path/to/program
-#Run /path/to/otherProgram and provide arguments
+# exécution de /path/to/program avec un argument pour générer la clé
SessionCryptoPassphrase "exec:/path/to/otherProgram argument1"</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="sessioncryptopassphrasefile" id="sessioncryptopassphrasefile">Directive</a> <a name="SessionCryptoPassphraseFile" id="SessionCryptoPassphraseFile">SessionCryptoPassphraseFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File containing keys used to encrypt the session</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoPassphraseFile <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le fichier contenant les clés utilisées pour chiffrer la
+session</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionCryptoPassphraseFile <var>nom-fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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>Expérimental</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_crypto</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache 2.3.0 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
- <p>The <code class="directive">SessionCryptoPassphraseFile</code> directive specifies the
- name of a configuration file containing the keys to use for encrypting or decrypting
- the session, specified one per line. The file is read on server start, and a graceful
- restart will be necessary for httpd to pick up changes to the keys.</p>
-
- <p>Unlike the <code class="directive">SessionCryptoPassphrase</code> directive, the keys are
- not exposed within the httpd configuration and can be hidden by protecting the file
- appropriately.</p>
-
- <p>Multiple keys can be specified in order to support key rotation. The first key
- listed will be used for encryption, while all keys listed will be attempted for
- decryption. To rotate keys across multiple servers over a period of time, add a new
- secret to the end of the list, and once rolled out completely to all servers, remove
- the first key from the start of the list.</p>
+ <p>La directive <code class="directive">SessionCryptoPassphraseFile</code>
+ permet de spécifier le nom d'un fichier de configuration contenant
+ les clés à utiliser pour le chiffrement et le déchiffrement de la
+ session (une clé par ligne). Le fichier est lu au démarrage du
+ serveur, et un redémarrage graceful est nécessaire pour prendre en
+ compte un éventuel changement de clés.</p>
+
+ <p>A la différence de la directive
+ <code class="directive">SessionCryptoPassphrase</code>, les clés ne sont pas
+ présentes dans le fichier de configuration de httpd et peuvent être
+ cachées via une protection appropriée du fichier de clés.</p>
+
+ <p>Il est possible de spécifier plusieurs clés afin de mettre en
+ oeuvre la rotation de clés. La première clé spécifiée sera utilisée
+ pour le chiffrement, alors que l'ensemble des clés spécifiées le
+ sera pour le déchiffrement. Pour effectuer une rotation périodique
+ des clés sur plusieurs serveurs, ajoutez une nouvelle clé en fin de
+ liste, puis, une fois la rotation complète effectuée, supprimez la
+ première clé de la liste.</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="sessiondbdcookiename" id="sessiondbdcookiename">Directive</a> <a name="SessionDBDCookieName" id="SessionDBDCookieName">SessionDBDCookieName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2109 cookie storing the session ID</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDCookieName <var>name</var> <var>attributes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom et attributs du cookie RFC2109 qui contient
+l'identifiant de session</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDCookieName <var>nom</var> <var>attributs</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDCookieName</code> directive specifies the name and
- optional attributes of an RFC2109 compliant cookie inside which the session ID will
- be stored. RFC2109 cookies are set using the <code>Set-Cookie</code> HTTP header.
+ <p>La directive <code class="directive">SessionDBDCookieName</code> permet
+ de spécifier le nom et les attributs optionnels d'un cookie
+ compatible RFC2109 qui contiendra l'identifiant de session. Les
+ cookies RFC2109 sont définis à l'aide de l'en-tête HTTP
+ <code>Set-Cookie</code>.
</p>
- <p>An optional list of cookie attributes can be specified, as per the example below.
- These attributes are inserted into the cookie as is, and are not interpreted by
- Apache. Ensure that your attributes are defined correctly as per the cookie specification.
+ <p>Une liste optionnelle d'attributs peut être spécifiée pour ce
+ cookie, comme dans l'exemple ci-dessous. Ces attributs sont insérés
+ dans le cookie tel quel, et ne sont pas interprétés par Apache.
+ Assurez-vous que vos attributs sont définis correctement selon la
+ spécification des cookies.
</p>
- <div class="example"><h3>Cookie
with attributes</h3><pre class="prettyprint lang-config">Session On
+ <div class="example"><h3>Cookie
avec attributs</h3><pre class="prettyprint lang-config">Session On
SessionDBDCookieName session path=/private;domain=example.com;httponly;secure;version=1;</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="sessiondbdcookiename2" id="sessiondbdcookiename2">Directive</a> <a name="SessionDBDCookieName2" id="SessionDBDCookieName2">SessionDBDCookieName2</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2965 cookie storing the session ID</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDCookieName2 <var>name</var> <var>attributes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom et attributs du cookie RFC2965 qui contient
+l'identifiant de session</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDCookieName2 <var>nom</var> <var>attributs</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDCookieName2</code> directive specifies the name and
- optional attributes of an RFC2965 compliant cookie inside which the session ID will
- be stored. RFC2965 cookies are set using the <code>Set-Cookie2</code> HTTP header.
+ <p>La directive <code class="directive">SessionDBDCookieName2</code> permet
+ de spécifier le nom et les attributs optionnels d'un cookie
+ compatible RFC2965 qui contiendra l'identifiant de session. Les
+ cookies RFC2965 sont définis à l'aide de l'en-tête HTTP
+ <code>Set-Cookie2</code>.
</p>
- <p>An optional list of cookie attributes can be specified, as per the example below.
- These attributes are inserted into the cookie as is, and are not interpreted by
- Apache. Ensure that your attributes are defined correctly as per the cookie specification.
+ <p>Une liste optionnelle d'attributs peut être spécifiée pour ce
+ cookie, comme dans l'exemple ci-dessous. Ces attributs sont insérés
+ dans le cookie tel quel, et ne sont pas interprétés par Apache.
+ Assurez-vous que vos attributs sont définis correctement selon la
+ spécification des cookies.
</p>
- <div class="example"><h3>Cookie2
with attributes</h3><pre class="prettyprint lang-config">Session On
+ <div class="example"><h3>Cookie2
avec attributs</h3><pre class="prettyprint lang-config">Session On
SessionDBDCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;</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="sessiondbdcookieremove" id="sessiondbdcookieremove">Directive</a> <a name="SessionDBDCookieRemove" id="SessionDBDCookieRemove">SessionDBDCookieRemove</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control for whether session ID cookies should be removed from incoming HTTP headers</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les cookies de session doivent être supprimés
+des en-têtes HTTP entrants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDCookieRemove On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDCookieRemove 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>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDCookieRemove</code> flag controls whether the cookies
- containing the session ID will be removed from the headers during request processing.</p>
+ <p>La directive <code class="directive">SessionDBDCookieRemove</code> permet
+ de déterminer si les cookies contenant l'identifiant de session
+ doivent être supprimés des en-têtes pendant le traitement de la
+ requête.</p>
- <p>In a reverse proxy situation where the Apache server acts as a server frontend for
- a backend origin server, revealing the contents of the session ID cookie to the backend
- could be a potential privacy violation. When set to on, the session ID cookie will be
- removed from the incoming HTTP headers.</p>
+ <p>Dans le cas d'un mandataire inverse où le serveur Apache sert de
+ frontal à un serveur d'arrière-plan, révéler le contenu du cookie de
+ session à ce dernier peut conduire à une violation de la
+ confidentialité. A ce titre, si cette directive est définie à "on",
+ le cookie de session sera supprimé des en-têtes HTTP entrants.</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="sessiondbddeletelabel" id="sessiondbddeletelabel">Directive</a> <a name="SessionDBDDeleteLabel" id="SessionDBDDeleteLabel">SessionDBDDeleteLabel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to remove sessions from the database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDDeleteLabel <var>label</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La requête SQL à utiliser pour supprimer des sessions de la
+base de données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDDeleteLabel <var>étiquette</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDDeleteLabel deletesession</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDDeleteLabel</code> directive sets the default delete
- query label to be used to delete an expired or empty session. This label must have been previously
- defined using the <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
+ <p>La directive <code class="directive">SessionDBDDeleteLabel</code> permet
+ de définir l'étiquette de la requête de suppression à utiliser par
+ défaut pour supprimer une session vide ou expirée. Cette
+ étiquette doit avoir été définie au préalable via une directive
+ <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</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="sessiondbdinsertlabel" id="sessiondbdinsertlabel">Directive</a> <a name="SessionDBDInsertLabel" id="SessionDBDInsertLabel">SessionDBDInsertLabel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to insert sessions into the database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDInsertLabel <var>label</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La requête SQL à utiliser pour insérer des sessions dans la
+base de données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDInsertLabel <var>étiquette</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDInsertLabel insertsession</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDInsertLabel</code> directive sets the default insert
- query label to be used to load in a session. This label must have been previously defined using the
- <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
+ <p>La directive <code class="directive">SessionDBDInsertLabel</code> permet
+ de définir l'étiquette de la requête d'insertion par défaut à
+ charger dans une session. Cette
+ étiquette doit avoir été définie au préalable via une directive
+ <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code>.</p>
- <p>If an attempt to update the session affects no rows, this query will be called to insert the
- session into the database.</p>
+ <p>Si une tentative de mise à jour d'une session ne concerne aucun
+ enregistrement, c'est cette requête qui sera utilisée pour insérer
+ la session dans la base de donné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="sessiondbdperuser" id="sessiondbdperuser">Directive</a> <a name="SessionDBDPerUser" id="SessionDBDPerUser">SessionDBDPerUser</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable a per user session</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active une session propre à un utilisateur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDPerUser On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDPerUser 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDPerUser</code> flag enables a per user session keyed
- against the user's login name. If the user is not logged in, this directive will be
- ignored.</p>
+ <p>La directive <code class="directive">SessionDBDPerUser</code> permet
+ d'activer une session propre à un utilisateur, dont la clé sera le
+ nom de l'utilisateur connecté. Si l'utilisateur n'est pas connecté,
+ la directive sera ignoré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="sessiondbdselectlabel" id="sessiondbdselectlabel">Directive</a> <a name="SessionDBDSelectLabel" id="SessionDBDSelectLabel">SessionDBDSelectLabel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to select sessions from the database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDSelectLabel <var>label</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La requête SQL à utiliser pour sélectionner des sessions
+dans la base de données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDSelectLabel <var>étiquette</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDSelectLabel selectsession</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDSelectLabel</code> directive sets the default select
- query label to be used to load in a session. This label must have been previously defined using the
- <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
+ <p>La directive <code class="directive">SessionDBDSelectLabel</code> permet
+ de définir l'étiquette de la requête de sélection par défaut à
+ utiliser pour charger une session. Cette étiquette doit avoir été
+ définie au préalable via une directive <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</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="sessiondbdupdatelabel" id="sessiondbdupdatelabel">Directive</a> <a name="SessionDBDUpdateLabel" id="SessionDBDUpdateLabel">SessionDBDUpdateLabel</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to update existing sessions in the database</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDUpdateLabel <var>label</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La requête SQL à utiliser pour mettre à jour des sessions
+préexistantes dans la base de données</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SessionDBDUpdateLabel <var>étiquette</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SessionDBDUpdateLabel updatesession</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
</table>
- <p>The <code class="directive">SessionDBDUpdateLabel</code> directive sets the default update
- query label to be used to load in a session. This label must have been previously defined using the
- <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
-
- <p>If an attempt to update the session affects no rows, the insert query will be
- called to insert the session into the database. If the database supports InsertOrUpdate,
- override this query to perform the update in one query instead of two.</p>
+ <p>La directive <code class="directive">SessionDBDUpdateLabel</code> permet
+ de définir l'étiquette de la requête de mise à jour par défaut à
+ charger dans une session. Cette
+ étiquette doit avoir été définie au préalable via une directive
+ <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code>.</p>
+
+ <p>Si une tentative de mise à jour d'une session ne concerne aucun
+ enregistrement, c'est la requête d'insertion qui sera appelée pour
+ insérer la session dans la base de données. Si la base de données
+ supporte InsertOrUpdate, modifiez cette requête pour effectuer la
+ mise à jour en une seule requête au lieu de deux.</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="browsermatch" id="browsermatch">Directive</a> <a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables conditional on HTTP User-Agent
-</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>]
-[[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement en fonction du
+contenu de l'en-tête HTTP User-Agent</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatch <em>regex [!]env-variable</em>[=<em>valeur</em>]
+[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_setenvif</td></tr>
</table>
- <p>The <code class="directive">BrowserMatch</code> is a special cases of the
- <code class="directive"><a href="#setenvif">SetEnvIf</a></code> directive that
- sets environment variables conditional on the
- <code>User-Agent</code> HTTP request header. The following two
- lines have the same effect:</p>
+ <p>La directive <code class="directive">BrowserMatch</code> est un cas
+ particulier de la directive <code class="directive"><a href="#setenvif">SetEnvIf</a></code>, qui définit des variables
+ d'environnement en fonction du contenu de l'en-tête de requête HTTP
+ <code>User-Agent</code>. Les deux lignes suivantes produisent le même
+ effet :</p>
<pre class="prettyprint lang-config">BrowserMatch Robot is_a_robot
SetEnvIf User-Agent Robot is_a_robot</pre>
- <p>Some additional examples:</p>
+ <p>Quelques exemples supplémentaires :</p>
<pre class="prettyprint lang-config">BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="browsermatchnocase" id="browsermatchnocase">Directive</a> <a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables conditional on User-Agent without
-respect to case</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>value</em>]
- [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement en fonction du
+contenu de l'en-tête HTTP User-Agent sans tenir compte de la
+casse</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>valeur</em>]
+ [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_setenvif</td></tr>
</table>
- <p>The <code class="directive">BrowserMatchNoCase</code> directive is
- semantically identical to the <code class="directive"><a href="#browsermatch">BrowserMatch</a></code> directive.
- However, it provides for case-insensitive matching. For
- example:</p>
+ <p>La directive <code class="directive">BrowserMatchNoCase</code> est
+ identique sur le plan sémantique à la directive <code class="directive"><a href="#browsermatch">BrowserMatch</a></code>. Elle permet
+ cependant une comparaison insensible à la casse. Par exemple :</p>
<pre class="prettyprint lang-config">BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows</pre>
- <p>The <code class="directive">BrowserMatch</code> and
- <code class="directive">BrowserMatchNoCase</code> directives are special cases of
- the <code class="directive"><a href="#setenvif">SetEnvIf</a></code> and <code class="directive"><a href="#setenvifnocase">SetEnvIfNoCase</a></code>
- directives. The following two lines have the same effect:</p>
+ <p>Les directives <code class="directive">BrowserMatch</code> et
+ <code class="directive">BrowserMatchNoCase</code> sont des cas particuliers
+ des directives <code class="directive"><a href="#setenvif">SetEnvIf</a></code>
+ et <code class="directive"><a href="#setenvifnocase">SetEnvIfNoCase</a></code>.
+ Ainsi, les deux lignes suivantes produisent le même effet :</p>
<pre class="prettyprint lang-config">BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="setenvif" id="setenvif">Directive</a> <a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on attributes of the request
-</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIf <em>attribute
- regex [!]env-variable</em>[=<em>value</em>]
- [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement en fonction des
+attributs de la requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIf <em>attribut
+ regex [!]env-variable</em>[=<em>valeur</em>]
+ [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_setenvif</td></tr>
</table>
- <p>The <code class="directive">SetEnvIf</code> directive defines
- environment variables based on attributes of the request. The
- <em>attribute</em> specified in the first argument can be one of the
- following things:</p>
+ <p>La directive <code class="directive">SetEnvIf</code> permet de définir
+ des variables d'environnement en fonction des attributs de la
+ requête. L'<em>attribut</em> spécifié comme premier argument peut
+ se présenter sous l'une des formes suivantes :</p>
<ol>
-<li>An HTTP request header field (see <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a>
- for more information about these); for example: <code>Host</code>,
- <code>User-Agent</code>, <code>Referer</code>, and
- <code>Accept-Language</code>. A regular expression may be
- used to specify a set of request headers.</li>
-
-<li>One of the following aspects of the request:
+<li>Un champ d'en-tête de requête HTTP (voir la <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a> pour
+ plus d'information à leur propos) ; par exemple : <code>Host</code>,
+ <code>User-Agent</code>, <code>Referer</code>, ou
+ <code>Accept-Language</code>. Il est possible d'utiliser une
+ expression rationnelle pour spécifier un jeu d'en-têtes de
+ requête.</li>
+
+<li>Une des caractéristiques de la requête suivantes :
<ul>
- <li><code>Remote_Host</code> - the hostname (if available) of
- the client making the request</li>
-
- <li><code>Remote_Addr</code> - the IP address of the client
- making the request</li>
-
- <li><code>Server_Addr</code> - the IP address of the server
- on which the request was received (only with versions later
- than 2.0.43)</li>
-
- <li><code>Request_Method</code> - the name of the method
- being used (<code>GET</code>, <code>POST</code>, <em>et
- cetera</em>)</li>
-
- <li><code>Request_Protocol</code> - the name and version of
- the protocol with which the request was made (<em>e.g.</em>,
- "HTTP/0.9", "HTTP/1.1", <em>etc.</em>)</li>
-
- <li><code>Request_URI</code> - the resource requested on the HTTP
- request line -- generally the portion of the URL
- following the scheme and host portion without the query string. See
- the <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
- directive of <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> for extra information on
- how to match your query string.</li>
+ <li><code>Remote_Host</code> - le nom d'hôte (s'il est disponible)
+ du client qui effectue la requête</li>
+
+ <li><code>Remote_Addr</code> - l'adresse IP du client qui effectue
+ la requête</li>
+
+ <li><code>Server_Addr</code> - l'adresse IP du serveur qui a reçu
+ la requête (uniquement à partir des versions supérieures à
+ 2.0.43)</li>
+
+ <li><code>Request_Method</code> - Le nom de la méthode HTTP
+ utilisée (<code>GET</code>, <code>POST</code>, <em>et
+ cetera...</em>)</li>
+
+ <li><code>Request_Protocol</code> - le nom et la version du
+ protocole utilisé pour la requête (par exemple "HTTP/0.9",
+ "HTTP/1.1", <em>etc...</em>)</li>
+
+ <li><code>Request_URI</code> - la ressource demandée dans la ligne
+ de requête HTTP -- en général la partie de l'URL suivant le
+ protocole et le nom du serveur, sans la chaîne d'arguments. Voir
+ la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> du module
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour plus d'informations sur la
+ manière de mettre en correspondance votre chaîne d'arguments.</li>
</ul>
</li>
-<li>The name of an environment variable in the list of those
-associated with the request. This allows
-<code class="directive">SetEnvIf</code> directives to test against the result
-of prior matches. Only those environment variables defined by earlier
-<code>SetEnvIf[NoCase]</code> directives are available for testing in
-this manner. 'Earlier' means that they were defined at a broader scope
-(such as server-wide) or previously in the current directive's scope.
-Environment variables will be considered only if there was no match
-among request characteristics and a regular expression was not
-used for the <em>attribute</em>.</li>
+<li>Le nom d'une variable d'environnement parmi la liste de celles qui
+sont associées à la requête. Ceci permet à la directive
+<code class="directive">SetEnvIf</code> d'effectuer des tests en fonction du
+résultat de comparaisons précédentes. Seules les variables
+d'environnement définies par des directives
+<code>SetEnvIf[NoCase]</code> précédentes sont disponibles pour
+effectuer des tests de cette manière. 'Précédentes' signifie qu'elles se
+trouvent à un niveau plus global de la configuration (par exemple au
+niveau du serveur principal), ou plus haut chronologiquement dans le
+contexte de la directive. Les variables d'environnement ne seront prises
+en compte que si aucune correspondance n'a été trouvée parmi les
+caractéristiques de la requête, et si <em>attribut</em> n'a pas été
+spécifié sous la forme d'une expression rationnelle.</li>
</ol>
-<p>The second argument (<em>regex</em>) is a <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>. If the <em>regex</em>
-matches against the <em>attribute</em>, then the remainder of the
-arguments are evaluated.</p>
+<p>Le second argument (<em>regex</em>) est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Si <em>regex</em>
+correspond à l'<em>attribut</em>, les arguments suivants sont évalués.</p>
-<p>The rest of the arguments give the names of variables to set, and
-optionally values to which they should be set. These take the form
-of</p>
+<p>Le reste des arguments constitue les noms des variables à définir,
+ainsi que les valeurs optionnelles qui doivent leur être affectées. Ils
+peuvent se présenter sous les formes suivantes :</p>
<ol>
- <li><code><em>varname</em></code>, or</li>
+ <li><code><em>nom-variable</em></code>, ou</li>
- <li><code>!<em>varname</em></code>, or</li>
+ <li><code>!<em>nom-variable</em></code>, ou</li>
- <li><code><em>varname</em>=<em>value</em></code></li>
+ <li><code><em>nom-variable</em>=<em>valeur</em></code></li>
</ol>
- <p>In the first form, the value will be set to "1". The second
- will remove the given variable if already defined, and the
- third will set the variable to the literal value given by
- <code><em>value</em></code>. Since version 2.0.51, Apache httpd will
- recognize occurrences of <code>$1</code>..<code>$9</code> within
- <var>value</var> and replace them by parenthesized subexpressions
- of <var>regex</var>. <code>$0</code> provides access to the whole
- string matched by that pattern.</p>
+ <p>Dans la première forme, la valeur sera définie à "1". Dans la
+ seconde forme, la variable sera supprimée si elle a été définie au
+ préalable, et dans la troisième forme, la variable sera définie à la
+ valeur littérale spécifiée par <code><em>valeur</em></code>. Depuis
+ la version 2.0.51, Apache httpd reconnaît les occurrences de variables
+ <code>$1</code>..<code>$9</code> à l'intérieur de
+ <code><em>valeur</em></code>, et les remplace par les
+ sous-expressions entre parenthèses correspondantes de
+ <var>regex</var>. <code>$0</code> permet d'accéder à l'ensemble de la chaîne
+ qui correspond à ce modèle.</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
-
+
SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral
-
+
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1
-
+
SetEnvIf ^TS ^[a-z] HAVE_TS</pre>
- <p>The first three will set the environment variable
- <code>object_is_image</code> if the request was for an image
- file, and the fourth sets <code>intra_site_referral</code> if
- the referring page was somewhere on the
- <code>www.mydomain.example.com</code> Web site.</p>
+ <p>Les trois premières lignes définissent la variable
+ d'environnement <code>objet_est_une_image</code> si l'objet de la
+ requête est un fichier image, et la quatrième définit la variable
+ <code>intra_site_referral</code> si la page référante se trouve
+ quelque part dans le site web
+ <code>www.mydomain.example.com</code>.</p>
- <p>The last example will set environment variable
- <code>HAVE_TS</code> if the request contains any headers that
- begin with "TS" whose values begins with any character in the
- set [a-z].</p>
+ <p>La dernière ligne définit la variable d'environnement
+ <code>HAVE_TS</code> si la requête contient un en-tête dont le nom
+ commence par "TS" et dont la valeur commence par tout caractère du
+ jeu [a-z].</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../env.html">Environment Variables in Apache HTTP Server</a>,
-for additional examples.
+<li><a href="../env.html">Les variables d'environnement et le
+serveur HTTP Apache</a> pour des exemples supplémentaires.
</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="setenvifexpr" id="setenvifexpr">Directive</a> <a name="SetEnvIfExpr" id="SetEnvIfExpr">SetEnvIfExpr</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on an ap_expr expression</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement en fonction d'une expression ap_expr</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIfExpr <em>expr
- [!]env-variable</em>[=<em>value</em>]
- [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
+ [!]env-variable</em>[=<em>valeur</em>]
+ [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_setenvif</td></tr>
</table>
- <p>The <code class="directive">SetEnvIfExpr</code> directive defines
- environment variables based on an <code class="directive"><a href="../mod/core.html#if"><If></a></code>
- <code>ap_expr</code>. These expressions will be evaluated at runtime,
- and applied <em>env-variable</em> in the same fashion as <code class="directive">SetEnvIf</code>.</p>
+ <p>La directive <code class="directive">SetEnvIfExpr</code> permet de
+ définir des variables d'environnement en fonction d'une expression
+ <code class="directive"><a href="../mod/core.html#if"><If></a></code> <code>ap_expr</code>. Cette
+ expression est évaluée à l'exécution, et utilise les variables
+ d'environnement <em>env-variable</em> de la même manière que la
+ directive <code class="directive">SetEnvIf</code>.</p>
<pre class="prettyprint lang-config">SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered</pre>
- <p>This would set the environment variable <code>iso_delivered</code>
- every time our application attempts to send it via <code>X-Sendfile</code></p>
+ <p>Dans cet exemple, la variable d'environnement
+ <code>iso_delivered</code> est définie chaque fois que notre
+ application tente de l'envoyer via <code>X-Sendfile</code>.</p>
- <p>A more useful example would be to set the variable rfc1918 if the
- remote IP address is a private address according to RFC 1918:</p>
+ <p>Il pourrait être plus utile de définir une variable rfc1918 si
+ l'adresse IP distante est une adresse privée au sens de la RFC 1918
+ :</p>
<pre class="prettyprint lang-config">SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918</pre>
<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><code class="directive"><a href="../mod/core.html#if"><If></a></code> can be used to achieve similar
-results.</li>
+<li><a href="../expr.html">Les expressions dans le serveur HTTP
+Apache</a>, pour une référence complète et davantage d'exemples.</li>
+<li>La directive <code class="directive"><a href="../mod/core.html#if"><If></a></code> permet d'obtenir des résultats
+similaires.</li>
<li><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></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="setenvifnocase" id="setenvifnocase">Directive</a> <a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets environment variables based on attributes of the request
-without respect to case</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIfNoCase <em>attribute regex
- [!]env-variable</em>[=<em>value</em>]
- [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement en fonction des
+attributs de la requête sans tenir compte de la casse</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIfNoCase <em>attribut regex
+ [!]env-variable</em>[=<em>valeur</em>]
+ [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_setenvif</td></tr>
</table>
- <p>The <code class="directive">SetEnvIfNoCase</code> is semantically identical to
- the <code class="directive"><a href="#setenvif">SetEnvIf</a></code> directive,
- and differs only in that the regular expression matching is
- performed in a case-insensitive manner. For example:</p>
+ <p>La directive <code class="directive">SetEnvIfNoCase</code> est identique
+ d'un point de vue sémantique à la directive <code class="directive"><a href="#setenvif">SetEnvIf</a></code>, et ne s'en distingue que
+ par le fait que la comparaison des expressions rationnelles est
+ effectuée sans tenir compte de la casse. Par exemple :</p>
<pre class="prettyprint lang-config">SetEnvIfNoCase Host Example\.Org site=example</pre>
- <p>This will cause the <code>site</code> environment variable
- to be set to "<code>example</code>" if the HTTP request header
- field <code>Host:</code> was included and contained
- <code>Example.Org</code>, <code>example.org</code>, or any other
- combination.</p>
+ <p>Cette ligne va définir la variable d'environnement
+ <code>site</code> avec la valeur "<code>example</code>" si le champ
+ d'en-tête de requête HTTP <code>Host:</code> est présent et contient
+ <code>Example.Org</code>, <code>example.org</code>, ou une autre
+ combinaison des mêmes caractères, sans tenir compte de la casse.</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="loadfile" id="loadfile">Directive</a> <a name="LoadFile" id="LoadFile">LoadFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Link in the named object file or library</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadFile <em>filename</em> [<em>filename</em>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison du fichier objet ou de la bibliothèque
+spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_so</td></tr>
</table>
- <p>The <code class="directive">LoadFile</code> directive links in the named object files or
- libraries when the server is started or restarted; this is used
- to load additional code which may be required for some module
- to work. <em>Filename</em> is either an absolute path or
- relative to <a href="core.html#serverroot">ServerRoot</a>.</p>
+ <p>La directive <code class="directive">LoadFile</code> permet de lier le fichier
+ objet ou la bibliothèque spécifié au serveur lors du
+ démarrage ou du redémarrage
+ de ce dernier ; ceci permet d'ajouter tout code additionnel
+ nécessaire au fonctionnement d'un module.
+ <em>nom-fichier</em> est soit un chemin absolu, soit un chemin
+ relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</p>
- <p>For example:</p>
+ <p>Par exemple:</p>
<pre class="prettyprint lang-config">LoadFile "libexec/libxmlparse.so"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="loadmodule" id="loadmodule">Directive</a> <a name="LoadModule" id="LoadModule">LoadModule</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Links in the object file or library, and adds to the list
-of active modules</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadModule <em>module filename</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison avec le serveur du fichier objet ou de la
+bibliothèque spécifié, et ajout de ce dernier à la liste des modules
+actifs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadModule <em>module nom-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_so</td></tr>
</table>
- <p>The <code class="directive">LoadModule</code> directive links in the object file or library
- <em>filename</em> and adds the module structure named
- <em>module</em> to the list of active modules. <em>Module</em>
- is the name of the external variable of type
- <code>module</code> in the file, and is listed as the <a href="module-dict.html#ModuleIdentifier">Module Identifier</a>
- in the module documentation.</p>
+ <p>La directive <code class="directive">LoadModule</code> permet de lier le fichier objet ou la
+ bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la
+ structure de module nommée <em>module</em> à la liste des modules
+ actifs. <em>module</em> est le nom de la variable externe de type
+ <code>module</code> dans le fichier, et est référencé comme <a href="module-dict.html#ModuleIdentifier">Identificateur de
+ module</a> dans la documentation des modules.</p>
- <p>For example:</p>
+ <p>Par exemple :</p>
- <pre class="prettyprint lang-config">LoadModule status_module "modules/mod_status.so"</pre>
+ <pre class="prettyprint lang-config">LoadModule "status_module modules/mod_status.so"</pre>
- <p>loads the named module from the modules subdirectory of the
- ServerRoot.</p>
+ <p>charge le module spécifié depuis le sous-répertoire des modules
+ situé à la racine du serveur.</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="memcacheconnttl" id="memcacheconnttl">Directive</a> <a name="MemcacheConnTTL" id="MemcacheConnTTL">MemcacheConnTTL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keepalive time for idle connections</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de conservation des connexions inactives</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MemcacheConnTTL <em>num[units]</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MemcacheConnTTL 15s</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_socache_memcache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in 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>Set the time to keep idle connections with the memcache server(s)
- alive (threaded platforms only).</p>
+ <p>Définit la durée pendant laquelle les connexions
+ inactives avec le(s) serveur(s) memcache seront conservées
+ (plateformes threadées seulement).</p>
- <p>Valid values for <code class="directive">MemcacheConnTTL</code> are times
- up to one hour. 0 means no timeout.</p>
+ <p>Les valeurs valides de la directive
+ <code class="directive">MemcacheConnTTL</code> sont des durées d'une heure
+ maximum. La valeur 0 signifie une absence de péremption</p>
- <div class="note"><p>This timeout defaults to units of seconds, but accepts
- suffixes for milliseconds (ms), seconds (s), minutes (min), and hours (h).
+ <div class="note"><p>L'unité par défaut pour ce délai est la seconde, mais vous
+ pouvez ajouter un suffixe pour spécifier une unité différente ; ms
+ pour milliseconde, s pour seconde, min pour minute et h pour heure..
</p></div>
- <p>Before Apache 2.4.17, this timeout was hardcoded and its value was 600 usec.
- So, the closest configuration to match the legacy behaviour is to set
- <code class="directive">MemcacheConnTTL</code> to 1ms.</p>
+ <p>Dans les versions antérieures à 2.4.17, ce délai était codé en
+ dur et sa valeur était 600 microsecondes. La valeur la plus proche
+ de cette ancienne valeur pour la directive
+ <code class="directive">MemcacheConnTTL</code> est donc 1ms.</p>
- <div class="example"><pre class="prettyprint lang-config"># Set a timeout of 10 minutes
+ <div class="example"><pre class="prettyprint lang-config"># Définition d'un délai de 10 minutes
MemcacheConnTTL 10min
-# Set a timeout of 60 seconds
+# Définition d'un délai de 60 secondes
MemcacheConnTTL 60</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="checkbasenamematch" id="checkbasenamematch">Directive</a> <a name="CheckBasenameMatch" id="CheckBasenameMatch">CheckBasenameMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Also match files with differing file name extensions.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie aussi la correspondance des fichiers, même avec des
+extensions différentes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CheckBasenameMatch on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CheckBasenameMatch 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_speling</td></tr>
</table>
- <p>When set, this directive extends the action of the spelling correction
- to the file name extension. For example a file <code>foo.gif</code> will
- match a request for <code>foo</code> or <code>foo.jpg</code>. This can be
- particulary useful in conjunction with
- <a href="../content-negotiation.html">MultiViews</a>.</p>
+ <p>Cette option n'a aucun effet si
+ <code class="directive">CheckCaseOnly</code> a été défini.</p>
+
+ <p>Lorsqu'elle est définie, cette directive étend le processus de correction
+ orthographique à l'extension des noms de fichiers. Par exemple, un fichier
+ de nom <code>foo.gif</code> sera pris en compte par une requête pour
+ <code>foo</code> ou <code>foo.jpg</code>. Ceci peut s'avérer
+ particulièrement utile en conjonction avec les <a href="../content-negotiation.html">MultiViews</a>.</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="checkcaseonly" id="checkcaseonly">Directive</a> <a name="CheckCaseOnly" id="CheckCaseOnly">CheckCaseOnly</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limits the action of the speling module to case corrections</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite l'action du module aux corrections de
+majuscules</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CheckCaseOnly on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CheckCaseOnly 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_speling</td></tr>
</table>
- <p>When set, this directive limits the action of the spelling correction
- to lower/upper case changes. Other potential corrections are not performed,
- except when <code class="directive">CheckBasenameMatch</code> is also set.</p>
+ <p>Lorsqu'elle est définie à "on", cette directive permet de limiter
+ l'action du module aux inversions majuscule/minuscule. Les autres
+ corrections ne sont pas effectuées sauf si la directive
+ <code class="directive">CheckBasenameMatch</code> est aussi à "on"..</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="checkspelling" id="checkspelling">Directive</a> <a name="CheckSpelling" id="CheckSpelling">CheckSpelling</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables the spelling
-module</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le module de correction</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CheckSpelling on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CheckSpelling 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_speling</td></tr>
</table>
- <p>This directive enables or disables the spelling module. When
- enabled, keep in mind that</p>
+ <p>Cette directive permet d'activer ou de désactiver le module de
+ correction. Lorsqu'il est activé, rappelez-vous que :</p>
<ul>
- <li>the directory scan which is necessary for the spelling
- correction will have an impact on the server's performance
- when many spelling corrections have to be performed at the
- same time.</li>
-
- <li>the document trees should not contain sensitive files
- which could be matched inadvertently by a spelling
- "correction".</li>
-
- <li>the module is unable to correct misspelled user names (as
- in <code>http://my.host/~apahce/</code>), just file names or
- directory names.</li>
-
- <li>spelling corrections apply strictly to existing files, so
- a request for the <code><Location /status></code> may
- get incorrectly treated as the negotiated file
- "<code>/stats.html</code>".</li>
+ <li>le parcours du répertoire nécessaire à la correction aura un
+ impact sur les performances du serveur lorsque de nombreuses
+ corrections devront être effectuées au même moment.</li>
+
+ <li>l'arborescence ne doit pas contenir de documents
+ sensibles qui pourraient être considérés par erreur comme
+ correspondant à la requête.</li>
+
+ <li>le module ne corrige pas les noms d'utilisateur mal
+ orthographiés (comme dans
+ <code>http://mon.serveur/~apahce/</code>), mais seulement les noms
+ de fichiers ou de répertoires.</li>
+
+ <li>les corrections s'appliquent strictement aux fichiers
+ existants, si bien qu'une requête pour <code><Location
+ /status></code> pour être traitée de manière incorrecte comme
+ une requête pour le fichier négocié "<code>/stats.html</code>".</li>
</ul>
- <p>mod_speling should not be enabled in <a href="mod_dav.html">DAV</a>
- enabled directories, because it will try to "spell fix" newly created
- resource names against existing filenames, e.g., when trying to upload
- a new document <code>doc43.html</code> it might redirect to an existing
- document <code>doc34.html</code>, which is not what was intended.
+ <p>mod_speling ne doit pas être activé pour des répertoires où <a href="mod_dav.html">DAV</a> l'est aussi, car il va essayer de
+ "corriger" les noms des ressources nouvellement créées en fonction
+ des noms de fichiers existants ; par exemple, lors du chargement
+ d'un nouveau document <code>doc43.html</code>, il est possible qu'il
+ redirige vers un document existant <code>doc34.html</code>, ce qui
+ ne correspond pas à ce que l'on souhaite.
</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="sslcacertificatefile" id="sslcacertificatefile">Directive</a> <a name="SSLCACertificateFile" id="SSLCACertificateFile">SSLCACertificateFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
-for Client Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCACertificateFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant une concaténation des certificats de CA
+codés en PEM pour l'authentification des clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCACertificateFile <em>chemin-fichier</em></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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the <em>all-in-one</em> file where you can assemble the
-Certificates of Certification Authorities (CA) whose <em>clients</em> you deal
-with. These are used for Client Authentication. Such a file is simply the
-concatenation of the various PEM-encoded Certificate files, in order of
-preference. This can be used alternatively and/or additionally to
-<code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code>.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-client.crt"</pre>
+Cette directive permet de définir le fichier <em>tout-en-un</em> où vous
+pouvez rassembler les certificats des Autorités de Certification (CAs)
+pour les clients auxquels vous avez à faire. On les utilise pour
+l'authentification des clients. Un tel fichier contient la simple
+concaténation des différents fichiers de certificats codés en PEM, par
+ordre de préférence. Cette directive peut être utilisée à la place et/ou
+en complément de la directive <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code>.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-client.crt"</pre>
</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="sslcacertificatepath" id="sslcacertificatepath">Directive</a> <a name="SSLCACertificatePath" id="SSLCACertificatePath">SSLCACertificatePath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
-Client Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCACertificatePath <em>directory-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire des certificats de CA codés en PEM pour
+l'authentification des clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCACertificatePath <em>chemin-répertoire</em></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#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the directory where you keep the Certificates of
-Certification Authorities (CAs) whose clients you deal with. These are used to
-verify the client certificate on Client Authentication.</p>
+Cette directive permet de définir le répertoire où sont stockés les
+certificats des Autorités de Certification (CAs) pour les clients
+auxquels vous avez à faire. On les utilise pour vérifier le certificat
+du client au cours de l'authentification de ce dernier.</p>
<p>
-The files in this directory have to be PEM-encoded and are accessed through
-hash filenames. So usually you can't just place the Certificate files
-there: you also have to create symbolic links named
-<em>hash-value</em><code>.N</code>. And you should always make sure this directory
-contains the appropriate symbolic links.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt/"</pre>
+Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Il ne
+suffit donc pas de placer les fichiers de certificats dans ce répertoire
+: vous devez aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.N</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt/"</pre>
</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="sslcadnrequestfile" id="sslcadnrequestfile">Directive</a> <a name="SSLCADNRequestFile" id="SSLCADNRequestFile">SSLCADNRequestFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
-for defining acceptable CA names</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCADNRequestFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la concaténation des certificats de CA
+codés en PEM pour la définition de noms de CA acceptables</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCADNRequestFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>When a client certificate is requested by mod_ssl, a list of
-<em>acceptable Certificate Authority names</em> is sent to the client
-in the SSL handshake. These CA names can be used by the client to
-select an appropriate client certificate out of those it has
-available.</p>
+<p>Lorsque mod_ssl demande un certificat client, une liste de <em>noms
+d'Autorités de Certification acceptables</em> est envoyée au client au
+cours de la phase d'initialisation de la connexion SSL. Le client peut
+alors utiliser cette liste de noms de CA pour sélectionner un certificat
+client approprié parmi ceux dont il dispose.</p>
-<p>If neither of the directives <code class="directive"><a href="#sslcadnrequestpath">SSLCADNRequestPath</a></code> or <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> are given, then the
-set of acceptable CA names sent to the client is the names of all the
-CA certificates given by the <code class="directive"><a href="#sslcacertificatefile">SSLCACertificateFile</a></code> and <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code> directives; in other
-words, the names of the CAs which will actually be used to verify the
-client certificate.</p>
+<p>Si aucune des directives <code class="directive"><a href="#sslcadnrequestpath">SSLCADNRequestPath</a></code> ou <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> n'est définie, la liste
+de noms de CsA acceptables envoyée au client est la liste des noms de
+tous les certificats de CA spécifiés par les directives <code class="directive"><a href="#sslcacertificatefile">SSLCACertificateFile</a></code> et <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code> ; en d'autres termes,
+c'est la liste des noms de CAs qui sera effectivement utilisée pour
+vérifier le certificat du client.</p>
-<p>In some circumstances, it is useful to be able to send a set of
-acceptable CA names which differs from the actual CAs used to verify
-the client certificate - for example, if the client certificates are
-signed by intermediate CAs. In such cases, <code class="directive"><a href="#sslcadnrequestpath">SSLCADNRequestPath</a></code> and/or <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> can be used; the
-acceptable CA names are then taken from the complete set of
-certificates in the directory and/or file specified by this pair of
+<p>Dans certaines situations, il est utile de pouvoir envoyer
+une liste de noms de CA acceptables qui diffère de la liste des CAs
+effectivement utilisés pour vérifier le certificat du client ;
+considérons par exemple le cas où le certificat du client est signé par
+des CAs intermédiaires. On peut ici utiliser les directives <code class="directive"><a href="#sslcadnrequestpath">SSLCADNRequestPath</a></code> et/ou <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code>, et les noms de CA
+acceptables seront alors extraits de l'ensemble des certificats contenus
+dans le répertoire et/ou le fichier définis par cette paire de
directives.</p>
-<p><code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> must
-specify an <em>all-in-one</em> file containing a concatenation of
-PEM-encoded CA certificates.</p>
+<p><code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> doit
+spécifier un fichier <em>tou-en-un</em> contenant une concaténation des
+certificats de CA codés en PEM.</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLCADNRequestFile "/usr/local/apache2/conf/ca-names.crt"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLCADNRequestFile "/usr/local/apache2/conf/ca-names.crt"</pre>
</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="sslcadnrequestpath" id="sslcadnrequestpath">Directive</a> <a name="SSLCADNRequestPath" id="SSLCADNRequestPath">SSLCADNRequestPath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
-defining acceptable CA names</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCADNRequestPath <em>directory-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire contenant des fichiers de certificats de CA
+codés en PEM pour la définition de noms de CA acceptables</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCADNRequestPath <em>chemin-répertoire</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This optional directive can be used to specify the set of
-<em>acceptable CA names</em> which will be sent to the client when a
-client certificate is requested. See the <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> directive for more
-details.</p>
+<p>Cette directive optionnelle permet de définir la liste de <em>noms de
+CAs acceptables</em> qui sera envoyée au client lorsqu'un certificat de
+client est demandé. Voir la directive <code class="directive"><a href="#sslcadnrequestfile">SSLCADNRequestFile</a></code> pour plus de
+détails.</p>
-<p>The files in this directory have to be PEM-encoded and are accessed
-through hash filenames. So usually you can't just place the
-Certificate files there: you also have to create symbolic links named
-<em>hash-value</em><code>.N</code>. And you should always make sure
-this directory contains the appropriate symbolic links.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCADNRequestPath "/usr/local/apache2/conf/ca-names.crt/"</pre>
+<p>Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Il ne
+suffit donc pas de placer les fichiers de certificats dans ce répertoire
+: vous devez aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.N</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCADNRequestPath "/usr/local/apache2/conf/ca-names.crt/"</pre>
</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="sslcarevocationcheck" id="sslcarevocationcheck">Directive</a> <a name="SSLCARevocationCheck" id="SSLCARevocationCheck">SSLCARevocationCheck</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable CRL-based revocation checking</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la vérification des révocations basée sur les CRL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCARevocationCheck chain|leaf|none <em>flag</em>s</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLCARevocationCheck none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Optional <em>flag</em>s available in httpd 2.4.21 or
-later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le paramètre optionnel <em>flag</em>s est disponible à partir de
+la version 2.4.21 du serveur HTTP Apache</td></tr>
</table>
<p>
-Enables certificate revocation list (CRL) checking. At least one of
-<code class="directive"><a href="#sslcarevocationfile">SSLCARevocationFile</a></code>
-or <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code> must be
-configured. When set to <code>chain</code> (recommended setting),
-CRL checks are applied to all certificates in the chain, while setting it to
-<code>leaf</code> limits the checks to the end-entity cert.
+Active la vérification des révocations basée sur les Listes de
+Révocations de Certificats (CRL). Au moins une des directives <code class="directive"><a href="#sslcarevocationfile">SSLCARevocationFile</a></code> ou <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code> doit être définie.
+Lorsque cette directive est définie à <code>chain</code> (valeur
+recommandée), les vérifications CRL sont effectuées sur tous les
+certificats de la chaîne, alors que la valeur <code>leaf</code> limite
+la vérification au certificat hors chaîne (la feuille).
</p>
-<p>The available <em>flag</em>s are:</p>
+<div class="note">
+<h3>Lorsque la directive est définie à <code>chain</code> ou
+<code>leaf</code>, les CRLs doivent être disponibles pour que la
+validation réussisse</h3>
+<p>
+Avant la version 2.3.15, les vérifications CRL dans mod_ssl
+réussissaient même si aucune CRL n'était trouvée dans les chemins
+définis par les directives <code class="directive"><a href="#sslcarevocationfile">SSLCARevocationFile</a></code> ou <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code>. Le comportement a
+changé avec l'introduction de cette directive : lorsque la vérification
+est activée, les CRLs <em>doivent</em> être présentes pour que la
+validation réussisse ; dans le cas contraire, elle échouera avec une
+erreur <code>"CRL introuvable"</code>.
+</p>
+</div>
+
+<p>Les <em>drapeau</em>x disponibles sont :</p>
<ul>
<li><code>no_crl_for_cert_ok</code>
<p>
- Prior to version 2.3.15, CRL checking in mod_ssl also succeeded when
- no CRL(s) for the checked certificate(s) were found in any of the locations
- configured with <code class="directive"><a href="#sslcarevocationfile">SSLCARevocationFile</a></code>
- or <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code>.
+ Avant la version 2.3.15, les vérifications CRL dans mod_ssl
+réussissaient même si aucune CRL pour le/les certificat(s) vérifié(s) n'était
+trouvée dans les chemins définis par les directives <code class="directive"><a href="#sslcarevocationfile">SSLCARevocationFile</a></code> ou <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code>.
</p>
<p>
- With the introduction of <code class="directive">SSLCARevocationFile</code>,
- the behavior has been changed: by default with <code>chain</code> or
- <code>leaf</code>, CRLs <strong>must</strong> be present for the
- validation to succeed - otherwise it will fail with an
- <code>"unable to get certificate CRL"</code> error.
+ Ce comportement a changé avec l'introduction de cette directive ; par défaut
+ avec <code>chain</code> ou <code>leaf</code>, les CRLs doivent être présents
+ pour que la validation réussisse ; si ce n'est pas le cas, elle échouera
+ avec une erreur <code>"unable to get certificate CRL"</code>.
</p>
<p>
- The <em>flag</em> <code>no_crl_for_cert_ok</code> allows to restore
- previous behaviour.
+ Le <em>drapeau</em> <code>no_crl_for_cert_ok</code> permet de rétablir le
+ comportement précédent.
</p>
</li>
</ul>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCARevocationCheck chain</pre>
+
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCARevocationCheck chain</pre>
</div>
-<div class="example"><h3>Compatibilit
y with versions 2.2</h3><pre class="prettyprint lang-config">SSLCARevocationCheck chain no_crl_for_cert_ok</pre>
+<div class="example"><h3>Compatibilit
é avec les versions 2.2</h3><pre class="prettyprint lang-config">SSLCARevocationCheck chain no_crl_for_cert_ok</pre>
</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="sslcarevocationfile" id="sslcarevocationfile">Directive</a> <a name="SSLCARevocationFile" id="SSLCARevocationFile">SSLCARevocationFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA CRLs for
-Client Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCARevocationFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la concaténation des CRLs des CA codés en
+PEM pour l'authentification des clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCARevocationFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the <em>all-in-one</em> file where you can
-assemble the Certificate Revocation Lists (CRL) of Certification
-Authorities (CA) whose <em>clients</em> you deal with. These are used
-for Client Authentication. Such a file is simply the concatenation of
-the various PEM-encoded CRL files, in order of preference. This can be
-used alternatively and/or additionally to <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code>.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-client.crl"</pre>
+Cette directive permet de définir le fichier <em>tout-en-un</em> où sont
+rassemblées les Listes de Révocation de Certificats (CRLs) des Autorités
+de certification (CAs) pour les clients auxquels vous avez à faire. On
+les utilise pour l'authentification des clients. Un tel fichier contient
+la simple concaténation des différents fichiers de CRLs codés en PEM,
+dans l'ordre de préférence. Cette directive peut être utilisée à la
+place et/ou en complément de la directive <code class="directive"><a href="#sslcarevocationpath">SSLCARevocationPath</a></code>.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-client.crl"</pre>
</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="sslcarevocationpath" id="sslcarevocationpath">Directive</a> <a name="SSLCARevocationPath" id="SSLCARevocationPath">SSLCARevocationPath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA CRLs for
-Client Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCARevocationPath <em>directory-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire des CRLs de CA codés en PEM pour
+l'authentification des clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCARevocationPath <em>chemin-répertoire</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the directory where you keep the Certificate Revocation
-Lists (CRL) of Certification Authorities (CAs) whose clients you deal with.
-These are used to revoke the client certificate on Client Authentication.</p>
+Cette directive permet de définir le répertoire où sont stockées les
+Listes de Révocation de Certificats (CRL) des Autorités de Certification
+(CAs) pour les clients auxquels vous avez à faire. On les utilise pour
+révoquer les certificats des clients au cours de l'authentification de
+ces derniers.</p>
<p>
-The files in this directory have to be PEM-encoded and are accessed through
-hash filenames. So usually you have not only to place the CRL files there.
-Additionally you have to create symbolic links named
-<em>hash-value</em><code>.rN</code>. And you should always make sure this directory
-contains the appropriate symbolic links.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl/"</pre>
+Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Il ne
+suffit donc pas de placer les fichiers de CRL dans ce répertoire
+: vous devez aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.N</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl/"</pre>
</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="sslcertificatechainfile" id="sslcertificatechainfile">Directive</a> <a name="SSLCertificateChainFile" id="SSLCertificateChainFile">SSLCertificateChainFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of PEM-encoded Server CA Certificates</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateChainFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant les certificats de CA du serveur codés en
+PEM</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateChainFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<div class="note"><h3>SSLCertificateChainFile is deprecated</h3>
-<p><code>SSLCertificateChainFile</code> became obsolete with version 2.4.8,
-when <code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>
-was extended to also load intermediate CA certificates from the server
-certificate file.</p>
+<div class="note"><h3>SSLCertificateChainFile est obsolète</h3>
+<p><code>SSLCertificateChainFile</code> est devenue obsolète avec la
+version 2.4.8, lorsque la directive
+<code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code> a été étendue
+pour supporter aussi les certificats de CA intermédiaires dans le
+fichier de certificats du serveur.</p>
</div>
<p>
-This directive sets the optional <em>all-in-one</em> file where you can
-assemble the certificates of Certification Authorities (CA) which form the
-certificate chain of the server certificate. This starts with the issuing CA
-certificate of the server certificate and can range up to the root CA
-certificate. Such a file is simply the concatenation of the various
-PEM-encoded CA Certificate files, usually in certificate chain order.</p>
+Cette directive permet de définir le fichier optionnel
+<em>tout-en-un</em> où vous pouvez rassembler les certificats des
+Autorités de Certification (CA) qui forment la chaîne de certification
+du certificat du serveur. Cette chaîne débute par le certificat de la CA
+qui a délivré le certificat du serveur et peut remonter jusqu'au
+certificat de la CA racine. Un tel fichier contient la simple
+concaténation des différents certificats de CA codés en PEM, en général
+dans l'ordre de la chaîne de certification.</p>
+<p>Elle doit être utilisée à la place et/ou en complément de la
+directive <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code>
+pour construire explicitement la chaîne de certification du serveur qui
+est envoyée au navigateur en plus du certificat du serveur. Elle s'avère
+particulièrement utile pour éviter les conflits avec les certificats de
+CA lorsqu'on utilise l'authentification du client. Comme le fait de
+placer un certificat de CA de la chaîne de certification du serveur dans
+la directive <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code> produit le même effet
+pour la construction de la chaîne de certification, cette directive a
+pour effet colatéral de faire accepter les certificats clients fournis
+par cette même CA, au cours de l'authentification du client.</p>
<p>
-This should be used alternatively and/or additionally to <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code> for explicitly
-constructing the server certificate chain which is sent to the browser
-in addition to the server certificate. It is especially useful to
-avoid conflicts with CA certificates when using client
-authentication. Because although placing a CA certificate of the
-server certificate chain into <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code> has the same effect
-for the certificate chain construction, it has the side-effect that
-client certificates issued by this same CA certificate are also
-accepted on client authentication.</p>
-<p>
-But be careful: Providing the certificate chain works only if you are using a
-<em>single</em> RSA <em>or</em> DSA based server certificate. If you are
-using a coupled RSA+DSA certificate pair, this will work only if actually both
-certificates use the <em>same</em> certificate chain. Else the browsers will be
-confused in this situation.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCertificateChainFile "/usr/local/apache2/conf/ssl.crt/ca.crt"</pre>
+Soyez cependant prudent : fournir la chaîne de certification ne
+fonctionne que si vous utilisez un <em>simple</em> certificat de
+serveur RSA <em>ou</em> DSA. Si vous utilisez une paire de certificats
+couplés RSA+DSA , cela ne fonctionnera que si les deux certificats
+utilisent vraiment <em>la même</em> chaîne de certification. Dans le cas
+contraire, la confusion risque de s'installer au niveau des
+navigateurs.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCertificateChainFile "/usr/local/apache2/conf/ssl.crt/ca.crt"</pre>
</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="sslcertificatefile" id="sslcertificatefile">Directive</a> <a name="SSLCertificateFile" id="SSLCertificateFile">SSLCertificateFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Server PEM-encoded X.509 certificate data file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier de données contenant les informations de certificat X.509 du serveur
+codées au format PEM</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive points to a file with certificate data in PEM format.
-At a minimum, the file must include an end-entity (leaf) certificate.
-The directive can be used multiple times (referencing different filenames)
-to support multiple algorithms for server authentication - typically
-RSA, DSA, and ECC. The number of supported algorithms depends on the
-OpenSSL version being used for mod_ssl: with version 1.0.0 or later,
-<code>openssl list-public-key-algorithms</code> will output a list
-of supported algorithms, see also the note below about limitations
-of OpenSSL versions prior to 1.0.2 and the ways to work around them.
+Cette directive permet de définir le fichier de données contenant
+les informations de certificat
+X.509 du serveur codées au format PEM. Ce fichier doit contenir
+au minimum un certificat d'entité finale (feuille).
+La directive peut être utilisée plusieurs fois (elle référence des
+fichiers différents) pour accepter plusieurs algorithmes
+d'authentification au niveau du serveur - souvent RSA, DSA et ECC. Le
+nombre d'algorithmes supportés dépend de la version d'OpenSSL utilisée
+avec mod_ssl : à partir de la version 1.0.0, la commande <code>openssl
+list-public-key-algorithms</code> affiche la liste des algorithmes
+supportés. Voir aussi la note ci-dessous à propos des limitations des versions
+d'OpenSSL antérieures à 1.0.2 et la manière de les contourner.
</p>
-<p>
-The files may also include intermediate CA certificates, sorted from
-leaf to root. This is supported with version 2.4.8 and later,
-and obsoletes <code class="directive"><a href="#sslcertificatechainfile">SSLCertificateChainFile</a></code>.
-When running with OpenSSL 1.0.2 or later, this allows
-to configure the intermediate CA chain on a per-certificate basis.
+<p>Les fichiers peuvent aussi contenir des certificats de CA
+intermédiaires triés depuis la feuille vers la racine. Cette
+fonctionnalité est disponible depuis la version 2.4.8 du serveur HTTP
+Apache, et rend obsolète la directive <code class="directive"><a href="#sslcertificatechainfile">SSLCertificateChainFile</a></code>. A partir de la
+version 1.0.2 d'OpenSSL, il est alors possible de configurer la chaîne
+de certification en fonction du certificat.</p>
+
+<p>Depuis la version 2.4.7 du serveur HTTP Apache, on peut aussi ajouter
+des paramètres DH personnalisés et un nom EC
+curve pour les clés éphémères à la fin du premier fichier défini par la
+directive <code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>.
+Ces paramètres peuvent être générés avec les commandes <code>openssl
+dhparam</code> et <code>openssl ecparam</code>, et ils peuvent être
+ajoutés tel quel à la fin du premier fichier de certificat. En effet,
+seul le premier fichier de certificat défini peut être utilisé pour
+enregistrer des paramètres personnalisés, car ces derniers s'appliquent
+indépendamment de l'algorithme d'authentification utilisé.
</p>
-<p>
-Custom DH parameters and an EC curve name for ephemeral keys,
-can also be added to end of the first file configured using
-<code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>.
-This is supported in version 2.4.7 or later.
-Such parameters can be generated using the commands
-<code>openssl dhparam</code> and <code>openssl ecparam</code>.
-The parameters can be added as-is to the end of the first
-certificate file. Only the first file can be used for custom
-parameters, as they are applied independently of the authentication
-algorithm type.
-</p>
-
-<p>
-Finally the end-entity certificate's private key can also be
-added to the certificate file instead of using a separate
-<code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>
-directive. This practice is highly discouraged. If it is used,
-the certificate files using such an embedded key must be configured
-after the certificates using a separate key file. If the private
-key is encrypted, the pass phrase dialog is forced at startup time.
+<p>Enfin, il est aussi possible d'ajouter la clé privée du certificat de
+l'entité finale au fichier de certificat, ce qui permet de se passer
+d'une directive <code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code> séparée. Cette
+pratique est cependant fortement déconseillée. En effet, les fichiers de
+certificats qui contiennent de tels clés embarquées doivent être définis
+avant les certificats en utilisant un fichier de clé séparé. En outre,
+si la clé est chiffrée, une boîte de dialogue pour entrer le mot de
+passe de la clé s'ouvre au démarrage du serveur.
</p>
<div class="note">
-<h3>DH parameter interoperability with primes > 1024 bit</h3>
-<p>
-Beginning with version 2.4.7, mod_ssl makes use of
-standardized DH parameters with prime lengths of 2048, 3072 and 4096 bits
-and with additional prime lengths of 6144 and 8192 bits beginning with
-version 2.4.10
-(from <a href="http://www.ietf.org/rfc/rfc3526.txt">RFC 3526</a>), and hands
-them out to clients based on the length of the certificate's RSA/DSA key.
-With Java-based clients in particular (Java 7 or earlier), this may lead
-to handshake failures - see this
-<a href="../ssl/ssl_faq.html#javadh">FAQ answer</a> for working around
-such issues.
+<h3>Interopérabilité des paramètres DH avec les nombres premiers de
+plus de 1024 bits</h3>
+<p>
+Depuis la version 2.4.7, mod_ssl utilise des
+paramètres DH standardisés avec des nombres premiers de 2048, 3072 et
+4096 bits, et avec des nombres premiers de 6144 et 8192 bits depuis la
+version 2.4.10 (voir <a href="http://www.ietf.org/rfc/rfc3526.txt">RFC
+3526</a>), et les fournit aux clients en fonction de la longueur de la
+clé du certificat RSA/DSA. En particulier avec les clients basés sur
+Java (versions 7 et antérieures), ceci peut provoquer des erreurs au
+cours de la négociation - voir cette <a href="../ssl/ssl_faq.html#javadh">réponse de la FAQ SSL</a> pour
+contourner les problèmes de ce genre.
</p>
</div>
<div class="note">
-<h3>Default DH parameters when using multiple certificates and OpenSSL
-versions prior to 1.0.2</h3>
-<p>
-When using multiple certificates to support different authentication algorithms
-(like RSA, DSA, but mainly ECC) and OpenSSL prior to 1.0.2, it is recommended
-to either use custom DH parameters (preferably) by adding them to the
-first certificate file (as described above), or to order the
-<code class="directive">SSLCertificateFile</code> directives such that RSA/DSA
-certificates are placed <strong>after</strong> the ECC one.
+<h3>Paramètres DH par défaut lorsqu'on utilise plusieurs certificats et une
+version d'OpenSSL antérieure à 1.0.2.</h3>
+<p>
+Lorsqu'on utilise plusieurs certificats pour supporter différents algorithmes
+d'authentification (comme RSA, DSA, mais principalement ECC) et une
+version d'OpenSSL antérieure à 1.0.2, il est recommandé soit d'utiliser des
+paramètres DH spécifiques (solution à privilégier) en les ajoutant au premier
+fichier certificat (comme décrit ci-dessus), soit d'ordonner les directives
+<code class="directive">SSLCertificateFile</code> de façon à ce que les certificats
+RSA/DSA soit placés <strong>après</strong> les certificats ECC.
</p>
<p>
-This is due to a limitation in older versions of OpenSSL which don't let the
-Apache HTTP Server determine the currently selected certificate at handshake
-time (when the DH parameters must be sent to the peer) but instead always
-provide the last configured certificate. Consequently, the server may select
-default DH parameters based on the length of the wrong certificate's key (ECC
-keys are much smaller than RSA/DSA ones and their length is not relevant for
-selecting DH primes).
+Cette limitation est présente dans les anciennes versions d'OpenSSL qui
+présentent toujours le dernier certificat configuré, au lieu
+de laisser le serveur HTTP Apache déterminer le certificat sélectionné lors de
+la phase de négociation de la connexion (lorsque les paramètres DH doivent être
+envoyés à l'hôte distant).
+De ce fait, le serveur peut sélectionner des paramètres DH par défaut basés sur
+la longueur de la clé du mauvais certificat (les clés ECC sont beaucoup plus
+petites que les clés RSA/DSA et leur longueur n'est pas pertinente pour la
+sélection des nombres premiers DH).
</p>
<p>
-Since custom DH parameters always take precedence over the default ones, this
-issue can be avoided by creating and configuring them (as described above),
-thus using a custom/suitable length.
+Ce problème peut être résolu en créant et configurant des paramètres DH
+spécifiques (comme décrit ci-dessus), car ils l'emportent toujours sur les
+paramètres DH par défaut, et vous pourrez ainsi utiliser une longueur spécifique
+et appropriée.
</p>
</div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLCertificateFile "/usr/local/apache2/conf/ssl.crt/server.crt"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLCertificateFile "/usr/local/apache2/conf/ssl.crt/server.crt"</pre>
</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="sslcertificatekeyfile" id="sslcertificatekeyfile">Directive</a> <a name="SSLCertificateKeyFile" id="SSLCertificateKeyFile">SSLCertificateKeyFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Server PEM-encoded private key file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateKeyFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la clé privée du serveur codée en
+PEM</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCertificateKeyFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive points to the PEM-encoded private key file for the
-server. If the contained private key is encrypted, the pass phrase
-dialog is forced at startup time.</p>
+Cette directive permet de définir le fichier contenant la clé privée du
+serveur codée en PEM. Si la clé privée est
+chiffrée, une boîte de dialogue demandant le mot de passe de cette
+dernière s'ouvre au démarrage du serveur.</p>
<p>
-The directive can be used multiple times (referencing different filenames)
-to support multiple algorithms for server authentication. For each
-<code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>
-directive, there must be a matching <code class="directive">SSLCertificateFile</code>
-directive.</p>
+Cette directive peut être utilisée plusieurs fois pour référencer
+différents noms de fichiers, afin de supporter plusieurs algorithmes
+pour l'authentification du serveur. A chaque directive <code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code> doit être associée
+une directive <code class="directive">SSLCertificateFile</code> correspondante.</p>
<p>
-The private key may also be combined with the certificate in the file given by
-<code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>, but this practice
-is highly discouraged. If it is used, the certificate files using such
-an embedded key must be configured after the certificates using a separate
-key file.</p>
+La clé privé peut aussi être ajoutée au fichier défini par la directive
+<code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>, mais cette
+pratique est fortement déconseillée. En effet, les fichiers de
+certificats qui comportent une telle clé doivent être définis après les
+certificats en utilisant un fichier de clé séparé.</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLCertificateKeyFile "/usr/local/apache2/conf/ssl.key/server.key"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLCertificateKeyFile "/usr/local/apache2/conf/ssl.key/server.key"</pre>
</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="sslciphersuite" id="sslciphersuite">Directive</a> <a name="SSLCipherSuite" id="SSLCipherSuite">SSLCipherSuite</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cipher Suite available for negotiation in SSL
-handshake</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCipherSuite <em>cipher-spec</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLCipherSuite DEFAULT (depends on OpenSSL version)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Algorithmes de chiffrement disponibles pour la négociation
+au cours de l'initialisation de la connexion SSL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCipherSuite <em>algorithmes</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLCipherSuite DEFAULT (dépend de la version d'OpenSSL
+installée)</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This complex directive uses a colon-separated <em>cipher-spec</em> string
-consisting of OpenSSL cipher specifications to configure the Cipher Suite the
-client is permitted to negotiate in the SSL handshake phase. Notice that this
-directive can be used both in per-server and per-directory context. In
-per-server context it applies to the standard SSL handshake when a connection
-is established. In per-directory context it forces a SSL renegotiation with the
-reconfigured Cipher Suite after the HTTP request was read but before the HTTP
-response is sent.</p>
+Cette directive complexe utilise la chaîne <em>algorithmes</em>
+contenant la liste des algorithmes de chiffrement OpenSSL que le client
+peut utiliser au cours de la phase d'initialisation de la connexion SSL.
+Notez que cette directive peut être utilisée aussi bien dans un contexte
+de serveur que dans un contexte de répertoire. Dans un contexte de
+serveur, elle s'applique à l'initialisation SSL standard lorsqu'une
+connexion est établie. Dans un contexte de répertoire, elle force une
+renégociation SSL avec la liste d'algorithmes de chiffrement spécifiée
+après la lecture d'une requête HTTP, mais avant l'envoi de la réponse
+HTTP.</p>
<p>
-An SSL cipher specification in <em>cipher-spec</em> is composed of 4 major
-attributes plus a few extra minor ones:</p>
+La liste d'algorithmes de chiffrement SSL spécifiée par l'argument
+<em>algorithmes</em> comporte quatre attributs principaux auxquels
+s'ajoutent quelques attributs secondaires :</p>
<ul>
-<li><em>Key Exchange Algorithm</em>:<br />
- RSA, Diffie-Hellman, Elliptic Curve Diffie-Hellman, Secure Remote Password
+<li><em>Algorithme d'échange de clés</em>:<br />
+ RSA, Diffie-Hellman, Elliptic Curve Diffie-Hellman, Secure Remote Password.
</li>
-<li><em>Authentication Algorithm</em>:<br />
- RSA, Diffie-Hellman, DSS, ECDSA, or none.
+<li><em>Algorithme d'authentification</em>:<br />
+ RSA, Diffie-Hellman, DSS, ECDSA, ou none.
</li>
-<li><em>Cipher/Encryption Algorithm</em>:<br />
- AES, DES, Triple-DES, RC4, RC2, IDEA, etc.
+<li><em>Algorithme de chiffrement</em>:<br />
+ AES, DES, Triple-DES, RC4, RC2, IDEA, etc...
</li>
-<li><em>MAC Digest Algorithm</em>:<br />
- MD5, SHA or SHA1, SHA256, SHA384.
+<li><em>Algorithme de condensé MAC</em>:<br />
+ MD5, SHA ou SHA1, SHA256, SHA384.
</li>
</ul>
-<p>An SSL cipher can also be an export cipher. SSLv2 ciphers are no longer
-supported. To specify which ciphers to use, one can either specify all the
-Ciphers, one at a time, or use aliases to specify the preference and order
-for the ciphers (see <a href="#table1">Table
-1</a>). The actually available ciphers and aliases depends on the used
-openssl version. Newer openssl versions may include additional ciphers.</p>
+<p>L'algorithme de chiffrement peut aussi provenir de l'extérieur. Les
+algorithmes SSLv2 ne sont plus supportés.
+Pour définir les algorithmes à utiliser, on
+peut soit spécifier tous les algorithmes à la fois, soit utiliser des
+alias pour spécifier une liste d'algorithmes dans leur ordre de
+préférence (voir <a href="#table1">Table 1</a>). Les algorithmes et
+alias effectivement disponibles dépendent de la version d'openssl
+utilisée. Les versions ultérieures d'openssl sont susceptibles d'inclure
+des algorithmes supplémentaires.</p>
<table class="bordered">
-<tr><th><a name="table1">Tag</a></th> <th>Description</th></tr>
-<tr><td colspan="2"><em>Key Exchange Algorithm:</em></td></tr>
-<tr><td><code>kRSA</code></td> <td>RSA key exchange</td></tr>
-<tr><td><code>kDHr</code></td> <td>Diffie-Hellman key exchange with RSA key</td></tr>
-<tr><td><code>kDHd</code></td> <td>Diffie-Hellman key exchange with DSA key</td></tr>
-<tr><td><code>kEDH</code></td> <td>Ephemeral (temp.key) Diffie-Hellman key exchange (no cert)</td> </tr>
-<tr><td><code>kSRP</code></td> <td>Secure Remote Password (SRP) key exchange</td></tr>
-<tr><td colspan="2"><em>Authentication Algorithm:</em></td></tr>
-<tr><td><code>aNULL</code></td> <td>No authentication</td></tr>
-<tr><td><code>aRSA</code></td> <td>RSA authentication</td></tr>
-<tr><td><code>aDSS</code></td> <td>DSS authentication</td> </tr>
-<tr><td><code>aDH</code></td> <td>Diffie-Hellman authentication</td></tr>
-<tr><td colspan="2"><em>Cipher Encoding Algorithm:</em></td></tr>
-<tr><td><code>eNULL</code></td> <td>No encryption</td> </tr>
-<tr><td><code>NULL</code></td> <td>alias for eNULL</td> </tr>
-<tr><td><code>AES</code></td> <td>AES encryption</td> </tr>
-<tr><td><code>DES</code></td> <td>DES encryption</td> </tr>
-<tr><td><code>3DES</code></td> <td>Triple-DES encryption</td> </tr>
-<tr><td><code>RC4</code></td> <td>RC4 encryption</td> </tr>
-<tr><td><code>RC2</code></td> <td>RC2 encryption</td> </tr>
-<tr><td><code>IDEA</code></td> <td>IDEA encryption</td> </tr>
-<tr><td colspan="2"><em>MAC Digest Algorithm</em>:</td></tr>
-<tr><td><code>MD5</code></td> <td>MD5 hash function</td></tr>
-<tr><td><code>SHA1</code></td> <td>SHA1 hash function</td></tr>
-<tr><td><code>SHA</code></td> <td>alias for SHA1</td> </tr>
-<tr><td><code>SHA256</code></td> <td>SHA256 hash function</td> </tr>
-<tr><td><code>SHA384</code></td> <td>SHA384 hash function</td> </tr>
-<tr><td colspan="2"><em>Aliases:</em></td></tr>
-<tr><td><code>SSLv3</code></td> <td>all SSL version 3.0 ciphers</td> </tr>
-<tr><td><code>TLSv1</code></td> <td>all TLS version 1.0 ciphers</td> </tr>
-<tr><td><code>EXP</code></td> <td>all export ciphers</td> </tr>
-<tr><td><code>EXPORT40</code></td> <td>all 40-bit export ciphers only</td> </tr>
-<tr><td><code>EXPORT56</code></td> <td>all 56-bit export ciphers only</td> </tr>
-<tr><td><code>LOW</code></td> <td>all low strength ciphers (no export, single DES)</td></tr>
-<tr><td><code>MEDIUM</code></td> <td>all ciphers with 128 bit encryption</td> </tr>
-<tr><td><code>HIGH</code></td> <td>all ciphers using Triple-DES</td> </tr>
-<tr><td><code>RSA</code></td> <td>all ciphers using RSA key exchange</td> </tr>
-<tr><td><code>DH</code></td> <td>all ciphers using Diffie-Hellman key exchange</td> </tr>
-<tr><td><code>EDH</code></td> <td>all ciphers using Ephemeral Diffie-Hellman key exchange</td> </tr>
-<tr><td><code>ECDH</code></td> <td>Elliptic Curve Diffie-Hellman key exchange</td> </tr>
-<tr><td><code>ADH</code></td> <td>all ciphers using Anonymous Diffie-Hellman key exchange</td> </tr>
-<tr><td><code>AECDH</code></td> <td>all ciphers using Anonymous Elliptic Curve Diffie-Hellman key exchange</td> </tr>
-<tr><td><code>SRP</code></td> <td>all ciphers using Secure Remote Password (SRP) key exchange</td> </tr>
-<tr><td><code>DSS</code></td> <td>all ciphers using DSS authentication</td> </tr>
-<tr><td><code>ECDSA</code></td> <td>all ciphers using ECDSA authentication</td> </tr>
-<tr><td><code>aNULL</code></td> <td>all ciphers using no authentication</td> </tr>
-</table>
-<p>
-Now where this becomes interesting is that these can be put together
-to specify the order and ciphers you wish to use. To speed this up
-there are also aliases (<code>SSLv3, TLSv1, EXP, LOW, MEDIUM,
-HIGH</code>) for certain groups of ciphers. These tags can be joined
-together with prefixes to form the <em>cipher-spec</em>. Available
-prefixes are:</p>
+<tr><th><a name="table1">Symbole</a></th> <th>Description</th></tr>
+<tr><td colspan="2"><em>Algorithme d'échange de clés :</em></td></tr>
+<tr><td><code>kRSA</code></td> <td>Echange de clés RSA</td></tr>
+<tr><td><code>kDHr</code></td> <td>Echange de clés Diffie-Hellman avec
+clé RSA</td></tr>
+<tr><td><code>kDHd</code></td> <td>Echange de clés Diffie-Hellman avec
+clé DSA</td></tr>
+<tr><td><code>kEDH</code></td> <td>Echange de clés Diffie-Hellman
+temporaires (pas de certificat)</td> </tr>
+<tr><td><code>kSRP</code></td> <td>échange de clés avec mot de passe
+distant sécurisé (SRP)</td></tr>
+<tr><td colspan="2"><em>Algorithmes d'authentification :</em></td></tr>
+<tr><td><code>aNULL</code></td> <td>Pas d'authentification</td></tr>
+<tr><td><code>aRSA</code></td> <td>Authentification RSA</td></tr>
+<tr><td><code>aDSS</code></td> <td>Authentification DSS</td> </tr>
+<tr><td><code>aDH</code></td> <td>Authentification Diffie-Hellman</td></tr>
+<tr><td colspan="2"><em>Algorithmes de chiffrement :</em></td></tr>
+<tr><td><code>eNULL</code></td> <td>Pas de chiffrement</td> </tr>
+<tr><td><code>NULL</code></td> <td>alias pour eNULL</td> </tr>
+<tr><td><code>AES</code></td> <td>Chiffrement AES</td> </tr>
+<tr><td><code>DES</code></td> <td>Chiffrement DES</td> </tr>
+<tr><td><code>3DES</code></td> <td>Chiffrement Triple-DES</td> </tr>
+<tr><td><code>RC4</code></td> <td>Chiffrement RC4</td> </tr>
+<tr><td><code>RC2</code></td> <td>Chiffrement RC2</td> </tr>
+<tr><td><code>IDEA</code></td> <td>Chiffrement IDEA</td> </tr>
+<tr><td colspan="2"><em>Algorithmes de condensés MAC </em>:</td></tr>
+<tr><td><code>MD5</code></td> <td>Fonction de hashage MD5</td></tr>
+<tr><td><code>SHA1</code></td> <td>Fonction de hashage SHA1</td></tr>
+<tr><td><code>SHA</code></td> <td>alias pour SHA1</td> </tr>
+<tr><td><code>SHA256</code></td> <td>Fonction de hashage SHA256</td> </tr>
+<tr><td><code>SHA384</code></td> <td>Fonction de hashage SHA384</td> </tr>
+<tr><td colspan="2"><em>Alias :</em></td></tr>
+<tr><td><code>SSLv3</code></td> <td>tous les algorithmes de chiffrement
+SSL version 3.0</td> </tr>
+<tr><td><code>TLSv1</code></td> <td>tous les algorithmes de chiffrement
+TLS version 1.0</td> </tr>
+<tr><td><code>EXP</code></td> <td>tous les algorithmes de chiffrement
+externes</td> </tr>
+<tr><td><code>EXPORT40</code></td> <td>tous les algorithmes de chiffrement
+externes limités à 40 bits</td> </tr>
+<tr><td><code>EXPORT56</code></td> <td>tous les algorithmes de chiffrement
+externes limités à 56 bits</td> </tr>
+<tr><td><code>LOW</code></td> <td>tous les algorithmes de chiffrement
+faibles (non externes, DES simple)</td></tr>
+<tr><td><code>MEDIUM</code></td> <td>tous les algorithmes avec
+chiffrement 128 bits</td> </tr>
+<tr><td><code>HIGH</code></td> <td>tous les algorithmes
+utilisant Triple-DES</td> </tr>
+<tr><td><code>RSA</code></td> <td>tous les algorithmes
+utilisant l'échange de clés RSA</td> </tr>
+<tr><td><code>DH</code></td> <td>tous les algorithmes
+utilisant l'échange de clés Diffie-Hellman</td> </tr>
+<tr><td><code>EDH</code></td> <td>tous les algorithmes
+utilisant l'échange de clés Diffie-Hellman temporaires</td> </tr>
+<tr><td><code>ECDH</code></td> <td>Echange de clés Elliptic Curve Diffie-Hellman</td> </tr>
+<tr><td><code>ADH</code></td> <td>tous les algorithmes
+utilisant l'échange de clés Diffie-Hellman anonymes</td> </tr>
+<tr><td><code>AECDH</code></td> <td>tous les algorithmes utilisant
+l'échange de clés Elliptic Curve Diffie-Hellman</td> </tr>
+<tr><td><code>SRP</code></td> <td>tous les algorithmes utilisant
+l'échange de clés avec mot de passe distant sécurisé (SRP)</td> </tr>
+<tr><td><code>DSS</code></td> <td>tous les algorithmes
+utilisant l'authentification DSS</td> </tr>
+<tr><td><code>ECDSA</code></td> <td>tous les algorithmes utilisant
+l'authentification ECDSA</td> </tr>
+<tr><td><code>aNULL</code></td> <td>tous les algorithmes n'utilisant
+aucune authentification</td> </tr>
+</table>
+<p>
+Cela devient intéressant lorsque tous ces symboles sont combinés
+ensemble pour spécifier les algorithmes disponibles et l'ordre dans
+lequel vous voulez les utiliser. Pour simplifier tout cela, vous
+disposez aussi d'alias (<code>SSLv3, TLSv1, EXP, LOW, MEDIUM,
+HIGH</code>) pour certains groupes d'algorithmes. Ces symboles peuvent
+être reliés par des préfixes pour former la chaîne <em>algorithmes</em>.
+Les préfixes disponibles sont :</p>
<ul>
-<li>none: add cipher to list</li>
-<li><code>+</code>: move matching ciphers to the current location in list</li>
-<li><code>-</code>: remove cipher from list (can be added later again)</li>
-<li><code>!</code>: kill cipher from list completely (can <strong>not</strong> be added later again)</li>
+<li>none: ajoute l'algorithme à la liste</li>
+<li><code>+</code>: déplace les algorithmes qui conviennent à la
+place courante dans la liste</li>
+<li><code>-</code>: supprime l'algorithme de la liste (peut être rajouté
+plus tard)</li>
+<li><code>!</code>: supprime définitivement l'algorithme de la liste (ne
+peut <strong>plus</strong> y être rajouté plus tard)</li>
</ul>
<div class="note">
-<h3><code>aNULL</code>, <code>eNULL</code> and <code>EXP</code>
-ciphers are always disabled</h3>
-<p>Beginning with version 2.4.7, null and export-grade
-ciphers are always disabled, as mod_ssl unconditionally adds
-<code>!aNULL:!eNULL:!EXP</code> to any cipher string at initialization.</p>
-</div>
-
-<p>A simpler way to look at all of this is to use the ``<code>openssl ciphers
--v</code>'' command which provides a nice way to successively create the
-correct <em>cipher-spec</em> string. The default <em>cipher-spec</em> string
-depends on the version of the OpenSSL libraries used. Let's suppose it is
-``<code>RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5</code>'' which
-means the following: Put <code>RC4-SHA</code> and <code>AES128-SHA</code> at
-the beginning. We do this, because these ciphers offer a good compromise
-between speed and security. Next, include high and medium security ciphers.
-Finally, remove all ciphers which do not authenticate, i.e. for SSL the
-Anonymous Diffie-Hellman ciphers, as well as all ciphers which use
-<code>MD5</code> as hash algorithm, because it has been proven insufficient.</p>
+<h3>Les algorithmes <code>aNULL</code>, <code>eNULL</code> et
+<code>EXP</code> sont toujours désactivés</h3>
+<p>Depuis la version 2.4.7, les
+algorithmes de type null ou destinés à l'exportation sont toujours
+désactivés car mod_ssl ajoute obligatoirement
+<code>!aNULL:!eNULL:!EXP</code> à toute chaîne d'algorithme de
+chiffrement à l'initialisation.</p>
+</div>
+
+<p>Pour vous simplifier la vie, vous pouvez utiliser la commande
+``<code>openssl ciphers -v</code>'' qui vous fournit un moyen simple de
+créer la chaîne <em>algorithmes</em> avec succès. La chaîne
+<em>algorithmes</em> par défaut dépend de la version des bibliothèques
+SSL installées. Supposons qu'elle contienne
+``<code>RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5</code>'', ce qui
+stipule de mettre <code>RC4-SHA</code> et <code>AES128-SHA</code> en
+premiers, car ces algorithmes présentent un bon compromis entre vitesse
+et sécurité. Viennent ensuite les algorithmes de sécurité élevée et
+moyenne. En fin de compte, les algorithmes qui n'offrent aucune
+authentification sont exclus, comme les algorithmes anonymes
+Diffie-Hellman pour SSL, ainsi que tous les algorithmes qui utilisent
+<code>MD5</code> pour le hashage, car celui-ci est reconnu comme
+insuffisant.</p>
<div class="example"><pre>$ openssl ciphers -v 'RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5'
RC4-SHA SSLv3 Kx=RSA Au=RSA Enc=RC4(128) Mac=SHA1
AES128-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(128) Mac=SHA1
SEED-SHA SSLv3 Kx=RSA Au=RSA Enc=SEED(128) Mac=SHA1
PSK-RC4-SHA SSLv3 Kx=PSK Au=PSK Enc=RC4(128) Mac=SHA1
KRB5-RC4-SHA SSLv3 Kx=KRB5 Au=KRB5 Enc=RC4(128) Mac=SHA1</pre></div>
-<p>The complete list of particular RSA & DH ciphers for SSL is given in <a href="#table2">Table 2</a>.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW</pre>
+<p>Vous trouverez la liste complète des algorithmes RSA & DH
+spécifiques à SSL dans la <a href="#table2">Table 2</a>.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW</pre>
</div>
<table class="bordered">
-<tr><th><a name="table2">Cipher-Tag</a></th> <th>Protocol</th> <th>Key Ex.</th> <th>Auth.</th> <th>Enc.</th> <th>MAC</th> <th>Type</th> </tr>
-<tr><td colspan="7"><em>RSA Ciphers:</em></td></tr>
+<tr><th><a name="table2">Symbole algorithme</a></th> <th>Protocole</th>
+<th>Echange de clés</th> <th>Authentification</th> <th>Chiffrement</th>
+<th>Condensé MAC</th> <th>Type</th> </tr>
+<tr><td colspan="7"><em>Algorithmes RSA :</em></td></tr>
<tr><td><code>DES-CBC3-SHA</code></td> <td>SSLv3</td> <td>RSA</td> <td>RSA</td> <td>3DES(168)</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>IDEA-CBC-SHA</code></td> <td>SSLv3</td> <td>RSA</td> <td>RSA</td> <td>IDEA(128)</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>RC4-SHA</code></td> <td>SSLv3</td> <td>RSA</td> <td>RSA</td> <td>RC4(128)</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>EXP-RC4-MD5</code></td> <td>SSLv3</td> <td>RSA(512)</td> <td>RSA</td> <td>RC4(40)</td> <td>MD5</td> <td> export</td> </tr>
<tr><td><code>NULL-SHA</code></td> <td>SSLv3</td> <td>RSA</td> <td>RSA</td> <td>None</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>NULL-MD5</code></td> <td>SSLv3</td> <td>RSA</td> <td>RSA</td> <td>None</td> <td>MD5</td> <td /> </tr>
-<tr><td colspan="7"><em>Diffie-Hellman Ciphers:</em></td></tr>
+<tr><td colspan="7"><em>Algorithmes Diffie-Hellman :</em></td></tr>
<tr><td><code>ADH-DES-CBC3-SHA</code></td> <td>SSLv3</td> <td>DH</td> <td>None</td> <td>3DES(168)</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>ADH-DES-CBC-SHA</code></td> <td>SSLv3</td> <td>DH</td> <td>None</td> <td>DES(56)</td> <td>SHA1</td> <td /> </tr>
<tr><td><code>ADH-RC4-MD5</code></td> <td>SSLv3</td> <td>DH</td> <td>None</td> <td>RC4(128)</td> <td>MD5</td> <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="sslcompression" id="sslcompression">Directive</a> <a name="SSLCompression" id="SSLCompression">SSLCompression</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable compression on the SSL level</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'activer la compression au niveau SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCompression on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLCompression 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.3 and later, if using OpenSSL 0.9.8 or later;
-virtual host scope available if using OpenSSL 1.0.0 or later.
-The default used to be <code>on</code> in version 2.4.3.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.3 du serveur HTTP
+Apache, si on utilise une version d'OpenSSL 0.9.8 ou supérieure ;
+l'utilisation dans un contexte de serveur virtuel n'est disponible que
+si on utilise une version d'OpenSSL 1.0.0 ou supérieure. La valeur par
+défaut était <code>on</code> dans la version 2.4.3.</td></tr>
</table>
-<p>This directive allows to enable compression on the SSL level.</p>
+<p>Cette directive permet d'activer la compression au niveau SSL.</p>
<div class="warning">
-<p>Enabling compression causes security issues in most setups (the so called
-CRIME attack).</p>
+<p>L'activation de la compression est à l'origine de problèmes de
+sécurité dans la plupart des configurations (l'attaque nommée CRIME).</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="sslcryptodevice" id="sslcryptodevice">Directive</a> <a name="SSLCryptoDevice" id="SSLCryptoDevice">SSLCryptoDevice</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable use of a cryptographic hardware accelerator</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCryptoDevice <em>engine</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'utilisation d'un accélérateur matériel de
+chiffrement</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLCryptoDevice <em>moteur</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLCryptoDevice builtin</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive enables use of a cryptographic hardware accelerator
-board to offload some of the SSL processing overhead. This directive
-can only be used if the SSL toolkit is built with "engine" support;
-OpenSSL 0.9.7 and later releases have "engine" support by default, the
-separate "-engine" releases of OpenSSL 0.9.6 must be used.</p>
+Cette directive permet d'activer l'utilisation d'une carte accélératrice
+de chiffrement qui prendra en compte certaines parties du traitement
+relatif à SSL. Cette directive n'est utilisable que si la boîte à
+outils SSL à été compilée avec le support "engine" ; les versions 0.9.7
+et supérieures d'OpenSSL possèdent par défaut le support "engine", alors
+qu'avec la version 0.9.6, il faut utiliser les distributions séparées
+"-engine".</p>
-<p>To discover which engine names are supported, run the command
+<p>Pour déterminer les moteurs supportés, exécutez la commande
"<code>openssl engine</code>".</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config"># For a Broadcom accelerator:
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"># Pour un accélérateur Broadcom :
SSLCryptoDevice ubsec</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="sslengine" id="sslengine">Directive</a> <a name="SSLEngine" id="SSLEngine">SSLEngine</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL Engine Operation Switch</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrupteur marche/arrêt du moteur SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLEngine on|off|optional</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLEngine 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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive toggles the usage of the SSL/TLS Protocol Engine. This
-is should be used inside a <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> section to enable SSL/TLS for a
-that virtual host. By default the SSL/TLS Protocol Engine is
-disabled for both the main server and all configured virtual hosts.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><VirtualHost _default_:443>
+Cette directive permet d'activer/désactiver le moteur du protocole
+SSL/TLS. Elle doit être utilisée dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> pour activer
+SSL/TLS pour ce serveur virtuel particulier. Par défaut, le moteur du
+protocole SSL/TLS est désactivé pour le serveur principal et tous les
+serveurs virtuels configurés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><VirtualHost _default_:443>
SSLEngine on
#...
</VirtualHost></pre>
</div>
-<p>In Apache 2.1 and later, <code class="directive">SSLEngine</code> can be set to
-<code>optional</code>. This enables support for
-<a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a>, Upgrading to TLS
-Within HTTP/1.1. At this time no web browsers support RFC 2817.</p>
+<p>Depuis la version 2.1 d'Apache, la directive
+<code class="directive">SSLEngine</code> peut être définie à
+<code>optional</code>, ce qui active le support de <a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a>, Upgrading to
+TLS Within HTTP/1.1. Pour le moment, aucun navigateur web ne supporte
+RFC 2817.</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="sslfips" id="sslfips">Directive</a> <a name="SSLFIPS" id="SSLFIPS">SSLFIPS</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL FIPS mode Switch</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Coimmutateur du mode SSL FIPS</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLFIPS on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLFIPS 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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive toggles the usage of the SSL library FIPS_mode flag.
-It must be set in the global server context and cannot be configured
-with conflicting settings (SSLFIPS on followed by SSLFIPS off or
-similar). The mode applies to all SSL library operations.
+Cette directive permet d'activer/désactiver l'utilisation du drapeau
+FIPS_mode de la bibliothèque SSL. Elle doit être définie dans le
+contexte du serveur principal, et n'accepte pas les configurations
+sources de conflits (SSLFIPS on suivi de SSLFIPS off par exemple). Le
+mode s'applique à toutes les opérations de la bibliothèque SSL.
</p>
<p>
-If httpd was compiled against an SSL library which did not support
-the FIPS_mode flag, <code>SSLFIPS on</code> will fail. Refer to the
-FIPS 140-2 Security Policy document of the SSL provider library for
-specific requirements to use mod_ssl in a FIPS 140-2 approved mode
-of operation; note that mod_ssl itself is not validated, but may be
-described as using FIPS 140-2 validated cryptographic module, when
-all components are assembled and operated under the guidelines imposed
-by the applicable Security Policy.
+Si httpd a été compilé avec une bibliothèque SSL qui ne supporte pas le
+drapeau FIPS_mode, la directive <code>SSLFIPS on</code> échouera.
+Reportez-vous au document sur la politique de sécurité FIPS 140-2 de la
+bibliothèque du fournisseur SSL, pour les prérequis spécifiques
+nécessaires à l'utilisation de mod_ssl selon un mode d'opération
+approuvé par FIPS 140-2 ; notez que mod_ssl en lui-même n'est pas
+validé, mais peut être décrit comme utilisant un module de chiffrement
+validé par FIPS 140-2, lorsque tous les composants sont assemblés et mis
+en oeuvre selon les recommandations de la politique de sécurité
+applicable.
</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="sslhonorcipherorder" id="sslhonorcipherorder">Directive</a> <a name="SSLHonorCipherOrder" id="SSLHonorCipherOrder">SSLHonorCipherOrder</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Option to prefer the server's cipher preference order</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Option permettant de classer les algorithmes de chiffrement
+du serveur par ordre de préférence</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLHonorCipherOrder on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLHonorCipherOrder 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>When choosing a cipher during an SSLv3 or TLSv1 handshake, normally
-the client's preference is used. If this directive is enabled, the
-server's preference will be used instead.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLHonorCipherOrder on</pre>
+<p>Normalement, ce sont les préférences du client qui sont prises en
+compte lors du choix d'un algorithme de chiffrement au cours d'une
+négociation SSLv3 ou TLSv1. Si cette directive est activée, ce sont les
+préférences du serveur qui seront prises en compte à la place.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLHonorCipherOrder on</pre>
</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="sslinsecurerenegotiation" id="sslinsecurerenegotiation">Directive</a> <a name="SSLInsecureRenegotiation" id="SSLInsecureRenegotiation">SSLInsecureRenegotiation</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Option to enable support for insecure renegotiation</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Option permettant d'activer le support de la renégociation
+non sécurisée</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLInsecureRenegotiation on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLInsecureRenegotiation 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8m or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si une version 0.9.8m
+ou supérieure d'OpenSSL est utilisée</td></tr>
</table>
-<p>As originally specified, all versions of the SSL and TLS protocols
-(up to and including TLS/1.2) were vulnerable to a Man-in-the-Middle
-attack
-(<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CAN-2009-3555">CVE-2009-3555</a>)
-during a renegotiation. This vulnerability allowed an attacker to
-"prefix" a chosen plaintext to the HTTP request as seen by the web
-server. A protocol extension was developed which fixed this
-vulnerability if supported by both client and server.</p>
+<p>Comme il a été spécifié, toutes les versions des protocoles SSL et
+TLS (jusqu'à la version 1.2 de TLS incluse) étaient vulnérables à une
+attaque de type Man-in-the-Middle (<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CAN-2009-3555">CVE-2009-3555</a>)
+au cours d'une renégociation. Cette vulnérabilité permettait à un
+attaquant de préfixer la requête HTTP (telle qu'elle était vue du
+serveur) avec un texte choisi. Une extension du protocole a été
+développée pour corriger cette vulnérabilité, sous réserve qu'elle soit
+supportée par le client et le serveur.</p>
-<p>If <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is linked against OpenSSL version 0.9.8m
-or later, by default renegotiation is only supported with
-clients supporting the new protocol extension. If this directive is
-enabled, renegotiation will be allowed with old (unpatched) clients,
-albeit insecurely.</p>
+<p>Si <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> est lié à une version 0.9.8m ou
+supérieure d'OpenSSL, par défaut, la renégociation n'est accordée qu'aux
+clients qui supportent la nouvelle extension du protocole. Si
+cette directive est activée, la renégociation sera accordée aux anciens
+clients (non patchés), quoique de manière non sécurisée</p>
-<div class="warning"><h3>Security warning</h3>
-<p>If this directive is enabled, SSL connections will be vulnerable to
-the Man-in-the-Middle prefix attack as described
-in <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CAN-2009-3555">CVE-2009-3555</a>.</p>
+<div class="warning"><h3>Avertissement à propos de la sécurité</h3>
+<p>Si cette directive est activée, les connexions SSL seront vulnérables
+aux attaques de type préfixe Man-in-the-Middle comme décrit dans <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CAN-2009-3555">CVE-2009-3555</a>.</p>
</div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLInsecureRenegotiation on</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLInsecureRenegotiation on</pre>
</div>
-<p>The <code>SSL_SECURE_RENEG</code> environment variable can be used
-from an SSI or CGI script to determine whether secure renegotiation is
-supported for a given SSL connection.</p>
+<p>La variable d'environnement <code>SSL_SECURE_RENEG</code> peut être
+utilisée dans un script SSI ou CGI pour déterminer si la renégociation
+sécurisée est supportée pour une connexion SSL donné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="sslocspdefaultresponder" id="sslocspdefaultresponder">Directive</a> <a name="SSLOCSPDefaultResponder" id="SSLOCSPDefaultResponder">SSLOCSPDefaultResponder</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the default responder URI for OCSP validation</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'URI du répondeur par défaut pour la validation
+OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSDefaultResponder <em>uri</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option sets the default OCSP responder to use. If <code class="directive"><a href="#sslocspoverrideresponder">SSLOCSPOverrideResponder</a></code> is not enabled,
-the URI given will be used only if no responder URI is specified in
-the certificate being verified.</p>
+<p>Cette directive permet de définir le répondeur OCSP par défaut. Si la
+directive <code class="directive"><a href="#sslocspoverrideresponder">SSLOCSPOverrideResponder</a></code> n'est pas activée,
+l'URI spécifié ne sera utilisé que si aucun URI de répondeur n'est
+spécifié dans le certificat en cours de vérification.</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="sslocspenable" id="sslocspenable">Directive</a> <a name="SSLOCSPEnable" id="SSLOCSPEnable">SSLOCSPEnable</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable OCSP validation of the client certificate chain</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la validation OCSP de la chaîne de certificats du
+client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPEnable on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPEnable 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option enables OCSP validation of the client certificate
-chain. If this option is enabled, certificates in the client's
-certificate chain will be validated against an OCSP responder after
-normal verification (including CRL checks) have taken place.</p>
+<p>Cette directive permet d'activer la validation OCSP de la chaîne de
+certificats du client. Si elle est activée, les certificats de la chaîne
+de certificats du client seront validés auprès d'un répondeur OCSP, une
+fois la vérification normale effectuée (vérification des CRLs
+incluse).</p>
-<p>The OCSP responder used is either extracted from the certificate
-itself, or derived by configuration; see the
-<code class="directive"><a href="#sslocspdefaultresponder">SSLOCSPDefaultResponder</a></code> and
-<code class="directive"><a href="#sslocspoverrideresponder">SSLOCSPOverrideResponder</a></code>
-directives.</p>
+<p>Le répondeur OCSP utilisé est soit extrait du certificat lui-même,
+soit spécifié dans la configuration ; voir les directives <code class="directive"><a href="#sslocspdefaultresponder">SSLOCSPDefaultResponder</a></code> et <code class="directive"><a href="#sslocspoverrideresponder">SSLOCSPOverrideResponder</a></code>.</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLVerifyClient on
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLVerifyClient on
SSLOCSPEnable on
SSLOCSPDefaultResponder "http://responder.example.com:8888/responder"
SSLOCSPOverrideResponder on</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslocspnoverify" id="sslocspnoverify">Directive</a> <a name="SSLOCSPNoverify" id="SSLOCSPNoverify">SSLOCSPNoverify</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>skip the OCSP responder certificates verification</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Evite la vérification des certificats des répondeurs OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPNoverify <em>On/Off</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPNoverify 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.26 and later, if using OpenSSL 0.9.7 or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache,
+sous réserve d'utiliser une version 0.9.7 ou supérieure d'OpenSSL</td></tr>
</table>
-<p>Skip the OCSP responder certificates verification, mostly useful when
-testing an OCSP server.</p>
+<p>Cette directive permet d'éviter la vérification des certificats
+des répondeurs OCSP, ce qui peut s'avérer utile lorsqu'on teste un serveur OCSP.</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="sslocspoverrideresponder" id="sslocspoverrideresponder">Directive</a> <a name="SSLOCSPOverrideResponder" id="SSLOCSPOverrideResponder">SSLOCSPOverrideResponder</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force use of the default responder URI for OCSP validation</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force l'utilisation de l'URI du répondeur par défaut pour
+la validation OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPOverrideResponder on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPOverrideResponder 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option forces the configured default OCSP responder to be used
-during OCSP certificate validation, regardless of whether the
-certificate being validated references an OCSP responder.</p>
+<p>Force l'utilisation, au cours d'une validation OCSP de certificat, du
+répondeur OCSP par défaut spécifié dans la configuration, que le
+certificat en cours de vérification fasse mention d'un répondeur OCSP ou
+non.</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="sslocspproxyurl" id="sslocspproxyurl">Directive</a> <a name="SSLOCSPProxyURL" id="SSLOCSPProxyURL">SSLOCSPProxyURL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Proxy URL to use for OCSP requests</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Adresse de mandataire à utiliser pour les requêtes OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPProxyURL <em>url</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.19 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.19 du serveur HTTP Apache</td></tr>
</table>
-<p>This option allows to set the URL of a HTTP proxy that should be used for
-all queries to OCSP responders.</p>
+<p>Cette directive permet de définir l'URL d'un mandataire HTTP qui devra être
+utilisé pour toutes les requêtes vers un répondeur OCSP.</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="sslocsprespondercertificatefile" id="sslocsprespondercertificatefile">Directive</a> <a name="SSLOCSPResponderCertificateFile" id="SSLOCSPResponderCertificateFile">SSLOCSPResponderCertificateFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set of trusted PEM encoded OCSP responder certificates</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fournit un jeu de certificats de confiance du répondeur OCSP avec
+encodage PEM</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponderCertificateFile <em>file</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.26 and later, if using OpenSSL 0.9.7 or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache,
+sous réserve d'utiliser une version 0.9.7 ou supérieure d'OpenSSL</td></tr>
</table>
-<p>This supplies a list of trusted OCSP responder certificates to be used
-during OCSP responder certificate validation. The supplied certificates are
-implicitly trusted without any further validation. This is typically used
-where the OCSP responder certificate is self signed or omitted from the OCSP
-response.</p>
+<p>Cette directive permet de définir un fichier contenant une liste de
+certificats de confiance du répondeur OCSP à utiliser au cours de la validation
+du certificat du répondeur OCSP. Les certificats fournis peuvent
+être considérés comme de confiance sans avoir à effectuer de vérifications
+supplémentaires. Ce processus de validation du certificat du répondeur OCSP
+intervient en général lorsque ce dernier est autosigné ou tout simplement absent
+de la réponse OCSP.</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="sslocsprespondertimeout" id="sslocsprespondertimeout">Directive</a> <a name="SSLOCSPResponderTimeout" id="SSLOCSPResponderTimeout">SSLOCSPResponderTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Timeout for OCSP queries</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponderTimeout <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Délai d'attente pour les requêtes OCSP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponderTimeout <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPResponderTimeout 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option sets the timeout for queries to OCSP responders, when
-<code class="directive"><a href="#sslocspenable">SSLOCSPEnable</a></code> is turned on.</p>
+<p>Cette option permet de définir le délai d'attente pour les requêtes à
+destination des répondeurs OCSP, lorsque la directive <code class="directive"><a href="#sslocspenable">SSLOCSPEnable</a></code> est à on.</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="sslocspresponsemaxage" id="sslocspresponsemaxage">Directive</a> <a name="SSLOCSPResponseMaxAge" id="SSLOCSPResponseMaxAge">SSLOCSPResponseMaxAge</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable age for OCSP responses</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponseMaxAge <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Age maximum autorisé pour les réponses OCSP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponseMaxAge <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPResponseMaxAge -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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option sets the maximum allowable age ("freshness") for OCSP responses.
-The default value (<code>-1</code>) does not enforce a maximum age,
-which means that OCSP responses are considered valid as long as their
-<code>nextUpdate</code> field is in the future.</p>
+<p>Cette option permet de définir l'âge maximum autorisé (la
+"fraicheur") des réponses OCSP. La valeur par défault (<code>-1</code>)
+signifie qu'aucun âge maximum n'est définit ; autrement dit, les
+réponses OCSP sont considérées comme valides tant que la valeur de leur
+champ <code>nextUpdate</code> se situe dans le futur.</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="sslocspresponsetimeskew" id="sslocspresponsetimeskew">Directive</a> <a name="SSLOCSPResponseTimeSkew" id="SSLOCSPResponseTimeSkew">SSLOCSPResponseTimeSkew</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable time skew for OCSP response validation</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponseTimeSkew <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dérive temporelle maximale autorisée pour la validation des
+réponses OCSP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPResponseTimeSkew <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPResponseTimeSkew 300</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>This option sets the maximum allowable time skew for OCSP responses
-(when checking their <code>thisUpdate</code> and <code>nextUpdate</code> fields).</p>
+<p>Cette option permet de définir la dérive temporelle maximale
+autorisée pour les réponses OCSP (lors de la vérification des champs
+<code>thisUpdate</code> et <code>nextUpdate</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="sslocspuserequestnonce" id="sslocspuserequestnonce">Directive</a> <a name="SSLOCSPUseRequestNonce" id="SSLOCSPUseRequestNonce">SSLOCSPUseRequestNonce</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Use a nonce within OCSP queries</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilisation d'un nombre à usage unique au sein des requêtes
+OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOCSPUseRequestNonce on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLOCSPUseRequestNonce 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
+Apache</td></tr>
</table>
-<p>This option determines whether queries to OCSP responders should contain
-a nonce or not. By default, a query nonce is always used and checked against
-the response's one. When the responder does not use nonces (e.g. Microsoft OCSP
-Responder), this option should be turned <code>off</code>.</p>
+<p>Cette directive permet de spécifier si les requêtes vers les
+répondeurs OCSP doivent contenir un nombre à usage unique ou non. Par
+défaut, un nombre à usage unique est toujours présent dans les requêtes
+et il est comparé à celui de la réponse. Lorsque le répondeur n'utilise pas de
+nombre à usage unique (comme Microsoft OCSP Responder), cette directive
+doit être définie à <code>off</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="sslopensslconfcmd" id="sslopensslconfcmd">Directive</a> <a name="SSLOpenSSLConfCmd" id="SSLOpenSSLConfCmd">SSLOpenSSLConfCmd</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure OpenSSL parameters through its <em>SSL_CONF</em> API</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOpenSSLConfCmd <em>command-name</em> <em>command-value</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration des paramètres d'OpenSSL via son API <em>SSL_CONF</em></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOpenSSLConfCmd <em>commande</em> <em>valeur</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.8 and later, if using OpenSSL 1.0.2 or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.8 du serveur HTTP
+Apache avec OpenSSL 1.0.2 ou supérieur</td></tr>
</table>
-<p>This directive exposes OpenSSL's <em>SSL_CONF</em> API to mod_ssl,
-allowing a flexible configuration of OpenSSL parameters without the need
-of implementing additional <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> directives when new
-features are added to OpenSSL.</p>
+<p>Cette directive permet à mod_ssl d'accéder à l'API <em>SSL_CONF</em>
+d'OpenSSL. Il n'est ainsi plus nécessaire d'implémenter des
+directives supplémentaires pour <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> lorsque de nouvelles
+fonctionnalités sont ajoutées à OpenSSL, ce qui rend la configuration de
+ce dernier beaucoup plus souple.</p>
-<p>The set of available <code class="directive">SSLOpenSSLConfCmd</code> commands
-depends on the OpenSSL version being used for <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
-(at least version 1.0.2 is required). For a list of supported command
-names, see the section <em>Supported configuration file commands</em> in the
-<a href="http://www.openssl.org/docs/man1.0.2/ssl/SSL_CONF_cmd.html#SUPPORTED-CONFIGURATION-FILE-COMMANDS">SSL_CONF_cmd(3)</a> manual page for OpenSSL.</p>
+<p>Le jeu de commandes disponibles pour la directive
+<code class="directive">SSLOpenSSLConfCmd</code> dépend de la version d'OpenSSL
+utilisée pour <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> (la version minimale 1.0.2 est un
+prérequis). Pour obtenir la liste des commandes supportées, voir la
+section <em>Supported configuration file commands</em> de la page de
+manuel d'OpenSSL <a href="http://www.openssl.org/docs/man1.0.2/ssl/SSL_CONF_cmd.html#SUPPORTED-CONFIGURATION-FILE-COMMANDS">SSL_CONF_cmd(3)</a>.</p>
-<p>Some of the <code class="directive">SSLOpenSSLConfCmd</code> commands can be used
-as an alternative to existing directives (such as
-<code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code> or
-<code class="directive"><a href="#sslprotocol">SSLProtocol</a></code>),
-though it should be noted that the syntax / allowable values for the parameters
-may sometimes differ.</p>
+<p>Certaines commandes peuvent remplacer des directives existantes
+(comme <code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code> ou
+<code class="directive"><a href="#sslprotocol">SSLProtocol</a></code>) ; notez cependant
+que la syntaxe et/ou les valeurs possibles peuvent différer.</p>
<div class="example"><h3>Examples</h3><pre class="prettyprint lang-config">SSLOpenSSLConfCmd Options -SessionTicket,ServerPreference
SSLOpenSSLConfCmd ECDHParameters brainpoolP256r1
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssloptions" id="ssloptions">Directive</a> <a name="SSLOptions" id="SSLOptions">SSLOptions</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure various SSL engine run-time options</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure différentes options d'exécution du moteur
+SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLOptions [+|-]<em>option</em> ...</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>Options</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive can be used to control various run-time options on a
-per-directory basis. Normally, if multiple <code>SSLOptions</code>
-could apply to a directory, then the most specific one is taken
-completely; the options are not merged. However if <em>all</em> the
-options on the <code>SSLOptions</code> directive are preceded by a
-plus (<code>+</code>) or minus (<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>
+Cette directive permet de contrôler différentes options d'exécution du
+moteur SSL dans un contexte de répertoire. Normalement, si plusieurs
+<code>SSLOptions</code> peuvent s'appliquer à un répertoire, c'est la
+plus spécifique qui est véritablement prise en compte ; les options ne
+se combinent pas entre elles. Elles se combinent cependant entre elles
+si elles sont <em>toutes</em> précédées par un symbole plus
+(<code>+</code>) ou moins (<code>-</code>). Toute option précédée d'un
+<code>+</code> est ajoutée aux options actuellement en vigueur, et toute
+option précédée d'un <code>-</code> est supprimée de ces mêmes
+options.
+</p>
<p>
-The available <em>option</em>s are:</p>
+Les <em>option</em>s disponibles sont :</p>
<ul>
<li><code>StdEnvVars</code>
<p>
- When this option is enabled, the standard set of SSL related CGI/SSI
- environment variables are created. This per default is disabled for
- performance reasons, because the information extraction step is a
- rather expensive operation. So one usually enables this option for
- CGI and SSI requests only.</p>
+ Lorsque cette option est activée, le jeu standard de variables
+ d'environnement SSL relatives à CGI/SSI est créé. Cette option est
+ désactivée par défaut pour des raisons de performances, car
+ l'extraction des informations constitue une opération assez coûteuse
+ en ressources. On n'active donc en général cette option que pour les
+ requêtes CGI et SSI.</p>
</li>
<li><code>ExportCertData</code>
<p>
- When this option is enabled, additional CGI/SSI environment variables are
- created: <code>SSL_SERVER_CERT</code>, <code>SSL_CLIENT_CERT</code> and
- <code>SSL_CLIENT_CERT_CHAIN_</code><em>n</em> (with <em>n</em> = 0,1,2,..).
- These contain the PEM-encoded X.509 Certificates of server and client for
- the current HTTPS connection and can be used by CGI scripts for deeper
- Certificate checking. Additionally all other certificates of the client
- certificate chain are provided, too. This bloats up the environment a
- little bit which is why you have to use this option to enable it on
- demand.</p>
+ Lorsque cette option est activée, des variables d'environnement
+ CGI/SSI supplémentaires sont créées : <code>SSL_SERVER_CERT</code>,
+ <code>SSL_CLIENT_CERT</code> et
+ <code>SSL_CLIENT_CERT_CHAIN_</code><em>n</em> (avec <em>n</em> =
+ 0,1,2,..). Elles contiennent les certificats X.509 codés en PEM du
+ serveur et du client pour la connexion HTTPS courante, et peuvent
+ être utilisées par les scripts CGI pour une vérification de
+ certificat plus élaborée. De plus, tous les autres certificats de la
+ chaîne de certificats du client sont aussi fournis. Tout ceci gonfle
+ un peu l'environnement, et c'est la raison pour laquelle vous ne
+ devez activer cette option qu'à la demande.</p>
</li>
<li><code>FakeBasicAuth</code>
<p>
- When this option is enabled, the Subject Distinguished Name (DN) of the
- Client X509 Certificate is translated into a HTTP Basic Authorization
- username. This means that the standard Apache authentication methods can
- be used for access control. The user name is just the Subject of the
- Client's X509 Certificate (can be determined by running OpenSSL's
- <code>openssl x509</code> command: <code>openssl x509 -noout -subject -in
- </code><em>certificate</em><code>.crt</code>). The optional <code class="directive"><a href="#sslusername">SSLUserName</a></code> directive can be used to
- specify which part of the certificate Subject is embedded in the username.
- Note that no password is obtained from the user. Every entry in the user
- file needs this password: ``<code>xxj31ZMTZzkVA</code>'', which is the
- DES-encrypted version of the word `<code>password</code>''. Those who
- live under MD5-based encryption (for instance under FreeBSD or BSD/OS,
- etc.) should use the following MD5 hash of the same word:
- ``<code>$1$OXLyS...$Owx8s2/m9/gfkcRVXzgoE/</code>''.</p>
-
- <p>Note that the <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicfake">AuthBasicFake</a></code>
- directive within <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> can be used as a more
- general mechanism for faking basic authentication, giving control over the
- structure of both the username and password.</p>
+ Lorsque cette option est activée, le Nom Distinctif (DN) sujet du
+ certificat client X509 est traduit en un nom d'utilisateur pour
+ l'autorisation HTTP de base. Cela signifie que les méthodes
+ d'authentification standard d'Apache peuvent être utilisées pour le
+ contrôle d'accès. Le nom d'utilisateur est tout simplement le Sujet
+ du certificat X509 du client (il peut être déterminé en utilisant la
+ commande OpenSSL <code>openssl x509</code> : <code>openssl x509
+ -noout -subject -in </code><em>certificat</em><code>.crt</code>). La
+ directive optionnelle <code class="directive"><a href="#sslusername">SSLUserName</a></code> permet de spécifier quelle
+ partie du sujet du certificat est incluse dans le nom d'utilisateur.
+ Notez qu'aucun mot de passe n'est envoyé par l'utilisateur. Chaque
+ entrée du fichier des utilisateurs doit comporter ce mot de passe :
+ ``<code>xxj31ZMTZzkVA</code>'', qui est la version chiffrée en DES
+ du mot ``<code>password</code>''. Ceux qui travaillent avec un
+ chiffrement basé sur MD5 (par exemple sous FreeBSD ou BSD/OS,
+ etc...) doivent utiliser le condensé MD5 suivant pour le même mot :
+ ``<code>$1$OXLyS...$Owx8s2/m9/gfkcRVXzgoE/</code>''.</p>
+
+ <p>Notez que la directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicfake">AuthBasicFake</a></code> du module
+ <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> permet de contrôler à la
+ fois le nom d'utilisateur et le mot de passe ; elle fournit donc un
+ mécanisme plus général de simulation d'authentification de base.</p>
</li>
<li><code>StrictRequire</code>
<p>
- This <em>forces</em> forbidden access when <code>SSLRequireSSL</code> or
- <code>SSLRequire</code> successfully decided that access should be
- forbidden. Usually the default is that in the case where a ``<code>Satisfy
- any</code>'' directive is used, and other access restrictions are passed,
- denial of access due to <code>SSLRequireSSL</code> or
- <code>SSLRequire</code> is overridden (because that's how the Apache
- <code>Satisfy</code> mechanism should work.) But for strict access restriction
- you can use <code>SSLRequireSSL</code> and/or <code>SSLRequire</code> in
- combination with an ``<code>SSLOptions +StrictRequire</code>''. Then an
- additional ``<code>Satisfy Any</code>'' has no chance once mod_ssl has
- decided to deny access.</p>
+ Cette option <em>force</em> l'interdiction d'accès lorsque
+ <code>SSLRequireSSL</code> ou <code>SSLRequire</code> a décidé que
+ l'accès devait être interdit. Par défaut, dans le cas où
+ une directive ``<code>Satisfy any</code>'' est utilisée, et si
+ d'autres restrictions d'accès ont été franchies, on passe en général
+ outre l'interdiction d'accès due à <code>SSLRequireSSL</code> ou
+ <code>SSLRequire</code> (parce que c'est ainsi que le mécanisme
+ <code>Satisfy</code> d'Apache doit fonctionner). Pour des
+ restrictions d'accès plus strictes, vous pouvez cependant utiliser
+ <code>SSLRequireSSL</code> et/ou <code>SSLRequire</code> en
+ combinaison avec une option ``<code>SSLOptions
+ +StrictRequire</code>''. Une directive ``<code>Satisfy Any</code>''
+ n'a alors aucune chance d'autoriser l'accès si mod_ssl a décidé de
+ l'interdire.</p>
</li>
<li><code>OptRenegotiate</code>
<p>
- This enables optimized SSL connection renegotiation handling when SSL
- directives are used in per-directory context. By default a strict
- scheme is enabled where <em>every</em> per-directory reconfiguration of
- SSL parameters causes a <em>full</em> SSL renegotiation handshake. When this
- option is used mod_ssl tries to avoid unnecessary handshakes by doing more
- granular (but still safe) parameter checks. Nevertheless these granular
- checks sometimes may not be what the user expects, so enable this on a
- per-directory basis only, please.</p>
+ Cette option active la gestion optimisée de la renégociation des
+ connexions SSL intervenant lorsque les directives SSL sont utilisées
+ dans un contexte de répertoire. Par défaut un schéma strict est
+ appliqué, et <em>chaque</em> reconfiguration des paramètres SSL au
+ niveau du répertoire implique une phase de renégociation SSL
+ <em>complète</em>. Avec cette option, mod_ssl essaie d'éviter les
+ échanges non nécessaires en effectuant des vérifications de
+ paramètres plus granulaires (mais tout de même efficaces).
+ Néanmoins, ces vérifications granulaires peuvent ne pas correspondre
+ à ce qu'attend l'utilisateur, et il est donc recommandé de n'activer
+ cette option que dans un contexte de répertoire.</p>
</li>
<li><code>LegacyDNStringFormat</code>
<p>
- This option influences how values of the
- <code>SSL_{CLIENT,SERVER}_{I,S}_DN</code> variables are formatted. Since
- version 2.3.11, Apache HTTPD uses a RFC 2253 compatible format by
- default. This uses commas as delimiters between the attributes, allows the
- use of non-ASCII characters (which are converted to UTF8), escapes
- various special characters with backslashes, and sorts the attributes
- with the "C" attribute last.</p>
-
- <p>If <code>LegacyDNStringFormat</code> is set, the old format will be
- used which sorts the "C" attribute first, uses slashes as separators, and
- does not handle non-ASCII and special characters in any consistent way.
+ Cette option permet d'agir sur la manière dont les valeurs des
+ variables <code>SSL_{CLIENT,SERVER}_{I,S}_DN</code> sont formatées.
+ Depuis la version 2.3.11, Apache HTTPD utilise par défaut un format
+ compatible avec la RFC 2253. Ce format utilise des virgules comme
+ délimiteurs entre les attributs, permet l'utilisation de caractères
+ non-ASCII (qui sont alors convertis en UTF8), échappe certains
+ caractères spéciaux avec des slashes inversés, et trie les attributs
+ en plaçant l'attribut "C" en dernière position.</p>
+
+ <p>Si l'option <code>LegacyDNStringFormat</code> est présente, c'est
+ l'ancien format qui sera utilisé : les attributs sont triés avec
+ l'attribut "C" en première position, les séparateurs sont des
+ slashes non inversés, les caractères non-ASCII ne sont pas supportés
+ et le support des caractères spéciaux n'est pas fiable.
</p>
</li>
</ul>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLOptions +FakeBasicAuth -StrictRequire
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLOptions +FakeBasicAuth -StrictRequire
<Files ~ "\.(cgi|shtml)$">
SSLOptions +StdEnvVars -ExportCertData
</Files></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslpassphrasedialog" id="sslpassphrasedialog">Directive</a> <a name="SSLPassPhraseDialog" id="SSLPassPhraseDialog">SSLPassPhraseDialog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of pass phrase dialog for encrypted private
-keys</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Méthode utilisée pour entrer le mot de passe pour les clés
+privées chiffrées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLPassPhraseDialog <em>type</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLPassPhraseDialog builtin</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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-When Apache starts up it has to read the various Certificate (see
-<code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>) and
-Private Key (see <code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>) files of the
-SSL-enabled virtual servers. Because for security reasons the Private
-Key files are usually encrypted, mod_ssl needs to query the
-administrator for a Pass Phrase in order to decrypt those files. This
-query can be done in two ways which can be configured by
-<em>type</em>:</p>
+Lors de son démarrage, Apache doit lire les différents fichiers de
+certificats (voir la directive <code class="directive"><a href="#sslcertificatefile">SSLCertificateFile</a></code>) et de clés privées
+(voir la directive <code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>) des serveurs
+virtuels où SSL est activé. Comme, pour des raisons de sécurité, les
+fichiers de clés privées sont en général chiffrés, mod_ssl doit
+demander à l'administrateur un mot de passe pour déchiffrer ces
+fichiers. L'argument <em>type</em> permet de choisir la manière dont
+cette demande peut être formulée parmi les trois suivantes :</p>
<ul>
<li><code>builtin</code>
<p>
- This is the default where an interactive terminal dialog occurs at startup
- time just before Apache detaches from the terminal. Here the administrator
- has to manually enter the Pass Phrase for each encrypted Private Key file.
- Because a lot of SSL-enabled virtual hosts can be configured, the
- following reuse-scheme is used to minimize the dialog: When a Private Key
- file is encrypted, all known Pass Phrases (at the beginning there are
- none, of course) are tried. If one of those known Pass Phrases succeeds no
- dialog pops up for this particular Private Key file. If none succeeded,
- another Pass Phrase is queried on the terminal and remembered for the next
- round (where it perhaps can be reused).</p>
+ C'est la méthode par défaut, et un dialogue interactive de terminal
+ s'ouvre au cours du démarrage juste avant qu'Apache ne se détache du
+ terminal. A ce moment, l'administrateur doit entrer manuellement un
+ mot de passe pour chaque fichier de clé privée chiffré. Etant donné
+ qu'il peut y avoir un grand nombre de serveurs virtuels configurés
+ avec SSL activé, le protocole de réutilisation suivant est utilisé
+ pour minimiser le dialogue : lorsqu'un fichier de clé privée est
+ chiffré, tous les mots de passe connus (au début, il n'y en a aucun,
+ bien entendu) sont essayés. Si l'un de ces mots de passe connus
+ convient, aucun dialogue ne s'ouvrira pour ce fichier de
+ clé privée particulier. Si aucun ne convient, un autre mot de passe
+ sera demandé à partir du terminal et sera mis en mémoire pour le
+ fichier de clé privée suivant (pour lequel il pourra éventuellement
+ être réutilisé).</p>
<p>
- This scheme allows mod_ssl to be maximally flexible (because for N encrypted
- Private Key files you <em>can</em> use N different Pass Phrases - but then
- you have to enter all of them, of course) while minimizing the terminal
- dialog (i.e. when you use a single Pass Phrase for all N Private Key files
- this Pass Phrase is queried only once).</p></li>
-
-<li><code>|/path/to/program [args...]</code>
-
- <p>This mode allows an external program to be used which acts as a
- pipe to a particular input device; the program is sent the standard
- prompt text used for the <code>builtin</code> mode on
- <code>stdin</code>, and is expected to write password strings on
- <code>stdout</code>. If several passwords are needed (or an
- incorrect password is entered), additional prompt text will be
- written subsequent to the first password being returned, and more
- passwords must then be written back.</p></li>
-
-<li><code>exec:/path/to/program</code>
+ Cette méthode confère à mod_ssl une grande souplesse (car pour N
+ fichiers de clé privée chiffrés, vous <em>pouvez</em> utiliser N
+ mots de passe différents - mais vous devrez alors tous les fournir,
+ bien entendu), tout en minimisant le dialogue de terminal (vous
+ pouvez en effet utiliser un seul mot de passe pour les N fichiers de
+ clé privée et vous n'aurez alors à l'entrer qu'une seule
+ fois).</p></li>
+
+<li><code>|/chemin/vers/programme [arguments...]</code>
+
+ <p>Ce mode permet d'utiliser un programme externe qui va se présenter
+ comme une redirection vers un périphérique d'entrée particulier ; le
+ texte de prompt standard utilisé pour le mode <code>builtin</code>
+ est envoyé au programme sur <code>stdin</code>, et celui-ci doit
+ renvoyer des mots de passe sur <code>stdout</code>. Si
+ plusieurs mots de passe sont requis (ou si un mot de passe incorrect
+ a été entré), un texte de prompt supplémentaire sera écrit après le
+ retour du premier mot de passe, et d'autres mots de passe devront
+ alors être réécrits.</p></li>
+
+<li><code>exec:/chemin/vers/programme</code>
<p>
- Here an external program is configured which is called at startup for each
- encrypted Private Key file. It is called with one argument, a string of the
- form ``<code>servername:portnumber:index</code>'' (with <code>index</code>
- being a zero-based sequence number), which indicates for which server,
- TCP port and certificate number it has to print the corresponding
- Pass Phrase to <code>stdout</code>. The intent is that this external
- program first runs security checks to make sure that the system is not
- compromised by an attacker, and only when these checks were passed
- successfully it provides the Pass Phrase.</p>
+ Ici, un programme externe est appelé au démarrage du serveur pour
+ chaque fichier de clé privée chiffré. Il est
+ appelé avec un
+ argument, une chaîne de la forme
+ "<code>servername:portnumber:index</code>" (index étant un numéro
+ d'ordre débutant 0), qui indique pour quels serveur, port TCP et
+ numéro de certificat il doit écrire le mot de
+ passe correspondant sur <code>stdout</code>. Le but recherché est
+ l'exécution de vérifications de sécurité préalables permettant de
+ s'assurer que le système n'est pas victime d'une attaque, et de ne
+ fournir le mot de passe que si toutes les vérifications ont été
+ effectuées avec succès.</p>
<p>
- Both these security checks, and the way the Pass Phrase is determined, can
- be as complex as you like. Mod_ssl just defines the interface: an
- executable program which provides the Pass Phrase on <code>stdout</code>.
- Nothing more or less! So, if you're really paranoid about security, here
- is your interface. Anything else has to be left as an exercise to the
- administrator, because local security requirements are so different.</p>
+ Ces vérifications de sécurité, ainsi que la manière dont le mot de
+ passe est déterminé peuvent être aussi sophistiqués que vous le
+ désirez. Mod_ssl ne définit que l'interface : un programme
+ exécutable qui écrit le mot de passe sur <code>stdout</code>. Ni
+ plus, ni moins ! Ainsi, si vous êtes vraiment paranoïaque en matière
+ de sécurité, voici votre interface. Tout le reste doit être confié à
+ l'administrateur à titre d'exercice, car les besoins en sécurité
+ locale sont très différents.</p>
<p>
- The reuse-algorithm above is used here, too. In other words: The external
- program is called only once per unique Pass Phrase.</p></li>
+ L'algorithme de réutilisation est utilisé ici aussi. En d'autres
+ termes, le programme externe n'est appelé qu'une fois par mot de
+ passe unique.</p></li>
</ul>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLPassPhraseDialog "exec:/usr/local/apache/sbin/pp-filter"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLPassPhraseDialog "exec:/usr/local/apache/sbin/pp-filter"</pre>
</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="sslpolicysection" id="sslpolicysection">Directive</a> <a name="SSLPolicysection" id="SSLPolicysection"><SSLPolicy></a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a named set of SSL configurations</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit par un nom un jeu de configurations SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><SSLPolicy <em>name</em>></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.28 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.28 du serveur HTTP Apache</td></tr>
</table>
-<p>This directive defines a set of SSL* configurations under
-and gives it a name. This name can be used in the directives
-<code class="directive">SSLPolicy</code> and <code class="directive">SSLProxyPolicy</code>
-to apply this configuration set in the current context.</p>
+<p>Cette directive permet de définir un jeu de configurations SSL et de lui
+attribuer un nom. Ce nom peut alors être utilisé par les directives
+<code class="directive">SSLPolicy</code> et <code class="directive">SSLProxyPolicy</code> pour
+appliquer ce jeu de configurations au contexte courant.</p>
-<div class="example"><h3>D
efine and Use of a Policy</h3><pre class="prettyprint lang-config"><SSLPolicy safe-stapling>
+<div class="example"><h3>D
éfinition et utilisation d'une configuration SSL</h3><pre class="prettyprint lang-config"><SSLPolicy safe-stapling>
SSLUseStapling on
SSLStaplingResponderTimeout 2
SSLStaplingReturnResponderErrors off
...</pre>
</div>
-<p>On the one hand, this can make server configurations easier to
-<em>read</em> and <em>maintain</em>. On the other hand, it is
-intended to make SSL easier and safer to <em>use</em>. For the
-latter, Apache httpd ships with a set of pre-defined policies
-that reflect good open source practise. The policy "modern",
-for example, carries the settings to make your server work
-compatible and securely with current browsers.</p>
+<p>Cette directive permet d'une part de faciliter la <em>lecture</em> et la
+<em>maintenance</em> des configurations des serveurs. Elle a été conçue d'autre
+part pour faciliter et sécuriser l'<em>utilisation</em> de SSL. Sur ce dernier
+point, Apache httpd est fourni avec un jeu de configurations SSL prédéfinies qui
+respecte les bonnes pratiques du code open source. Par exemple, le jeu de
+configurations "modern" fait en sorte que votre serveur fonctionne de manière
+compatible et sécurisée avec les navigateurs courants.</p>
-<p>The list of predefined policies in your Apache can be obtained
-by running the following command. This list shows you the
-detailed configurations each policy is made of:</p>
+<p>Vous pouvez obtenir la liste des politiques SSL prédéfinies de votre serveur
+Apache en lançant la commande suivante. Cette liste vous montre le détail du
+contenu de chaque politique SSL prédéfinie :</p>
-<div class="example"><h3>List
all Defined Policies</h3><pre class="prettyprint lang-sh">httpd -t -D DUMP_SSL_POLICIES</pre>
+<div class="example"><h3>List
e de toutes les politiques SSL prédéfinies</h3><pre class="prettyprint lang-sh">httpd -t -D DUMP_SSL_POLICIES</pre>
</div>
-<p>The directive can only be used in the server config (global context), so
-there cannot be two policies with the same name. However, policies can
-be redefined:</p>
+<p>Cette directive ne peut être utilisée qu'au niveau de la configuration
+globale du serveur ; il ne peut donc coexister deux politiques de même nom. Les
+politiques SSL peuvent cependant être redéfinies :</p>
-<div class="example"><h3>
Policy Overwrite</h3><pre class="prettyprint lang-config"><SSLPolicy proxy-trust>
+<div class="example"><h3>
Redéfinition d'une politique</h3><pre class="prettyprint lang-config"><SSLPolicy proxy-trust>
SSLProxyVerify require
</SSLPolicy>
...
</SSLPolicy></pre>
</div>
-<p>Policy definitions are <em>added</em> in the order they appear, but are
-<em>applied</em> when the whole configuration has been read. This means that any
-use of 'proxy-trust' will mean 'SSLProxyVerify none'. The first definition
-has no effect at all. That allows pre-installed policies to be replaced
-without the need to disable them.</p>
+<p>Les définitions des politiques SSL sont <em>ajoutées</em> selon l'ordre dans
+lequel elles apparaissent, mais sont appliquées lorsque l'ensemble du fichier de
+configuration a été lu. Cela implique que dans l'exemple précédent, toute
+utilisation de la politique 'proxy-trust' sera équivalente à la directive
+'SSLProxyVerify none' et que la première définition de cette politique sera
+ignorée. Il est ainsi possible de modifier des politiques préinstallées sans
+avoir à les désactiver.</p>
-<p>Additional to replacing policies, redefinitions may just alter
-an aspect of a policy:</p>
+<p>Il est aussi possible de ne modifier qu'un aspect de la polique SSL :</p>
-<div class="example"><h3>
Policy Redefine</h3><pre class="prettyprint lang-config"><SSLPolicy proxy-trust>
+<div class="example"><h3>
Redéfinition d'un aspect d'une politique SSL</h3><pre class="prettyprint lang-config"><SSLPolicy proxy-trust>
SSLProxyVerify require
</SSLPolicy>
...
</SSLPolicy></pre>
</div>
-<p>This re-uses all settings from the previous 'proxy-trust' and adds
-one directive on top of it. All others still apply. This is very handy
-when pre-defined policies (from Apache itself or a distributor)
-that <em>almost</em> what you need. Previously, such definitions were
-(copied and) edited. This made updating them difficult. Now they can
-be setup like this:</p>
+<p>Toutes les directives de la politique 'proxy-trust' sont alors réutilisées et
+la directive 'SSLProxyVerifyDepth 10' est ajoutée en tête de cette dernière. Cela
+s'avère particulièrement utile lorsque les politiques prédéfinies (par Apache ou
+une distribution) satisfont <em>presque</em> à vos besoins. Auparavant, ces
+politiques devaient être éditées et modifiées après copie éventuelle, ce qui
+compliquait les mises à jour. Elles peuvent maintenant être modifiées comme suit
+:</p>
<div class="example"><h3>Tweak a Pre-Defined Policy</h3><pre class="prettyprint lang-config">Include ssl-policies.conf
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslpolicy" id="sslpolicy">Directive</a> <a name="SSLPolicy" id="SSLPolicy">SSLPolicy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Apply a SSLPolicy by name</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique une politique SSL en la référençant par son nom</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLPolicy <em>name</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.28 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.28 du serveur HTTP Apache</td></tr>
</table>
-<p>This directive applies the set of SSL* directives defined
-under 'name' (see <code class="directive"><SSLPolicy></code>) as the <em>base</em>
-settings in the current context. Apache comes with the following pre-defined policies from
-Mozilla, the makers of the Firefox browser
-(<a href="https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations">see here
-for a detailed description by them.</a>):
+<p>Cette directive permet d'appliquer le jeu de directives définies au sein
+de la polique SSL de nom 'name' (voir directive <code class="directive"><SSLPolicy></code>) comme configuration <em>de base</em> dans
+le contexte courant. Apache httpd est fourni avec les politiques SSL prédéfinies
+suivantes de Mozilla, l'éditeur du navigateur Firefox (<a href="https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations">description
+détaillée</a>) :
</p>
<ul>
- <li><code>modern</code>: recommended when your server is accessible on the open Internet. Works with all modern browsers, but old devices might be unable to connect.</li>
- <li><code>intermediate</code>: the fallback if you need to support old (but not very old) clients.</li>
- <li><code>old</code>: when you need to give Windows XP/Internet Explorer 6 access. The last resort.</li>
+ <li><code>modern</code>: recommandé lorsque votre serveur est accessible
+ depuis internet, fonctionne avec tous les navigateurs modernes, mais les
+ anciens navigateurs peuvent avoir des difficultés pour se connecter.</li>
+ <li><code>intermediate</code>: version dégradée si vous devez supporter les
+ vieux clients (mais pas trop vieux).</li>
+ <li><code>old</code>: lorsque vous voulez donner accès à IE6 sous Windows XP
+ (ultime recours).</li>
</ul>
-<p>You can check the detailed description of all defined policies via the command line:</p>
-<div class="example"><h3>List all Defined Policies</h3><pre class="prettyprint lang-sh">httpd -t -D DUMP_SSL_POLICIES</pre>
+<p>Vous poubez obtenir une description détaillée de toutes les politiques
+prédéfinies via la commande :</p>
+<div class="example"><h3>Liste de toutes les politiques SSL prédéfinies</h3><pre class="prettyprint lang-sh">httpd -t -D DUMP_SSL_POLICIES</pre>
</div>
-<p>A SSLPolicy defines the baseline for the context it is used in. That means that any
-other SSL* directives in the same context override it. As an example of this, see the effective
-<code class="directive">SSLProtocol</code> value in the following settings:</p>
+<p>Une politique SSL définit une base de départ pour le contexte dans lequel
+elle est définie. Autrement dit, toute directive SSL complémentaire l'emporte
+sur cette politique. A titre d'exemple, observez la valeur effective de
+<code class="directive">SSLProtocol</code> dans la configuration suivante :</p>
-<div class="example"><h3>Policy Precedence</h3><pre class="prettyprint lang-config"><VirtualHost...> # effective: 'all'
+<div class="example"><h3>Politiques SSL et priorités</h3><pre class="prettyprint lang-config"><VirtualHost...> # effective : 'all'
SSLPolicy modern
SSLProtocol all
</VirtualHost>
-<VirtualHost...> # effective: 'all'
+<VirtualHost...> # effective : 'all'
SSLProtocol all
SSLPolicy modern
</VirtualHost>
SSLPolicy modern
-<VirtualHost...> # effective: 'all'
+<VirtualHost...> # effective : 'all'
SSLProtocol all
</VirtualHost>
SSLProtocol all
-<VirtualHost...> # effective: '+TLSv1.2'
+<VirtualHost...> # effective : '+TLSv1.2'
SSLPolicy modern
</VirtualHost></pre>
</div>
-<p>There can be more than one policy applied in a context. The
-later ones overshadowing the earlier ones:</p>
+<p>Il est possible d'appliquer plusieurs politiques SSL au sein d'un même
+contexte. Les dernières auront alors priorité sur les précédentes :</p>
-<div class="example"><h3>Policy Ordering</h3><pre class="prettyprint lang-config"><VirtualHost...> # effective protocol: 'all -SSLv3'
+<div class="example"><h3>Ordonnancement des politiques SSL</h3><pre class="prettyprint lang-config"><VirtualHost...> # protocole effectif : 'all -SSLv3'
SSLPolicy modern
SSLPolicy intermediate
</VirtualHost>
-<VirtualHost...> # effective protocol: '+TLSv1.2'
+<VirtualHost...> # protocole effectif : '+TLSv1.2'
SSLPolicy intermediate
SSLPolicy modern
</VirtualHost></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslprotocol" id="sslprotocol">Directive</a> <a name="SSLProtocol" id="SSLProtocol">SSLProtocol</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure usable SSL/TLS protocol versions</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProtocol [+|-]<em>protocol</em> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Indique les versions du protocole SSL/TLS
+disponibles</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProtocol [+|-]<em>protocole</em> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProtocol all -SSLv3</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive can be used to control which versions of the SSL/TLS protocol
-will be accepted in new connections.</p>
+Cette directive permet de définir quelles versions du protocole SSL/TLS
+seront acceptées lors de l'initialisation d'une nouvelle connexion.</p>
<p>
-The available (case-insensitive) <em>protocol</em>s are:</p>
+Les <em>protocole</em>s disponibles sont les suivants (sensibles à la
+casse) :</p>
<ul>
<li><code>SSLv3</code>
<p>
- This is the Secure Sockets Layer (SSL) protocol, version 3.0, from
- the Netscape Corporation.
- It is the successor to SSLv2 and the predecessor to TLSv1, but is
- deprecated in <a href="http://www.ietf.org/rfc/rfc7568.txt">RFC 7568</a>.</p></li>
+ Il s'agit du protocole Secure Sockets Layer (SSL) version 3.0 de
+ Netscape Corporation. C'est le successeur de SSLv2 et le
+ prédécesseur de TLSv1, mais est considéré comme
+ obsolète dans la <a href="http://www.ietf.org/rfc/rfc7568.txt">RFC
+ 7568</a></p></li>
<li><code>TLSv1</code>
<p>
- This is the Transport Layer Security (TLS) protocol, version 1.0.
- It is the successor to SSLv3 and is defined in
- <a href="http://www.ietf.org/rfc/rfc2246.txt">RFC 2246</a>.
- It is supported by nearly every client.</p></li>
+ Il s'agit du protocole Transport Layer Security (TLS) version 1.0.
+ C'est le successeur de SSLv3, et il est défini dans la <a href="http://www.ietf.org/rfc/rfc2246.txt">RFC2246</a>.</p></li>
-<li><code>TLSv1.1</code> (when using OpenSSL 1.0.1 and later)
+<li><code>TLSv1.1</code> (à partir de la version 1.0.1 d'OpenSSL)
<p>
- A revision of the TLS 1.0 protocol, as defined in
- <a href="http://www.ietf.org/rfc/rfc4346.txt">RFC 4346</a>.</p></li>
+ Une révision du protocole TLS 1.0 définie dans la <a href="http://www.ietf.org/rfc/rfc4346.txt">RFC 4346</a>. Il est
+ supporté par la plupart des clients.</p></li>
-<li><code>TLSv1.2</code> (when using OpenSSL 1.0.1 and later)
+<li><code>TLSv1.2</code> (à partir de la version 1.0.1 d'OpenSSL)
<p>
- A revision of the TLS 1.1 protocol, as defined in
- <a href="http://www.ietf.org/rfc/rfc5246.txt">RFC 5246</a>.</p></li>
+ Une révision du protocole TLS 1.1 définie dans la <a href="http://www.ietf.org/rfc/rfc5246.txt">RFC 5246</a>.</p></li>
<li><code>all</code>
<p>
- This is a shortcut for ``<code>+SSLv3 +TLSv1</code>'' or
- - when using OpenSSL 1.0.1 and later -
- ``<code>+SSLv3 +TLSv1 +TLSv1.1 +TLSv1.2</code>'', respectively
- (except for OpenSSL versions compiled with the ``no-ssl3'' configuration
- option, where <code>all</code> does not include <code>+SSLv3</code>).</p></li>
+ C'est un raccourci pour ``<code>+SSLv3 +TLSv1</code>'' ou - à partir
+ de la version 1.0.1 d'OpenSSL - ``<code>+SSLv3 +TLSv1 +TLSv1.1
+ +TLSv1.2</code>'' (sauf si OpenSSL a été compilé avec l'option
+ ``no-ssl3'', auquel cas <code>all</code> n'inclura pas
+ <code>+SSLv3</code>).</p></li>
</ul>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProtocol TLSv1</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProtocol TLSv1</pre>
</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="sslproxycacertificatefile" id="sslproxycacertificatefile">Directive</a> <a name="SSLProxyCACertificateFile" id="SSLProxyCACertificateFile">SSLProxyCACertificateFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA Certificates
-for Remote Server Auth</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la concaténation des certificats de CA
+codés en PEM pour l'authentification des serveurs distants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCACertificateFile <em>file-path</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the <em>all-in-one</em> file where you can assemble the
-Certificates of Certification Authorities (CA) whose <em>remote servers</em> you deal
-with. These are used for Remote Server Authentication. Such a file is simply the
-concatenation of the various PEM-encoded Certificate files, in order of
-preference. This can be used alternatively and/or additionally to
-<code class="directive"><a href="#sslproxycacertificatepath">SSLProxyCACertificatePath</a></code>.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-remote-server.crt"</pre>
+Cette directive permet de définir le fichier <em>tout-en-un</em> où sont
+stockés les certificats des Autorités de Certification (CA) pour les
+<em>serveurs distants</em> auxquels vous avez à faire. On les utilise
+lors de l'authentification du serveur distant. Un tel fichier contient
+la simple concaténation des différents fichiers de certificats codés en
+PEM, classés par ordre de préférence. On peut utiliser cette directive à
+la place et/ou en complément de la directive <code class="directive"><a href="#sslproxycacertificatepath">SSLProxyCACertificatePath</a></code>.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyCACertificateFile
+"/usr/local/apache2/conf/ssl.crt/ca-bundle-serveur.distant.crt"</pre>
</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="sslproxycacertificatepath" id="sslproxycacertificatepath">Directive</a> <a name="SSLProxyCACertificatePath" id="SSLProxyCACertificatePath">SSLProxyCACertificatePath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA Certificates for
-Remote Server Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCACertificatePath <em>directory-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire des certificats de CA codés en PEM pour
+l'authentification des serveurs distants</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCACertificatePath <em>chemin-répertoire</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the directory where you keep the Certificates of
-Certification Authorities (CAs) whose remote servers you deal with. These are used to
-verify the remote server certificate on Remote Server Authentication.</p>
+Cette directive permet de spécifier le répertoire où sont stockés les
+certificats des Autorités de Certification (CAs) pour les serveurs
+distants auxquels vous avez à faire. On les utilise pour vérifier le
+certificat du serveur distant lors de l'authentification de ce
+dernier.</p>
<p>
-The files in this directory have to be PEM-encoded and are accessed through
-hash filenames. So usually you can't just place the Certificate files
-there: you also have to create symbolic links named
-<em>hash-value</em><code>.N</code>. And you should always make sure this directory
-contains the appropriate symbolic links.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyCACertificatePath "/usr/local/apache2/conf/ssl.crt/"</pre>
+Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Il ne
+suffit donc pas de placer les fichiers de certificats dans ce répertoire
+: vous devez aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.N</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyCACertificatePath "/usr/local/apache2/conf/ssl.crt/"</pre>
</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="sslproxycarevocationcheck" id="sslproxycarevocationcheck">Directive</a> <a name="SSLProxyCARevocationCheck" id="SSLProxyCARevocationCheck">SSLProxyCARevocationCheck</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable CRL-based revocation checking for Remote Server Auth</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la vérification des révocations basée sur les CRLs
+pour l'authentification du serveur distant</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCARevocationCheck chain|leaf|none</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyCARevocationCheck none</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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-Enables certificate revocation list (CRL) checking for the
-<em>remote servers</em> you deal with. At least one of
-<code class="directive"><a href="#sslproxycarevocationfile">SSLProxyCARevocationFile</a></code>
-or <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code> must be
-configured. When set to <code>chain</code> (recommended setting),
-CRL checks are applied to all certificates in the chain, while setting it to
-<code>leaf</code> limits the checks to the end-entity cert.
+Active la vérification des révocations basée sur les Listes de
+révocations de Certificats (CRL) pour les <em>serveurs distants</em>
+auxquels vous vous connectez. A moins une des directives <code class="directive"><a href="#sslproxycarevocationfile">SSLProxyCARevocationFile</a></code> ou <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code> doit être définie.
+Lorsque cette directive est définie à <code>chain</code> (valeur
+recommandée), les vérifications CRL sont effectuées sur tous les
+certificats de la chaîne, alors que la valeur <code>leaf</code> limite
+la vérification au certificat hors chaîne (la feuille).
</p>
<div class="note">
-<h3>When set to <code>chain</code> or <code>leaf</code>,
-CRLs <em>must</em> be available for successful validation</h3>
-<p>
-Prior to version 2.3.15, CRL checking in mod_ssl also succeeded when
-no CRL(s) were found in any of the locations configured with
-<code class="directive"><a href="#sslproxycarevocationfile">SSLProxyCARevocationFile</a></code>
-or <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code>.
-With the introduction of this directive, the behavior has been changed:
-when checking is enabled, CRLs <em>must</em> be present for the validation
-to succeed - otherwise it will fail with an
-<code>"unable to get certificate CRL"</code> error.
+<h3>Lorsque la directive est définie à <code>chain</code> ou
+<code>leaf</code>, les CRLs doivent être disponibles pour que la
+validation réussisse</h3>
+<p>
+Avant la version 2.3.15, les vérifications CRL dans mod_ssl
+réussissaient même si aucune CRL n'était trouvée dans les chemins
+définis par les directives <code class="directive"><a href="#sslproxycarevocationfile">SSLProxyCARevocationFile</a></code> ou <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code>. Le comportement a
+changé avec l'introduction de cette directive : lorsque la vérification
+est activée, les CRLs <em>doivent</em> être présentes pour que la
+validation réussisse ; dans le cas contraire, elle échouera avec une
+erreur <code>"CRL introuvable"</code>.
</p>
</div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyCARevocationCheck chain</pre>
+<div class="example"><h3>Exmple</h3><pre class="prettyprint lang-config">SSLProxyCARevocationCheck chain</pre>
</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="sslproxycarevocationfile" id="sslproxycarevocationfile">Directive</a> <a name="SSLProxyCARevocationFile" id="SSLProxyCARevocationFile">SSLProxyCARevocationFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA CRLs for
-Remote Server Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCARevocationFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la concaténation des CRLs de CA codés en
+PEM pour l'authentification des serveurs distants</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCARevocationFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the <em>all-in-one</em> file where you can
-assemble the Certificate Revocation Lists (CRL) of Certification
-Authorities (CA) whose <em>remote servers</em> you deal with. These are used
-for Remote Server Authentication. Such a file is simply the concatenation of
-the various PEM-encoded CRL files, in order of preference. This can be
-used alternatively and/or additionally to <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code>.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-remote-server.crl"</pre>
+Cette directive permet de définir le fichier <em>tout-en-un</em> où sont
+rassemblées les Listes de Révocation de Certificats (CRLs) des Autorités
+de certification (CAs) pour les <em>serveurs distants</em> auxquels vous
+avez à faire. On les utilise pour l'authentification des serveurs
+distants. Un tel fichier contient la simple concaténation des différents
+fichiers de CRLs codés en PEM, classés par ordre de préférence. Cette
+directive peut être utilisée à la place et/ou en complément de la
+directive <code class="directive"><a href="#sslproxycarevocationpath">SSLProxyCARevocationPath</a></code>.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyCARevocationFile
+"/usr/local/apache2/conf/ssl.crl/ca-bundle-serveur.distant.crl"</pre>
</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="sslproxycarevocationpath" id="sslproxycarevocationpath">Directive</a> <a name="SSLProxyCARevocationPath" id="SSLProxyCARevocationPath">SSLProxyCARevocationPath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded CA CRLs for
-Remote Server Auth</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCARevocationPath <em>directory-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire des CRLs de CA codés en PEM pour
+l'authentification des serveurs distants</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCARevocationPath <em>chemin-répertoire</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the directory where you keep the Certificate Revocation
-Lists (CRL) of Certification Authorities (CAs) whose remote servers you deal with.
-These are used to revoke the remote server certificate on Remote Server Authentication.</p>
+Cette directive permet de définir le répertoire où sont stockées les
+Listes de Révocation de Certificats (CRL) des Autorités de Certification
+(CAs) pour les serveurs distants auxquels vous avez à faire. On les
+utilise pour révoquer les certificats des serveurs distants au cours de
+l'authentification de ces derniers.</p>
<p>
-The files in this directory have to be PEM-encoded and are accessed through
-hash filenames. So usually you have not only to place the CRL files there.
-Additionally you have to create symbolic links named
-<em>hash-value</em><code>.rN</code>. And you should always make sure this directory
-contains the appropriate symbolic links.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyCARevocationPath "/usr/local/apache2/conf/ssl.crl/"</pre>
+Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Il ne
+suffit donc pas de placer les fichiers de CRL dans ce répertoire
+: vous devez aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.rN</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyCARevocationPath "/usr/local/apache2/conf/ssl.crl/"</pre>
</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="sslproxycheckpeercn" id="sslproxycheckpeercn">Directive</a> <a name="SSLProxyCheckPeerCN" id="SSLProxyCheckPeerCN">SSLProxyCheckPeerCN</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to check the remote server certificate's CN field
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration de la vérification du champ CN du certificat
+du serveur distant
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCheckPeerCN on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyCheckPeerCN on</code></td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets whether the remote server certificate's CN field is
-compared against the hostname of the request URL. If both are not equal
-a 502 status code (Bad Gateway) is sent. <code>SSLProxyCheckPeerCN</code> is
-superseded by <code class="directive"><a href="#sslproxycheckpeername">SSLProxyCheckPeerName</a></code>
-in release 2.4.5 and later.
+Cette directive permet de définir si le champ CN du certificat
+du serveur distant doit être comparé au nom de serveur de l'URL de la
+requête. S'ils ne correspondent pas, un
+code d'état 502 (Bad Gateway) est envoyé. A partir de la version 2.4.5, la
+directive <code class="directive"><a href="#sslproxycheckpeername">SSLProxyCheckPeerName</a></code>
+l'emporte sur la directive <code>SSLProxyCheckPeerCN</code>.
</p>
<p>
-In all releases 2.4.5 through 2.4.20, setting
-<code>SSLProxyCheckPeerName off</code> was sufficient to enable this behavior
-(as the <code>SSLProxyCheckPeerCN</code> default was <code>on</code>.) In
-these releases, both directives must be set to <code>off</code> to completely
-avoid remote server certificate name validation. Many users reported this
-to be very confusing.
+De la version 2.4.5 à la version 2.4.20, spécifier <code>SSLProxyCheckPeerName
+off</code> était suffisant pour activer cette fonctionnalité (étant donné que la
+valeur par défaut de la directive <code>SSLProxyCheckPeerCN</code> était
+<code>on</code>). Avec ces mêmes versions, les deux directives devaient être
+définies à <code>off</code> pour éviter la validation du nom de certificat du
+serveur distant. De nombreux utilisateurs ont signalé ce comportement comme
+étant source de confusion.
</p>
<p>
-As of release 2.4.21, all configurations which enable either one of the
-<code>SSLProxyCheckPeerName</code> or <code>SSLProxyCheckPeerCN</code> options
-will use the new <code class="directive"><a href="#sslproxycheckpeername">SSLProxyCheckPeerName</a></code>
-behavior, and all configurations which disable either one of the
-<code>SSLProxyCheckPeerName</code> or <code>SSLProxyCheckPeerCN</code> options
-will suppress all remote server certificate name validation. Only the following
-configuration will trigger the legacy certificate CN comparison in 2.4.21 and
-later releases;
+A partir de la version 2.4.21, toute configuration qui active une des
+deux options <code>SSLProxyCheckPeerName</code> ou
+<code>SSLProxyCheckPeerCN</code> adopte le nouveau comportement de la
+directive <code class="directive"><a href="#sslproxycheckpeername">SSLProxyCheckPeerName</a></code>, alors
+que toute configuration qui désactive une des options
+<code>SSLProxyCheckPeerName</code> ou <code>SSLProxyCheckPeerCN</code> supprime
+toute validation du nom de certificat du serveur distant. Seule la configuration
+suivante peut rétablir le comportement traditionnel en matière de comparaison
+des CN de certificats dans les versions 2.4.21 et ultérieures.
</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyCheckPeerCN on
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProxyCheckPeerCN on
SSLProxyCheckPeerName off</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="sslproxycheckpeerexpire" id="sslproxycheckpeerexpire">Directive</a> <a name="SSLProxyCheckPeerExpire" id="SSLProxyCheckPeerExpire">SSLProxyCheckPeerExpire</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to check if remote server certificate is expired
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration de la vérification de l'expiration du
+certificat du serveur distant
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCheckPeerExpire on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyCheckPeerExpire on</code></td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets whether it is checked if the remote server certificate
-is expired or not. If the check fails a 502 status code (Bad Gateway) is
-sent.
+Cette directive permet de définir si l'expiration du certificat du
+serveur distant doit être vérifiée ou non. Si la vérification échoue, un
+code d'état 502 (Bad Gateway) est envoyé.
</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyCheckPeerExpire on</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProxyCheckPeerExpire on</pre>
</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="sslproxycheckpeername" id="sslproxycheckpeername">Directive</a> <a name="SSLProxyCheckPeerName" id="SSLProxyCheckPeerName">SSLProxyCheckPeerName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure host name checking for remote server certificates
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure la vérification du nom d'hôte pour les
+certificats serveur distant
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCheckPeerName on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyCheckPeerName 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.4.5 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
+Apache</td></tr>
</table>
<p>
-This directive configures host name checking for server certificates when
-mod_ssl is acting as an SSL client. The check will succeed if the host name
-from the request URI matches one of the CN attribute(s) of the certificate's
-subject, or matches the subjectAltName extension. If the check fails, the SSL
-request is aborted and a 502 status code (Bad Gateway) is returned.
+Cette directive permet de configurer la vérification du nom d'hôte pour
+les certificats serveur lorsque mod_ssl agit en tant que client SSL. La
+vérification réussit si le nom d'hôte de l'URI de la requête correspond à un
+des attributs CN du sujet du certificat, ou à l'extension subjectAltName. Si la
+vérification échoue, la requête SSL
+avorte, et un code d'erreur 502 (Bad Gateway) est renvoyé.
</p>
<p>
-Wildcard matching is supported for specific cases: an subjectAltName entry
-of type dNSName, or CN attributes starting with <code>*.</code> will match
-with any host name of the same number of name elements and the same suffix.
-E.g. <code>*.example.org</code> will match <code>foo.example.org</code>,
-but will not match <code>foo.bar.example.org</code>, because the number of
-elements in the respective host names differs.
+Les caractères génériques sont supportés dans certains cas bien spécifiques :
+une entrée subjectAltName de type dNSName ou les attributs CN
+commençant par <code>*.</code> correspondront à tout nom d'hôte comportant
+le même nombre de champs et le même suffixe ; par exemple,
+<code>*.example.org</code> correspondra à <code>foo.example.org</code>,
+mais pas à <code>foo.bar.example.org</code> car le nombre d'éléments dans les
+nom est différent.
</p>
<p>
-This feature was introduced in 2.4.5 and superseded the behavior of the
-<code class="directive"><a href="#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code> directive, which
-only tested the exact value in the first CN attribute against the host name.
-However, many users were confused by the behavior of using these directives
-individually, so the mutual behavior of <code>SSLProxyCheckPeerName</code>
-and <code>SSLProxyCheckPeerCN</code> directives were improved in release
-2.4.21. See the <code class="directive"><a href="#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code>
-directive description for the original behavior and details of these
-improvements.
+Cette fonctionnalité a été introduite avec la version 2.4.5 et l'emporte sur la
+directive <code class="directive"><a href="#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code> qui ne
+comparait que la valeur exacte du premier attribut CN avec le nom d'hôte.
+Cependant, de nombreux utilisateurs étaient déconcertés par le comportement
+induit par l'utilisation de ces deux directives individuellement, si bien que ce
+comportement a été amélioré avec la version 2.4.21. Voir la description de la
+directive <code class="directive"><a href="#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code> pour le
+comportement original et des détails à propos de ces améliorations.
</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="sslproxyciphersuite" id="sslproxyciphersuite">Directive</a> <a name="SSLProxyCipherSuite" id="SSLProxyCipherSuite">SSLProxyCipherSuite</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cipher Suite available for negotiation in SSL
-proxy handshake</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCipherSuite <em>cipher-spec</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Algorithmes de chiffrement disponibles pour la négociation
+lors de l'initialisation d'une connexion SSL de mandataire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyCipherSuite <em>algorithmes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyCipherSuite ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+EXP</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>Equivalent to <code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code>, but
-for the proxy connection.
-Please refer to <code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code>
-for additional information.</p>
+<p>Cette directive est équivalente à la directive <code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code>, mais s'applique à une connexion de
+mandataire. Veuillez vous reporter à la directive <code class="directive"><a href="#sslciphersuite">SSLCipherSuite</a></code> pour plus d'informations.</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="sslproxyengine" id="sslproxyengine">Directive</a> <a name="SSLProxyEngine" id="SSLProxyEngine">SSLProxyEngine</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SSL Proxy Engine Operation Switch</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrupteur marche/arrêt du moteur de mandataire
+SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyEngine on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyEngine 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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive toggles the usage of the SSL/TLS Protocol Engine for proxy. This
-is usually used inside a <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> section to enable SSL/TLS for proxy
-usage in a particular virtual host. By default the SSL/TLS Protocol Engine is
-disabled for proxy both for the main server and all configured virtual hosts.</p>
+Cette directive permet d'activer/désactiver l'utilisation du moteur de
+protocole SSL/TLS pour le mandataire. On l'utilise en général à
+l'intérieur d'une section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> pour activer le protocole SSL/TLS
+dans le cadre d'un mandataire pour un serveur virtuel particulier. Par
+défaut, le moteur de protocole SSL/TLS est désactivé pour la fonction de
+mandataire du serveur principal et de tous les serveurs virtuels
+configurés.</p>
-<p>Note that the <code class="directive">SSLProxyEngine</code> directive should not, in
-general, be included in a virtual host that will be acting as a
-forward proxy (using <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code>
-or <code class="directive"><a href="../mod/mod_proxy.html#proxyrequests">ProxyRequests</a></code> directives).
-<code class="directive">SSLProxyEngine</code> is not required to enable a forward proxy
-server to proxy SSL/TLS requests.</p>
+<p>Notez que la directive <code class="directive">SSLProxyEngine</code> ne doit
+généralement pas être utilisée dans le cadre d'un serveur virtuel qui agit en
+tant que mandataire direct (via les directives <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> ou <code class="directive"><a href="../mod/mod_proxy.html#proxyrequests">ProxyRequests</a></code>).
+<code class="directive">SSLProxyEngine</code> n'est pas nécessaire pour activer un
+serveur mandataire direct pour les requêtes SSL/TLS.</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><VirtualHost _default_:443>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><VirtualHost _default_:443>
SSLProxyEngine on
#...
</VirtualHost></pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslproxymachinecertificatechainfile" id="sslproxymachinecertificatechainfile">Directive</a> <a name="SSLProxyMachineCertificateChainFile" id="SSLProxyMachineCertificateChainFile">SSLProxyMachineCertificateChainFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificateChainFile <em>filename</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier de certificats de CA encodés PEM concaténés permettant au
+mandataire de choisir un certificat</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificateChainFile <em>nom-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the all-in-one file where you keep the certificate chain
-for all of the client certs in use. This directive will be needed if the
-remote server presents a list of CA certificates that are not direct signers
-of one of the configured client certificates.
+Cette directive permet de définir le fichier global où est enregistrée
+la chaîne de certification pour tous les certificats clients utilisés.
+Elle est nécessaire si le serveur distant présente une liste de
+certificats de CA qui ne sont pas les signataires directs d'un des
+certificats clients configurés.
</p>
<p>
-This referenced file is simply the concatenation of the various PEM-encoded
-certificate files. Upon startup, each client certificate configured will
-be examined and a chain of trust will be constructed.
+Ce fichier contient tout simplement la concaténation des différents
+fichiers de certificats encodés PEM. Au démarrage, chaque certificat
+client configuré est examiné et une chaîne de certification est
+construite.
</p>
-<div class="warning"><h3>Security warning</h3>
-<p>If this directive is enabled, all of the certificates in the file will be
-trusted as if they were also in <code class="directive"><a href="#sslproxycacertificatefile">
-SSLProxyCACertificateFile</a></code>.</p>
+<div class="warning"><h3>Avertissement en matière de sécurité</h3>
+<p>Si cette directive est définie, tous les certificats contenus dans le
+fichier spécifié seront considérés comme étant de confiance, comme s'ils
+étaient aussi désignés dans la directive <code class="directive"><a href="#sslproxycacertificatefile">SSLProxyCACertificateFile</a></code>.</p>
</div>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificateChainFile "/usr/local/apache2/conf/ssl.crt/proxyCA.pem"</pre>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificateChainFile
+"/usr/local/apache2/conf/ssl.crt/proxyCA.pem"</pre>
</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="sslproxymachinecertificatefile" id="sslproxymachinecertificatefile">Directive</a> <a name="SSLProxyMachineCertificateFile" id="SSLProxyMachineCertificateFile">SSLProxyMachineCertificateFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File of concatenated PEM-encoded client certificates and keys to be used by the proxy</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificateFile <em>filename</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichier contenant la concaténation des clés et certificats
+clients codés en PEM que le mandataire doit utiliser</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificateFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the all-in-one file where you keep the certificates and
-keys used for authentication of the proxy server to remote servers.
+Cette directive permet de définir le fichier tout-en-un où sont stockés
+les clés et certificats permettant au serveur mandataire de
+s'authentifier auprès des serveurs distants.
</p>
<p>
-This referenced file is simply the concatenation of the various PEM-encoded
-certificate files, in order of preference. Use this directive alternatively
-or additionally to <code>SSLProxyMachineCertificatePath</code>.
+Le fichier spécifié est la simple concaténation des différents fichiers
+de certificats codés en PEM, classés par ordre de préférence. Cette
+directive s'utilise à la place ou en complément de la directive
+<code>SSLProxyMachineCertificatePath</code>.
</p>
<div class="warning">
-<p>Currently there is no support for encrypted private keys</p>
+<p>Actuellement, les clés privées chiffrées ne sont pas supportées.</p>
</div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificateFile "/usr/local/apache2/conf/ssl.crt/proxy.pem"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificateFile "/usr/local/apache2/conf/ssl.crt/proxy.pem"</pre>
</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="sslproxymachinecertificatepath" id="sslproxymachinecertificatepath">Directive</a> <a name="SSLProxyMachineCertificatePath" id="SSLProxyMachineCertificatePath">SSLProxyMachineCertificatePath</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory of PEM-encoded client certificates and keys to be used by the proxy</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificatePath <em>directory</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire des clés et certificats clients codés en PEM que
+le mandataire doit utiliser</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyMachineCertificatePath <em>chemin-répertoire</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the directory where you keep the certificates and
-keys used for authentication of the proxy server to remote servers.
+Cette directive permet de définir le répertoire où sont stockés les clés
+et certificats permettant au serveur mandataire de s'authentifier auprès
+des serveurs distants.
</p>
-<p>The files in this directory must be PEM-encoded and are accessed through
-hash filenames. Additionally, you must create symbolic links named
-<code><em>hash-value</em>.N</code>. And you should always make sure this
-directory contains the appropriate symbolic links.</p>
+<p>Les fichiers de ce répertoire doivent être codés en PEM et ils sont
+accédés via des noms de fichier sous forme de condensés ou hash. Vous
+devez donc aussi créer des liens symboliques nommés
+<em>valeur-de-hashage</em><code>.N</code>, et vous devez toujours vous
+assurer que ce répertoire contient les liens symboliques appropriés.</p>
<div class="warning">
-<p>Currently there is no support for encrypted private keys</p>
+<p>Actuellement, les clés privées chiffrées ne sont pas supportées.</p>
</div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificatePath "/usr/local/apache2/conf/proxy.crt/"</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProxyMachineCertificatePath "/usr/local/apache2/conf/proxy.crt/"</pre>
</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="sslproxypolicy" id="sslproxypolicy">Directive</a> <a name="SSLProxyPolicy" id="SSLProxyPolicy">SSLProxyPolicy</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Apply the SSLProxy* parts alone of a SSLPolicy</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique que les directives SSLProxy* d'une politique SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyPolicy <em>name</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.28 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.28 du serveur HTTP Apache</td></tr>
</table>
-<p>This directive is similar to <code class="directive">SSLPolicy</code>, but
-applies only the SSLProxy* directives defined in the policy. This helps
-when you need different policies for front and backends:</p>
+<p>Cette directive est similaire à la directive <code class="directive">SSLPolicy</code>
+mais elle n'applique que les directives SSLProxy* définies dans la politique SSL
+spécifiée. Ceci s'avère utile lorsque vous avez besoin de politiques SSL
+différentes pour les serveurs d'avant et d'arrière-plan :</p>
-<div class="example"><h3>A
nother Policies for Proxy Only</h3><pre class="prettyprint lang-config">SSLPolicy modern
+<div class="example"><h3>A
utre politique SSL pour le mandataire seulement</h3><pre class="prettyprint lang-config">SSLPolicy modern
SSLProxyPolicy intermediate</pre>
</div>
-<p>In this example, the 'modern' policy is first applied for front- and backend. The backend
-parts are then overwritten by the 'intermediate' policy settings.</p>
+<p>Dans cet exemple, la politique 'modern' est tout d'abord appliquée pour
+l'avant et l'arrière-plan. La politique 'intermediate' est ensuite appliquée au
+mandataire en ne prenant en compte que les directives SSLProxy*.</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="sslproxyprotocol" id="sslproxyprotocol">Directive</a> <a name="SSLProxyProtocol" id="SSLProxyProtocol">SSLProxyProtocol</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure usable SSL protocol flavors for proxy usage</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyProtocol [+|-]<em>protocol</em> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les protocoles SSL disponibles pour la fonction de
+mandataire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyProtocol [+|-]<em>protocole</em> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyProtocol all -SSLv3</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>Extension</td></tr>
</table>
<p>
-This directive can be used to control the SSL protocol flavors mod_ssl should
-use when establishing its server environment for proxy . It will only connect
-to servers using one of the provided protocols.</p>
-<p>Please refer to <code class="directive"><a href="#sslprotocol">SSLProtocol</a></code>
-for additional information.
+Cette directive permet de définir les protocoles SSL que mod_ssl peut
+utiliser lors de l'élaboration de son environnement de serveur pour la
+fonction de mandataire. Il ne se connectera qu'aux serveurs utilisant un
+des protocoles spécifiés.</p>
+<p>Veuillez vous reporter à la directive <code class="directive"><a href="#sslprotocol">SSLProtocol</a></code> pour plus d'informations.
</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="sslproxyverify" id="sslproxyverify">Directive</a> <a name="SSLProxyVerify" id="SSLProxyVerify">SSLProxyVerify</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of remote server Certificate verification</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyVerify <em>level</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Niveau de vérification du certificat du serveur
+distant</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyVerify <em>niveau</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyVerify none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>When a proxy is configured to forward requests to a remote SSL
-server, this directive can be used to configure certificate
-verification of the remote server. </p>
+<p>Lorsqu'un mandataire est configuré pour faire suivre les requêtes
+vers un serveur SSL distant, cette directive permet de configurer la
+vérification du certificat de ce serveur distant.</p>
+
<p>
-The following levels are available for <em>level</em>:</p>
+Les valeurs de <em>niveau</em>x disponibles sont les suivantes :</p>
<ul>
<li><strong>none</strong>:
- no remote server Certificate is required at all</li>
+ aucun certificat n'est requis pour le serveur distant</li>
<li><strong>optional</strong>:
- the remote server <em>may</em> present a valid Certificate</li>
+ le serveur distant <em>peut</em> présenter un certificat valide</li>
<li><strong>require</strong>:
- the remote server <em>has to</em> present a valid Certificate</li>
+ le serveur distant <em>doit</em> présenter un certificat valide</li>
<li><strong>optional_no_ca</strong>:
- the remote server may present a valid Certificate<br />
- but it need not to be (successfully) verifiable.</li>
+ le serveur distant peut présenter un certificat valide<br />
+ mais il n'est pas nécessaire qu'il soit vérifiable (avec succès).</li>
</ul>
-<p>In practice only levels <strong>none</strong> and
+<p>En pratique, seuls les niveaux <strong>none</strong> et
+<strong>require</strong> sont vraiment intéressants, car le niveau
+<strong>optional</strong> ne fonctionne pas avec tous les serveurs, et
+le niveau <strong>optional_no_ca</strong> va tout à fait à l'encontre de
+l'idée que l'on peut se faire de l'authentification (mais peut tout de
+même être utilisé pour établir des pages de test SSL, etc...)
+
+In practice only levels <strong>none</strong> and
<strong>require</strong> are really interesting, because level
<strong>optional</strong> doesn't work with all servers and level
<strong>optional_no_ca</strong> is actually against the idea of
authentication (but can be used to establish SSL test pages, etc.)</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLProxyVerify require</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLProxyVerify require</pre>
</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="sslproxyverifydepth" id="sslproxyverifydepth">Directive</a> <a name="SSLProxyVerifyDepth" id="SSLProxyVerifyDepth">SSLProxyVerifyDepth</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum depth of CA Certificates in Remote Server
-Certificate verification</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyVerifyDepth <em>number</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Niveau de profondeur maximum dans les certificats de CA
+lors de la vérification du certificat du serveur distant</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLProxyVerifyDepth <em>niveau</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLProxyVerifyDepth 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets how deeply mod_ssl should verify before deciding that the
-remote server does not have a valid certificate. </p>
+Cette directive permet de définir le niveau de profondeur maximum
+jusqu'auquel mod_ssl doit aller au cours de sa vérification avant de
+décider que le serveur distant ne possède pas de certificat valide.</p>
<p>
-The depth actually is the maximum number of intermediate certificate issuers,
-i.e. the number of CA certificates which are max allowed to be followed while
-verifying the remote server certificate. A depth of 0 means that self-signed
-remote server certificates are accepted only, the default depth of 1 means
-the remote server certificate can be self-signed or has to be signed by a CA
-which is directly known to the server (i.e. the CA's certificate is under
-<code class="directive"><a href="#sslproxycacertificatepath">SSLProxyCACertificatePath</a></code>), etc.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLProxyVerifyDepth 10</pre>
+La profondeur correspond en fait au nombre maximum de fournisseurs de
+certificats intermédiaires, c'est à dire le nombre maximum de
+certificats
+de CA que l'on peut consulter lors de la vérification du certificat du
+serveur distant. Une profondeur de 0 signifie que seuls les certificats
+de serveurs distants auto-signés sont acceptés, et la profondeur par
+défaut de 1 que le certificat du serveur distant peut être soit
+auto-signé, soit signé par une CA connue directement du serveur (en
+d'autres termes, le certificat de CA est référencé par la directive
+<code class="directive"><a href="#sslproxycacertificatepath">SSLProxyCACertificatePath</a></code>),
+etc...</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLProxyVerifyDepth 10</pre>
</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="sslrandomseed" id="sslrandomseed">Directive</a> <a name="SSLRandomSeed" id="SSLRandomSeed">SSLRandomSeed</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pseudo Random Number Generator (PRNG) seeding
-source</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRandomSeed <em>context</em> <em>source</em>
-[<em>bytes</em>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Source de déclenchement du Générateur de Nombres
+Pseudo-Aléatoires (PRNG)</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRandomSeed <em>contexte</em> <em>source</em>
+[<em>nombre</em>]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This configures one or more sources for seeding the Pseudo Random Number
-Generator (PRNG) in OpenSSL at startup time (<em>context</em> is
-<code>startup</code>) and/or just before a new SSL connection is established
-(<em>context</em> is <code>connect</code>). This directive can only be used
-in the global server context because the PRNG is a global facility.</p>
+Cette directive permet de définir une ou plusieurs sources de
+déclenchement du Générateur de Nombres Pseudo-Aléatoires (PRNG) dans
+OpenSSL au démarrage du serveur (si <em>contexte</em> a pour valeur
+<code>startup</code>) et/ou juste avant l'établissement d'une nouvelle
+connexion SSL (si <em>contexte</em> a pour valeur <code>connect</code>).
+Cette directive ne peut être utilisée qu'au niveau du serveur global car
+le PRNG est un service global.</p>
<p>
-The following <em>source</em> variants are available:</p>
+Les différentes valeurs de <em>source</em> disponibles sont :</p>
<ul>
<li><code>builtin</code>
- <p> This is the always available builtin seeding source. Its usage
- consumes minimum CPU cycles under runtime and hence can be always used
- without drawbacks. The source used for seeding the PRNG contains of the
- current time, the current process id and (when applicable) a randomly
- chosen 1KB extract of the inter-process scoreboard structure of Apache.
- The drawback is that this is not really a strong source and at startup
- time (where the scoreboard is still not available) this source just
- produces a few bytes of entropy. So you should always, at least for the
- startup, use an additional seeding source.</p></li>
-<li><code>file:/path/to/source</code>
- <p>
- This variant uses an external file <code>/path/to/source</code> as the
- source for seeding the PRNG. When <em>bytes</em> is specified, only the
- first <em>bytes</em> number of bytes of the file form the entropy (and
- <em>bytes</em> is given to <code>/path/to/source</code> as the first
- argument). When <em>bytes</em> is not specified the whole file forms the
- entropy (and <code>0</code> is given to <code>/path/to/source</code> as
- the first argument). Use this especially at startup time, for instance
- with an available <code>/dev/random</code> and/or
- <code>/dev/urandom</code> devices (which usually exist on modern Unix
- derivatives like FreeBSD and Linux).</p>
- <p>
- <em>But be careful</em>: Usually <code>/dev/random</code> provides only as
- much entropy data as it actually has, i.e. when you request 512 bytes of
- entropy, but the device currently has only 100 bytes available two things
- can happen: On some platforms you receive only the 100 bytes while on
- other platforms the read blocks until enough bytes are available (which
- can take a long time). Here using an existing <code>/dev/urandom</code> is
- better, because it never blocks and actually gives the amount of requested
- data. The drawback is just that the quality of the received data may not
- be the best.</p></li>
-
-<li><code>exec:/path/to/program</code>
+ <p>Cette source de déclenchement intégrée est toujours disponible.
+ Son utilisation consomme un minimum de cycles CPU en cours
+ d'exécution, et son utilisation ne présente de ce fait aucun
+ problème. La source utilisée pour déclencher le PRNG contient la
+ date courante, l'identifiant du processus courant et (si disponible)
+ un extrait de 1Ko aléatoirement choisi de la structure d'Apache pour
+ les échanges inter-processus. Ceci présente un inconvénient car le
+ caractère aléatoire de cette source n'est pas vraiment fort, et au
+ démarrage (lorsque la structure d'échanges n'est pas encore
+ disponible), cette source ne produit que quelques octets d'entropie.
+ Vous devez donc toujours utiliser une source de déclenchement
+ additionnelle, au moins pour le démarrage.</p></li>
+<li><code>file:/chemin/vers/source</code>
<p>
- This variant uses an external executable
- <code>/path/to/program</code> as the source for seeding the
- PRNG. When <em>bytes</em> is specified, only the first
- <em>bytes</em> number of bytes of its <code>stdout</code> contents
- form the entropy. When <em>bytes</em> is not specified, the
- entirety of the data produced on <code>stdout</code> form the
- entropy. Use this only at startup time when you need a very strong
- seeding with the help of an external program (for instance as in
- the example above with the <code>truerand</code> utility you can
- find in the mod_ssl distribution which is based on the AT&T
- <em>truerand</em> library). Using this in the connection context
- slows down the server too dramatically, of course. So usually you
- should avoid using external programs in that context.</p></li>
-<li><code>egd:/path/to/egd-socket</code> (Unix only)
+ Cette variante utilise un fichier externe
+ <code>file:/chemin/vers/source</code> comme source de déclenchement
+ du PRNG. Lorsque <em>nombre</em> est spécifié, seuls les
+ <em>nombre</em> premiers octets du fichier forment l'entropie (et
+ <em>nombre</em> est fourni comme premier argument à
+ <code>/chemin/vers/source</code>). Lorsque <em>nombre</em> n'est pas
+ spécifié, l'ensemble du fichier forme l'entropie (et <code>0</code>
+ est fourni comme premier argument à
+ <code>/chemin/vers/source</code>). Utilisez cette source en
+ particulier au démarrage, par exemple avec un fichier de
+ périphérique <code>/dev/random</code> et/ou
+ <code>/dev/urandom</code> (qui sont en général présent sur les
+ plate-formes dérivées d'Unix modernes comme FreeBSD et Linux).</p>
+ <p><em>Soyez cependant prudent</em> : en général,
+ <code>/dev/random</code> ne fournit que l'entropie dont il dispose
+ réellement ; en d'autres termes, lorsque vous demandez 512 octets
+ d'entropie, si le périphérique ne dispose que de 100 octets, deux
+ choses peuvent se produire : sur certaines plates-formes, vous ne
+ recevez que les 100 octets, alors que sur d'autres, la lecture se
+ bloque jusqu'à ce qu'un nombre suffisant d'octets soit disponible
+ (ce qui peut prendre beaucoup de temps). Il est préférable ici
+ d'utiliser le périphérique <code>/dev/urandom</code>, car il ne se
+ bloque jamais et fournit vraiment la quantité de données demandées.
+ Comme inconvénient, les données reçues ne sont pas forcément de la
+ meilleure qualité.</p></li>
+
+<li><code>exec:/chemin/vers/programme</code>
<p>
- This variant uses the Unix domain socket of the
- external Entropy Gathering Daemon (EGD) (see <a href="http://www.lothar.com/tech/crypto/">http://www.lothar.com/tech
- /crypto/</a>) to seed the PRNG. Use this if no random device exists
- on your platform.</p></li>
+ Cette variante utilise un exécutable externe
+ <code>/chemin/vers/programme</code> comme source de déclenchement du
+ PRNG. Lorsque <em>nombre</em> est spécifié, seules les
+ <em>nombre</em> premiers octets de son flux <code>stdout</code>
+ forment l'entropie. Lorsque <em>nombre</em> n'est pas spécifié,
+ l'intégralité des données produites sur <code>stdout</code> forment
+ l'entropie. N'utilisez cette variante qu'au démarrage où une source
+ de déclenchement fortement aléatoire est nécessaire, en utilisant
+ un programme externe (comme dans l'exemple
+ ci-dessous avec l'utilitaire <code>truerand</code> basé sur la
+ bibliothèque <em>truerand</em> de AT&T que vous trouverez
+ dans la distribution de mod_ssl). Bien entendu, l'utilisation de
+ cette variante dans un contexte "connection" ralentit le serveur de
+ manière trop importante, et en général, vous devez donc éviter
+ d'utiliser des programmes externes dans ce contexte.</p></li>
+<li><code>egd:/chemin/vers/socket-egd</code> (Unix seulement)
+ <p>Cette variante utilise le socket de domaine Unix du Démon
+ Générateur d'Entropie externe ou Entropy Gathering Daemon ou EGD
+ (voir <a href="http://www.lothar.com/tech/crypto/">http://www.lothar.com/tech
+ /crypto/</a>) pour déclencher le PRNG. N'utilisez cette variante que
+ si votre plate-forme ne possède pas de périphérique random ou
+ urandom.</p></li>
</ul>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLRandomSeed startup builtin
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLRandomSeed startup builtin
SSLRandomSeed startup "file:/dev/random"
SSLRandomSeed startup "file:/dev/urandom" 1024
SSLRandomSeed startup "exec:/usr/local/bin/truerand" 16
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="sslrenegbuffersize" id="sslrenegbuffersize">Directive</a> <a name="SSLRenegBufferSize" id="SSLRenegBufferSize">SSLRenegBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the size for the SSL renegotiation buffer</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRenegBufferSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille du tampon de renégociation
+SSL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRenegBufferSize <var>taille</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLRenegBufferSize 131072</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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
-<p>If an SSL renegotiation is required in per-location context, for
-example, any use of <code class="directive"><a href="#sslverifyclient">SSLVerifyClient</a></code> in a Directory or
-Location block, then <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> must buffer any HTTP
-request body into memory until the new SSL handshake can be performed.
-This directive can be used to set the amount of memory that will be
-used for this buffer. </p>
+<p>Si une renégociation SSL est requise dans un contexte de répertoire,
+par exemple avec l'utilisation de <code class="directive"><a href="#sslverifyclient">SSLVerifyClient</a></code> dans un bloc Directory ou
+Location, mod_ssl doit mettre en tampon en mémoire tout corps de requête
+HTTP en attendant qu'une nouvelle initialisation de connexion SSL puisse
+être effectuée. Cette directive permet de définir la quantité de mémoire
+à allouer pour ce tampon.</p>
<div class="warning"><p>
-Note that in many configurations, the client sending the request body
-will be untrusted so a denial of service attack by consumption of
-memory must be considered when changing this configuration setting.
+Notez que dans de nombreuses configurations, le client qui envoie un
+corps de requête n'est pas forcément digne de confiance, et l'on doit
+par conséquent prendre en considération la possibilité d'une attaque de
+type déni de service lorsqu'on modifie la valeur de cette directive.
</p></div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLRenegBufferSize 262144</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLRenegBufferSize 262144</pre>
</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="sslrequire" id="sslrequire">Directive</a> <a name="SSLRequire" id="SSLRequire">SSLRequire</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allow access only when an arbitrarily complex
-boolean expression is true</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'autorise l'accès que lorsqu'une expression booléenne
+complexe et arbitraire est vraie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRequire <em>expression</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
+<div class="note"><h3>SSLRequire is obsolète</h3>
+<p><code>SSLRequire</code> est obsolète et doit en général être
+remplacée par l'expression <a href="mod_authz_core.html#reqexpr">Require</a>. La syntaxe <a href="../expr.html">ap_expr</a> de l'expression <code>Require</code> est
+une extension de la syntaxe de <code>SSLRequire</code>, avec les
+différences suivantes :</p>
-<div class="note"><h3>SSLRequire is deprecated</h3>
-<p><code>SSLRequire</code> is deprecated and should in general be replaced
-by <a href="mod_authz_core.html#reqexpr">Require expr</a>. The so called
-<a href="../expr.html">ap_expr</a> syntax of <code>Require expr</code> is
-a superset of the syntax of <code>SSLRequire</code>, with the following
-exception:</p>
-
-<p>In <code>SSLRequire</code>, the comparison operators <code><</code>,
-<code><=</code>, ... are completely equivalent to the operators
-<code>lt</code>, <code>le</code>, ... and work in a somewhat peculiar way that
-first compares the length of two strings and then the lexical order.
-On the other hand, <a href="../expr.html">ap_expr</a> has two sets of
-comparison operators: The operators <code><</code>,
-<code><=</code>, ... do lexical string comparison, while the operators
-<code>-lt</code>, <code>-le</code>, ... do integer comparison.
-For the latter, there are also aliases without the leading dashes:
-<code>lt</code>, <code>le</code>, ...
+<p>Avec <code>SSLRequire</code>, les opérateurs de comparaison
+<code><</code>, <code><=</code>, ... sont strictement équivalents
+aux opérateurs <code>lt</code>, <code>le</code>, ... , et fonctionnent
+selon une méthode qui compare tout d'abord la longueur des deux chaînes,
+puis l'ordre alphabétique. Les expressions <a href="../expr.html">ap_expr</a>, quant à elles, possèdent deux jeux
+d'opérateurs de comparaison : les opérateurs <code><</code>,
+<code><=</code>, ... effectuent une comparaison alphabétique de
+chaînes, alors que les opérateurs <code>-lt</code>, <code>-le</code>,
+... effectuent une comparaison d'entiers. Ces derniers possèdent aussi
+des alias sans tiret initial : <code>lt</code>, <code>le</code>, ...
</p>
</div>
+<p>Cette directive permet de spécifier une condition générale d'accès
+qui doit être entièrement satisfaite pour que l'accès soit autorisé.
+C'est une directive très puissante, car la condition d'accès spécifiée
+est une expression booléenne complexe et arbitraire contenant un nombre
+quelconque de vérifications quant aux autorisations d'accès.</p>
<p>
-This directive specifies a general access requirement which has to be
-fulfilled in order to allow access. It is a very powerful directive because the
-requirement specification is an arbitrarily complex boolean expression
-containing any number of access checks.</p>
-<p>
-The <em>expression</em> must match the following syntax (given as a BNF
-grammar notation):</p>
+L'<em>expression</em> doit respecter la syntaxe suivante (fournie ici
+sous la forme d'une notation dans le style de la grammaire BNF) :</p>
<blockquote>
<pre>expr ::= "<strong>true</strong>" | "<strong>false</strong>"
| "<strong>!</strong>" expr
variable ::= "<strong>%{</strong>" varname "<strong>}</strong>"
function ::= funcname "<strong>(</strong>" funcargs "<strong>)</strong>"</pre>
</blockquote>
-<p>For <code>varname</code> any of the variables described in <a href="#envvars">Environment Variables</a> can be used. For
-<code>funcname</code> the available functions are listed in
-the <a href="../expr.html#functions">ap_expr documentation</a>.</p>
-
-<p>The <em>expression</em> is parsed into an internal machine
-representation when the configuration is loaded, and then evaluated
-during request processing. In .htaccess context, the <em>expression</em> is
-both parsed and executed each time the .htaccess file is encountered during
-request processing.</p>
-
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)-/ \
+<p>Pour <code>varname</code>, toute variable décrite dans <a href="#envvars">Variables d'environnement</a> pourra être utilisée.
+Pour <code>funcname</code>, vous trouverez la liste des fonctions
+disponibles dans la <a href="../expr.html#functions">documentation
+ap_expr</a>.</p>
+
+<p><em>expression</em> est interprétée et traduite
+sous une forme machine interne lors du chargement de la configuration,
+puis évaluée lors du traitement de la requête. Dans le contexte des
+fichiers .htaccess, <em>expression</em> est interprétée et exécutée
+chaque fois que le fichier .htaccess intervient lors du traitement de la
+requête.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)-/ \
and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
and %{TIME_WDAY} -ge 1 and %{TIME_WDAY} -le 5 \
or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/</pre>
</div>
-<p>The <code>PeerExtList(<em>object-ID</em>)</code> function expects
-to find zero or more instances of the X.509 certificate extension
-identified by the given <em>object ID</em> (OID) in the client certificate.
-The expression evaluates to true if the left-hand side string matches
-exactly against the value of an extension identified with this OID.
-(If multiple extensions with the same OID are present, at least one
-extension must match).</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLRequire "foobar" in PeerExtList("1.2.3.4.5.6")</pre>
+<p>La fonction <code>PeerExtList(<em>identifiant objet</em>)</code>
+recherche une instance d'extension de certificat X.509 identifiée par
+<em>identifiant objet</em> (OID) dans le certificat client. L'expression est
+évaluée à true si la partie gauche de la chaîne correspond exactement à
+la valeur d'une extension identifiée par cet OID (Si plusieurs
+extensions possèdent le même OID, l'une d'entre elles au moins doit
+correspondre).
+</p>
+
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLRequire "foobar" in PeerExtList("1.2.3.4.5.6")</pre>
</div>
-<div class="note"><h3>Notes on the PeerExtList function</h3>
+<div class="note"><h3>Notes à propos de la fonction PeerExtList</h3>
<ul>
-<li><p>The object ID can be specified either as a descriptive
-name recognized by the SSL library, such as <code>"nsComment"</code>,
-or as a numeric OID, such as <code>"1.2.3.4.5.6"</code>.</p></li>
+<li><p>L'identifiant objet peut être spécifié soit comme un nom
+descriptif reconnu par la bibliothèque SSL, tel que
+<code>"nsComment"</code>, soit comme un OID numérique tel que
+<code>"1.2.3.4.5.6"</code>.</p></li>
-<li><p>Expressions with types known to the SSL library are rendered to
-a string before comparison. For an extension with a type not
-recognized by the SSL library, mod_ssl will parse the value if it is
-one of the primitive ASN.1 types UTF8String, IA5String, VisibleString,
-or BMPString. For an extension of one of these types, the string
-value will be converted to UTF-8 if necessary, then compared against
-the left-hand-side expression.</p></li>
+<li><p>Les expressions contenant des types connus de la bibliothèque
+SSL sont transformées en chaînes avant comparaison. Pour les extensions
+contenant un type non connu de la bibliothèque SSL, mod_ssl va essayer
+d'interpréter la valeur s'il s'agit d'un des types ASN.1 primaire UTF8String,
+IA5String, VisibleString, ou BMPString. Si l'extension correspond à un
+de ces types, la chaîne sera convertie en UTF-8 si nécessaire, puis
+comparée avec la partie gauche de l'expression.</p></li>
</ul>
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../env.html">Environment Variables in Apache HTTP Server</a>,
-for additional examples.
+<li><a href="../env.html">Les variables d'environnement dans le
+serveur HTTP Apache</a>, pour d'autres exemples.
</li>
<li><a href="mod_authz_core.html#reqexpr">Require expr</a></li>
-<li><a href="../expr.html">Generic expression syntax in Apache HTTP Server</a>
+<li><a href="../expr.html">Syntaxe générale des expressions dans le
+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="sslrequiressl" id="sslrequiressl">Directive</a> <a name="SSLRequireSSL" id="SSLRequireSSL">SSLRequireSSL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Deny access when SSL is not used for the
-HTTP request</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interdit l'accès lorsque la requête HTTP n'utilise pas
+SSL</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLRequireSSL</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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive forbids access unless HTTP over SSL (i.e. HTTPS) is enabled for
-the current connection. This is very handy inside the SSL-enabled virtual
-host or directories for defending against configuration errors that expose
-stuff that should be protected. When this directive is present all requests
-are denied which are not using SSL.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLRequireSSL</pre>
+Cette directive interdit l'accès si HTTP sur SSL (c'est à dire HTTPS)
+n'est pas activé pour la connexion courante. Ceci est très pratique dans
+un serveur virtuel où SSL est activé ou dans un répertoire pour se
+protéger des erreurs de configuration qui pourraient donner accès à des
+ressources protégées. Lorsque cette directive est présente, toutes les
+requêtes qui n'utilisent pas SSL sont rejetées.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLRequireSSL</pre>
</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="sslsessioncache" id="sslsessioncache">Directive</a> <a name="SSLSessionCache" id="SSLSessionCache">SSLSessionCache</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of the global/inter-process SSL Session
-Cache</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type du cache de session SSL global et
+inter-processus</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionCache <em>type</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLSessionCache none</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#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This configures the storage type of the global/inter-process SSL Session
-Cache. This cache is an optional facility which speeds up parallel request
-processing. For requests to the same server process (via HTTP keep-alive),
-OpenSSL already caches the SSL session information locally. But because modern
-clients request inlined images and other data via parallel requests (usually
-up to four parallel requests are common) those requests are served by
-<em>different</em> pre-forked server processes. Here an inter-process cache
-helps to avoid unnecessary session handshakes.</p>
+Cette directive permet de configurer le type de stockage du cache de
+session SSL global et inter-processus. Ce cache est une fonctionnalité
+optionnelle qui accélère le traitement parallèle des requêtes. Pour ce
+qui est des requêtes vers un même processus du serveur (via HTTP
+keep-alive), OpenSSL met en cache les informations de session SSL en
+interne. Mais comme les clients modernes demandent des images en ligne
+et d'autres données via des requêtes parallèles (un nombre de quatre
+requêtes parallèles est courant), ces requêtes vont être servies par
+<em>plusieurs</em> processus du serveur pré-déclenchés. Ici, un cache
+inter-processus permet d'éviter des négociations de session
+inutiles.</p>
<p>
-The following five storage <em>type</em>s are currently supported:</p>
+Les quatre <em>type</em>s de stockage suivants sont actuellement
+supportés :</p>
<ul>
<li><code>none</code>
- <p>This disables the global/inter-process Session Cache. This
- will incur a noticeable speed penalty and may cause problems if
- using certain browsers, particularly if client certificates are
- enabled. This setting is not recommended.</p></li>
+ <p>Cette valeur désactive le cache de session global et
+ inter-processus, ce qui va ralentir le serveur de manière sensible
+ et peut poser problème avec certains navigateurs, en particulier si
+ les certificats clients sont activés. Cette configuration n'est pas
+ recommandée.</p></li>
<li><code>nonenotnull</code>
- <p>This disables any global/inter-process Session Cache. However
- it does force OpenSSL to send a non-null session ID to
- accommodate buggy clients that require one.</p></li>
-
-<li><code>dbm:/path/to/datafile</code>
-
- <p>This makes use of a DBM hashfile on the local disk to
- synchronize the local OpenSSL memory caches of the server
- processes. This session cache may suffer reliability issues under
- high load. To use this, ensure that
- <code class="module"><a href="../mod/mod_socache_dbm.html">mod_socache_dbm</a></code> is loaded.</p></li>
-
-<li><code>shmcb:/path/to/datafile</code>[<code>(</code><em>size</em><code>)</code>]
-
- <p>This makes use of a high-performance cyclic buffer
- (approx. <em>size</em> bytes in size) inside a shared memory
- segment in RAM (established via <code>/path/to/datafile</code>) to
- synchronize the local OpenSSL memory caches of the server
- processes. This is the recommended session cache. To use this,
- ensure that <code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code> is loaded.</p></li>
-
-<li><code>dc:UNIX:/path/to/socket</code>
-
- <p>This makes use of the <a href="http://distcache.sourceforge.net/">distcache</a> distributed session
- caching libraries. The argument should specify the location of
- the server or proxy to be used using the distcache address syntax;
- for example, <code>UNIX:/path/to/socket</code> specifies a UNIX
- domain socket (typically a local dc_client proxy);
- <code>IP:server.example.com:9001</code> specifies an IP
- address. To use this, ensure that
- <code class="module"><a href="../mod/mod_socache_dc.html">mod_socache_dc</a></code> is loaded.</p></li>
+ <p>Cette valeur désactive tout cache de session global et
+ inter-processus. Cependant, elle force OpenSSL à envoyer un
+ identifiant de session non nul afin de s'adapter aux clients bogués
+ qui en nécessitent un.</p></li>
+
+<li><code>dbm:/chemin/vers/fichier-données</code>
+
+ <p>Cette valeur utilise un fichier de hashage DBM sur disque local
+ pour synchroniser les caches OpenSSL locaux en mémoire des processus
+ du serveur. Ce cache de session peut être sujet à des problèmes de
+ fiabilité sous forte charge. Pour l'utiliser, le module
+ <code class="module"><a href="../mod/mod_socache_dbm.html">mod_socache_dbm</a></code> doit être chargé.</p></li>
+
+<li><code>shmcb:/chemin/vers/fichier-données</code>[<code>(</code><em>nombre</em><code>)</code>]
+
+ <p>Cette valeur utilise un tampon cyclique à hautes performances
+ (d'une taille d'environ <em>nombre</em> octets) dans un segment de
+ mémoire partagée en RAM (établi via
+ <code>/chemin/vers/fichier-données</code>, pour synchroniser les
+ caches OpenSSL locaux en mémoire des processus du serveur. C'est le
+ type de cache de session recommandé. Pour l'utiliser, le module
+ <code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code> doit être chargé.</p></li>
+
+<li><code>dc:UNIX:/chemin/vers/socket</code>
+
+ <p>Cette valeur utilise les bibliothèques de mise en cache de
+ sessions distribuée sur <a href="http://distcache.sourceforge.net/">distcache</a>.
+ L'argument doit spécifier le serveur ou mandataire à utiliser en
+ utilisant la syntaxe d'adressage distcache ; par exemple,
+ <code>UNIX:/chemin/vers/socket</code> spécifie un socket de domaine
+ Unix (en général un mandataire de dc_client local) ;
+ <code>IP:serveur.example.com:9001</code> spécifie une adresse IP.
+ Pour l'utiliser, le module <code class="module"><a href="../mod/mod_socache_dc.html">mod_socache_dc</a></code> doit être
+ chargé.</p></li>
</ul>
-<div class="example"><h3>Ex
amples</h3><pre class="prettyprint lang-config">SSLSessionCache "dbm:/usr/local/apache/logs/ssl_gcache_data"
+<div class="example"><h3>Ex
emples</h3><pre class="prettyprint lang-config">SSLSessionCache "dbm:/usr/local/apache/logs/ssl_gcache_data"
SSLSessionCache "shmcb:/usr/local/apache/logs/ssl_gcache_data(512000)"</pre>
</div>
-<p>The <code>ssl-cache</code> mutex is used to serialize access to
-the session cache to prevent corruption. This mutex can be configured
-using the <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code> directive.</p>
+<p>Le mutex <code>ssl-cache</code> permet de sérialiser l'accès au cache
+de session afin d'éviter toute corruption. Ce mutex peut être configuré
+via la directive <code class="directive"><a href="../mod/core.html#mutex">Mutex</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="sslsessioncachetimeout" id="sslsessioncachetimeout">Directive</a> <a name="SSLSessionCacheTimeout" id="SSLSessionCacheTimeout">SSLSessionCacheTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before an SSL session expires
-in the Session Cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionCacheTimeout <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de secondes avant l'expiration d'une session SSL
+dans le cache de sessions</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionCacheTimeout <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLSessionCacheTimeout 300</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Applies also to RFC 5077 TLS session resumption in Apache 2.4.10 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>S'applique aussi au renouvellement de la session TLS de
+la RFC 5077 à partir de la version 2.4.10 du serveur HTTP Apache</td></tr>
</table>
<p>
-This directive sets the timeout in seconds for the information stored in the
-global/inter-process SSL Session Cache, the OpenSSL internal memory cache and
-for sessions resumed by TLS session resumption (RFC 5077).
-It can be set as low as 15 for testing, but should be set to higher
-values like 300 in real life.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLSessionCacheTimeout 600</pre>
+Cette directive permet de définir la durée de vie en secondes des
+informations stockées dans le cache de sessions SSL global et
+inter-processus, dans le cache OpenSSL interne en mémoire et pour
+les sessions réinitialisées par la reprise de session TLS (RFC 5077). elle peut
+être définie à une valeur d'environ 15 à des fins de test, mais à une
+valeur très supérieure comme 300 en production.</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLSessionCacheTimeout 600</pre>
</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="sslsessionticketkeyfile" id="sslsessionticketkeyfile">Directive</a> <a name="SSLSessionTicketKeyFile" id="SSLSessionTicketKeyFile">SSLSessionTicketKeyFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Persistent encryption/decryption key for TLS session tickets</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionTicketKeyFile <em>file-path</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Clé de chiffrement/déchiffrement permanente pour les
+tickets de session TLS</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionTicketKeyFile <em>chemin-fichier</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.0 and later, if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.0 du serveur HTTP
+Apache, sous réserve que l'on utilise une version 0.9.8h ou supérieure
+d'OpenSSL</td></tr>
</table>
-<p>Optionally configures a secret key for encrypting and decrypting
-TLS session tickets, as defined in
-<a href="http://www.ietf.org/rfc/rfc5077.txt">RFC 5077</a>.
-Primarily suitable for clustered environments where TLS sessions information
-should be shared between multiple nodes. For single-instance httpd setups,
-it is recommended to <em>not</em> configure a ticket key file, but to
-rely on (random) keys generated by mod_ssl at startup, instead.</p>
-<p>The ticket key file must contain 48 bytes of random data,
-preferrably created from a high-entropy source. On a Unix-based system,
-a ticket key file can be created as follows:</p>
+<p>Cette directive permet de définir une clé secrète pour le chiffrement
+et le déchiffrement des tickets de session TLS selon les préconisations
+de la <a href="http://www.ietf.org/rfc/rfc5077.txt">RFC 5077</a>. Elle a
+été conçue à l'origine pour les environnements de clusters où les
+données des sessions TLS doivent être partagées entre plusieurs noeuds.
+Pour les configurations ne comportant qu'une seule instance de httpd, il
+est préférable d'utiliser les clés (aléatoires) générées par mod_ssl au
+démarrage du serveur.</p>
+<p>Le fichier doit contenir 48 octets de données aléatoires créées de
+préférence par une source à haute entropie. Sur un système de type UNIX,
+il est possible de créer le fichier contenant la clé de la manière
+suivante :</p>
<div class="example"><p><code>
-dd if=/dev/random of=/path/to/file.tkey bs=1 count=48
+dd if=/dev/random of=/chemin/vers/fichier.tkey bs=1 count=48
</code></p></div>
-<p>Ticket keys should be rotated (replaced) on a frequent basis,
-as this is the only way to invalidate an existing session ticket -
-OpenSSL currently doesn't allow to specify a limit for ticket lifetimes.
-A new ticket key only gets used after restarting the web server.
-All existing session tickets become invalid after a restart.</p>
+<p>Ces clés doivent être renouvelées fréquemment, car il s'agit du seul
+moyen d'invalider un ticket de session existant - OpenSSL ne permet pas
+actuellement de spécifier une limite à la durée de
+vie des tickets. Une nouvelle clé de ticket ne peut être utilisée qu'après
+redémarrage du serveur web. Tous les tickets de session existants
+deviennent invalides après le redémarrage du serveur.</p>
<div class="warning">
-<p>The ticket key file contains sensitive keying material and should
-be protected with file permissions similar to those used for
-<code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>.</p>
+<p>Ce fichier contient des données sensibles et doit donc être protégé
+par des permissions similaires à celles du fichier spécifié par la
+
directive <code class="directive"><a href="#sslcertificatekeyfile">SSLCertificateKeyFile</a></code>.</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="sslsessiontickets" id="sslsessiontickets">Directive</a> <a name="SSLSessionTickets" id="SSLSessionTickets">SSLSessionTickets</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable use of TLS session tickets</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive les tickets de session TLS</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSessionTickets on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLSessionTickets 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.11 and later, if using OpenSSL 0.9.8f
-or 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, sous réserve d'utiliser OpenSSL version 0.9.8f ou supérieure.
+</td></tr>
</table>
-<p>This directive allows to enable or disable the use of TLS session tickets
-(RFC 5077).</p>
+<p>Cette directive permet d'activer ou de désactiver l'utilisation des
+tickets de session TLS (RFC 5077).</p>
<div class="warning">
-<p>TLS session tickets are enabled by default. Using them without restarting
-the web server with an appropriate frequency (e.g. daily) compromises perfect
-forward secrecy.</p>
+<p>Les tickets de session TLS sont activés par défaut. Les utiliser sans
+redémarrer le serveur selon une périodicité appropriée (par exemple
+quotidiennement) compromet cependant le niveau de confidentialité.</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="sslsrpunknownuserseed" id="sslsrpunknownuserseed">Directive</a> <a name="SSLSRPUnknownUserSeed" id="SSLSRPUnknownUserSeed">SSLSRPUnknownUserSeed</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>SRP unknown user seed</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Source de randomisation pour utilisateur SRP inconnu</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSRPUnknownUserSeed <em>secret-string</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.4 and later, if using OpenSSL 1.0.1 or
-later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.4 du serveur HTTP
+Apache, sous réserve d'utiliser OpenSSL version 1.0.1 ou supérieure.</td></tr>
</table>
<p>
-This directive sets the seed used to fake SRP user parameters for unknown
-users, to avoid leaking whether a given user exists. Specify a secret
-string. If this directive is not used, then Apache will return the
-UNKNOWN_PSK_IDENTITY alert to clients who specify an unknown username.
+Cette directive permet de définir la source de randomisation à utiliser
+pour les utilisateurs SRP inconnus, ceci afin de combler les manques en
+cas d'existence d'un tel utilisateur. Elle définit une chaîne secrète. Si
+cette directive n'est pas définie, Apache renverra une alerte
+UNKNOWN_PSK_IDENTITY aux clients qui fournissent un nom d'utilisateur
+inconnu.
</p>
-<div class="example"><h3>Ex
ample</h3><p><code>
+<div class="example"><h3>Ex
emple</h3><p><code>
SSLSRPUnknownUserSeed "secret"
</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="sslsrpverifierfile" id="sslsrpverifierfile">Directive</a> <a name="SSLSRPVerifierFile" id="SSLSRPVerifierFile">SSLSRPVerifierFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Path to SRP verifier file</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier de vérification SRP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLSRPVerifierFile <em>file-path</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 2.4.4 and later, if using OpenSSL 1.0.1 or
-later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.4.4 du serveur HTTP
+Apache, sous réserve d'utiliser OpenSSL version 1.0.1 ou supérieure.</td></tr>
</table>
<p>
-This directive enables TLS-SRP and sets the path to the OpenSSL SRP (Secure
-Remote Password) verifier file containing TLS-SRP usernames, verifiers, salts,
-and group parameters.</p>
-<div class="example"><h3>Example</h3><p><code>
+Cette directive permet d'activer TLS-SRP et de définir le chemin du
+fichier de vérification OpenSSL SRP (Mot de passe distant sécurisé)
+contenant les noms d'utilisateurs TLS-SRP, les vérificateurs, les
+"grains de sel" (salts), ainsi que les paramètres de groupe.</p>
+<div class="example"><h3>Exemple</h3><p><code>
SSLSRPVerifierFile "/path/to/file.srpv"
</code></p></div>
<p>
-The verifier file can be created with the <code>openssl</code> command line
-utility:</p>
-<div class="example"><h3>Cr
eating the SRP verifier file</h3><p><code>
+Le fichier de vérification peut être créé via l'utilitaire en ligne de
+commande <code>openssl</code> :</p>
+<div class="example"><h3>Cr
éation du fichier de vérification SRP</h3><p><code>
openssl srp -srpvfile passwd.srpv -userinfo "some info" -add username
</code></p></div>
-<p> The value given with the optional <code>-userinfo</code> parameter is
-avalable in the <code>SSL_SRP_USERINFO</code> request environment variable.</p>
+<p>La valeur affectée au paramètre optionnel <code>-userinfo</code> est
+enregistrée dans la variable d'environnement
+<code>SSL_SRP_USERINFO</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="sslstaplingcache" id="sslstaplingcache">Directive</a> <a name="SSLStaplingCache" id="SSLStaplingCache">SSLStaplingCache</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures the OCSP stapling cache</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration du cache pour l'agrafage OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingCache <em>type</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>Configures the cache used to store OCSP responses which get included
-in the TLS handshake if <code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code>
-is enabled. Configuration of a cache is mandatory for OCSP stapling.
-With the exception of <code>none</code> and <code>nonenotnull</code>,
-the same storage types are supported as with
+<p>Si <code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> est à "on",
+cette directive permet de configurer le cache destiné à stocker les
+réponses OCSP incluses dans la négociation TLS. La configuration d'un
+cache est obligatoire pour pouvoir utiliser l'agrafage OCSP. A
+l'exception de <code>none</code> et <code>nonenotnull</code>, cette
+directive supporte les mêmes types de stockage que la directive
<code class="directive"><a href="#sslsessioncache">SSLSessionCache</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="sslstaplingerrorcachetimeout" id="sslstaplingerrorcachetimeout">Directive</a> <a name="SSLStaplingErrorCacheTimeout" id="SSLStaplingErrorCacheTimeout">SSLStaplingErrorCacheTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before expiring invalid responses in the OCSP stapling cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingErrorCacheTimeout <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de vie des réponses invalides dans le cache pour
+agrafage OCSP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingErrorCacheTimeout <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingErrorCacheTimeout 600</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>Sets the timeout in seconds before <em>invalid</em> responses
-in the OCSP stapling cache (configured through <code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code>) will expire.
-To set the cache timeout for valid responses, see
+<p>Cette directive permet de définir la durée de vie des réponses
+<em>invalides</em> dans le cache pour agrafage OCSP configuré via la
+directive <code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code>. Pour
+définir la durée de vie des réponses valides, voir la directive
<code class="directive"><a href="#sslstaplingstandardcachetimeout">SSLStaplingStandardCacheTimeout</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="sslstaplingfaketrylater" id="sslstaplingfaketrylater">Directive</a> <a name="SSLStaplingFakeTryLater" id="SSLStaplingFakeTryLater">SSLStaplingFakeTryLater</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Synthesize "tryLater" responses for failed OCSP stapling queries</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Génère une réponse "tryLater" pour les requêtes OCSP échouées</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingFakeTryLater on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingFakeTryLater 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>When enabled and a query to an OCSP responder for stapling
-purposes fails, mod_ssl will synthesize a "tryLater" response for the
-client. Only effective if <code class="directive"><a href="#sslstaplingreturnrespondererrors">SSLStaplingReturnResponderErrors</a></code>
-is also enabled.</p>
+<p>Lorsque cette directive est activée, et si une requête vers un
+serveur OCSP à des fins d'inclusion dans une négociation TLS échoue,
+mod_ssl va générer une réponse "tryLater" pour le client (<code class="directive"><a href="#sslstaplingreturnrespondererrors">SSLStaplingReturnResponderErrors</a></code> doit être
+activé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="sslstaplingforceurl" id="sslstaplingforceurl">Directive</a> <a name="SSLStaplingForceURL" id="SSLStaplingForceURL">SSLStaplingForceURL</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Override the OCSP responder URI specified in the certificate's AIA extension</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remplace l'URI du serveur OCSP spécifié dans l'extension
+AIA du certificat</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingForceURL <em>uri</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>This directive overrides the URI of an OCSP responder as obtained from
-the authorityInfoAccess (AIA) extension of the certificate.
-One potential use is when a proxy is used for retrieving OCSP queries.</p>
+<p>Cette directive permet de remplacer l'URI du serveur OCSP extraite de
+l'extension authorityInfoAccess (AIA) du certificat. Elle peut s'avérer
+utile lorsqu'on passe par un mandataire</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="sslstaplingrespondertimeout" id="sslstaplingrespondertimeout">Directive</a> <a name="SSLStaplingResponderTimeout" id="SSLStaplingResponderTimeout">SSLStaplingResponderTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Timeout for OCSP stapling queries</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponderTimeout <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps d'attente maximum pour les requêtes vers les serveurs
+OCSP</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponderTimeout <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingResponderTimeout 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>This option sets the timeout for queries to OCSP responders when
-<code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> is enabled
-and mod_ssl is querying a responder for OCSP stapling purposes.</p>
+<p>Cette directive permet de définir le temps d'attente maximum lorsque
+mod_ssl envoie une requête vers un serveur OCSP afin d'obtenir une
+réponse destinée à être incluse dans les négociations TLS avec les
+clients (<code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> doit
+avoir été activée au préalable).</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="sslstaplingresponsemaxage" id="sslstaplingresponsemaxage">Directive</a> <a name="SSLStaplingResponseMaxAge" id="SSLStaplingResponseMaxAge">SSLStaplingResponseMaxAge</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable age for OCSP stapling responses</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponseMaxAge <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Age maximum autorisé des réponses OCSP incluses dans la
+négociation TLS</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponseMaxAge <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingResponseMaxAge -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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>This option sets the maximum allowable age ("freshness") when
-considering OCSP responses for stapling purposes, i.e. when
-<code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> is turned on.
-The default value (<code>-1</code>) does not enforce a maximum age,
-which means that OCSP responses are considered valid as long as their
-<code>nextUpdate</code> field is in the future.</p>
+<p>Cette directive permet de définir l'âge maximum autorisé
+("fraîcheur") des réponses OCSP incluses dans la négociation TLS
+(<code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> doit
+avoir été activée au préalable). La valeur par défaut (<code>-1</code>)
+ne définit aucun âge maximum, ce qui signifie que les réponses OCSP sont
+considérées comme valides à partir du moment où le contenu de leur champ
+<code>nextUpdate</code> se trouve dans le futur.</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="sslstaplingresponsetimeskew" id="sslstaplingresponsetimeskew">Directive</a> <a name="SSLStaplingResponseTimeSkew" id="SSLStaplingResponseTimeSkew">SSLStaplingResponseTimeSkew</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum allowable time skew for OCSP stapling response validation</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponseTimeSkew <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de vie maximale autorisée des réponses OCSP incluses dans la
+négociation TLS</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingResponseTimeSkew <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingResponseTimeSkew 300</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>This option sets the maximum allowable time skew when mod_ssl checks the
-<code>thisUpdate</code> and <code>nextUpdate</code> fields of OCSP responses
-which get included in the TLS handshake (OCSP stapling). Only applicable
-if <code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> is turned on.</p>
+<p>Cette directive permet de spécifier l'intervalle de temps maximum que
+mod_ssl va calculer en faisant la différence entre les contenus des
+champs <code>nextUpdate</code> et <code>thisUpdate</code> des réponses
+OCSP incluses dans la négociation TLS. Pour pouvoir utiliser cette
+directive, <code class="directive"><a href="#sslusestapling">SSLUseStapling</a></code> doit
+être à "on".</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="sslstaplingreturnrespondererrors" id="sslstaplingreturnrespondererrors">Directive</a> <a name="SSLStaplingReturnResponderErrors" id="SSLStaplingReturnResponderErrors">SSLStaplingReturnResponderErrors</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pass stapling related OCSP errors on to client</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Transmet au client les erreurs survenues lors des requêtes
+OCSP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingReturnResponderErrors on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingReturnResponderErrors 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>When enabled, mod_ssl will pass responses from unsuccessful
-stapling related OCSP queries (such as responses with an overall status
-other than "successful", responses with a certificate status other than
-"good", expired responses etc.) on to the client.
-If set to <code>off</code>, only responses indicating a certificate status
-of "good" will be included in the TLS handshake.</p>
+<p>Lorsque cette directive est activée, mod_ssl va transmettre au client les
+réponses concernant les requêtes OCSP
+échouées (comme les réponses avec un état autre que
+"successful", les réponses avec un statut de certificat autre que
+"good", les réponses
+périmées, etc...). Lorsqu'elle est à
+<code>off</code>, seules les réponses indiquant un statut de certificat
+"good" seront incluses dans les
+négociations TLS avec les clients.</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="sslstaplingstandardcachetimeout" id="sslstaplingstandardcachetimeout">Directive</a> <a name="SSLStaplingStandardCacheTimeout" id="SSLStaplingStandardCacheTimeout">SSLStaplingStandardCacheTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of seconds before expiring responses in the OCSP stapling cache</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingStandardCacheTimeout <em>seconds</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de vie des réponses OCSP dans le cache</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStaplingStandardCacheTimeout <em>secondes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStaplingStandardCacheTimeout 3600</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
</table>
-<p>Sets the timeout in seconds before responses in the OCSP stapling cache
-(configured through <code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code>)
-will expire. This directive applies to <em>valid</em> responses, while
-<code class="directive"><a href="#sslstaplingerrorcachetimeout">SSLStaplingErrorCacheTimeout</a></code> is
-used for controlling the timeout for invalid/unavailable responses.
+<p>Cette directive permet de définir la durée de vie des réponses OCSP
+dans le cache configuré via la directive <code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code>. Elle ne s'applique qu'aux
+réponse <em>valides</em>, alors que la directive <code class="directive"><a href="#sslstaplingerrorcachetimeout">SSLStaplingErrorCacheTimeout</a></code> s'applique aux
+réponses invalides ou non disponibles.
</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="sslstrictsnivhostcheck" id="sslstrictsnivhostcheck">Directive</a> <a name="SSLStrictSNIVHostCheck" id="SSLStrictSNIVHostCheck">SSLStrictSNIVHostCheck</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Whether to allow non-SNI clients to access a name-based virtual
-host.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle de l'accès des clients non-SNI à un serveur virtuel à
+base de nom.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLStrictSNIVHostCheck on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLStrictSNIVHostCheck off</code></td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets whether a non-SNI client is allowed to access a name-based
-virtual host. If set to <code>on</code> in the default name-based virtual
-host, clients that are SNI unaware will not be allowed to access <em>any</em>
-virtual host, belonging to this particular IP / port combination.
-If set to <code>on</code> in any other virtual host, SNI unaware clients
-are not allowed to access this particular virtual host.
+Cette directive permet de contrôler l'accès des clients non-SNI à un serveur
+virtuel à base de nom. Si elle est définie à <code>on</code> dans le
+serveur virtuel à base de nom par défaut, les
+clients non-SNI ne seront autorisés à accéder à aucun serveur virtuel
+appartenant à cette combinaison IP/port. Par
+contre, si elle est définie à <code>on</code> dans un serveur virtuel
+quelconque, les clients non-SNI ne se verront interdire l'accès qu'à ce
+serveur.
</p>
<div class="warning"><p>
-This option is only available if httpd was compiled against an SNI capable
-version of OpenSSL.
+Cette option n'est disponible que si httpd a été compilé avec une
+version d'OpenSSL supportant SNI.
</p></div>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLStrictSNIVHostCheck on</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLStrictSNIVHostCheck on</pre>
</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="sslusername" id="sslusername">Directive</a> <a name="SSLUserName" id="SSLUserName">SSLUserName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Variable name to determine user name</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLUserName <em>varname</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de la variable servant à déterminer le nom de
+l'utilisateur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLUserName <em>nom-var</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the "user" field in the Apache request object.
-This is used by lower modules to identify the user with a character
-string. In particular, this may cause the environment variable
-<code>REMOTE_USER</code> to be set. The <em>varname</em> can be
-any of the <a href="#envvars">SSL environment variables</a>.</p>
+Cette variable permet de définir le champ "user" de l'objet de la
+requête Apache. Ce champ est utilisé par des modules de plus bas niveau
+pour identifier l'utilisateur avec une chaîne de caractères. En
+particulier, l'utilisation de cette directive peut provoquer la
+définition de la variable d'environnement <code>REMOTE_USER</code>.
+La valeur de l'argument <em>nom-var</em> peut correspondre à toute <a href="#envvars">variable d'environnement SSL</a>.</p>
-<p>When the <code>FakeBasicAuth</code> option is enabled, this directive
-instead controls the value of the username embedded within the basic
-
authentication header (see <a href="#ssloptions">SSLOptions</a>).</p>
+<p>Lorsque l'option <code>FakeBasicAuth</code> est activée, cette
+directive contrôle la valeur du nom d'utilisateur contenue dans
+
l'en-tête d'authentification de base (voir <a href="#ssloptions">SSLOptions</a>).</p>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLUserName SSL_CLIENT_S_DN_CN</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLUserName SSL_CLIENT_S_DN_CN</pre>
</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="sslusestapling" id="sslusestapling">Directive</a> <a name="SSLUseStapling" id="SSLUseStapling">SSLUseStapling</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable stapling of OCSP responses in the TLS handshake</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'ajout des réponses OCSP à la négociation TLS</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLUseStapling on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLUseStapling 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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available if using OpenSSL 0.9.8h or later</td></tr>
-</table>
-<p>This option enables OCSP stapling, as defined by the "Certificate
-Status Request" TLS extension specified in RFC 6066. If enabled (and
-requested by the client), mod_ssl will include an OCSP response
-for its own certificate in the TLS handshake. Configuring an
-<code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code> is a
-prerequisite for enabling OCSP stapling.</p>
-
-<p>OCSP stapling relieves the client of querying the OCSP responder
-on its own, but it should be noted that with the RFC 6066 specification,
-the server's <code>CertificateStatus</code> reply may only include an
-OCSP response for a single cert. For server certificates with intermediate
-CA certificates in their chain (the typical case nowadays),
-stapling in its current implementation therefore only partially achieves the
-stated goal of "saving roundtrips and resources" - see also
-<a href="http://www.ietf.org/rfc/rfc6961.txt">RFC 6961</a>
-(TLS Multiple Certificate Status Extension).
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible si on utilise OpenSSL version 0.9.8h ou supérieure</td></tr>
+</table>
+<p>Cette directive permet d'activer l'"Agrafage OCSP" (OCSP stapling)
+selon la définition de l'extension TLS "Certificate Status Request"
+fournie dans la RFC 6066. Si elle est activée et si le client le
+demande, mod_ssl va inclure une réponse OCSP à propos de son propre
+certificat dans la négociation TLS. Pour pouvoir activer l'Agrafage
+OCSP, il est nécessaire de configurer un <code class="directive"><a href="#sslstaplingcache">SSLStaplingCache</a></code>.</p>
+
+<p>L'agrafage OCSP dispense le client de requérir le serveur OCSP
+directement ; il faut cependant noter que selon les spécifications de la
+RFC 6066, la réponse <code>CertificateStatus</code> du serveur ne peut
+inclure une réponse OCSP que pour un seul certificat. Pour les
+certificats de serveur comportant des certificats de CA intermédiaires
+dans leur chaîne (c'est un cas typique de nos jours), l'implémentation
+actuelle de l'agrafage OCSP n'atteint que partiellement l'objectif d'
+"économie en questions/réponse et en ressources". Pour plus de détails,
+voir la <a href="http://www.ietf.org/rfc/rfc6961.txt">RFC 6961</a> (TLS
+Multiple Certificate Status Extension).
</p>
-<p>When OCSP stapling is enabled, the <code>ssl-stapling</code> mutex is used
-to control access to the OCSP stapling cache in order to prevent corruption,
-and the <code>sss-stapling-refresh</code> mutex is used to control refreshes
-of OCSP responses. These mutexes can be configured using the
-<code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code> directive.
+<p>Lorsque l'agrafage OCSP est activé, le mutex
+<code>ssl-stapling</code> contrôle l'accès au cache de l'agrafage OCSP
+afin de prévenir toute corruption, et le mutex
+<code>sss-stapling-refresh</code> contrôle le raffraîchissement des
+réponses OCSP. Ces mutex peuvent être configurés via la directive
+<code class="directive"><a href="../mod/core.html#mutex">Mutex</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="sslverifyclient" id="sslverifyclient">Directive</a> <a name="SSLVerifyClient" id="SSLVerifyClient">SSLVerifyClient</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type of Client Certificate verification</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLVerifyClient <em>level</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Niveau de vérification du certificat client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLVerifyClient <em>niveau</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLVerifyClient 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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets the Certificate verification level for the Client
-Authentication. Notice that this directive can be used both in per-server and
-per-directory context. In per-server context it applies to the client
-authentication process used in the standard SSL handshake when a connection is
-established. In per-directory context it forces a SSL renegotiation with the
-reconfigured client verification level after the HTTP request was read but
-before the HTTP response is sent.</p>
+Cette directive permet de définir le niveau de vérification du
+certificat pour l'authentification du client. Notez que cette directive
+peut être utilisée à la fois dans les contextes du serveur principal et
+du répertoire. Dans le contexte du serveur principal, elle s'applique au
+processus d'authentification du client utilisé au cours de la
+négociation SSL standard lors de l'établissement d'une connexion. Dans
+un contexte de répertoire, elle force une renégociation SSL avec le
+niveau de vérification du client spécifié, après la lecture d'une
+requête HTTP, mais avant l'envoi de la réponse HTTP.</p>
<p>
-The following levels are available for <em>level</em>:</p>
+Les valeurs de <em>niveau</em> disponibles sont les suivantes :</p>
<ul>
<li><strong>none</strong>:
- no client Certificate is required at all</li>
+ aucun certificat client n'est requis</li>
<li><strong>optional</strong>:
- the client <em>may</em> present a valid Certificate</li>
+ le client <em>peut</em> présenter un certificat valide</li>
<li><strong>require</strong>:
- the client <em>has to</em> present a valid Certificate</li>
+ le client <em>doit</em> présenter un certificat valide</li>
<li><strong>optional_no_ca</strong>:
- the client may present a valid Certificate<br />
- but it need not to be (successfully) verifiable. This option
- cannot be relied upon for client authentication. </li>
+ le client peut présenter un certificat valide, mais il n'est pas
+ nécessaire que ce dernier soit vérifiable (avec succès). Cette option ne
+ peut pas être utilisée lors de l'authentification du client.</li>
</ul>
-<div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SSLVerifyClient require</pre>
+<div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SSLVerifyClient require</pre>
</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="sslverifydepth" id="sslverifydepth">Directive</a> <a name="SSLVerifyDepth" id="SSLVerifyDepth">SSLVerifyDepth</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum depth of CA Certificates in Client
-Certificate verification</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLVerifyDepth <em>number</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Profondeur maximale des certificats de CA pour la
+vérification des certificats clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSLVerifyDepth <em>nombre</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SSLVerifyDepth 1</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>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
</table>
<p>
-This directive sets how deeply mod_ssl should verify before deciding that the
-clients don't have a valid certificate. Notice that this directive can be
-used both in per-server and per-directory context. In per-server context it
-applies to the client authentication process used in the standard SSL
-handshake when a connection is established. In per-directory context it forces
-a SSL renegotiation with the reconfigured client verification depth after the
-HTTP request was read but before the HTTP response is sent.</p>
-<p>
-The depth actually is the maximum number of intermediate certificate issuers,
-i.e. the number of CA certificates which are max allowed to be followed while
-verifying the client certificate. A depth of 0 means that self-signed client
-certificates are accepted only, the default depth of 1 means the client
-certificate can be self-signed or has to be signed by a CA which is directly
-known to the server (i.e. the CA's certificate is under
-<code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code>), etc.</p>
-<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SSLVerifyDepth 10</pre>
+Cette directive permet de spécifier la profondeur maximale à laquelle
+mod_ssl va effectuer sa vérification avant de décider que le client ne
+possède pas de certificat valide. Notez que cette directive peut être
+utilisée à la fois dans les contextes du serveur principal et de
+répertoire. Dans le contexte du serveur principal, elle s'applique au
+processus d'authentification du client utilisé au cours de la
+négociation SSL standard lors de l'établissement d'une connexion. Dans
+un contexte de répertoire, elle force une renégociation SSL avec la
+profondeur vérification du client spécifiée, après la lecture d'une
+requête HTTP, mais avant l'envoi de la réponse HTTP.</p>
+<p>
+La profondeur correspond au nombre maximum de fournisseurs de
+certificats intermédiaires, c'est à dire le nombre maximum de
+certificats de CA que l'on est autorisé à suivre lors de la vérification
+du certificat du client. Une profondeur de 0 signifie que seuls les
+certificats clients auto-signés sont acceptés ; la profondeur par défaut
+de 1 signifie que le certificat client peut être soit auto-signé, soit
+signé par une CA connue directement du serveur (c'est à dire que le
+certificat de la CA doit être référencé par la directive <code class="directive"><a href="#sslcacertificatepath">SSLCACertificatePath</a></code>), etc...</p>
+<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SSLVerifyDepth 10</pre>
</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="substitute" id="substitute">Directive</a> <a name="Substitute" id="Substitute">Substitute</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Pattern to filter the response content</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Substitute <var>s/pattern/substitution/[infq]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modèle de substition dans le contenu de la
+réponse</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Substitute <var>s/modèle/substitution/[infq]</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_substitute</td></tr>
</table>
- <p>The <code class="directive">Substitute</code> directive specifies a
- search and replace pattern to apply to the response body.</p>
+ <p>La directive <code class="directive">Substitute</code> permet de
+ spécifier un modèle de recherche/remplacement à appliquer au corps
+ de la réponse.</p>
- <p>The meaning of the pattern can be modified by using any
- combination of these flags:</p>
+ <p>La signification du modèle peut être modifiée via toute
+ combinaison de ces drapeaux :</p>
<dl>
<dt><code>i</code></dt>
- <dd>Perform a case-insensitive match.</dd>
+ <dd>Effectue une comparaison sans tenir compte de la casse.</dd>
<dt><code>n</code></dt>
- <dd>By default the pattern is treated as a regular expression.
- Using the <code>n</code> flag forces the pattern to be treated
- as a fixed string.</dd>
+ <dd>Par défaut, le modèle est traité en tant qu'expression
+ rationnelle. Le drapeau <code>n</code> force le traitement du
+ modèle en tant que chaîne fixe.</dd>
<dt><code>f</code></dt>
- <dd>The <code>f</code> flag causes <code>mod_substitute</code> to flatten the
- result of a substitution allowing for later substitutions to
- take place on the boundary of this one. This is the default.</dd>
+
+ <dd>Avec le drapeau <code>f</code>, <code>mod_substitute</code> met à plat le
+ résultat d'une substitution (les conteneurs ou buckets ne sont
+ pas dissociés), ce qui permet à d'éventuelles substitutions
+ ultérieures de s'effectuer sur cette dernière. C'est le
+ comportement par défaut.</dd>
<dt><code>q</code></dt>
- <dd>The <code>q</code> flag causes <code>mod_substitute</code> to not
- flatten the buckets after each substitution. This can
- result in much faster response and a decrease in memory
- utilization, but should only be used if there is no possibility
- that the result of one substitution will ever match a pattern
- or regex of a subsequent one.</dd>
+
+ <dd>Avec le drapeau <code>q</code>, <code>mod_substitute</code> dissocie les
+ conteneurs (ou buckets) après chaque substitution. Ceci peut
+ améliorer la rapidité de la réponse et diminuer la quantité de
+ mémoire utilisée, mais ne doit être utilisé que s'il n'existe
+ aucune possibilité pour que le résultat d'une substitution ne
+ corresponde au modèle ou à l'expression rationnelle d'une
+ substitution ultérieure.</dd>
</dl>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config"><Location "/">
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config"><Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s/foo/bar/ni"
</Location></pre>
</div>
- <p>If either the pattern or the substitution contain a slash
- character then an alternative delimiter should be used:</p>
+ <p>Si le modèle ou la chaîne de substitution contient un caractère
+ slash '/', il faut utiliser un autre délimiteur :</p>
- <div class="example"><h3>Example of using an alternate delimiter</h3><pre class="prettyprint lang-config"><Location "/">
+ <div class="example"><h3>Exemple d'utilisation d'un délimiteur
+ alternatif</h3><pre class="prettyprint lang-config"><Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|<BR */?>|<br />|i"
</Location></pre>
</div>
- <p>Backreferences can be used in the comparison and in the substitution,
- when regular expressions are used, as illustrated in the following example: </p>
- <div class="example"><h3>Example of using backreferences and captures</h3><pre class="prettyprint lang-config"><Location "/">
+ <p>Lorsqu'on utilise des expressions rationnelles, on peut insérer
+ des références arrières dans les opérations de comparaison et de
+ substitution, comme illustré dans l'exemple suivant :</p>
+ <div class="example"><h3>Exemple d'utilisation de références arrières et de captures</h3><pre class="prettyprint lang-config"><Location "/">
AddOutputFilterByType SUBSTITUTE text/html
- # "foo=k,bar=k" -> "foo/bar=k"
+ # "foo=k,bar=k" -> "foo/bar=k"
Substitute "s|foo=(\w+),bar=\1|foo/bar=$1"
</Location></pre>
</div>
- <p>A common use scenario for <code>mod_substitute</code> is the
- situation in which a front-end server proxies requests to a back-end
- server which returns HTML with hard-coded embedded URLs that refer
- to the back-end server. These URLs don't work for the end-user,
- since the back-end server is unreachable.</p>
+ <p>Un scénario courant d'utilisation de <code>mod_substitute</code>
+ est la situation où un serveur frontal mandate des requêtes pour un
+ serveur d'arrière-plan qui renvoie des documents HTML contenant des
+ URLs intégrées codées en dur qui font référence à ce serveur
+ d'arrière-plan. Ces URLs ne fonctionnent pas pour l'utilisateur
+ final car le serveur d'arrière-plan est hors d'atteinte.</p>
- <p>In this case, <code>mod_substitute</code> can be used to rewrite
- those URLs into something that will work from the front end:</p>
+ <p>On peut, dans ce cas, utiliser <code>mod_substitute</code> pour
+ réécrire ces URLs afin qu'elles soit utilisables dans la partie
+ située derrière le mandataire :</p>
- <div class="example"><h3>Rewriting URLs embedded in proxied content</h3><pre class="prettyprint lang-config">ProxyPass "/blog/" "http://internal.blog.example.com"
+ <div class="example"><h3>Réécriture des URLs intégrées à un contenu mandaté</h3><pre class="prettyprint lang-config">ProxyPass "/blog/" "http://internal.blog.example.com"
ProxyPassReverse "/blog/" "http://internal.blog.example.com/"
Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"</pre>
</div>
- <p><code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
- modifies any <code>Location</code> (redirect) headers that are sent
- by the back-end server, and, in this example,
- <code class="directive">Substitute</code> takes care of the rest of the problem by
- fixing up the HTML response as well.</p>
+ <p>La directive <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> modifie tout en-tête
+ <code>Location</code> (redirection) envoyé par le serveur
+ d'arrière-plan et, dans cet exemple, la directive
+ <code class="directive">Substitute</code> se charge à son tour de la modification de
+ la réponse HTML.</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="substituteinheritbefore" id="substituteinheritbefore">Directive</a> <a name="SubstituteInheritBefore" id="SubstituteInheritBefore">SubstituteInheritBefore</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Change the merge order of inherited patterns</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modifie l'ordre de fusion des modèles hérités</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SubstituteInheritBefore on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SubstituteInheritBefore on</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_substitute</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 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>Whether to apply the inherited <code class="directive"><a href="#substitute">Substitute</a></code>
- patterns first (<code>on</code>), or after the ones of the current
- context (<code>off</code>).
- The latter was the default in versions 2.4 and earlier, but changed
- starting with 2.5, hence <code class="directive">SubstituteInheritBefore</code>
- set to <code>off</code> allows to restore the legacy behaviour.
- <code class="directive">SubstituteInheritBefore</code> is itself inherited,
- hence contexts that inherit it (those that don't specify their own
- <code class="directive">SubstituteInheritBefore</code> value) will apply the
- closest defined merge order.</p>
+ <p>Cette directive permet de définir si l'on applique les modèles
+<code class="directive"><a href="#substitute">Substitute</a></code> hérités en premier
+(valeur <code>on</code>), ou après ceux du
+contexte courant (valeur <code>off</code>). Sa valeur est maintenant
+définie par défaut à <code>on</code> ; il est cependant possible de
+restaurer le comportement des versions 2.4 et antérieures du serveur qui
+était équivalent à une définition à <code>off</code> de cette directive.
+La valeur de la directive <code class="directive">SubstituteInheritBefore</code> est
+elle-même héritée, et les contextes qui en héritent (ceux qui ne
+définissent pas explicitement leur propre directive
+<code class="directive">SubstituteInheritBefore</code>) appliqueront donc
+l'ordre de fusion défini le plus proche.</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="substitutemaxlinelength" id="substitutemaxlinelength">Directive</a> <a name="SubstituteMaxLineLength" id="SubstituteMaxLineLength">SubstituteMaxLineLength</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum line size</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SubstituteMaxLineLength <var>bytes</var>(b|B|k|K|m|M|g|G)</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la longueur de ligne maximale</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SubstituteMaxLineLength <var>octets</var>(b|B|k|K|m|M|g|G)</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SubstituteMaxLineLength 1m</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_substitute</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in httpd 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>The maximum line size handled by <code class="module"><a href="../mod/mod_substitute.html">mod_substitute</a></code>
- is limited to restrict memory use. The limit can be configured
- using <code class="directive">SubstituteMaxLineLength</code>.
- The value can be given as the number of bytes and can be suffixed
- with a single letter <code>b</code>, <code>B</code>, <code>k</code>,
- <code>K</code>, <code>m</code>, <code>M</code>, <code>g</code>,
- <code>G</code> to provide the size in bytes, kilobytes, megabytes
- or gigabytes respectively.</p>
+ <p>La taille de la ligne traitée par <code class="module"><a href="../mod/mod_substitute.html">mod_substitute</a></code>
+ est limitée afin de restreindre l'utilisation des ressources
+ mémoire. La directive <code class="directive">SubstituteMaxLineLength</code>
+ permet de définir cette limite. La valeur de la limite peut être
+ spécifiée sous la forme d'un nombre d'octets, et peut être suffixée
+ par une des lettres <code>b</code>, <code>B</code>, <code>k</code>,
+ <code>K</code>, <code>m</code>, <code>M</code>, <code>g</code> ou
+ <code>G</code> pour fournir une valeur respectivement en octets,
+ kiloOctets, mégaOctets ou gigaOctets.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><Location "/">
AddOutputFilterByType SUBSTITUTE text/html
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="suexecusergroup" id="suexecusergroup">Directive</a> <a name="SuexecUserGroup" id="SuexecUserGroup">SuexecUserGroup</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>User and group for CGI programs to run as</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SuexecUserGroup <em>User Group</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'utilisateur et le groupe sous lesquels les programmes CGI
+doivent s'exécuter</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SuexecUserGroup <em>Utilisateur Groupe</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_suexec</td></tr>
</table>
- <p>The <code class="directive">SuexecUserGroup</code> directive allows you
- to specify a user and group for CGI programs to run as. Non-CGI
- requests are still processed with the user specified in the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> directive.</p>
+ <p>La directive <code class="directive">SuexecUserGroup</code> permet de
+ spécifier l'utilisateur et le groupe sous lesquels les programmes
+ CGI doivent s'exécuter. Les requêtes non CGI seront toujours
+ traitées avec l'utilisateur spécifié par la directive <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">SuexecUserGroup nobody nogroup</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">SuexecUserGroup nobody nogroup</pre>
</div>
- <p>Startup will fail if this directive is specified but the suEXEC
- feature is disabled.</p>
+ <p>Le démarrage va échouer si cette
+ directive est spécifiée et si la fonctionnalité suEXEC est
+ désactivée.</p>
+
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="chrootdir" id="chrootdir">Directive</a> <a name="ChrootDir" id="ChrootDir">ChrootDir</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory for apache to run chroot(8) after startup.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ChrootDir <var>/path/to/directory</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire dans lequel Apache doit se positionner au
+démarrage après avoir effectué un chroot(8).</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ChrootDir <var>chemin-répertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/mod_unixd.html">mod_unixd</a></code></td></tr>
</table>
- <p>This directive tells the server to <var>chroot(8)</var> to the
- specified directory after startup, but before accepting requests
- over the 'net.</p>
- <p>Note that running the server under chroot is not simple,
- and requires additional setup, particularly if you are running
- scripts such as CGI or PHP. Please make sure you are properly
- familiar with the operation of chroot before attempting to use
- this feature.</p>
+ <p>Cette directive
+ permet de faire en sorte que le serveur effectue un
+ <var>chroot(8)</var> vers le répertoire spécifié après le démarrage,
+ mais avant d'accepter les requêtes en provenance du réseau.</p>
+ <p>Notez que l'exécution du serveur dans un environnement chroot
+ n'est pas simple et nécessite une configuration particulière, en
+ particulier si vous utilisez des scripts CGI ou PHP. Il est
+ conseillé de se familiariser avec l'opération chroot avant d'essayer
+ d'utiliser cette fonctionnalité.</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="group" id="group">Directive</a> <a name="Group" id="Group">Group</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Group under which the server will answer
-requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Group <var>unix-group</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Groupe sous lequel le serveur va traiter les
+requêtes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Group <var>groupe unix</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Group #-1</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_unixd</td></tr>
</table>
- <p>The <code class="directive">Group</code> directive sets the group under
- which the server will answer requests. In order to use this
- directive, the server must be run initially as <code>root</code>. If
- you start the server as a non-root user, it will fail to change to the
- specified group, and will instead continue to run as the group of the
- original user. <var>Unix-group</var> is one of:</p>
+ <p>La directive <code class="directive">Group</code> permet de définir le
+ groupe sous lequel le serveur va traiter les requêtes. Pour pouvoir
+ utiliser cette directive, le serveur doit avoir été démarré par
+ <code>root</code>. Si vous démarrez le serveur en tant
+ qu'utilisateur non root, celui-ci ne pourra pas adopter le groupe
+ spécifié comme groupe d'exécution, et continuera à s'exécuter sous
+ le groupe de l'utilisateur qui l'aura lancé. <var>groupe unix</var>
+ peut se présenter sous la forme :</p>
<dl>
- <dt>A group name</dt>
- <dd>Refers to the given group by name.</dd>
+ <dt>d'un nom de groupe</dt>
+ <dd>Référence le groupe spécifié par son nom.</dd>
- <dt><code>#</code> followed by a group number.</dt>
- <dd>Refers to a group by its number.</dd>
+ <dt>du caractère <code>#</code> suivi d'un numéro de groupe.</dt>
+ <dd>Référence le groupe spécifié par son numéro.</dd>
</dl>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">Group www-group</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">Group www-group</pre>
</div>
- <p>It is recommended that you set up a new group specifically for
- running the server. Some admins use user <code>nobody</code>,
- but this is not always possible or desirable.</p>
+ <p>Il est conseillé de créer un groupe dédié à l'exécution du
+ serveur. Certains administrateurs utilisent l'utilisateur
+ <code>nobody</code>, mais ce n'est pas toujours souhaitable ou même
+ possible.</p>
- <div class="warning"><h3>Security</h3>
- <p>Don't set <code class="directive">Group</code> (or <code class="directive"><a href="#user">User</a></code>) to <code>root</code> unless
- you know exactly what you are doing, and what the dangers are.</p>
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Ne définissez pas la directive <code class="directive">Group</code> (ou
+ <code class="directive"><a href="#user">User</a></code>) à
+ <code>root</code> à moins de savoir exactement ce que vous faites
+ ainsi que les dangers encourus.</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="suexec" id="suexec">Directive</a> <a name="Suexec" id="Suexec">Suexec</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable the suEXEC feature</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive la fonctionnalité suEXEC</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Suexec On|Off</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>On if suexec binary exists with proper owner and mode,
-Off otherwise</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>On si le binaire suexec existe avec les mode et propriétaire
+appropriés, Off dans le cas contraire</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_unixd</td></tr>
</table>
- <p>When On, startup will fail if the suexec binary doesn't exist
- or has an invalid owner or file mode.</p>
- <p>When Off, suEXEC will be disabled even if the suexec binary exists
- and has a valid owner and file mode.</p>
+ <p>Lorsque cette directive est définie à On, le démarrage échouera si
+ le binaire suexec n'existe pas, ou possède un propriétaire ou mode
+ fichier invalide.</p>
+ <p>Lorsque cette directive est définie à Off, suEXEC sera désactivé,
+ même si le binaire suexec existe et possède un propriétaire et mode
+ fichier valides.</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="user" id="user">Directive</a> <a name="User" id="User">User</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The userid under which the server will answer
-requests</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>User <var>unix-userid</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'utilisateur sous lequel le serveur va traiter les
+requêtes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>User <var>utilisateur unix</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>User #-1</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_unixd</td></tr>
</table>
- <p>The <code class="directive">User</code> directive sets the user ID as
- which the server will answer requests. In order to use this
- directive, the server must be run initially as <code>root</code>.
- If you start the server as a non-root user, it will fail to change
- to the lesser privileged user, and will instead continue to run as
- that original user. If you do start the server as <code>root</code>,
- then it is normal for the parent process to remain running as root.
- <var>Unix-userid</var> is one of:</p>
+ <p>La directive <code class="directive">User</code> permet de définir
+ l'utilisateur sous lequel le serveur va traiter les requêtes. Pour
+ pouvoir utiliser cette directive, le serveur doit avoir été démarré
+ par <code>root</code>. Si vous démarrez le serveur en tant
+ qu'utilisateur non root, celui-ci ne pourra pas adopter
+ l'utilisateur avec privilèges restreints comme utilisateur
+ d'exécution, et continuera à s'exécuter sous
+ l'utilisateur qui l'aura lancé. Si vous démarrez le serveur en tant
+ que <code>root</code>, il est normal que le processus parent
+ continue à s'exécuter sous root. <var>utilisateur unix</var> peut se
+ présenter sous la forme :</p>
<dl>
- <dt>A username</dt>
- <dd>Refers to the given user by name.</dd>
+ <dt>d'un nom d'utilisateur</dt>
+ <dd>Référence l'utilisateur spécifié par son nom.</dd>
- <dt># followed by a user number.</dt>
- <dd>Refers to a user by its number.</dd>
+ <dt>le caractère # suivi d'un numéro d'utilisateur.</dt>
+ <dd>Référence l'utilisateur spécifié par son numéro.</dd>
</dl>
- <p>The user should have no privileges that result in it being
- able to access files that are not intended to be visible to the
- outside world, and similarly, the user should not be able to
- execute code that is not meant for HTTP requests. It is
- recommended that you set up a new user and group specifically for
- running the server. Some admins use user <code>nobody</code>, but
- this is not always desirable, since the <code>nobody</code> user
- can have other uses on the system.</p>
-
- <div class="warning"><h3>Security</h3>
- <p>Don't set <code class="directive">User</code> (or <code class="directive"><a href="#group">Group</a></code>) to <code>root</code> unless
- you know exactly what you are doing, and what the dangers are.</p>
+ <p>L'utilisateur ne doit pas posséder de privilèges qui lui
+ permettent d'accéder à des fichiers qui ne doivent pas être visibles
+ du monde extérieur, et parallèlement, l'utilisateur ne doit pas
+ exécuter de code dont l'usage soit destiné à un usage autre que les
+ requêtes HTTP. Il est conseillé de créer un utilisateur et un groupe
+ dédiés à l'exécution du serveur. Certains administrateurs utilisent
+ l'utilisateur <code>nobody</code>, mais ce n'est pas toujours
+ souhaitable, car l'utilisateur <code>nobody</code> peut avoir
+ diverses utilisations dans le système.</p>
+
+ <div class="warning"><h3>Sécurité</h3>
+ <p>Ne définissez pas la directive <code class="directive">Group</code> (ou
+ <code class="directive"><a href="#user">User</a></code>) à
+ <code>root</code> à moins de savoir exactement ce que vous faites
+ ainsi que les dangers encourus.</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="userdir" id="userdir">Directive</a> <a name="UserDir" id="UserDir">UserDir</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the user-specific directories</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UserDir <em>directory-filename</em> [<em>directory-filename</em>] ...
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin des répertoires propres à un
+utilisateur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UserDir <em>nom-répertoire</em> [<em>nom-répertoire</em>] ...
</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>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_userdir</td></tr>
</table>
- <p>The <code class="directive">UserDir</code> directive sets the real
- directory in a user's home directory to use when a request for a
- document for a user is received. <em>Directory-filename</em> is
- one of the following:</p>
+ <p>La directive <code class="directive">UserDir</code> permet de définir le
+ répertoire réel du répertoire home d'un utilisateur à utiliser à la
+ réception d'une requête pour un document de cet utilisateur.
+ <em>nom-répertoire</em> peut se présenter sous la forme suivante
+ :</p>
<ul>
- <li>The name of a directory or a pattern such as those shown
- below.</li>
-
- <li>The keyword <code>disabled</code>. This turns off
- <em>all</em> username-to-directory translations except those
- explicitly named with the <code>enabled</code> keyword (see
- below).</li>
-
- <li>The keyword <code>disabled</code> followed by a
- space-delimited list of usernames. Usernames that appear in
- such a list will <em>never</em> have directory translation
- performed, even if they appear in an <code>enabled</code>
- clause.</li>
-
- <li>The keyword <code>enabled</code> followed by a
- space-delimited list of usernames. These usernames will have
- directory translation performed even if a global disable is
- in effect, but not if they also appear in a
- <code>disabled</code> clause.</li>
+ <li>Le nom d'un répertoire ou un modèle tel que ceux présentés
+ ci-dessous.</li>
+
+ <li>Le mot-clé <code>disabled</code>. <em>Toutes</em> les
+ traductions nom d'utilisateur vers répertoire sont alors
+ désactivées, à l'exception de celles comportant le mot-clé
+ <code>enabled</code> (voir ci-dessous).</li>
+
+ <li>Le mot-clé <code>disabled</code> suivi d'une liste de noms
+ d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
+ apparaissant dans une telle liste ne feront <em>jamais</em>
+ l'objet d'une traduction vers un répertoire, même dans le cas où
+ ils apparaîtront dans une clause <code>enabled</code>.</li>
+
+ <li>Le mot-clé <code>enabled</code> suivi d'une liste de noms
+ d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
+ apparaissant dans une telle liste seront traduits en répertoires
+ même dans le cas où une clause disable globale est active, mais
+ pas s'ils apparaissent aussi dans une clause
+ <code>disabled</code>.</li>
</ul>
- <p>If neither the <code>enabled</code> nor the
- <code>disabled</code> keywords appear in the
- <code class="directive">Userdir</code> directive, the argument is treated as a
- filename pattern, and is used to turn the name into a directory
- specification. A request for
- <code>http://www.example.com/~bob/one/two.html</code> will be
- translated to:</p>
+ <p>Si aucun mot-clé <code>enabled</code> ou <code>disabled</code>
+ n'apparait dans la directive <code class="directive">Userdir</code>, l'argument est
+ traité en tant que modèle de fichier, et utilisé pour traduire le
+ nom d'utilisateur en une spécification de répertoire. Une requête
+ pour <code>http://www.example.com/~bob/un/deux.html</code> sera
+ traduite en :</p>
<table>
- <tr><th>UserDir directive used</th>
- <th>Translated path</th></tr>
+ <tr><th>Directive Userdir utilisée</th>
+ <th>Chemin traduit</th></tr>
<tr><td>UserDir public_html</td>
- <td>~bob/public_html/one/two.html</td></tr>
+ <td>~bob/public_html/un/deux.html</td></tr>
<tr><td>UserDir /usr/web</td>
- <td>/usr/web/bob/one/two.html</td></tr>
+ <td>/usr/web/bob/un/deux.html</td></tr>
<tr><td>UserDir /home/*/www</td>
- <td>/home/bob/www/one/two.html</td></tr>
+ <td>/home/bob/www/un/deux.html</td></tr>
</table>
- <p>The following directives will send redirects to the client:</p>
+ <p>Les directives suivantes vont envoyer des redirections au client
+ :</p>
<table>
- <tr><th>UserDir directive used</th>
- <th>Translated path</th></tr>
- <tr><td>UserDir http://www.example.com/users</td>
- <td>http://www.example.com/users/bob/one/two.html</td></tr>
+ <tr><th>Directive Userdir utilisée</th>
+ <th>Chemin traduit</th></tr>
+ <tr><td>UserDir http://www.example.com/utilisateurs</td>
+ <td>http://www.example.com/utilisateurs/bob/un/deux.html</td></tr>
<tr><td>UserDir http://www.example.com/*/usr</td>
- <td>http://www.example.com/bob/usr/one/two.html</td></tr>
+ <td>http://www.example.com/bob/usr/un/deux.html</td></tr>
<tr><td>UserDir http://www.example.com/~*/</td>
- <td>http://www.example.com/~bob/one/two.html</td></tr>
+ <td>http://www.example.com/~bob/un/deux.html</td></tr>
</table>
<div class="note">
- <strong>Be careful when using this directive; for instance,
- <code>"UserDir ./"</code> would map <code>"/~root"</code> to
- <code>"/"</code> - which is probably undesirable. It is strongly
- recommended that your configuration include a "<code>UserDir
- disabled root</code>" declaration. See also the <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> directive and the <a href="../misc/security_tips.html">Security Tips</a> page for
- more information.</strong>
+ <strong>Soyez prudent avec cette directive ; par exemple,
+ <code>"UserDir ./"</code> ferait correspondre
+ <code>"/~root"</code> à <code>"/"</code> - ce qui n'est
+ probablement pas souhaité. Il est fortement recommandé d'inclure
+ une déclaration "<code>UserDir disabled root</code>" dans votre
+ configuration. Voir aussi la directive <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et la page <a href="../misc/security_tips.html">Conseils en matière de
+ sécurité</a> pour plus d'informations.</strong>
</div>
- <p>Additional examples:</p>
+ <p>Exemples supplémentaires :</p>
- <p>To allow a few users to have <code>UserDir</code> directories, but
- not anyone else, use the following:</p>
+ <p>Pour permettre à quelques utilisateurs et seulement à ceux-ci de
+ posséder des répertoires <code>UserDir</code>, utilisez la
+ configuration suivante :</p>
<pre class="prettyprint lang-config">UserDir disabled
UserDir enabled user1 user2 user3</pre>
- <p>To allow most users to have <code>UserDir</code> directories, but
- deny this to a few, use the following:</p>
+ <p>Pour permettre à la plupart des utilisateurs de posséder des
+ répertoires <code>UserDir</code>, mais l'interdire à quelques uns,
+ utilisez la configuration suivante :</p>
- <pre class="prettyprint lang-config">UserDir disabled user4 user5 user6</pre>
+ <pre class="prettyprint lang-config">UserDir disabled utilisateur4 utilisateur5 utilisateur6</pre>
- <p>It is also possible to specify alternative user directories.
- If you use a command like:</p>
+ <p>Il est aussi possible de spécifier des répertoires utilisateurs
+ alternatifs. Si vous utilisez une commande comme :</p>
<pre class="prettyprint lang-config">UserDir "public_html" "/usr/web" "http://www.example.com/"</pre>
- <p>With a request for
- <code>http://www.example.com/~bob/one/two.html</code>, will try to
- find the page at <code>~bob/public_html/one/two.html</code> first, then
- <code>/usr/web/bob/one/two.html</code>, and finally it will send a
- redirect to <code>http://www.example.com/bob/one/two.html</code>.</p>
+ <p>Avec une requête pour
+ <code>http://www.example.com/~bob/un/deux.html</code>, le serveur
+ tentera tout d'abord de trouver la page à
+ <code>~bob/public_html/un/deux.html</code>, puis à
+ <code>/usr/web/bob/un/deux.html</code>, et enfin il enverra une
+ redirection vers
+ <code>http://www.example.com/bob/un/deux.html</code>.</p>
- <p>If you add a redirect, it must be the last alternative in the list.
- Apache httpd cannot determine if the redirect succeeded or not, so if you have
- the redirect earlier in the list, that will always be the alternative
- that is used.</p>
+ <p>Si vous spécifiez une redirection, elle doit être la dernière
+ alternative de la liste. Apache httpd ne pouvant pas déterminer si la
+ redirection a réussi, si cette dernière ne se trouve pas en fin de
+ liste, c'est cette alternative qui sera toujours utilisée.</p>
- <p>User directory substitution is not active by default in versions
- 2.1.4 and later. In earlier versions, <code>UserDir public_html</code>
- was assumed if no <code class="directive">UserDir</code>
- directive was present.</p>
+ <p>La substitution de répertoire utilisateur n'est pas activée par
+ défaut depuis la version 2.1.4. Dans les versions précédentes,
+ <code>UserDir public_html</code> était sous-entendu si aucune
+ directive <code class="directive">UserDir</code>
+ n'était présente.</p>
- <div class="note"><h3>Merging details</h3>
- <p> Lists of specific enabled and disabled users are replaced, not merged,
- from global to virtual host scope</p></div>
+ <div class="note"><h3>Détails à propos de la fusion</h3>
+ <p>Lorsqu'on passe du contexte global au contexte de serveur
+ virtuel, les listes d'utilisateurs spécifiques activés ou désactivés
+ sont remplacées par les listes du contexte, et non fusionnées.</p></div>
<h3>Voir aussi</h3>
<ul>
<li>
- <a href="../howto/public_html.html">Per-user web directories tutorial</a>
+ <a href="../howto/public_html.html">Tutoriel sur les répertoires web
+ utilisateur</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="cookiedomain" id="cookiedomain">Directive</a> <a name="CookieDomain" id="CookieDomain">CookieDomain</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The domain to which the tracking cookie applies</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieDomain <em>domain</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le domaine auquel le cookie traceur
+s'applique</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieDomain <em>domaine</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_usertrack</td></tr>
</table>
- <p>This directive controls the setting of the domain to which
- the tracking cookie applies. If not present, no domain is
- included in the cookie header field.</p>
-
- <p>The domain string <strong>must</strong> begin with a dot, and
- <strong>must</strong> include at least one embedded dot. That is,
- <code>.example.com</code> is legal, but <code>www.example.com</code> and
- <code>.com</code> are not.</p>
-
- <div class="note">Most browsers in use today will not allow cookies to be set
- for a two-part top level domain, such as <code>.co.uk</code>,
- although such a domain ostensibly fulfills the requirements
- above.<br />
-
- These domains are equivalent to top level domains such as
- <code>.com</code>, and allowing such cookies may be a security
- risk. Thus, if you are under a two-part top level domain, you
- should still use your actual domain, as you would with any other top
- level domain (for example <code>.example.co.uk</code>).
+ <p>Cette directive permet de définir le domaine auquel le cookie
+ traceur s'applique. Si elle n'est pas présente, aucun domaine n'est
+ inclus dans le champ d'en-tête cookie.</p>
+
+ <p>La chaîne dommaine <strong>doit</strong> commencer par un point,
+ et <strong>doit</strong> comporter au moins un point entouré
+ d'autres caractères. Par exemple, <code>.example.com</code> est
+ une chaîne valide, mais <code>www.example.com</code> et
+ <code>.com</code> ne le sont pas.</p>
+
+ <div class="note">La plupart des navigateurs utilisés actuellement n'autorisent
+ pas la définition de cookies pour un domaine racine de deux niveaux,
+ tel que <code>.co.uk</code>, bien qu'un tel domaine remplisse les
+ conditions de validité décrites ci-dessus.<br />
+
+ Ces domaines sont équivalents à des domaines racines comme
+ <code>.com</code>, et autoriser de tels cookies peut constituer un
+ risque en matière de sécurité. Ainsi, si vous vous situez sous un
+ domaine racine de deux niveaux, vous devez encore utiliser votre
+ domaine véritable, comme vous le feriez avec tout autre domaine
+ racine (par exemple <code>.example.co.uk</code>).
</div>
<pre class="prettyprint lang-config">CookieDomain .example.com</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cookieexpires" id="cookieexpires">Directive</a> <a name="CookieExpires" id="CookieExpires">CookieExpires</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Expiry time for the tracking cookie</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieExpires <em>expiry-period</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée avant expiration du cookie traceur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieExpires <em>durée</em></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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_usertrack</td></tr>
</table>
- <p>When used, this directive sets an expiry time on the cookie
- generated by the usertrack module. The <em>expiry-period</em>
- can be given either as a number of seconds, or in the format
- such as "2 weeks 3 days 7 hours". Valid denominations are:
- years, months, weeks, days, hours, minutes and seconds. If the expiry
- time is in any format other than one number indicating the
- number of seconds, it must be enclosed by double quotes.</p>
-
- <p>If this directive is not used, cookies last only for the
- current browser session.</p>
+ <p>Lorsqu'elle est utilisée, cette directive définit une durée avant
+ l'expiration du cookie généré par le module usertrack. La
+ <em>durée</em> peut être spécifiée sous la forme d'un nombre de
+ secondes, ou sous une forme du
+ style "2 weeks 3 days 7 hours". les termes valides sont : years,
+ months, weeks, days, hours, minutes et seconds. Si la durée est
+ spécifiée dans un format autre qu'un nombre de secondes, elle doit
+ être entourée de guillemets.</p>
+
+ <p>Si cette directive est absente, la durée de vie des cookies est
+ limitée à la session actuelle du navigateur.</p>
<pre class="prettyprint lang-config">CookieExpires "3 weeks"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cookiename" id="cookiename">Directive</a> <a name="CookieName" id="CookieName">CookieName</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the tracking cookie</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieName <em>token</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du cookie traceur</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieName <em>symbole</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CookieName Apache</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_usertrack</td></tr>
</table>
- <p>This directive allows you to change the name of the cookie
- this module uses for its tracking purposes. By default the
- cookie is named "<code>Apache</code>".</p>
+ <p>Cette directive vous permet de modifier le nom du cookie que ce
+ module utilise pour sa journalisation. Le nom par défaut du cookie
+ est "<code>Apache</code>".</p>
- <p>You must specify a valid cookie name; results are
- unpredictable if you use a name containing unusual characters.
- Valid characters include A-Z, a-z, 0-9, "_", and "-".</p>
+ <p>Vous devez spécifier un nom de cookie valide ; les résultats sont
+ imprévisibles si vous utilisez un nom contenant des caractères
+ inhabituels. Les caractères valides font partie des intervales A-Z,
+ a-z, 0-9, "_", et "-".</p>
<pre class="prettyprint lang-config">CookieName clicktrack</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cookiestyle" id="cookiestyle">Directive</a> <a name="CookieStyle" id="CookieStyle">CookieStyle</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format of the cookie header field</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Format du champ d'en-tête cookie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieStyle
<em>Netscape|Cookie|Cookie2|RFC2109|RFC2965</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CookieStyle Netscape</code></td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_usertrack</td></tr>
</table>
- <p>This directive controls the format of the cookie header
- field. The three formats allowed are:</p>
+ <p>Cette directive permet de contrôler le format du champ d'en-tête
+ cookie. Les trois formats autorisés sont :</p>
<ul>
- <li><strong>Netscape</strong>, which is the original but now deprecated
- syntax. This is the default, and the syntax Apache has
- historically used.</li>
+ <li><strong>Netscape</strong> : il s'agit du format original, mais
+ est maintenant obsolète. C'est le format par défaut et il
+ correspond à la syntaxe historique utilisée par Apache.</li>
- <li><strong>Cookie</strong> or <strong>RFC2109</strong>, which is the syntax that
- superseded the Netscape syntax.</li>
+ <li><strong>Cookie</strong> ou <strong>RFC2109</strong> : c'est la
+ syntaxe qui remplace la syntaxe Netscape.</li>
- <li><strong>Cookie2</strong> or <strong>RFC2965</strong>, which is the most
- current cookie syntax.</li>
+ <li><strong>Cookie2</strong> ou <strong>RFC2965</strong> : c'est
+ la syntaxe de cookie la plus actuelle.</li>
</ul>
- <p>Not all clients can understand all of these formats, but you
- should use the newest one that is generally acceptable to your
- users' browsers. At the time of writing, most browsers support all
- three of these formats, with <code>Cookie2</code> being the
- preferred format.</p>
+ <p>Tous les clients ne supportent pas l'ensemble de ces formats,
+ mais il est conseillé d'utiliser le plus récent qui sera en général
+ supporté par le navigateur de votre utilisateur. A l'heure où ce
+ document est écrit, la plupart des navigateurs supportent ces trois
+ formats, <code>Cookie2</code> étant le format recommandé.</p>
<pre class="prettyprint lang-config">CookieStyle Cookie2</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="cookietracking" id="cookietracking">Directive</a> <a name="CookieTracking" id="CookieTracking">CookieTracking</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables tracking cookie</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le cookie traceur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CookieTracking on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CookieTracking 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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_usertrack</td></tr>
</table>
- <p>When <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> is loaded, and
- <code>CookieTracking on</code> is set, Apache will send a
- user-tracking cookie for all new requests. This directive can
- be used to turn this behavior on or off on a per-server or
- per-directory basis. By default, enabling
- <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> will <strong>not</strong>
- activate cookies. </p>
+ <p>Lorsque le module <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> est chargé, et
+ si <code>CookieTracking on</code> est définie, Apache enverra un
+ cookie traceur pour toute nouvelle requête. Cette directive peut
+ être utilisée pour activer ou désactiver ce comportement pour un
+ serveur virtuel ou un répertoire. Par défaut, l'activation de
+ <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> ne suffit <strong>pas</strong> pour
+ activer les cookies.</p>
<pre class="prettyprint lang-config">CookieTracking on</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="virtualdocumentroot" id="virtualdocumentroot">Directive</a> <a name="VirtualDocumentRoot" id="VirtualDocumentRoot">VirtualDocumentRoot</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the document root
-for a given virtual host</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualDocumentRoot <em>interpolated-directory</em>|none</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet une configuration dynamique de la racine des
+documents d'un serveur virtuel donné</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualDocumentRoot <em>répertoire-interpolé</em>|none</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VirtualDocumentRoot none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_vhost_alias</td></tr>
</table>
- <p>The <code class="directive">VirtualDocumentRoot</code> directive allows you to
- determine where Apache HTTP Server will find your documents based on the
- value of the server name. The result of expanding
- <em>interpolated-directory</em> is used as the root of the
- document tree in a similar manner to the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directive's argument.
- If <em>interpolated-directory</em> is <code>none</code> then
- <code class="directive">VirtualDocumentRoot</code> is turned off. This directive
- cannot be used in the same context as <code class="directive"><a href="#virtualdocumentrootip">VirtualDocumentRootIP</a></code>.</p>
+ <p>La directive <code class="directive">VirtualDocumentRoot</code> vous
+ permet de spécifier où le serveur HTTP Apache pourra trouver vos
+ documents en se basant
+ sur le nom du serveur. Le résultat de l'expansion du
+ <em>répertoire-interpolé</em> est utilisé comme racine de
+ l'arborescence des documents d'une manière similaire à l'argument de
+ la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Si
+ <em>répertoire-interpolé</em> a pour valeur <code>none</code>, la
+ directive <code class="directive">VirtualDocumentRoot</code> est désactivée.
+ Cette directive ne peut pas être utilisée dans le même contexte que
+ la directive <code class="directive"><a href="#virtualdocumentrootip">VirtualDocumentRootIP</a></code>.</p>
<div class="warning"><h3>Note</h3>
-<code class="directive">VirtualDocumentRoot</code> will override any <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directives you may have put in the same
-context or child contexts. Putting a <code class="directive">VirtualDocumentRoot</code>
-in the global server scope will effectively override <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directives in any virtual hosts defined later
-on, unless you set <code class="directive">VirtualDocumentRoot</code> to <code>None</code>
-in each virtual host.
-</div>
+La directive <code class="directive">VirtualDocumentRoot</code> l'emporte sur
+toute directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
+définie dans le même contexte ou dans des contextes enfants. Le fait de
+définir une directive <code class="directive">VirtualDocumentRoot</code> dans le
+contexte du serveur principal va effectivement l'emporter sur toute
+directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> définie dans
+un serveur virtuel quelconque, si vous n'avez pas défini
+<code class="directive">VirtualDocumentRoot</code> à <code>None</code> dans ce
+serveur virtuel.
+</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="virtualdocumentrootip" id="virtualdocumentrootip">Directive</a> <a name="VirtualDocumentRootIP" id="VirtualDocumentRootIP">VirtualDocumentRootIP</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the document root
-for a given virtual host</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualDocumentRootIP <em>interpolated-directory</em>|none</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration dynamique de la racine des documents pour un
+serveur virtuel donné</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualDocumentRootIP <em>répertoire-interpolé</em>|none</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VirtualDocumentRootIP none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_vhost_alias</td></tr>
</table>
-<p>The <code class="directive">VirtualDocumentRootIP</code> directive is like the
- <code class="directive"><a href="#virtualdocumentroot">VirtualDocumentRoot</a></code>
- directive, except that it uses the IP address of the server end
- of the connection for directory interpolation instead of the server
- name.</p>
+<p>La directive <code class="directive">VirtualDocumentRootIP</code> est
+identique à la directive <code class="directive"><a href="#virtualdocumentroot">VirtualDocumentRoot</a></code> à l'exception
+près qu'elle utilise l'adresse IP du serveur virtuel pour
+l'interpolation du répertoire à la place du nom du serveur.</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="virtualscriptalias" id="virtualscriptalias">Directive</a> <a name="VirtualScriptAlias" id="VirtualScriptAlias">VirtualScriptAlias</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the CGI directory for
-a given virtual host</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualScriptAlias <em>interpolated-directory</em>|none</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration dynamique du répertoire des scripts CGI pour
+un serveur virtuel donné</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualScriptAlias <em>répertoire-interpolé</em>|none</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VirtualScriptAlias none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_vhost_alias</td></tr>
</table>
- <p>The <code class="directive">VirtualScriptAlias</code> directive allows you to
- determine where Apache httpd will find CGI scripts in a similar
- manner to <code class="directive"><a href="#virtualdocumentroot">VirtualDocumentRoot</a></code> does for other documents. It matches
- requests for URIs starting <code>/cgi-bin/</code>, much like <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
- <code>/cgi-bin/</code> would.</p>
+ <p>La directive <code class="directive">VirtualScriptAlias</code> vous
+ permet de spécifier où Apache httpd pourra trouver les scripts CGI selon une
+ méthode similaire à celle qu'utilise la directive <code class="directive"><a href="#virtualdocumentroot">VirtualDocumentRoot</a></code> pour les
+ autres documents. Elle recherche des requêtes dont l'URI commence
+ par <code>/cgi-bin/</code>, comme le ferait la directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</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="virtualscriptaliasip" id="virtualscriptaliasip">Directive</a> <a name="VirtualScriptAliasIP" id="VirtualScriptAliasIP">VirtualScriptAliasIP</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dynamically configure the location of the CGI directory for
-a given virtual host</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualScriptAliasIP <em>interpolated-directory</em>|none</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration dynamique du répertoire des scripts CGI pour
+un serveur virtuel donné</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>VirtualScriptAliasIP <em>répertoire-interpolé</em>|none</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>VirtualScriptAliasIP none</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>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_vhost_alias</td></tr>
</table>
- <p>The <code class="directive">VirtualScriptAliasIP</code> directive is like the
- <code class="directive"><a href="#virtualscriptalias">VirtualScriptAlias</a></code>
- directive, except that it uses the IP address of the server end
- of the connection for directory interpolation instead of the server
- name.</p>
+ <p>La directive <code class="directive">VirtualScriptAliasIP</code> est
+ identique à la directive <code class="directive"><a href="#virtualscriptalias">VirtualScriptAlias</a></code> à
+ l'exception près qu'elle utilise l'adresse IP du serveur virtuel
+ pour l'interpolation du répertoire à la place du nom du serveur.</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="coredumpdirectory" id="coredumpdirectory">Directive</a> <a name="CoreDumpDirectory" id="CoreDumpDirectory">CoreDumpDirectory</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directory where Apache HTTP Server attempts to
-switch before dumping core</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CoreDumpDirectory <var>directory</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for the default setting</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le répertoire dans lequel le serveur HTTP Apache va tenter de se
+positionner avant d'effectuer un vidage mémoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CoreDumpDirectory <var>répertoire</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour le répertoire par défaut</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
</table>
- <p>This controls the directory to which Apache httpd attempts to
- switch before dumping core. If your operating system is configured to
- create core files in the working directory of the crashing process,
- <code class="directive">CoreDumpDirectory</code> is necessary to change working
- directory from the default <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
- directory, which should not be writable by the user the server runs as.</p>
-
- <p>If you want a core dump for debugging, you can use this directive to
- place it in a different location. This directive has no effect if your
- operating system is not configured to write core files to the working directory
- of the crashing processes.</p>
-
- <div class="note"><h3>Core Dumps on Linux</h3>
- <p>If Apache httpd starts as root and switches to another user, the
- Linux kernel <em>disables</em> core dumps even if the directory is
- writable for the process. Apache httpd (2.0.46 and later) reenables core dumps
- on Linux 2.4 and beyond, but only if you explicitly configure a <code class="directive">CoreDumpDirectory</code>.</p>
+ <p>Cette directive permet de définir le répertoire dans lequel
+ Apache httpd va tenter de se positionner avant d'effectuer un vidage
+ mémoire sur disque.
+ Si votre système d'exploitation est configuré pour créer des
+ fichiers de vidage mémoire dans le répertoire de travail des
+ processus qui se sont crashés,
+ <code class="directive">CoreDumpDirectory</code> est nécessaire pour
+ définir un répertoire de travail autre que le répertoire par défaut
+ <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, ce répertoire de
+ travail ne devant pas être accessible en écriture par l'utilisateur sous
+ lequel le serveur s'exécute.</p>
+
+ <p>Si vous avez besoin d'un vidage mémoire pour le débogage, vous
+ pouvez utiliser cette directive pour le placer à un endroit
+ différent. Cette directive n'a aucun effet si votre système
+ d'exploitation n'est pas configuré pour créer des
+ fichiers de vidage mémoire dans le répertoire de travail des
+ processus qui se sont crashés.</p>
+
+ <div class="note"><h3>Vidages mémoire sous Linux</h3>
+ <p>Si Apache httpd est démarré sous l'utilisateur root puis bascule vers
+ un autre utilisateur, le noyau Linux <em>désactive</em> les
+ vidages mémoire, même si le répertoire est accessible en écriture au
+ processus. Apache httpd (versions 2.0.46 et supérieures) réactive les
+ vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous
+ définissez une directive <code class="directive">CoreDumpDirectory</code>.</p>
</div>
<div class="note">
- <h3>Core Dumps on BSD</h3>
- <p>To enable core-dumping of suid-executables on BSD-systems (such
- as FreeBSD), set <code>kern.sugid_coredump</code> to 1.
+ <h3>Vidages mémoire sous BSD</h3>
+ <p>Pour activer le vidage mémoire des exécutables suid sur les
+ systèmes de style BSD (comme FreeBSD), définissez
+ <code>kern.sugid_coredump</code> à 1.
</p>
</div>
- <div class="note"><h3>Specific signals</h3>
- <p><code class="directive">CoreDumpDirectory</code> processing only occurs for
- a select set of fatal signals: SIGFPE, SIGILL, SIGABORT,
- SIGSEGV, and SIGBUS.</p>
- <p>On some operating systems, SIGQUIT also results in a core dump but
- does not go through <code class="directive">CoreDumpDirectory</code> or
- <code class="directive">EnableExceptionHook</code> processing, so the core
- location is dictated entirely by the operating system.</p>
+ <div class="note"><h3>Signaux spécifiques</h3>
+ <p><code class="directive">CoreDumpDirectory</code> n'est traité qu'à la
+ reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT,
+ SIGSEGV, et SIGBUS.</p>
+ <p>
+ Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un
+ vidage mémoire, mais n'est pas traité par les directives
+ <code class="directive">CoreDumpDirectory</code> ou
+ <code class="directive">EnableExceptionHook</code>, si bien que la
+ définition du répertoire d'enregistrement du vidage mémoire est
+ entièrement dévolue au système d'exploitation.</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="enableexceptionhook" id="enableexceptionhook">Directive</a> <a name="EnableExceptionHook" id="EnableExceptionHook">EnableExceptionHook</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enables a hook that runs exception handlers
-after a crash</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un hook ("point d'accrochage logiciel") qui exécute des
+gestionnaires d'exception après un crash</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableExceptionHook On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableExceptionHook 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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
</table>
- <p>For safety reasons this directive is only available if the server was
- configured with the <code>--enable-exception-hook</code> option. It
- enables a hook that allows external modules to plug in and do something
- after a child crashed.</p>
-
- <p>There are already two modules, <code>mod_whatkilledus</code> and
- <code>mod_backtrace</code> that make use of this hook. Please have a
- look at Jeff Trawick's <a href="https://emptyhammock.com/projects/httpd/diag/">EnableExceptionHook site</a> for more information about these.</p>
+ <p>Pour des raisons de sécurité, cette directive n'est disponible
+ que si la compilation du serveur a été configurée avec l'option
+ <code>--enable-exception-hook</code>. Elle permet d'activer un hook
+ ("point d'accrochage logiciel")
+ qui autorise certains modules externes à effectuer un branchement et
+ accomplir telle ou telle action après le crash d'un processus
+ enfant.</p>
+
+ <p>Deux modules, <code>mod_whatkilledus</code> et
+ <code>mod_backtrace</code> utilisent ce hook. Veuillez vous
+ référer à la <a href="https://emptyhammock.com/projects/httpd/diag/">page EnableExceptionHook</a> de Jeff Trawick pour plus
+ d'informations à leur sujet.</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="gracefulshutdowntimeout" id="gracefulshutdowntimeout">Directive</a> <a name="GracefulShutdownTimeout" id="GracefulShutdownTimeout">GracefulShutdownTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify a timeout after which a gracefully shutdown server
-will exit.</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le délai maximum après lequel le serveur va
+s'arrêter dans le cas d'un arrêt "en douceur"</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GracefulShutdownTimeout <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>GracefulShutdownTimeout 0</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
</table>
- <p>The <code class="directive">GracefulShutdownTimeout</code> specifies
- how many seconds after receiving a "graceful-stop" signal, a
- server should continue to run, handling the existing connections.</p>
+ <p>La directive <code class="directive">GracefulShutdownTimeout</code>
+ permet de spécifier le temps, en secondes, pendant lequel le serveur
+ va continuer à fonctionner après avoir reçu un signal
+ "graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement
+ des connexions en cours.</p>
- <p>Setting this value to zero means that the server will wait
- indefinitely until all remaining requests have been fully served.</p>
+ <p>Définir cette valeur à zéro signifie au serveur d'attendre
+ jusqu'à ce que toutes les requêtes en cours aient été traité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="listen" id="listen">Directive</a> <a name="Listen" id="Listen">Listen</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>IP addresses and ports that the server
-listens to</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Listen [<var>IP-address</var>:]<var>portnumber</var> [<var>protocol</var>]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les adresses IP et ports sur lesquels le serveur écoute</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Listen [<var>adresse IP</var>:]<var>numéro port</var>
+[<var>protocole</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The <code class="directive">Listen</code> directive instructs Apache httpd to
- listen to only specific IP addresses or ports; by default it
- responds to requests on all IP interfaces. <code class="directive">Listen</code>
- is now a required directive. If it is not in the config file, the
- server will fail to start. This is a change from previous versions
- of Apache httpd.</p>
-
- <p>The <code class="directive">Listen</code> directive tells the server to
- accept incoming requests on the specified port or address-and-port
- combination. If only a port number is specified, the server listens to
- the given port on all interfaces. If an IP address is given as well
- as a port, the server will listen on the given port and
- interface.</p>
-
- <p>Multiple <code class="directive">Listen</code> directives may be used to
- specify a number of addresses and ports to listen to. The server will
- respond to requests from any of the listed addresses and ports.</p>
-
- <p>For example, to make the server accept connections on both
- port 80 and port 8000, use:</p>
+ <p>La directive <code class="directive">Listen</code> permet de signifier à
+ Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par
+ défaut, le serveur répond aux requêtes en provenance de toutes les
+ interfaces réseau. La directive <code class="directive">Listen</code> est
+ dorénavant requise, et si elle est absente du fichier de
+ configuration, le serveur refusera de démarrer. Ceci constitue un
+ changement par rapport aux versions précédentes d'Apache httpd.</p>
+
+ <p>La directive <code class="directive">Listen</code> signifie au serveur de
+ n'accepter les requêtes entrantes que vers le port ou le couple
+ adresse-port spécifié. Si seulement un port est spécifié, le serveur
+ se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP
+ et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur
+ l'interface réseau correspondant à l'adresse IP.</p>
+
+ <p>On peut utiliser autant de directives
+ <code class="directive">Listen</code> que nécessaire pour spécifier
+ plusieurs adresses et/ou ports à écouter. Le serveur répondra aux
+ requêtes vers tous les adresses et ports spécifiés.</p>
+
+ <p>Par exemple, pour que le serveur accepte les connexions sur les
+ ports 80 et 8000, utilisez :</p>
<pre class="prettyprint lang-config">Listen 80
Listen 8000</pre>
- <p>To make the server accept connections on two specified
- interfaces and port numbers, use </p>
+ <p>Pour que le serveur accepte les connexions sur deux interfaces et
+ ports particuliers, spécifiez :</p>
<pre class="prettyprint lang-config">Listen 192.170.2.1:80
Listen 192.170.2.5:8000</pre>
- <p>IPv6 addresses must be surrounded in square brackets, as in the
- following example:</p>
+ <p>Les adressee IPv6 doivent être entourées de crochets, comme dans
+ l'exemple suivant :</p>
<pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre>
- <p>The optional <var>protocol</var> argument is not required for most
- configurations. If not specified, <code>https</code> is the default for
- port 443 and <code>http</code> the default for all other ports. The
- protocol is used to determine which module should handle a request, and
- to apply protocol specific optimizations with the
- <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> directive.</p>
+ <p>L'argument optionnel <var>protocole</var> n'est pas nécessaire
+ dans la plupart des configurations. S'il est absent,
+ <code>https</code> est la valeur par défaut pour le port 443 et
+ <code>http</code> l'est pour tous les autres ports. L'argument
+ protocole sert à déterminer quel module doit traiter une requête, et
+ à appliquer des optimisations spécifiques à certains protocoles à
+ l'aide de la directive <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code>.</p>
- <p>You only need to set the protocol if you are running on non-standard
- ports. For example, running an <code>https</code> site on port 8443:</p>
+ <p>La spécification d'un protocole n'est nécessaire que si vous
+ utilisez des ports non standards. Par exemple, pour configurer un
+ site en <code>https</code> sur le port 8443 :</p>
<pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre>
- <div class="note"><h3>Error condition</h3>
- Multiple <code class="directive">Listen</code> directives for the same ip
- address and port will result in an <code>Address already in use</code>
- error message.
+ <div class="note"><h3>Condition d'erreur</h3>
+ Plusieurs directives <code class="directive">Listen</code> pour les mêmes
+ adresse IP/port vont provoquer l'envoi d'un message d'erreur
+ <code>Address already in use</code>.
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../dns-caveats.html">DNS Issues</a></li>
-<li><a href="../bind.html">Setting which addresses and ports Apache HTTP Server
- uses</a></li>
-<li><a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Further
-discussion of the <code>Address already in use</code> error message,
-including other causes.</a></li>
+<li><a href="../dns-caveats.html">Problèmes avec DNS</a></li>
+<li><a href="../bind.html">Définition des adresses et ports
+qu'utilise le serveur HTTP Apache</a></li>
+<li><a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Autre
+discussion à propos du message d'erreur <code>Address already in
+use</code>, citant d'autres causes possibles.</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="listenbacklog" id="listenbacklog">Directive</a> <a name="ListenBackLog" id="ListenBackLog">ListenBackLog</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum length of the queue of pending connections</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Longueur maximale de la liste d'attente des
+connexions</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ListenBacklog <var>backlog</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ListenBacklog 511</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The maximum length of the queue of pending connections.
- Generally no tuning is needed or desired, however on some
- systems it is desirable to increase this when under a TCP SYN
- flood attack. See the backlog parameter to the
- <code>listen(2)</code> system call.</p>
-
- <p>This will often be limited to a smaller number by the
- operating system. This varies from OS to OS. Also note that
- many OSes do not use exactly what is specified as the backlog,
- but use a number based on (but normally larger than) what is
- set.</p>
+ <p>La longueur maximale de la liste d'attente des connexions. En
+ général, aucune modification n'est nécessaire, ni même souhaitable ;
+ cependant, sur certains systèmes, il peut être nécessaire
+ d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en
+ masse de requêtes SYN pour saturer le serveur). Voir le paramètre
+ backlog de l'appel système <code>listen(2)</code>.</p>
+
+ <p>En fait, l'argument backlog sera souvent limité à une valeur
+ inférieure en fonction du système d'exploitation. Notez aussi que de
+ nombreux systèmes d'exploitation ne tiennent pas vraiment compte de
+ la valeur spécifiée pour l'argument backlog, mais s'en inspirent
+ seulement (et choisissent en général une valeur supérieure).</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="listencoresbucketsratio" id="listencoresbucketsratio">Directive</a> <a name="ListenCoresBucketsRatio" id="ListenCoresBucketsRatio">ListenCoresBucketsRatio</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ratio between the number of CPU cores (online) and the number of
-listeners' buckets</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Rapport entre le nombre de coeurs de processeur activés et
+le nombre de segments d'écoute</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ListenCoresBucketsRatio <var>ratio</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ListenCoresBucketsRatio 0 (disabled)</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available in Apache HTTP Server 2.4.17, with a kernel supporting
-the socket option <code>SO_REUSEPORT</code> and distributing new connections
-evenly across listening processes' (or threads') sockets using it (eg. Linux
-3.9 and later, but not the current implementations of <code>SO_REUSEPORT</code>
-in *BSDs.</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, avec un noyau supportant l'option de socket
+<code>SO_REUSEPORT</code>, et distribuant uniformément les nouvelles
+connexions aux sockets d'écoute des processus (ou threads) qui
+l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas
+l'implémentation courante de <code>SO_REUSEPORT</code> par les
+plateformes de type BSD.</td></tr>
</table>
- <p>A <var>ratio</var> between the number of (online) CPU cores and the
- number of listeners' buckets can be used to make Apache HTTP Server create
- <code>num_cpu_cores / ratio</code> listening buckets, each containing its
- own <code class="directive">Listen</code>-ing socket(s) on the same port(s), and
- then make each child handle a single bucket (with round-robin distribution
- of the buckets at children creation time).</p>
-
- <div class="note"><h3>Meaning of "online" CPU core</h3>
- <p>On Linux (and also BSD) a CPU core can be turned on/off if
- <a href="https://www.kernel.org/doc/Documentation/cpu-hotplug.txt">Hotplug</a>
- is configured, therefore <code class="directive">ListenCoresBucketsRatio</code> needs to
- take this parameter into account while calculating the number of buckets to create.</p>
+ <p>Vous pouvez utiliser la directive
+ <code class="directive">ListenCoresBucketsRatio</code> pour spécifier un
+ <var>ratio</var> entre le nombre de coeurs de CPU activés et le
+ nombre de segments d'écoute (listeners' buckets) souhaités ; le
+ serveur HTTP Apache va alors créer<code>num_cpu_cores / ratio</code>
+ segments d'écoute, chacun contenant son propre socket d'écoute
+ <code class="directive">Listen</code> sur le ou les mêmes ports ; chaque
+ processus enfant sera associé à un seul segment d'écoute (avec une
+ distribution de type round-robin des segments à la création des
+ processus enfants).</p>
+
+ <div class="note"><h3>Définition du terme coeur de CPU activé ("online")</h3>
+ <p>Sous Linux et BSD, un coeur de CPU peut être activé ou désactivé si <a href="https://www.kernel.org/doc/Documentation/cpu-hotplug.txt">Hotplug</a>
+ a été configuré ; la directive
+ <code class="directive">ListenCoresBucketsRatio</code> doit donc tenir compte de ce
+ paramètre pour calculer le nombre de segments d'écoute à créer.</p>
</div>
- <p><code class="directive">ListenCoresBucketsRatio</code> can improve the
- scalability when accepting new connections is/becomes the bottleneck.
- On systems with a large number of CPU cores, enabling this feature has
- been tested to show significant performances improvement and shorter
- responses time.</p>
-
- <p>There must be at least twice the number of CPU cores than the
- configured <var>ratio</var> for this to be active. The recommended
- <var>ratio</var> is <code>8</code>, hence at least <code>16</code>
- cores should be available at runtime when this value is used.
- The right <var>ratio</var> to obtain maximum performance needs to be calculated
- for each target system, testing multiple values and observing the variations in your
- key performance metrics.</p>
-
- <p>This directive influences the calculation of the
- <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code> and
- <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code> lower bound values.
- The number of children processes needs to be a multiple of the number
- of buckets to optimally accept connections.</p>
+ <p>La directive <code class="directive">ListenCoresBucketsRatio</code> peut
+ améliorer le support de la montée en charge lorsque l'arrivée de
+ nouvelles connexions est/devient un goulot d'étranglement. Le test
+ de cette fonctionnalité avec des machines possédant un nombre de
+ coeurs de CPU important a permit de constater une amélioration des
+ performances significative et des temps de réponse plus courts.</p>
+
+ <p>Pour que cette fonctionnalité soit activée, le nombre de coeurs
+ de CPU doit être égal au moins au double du <var>ratio</var>
+ spécifié. Si vous spécifiez la valeur recommandée pour
+ <var>ratio</var>, à savoir <code>8</code>, le nombre minimum de
+ coeurs de processeurs disponibles sera alors de <code>16</code>. La valeur
+ optimale de <var>ratio</var> permettant d'obtenir des performances maximales
+ doit être calculée pour chaque système cible, en testant plusieurs valeurs
+ et en observant les résultats.</p>
+
+ <p>Cette directive influence le calcul des valeurs limites inférieures de
+ <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code> et <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>. En effet, pour accepter les
+ connexions de manière optimale, le nombre de processus enfants doit être un
+ multiple du nombre de segments d'écoute.</p>
<div class="note">
- <h3>Multiple <code class="directive">Listen</code>ers or Apache HTTP servers on
- the same IP address and port</h3>
- <p>Setting the <code>SO_REUSEPORT</code> option on the listening socket(s)
- consequently allows multiple processes (sharing the same <code>EUID</code>,
- e.g. <code>root</code>) to bind to the the same IP address and port,
- without the binding error raised by the system in the usual case.</p>
- <p>This also means that multiple instances of Apache httpd configured on a
- same <code>IP:port</code> and with a positive <code class="directive">ListenCoresBucketsRatio</code>
- would start without an error too, and then run with incoming connections
- evenly distributed accross both instances (this is NOT a recommendation or
- a sensible usage in any case, but just a notice that it would prevent such
- possible issues to be detected).</p>
- <p>Within the same instance, Apache httpd will check and fail to start if
- multiple <code class="directive">Listen</code> directives on the exact same IP (or
- hostname) and port are configured, thus avoiding the creation of some
- duplicated buckets which would be useless and kill performances. However
- it can't (and won't try harder to) catch all the possible overlapping cases
- (like a hostname resolving to an IP used elsewhere).</p>
+ <h3>Cas où plusieurs <code class="directive">Listen</code>ers ou serveurs HTTP
+ Apache partagent la même adresse IP et port</h3>
+ <p>La définition de l'option <code>SO_REUSEPORT</code> pour les sockets
+ d'écoute permet à plusieurs processus (partageant le même <code>EUID</code>,
+ par exemple <code>root</code>) de se rattacher à la même adresse IP et port,
+ sans obtenir l'erreur de rattachement que le système génère habituellement
+ lorsque ce cas se produit.</p>
+ <p>Cela signifie aussi que plusieurs instances d'Apache httpd configurées
+ avec le même <code>IP:port</code> et avec une valeur
+ <code class="directive">ListenCoresBucketsRatio</code> positive pourraient démarrer
+ sans erreur, et fonctionner ensuite avec une répartition uniforme des
+ connexions entrantes sur ces différentes instances (ce n'est PAS une
+ recommandation et ne constitue pas un usage approprié à tous les cas, mais
+ juste un avertissement sur le fait qu'un véritable problème de rattachement
+ multiple à un <code>IP:port</code> pourrait alors être occulté).</p>
+ <p>Au sein d'une même instance, Apache httpd vérifie la présence de
+ directives <code class="directive">Listen</code> multiples avec la même adresse IP
+ (ou nom d'hôte) et le même port, et refuse de démarrer si c'est le cas, ce
+ qui permet d'éviter la création de segments d'écoute dupliqués qui seraient
+ du coup inutiles et affecteraient les performances. Cependant, il ne peut
+ pas (et n'essaiera pas de le faire) intercepter tous les cas possibles de
+ recouvrement (comme un nom d'hôte correspondant à une adresse IP utilisée
+ quelque part ailleurs).</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="maxconnectionsperchild" id="maxconnectionsperchild">Directive</a> <a name="MaxConnectionsPerChild" id="MaxConnectionsPerChild">MaxConnectionsPerChild</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limit on the number of connections that an individual child server
-will handle during its life</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de connexions qu'un processus enfant va
+traiter au cours de son fonctionnement</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxConnectionsPerChild <var>number</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxConnectionsPerChild 0</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Available Apache HTTP Server 2.3.9 and later. The old name
-<code>MaxRequestsPerChild</code> is still supported.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 du serveur HTTP
+Apache. L'ancien nom <code>MaxRequestsPerChild</code> est encore
+supporté.</td></tr>
</table>
- <p>The <code class="directive">MaxConnectionsPerChild</code> directive sets
- the limit on the number of connections that an individual child
- server process will handle. After
- <code class="directive">MaxConnectionsPerChild</code> connections, the child
- process will die. If <code class="directive">MaxConnectionsPerChild</code> is
- <code>0</code>, then the process will never expire.</p>
+ <p>La directive <code class="directive">MaxConnectionsPerChild</code> permet de
+ définir le nombre maximum de connexions qu'un processus enfant va
+ pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
+ <code class="directive">MaxConnectionsPerChild</code> connexions, le processus
+ enfant est arrêté. Si <code class="directive">MaxConnectionsPerChild</code> est
+ définie à <code>0</code>, il n'y a plus aucune limite sur le nombre
+ de connexions que le processus pourra traiter.</p>
+
+ <p>Définir <code class="directive">MaxConnectionsPerChild</code> à une valeur
+ non nulle limite la quantité de mémoire qu'un processus peut
+ consommer à cause de fuites (accidentelles) de mémoire.</p>
- <p>Setting <code class="directive">MaxConnectionsPerChild</code> to a
- non-zero value limits the amount of memory that process can consume
- by (accidental) memory leakage.</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="maxmemfree" id="maxmemfree">Directive</a> <a name="MaxMemFree" id="MaxMemFree">MaxMemFree</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum amount of memory that the main allocator is allowed
-to hold without calling <code>free()</code></td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxMemFree <var>KBytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Quantité maximale de mémoire que l'allocateur principal est
+autorisé à conserver sans appeler <code>free()</code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxMemFree <var>KOctets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxMemFree 2048</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code></td></tr>
</table>
- <p>The <code class="directive">MaxMemFree</code> directive sets the
- maximum number of free Kbytes that every allocator is allowed
- to hold without calling <code>free()</code>. In threaded MPMs, every
- thread has its own allocator. When set
- to zero, the threshold will be set to unlimited.</p>
+ <p>La directive <code class="directive">MaxMemFree</code> permet de définir
+ le nombre maximum de KOctets libres que tout allocateur est
+ autorisé à conserver sans appeler <code>free()</code>. Dans les MPMs
+ threadés, chaque thread possède son propre allocateur. Si elle est
+ définie à 0, la quantité de mémoire libre que peut conserver un
+ allocateur est illimité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="maxrequestworkers" id="maxrequestworkers">Directive</a> <a name="MaxRequestWorkers" id="MaxRequestWorkers">MaxRequestWorkers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of connections that will be processed
-simultaneously</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRequestWorkers <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions pouvant être traitées
+simultanément</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRequestWorkers <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
</table>
- <p>The <code class="directive">MaxRequestWorkers</code> directive sets the limit
- on the number of simultaneous requests that will be served. Any
- connection attempts over the <code class="directive">MaxRequestWorkers</code>
- limit will normally be queued, up to a number based on the
- <code class="directive"><a href="#listenbacklog">ListenBacklog</a></code>
- directive. Once a child process is freed at the end of a different
- request, the connection will then be serviced.</p>
-
- <p>For non-threaded servers (<em>i.e.</em>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>),
- <code class="directive">MaxRequestWorkers</code> translates into the maximum
- number of child processes that will be launched to serve requests.
- The default value is <code>256</code>; to increase it, you must also raise
- <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
-
- <p>For threaded and hybrid servers (<em>e.g.</em> <code class="module"><a href="../mod/event.html">event</a></code>
- or <code class="module"><a href="../mod/worker.html">worker</a></code>) <code class="directive">MaxRequestWorkers</code> restricts
- the total number of threads that will be available to serve clients.
- For hybrid MPMs the default value is <code>16</code> (<code class="directive"><a href="#serverlimit">ServerLimit</a></code>) multiplied by the value of
- <code>25</code> (<code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>). Therefore, to increase <code class="directive">MaxRequestWorkers</code> to a value that requires more than 16 processes,
- you must also raise <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
-
- <p><code class="directive">MaxRequestWorkers</code> was called
- <code class="directive">MaxClients</code> before version 2.3.13. The old name is still
- supported.</p>
+ <p>La directive <code class="directive">MaxRequestWorkers</code> permet de fixer le
+ nombre maximum de requêtes pouvant être traitées simultanément.
+ Si la limite <code class="directive">MaxRequestWorkers</code> est atteinte, toute
+ tentative de connexion sera normalement mise dans une file
+ d'attente, et ceci jusqu'à un certain nombre dépendant de la
+ directive <code class="directive"><a href="#listenbacklog">ListenBacklog</a></code>.
+ Lorsqu'un processus enfant se libèrera suite à la fin du traitement
+ d'une requête, la connexion en attente pourra être traitée à son
+ tour.</p>
+
+ <p>Pour les serveurs non threadés (<em>c'est à dire</em> utilisant
+ <code class="module"><a href="../mod/prefork.html">prefork</a></code>), la directive
+ <code class="directive">MaxRequestWorkers</code> définit alors le nombre maximum de
+ processus enfants qui pourront être lancés simultanément pour
+ traiter les requêtes. La valeur par défaut est <code>256</code> ; si
+ vous l'augmentez, vous devez aussi augmenter la valeur de la
+ directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
+
+ <p>Pour les serveur threadés et hybrides (utilisant <em>par
+ exemple</em> <code class="module"><a href="../mod/event.html">event</a></code> ou <code class="module"><a href="../mod/worker.html">worker</a></code>),
+ <code class="directive">MaxRequestWorkers</code> définit alors le nombre total de
+ threads qui seront disponibles pour servir les clients. Dans le
+ cas des MPMs hybrides, la valeur par défaut est <code>16</code>
+ (directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>) multiplié par la valeur
+ <code>25</code> (directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>). Par conséquent, pour affecter à la
+ directive <code class="directive">MaxRequestWorkers</code> une valeur qui requiert
+ plus de 16 processus, vous devez aussi augmenter la valeur de la
+ directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
+
+ <p>Le nom de la directive <code class="directive">MaxRequestWorkers</code>
+ était <code class="directive">MaxClients</code> avant la version 2.3.13. Cet
+ ancien nom est encore supporté.</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="maxsparethreads" id="maxsparethreads">Directive</a> <a name="MaxSpareThreads" id="MaxSpareThreads">MaxSpareThreads</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of idle threads</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareThreads <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de threads inactifs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareThreads <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>Maximum number of idle threads. Different MPMs deal with this
- directive differently.</p>
-
- <p>For <code class="module"><a href="../mod/worker.html">worker</a></code> and <code class="module"><a href="../mod/event.html">event</a></code>, the default is
- <code>MaxSpareThreads 250</code>. These MPMs deal with idle threads
- on a server-wide basis. If there are too many idle threads in the
- server then child processes are killed until the number of idle
- threads is less than this number. Additional processes/threads
- might be created if <code class="directive"><a href="#listencoresbucketsratio">ListenCoresBucketsRatio</a></code>
- is enabled.</p>
-
- <p>For <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code> the default is
- <code>MaxSpareThreads 100</code>. Since this MPM runs a
- single-process, the spare thread count is also server-wide.</p>
-
- <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> works
- similar to <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>. For
- <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> the default value is <code>10</code>.</p>
-
- <div class="note"><h3>Restrictions</h3>
- <p>The range of the <code class="directive">MaxSpareThreads</code> value
- is restricted. Apache httpd will correct the given value automatically
- according to the following rules:</p>
+ <p>C'est le nombre maximum de threads inactifs. Les MPMs utilisent
+ cette directive de différentes manières.</p>
+
+ <p>Pour <code class="module"><a href="../mod/worker.html">worker</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, la définition par défaut est
+ <code>MaxSpareThreads 250</code>. Ce MPM gère les threads inactifs
+ au niveau du serveur. Si le serveur possède trop de threads
+ inactifs, des processus enfants seront arrêtés jusqu'à ce que le
+ nombre de threads inactifs repasse en dessous de cette limite. Des
+ processus/threads supplémentaires sont susceptibles d'être créés si
+ <code class="directive"><a href="#listencoresbucketsratio">ListenCoresBucketsRatio</a></code> est
+ activée.</p>
+
+ <p>Pour <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
+ <code>MaxSpareThreads 100</code>. Comme ce MPM n'exécute qu'un seul
+ processus, le nombre de processus inactifs est surveillé au
+ niveau du serveur.</p>
+
+ <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de manière similaire à
+ <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>. Pour <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>, la
+ valeur par défaut est <code>10</code>.</p>
+
+ <div class="note"><h3>Contraintes</h3>
+ <p>La gamme de valeurs pour <code class="directive">MaxSpareThreads</code>
+ est limitée. Apache httpd corrigera automatiquement cette valeur selon
+ les règles suivantes :</p>
<ul>
- <li><code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code> wants the value to be greater than
- <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>.</li>
+ <li>Avec <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="directive">MaxSpareThreads</code> doit être supérieure à <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>.</li>
- <li>For <code class="module"><a href="../mod/worker.html">worker</a></code> and <code class="module"><a href="../mod/event.html">event</a></code>, the value
- must be greater or equal to the sum of <code class="directive"><a href="#minsparethreads">
- MinSpareThreads</a></code> and <code class="directive"><a href="#threadsperchild">
- ThreadsPerChild</a></code>.</li>
+ <li>Avec
+ <code class="module"><a href="../mod/worker.html">worker</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, <code class="directive">MaxSpareThreads</code>
+ doit être supérieure ou égale à la somme de <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></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="minsparethreads" id="minsparethreads">Directive</a> <a name="MinSpareThreads" id="MinSpareThreads">MinSpareThreads</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of idle threads available to handle request
-spikes</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareThreads <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de threads inactifs qui seront disponibles
+pour pouvoir traiter les pics de requêtes</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareThreads <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>Minimum number of idle threads to handle request spikes.
- Different MPMs deal with this directive differently.</p>
+ <p>C'est le nombre minimum de threads inactifs pour être en mesure
+ de traiter les pics de requêtes. Les MPMs utilisent cette directive
+ de différentes manières.</p>
- <p><code class="module"><a href="../mod/worker.html">worker</a></code> and <code class="module"><a href="../mod/event.html">event</a></code> use a default of
- <code>MinSpareThreads 75</code> and deal with idle threads on a server-wide
- basis. If there aren't enough idle threads in the server then child
- processes are created until the number of idle threads is greater
- than <var>number</var>. Additional processes/threads
- might be created if <code class="directive"><a href="#listencoresbucketsratio">ListenCoresBucketsRatio</a></code>
- is enabled.</p>
+ <p>Avec <code class="module"><a href="../mod/worker.html">worker</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, la définition par défaut est
+ <code>MinSpareThreads 75</code>, et le nombre de threads inactifs
+ est surveillé au niveau du serveur. Si le serveur ne possède pas
+ assez de threads inactifs, des processus enfants sont créés jusqu'à
+ ce que le nombre de threads inactifs repasse au dessus de
+ <var>nombre</var>. Des processus/threads supplémentaires peuvent
+ être créés si <code class="directive"><a href="#listencoresbucketsratio">ListenCoresBucketsRatio</a></code> est activée.</p>
- <p><code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code> uses a default of
- <code>MinSpareThreads 10</code> and, since it is a single-process
- MPM, tracks this on a server-wide bases.</p>
+ <p>Avec <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
+ <code>MinSpareThreads 10</code> et, comme ce MPM n'exécute qu'un
+ seul processus, le nombre de threads est surveillé au niveau du
+ serveur.</p>
+
+ <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de manière similaire à
+ <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>. Pour <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>, la
+ valeur par défaut est <code>5</code>.</p>
- <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> works
- similar to <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>. For
- <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> the default value is <code>5</code>.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="pidfile" id="pidfile">Directive</a> <a name="PidFile" id="PidFile">PidFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>File where the server records the process ID
-of the daemon</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PidFile <var>filename</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ficher dans lequel le serveur enregistre l'identificateur
+de processus du démon</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PidFile <var>nom fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>PidFile httpd.pid</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The <code class="directive">PidFile</code> directive sets the file to
- which the server records the process id of the daemon. If the
- filename is not absolute then it is assumed to be relative to the
- <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
+ <p>La directive <code class="directive">PidFile</code> permet de définir le
+ ficher dans lequel le serveur
+ enregistre l'identificateur de processus du démon. Si le chemin du
+ fichier n'est pas absolu, il est considéré comme relatif au chemin
+ défini par la directive <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
- <div class="example"><h3>Ex
ample</h3><pre class="prettyprint lang-config">PidFile /var/run/apache.pid</pre>
+ <div class="example"><h3>Ex
emple</h3><pre class="prettyprint lang-config">PidFile /var/run/apache.pid</pre>
</div>
- <p>It is often useful to be able to send the server a signal,
- so that it closes and then re-opens its <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> and <code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code>, and
- re-reads its configuration files. This is done by sending a
- SIGHUP (kill -1) signal to the process id listed in the
- <code class="directive">PidFile</code>.</p>
+ <p>Il est souvent utile de pouvoir envoyer un signal au
+ serveur afin qu'il ferme et ouvre à nouveau ses journaux
+ d'<code class="directive"><a href="../mod/core.html#erreur">erreur</a></code> et de <code class="directive"><a href="../mod/mod_log_config.html#transfert">transfert</a></code>, et recharge son
+ fichier de configuration. Pour ce faire, on envoie un signal SIGHUP
+ (kill -1) à l'identificateur de processus enregistré dans le fichier
+ défini par la directive <code class="directive">PidFile</code>.</p>
- <p>The <code class="directive">PidFile</code> is subject to the same
- warnings about log file placement and <a href="../misc/security_tips.html#serverroot">security</a>.</p>
+ <p>La directive <code class="directive">PidFile</code> fait l'objet des
+ mêmes avertissements que ceux concernant le chemin d'enregistrement
+ des fichiers journaux et la <a href="../misc/security_tips.html#serverroot">sécurité</a>.</p>
<div class="note"><h3>Note</h3>
- <p>As of Apache HTTP Server 2, we recommended that you only use the <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> script, or the init script that your OS provides,
- for (re-)starting or stopping the server.</p>
+ <p>Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser
+ que le script <code class="program"><a href="../programs/apachectl.html">apachectl</a></code>, ou le script de
+ démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
+ arrêter le serveur.</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="receivebuffersize" id="receivebuffersize">Directive</a> <a name="ReceiveBufferSize" id="ReceiveBufferSize">ReceiveBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>TCP receive buffer size</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReceiveBufferSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en entrée</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReceiveBufferSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ReceiveBufferSize 0</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The server will set the TCP receive buffer size to the number of
- bytes specified.</p>
+ <p>Le serveur va fixer la taille du tampon TCP en entrée au
+ nombre d'octets spécifié.</p>
- <p>If set to the value of <code>0</code>, the server will use the
- OS default.</p>
+ <p>Si la directive est définie à <code>0</code>, le serveur va
+ utiliser la valeur par défaut adoptée par le système
+ d'exploitation.</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="scoreboardfile" id="scoreboardfile">Directive</a> <a name="ScoreBoardFile" id="ScoreBoardFile">ScoreBoardFile</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the file used to store coordination data for
-the child processes</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier où sont stockées les données concernant
+la coordination des processus enfants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScoreBoardFile <var>file-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScoreBoardFile apache_runtime_status</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
- <p>Apache HTTP Server uses a scoreboard to communicate between its parent
- and child processes. Some architectures require a file to facilitate
- this communication. If the file is left unspecified, Apache httpd first
- attempts to create the scoreboard entirely in memory (using anonymous
- shared memory) and, failing that, will attempt to create the file on
- disk (using file-based shared memory). Specifying this directive causes
- Apache httpd to always create the file on the disk.</p>
-
- <p>If <var>file-path</var> is not an absolute path, the location specified
- will be relative to the value of
- <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
-
- <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">ScoreBoardFile /var/run/apache_runtime_status</pre>
+ <p>Le serveur HTTP Apache utilise un tableau de bord pour la
+ communication entre le processus parent et les processus enfants.
+ Pour faciliter cette communication, certaines architectures
+ nécessitent un fichier. En l'absence de cette directive, donc si
+ aucun nom de fichier n'est spécifié, Apache httpd tentera tout
+ d'abord de créer un tableau uniquement en mémoire (en utilisant la
+ mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de
+ créer un fichier sur disque (en utilisant la mémoire partagée à base
+ de fichier). Si cette directive est utilisée, Apache httpd créera
+ systématiquement un fichier sur disque.</p>
+
+ <p>Si <var>file-path</var> n'est pas un chemin absolu, il sera relatif à la
+ valeur spécifiée par la directive <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.
+ </p>
+
+ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ScoreBoardFile /var/run/apache_runtime_status</pre>
</div>
- <p>File-based shared memory is useful for third-party applications
- that require direct access to the scoreboard.</p>
+ <p>Une mémoire partagée sous forme de fichier est utile pour les
+ applications tierces qui nécessitent un accès direct au tableau de
+ bord des processus.</p>
- <p>If you use a <code class="directive">ScoreBoardFile</code> then
- you may see improved speed by placing it on a RAM disk. But be
- careful that you heed the same warnings about log file placement
- and <a href="../misc/security_tips.html">security</a>.</p>
+ <p>Si vous utilisez un <code class="directive">ScoreBoardFile</code>, vous
+ pourrez constater une amélioration des performances en le plaçant
+ sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte
+ des mêmes avertissements que ceux concernant le chemin du fichier
+ journal et la <a href="../misc/security_tips.html">sécurité</a>.</p>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../stopping.html">Stopping and Restarting
-Apache HTTP Server</a></li>
+<li><a href="../stopping.html">Arrêter et redémarrer
+le 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="sendbuffersize" id="sendbuffersize">Directive</a> <a name="SendBufferSize" id="SendBufferSize">SendBufferSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>TCP buffer size</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SendBufferSize <var>bytes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en sortie</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SendBufferSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SendBufferSize 0</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>Sets the server's TCP send buffer size to the number of bytes
- specified. It is often useful to set this past the OS's standard
- default value on high speed, high latency connections
- (<em>i.e.</em>, 100ms or so, such as transcontinental fast pipes).</p>
-
- <p>If set to the value of <code>0</code>, the server will use the
- default value provided by your OS.</p>
-
- <p>Further configuration of your operating system may be required to elicit
- better performance on high speed, high latency connections.</p>
-
- <div class="note"> <p> On some operating systems, changes in TCP behavior resulting
- from a larger <code class="directive">SendBufferSize</code> may not be seen unless
- <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> is set to OFF. This
- interaction applies only to static files.</p> </div>
-
+ <p>Définit la taille du tampon TCP en sortie avec le nombre
+ d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les
+ valeurs par défaut standards du passé des systèmes d'exploitation
+ pour les transmissions à grande vitesse et haute densité (<em>c'est
+ à dire</em> de l'ordre de 100ms comme sur les liaisons rapides
+ transcontinentales).</p>
+
+ <p>Si la directive est définie à <code>0</code>, le serveur va
+ utiliser la valeur par défaut adoptée par le système
+ d'exploitation.</p>
+
+ <p>L'amélioration des performances des connexions à grande vitesse
+ et à temps de latence élevé, peut nécessiter
+ une intervention au niveau de la configuration de votre système
+ d'exploitation.</p>
+
+ <div class="note"><p>Sous certains systèmes d'exploitation, la modification du
+ comportement TCP via une augmentation de la valeur de
+ <code class="directive">SendBufferSize</code> risque de ne pas être
+ perceptible, si la directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> n'est pas définie à OFF.
+ Cette interaction ne s'applique qu'aux fichiers statiques.</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="serverlimit" id="serverlimit">Directive</a> <a name="ServerLimit" id="ServerLimit">ServerLimit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Upper limit on configurable number of processes</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerLimit <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite supérieure de la définition du nombre de
+processus</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerLimit <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code></td></tr>
</table>
- <p>For the <code class="module"><a href="../mod/prefork.html">prefork</a></code> MPM, this directive sets the
- maximum configured value for <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> for the lifetime of the
- Apache httpd process. For the <code class="module"><a href="../mod/worker.html">worker</a></code> and <code class="module"><a href="../mod/event.html">event
- </a></code> MPMs, this directive in combination with <code class="directive"><a href="#threadlimit">ThreadLimit</a></code> sets
- the maximum configured value for <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> for the lifetime of the
- Apache httpd process. For the <code class="module"><a href="../mod/event.html">event</a></code> MPM, this directive
- also defines how many old server processes may keep running and finish processing
- open connections.
- Any attempts to change this directive during a restart will be ignored, but
- <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> can be modified
- during a restart.</p>
-
- <p>Special care must be taken when using this directive. If
- <code class="directive">ServerLimit</code> is set to a value much higher
- than necessary, extra, unused shared memory will be allocated. If
- both <code class="directive">ServerLimit</code> and <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> are set to values
- higher than the system can handle, Apache httpd may not start or the
- system may become unstable.</p>
-
- <p>With the <code class="module"><a href="../mod/prefork.html">prefork</a></code> MPM, use this directive only
- if you need to set <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> higher than 256 (default).
- Do not set the value of this directive any higher than what you
- might want to set <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> to.</p>
-
- <p>With <code class="module"><a href="../mod/worker.html">worker</a></code>, use this directive only if your
- <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers
- </a></code> and <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>
- settings require more than 16 server processes (default). Do not set
- the value of this directive any higher than the number of server
- processes required by what you may want for <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers </a></code> and <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>.</p>
-
- <p>With <code class="module"><a href="../mod/event.html">event</a></code>, increase this directive if the process
- number defined by your <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> and <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> settings, plus the
- number of gracefully shutting down processes, is more than 16 server
- processes (default).</p>
+ <p>Avec le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>, cette directive définit le
+ nombre maximum que l'on peut affecter à la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la
+ durée de vie du processus Apache httpd. Avec les
+ MPMs <code class="module"><a href="../mod/worker.html">worker</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, cette directive, en combinaison avec
+ <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, définit le
+ nombre maximum que l'on peut affecter à <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la durée de
+ vie du processus Apache httpd. Avec le MPM <code class="module"><a href="../mod/event.html">event</a></code>, cette
+ directive permet aussi de définir combien de processus anciens peuvent
+ continuer à s'exécuter pour terminer le traitement des connexions ouvertes.
+ Au cours d'un redémarrage, vous pouvez
+ modifier la valeur de la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, alors que toute
+ tentative de modification de la valeur de la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> sera ignorée.</p>
+
+ <p>Cette directive doit être utilisée avec précaution. Si
+ <code class="directive">ServerLimit</code> est définie à une valeur beaucoup
+ plus grande que nécessaire, de la mémoire partagée supplémentaire
+ sera inutilement allouée. Si à la fois
+ <code class="directive">ServerLimit</code> et <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> possèdent des valeurs
+ supérieures à ce que le système peut supporter, ce dernier peut
+ devenir instable ou Apache httpd peut tout simplement refuser de démarrer.</p>
+
+ <p>Avec les MPMs <code class="module"><a href="../mod/prefork.html">prefork</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, n'utilisez cette directive
+ que si vous devez définir <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> à une valeur supérieure à
+ 256 (valeur par défaut). N'affectez pas à la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une valeur supérieure à
+ celle que vous avez prévu d'affecter à la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>.</p>
+
+ <p>Avec <code class="module"><a href="../mod/worker.html">worker</a></code>, n'utilisez cette directive que si
+ la définition de vos directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> nécessitent plus de
+ 16 processus serveurs (valeur par défaut). N'affectez pas à la
+ directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une
+ valeur supérieure au nombre de processus requis pour la définition
+ des directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers
+ </a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>.</p>
+
+ <p>Avec le MPM <code class="module"><a href="../mod/event.html">event</a></code>, augmentez la valeur de cette
+ directive si le nombre de processus défini par les directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> augmenté du nombre de processus
+ en procédure d'arrêt "graceful" est supérieur à 16 (valeur par défaut).</p>
<div class="note"><h3>Note</h3>
- <p>There is a hard limit of <code>ServerLimit 20000</code> compiled
- into the server (for the <code class="module"><a href="../mod/prefork.html">prefork</a></code> MPM 200000). This is
- intended to avoid nasty effects caused by typos. To increase it
- even further past this limit, you will need to modify the value of
- MAX_SERVER_LIMIT in the mpm source file and rebuild the server.</p>
+ <p>Il existe une limite de <code>ServerLimit 20000</code> codée en
+ dur dans le serveur (200000 pour le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>).
+ Ceci est censé éviter les effets désastreux que pourrait provoquer
+ une faute de frappe. Pour dépasser cette limite, vous devez
+ modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du
+ mpm et recompiler le serveur.</p>
</div>
<h3>Voir aussi</h3>
<ul>
-<li><a href="../stopping.html">Stopping and Restarting Apache HTTP Server</a></li>
+<li><a href="../stopping.html">Arrêter et redémarrer
+le 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="startservers" id="startservers">Directive</a> <a name="StartServers" id="StartServers">StartServers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of child server processes created at startup</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartServers <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de processus enfants du serveur créés au
+démarrage</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartServers <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The <code class="directive">StartServers</code> directive sets the
- number of child server processes created on startup. As the number
- of processes is dynamically controlled depending on the load, (see
- <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>,
- <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>,
- <code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code>)
- there is usually little reason to adjust this parameter.</p>
-
- <p>The default value differs from MPM to MPM. <code class="module"><a href="../mod/worker.html">worker</a></code> and
- <code class="module"><a href="../mod/event.html">event</a></code> default to <code>StartServers 3</code>; <code class="module"><a href="../mod/prefork.html">
- prefork</a></code> defaults to <code>5</code>; <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>
- defaults to <code>2</code>.</p>
+ <p>La directive <code class="directive">StartServers</code> permet de
+ définir le nombre de processus enfants du serveur créés au
+ démarrage. Comme le nombre de processus est contrôlé dynamiquement
+ en fonction de la charge (voir <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>, <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>, <code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code>), il n'est en général
+ pas nécessaire d'ajuster ce paramètre.</p>
+
+ <p>La valeur par défaut diffère d'un MPM à l'autre. Pour
+ <code class="module"><a href="../mod/worker.html">worker</a></code> et <code class="module"><a href="../mod/event.html">event</a></code>, la définition par défaut est
+ <code>StartServers 3</code> ; la valeur par défaut est
+ <code>5</code> pour <code class="module"><a href="../mod/prefork.html">prefork</a></code> et <code>2</code>
+ pour <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</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="startthreads" id="startthreads">Directive</a> <a name="StartThreads" id="StartThreads">StartThreads</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of threads created on startup</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartThreads <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads créés au démarrage</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartThreads <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code></td></tr>
</table>
- <p>Number of threads created on startup. As the
- number of threads is dynamically controlled depending on the
- load, (see
- <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>,
- <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>,
- <code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code>)
- there is usually little reason to adjust this
- parameter.</p>
-
- <p>For <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code> the default is
- <code>StartThreads 50</code> and, since there is only a single
- process, this is the total number of threads created at startup to
- serve requests.</p>
+ <p>C'est le nombre de threads créés au démarrage du serveur. Comme
+ le nombre de threads est contrôlé dynamiquement
+ en fonction de la charge (voir <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>, <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>, <code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code>), il n'est en général
+ pas nécessaire d'ajuster ce paramètre.</p>
+
+ <p>Pour <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
+ <code>StartThreads 50</code> et, comme il n'y a qu'un processus, il
+ s'agit du nombre total de threads créés au démarrage pour servir les
+ requêtes.</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="threadlimit" id="threadlimit">Directive</a> <a name="ThreadLimit" id="ThreadLimit">ThreadLimit</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the upper limit on the configurable number of threads
-per child process</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadLimit <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de threads maximum que l'on peut définir par
+processus enfant</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadLimit <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
- <p>This directive sets the maximum configured value for <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> for the lifetime
- of the Apache httpd process. Any attempts to change this directive
- during a restart will be ignored, but <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> can be modified
- during a restart up to the value of this directive.</p>
-
- <p>Special care must be taken when using this directive. If
- <code class="directive">ThreadLimit</code> is set to a value much higher
- than <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>,
- extra unused shared memory will be allocated. If both
- <code class="directive">ThreadLimit</code> and <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> are set to values
- higher than the system can handle, Apache httpd may not start or the
- system may become unstable. Do not set the value of this directive
- any higher than your greatest predicted setting of <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> for the
- current run of Apache httpd.</p>
-
- <p>The default value for <code class="directive">ThreadLimit</code> is
- <code>1920</code> when used with <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code> and
- <code>64</code> when used with the others.</p>
+ <p>Cette directive permet de définir le nombre maximum que l'on peut
+ affecter à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour la durée de vie
+ du processus Apache httpd. La directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> peut être modifiée
+ au cours d'un redémarrage jusqu'à la valeur de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, mais toute tentative
+ de modification de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code> au cours d'un
+ redémarrage sera ignorée.</p>
+
+ <p>L'utilisation de cette directive doit faire l'objet de
+ précautions particulières. Si <code class="directive">ThreadLimit</code> est
+ définie à une valeur très supérieure à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>, de la mémoire
+ partagée supplémentaire sera inutilement allouée. Si les directives
+ <code class="directive">ThreadLimit</code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> sont définies à des
+ valeurs supérieures à ce que le système peut supporter, ce dernier
+ peut devenir instable, ou Apache httpd peut tout simplement refuser de
+ démarrer. Ne définissez pas cette directive à une valeur supérieure
+ à la valeur maximale que vous pensez affecter à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour le processus
+ Apache httpd en cours d'exécution.</p>
+
+ <p>La valeur par défaut de la directive
+ <code class="directive">ThreadLimit</code> est <code>1920</code> avec
+ <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>64</code> avec les autres
+ MPMs.</p>
<div class="note"><h3>Note</h3>
- <p>There is a hard limit of <code>ThreadLimit 20000</code> (or
- <code>ThreadLimit 100000</code> with <code class="module"><a href="../mod/event.html">event</a></code>,
- <code>ThreadLimit 15000</code> with <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>)
- compiled into the server. This is intended to avoid nasty effects
- caused by typos. To increase it even further past this limit, you
- will need to modify the value of MAX_THREAD_LIMIT in the mpm
- source file and rebuild the server.</p>
+ <p>Il existe une limite de <code>ThreadLimit 20000</code> (ou
+ <code>ThreadLimit 100000</code> avec <code class="module"><a href="../mod/event.html">event</a></code>,
+ <code>ThreadLimit 15000</code> avec <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>)
+ codée en dur dans le serveur. Ceci est censé éviter les effets
+ désastreux que pourrait provoquer une faute de frappe. Pour
+ dépasser cette limite, vous devez modifier la valeur de
+ MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le
+ serveur.</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="threadsperchild" id="threadsperchild">Directive</a> <a name="ThreadsPerChild" id="ThreadsPerChild">ThreadsPerChild</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of threads created by each child process</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadsPerChild <var>number</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>See usage for details</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads créés par chaque processus
+enfant</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadsPerChild <var>nombre</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Voir ci-dessous pour plus de détails</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
- <p>This directive sets the number of threads created by each
- child process. The child creates these threads at startup and
- never creates more. If using an MPM like <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>,
- where there is only one child process, this number should be high
- enough to handle the entire load of the server. If using an MPM
- like <code class="module"><a href="../mod/worker.html">worker</a></code>, where there are multiple child processes,
- the <em>total</em> number of threads should be high enough to handle
- the common load on the server.</p>
-
- <p>The default value for <code class="directive">ThreadsPerChild</code> is
- <code>64</code> when used with <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code> and
- <code>25</code> when used with the others.</p>
+ <p>Cette directive permet de définir le nombre de threads que va
+ créer chaque processus enfant. Un processus enfant crée ces threads
+ au démarrage et n'en crée plus d'autres par la suite. Si l'on
+ utilise un MPM comme <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code> qui ne lance qu'un
+ processus enfant, ce nombre doit être suffisamment grand pour
+ supporter la charge du serveur. Avec un MPM comme
+ <code class="module"><a href="../mod/worker.html">worker</a></code> qui lance plusieurs processus enfants, c'est
+ le nombre <em>total</em> de threads qui doit être suffisamment grand
+ pour supporter la charge du serveur.</p>
+
+ <p>La valeur par défaut de la directive
+ <code class="directive">ThreadsPerChild</code> est <code>64</code> avec
+ <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>25</code> avec les autres
+ MPMs.</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="threadstacksize" id="threadstacksize">Directive</a> <a name="ThreadStackSize" id="ThreadStackSize">ThreadStackSize</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The size in bytes of the stack used by threads handling
-client connections</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadStackSize <var>size</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>65536 on NetWare; varies on other operating systems</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille en octets de la pile qu'utilisent les threads qui
+traitent les connexions clients</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadStackSize <var>taille</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>65536 sous NetWare; varie en fonction des autres systèmes
+d'exploitation</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
</table>
- <p>The <code class="directive">ThreadStackSize</code> directive sets the
- size of the stack (for autodata) of threads which handle client
- connections and call modules to help process those connections.
- In most cases the operating system default for stack size is
- reasonable, but there are some conditions where it may need to be
- adjusted:</p>
+ <p>La directive <code class="directive">ThreadStackSize</code> permet de
+ définir la taille de la pile (pour les données propres) qu'utilisent
+ les threads qui traitent les connexions clients en faisant appel à
+ des modules. Dans la plupart des cas, la valeur par défaut de la
+ taille de la pile du système d'exploitation convient, mais il existe
+ certaines situations où il peut s'avérer nécessaire de l'ajuster
+ :</p>
<ul>
- <li>On platforms with a relatively small default thread stack size
- (e.g., HP-UX), Apache httpd may crash when using some third-party modules
- which use a relatively large amount of autodata storage. Those
- same modules may have worked fine on other platforms where the
- default thread stack size is larger. This type of crash is
- resolved by setting <code class="directive">ThreadStackSize</code> to a
- value higher than the operating system default. This type of
- adjustment is necessary only if the provider of the third-party
- module specifies that it is required, or if diagnosis of an Apache httpd
- crash indicates that the thread stack size was too small.</li>
-
- <li>On platforms where the default thread stack size is
- significantly larger than necessary for the web server
- configuration, a higher number of threads per child process
- will be achievable if <code class="directive">ThreadStackSize</code> is
- set to a value lower than the operating system default. This type
- of adjustment should only be made in a test environment which allows
- the full set of web server processing can be exercised, as there
- may be infrequent requests which require more stack to process.
- The minimum required stack size strongly depends on the modules
- used, but any change in the web server configuration can invalidate
- the current <code class="directive">ThreadStackSize</code> setting.</li>
-
- <li>On Linux, this directive can only be used to increase the default
- stack size, as the underlying system call uses the value as a
- <em>minimum</em> stack size. The (often large) soft limit for
- <code>ulimit -s</code> (8MB if unlimited) is used as the default stack
- size.</li>
+ <li>Sur les plates-formes qui possèdent une valeur par défaut de
+ taille de la pile relativement petite (par exemple HP-UX), Apache
+ httpd peut se crasher si l'on utilise certains modules tiers qui
+ possèdent un quantité de données propres stockées relativement
+ importante. Il se peut que ces mêmes modules fonctionnent
+ correctement sur d'autres plate-formes où la valeur par défaut de
+ la taille de la pile est supérieure. Ce type de crash peut être
+ evité en définissant <code class="directive">ThreadStackSize</code> à une
+ valeur supérieure à la valeur par défaut du système
+ d'exploitation. Ce type d'ajustement n'est nécessaire que si le
+ fournisseur du module tiers en fait mention, ou si le diagnostic
+ d'un crash d'Apache httpd indique que la taille de la pile était trop
+ petite.</li>
+
+ <li>Sur les plates-formes où la taille par défaut de la pile des
+ threads est sensiblement supérieure à la taille nécessaire pour la
+ configuration du serveur web, il est possible de disposer d'un
+ plus grand nombre de threads par processus enfant si la directive
+ <code class="directive">ThreadStackSize</code> est définie à une valeur
+ inférieure à la valeur par défaut du système d'exploitation.
+ Cependant, ce
+ type d'ajustement ne doit être effectué que dans un environnement
+ de test permettant de qualifier le serveur web au maximum de ses
+ possibilités, car il peut arriver, dans de rares cas, que des
+ requêtes nécessitent une taille de pile supérieure pour pouvoir
+ être traitées. La taille minimale requise pour la pile dépend
+ fortement des modules utilisés, mais toute modification dans la
+ configuration du serveur web peut invalider la définition courante
+ de la directive <code class="directive">ThreadStackSize</code>.</li>
+
+ <li>Sous Linux, cette directive ne peut être utilisée que pour
+ augmenter la valeur par defaut de la taille de la pile, car
+ l'appel système sous-jacent utilise cette valeur comme taille de pile
+ <em>minimale</em>. C'est la limite logicielle (souvent élevée)
+ pour <code>ulimit -s</code> (8Mo si aucune limite) qui est
+ utilisée comme taille de pile par défaut.</li>
</ul>
- <div class="note">It is recommended to not reduce <code class="directive">ThreadStackSize</code>
- unless a high number of threads per child process is needed. On some
- platforms (including Linux), a setting of 128000 is already too low and
- causes crashes with some common modules.</div>
+ <div class="note">Il est recommandé de ne pas réduire
+ <code class="directive">ThreadStackSize</code>, à moins qu'un grand nombre
+ de threads par processus enfant ne soit nécessaire. Sur certaines
+ plates-formes (y compris Linux), une valeur de 128000 est déjà trop
+ basse et provoque des crashes avec certains modules courants.</div>
</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="maxthreads" id="maxthreads">Directive</a> <a name="MaxThreads" id="MaxThreads">MaxThreads</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the maximum number of worker threads</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxThreads <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nombre maximum de threads esclaves</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxThreads <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxThreads 2048</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mpm_netware</td></tr>
</table>
- <p>The <code class="directive">MaxThreads</code> directive sets the desired
- maximum number worker threads allowable. The default value is
- also the compiled in hard limit. Therefore it can only be lowered,
- for example:</p>
+ <p>La directive <code class="directive">MaxThreads</code> définit
+ le nombre maximum de threads esclaves que l'on désire autoriser. La
+ valeur par défaut correspondant à la valeur codée en dur à la
+ compilation, la valeur de cette directive ne peut donc qu'être
+ diminuée, comme dans l'exemple suivant :</p>
<div class="example"><p><code>
MaxThreads 512
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="maxspareservers" id="maxspareservers">Directive</a> <a name="MaxSpareServers" id="MaxSpareServers">MaxSpareServers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum number of idle child server processes</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareServers <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de processus serveurs enfants
+inactifs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareServers <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxSpareServers 10</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>prefork</td></tr>
</table>
- <p>The <code class="directive">MaxSpareServers</code> directive sets the
- desired maximum number of <em>idle</em> child server processes. An
- idle process is one which is not handling a request. If there are
- more than <code class="directive">MaxSpareServers</code> idle, then the
- parent process will kill off the excess processes.</p>
+ <p>La directive <code class="directive">MaxSpareServers</code> permet de
+ définir le nombre maximum souhaité de processus serveurs enfants
+ <em>inactifs</em>. Un processus inactif est un processus qui ne
+ traite pas de requête. S'il y a plus de
+ <code class="directive">MaxSpareServers</code> processus inactifs, le
+ processus parent arrêtera les processus excédentaires.</p>
- <p>Tuning of this parameter should only be necessary on very
- busy sites. Setting this parameter to a large number is almost
- always a bad idea. If you are trying to set the value equal to or lower than
- <code class="directive"><a href="#minspareservers">MinSpareServers</a></code>, Apache HTTP Server
- will automatically adjust it to <code class="directive">MinSpareServers</code><code> + 1</code>.</p>
+ <p>La modification de ce paramètre n'est nécessaire que
+ dans le cas de sites très sollicités. Définir ce paramètre à une
+ valeur très grande est cependant dans la plupart des cas une
+ mauvaise idée. Si vous essayez d'affecter à ce paramètre une valeur
+ égale ou inférieure à la valeur de <code class="directive"><a href="#minspareservers">MinSpareServers</a></code>, le serveur HTTP Apache
+ l'ajustera automatiquement à la valeur de <code class="directive">
+ MinSpareServers</code><code> + 1</code>.</p>
<h3>Voir aussi</h3>
<ul>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="minspareservers" id="minspareservers">Directive</a> <a name="MinSpareServers" id="MinSpareServers">MinSpareServers</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Minimum number of idle child server processes</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareServers <var>number</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de processus serveurs enfants
+inactifs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareServers <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MinSpareServers 5</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>MPM</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>prefork</td></tr>
</table>
- <p>The <code class="directive">MinSpareServers</code> directive sets the
- desired minimum number of <em>idle</em> child server processes. An
- idle process is one which is not handling a request. If there are
- fewer than <code class="directive">MinSpareServers</code> idle, then the parent
- process creates new children: It will spawn one, wait a second, then spawn
- two, wait a second, then spawn four, and it will
- continue exponentially until it is spawning 32 children per second. It will
- stop whenever it satisfies the <code class="directive">MinSpareServers</code>
- setting.</p>
+ <p>La directive <code class="directive">MinSpareServers</code> permet de
+ définir le nombre minimum désiré de processus serveurs enfants
+ <em>inactifs</em>. Un processus inactif est un processus qui ne
+ traite pas de requête. S'il y a moins de
+ <code class="directive">MinSpareServers</code> processus inactifs, le
+ processus parent va créer de nouveaux enfants de la manière suivante
+ : il en crée un, attend une seconde, il en crée deux, attend une
+ seconde, il en crée quatre, puis continue ainsi exponentiellement
+ jusu'à ce que son taux de création de processus enfants soit de 32
+ par seconde. Il ne s'arrête que lorsque le nombre de processus
+ enfants correspond à la définition de la directive
+ <code class="directive">MinSpareServers</code>.</p>
- <p>Tuning of this parameter should only be necessary on very
- busy sites. Setting this parameter to a large number is almost
- always a bad idea.</p>
+ <p>La modification de ce paramètre n'est nécessaire que
+ dans le cas de sites très sollicités. Définir ce paramètre à une
+ valeur très grande est dans la plupart des cas une mauvaise
+ idée.</p>
<h3>Voir aussi</h3>
<ul>
projects / thirdparty / apache / httpd.git / commitdiff
