diff options
| author | Lucien Gentis <lgentis@apache.org> | 2016-01-30 18:36:32 +0100 |
|---|---|---|
| committer | Lucien Gentis <lgentis@apache.org> | 2016-01-30 18:36:32 +0100 |
| commit | 985fcfccee2342e22d67d873e2ee133196b1382f (patch) | |
| tree | 51aa6f48fa375b288408386e5a87d8eab85973b5 /docs/manual/mod | |
| parent | charset returns to ISO-8859-1. (diff) | |
| download | apache2-985fcfccee2342e22d67d873e2ee133196b1382f.tar.xz apache2-985fcfccee2342e22d67d873e2ee133196b1382f.zip | |
Rebuild.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1727738 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod')
136 files changed, 10874 insertions, 10874 deletions
diff --git a/docs/manual/mod/core.html b/docs/manual/mod/core.html index 1dad1c3ee1..6f72a8106f 100644 --- a/docs/manual/mod/core.html +++ b/docs/manual/mod/core.html @@ -14,7 +14,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: core.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: core.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 9a87a8831e..72ea1c9075 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -24,16 +24,16 @@ <div id="path"> <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div> <div id="page-content"> -<div id="preamble"><h1>Fonctionalités de Base Apache</h1> +<div id="preamble"><h1>Fonctionalités de Base Apache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/core.html" title="Français"> fr </a> | +<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/core.html" title="Français"> fr </a> | <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | -<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalités de base du serveur HTTP Apache toujours +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalités de base du serveur HTTP Apache toujours disponibles</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Core</td></tr></table> </div> @@ -132,7 +132,7 @@ disponibles</td></tr> <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>Permet d'optimiser la configuration d'une socket pour -l'écoute d'un protocole</td></tr> +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> @@ -140,49 +140,49 @@ d'acceptation</var></code></td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive permet d'effectuer une optimisation de la socket - d'écoute d'un type de protocole en fonction du système + 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 + 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> + 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 + <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>Les noms de protocoles par défaut sont <code>https</code> pour le + <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> + 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>Sous FreeBSD, les valeurs par défaut sont :</p> + <p>Sous FreeBSD, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http httpready AcceptFilter https dataready</pre> <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> + 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>Sous Linux, les valeurs par défaut sont :</p> + <p>Sous Linux, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http data AcceptFilter https data</pre> <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas - la mise en tampon des requêtes http. Toute valeur autre que + 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 + pour ce protocole. Pour plus de détails, voir la page de manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/ tcp.7.html">tcp(7)</a>.</p> - <p>Sous Windows, les valeurs par défaut sont :</p> + <p>Sous Windows, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http data AcceptFilter https data</pre> @@ -190,19 +190,19 @@ AcceptFilter https data</pre> <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. Deux valeurs utilisent - l'API Windows AcceptEx() et vont recycler les sockets réseau entre - les connexions. <code>data</code> attend jusqu'à ce que les données - aient été transmises comme décrit plus haut, et le tampon de données - initiales ainsi que les adresses réseau finales sont tous extraits - grâce à une seule invocation d'AcceptEx(). <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> + l'API Windows AcceptEx() et vont recycler les sockets réseau entre + les connexions. <code>data</code> attend jusqu'à ce que les données + aient été transmises comme décrit plus haut, et le tampon de données + initiales ainsi que les adresses réseau finales sont tous extraits + grâce à une seule invocation d'AcceptEx(). <code>connect</code> + utilise l'API AcceptEx(), extrait aussi les adresses réseau finales, + mais à l'instar de <code>none</code>, la valeur <code>connect</code> + n'attend pas la transmission des données initiales.</p> <p>Sous Windows, <code>none</code> utilise accept() au lieu d'AcceptEx(), et ne recycle pas les sockets entre les connexions. - Ceci s'avère utile pour les interfaces réseau dont le pilote est - défectueux, ainsi que pour certains fournisseurs de réseau comme les + 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> @@ -216,58 +216,58 @@ AcceptFilter https data</pre> <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>Les ressources acceptent des informations sous forme d'un -nom de chemin en fin de requête.</td></tr> +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#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#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>Cette directive permet de définir si les requêtes contenant des + <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 + 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 + 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>/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> + possède trois valeurs possibles :</p> <dl> - <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 + <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 + <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> + <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>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 + 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 @@ -282,18 +282,18 @@ nom de chemin en fin de requête.</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="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>Nom du fichier de configuration distribué</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#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>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>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> @@ -303,8 +303,8 @@ nom de chemin en fin de requête.</td></tr> <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> + pour y lire d'éventuelles directives, à moins quelles n'aient été + désactivées avec</p> <pre class="prettyprint lang-config"><Directory "/"> AllowOverride None @@ -321,49 +321,49 @@ nom de chemin en fin de requête.</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="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>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 +<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#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>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 + <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 + 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). + 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>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 + ê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> + à 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> @@ -373,42 +373,42 @@ type de contenu d'une réponse est <code>text/plain</code> ou <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>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#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#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>L'option NoDecode est disponible depuis la version +<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>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> + l'utilisation des URLs contenant des séparateurs de chemin + encodés dans la partie chemin + (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour + <code>\</code> sur les systèmes concernés).</p> - <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont - refusées et provoquent le renvoi d'une erreur 404 (Not found).</p> + <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont + refusées et provoquent le renvoi d'une erreur 404 (Not found).</p> - <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les - slashes encodés sont décodés comme tout autre caractère codé.</p> + <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les + slashes encodés sont décodés comme tout autre caractère codé.</p> - <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées, - mais les slashes codés ne sont pas décodés et laissés dans leur état - codé.</p> + <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées, + mais les slashes codés ne sont pas décodés et laissés dans leur état + codé.</p> - <p>Définir <code class="directive">AllowEncodedSlashes</code> à + <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>Si le codage des slashes dans la partie chemin est nécessaire, + <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> + 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> @@ -419,37 +419,37 @@ autorisés à transiter dans les URLs tels quels</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowoverride" id="allowoverride">Directive</a> <a name="AllowOverride" id="AllowOverride">AllowOverride</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autorisées dans les fichiers +<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>type directive</var> [<var>type directive</var>] ...</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#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>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> + 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 + 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>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> sont définies à <code>None</code>, les + <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> + ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les + fichiers <code>.htaccess</code> du système de fichiers.</p> - <p>Lorsque cette directive est définie à <code>All</code>, toute + <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> + autorisée dans les fichiers <code>.htaccess</code>.</p> <p>L'argument <var>type directive</var> peut contenir les groupements de directives suivants :</p> @@ -468,10 +468,10 @@ All pour les versions antérieures</code></td></tr> <dt>FileInfo</dt> <dd> - Permet l'utilisation des directives qui contrôlent les types de + 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 + 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 @@ -482,8 +482,8 @@ All pour les versions antérieures</code></td></tr> <dt>Indexes</dt> <dd> - 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>, + 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>, @@ -493,7 +493,7 @@ All pour les versions antérieures</code></td></tr> <dt>Limit</dt> <dd> - Permet l'utilisation des directives contrôlant l'accès au serveur + 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> @@ -506,25 +506,25 @@ All pour les versions antérieures</code></td></tr> <dd> Permet d'utiliser l'option AllowOverride pour rendre les erreurs de syntaxe non fatales 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 + 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> 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> + 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> + précédentes non fatales.</li> </ul> <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 + <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 + configuration utilisateur destinée à restreindre l'accès à un site ne sera pas prise en compte. </div> </dd> @@ -532,21 +532,21 @@ All pour les versions antérieures</code></td></tr> <dt>Options[=<var>Option</var>,...]</dt> <dd> - 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 à + 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> + <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 + .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 + 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. + 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> @@ -566,11 +566,11 @@ All pour les versions antérieures</code></td></tr> <code>Indexes</code>, provoquent une erreur "internal server error".</p> - <div class="note"><p>Pour des raisons de sécurité et de performance, ne - définissez pas <code>AllowOverride</code> à autre chose que + <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 + 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> @@ -585,29 +585,29 @@ All pour les versions antérieures</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>Directives autorisées dans les fichiers <code>.htaccess</code></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#Context">Contexte:</a></th><td>répertoire</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#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>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 + (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 + disponible que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> spécifiées sans expressions rationnelles. </div> - <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>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> @@ -616,7 +616,7 @@ AllowOverrideList Redirect RedirectMatch</pre> <p>Dans l'exemple ci-dessus, seules les directives - <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées. + <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées. Toutes les autres provoqueront une erreur interne du serveur.</p> <p>Example:</p> @@ -642,85 +642,85 @@ AllowOverrideList CookieTracking CookieName</pre> <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>Définit le type de filtrage minimal disponible pour le +<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#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>Disponible à partir de la version 2.5.0 du serveur +<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>Cette directive permet de définir les niveaux minimaux de + <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 + 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 + <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 + <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 permettant de localiser l'interpréteur des +<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#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 uniquement</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare uniquement</td></tr> </table> - <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> + <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>Active la transmission d'en-têtes d'autorisation HTTP aux scripts en +<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#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>Disponible à partir de la version 2.4.13 du serveur HTTP +<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>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 + 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 + 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 + <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>, etc... En particulier, elle affecte - les modules qui ne traitent pas à proprement parler les requêtes, - mais utilisent quand-même cette API, comme + 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> @@ -729,145 +729,145 @@ Apache</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="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>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#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#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#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> </table> - <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 + <p>Cette directive active la génération d'un en-tête + <code>Content-MD5</code> selon les définitions des RFC 1864 et 2616.</p> - <p>MD5 est un algorithme permettant de générer un condensé (parfois - appelé "empreinte") à partir de données d'une taille aléatoire ; le - degré de précision est tel que la moindre altération des données - d'origine entraîne une altération de l'empreinte.</p> + <p>MD5 est un algorithme permettant de générer un condensé (parfois + appelé "empreinte") à partir de données d'une taille aléatoire ; le + degré de précision est tel que la moindre altération des données + d'origine entraîne une altération de l'empreinte.</p> - <p>L'en-tête <code>Content-MD5</code> permet de vérifier - l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire - ou un client peut utiliser cet en-tête pour rechercher une - éventuelle modification accidentelle de la réponse au cours de sa - transmission. Exemple d'en-tête :</p> + <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>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 + <p>Notez que des problèmes de performances peuvent affecter votre + serveur, car l'empreinte est générée pour chaque requête (il n'y a pas de mise en cache).</p> - <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les - documents servis par le module <code class="module"><a href="../mod/core.html">core</a></code>, à l'exclusion + <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> + 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>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#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>Disponible depuis de la version 2.4.2 du serveur HTTP +<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>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 + 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>La valeur par défaut de la directive - <code class="directive">DefaultRuntimeDir</code> peut être modifiée en + <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> + définie à la compilation.</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> + é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>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 +<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>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é. +<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>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#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>Tous les arguments, excepté <code>none</code>, sont -DESACTIVÉS à partir de la version 2.3.0.</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>Cette directive a été désactivée. Pour la compatibilité + <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> + ê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> n'est disponible que dans les - versions d'Apache 2.2.7 et supérieures.</p> + versions d'Apache 2.2.7 et supérieures.</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 + 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> + 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> </div> <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>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#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>Avec un seul paramètre, l'effet de la directive - <code class="directive">Define</code> est identique à celui de l'argument + <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> + 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 + <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> + 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 @@ -880,21 +880,21 @@ DESACTIVÉS à partir de la version 2.3.0.</td></tr> DocumentRoot "/var/www/${servername}/htdocs"</pre> - <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> + <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> - <p>Si cette directive est définie au sein d'un bloc VirtualHost, les + <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> + ultérieure, au delà de tout bloc VirtualHost.</p> </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>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>> +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> @@ -902,17 +902,17 @@ sous-répertoires, et à leur contenu.</td></tr> </table> <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 + 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 @@ -923,22 +923,22 @@ sous-répertoires, et à leur contenu.</td></tr> </Directory></pre> - <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 + <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>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 + <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 + 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> Les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> - peuvent aussi être utilisées en ajoutant le caractère + 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}"> @@ -946,13 +946,13 @@ sous-répertoires, et à leur contenu.</td></tr> </Directory></pre> - <p>pourra correspondre à tout répertoire situé dans /www/ et dont le + <p>pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.</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 + 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 + court sont appliquées en premier, en s'intercalant avec les directives des fichiers <a href="#accessfilename">.htaccess</a>. Par exemple, avec</p> @@ -965,27 +965,27 @@ sous-répertoires, et à leur contenu.</td></tr> </Directory></pre> - <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte + <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte le chemin suivant :</p> <ul> <li>Aplication de la directive <code>AllowOverride None</code> - (qui désactive les fichiers <code>.htaccess</code>).</li> + (qui désactive les fichiers <code>.htaccess</code>).</li> <li>Application de la directive <code>AllowOverride - FileInfo</code> (pour le répertoire <code>/home</code>).</li> + FileInfo</code> (pour le répertoire <code>/home</code>).</li> <li>Application de toute directive <code>FileInfo</code> qui se - trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>, + 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>Les directives associées aux répertoires sous forme d'expressions + <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 + 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$"> @@ -994,44 +994,44 @@ sous-répertoires, et à leur contenu.</td></tr> <p>la section avec expression rationnelle ne sera prise en compte - qu'après les sections <code class="directive"><Directory></code> sans expression rationnelle + 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>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> + <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>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><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>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> + 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">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> +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>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#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> @@ -1040,42 +1040,42 @@ du système de fichiers correspondant à une expression rationnelle</td></tr> </table> <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> + 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>convient pour les sous-répertoires de <code>/www/</code> dont + <p>convient pour les sous-répertoires de <code>/www/</code> dont le nom se compose de trois chiffres.</p> - <div class="note"><h3>Compatibilité</h3> + <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 + 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 + répertoires qui correspondent à l'expression sont affectés par les directives contenues dans la section. </div> <div class="note"><h3>slash de fin</h3> - Cette directive s'applique aux requêtes pour des répertoires avec + 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. + particulière. </div> - <p>A partir de la version 2.4.8, les groupes nommés et les - références arrières sont extraits et enregistrés dans - l'environnement avec leur nom en majuscules et préfixé + <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> + 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> + é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 @@ -1085,12 +1085,12 @@ du système de fichiers correspondant à une expression rationnelle</td></tr> <h3>Voir aussi</h3> <ul> <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> +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> +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> @@ -1098,53 +1098,53 @@ combinent entre elles à la réception d'une requête</li> <table class="directive"> <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#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>Cette directive permet de définir le répertoire à partir duquel + <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> + 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>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>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>Le répertoire défini par la directive + <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">Mise en -correspondance des URLs avec le système de fichiers</a></li> +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>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> +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#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>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 + 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')"> @@ -1155,10 +1155,10 @@ requête à l'exécution</td></tr> </Else></pre> - <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 + <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> + requêtes comportant un en-tête <var>Host:</var>.</p> <h3>Voir aussi</h3> @@ -1166,9 +1166,9 @@ requête à l'exécution</td></tr> <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">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>, + <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> @@ -1176,10 +1176,10 @@ requête à l'exécution</td></tr> <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>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> +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#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> @@ -1187,8 +1187,8 @@ alors que la condition correspondant à la section <code class="directive"><a hre <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 + 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'"> @@ -1202,68 +1202,68 @@ alors que la condition correspondant à la section <code class="directive"><a hre </Else></pre> - <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> + <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">Les expressions dans le serveur HTTP -Apache</a>, pour une référence complète et d'autres exemples.</li> +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">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>, + <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>Utilise la projection en mémoire (Memory-Mapping) pour +<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#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#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>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> + <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>Sur certains systèmes multi-processeurs, la projection en - mémoire peut dégrader les performances du programme + <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 + <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>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> + <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>Pour les montages NFS, cette fonctionnalité peut être - explicitement désactivée pour les fichiers concernés en spécifiant + <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"> @@ -1278,54 +1278,54 @@ lire les fichiers pendant qu'ils sont servis</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#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>Par défaut à Off depuis la 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>Cette directive définit si le programme <code class="program"><a href="../programs/httpd.html">httpd</a></code> + <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 + 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 + 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> + <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>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>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 + 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, + <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> + noyau peut s'avérer incapable de servir un fichier de ce montage + réseau en passant par son propre cache.</li> </ul> - <p>Pour les configurations de serveur non sujettes à ce genre de - problème, vous pouvez activer cette fonctionnalité en - spécifiant :</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>Pour les montages réseau, cette fonctionnalité peut être - explicitement désactivée pour les fichiers concernés en spécifiant + <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"> @@ -1333,10 +1333,10 @@ fichiers aux clients</td></tr> </Directory></pre> <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="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 + définition de <code class="directive">EnableSendfile</code> que dans un contexte global. </p> @@ -1345,25 +1345,25 @@ fichiers aux clients</td></tr> <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>Interrompt la lecture de la configuration avec un message -d'erreur personnalisé</td></tr> +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#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> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>à partir de la version 2.3.9</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>Si une erreur peut être détectée dans la configuration, souvent + <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> + directive peut être utilisée pour générer un message d'erreur + personnalisé, et interrompre la lecture de la configuration. </p> <pre class="prettyprint lang-config"># Exemple -# vérification du chargement de mod_include +# vérification du chargement de mod_include <IfModule !include_module> Error "mod_include is required by mod_foo. Load it with LoadModule." </IfModule> -# vérification de la définition de SSL ou (exclusif) NOSSL +# 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." @@ -1384,59 +1384,59 @@ d'erreur personnalisé</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#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>Apache httpd peut traiter les problèmes et les erreurs de quatre - manières,</p> + <p>Apache httpd peut traiter les problèmes et les erreurs de quatre + manières,</p> <ol> <li>afficher un simple message d'erreur au contenu fixe</li> - <li>afficher un message personnalisé</li> + <li>afficher un message personnalisé</li> <li>rediriger en interne vers un <var>chemin d'URL</var> local pour traiter - le problème ou l'erreur</li> + le problème ou l'erreur</li> <li>rediriger vers une <var>URL</var> externe pour traiter - le problème ou l'erreur</li> + le problème ou l'erreur</li> </ol> - <p>La première option constitue le comportement par défaut; pour - choisir une des trois autres options, il faut configurer Apache à + <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> + 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> + <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, à + 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> + l'interprétation de toute expression. Exemples :</p> <pre class="prettyprint lang-config">ErrorDocument 500 http://foo.example.com/cgi-bin/tester ErrorDocument 404 /cgi-bin/bad_urls.pl ErrorDocument 401 /subscription_info.html -ErrorDocument 403 "Désolé, nous ne pouvons pas vous accorder l'accès aujourd'hui" +ErrorDocument 403 "Désolé, nous ne pouvons pas vous accorder l'accès aujourd'hui" ErrorDocument 403 Forbidden! ErrorDocument 403 /cgi-bin/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}}</pre> - <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 + <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 @@ -1446,114 +1446,114 @@ ErrorDocument 403 /cgi-bin/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}}</pre> </Directory></pre> - <p>Notez que lorsque vous spécifiez une directive + <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 + (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 + 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 + 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 + 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> + 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 + <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 + 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 + 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 + 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> + 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 sur la -personnalisation des réponses</a></li> +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>Définition du chemin du journal des erreurs</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>chemin fichier</var>|syslog[:<var>facility</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#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>La directive <code class="directive">ErrorLog</code> permet de définir le + <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>chemin fichier</var> n'est pas - absolu, il est considéré comme relatif au chemin défini par la + 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>Si le <var>chemin fichier</var> commence par une barre verticale - "<code>(|)</code>", il est considéré comme une commande à lancer pour traiter la + "<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>Voir les notes à propos des <a href="../logs.html#piped">journaux - redirigés</a> pour plus d'informations.</p> + <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 + <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</p> + global, et si il est modifié dans un serveur virtuel, le dispositif + final spécifié affecte l'ensemble du serveur</p> <pre class="prettyprint lang-config">ErrorLog syslog:user</pre> - <p>Des modules additionnels peuvent implémenter leur propre - fournisseur ErrorLog. La syntaxe est similaire à l'exemple + <p>Des modules additionnels peuvent implémenter leur propre + fournisseur ErrorLog. La syntaxe est similaire à l'exemple <code>syslog</code> ci-dessus.</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> + <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>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 + <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> @@ -1567,89 +1567,89 @@ personnalisation des réponses</a></li> <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>Spécification du format des entrées du journal des erreurs</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>La directive <code class="directive">ErrorLogFormat</code> permet de - spécifier quelles informations supplémentaires vont être enregistrées + spécifier quelles informations supplémentaires vont être enregistrées dans le journal des erreurs en plus du message habituel.</p> <pre class="prettyprint lang-config"># Exemple simple ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> - <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 + <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 + 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, + 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> + 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 + 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 + 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> + 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> + <table class="bordered"><tr class="header"><th>Item modifié</th><th>Signification</th></tr> <tr> <td><code>%-{Referer}i</code></td> - <td>Enregistre le caractère <code>-</code> si l'en-tête - <code>Referer</code> n'est pas défini.</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>N'enregistre rien si l'en-tête - <code>Referer</code> n'est pas défini.</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>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> + <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>Certains items de format acceptent des paramètres supplémentaires + <p>Certains items de format acceptent des paramètres supplémentaires entre accolades.</p> - <table class="bordered"><tr class="header"><th>Chaîne de format</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>Le signe pourcentage</td></tr> <tr class="odd"><td><code>%a</code></td> @@ -1661,38 +1661,38 @@ ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> <tr class="odd"><td><code>%A</code></td> <td>Adresse IP et port locaux</td></tr> <tr><td><code>%{<em>name</em>}e</code></td> - <td>Variable d'environnement de requête <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>Etat d'erreur APR/OS et chaîne</td></tr> + <td>Etat d'erreur APR/OS et chaîne</td></tr> <tr><td><code>%F</code></td> - <td>Nom du fichier source et numéro de ligne de l'appel du + <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>En-tête de requête <em>name</em></td></tr> + <td>En-tête de requête <em>name</em></td></tr> <tr><td><code>%k</code></td> - <td>Nombre de requêtes persistantes pour cette connexion</td></tr> + <td>Nombre de requêtes persistantes pour cette connexion</td></tr> <tr class="odd"><td><code>%l</code></td> - <td>Sévérité du message</td></tr> + <td>Sévérité du message</td></tr> <tr><td><code>%L</code></td> - <td>Identifiant journal de la requête</td></tr> + <td>Identifiant journal de la requête</td></tr> <tr class="odd"><td><code>%{c}L</code></td> <td>Identifiant journal de la connexion</td></tr> <tr><td><code>%{C}L</code></td> - <td>Identifiant journal de la connexion si utilisé dans la - portée de la connexion, vide sinon</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>Nom du module qui effectue la journalisation du message</td></tr> <tr><td><code>%M</code></td> <td>Le message effectif</td></tr> <tr class="odd"><td><code>%{<em>name</em>}n</code></td> - <td>Note de requête <em>name</em></td></tr> + <td>Note de requête <em>name</em></td></tr> <tr><td><code>%P</code></td> <td>Identifiant du processus courant</td></tr> <tr class="odd"><td><code>%T</code></td> <td>Identifiant du thread courant</td></tr> <tr><td><code>%{g}T</code></td> - <td>Identifiant unique de thread système du thread courant - (l'identifiant affiché par la commande <code>top</code> par + <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>L'heure courante</td></tr> @@ -1704,27 +1704,27 @@ ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> <tr><td><code>%v</code></td> <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>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> + <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> + <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> + <td>Délimiteur de champ (aucune sortie)</td></tr> </table> - <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 + <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> + 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> + <pre class="prettyprint lang-config"># Exemple (format par défaut pour les MPMs threadés) +ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> <p>Cet exemple renverrait un message d'erreur du style :</p> @@ -1733,14 +1733,14 @@ ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ re [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>Notez que, comme indiqué plus haut, certains champs sont - totalement supprimés s'ils n'ont pas été définis.</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"># Exemple (similaire au format 2.2.x) -ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> +ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre> - <pre class="prettyprint lang-config"># Exemple avancé avec identifiants journal de requête/connexion + <pre class="prettyprint lang-config"># Exemple avancé avec identifiants journal de requête/connexion ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M" ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T" ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" @@ -1759,36 +1759,36 @@ ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre> <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>Extrait des informations d'état étendues pour chaque -requête</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>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 + <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> + 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>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> + <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> @@ -1796,76 +1796,76 @@ requête</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="fileetag" id="fileetag">Directive</a> <a name="FileETag" id="FileETag">FileETag</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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#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>La valeur par défaut était "INode MTime Size" -dans les versions 2.3.14 et antérieures.</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> - 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 + 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 + 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 : + 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>Le numéro d'i-node du fichier sera inclus dans le processus de - génération</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>La date et l'heure auxquelles le fichier a été modifié la - dernière fois seront incluses</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>La taille du fichier en octets sera incluse</dd> <dt><strong>All</strong></dt> - <dd>Tous les champs disponibles seront utilisés. Cette définition - est équivalente à : + <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>Si le document se compose d'un fichier, aucun champ - <code>ETag</code> ne sera inclus dans la réponse</dd> + <code>ETag</code> ne sera inclus dans la réponse</dd> </dl> - <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>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 + <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 à + 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>Avertissement</h3> - Ne modifiez pas les valeurs par défaut pour les répertoires ou - localisations où WebDAV est activé et qui utilisent + 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 + 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>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 + <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> @@ -1877,56 +1877,56 @@ dans les versions 2.3.14 et antérieures.</td></tr> <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>Contient des directives qui s'appliquent aux fichiers -précisés</td></tr> +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#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>La directive <code class="directive"><Files></code> limite - la portée des directives qu'elle contient aux fichiers précisés. + 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é. + 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 + 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 + 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> + 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"> - # Insérer ici des directives qui s'appliquent au fichier cat.html + # Insérer ici des directives qui s'appliquent au fichier cat.html </Files> <Files "?at.*"> - # Les directives insérées ici s'appliqueront aux fichiers + # Les directives insérées ici s'appliqueront aux fichiers # cat.html, bat.html, hat.php, et ainsi de suite. </Files></pre> <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la - caractère <code>~</code>. Par exemple :</p> + caractère <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Files ~ "\.(gif|jpe?g|png)$"> #... </Files></pre> - <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>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>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 + <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 + contrôler l'accès à leurs propres ressources, fichier par fichier.</p> @@ -1934,25 +1934,25 @@ précisés</td></tr> <ul> <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> +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>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#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#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>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 + 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> @@ -1961,23 +1961,23 @@ spécifiés sous la forme d'expressions rationnelles</td></tr> </FilesMatch></pre> - <p>correspondrait à la plupart des formats graphiques de + <p>correspondrait à la plupart des formats graphiques de l'Internet.</p> - <div class="note">Les caractères <code>.+</code> au début de l'expression + <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>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é + <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> + 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> + é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>[^/]+)"> require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example @@ -1988,26 +1988,26 @@ spécifiés sous la forme d'expressions rationnelles</td></tr> <ul> <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> +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>Force le type de médium spécifié dans le champ d'en-tête +<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#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>Lorsqu'elle est placée dans un fichier <code>.htaccess</code> ou + <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 + 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> @@ -2015,53 +2015,53 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> <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 + 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>Vous pouvez aussi annuler toute définition plus générale de + <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> + <code>None</code> à l'argument <var>type médium</var> :</p> - <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers à image/gif: + <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers à image/gif: <Location "/images"> ForceType image/gif </Location> -# mais utilise les méthodes classiques d'attribution du type MIME -# dans le sous-répertoire suivant : +# 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>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 + <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> + 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>Si aucun gestionnaire n'est explicitement défini pour une - requête, le type de contenu spécifié sera aussi utilisé comme nom de + <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>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. + 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>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. + 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>Dans la mesure du possible, il est conseillé d'éviter les + <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 + 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> + l'accès à cette directive.</p> </div> @@ -2069,19 +2069,19 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="gprofdir" id="gprofdir">Directive</a> <a name="GprofDir" id="GprofDir">GprofDir</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire dans lequel écrire les données de profiling +<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>Lorsque le serveur a été compilé avec le support du profiling + <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> + 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>Cette directive ne fonctionne actuellement qu'avec le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>.</p> @@ -2093,50 +2093,50 @@ gmon.out.</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#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>Cette directive active la recherche DNS afin de pouvoir - journaliser les nom d'hôtes (et les passer aux programmes CGI et aux + 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 + <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 + 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 + <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 à + <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> + 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> + <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> @@ -2144,58 +2144,58 @@ clients</td></tr> <table class="directive"> <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> +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#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>La directive <code class="directive"><If></code> évalue une - expression à la volée, et applique les directives qu'elle contient + <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>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 + <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> + à 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>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 + <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> + propriétés. La documentation complète est disponible dans <a href="../expr.html">Les expressions dans le serveur HTTP Apache</a>.</p> <p>Cette section de configuration ne peut contenir que des - directives qui supportent le <a href="directive-dict.html#Context">contexte de répertoire</a>.</p> + directives qui supportent le <a href="directive-dict.html#Context">contexte de répertoire</a>.</p> <div class="warning"> 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>. + 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">Les expressions dans le serveur HTTP -Apache</a>, pour une référence complète et d'autres exemples.</li> +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">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 +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> @@ -2203,44 +2203,44 @@ directives <code class="directive"><If></code>, <code class="directive">&l <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>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>> ... +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#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>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 + 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> + se trouve entre les balises de début et de fin est ignoré.</p> - <p><var>test</var> peut se présenter sous deux formes :</p> + <p><var>test</var> peut se présenter sous deux formes :</p> <ul> - <li><var>nom paramètre</var></li> + <li><var>nom paramètre</var></li> - <li><code>!</code><var>nom paramètre</var></li> + <li><code>!</code><var>nom paramètre</var></li> </ul> - <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 + <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> + paramètre</var> n'est <strong>pas</strong> défini.</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 + <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>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> + 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> @@ -2263,23 +2263,23 @@ test retourne "vrai" au démarrage du serveur</td></tr> <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>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> +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#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>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 + <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> + qui se trouve entre les balises de début et de fin est ignoré.</p> - <p><var>test</var> peut se présenter sous deux formes :</p> + <p><var>test</var> peut se présenter sous deux formes :</p> <ul> <li><var>module</var></li> @@ -2287,29 +2287,29 @@ module</var>> ... </IfModule></code></td></tr> <li>!<var>module</var></li> </ul> - <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é + <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> + 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 + utilisez le nom du fichier qui contient la chaîne de caractères <code>STANDARD20_MODULE_STUFF</code>.</p> <p>Les sections <code class="directive"><IfModule></code> - peuvent être imbriquées, ce qui permet d'implémenter des tests + peuvent être imbriquées, ce qui permet d'implémenter des tests multi-modules simples.</p> - <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 + <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> @@ -2318,39 +2318,39 @@ module</var>> ... </IfModule></code></td></tr> <table class="directive"> <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#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>Utilisation des caractères -génériques dans la partie chemin depuis la version 2.3.6</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>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 + <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 + 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 + 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> + 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> + <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>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> @@ -2358,23 +2358,23 @@ génériques dans la partie chemin depuis la version 2.3.6</td></tr> Include /usr/local/apache2/conf/vhosts/*.conf</pre> - <p>ou encore, avec des chemins relatifs au répertoire défini par la + <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>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 + <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>Par contre, dans l'exemple suivant, la directive sera simplement - ignorée si aucun sous-répertoire de conf/vhosts ne contient au + 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> @@ -2392,19 +2392,19 @@ Include conf/vhosts/*.conf</pre> <table class="directive"> <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> +<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>Disponible à partir de la version 2.3.6 du serveur HTTP +<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>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> + 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> @@ -2418,36 +2418,36 @@ Apache</td></tr> <table class="directive"> <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#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>L'extension Keep-Alive de HTTP/1.0 et l'implémentation des + <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 + 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> + 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 + 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 + 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 + 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 + 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 + 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> + 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> @@ -2457,57 +2457,57 @@ Apache</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="keepalivetimeout" id="keepalivetimeout">Directive</a> <a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle le serveur va attendre une requête +<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>nombre</var>[ms]</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#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>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> + 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>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> + <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>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>] ... > ... +<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#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>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 + <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 + 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> @@ -2515,38 +2515,38 @@ certaines méthodes HTTP</td></tr> </Limit></pre> - <p>La liste des noms de méthodes peut contenir une ou plusieurs + <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> + <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">Une section <code class="directive"><LimitExcept></code> doit toujours être préférée à + <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> + 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>Les directives <code class="directive"><Limit></code> et <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> - 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> + 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 + <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> + 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 + 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> + editors</code> sera ignorée dans tous les cas :</p> <pre class="prettyprint lang-config"><LimitExcept GET> Require valid-user @@ -2560,25 +2560,25 @@ certaines méthodes HTTP</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitexcept" id="limitexcept">Directive</a> <a name="LimitExcept" id="LimitExcept"><LimitExcept></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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>] ... > ... +<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#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> 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 + 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 + 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> + de détails.</p> <p>Par exemple :</p> @@ -2592,33 +2592,33 @@ sauf celles qui sont spécifiées</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a> <a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le nombre maximal de redirections internes et de -sous-requêtes imbriquées</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#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>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> + 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> + 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> + é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> @@ -2627,50 +2627,50 @@ sous-requêtes imbriquées</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestbody" id="limitrequestbody">Directive</a> <a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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#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>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>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 + 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 + 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> + 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 + 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>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 + <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> @@ -2679,37 +2679,37 @@ envoyée par le client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitrequestfields" id="limitrequestfields">Directive</a> <a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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#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>nombre</var> est un entier de 0 (nombre de champs illimité) - à 32767. La valeur par défaut est définie à la compilation par la + <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 à + <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 + 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 + 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> + 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 + 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> @@ -2718,8 +2718,8 @@ requête HTTP</td></tr> <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 + <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> @@ -2728,44 +2728,44 @@ requête HTTP</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="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>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#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#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>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>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, + à 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 + 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> + 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">Dans des conditions normales, la valeur par défaut de cette - directive ne doit pas être modifiée.</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>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 + <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> @@ -2774,32 +2774,32 @@ requête HTTP</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="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>Définit la taille maximale d'une ligne de requête +<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#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>Cette directive permet de définir la taille maximale autorisée - pour une ligne de requête HTTP en <var>octets</var>.</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 + <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> + 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> + 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> @@ -2807,11 +2807,11 @@ HTTP</td></tr> <div class="note">Dans des conditions normales, cette directive doit conserver - sa valeur par défaut.</div> + sa valeur par défaut.</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 + <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> @@ -2821,18 +2821,18 @@ HTTP</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a> <a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale du corps d'une requête au format +<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#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>Taille maximale (en octets) du corps d'une requête au format XML. + <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> + imposée.</p> <p>Exemple :</p> @@ -2845,7 +2845,7 @@ XML</td></tr> <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>N'applique les directives contenues qu'aux URLs -spécifiées</td></tr> +spécifiées</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Location <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> @@ -2853,52 +2853,52 @@ spécifiées</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <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 + 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> + 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 + 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> + 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>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>Le chemin spécifié correspond exactement à la partie chemin de + <li>Le chemin spécifié correspond exactement à la partie chemin de l'URL. </li> - <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 + <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>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 + <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> - 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. + 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> - 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. + 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>"> # ... @@ -2907,30 +2907,30 @@ spécifiées</td></tr> <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> + <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>Pour toutes les requêtes originales (non mandatées), l'argument + <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>/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> + le préfixe.</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 + <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>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 + rationnelles</a>, moyennant l'addition d'un caractère <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Location ~ "/(extra|special)/data"> @@ -2938,18 +2938,18 @@ spécifiées</td></tr> </Location></pre> - <p>concernerait les URLs contenant les sous-chaîne + <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 + 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 + 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>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 + requêtes d'état, mais ne les autoriser que depuis des navigateurs appartenant au domaine <code>example.com</code>, vous pouvez utiliser :</p> @@ -2959,27 +2959,27 @@ spécifiées</td></tr> </Location></pre> - <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 à + <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 + 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> + 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 + 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> @@ -2987,15 +2987,15 @@ spécifiées</td></tr> <ul> <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> +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>N'applique les directives contenues qu'aux URLs -correspondant à une expression rationnelle</td></tr> +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> @@ -3003,36 +3003,36 @@ correspondant à une expression rationnelle</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <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> + 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>correspondrait à toute URL contenant les sous-chaînes + <p>correspondrait à toute URL contenant les sous-chaînes <code>/extra/data</code> ou <code>/special/data</code>.</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 + <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>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é + <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> + 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> + é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 @@ -3043,30 +3043,30 @@ correspondant à une expression rationnelle</td></tr> <ul> <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> +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>Contrôle la verbosité du journal des erreurs</td></tr> +<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#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>La configuration du niveau de journalisation par module -et par répertoire est disponible depuis la version 2.3.6 du serveur HTTP +<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>La directive <code class="directive">LogLevel</code> permet d'ajuster la - verbosité des messages enregistrés dans les journaux d'erreur (voir + 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> + directive). Les <var>niveau</var>x disponibles sont présentés + ci-après, par ordre de criticité décroissante :</p> <table class="bordered"> @@ -3081,7 +3081,7 @@ Apache</td></tr> <tr> <td><code>emerg</code> </td> - <td>Urgences - le système est inutilisable.</td> + <td>Urgences - le système est inutilisable.</td> <td>"Child cannot open lock file. Exiting"</td> </tr> @@ -3089,7 +3089,7 @@ Apache</td></tr> <tr> <td><code>alert</code> </td> - <td>Des mesures doivent être prises immédiatement.</td> + <td>Des mesures doivent être prises immédiatement.</td> <td>"getpwuid: couldn't determine user name from uid"</td> </tr> @@ -3122,7 +3122,7 @@ Apache</td></tr> <tr> <td><code>notice</code> </td> - <td>Evènement important mais normal.</td> + <td>Evènement important mais normal.</td> <td>"httpd: caught SIGBUS, attempting to dump core in ..."</td> @@ -3140,7 +3140,7 @@ Apache</td></tr> <tr> <td><code>debug</code> </td> - <td>Messages de débogage.</td> + <td>Messages de débogage.</td> <td>"Opening config file ..."</td> </tr> @@ -3189,29 +3189,29 @@ Apache</td></tr> <tr> <td><code>trace7</code> </td> - <td>Messages de traces, enregistrement d'une grande quantité de - données</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>Messages de traces, enregistrement d'une grande quantité de - données</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>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é, + <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> + seront aussi émis.</p> - <p>Il est recommandé d'utiliser un niveau <code>crit</code> ou - inférieur.</p> + <p>Il est recommandé d'utiliser un niveau <code>crit</code> ou + inférieur.</p> <p>Par exemple :</p> @@ -3220,18 +3220,18 @@ Apache</td></tr> <div class="note"><h3>Note</h3> <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 + 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>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 + <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> + trois spécifications suivantes sont donc équivalentes :</p> <pre class="prettyprint lang-config">LogLevel info ssl:warn LogLevel info mod_ssl.c:warn @@ -3239,7 +3239,7 @@ LogLevel info ssl_module:warn</pre> <p>Il est aussi possible d'attribuer un niveau de journalisation par - répertoire :</p> + répertoire :</p> <pre class="prettyprint lang-config">LogLevel info <Directory "/usr/local/apache/htdocs/app"> @@ -3248,12 +3248,12 @@ LogLevel info ssl_module:warn</pre> <div class="note"> - 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>. + 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> @@ -3267,36 +3267,36 @@ LogLevel info ssl_module:warn</pre> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>Surcharge la verbosité du journal des erreurs pour certains +<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>non définie</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>Disponible à partir de la version 2.5.0 du serveur HTTP +<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>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 + 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 + 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> + 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>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 + 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>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>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>Exemples:</p> @@ -3306,8 +3306,8 @@ Apache.</td></tr> <div class="note"> 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. + messages associés à la requête ou à la connexion. Les messages + associés au serveur ne sont pas affectés. </div> @@ -3319,19 +3319,19 @@ Apache.</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="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>Nombre de requêtes permises pour une connexion +<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#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>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 + 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>Par exemple :</p> @@ -3343,246 +3343,246 @@ persistante</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a> <a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de chevauchements de segments de données autorisé +<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> + 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#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>Disponible depuis la version 2.3.15 du serveur HTTP +<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>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> + 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>Limite le nombre de chevauchements de segments à la valeur - par défaut 20 définie à la compilation.</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>Aucun chevauchement de segment n'est autorisé.</dd> + <dd>Aucun chevauchement de segment n'est autorisé.</dd> <dt><strong>unlimited</strong></dt> - <dd>Le nombre de chevauchements de segments est illimité.</dd> + <dd>Le nombre de chevauchements de segments est illimité.</dd> <dt><var>number-of-ranges</var></dt> - <dd>Un nombre positif représente le nombre maximal de - chevauchements de segments autorisé par le serveur.</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>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#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#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>Disponible depuis la version 2.3.15 du serveur HTTP +<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>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> + 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>Limite le nombre d'inversions à la valeur - par défaut 20 définie à la compilation.</dd> + <dd>Limite le nombre d'inversions à la valeur + par défaut 20 définie à la compilation.</dd> <dt><strong>none</strong></dt> - <dd>Aucune inversion n'est autorisée.</dd> + <dd>Aucune inversion n'est autorisée.</dd> <dt><strong>unlimited</strong></dt> - <dd>Le nombre d'inversions est illimité.</dd> + <dd>Le nombre d'inversions est illimité.</dd> <dt><var>number-of-ranges</var></dt> - <dd>Un nombre positif représente le nombre maximal - d'inversions autorisé par le serveur.</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>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#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#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>Disponible depuis la version 2.3.15 du serveur HTTP +<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>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> + 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> <dt><strong>default</strong></dt> - <dd>Limite le nombre de segments de données à 200 (valeur par - défaut définie à la compilation).</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>Les en-têtes Range sont ignorés.</dd> + <dd>Les en-têtes Range sont ignorés.</dd> <dt><strong>unlimited</strong></dt> - <dd>Le nombre de segments de données est illimité.</dd> + <dd>Le nombre de segments de données est illimité.</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> + <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>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#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#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>Disponible à partir de la version 2.4.11 du serveur HTTP +<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>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> + <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>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#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>Disponible depuis la version 2.3.4 du serveur HTTP Apache</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>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 + <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>La directive <code class="directive">Mutex</code> est typiquement - utilisée dans les situations exceptionnelles suivantes :</p> + utilisée dans les situations exceptionnelles suivantes :</p> <ul> - <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>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>choix d'un autre répertoire utilisé par les mutex à base de - fichier lorsque le répertoire par défaut ne supporte pas le + <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>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 + <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> + 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>Les <em>mécanismes</em> de mutex disponibles sont les suivants :</p> + <p>Les <em>mécanismes</em> de mutex disponibles sont les suivants :</p> <ul> <li><code>default | yes</code> - <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 + <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>Le mutex est désactivé, et cette valeur n'est permise pour un + <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>Une variante de mutex basée sur un sémaphore Posix.</p> + <p>Une variante de mutex basée sur un sémaphore Posix.</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, + <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>Une variante de mutex basée sur un sémaphore IPC SystemV.</p> + <p>Une variante de mutex basée sur un sémaphore IPC SystemV.</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> + <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>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 + <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>Sélection de la "meilleure" implémentation des sémaphores - disponible ; le choix s'effectue entre les sémaphores posix et + <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>Une variante de mutex à base de mutex de thread Posix + <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>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 + 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> + pouvoir utiliser l'option <code>pthread</code> sans problème.</p> </div> </li> @@ -3591,99 +3591,99 @@ verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr> la fonction <code>fcntl()</code>.</p> <div class="warning"><h3>Avertissement</h3> - <p>Lorsqu'on utilise plusieurs mutex basés sur ce mécanisme dans + <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 + 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:/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> + <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:/chemin/vers/mutex</code> - <p>Sélection de la "meilleure" implémentation de verrouillage + <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>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 + <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 + <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 + 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 + 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 + 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>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 + <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> + 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>La table suivante décrit les noms de mutex utilisés par httpd et - ses modules associés.</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>Nom mutex</th> <th>Module(s)</th> - <th>Ressource protégée</th> + <th>Ressource protégée</th> </tr> <tr> <td><code>mpm-accept</code></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 + <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>liste de clients en mémoire partagée</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>compteur en mémoire partagée</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>cache de résultat de recherche LDAP</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 avec des programmes externes - d'associations de valeurs, afin d'éviter les interférences - d'entrées/sorties entre plusieurs requêtes</td> + 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> @@ -3693,7 +3693,7 @@ verrou pour tous les mutex ou seulement les mutex spécifiés</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>cache de l'étiquetage OCSP ("OCSP stapling")</td> + <td>cache de l'étiquetage OCSP ("OCSP stapling")</td> </tr> <tr class="odd"> <td><code>watchdog-callback</code></td> @@ -3702,15 +3702,15 @@ verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr> </tr> </table> - <p>Le mot-clé <code>OmitPID</code> permet d'empêcher l'addition de + <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>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 + <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 @@ -3721,7 +3721,7 @@ 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>OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de +<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> @@ -3729,13 +3729,13 @@ nom</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Avant la version 2.3.11, il était nécessaire de définir une + <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> + 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> @@ -3748,45 +3748,45 @@ virtuels</a></li> <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>Définit les fonctionnalités disponibles pour un répertoire +<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#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</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#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>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>Avec la version 2.3.11, la valeur par défaut passe de All -à FollowSymlinks</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>La directive <code class="directive">Options</code> permet de définir - les fonctionnalités de serveur disponibles pour un répertoire + <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> peut être défini à <code>None</code>, auquel - cas aucune fonctionnalité spécifique n'est activée, ou comprendre + <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>Toutes les options excepté <code>MultiViews</code>.</dd> + <dd>Toutes les options excepté <code>MultiViews</code>.</dd> <dt><code>ExecCGI</code></dt> - <dd>L'exécution de scripts CGI à l'aide du module + <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> - Le serveur va suivre les liens symboliques dans le répertoire - concerné. Il s'agit de la valeur par défaut. + 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 + <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 @@ -3794,54 +3794,54 @@ particulier</td></tr> 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ù + <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> - 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> + 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> - Les inclusions côté serveur (SSI) sont permises, mais <code>#exec - cmd</code> et <code>#exec cgi</code> sont désactivés. + 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> + 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> - Si une URL requise correspond au répertoire concerné, et si aucun + 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> + 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> - 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> + 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>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 + 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> @@ -3850,32 +3850,32 @@ particulier</td></tr> 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ù + <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>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#mergin">comment les sections sont - fusionnées</a>). Elles le sont cependant si <em>toutes</em> les + <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#mergin">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> + 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>Mélanger des <code class="directive">Options</code> avec <code>+</code> + <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> + la vérification de la syntaxe au cours du démarrage du serveur fera + échouer ce dernier.</p> </div> <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code> @@ -3891,7 +3891,7 @@ particulier</td></tr> <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 + 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> @@ -3905,49 +3905,49 @@ particulier</td></tr> <p>alors, les options <code>FollowSymLinks</code> et - <code>Includes</code> seront prises en compte pour le répertoire + <code>Includes</code> seront prises en compte pour le répertoire <code>/web/docs/spec</code>.</p> <div class="note"><h3>Note</h3> <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> + <code>-Includes</code> désactive complètement les inclusions côté + serveur sans tenir compte des définitions précédentes.</p> </div> - <p>En l'absence de toute définition d'options, la valeur par défaut + <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>Protocole pour une socket d'écoute</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>Sous Windows, disponible à partir de la version 2.3.3 du +<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>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 + <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>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 + <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>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> + <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>Vous pouvez aussi spécifier le protocole via la directive + <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> @@ -3961,22 +3961,22 @@ serveur HTTP Apache.</td></tr> <table class="directive"> <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#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>Disponible à partir de la version 2.4.17 du serveur +<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>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 + <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>Par défaut, + <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 + 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>Par exemple, si vous voulez autoriser le protocole @@ -3991,13 +3991,13 @@ serveur HTTP Apache.</td></tr> https et <code>h2c</code> pour les connexions http. D'autres modules peuvent fournir d'autres protocoles.</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>Spécifier des protocoles non disponibles ou désactivés n'aura + aucun effet, et ceux-ci seront simplement ignorés.</p> - <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 + <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> @@ -4010,30 +4010,30 @@ serveur HTTP Apache.</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="protocolshonororder" id="protocolshonororder">Directive</a> <a name="ProtocolsHonorOrder" id="ProtocolsHonorOrder">ProtocolsHonorOrder</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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#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>Disponible à partir de la version 2.4.17 du serveur +<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>Cette directive permet de définir si le serveur doit tenir - compte de l'ordre des protocoles définis par la directive + <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>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 + <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>Si la directive <code class="directive">ProtocolsHonorOrder</code> - est définie à <code>on</code> (valeur par défaut), + 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> + définie au niveau du serveur influera la + négociation du protocole.</p> <h3>Voir aussi</h3> @@ -4044,79 +4044,79 @@ serveur HTTP Apache.</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="qualifyredirecturl" id="qualifyredirecturl">Directive</a> <a name="QualifyRedirectURL" id="QualifyRedirectURL">QualifyRedirectURL</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie si la variable d'environnement REDIRECT_URL est -pleinement qualifiée</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#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 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> +<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>Cette directive permet de s'assurer que le serveur vérifiera que + <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 + 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>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>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#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>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 +<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> +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>Limite le temps CPU alloué aux processus initiés par les +<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 +<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#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>Prend 1 ou 2 paramètres. Le premier definit la limite de + <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 + 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. + 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 + 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 + <p>Les limites de ressources CPU sont exprimées en secondes par processus.</p> <h3>Voir aussi</h3> @@ -4128,34 +4128,34 @@ d'exploitation</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>Limite la mémoire allouée aux processus initiés par les +<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 +<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#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>Prend 1 ou 2 paramètres. Le premier definit la limite de + <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 + 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. + 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 + 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 + <p>Les limites de ressources mémoire sont exprimées en octets par processus.</p> <h3>Voir aussi</h3> @@ -4167,40 +4167,40 @@ d'exploitation</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>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#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#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>Prend 1 ou 2 paramètres. Le premier definit la limite de + <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 + 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. + 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 + 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 + <p>Les limites des processus contrôlent le nombre de processus par utilisateur.</p> <div class="note"><h3>Note</h3> - <p>Si les processus CGI s'exécutent sous le même + <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 + 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> @@ -4214,28 +4214,28 @@ les processus initiés par les processus enfants d'Apache httpd</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a> <a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpréteur des scripts +<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#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 seulement</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Win32 seulement</td></tr> </table> - <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> + <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>ou simplement, dans le cas où <code>perl</code> est dans le + <p>ou simplement, dans le cas où <code>perl</code> est dans le <code>PATH</code> :</p> <pre class="prettyprint lang-perl">#!perl</pre> @@ -4244,66 +4244,66 @@ CGI</td></tr> <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 + 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 + 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> + <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 + 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 + 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>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> + 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>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#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#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>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), + 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> + 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>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 (défaut)</th> + <th>Off (défaut)</th> <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td> </tr> <tr> @@ -4317,31 +4317,31 @@ elle-même possède plus de 63 caractères.</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="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>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#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>La directive <code class="directive">ServerAdmin</code> permet de définir + <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 + 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 + 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> + 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 à + <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>car les utilisateurs ne mentionnent pas systématiquement le + <p>car les utilisateurs ne mentionnent pas systématiquement le serveur dont ils parlent !</p> </div> @@ -4349,17 +4349,17 @@ messages d'erreur envoyés au client</td></tr> <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>Autres noms d'un serveur utilisables pour atteindre des -serveurs virtuels à base de nom</td></tr> +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>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 + <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> + contenir des caractères génériques, si nécessaire.</p> <pre class="prettyprint lang-config"><VirtualHost *:80> ServerName server.example.com @@ -4369,16 +4369,16 @@ serveurs virtuels à base de nom</td></tr> # ... </VirtualHost></pre> - <p>La recherche du serveur virtuel à base de nom correspondant au - plus près à la requête s'effectue selon l'ordre d'apparition des + <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 + priorité particulière si le nom contient des caractères génériques (que ce soit pour ServerName ou ServerAlias).</p> - <p>Tous les noms spécifiés au sein d'une section - <code class="directive">VirtualHost</code> sont traités comme un - <code class="directive">ServerAlias</code> (sans caractères génériques).</p> + <p>Tous les noms spécifiés au sein d'une section + <code class="directive">VirtualHost</code> sont traités comme un + <code class="directive">ServerAlias</code> (sans caractères génériques).</p> <h3>Voir aussi</h3> @@ -4391,86 +4391,86 @@ du serveur HTTP Apache</a></li> <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>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#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>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 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">ServerAlias</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 + (éventuellement en conjonction avec la directive + <code class="directive">ServerAlias</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 + <p>Cette directive est aussi utilisée lors de la création d'URLs de redirection relatives quand la directive - <code class="directive">UseCanonicalName</code> est définie à une valeur autre que - la valeur par défaut.</p> + <code class="directive">UseCanonicalName</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 + 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 + 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>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>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> + 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 + <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 + <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 + s'assurer que le serveur génère correctement ses URLs d'auto-identification. </p> <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 + 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. + <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>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 + 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> + 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> @@ -4479,7 +4479,7 @@ s'authentifier lui-même</td></tr> <h3>Voir aussi</h3> <ul> -<li><a href="../dns-caveats.html">Problèmes concernant le DNS et +<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> @@ -4491,15 +4491,15 @@ du serveur HTTP Apache</a></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>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#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>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> + <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> @@ -4510,73 +4510,73 @@ du serveur HTTP Apache</a></li> <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>Racine du répertoire d'installation du +<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#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>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> + <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>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 + <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> + différente de celles listées ci-dessus.</p> <h3>Voir aussi</h3> <ul> <li><a href="../invoking.html">the <code>-d</code> 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 +<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>Définit un pied de page pour les documents générés par le +<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#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#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>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 + 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> + 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 + <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 + 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>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 + <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> @@ -4587,22 +4587,22 @@ serveur</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="servertokens" id="servertokens">Directive</a> <a name="ServerTokens" id="ServerTokens">ServerTokens</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-tête <code>Server</code> de la réponse +<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#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>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 + <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> (ou non spécifié)</dt> + <dt><code>ServerTokens Full</code> (ou non spécifié)</dt> <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.2 (Unix) PHP/4.2.2 MyMod/1.2</code></dd> @@ -4636,21 +4636,21 @@ HTTP</td></tr> </dl> - <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>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 + <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> + <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> @@ -4662,30 +4662,30 @@ HTTP</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="sethandler" id="sethandler">Directive</a> <a name="SetHandler" id="SetHandler">SetHandler</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers spécifiés par un +<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#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>Disponible à partir de la version 2.5 du serveur HTTP Apache</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>Lorsqu'elle se situe à l'intérieur d'un fichier + <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 + 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 + 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> + <code>.htaccess</code> de ce répertoire :</p> <pre class="prettyprint lang-config">SetHandler imap-file</pre> <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 + 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"> @@ -4694,32 +4694,32 @@ gestionnaire particulier</td></tr> <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> + 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>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> + <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" </FilesMatch></pre> - <p>Vous pouvez écraser la définition antérieure d'une directive + <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>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> + 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> @@ -4729,22 +4729,22 @@ gestionnaire particulier</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="setinputfilter" id="setinputfilter">Directive</a> <a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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#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>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 + 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>Si la directive comporte plusieurs filtres, ils doivent être - séparés par des points-virgules, et spécifiés selon l'ordre dans + <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> @@ -4755,31 +4755,31 @@ client et les données POST</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="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>Définit les filtres par lesquels vont passer les réponses +<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#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>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 + 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>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> + 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>Si la directive comporte plusieurs filtres, ils doivent être - séparés par des points-virgules, et spécifiés selon l'ordre dans + <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> @@ -4791,24 +4791,24 @@ du serveur</td></tr> <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>Temps pendant lequel le serveur va attendre certains -évènements avant de considérer qu'une requête a échoué</td></tr> +é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>secondes</var></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#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>La directive <code class="directive">TimeOut</code> permet de définir le - temps maximum pendant lequel Apache httpd va attendre des entrées/sorties + <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> <ol> - <li>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 + <li>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.</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 + <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>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 des @@ -4817,9 +4817,9 @@ du serveur</td></tr> <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>Avec <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, la valeur du délai par défaut + <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> + pas défini.</li> </ol> @@ -4827,38 +4827,38 @@ du serveur</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="traceenable" id="traceenable">Directive</a> <a name="TraceEnable" id="TraceEnable">TraceEnable</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le comportement des requêtes +<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#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>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 + <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 à 64k (plus 8k pour les en-têtes de + du corps de requête à 64k (plus 8k 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 à 64k.</p> + 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 à 64k.</p> <div class="note"><h3>Note</h3> - <p>Bien que certains prétendent le contraire, <code>TRACE</code> ne - constitue pas une vulnérabilité en matière de sécurité, et il n'y a - aucune raison suffisante pour le désactiver, ce qui rendrait + <p>Bien que certains prétendent le contraire, <code>TRACE</code> ne + constitue pas une vulnérabilité en matière de sécurité, et il n'y a + aucune raison suffisante pour le désactiver, ce qui rendrait votre serveur non conforme.</p> </div> @@ -4866,7 +4866,7 @@ du serveur</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="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>Invalide la définition d'une variable</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> @@ -4877,74 +4877,74 @@ du serveur</td></tr> 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 + 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> + ultérieure, au delà de tout bloc VirtualHost.</p> </div> <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>Définit la manière dont le serveur détermine son propre nom +<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#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>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 + <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 + 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 + 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> + seront affectées des valeurs fournies par le client.</p> - <p>Cette directive peut s'avérer utile, par exemple, sur un serveur + <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 + 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 + <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 à + 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 + <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 + 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 + 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 + <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 + 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> + auto-identifiantes, il ne devrait pas y avoir de problème.</p> </div> <h3>Voir aussi</h3> @@ -4957,24 +4957,24 @@ et son port</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur -détermine son propre 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#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>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 + <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 + 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> @@ -4984,18 +4984,18 @@ détermine son propre port</td></tr> <dt><code>UseCanonicalName On</code></dt> <dd> <ol> - <li>Port indiqué dans <code class="directive"><a href="#servername">Servername</a></code></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> + <li>Port par défaut</li> </ol> </dd> <dt><code>UseCanonicalName Off | DNS</code></dt> <dd> <ol> - <li>Port spécifié dans l'en-tête <code>Host:</code></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> + <li>Port spécifié par <code class="directive"><a href="#servername">Servername</a></code></li> + <li>Port par défaut</li> </ol> </dd> </dl> @@ -5015,8 +5015,8 @@ détermine son propre port</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="virtualhost" id="virtualhost">Directive</a> <a name="VirtualHost" id="VirtualHost"><VirtualHost></a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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#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>adresse IP</var>[:<var>port</var>] [<var>adresse IP</var>[:<var>port</var>]] ...> ... @@ -5027,26 +5027,26 @@ d'hôte spécifique ou à une adresse IP</td></tr> </table> <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 + 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> + 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>L'adresse IP du serveur virtuel ;</li> - <li>Un nom de domaine entièrement qualifié correspondant à - l'adresse IP du serveur virtuel (non recommandé) ;</li> + <li>Un nom de domaine entièrement qualifié correspondant à + l'adresse IP du serveur virtuel (non recommandé) ;</li> - <li>Le caractère <code>*</code>, qui agit comme un - caractère générique, et correspond à toute adresse IP.</li> + <li>Le caractère <code>*</code>, qui agit comme un + caractère générique, et correspond à toute adresse IP.</li> - <li>La chaîne <code>_default_</code>, dont la signification est - identique à celle du caractère <code>*</code></li> + <li>La chaîne <code>_default_</code>, dont la signification est + identique à celle du caractère <code>*</code></li> </ul> @@ -5060,9 +5060,9 @@ d'hôte spécifique ou à une adresse IP</td></tr> - <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>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> @@ -5074,93 +5074,93 @@ d'hôte spécifique ou à une adresse IP</td></tr> </VirtualHost></pre> - <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> + <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>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 + 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> + 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>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 + 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 + <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 + 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> + 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 + 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 + 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> + 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 + <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> + utilisateur que celui qui démarre le serveur.</p> </div> <h3>Voir aussi</h3> <ul> <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 +<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 +<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> +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>Message d'avertissement personnalisable en provenance de -l'interprétation du fichier de configuration</td></tr> +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#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> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5 du serveur HTTP +<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>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 + <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> + 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 +# signale que ReverseProxy n'est pas défini <IfDefine !ReverseProxy> - Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger - si nécessaire" + Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger + si nécessaire" </IfDefine> <IfDefine ReverseProxy> - # définition de la configuration personnalisée du mandataire + # définition de la configuration personnalisée du mandataire </IfDefine></pre> @@ -5170,10 +5170,10 @@ Apache.</td></tr> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/core.html" title="Français"> fr </a> | +<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/core.html" title="Français"> fr </a> | <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | -<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -5192,7 +5192,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/core.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/directive-dict.html b/docs/manual/mod/directive-dict.html index 0cf1a17bdc..0db515cdf5 100644 --- a/docs/manual/mod/directive-dict.html +++ b/docs/manual/mod/directive-dict.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: directive-dict.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: directive-dict.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/directive-dict.html.fr b/docs/manual/mod/directive-dict.html.fr index 88bc03eafd..879c824549 100644 --- a/docs/manual/mod/directive-dict.html.fr +++ b/docs/manual/mod/directive-dict.html.fr @@ -1,13 +1,13 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -<title>Termes utilisés pour la description des directives - Serveur Apache HTTP Version 2.5</title> +<title>Termes utilisés pour la description des directives - Serveur Apache HTTP Version 2.5</title> <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> @@ -21,82 +21,82 @@ <img alt="" src="../images/feather.gif" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> <div id="path"> -<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Termes utilisés pour la description des directives</h1> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Termes utilisés pour la description des directives</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/directive-dict.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | +<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | <a href="../ja/mod/directive-dict.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/directive-dict.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> - <p>Ce document décrit les termes utilisés pour décrire chaque <a href="directives.html">directive de configuration</a> d'Apache.</p> + <p>Ce document décrit les termes utilisés pour décrire chaque <a href="directives.html">directive de configuration</a> d'Apache.</p> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#Description">Description</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#Syntax">Syntaxe</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#Default">Défaut</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Default">Défaut</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#Context">Contexte</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#Override">Surcharge .htaccess</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#Status">Statut</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#Module">Module</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#Compatibility">Compatibilité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Compatibility">Compatibilité</a></li> </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../configuring.html">Fichiers de configuration</a></li></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="Description" id="Description">Description</a></h2> -<p>Une brève description des fonctions de cette directive.</p> +<p>Une brève description des fonctions de cette directive.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="Syntax" id="Syntax">Syntaxe</a></h2> <p>Ce terme introduit le format sous lequel la directive doit - apparaître dans le fichier de configuration. Cette syntaxe est très - spécifique à la directive et est décrite en détail dans la - définition de cette dernière. En général, le nom de la directive est - suivi d'un ou plusieurs arguments séparés par des espaces. Si un - argument contient un espace, il doit être entouré de guillemets. Les - arguments optionnels sont entourés de crochets. Lorsqu'un argument + apparaître dans le fichier de configuration. Cette syntaxe est très + spécifique à la directive et est décrite en détail dans la + définition de cette dernière. En général, le nom de la directive est + suivi d'un ou plusieurs arguments séparés par des espaces. Si un + argument contient un espace, il doit être entouré de guillemets. Les + arguments optionnels sont entourés de crochets. Lorsqu'un argument accepte une valeur parmi une liste de valeurs possibles, cette liste - est spécifiée en séparant les valeurs par une barre verticale "|". - Les textes littéraux sont présentés dans la fonte par défaut, alors + est spécifiée en séparant les valeurs par une barre verticale "|". + Les textes littéraux sont présentés dans la fonte par défaut, alors que les types d'argument pour lesquels une substitution est - nécessaire sont en <em>gras</em>. La syntaxe des directives + nécessaire sont en <em>gras</em>. La syntaxe des directives acceptant un nombre variable d'arguments se termine par "...", ce - qui indique que le dernier argument peut être répété.</p> + qui indique que le dernier argument peut être répété.</p> <p>Les directives utilisent un grand nombre de types d'arguments - différents. Les plus courants sont définis ci-dessous.</p> + différents. Les plus courants sont définis ci-dessous.</p> <dl> <dt><em>URL</em></dt> <dd>Un Localisateur de Ressource Uniforme (Uniform Resource - Locator) complet comportant un protocole, un nom d'hôte et un nom + Locator) complet comportant un protocole, un nom d'hôte et un nom de chemin optionnel comme dans <code>http://www.example.com/chemin/vers/fichier.html</code></dd> <dt><em>chemin-URL</em></dt> <dd>La partie de l'<em>url</em> qui suit le protocole et le nom - d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le - <em>chemin-URL</em> représente la ressource vue depuis le web, et est - différente de la représentation de cette même ressource vue depuis le - système de fichiers.</dd> + d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le + <em>chemin-URL</em> représente la ressource vue depuis le web, et est + différente de la représentation de cette même ressource vue depuis le + système de fichiers.</dd> <dt><em>chemin-fichier</em></dt> - <dd>Le chemin d'un fichier dans le système de fichiers local - commençant par le répertoire racine comme dans + <dd>Le chemin d'un fichier dans le système de fichiers local + commençant par le répertoire racine comme dans <code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>. Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence - pas par un slash sera considéré comme relatif au répertoire défini + pas par un slash sera considéré comme relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</dd> - <dt><em>chemin-répertoire</em></dt> + <dt><em>chemin-répertoire</em></dt> - <dd>Le chemin d'un répertoire dans le système de fichiers local - commençant par le répertoire racine comme dans + <dd>Le chemin d'un répertoire dans le système de fichiers local + commençant par le répertoire racine comme dans <code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd> <dt><em>nom-fichier</em></dt> @@ -107,127 +107,127 @@ <dt><em>regex</em></dt> <dd>Une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> - compatible Perl. La définition de la directive spécifiera à quoi - <em>regex</em> sera comparée.</dd> + compatible Perl. La définition de la directive spécifiera à quoi + <em>regex</em> sera comparée.</dd> <dt><em>extension</em></dt> - <dd>En général, c'est la partie du <em>nom de fichier</em> qui - suit le dernier point. Cependant, Apache reconnaît plusieurs + <dd>En général, c'est la partie du <em>nom de fichier</em> qui + suit le dernier point. Cependant, Apache reconnaît plusieurs extensions de noms de fichiers ; ainsi, si un <em>nom de fichier</em> contient plusieurs points, chacune des parties du nom de fichier - séparées par des points et situées après le premier point est une + séparées par des points et situées après le premier point est une <em>extension</em>. Par exemple, le <em>nom de fichier</em> <code>fichier.html.en</code> comporte deux extensions : <code>.html</code> et <code>.en</code>. Pour les directives - Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans + Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans le point initial. Enfin, les <em>extension</em>s ne sont pas - sensibles à la casse.</dd> + sensibles à la casse.</dd> <dt><em>MIME-type</em></dt> - <dd>Une méthode de description du format d'un fichier consistant - en un type de format majeur et un type de format mineur séparés + <dd>Une méthode de description du format d'un fichier consistant + en un type de format majeur et un type de format mineur séparés par un slash comme dans <code>text/html</code>.</dd> <dt><em>env-variable</em></dt> <dd>Le nom d'une <a href="../env.html">variable - d'environnement</a> définie au cours du processus de configuration - d'Apache. Notez qu'elle peut être différente d'une variable - d'environnement du système d'exploitation. Voir la <a href="../env.html">documentation sur les variables d'environnement</a> - pour plus de détails.</dd> + d'environnement</a> définie au cours du processus de configuration + d'Apache. Notez qu'elle peut être différente d'une variable + d'environnement du système d'exploitation. Voir la <a href="../env.html">documentation sur les variables d'environnement</a> + pour plus de détails.</dd> </dl> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="Default" id="Default">Défaut</a></h2> +<h2><a name="Default" id="Default">Défaut</a></h2> - <p>Si la directive possède une valeur par défaut (en d'autres + <p>Si la directive possède une valeur par défaut (en d'autres termes, si le serveur Web Apache se comporte comme si vous l'aviez - définie à une valeur particulière, alors que vous l'avez omise dans - votre configuration), elle est spécifiée ici. Si la directive ne - possède pas de valeur par défaut, cette section doit spécifier - "<em>Aucune</em>". Notez que la valeur par défaut dont il est - question n'est pas nécessairement la même que la valeur attribuée à - la directive dans le fichier httpd.conf par défaut distribué avec le + définie à une valeur particulière, alors que vous l'avez omise dans + votre configuration), elle est spécifiée ici. Si la directive ne + possède pas de valeur par défaut, cette section doit spécifier + "<em>Aucune</em>". Notez que la valeur par défaut dont il est + question n'est pas nécessairement la même que la valeur attribuée à + la directive dans le fichier httpd.conf par défaut distribué avec le serveur.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="Context" id="Context">Contexte</a></h2> <p>Indique les parties des fichiers de configuration du serveur - où cette directive est valide. Il s'agit d'une liste d'une ou - plusieurs des valeurs suivantes séparées par des virgules :</p> + où cette directive est valide. Il s'agit d'une liste d'une ou + plusieurs des valeurs suivantes séparées par des virgules :</p> <dl> <dt>configuration du serveur</dt> - <dd>Signifie que la directive peut être utilisée dans les fichiers + <dd>Signifie que la directive peut être utilisée dans les fichiers de configuration du serveur (par exemple <code>httpd.conf</code>), - mais <strong>pas</strong> à l'intérieur d'un conteneur <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ou <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>. De même, elle + mais <strong>pas</strong> à l'intérieur d'un conteneur <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ou <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>. De même, elle n'est pas valide dans les fichiers <code>.htaccess</code>.</dd> <dt>serveur virtuel</dt> - <dd>Signifie que la directive peut apparaître à l'intérieur d'un + <dd>Signifie que la directive peut apparaître à l'intérieur d'un conteneur <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> dans les fichiers de configuration du serveur.</dd> - <dt>répertoire</dt> + <dt>répertoire</dt> - <dd>Une directive spécifiée comme valide dans ce contexte peut - être utilisée à l'intérieur de conteneurs <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, <code class="directive"><a href="../mod/core.html#if"><If></a></code>, et <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> dans les + <dd>Une directive spécifiée comme valide dans ce contexte peut + être utilisée à l'intérieur de conteneurs <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, <code class="directive"><a href="../mod/core.html#if"><If></a></code>, et <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> dans les fichiers de configuration du serveur, en tenant compte des - restrictions précisées dans la documentation sur les <a href="../sections.html">Sections de configuration</a>.</dd> + restrictions précisées dans la documentation sur les <a href="../sections.html">Sections de configuration</a>.</dd> <dt>.htaccess</dt> <dd>Si une directive est valide dans ce contexte, cela signifie - qu'elle peut apparaître à l'intérieur de fichiers de configuration - de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou - ne sera pas traitée, selon la définition de l'option <a href="#Override">overrides</a> pour le contexte courant.</dd> + qu'elle peut apparaître à l'intérieur de fichiers de configuration + de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou + ne sera pas traitée, selon la définition de l'option <a href="#Override">overrides</a> pour le contexte courant.</dd> </dl> - <p>La directive n'est autorisée <em>que</em> dans le contexte - désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une - erreur de configuration qui va soit empêcher le serveur de traiter - les requêtes correctement dans ce contexte, soit tout simplement - empêcher le serveur de fonctionner -- en d'autres termes, le serveur - refusera de démarrer.</p> + <p>La directive n'est autorisée <em>que</em> dans le contexte + désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une + erreur de configuration qui va soit empêcher le serveur de traiter + les requêtes correctement dans ce contexte, soit tout simplement + empêcher le serveur de fonctionner -- en d'autres termes, le serveur + refusera de démarrer.</p> - <p>Les lieux de définition valides pour une directive résultent en + <p>Les lieux de définition valides pour une directive résultent en fait d'un - OU logique de tous les contextes spécifiés. En d'autres termes, une - directive spécifiée comme valide dans "<code>configuration du - serveur, .htaccess</code>" peut être utilisée dans le fichier + OU logique de tous les contextes spécifiés. En d'autres termes, une + directive spécifiée comme valide dans "<code>configuration du + serveur, .htaccess</code>" peut être utilisée dans le fichier <code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>, mais pas dans un conteneur <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="Override" id="Override">Surcharge .htaccess</a></h2> - <p>Ce terme indique quelle autorisation de surcharge doit être - active pour que la directive puisse être traitée lorsqu'elle - apparaît dans un fichier <code>.htaccess</code>. Si le <a href="#Context">context</a> de la directive ne lui permet pas - d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte - ne sera spécifié.</p> - - <p>Les autorisations de surcharge sont activées via la directive - <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, et possèdent une - portée particulière, comme un répertoire et tous ses - sous-répertoires, sauf si une autre directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> apparaît à un niveau - inférieur. La documentation pour cette directive spécifie aussi les + <p>Ce terme indique quelle autorisation de surcharge doit être + active pour que la directive puisse être traitée lorsqu'elle + apparaît dans un fichier <code>.htaccess</code>. Si le <a href="#Context">context</a> de la directive ne lui permet pas + d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte + ne sera spécifié.</p> + + <p>Les autorisations de surcharge sont activées via la directive + <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, et possèdent une + portée particulière, comme un répertoire et tous ses + sous-répertoires, sauf si une autre directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> apparaît à un niveau + inférieur. La documentation pour cette directive spécifie aussi les noms d'autorisations de surcharge disponibles.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="Status" id="Status">Statut</a></h2> - <p>Cet attribut indique le degré de rapprochement de la directive du - coeur d'Apache ; en d'autres termes, vous pouvez être amené à - recompiler le serveur avec un jeu de modules supplémentaires pour - pouvoir utiliser la directive, et ainsi accéder à ses - fonctionnalités. Les valeurs possible pour cet attribut sont :</p> + <p>Cet attribut indique le degré de rapprochement de la directive du + coeur d'Apache ; en d'autres termes, vous pouvez être amené à + recompiler le serveur avec un jeu de modules supplémentaires pour + pouvoir utiliser la directive, et ainsi accéder à ses + fonctionnalités. Les valeurs possible pour cet attribut sont :</p> <dl> <dt>Core</dt> @@ -240,34 +240,34 @@ <dd>Une directive dont le statut est "MPM" est fournie par un <a href="../mpm.html">module Multi-Processus</a>. Ce type de directive sera disponible si et seulement si vous utilisez un des - MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la - définition de la directive.</dd> + MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la + définition de la directive.</dd> <dt>Base</dt> <dd>Une directive dont le statut est "Base" est fournie par un des - modules Apache standards qui sont compilés dans le serveur par - défaut, et sont de ce fait toujours disponibles, sauf si vous avez + modules Apache standards qui sont compilés dans le serveur par + défaut, et sont de ce fait toujours disponibles, sauf si vous avez fait en sorte de les supprimer de votre configuration.</dd> <dt>Extension</dt> <dd>Une directive dont le statut est "Extension" est fournie par un des modules inclus dans le kit du serveur Apache, mais qui ne - sont pas compilés dans le serveur par défaut. Pour activer la - directive et accéder à ses fonctionnalités, vous devez modifier + sont pas compilés dans le serveur par défaut. Pour activer la + directive et accéder à ses fonctionnalités, vous devez modifier les fichiers de configuration de la compilation du serveur, et recompiler Apache.</dd> - <dt>Expérimental</dt> + <dt>Expérimental</dt> <dd>Le statut "Experimental" indique que la directive fait partie - du kit Apache, mais que vous l'utilisez à vos risques et périls. - La directive est documentée à titre d'exhaustivité, et n'est pas - obligatoirement supportée. Le module qui fournit la directive peut - être compilé par défaut dans le serveur ou non ; consultez le haut - de la page qui décrit la directive et son module pour vérifier sa - disponibilité.</dd> + du kit Apache, mais que vous l'utilisez à vos risques et périls. + La directive est documentée à titre d'exhaustivité, et n'est pas + obligatoirement supportée. Le module qui fournit la directive peut + être compilé par défaut dans le serveur ou non ; consultez le haut + de la page qui décrit la directive et son module pour vérifier sa + disponibilité.</dd> </dl> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> @@ -277,19 +277,19 @@ fournissent la directive.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="Compatibility" id="Compatibility">Compatibilité</a></h2> +<h2><a name="Compatibility" id="Compatibility">Compatibilité</a></h2> <p>Si la directive ne faisait pas partie de la distribution - originale d'Apache version 2, la version dans laquelle elle a été - introduite est indiquée ici. Cette section indique aussi si la + originale d'Apache version 2, la version dans laquelle elle a été + introduite est indiquée ici. Cette section indique aussi si la directive n'est disponible que sur certaines plates-formes.</p> </div></div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/directive-dict.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | +<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | <a href="../ja/mod/directive-dict.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/directive-dict.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -308,7 +308,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/directive-dict } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html index 421e3332ce..244746d75d 100644 --- a/docs/manual/mod/directives.html +++ b/docs/manual/mod/directives.html @@ -14,7 +14,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: directives.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: directives.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/directives.html.fr b/docs/manual/mod/directives.html.fr index b3b15e4074..cdd678dadf 100644 --- a/docs/manual/mod/directives.html.fr +++ b/docs/manual/mod/directives.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -25,26 +25,26 @@ <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../de/mod/directives.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/directives.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/directives.html" title="Français"> fr </a> | +<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/directives.html" title="Français"> fr </a> | <a href="../ja/mod/directives.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/directives.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | <a href="../zh-cn/mod/directives.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> </div> <p> Toutes les directives Apache disponibles dans la distribution standard - d'Apache sont référencées ici. Elles sont décrites en utilisant un - format normalisé, et <a href="directive-dict.html" rel="Glossary">un dictionnaire</a> des termes utilisés dans leurs + d'Apache sont référencées ici. Elles sont décrites en utilisant un + format normalisé, et <a href="directive-dict.html" rel="Glossary">un dictionnaire</a> des termes utilisés dans leurs descriptions est disponible. </p> <p> Un <a href="quickreference.html"> - Document de référence rapide des directives</a> - est également disponible. Il fournit des détails à propos de chaque directive - sous une forme abrégée. + Document de référence rapide des directives</a> + est également disponible. Il fournit des détails à propos de chaque directive + sous une forme abrégée. </p> <p class="letters"><a href="#A"> A </a> | <a href="#B"> B </a> | <a href="#C"> C </a> | <a href="#D"> D </a> | <a href="#E"> E </a> | <a href="#F"> F </a> | <a href="#G"> G </a> | <a href="#H"> H </a> | <a href="#I"> I </a> | <a href="#K"> K </a> | <a href="#L"> L </a> | <a href="#M"> M </a> | <a href="#N"> N </a> | <a href="#O"> O </a> | <a href="#P"> P </a> | <a href="#Q"> Q </a> | <a href="#R"> R </a> | <a href="#S"> S </a> | <a href="#T"> T </a> | <a href="#U"> U </a> | <a href="#V"> V </a> | <a href="#W"> W </a> | <a href="#X"> X </a></p> @@ -734,11 +734,11 @@ <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../de/mod/directives.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/directives.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/directives.html" title="Français"> fr </a> | +<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/directives.html" title="Français"> fr </a> | <a href="../ja/mod/directives.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/directives.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | <a href="../zh-cn/mod/directives.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -758,7 +758,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/directives.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/event.html b/docs/manual/mod/event.html index 1da582d8f6..da55c855da 100644 --- a/docs/manual/mod/event.html +++ b/docs/manual/mod/event.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: event.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/event.html.fr b/docs/manual/mod/event.html.fr index 3c1e12d160..30fe455bb3 100644 --- a/docs/manual/mod/event.html.fr +++ b/docs/manual/mod/event.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,23 +27,23 @@ <div id="preamble"><h1>Apache MPM event</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/event.html" title="Français"> fr </a></p> +<a href="../fr/mod/event.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne mobiliser des threads que pour les connexions en cours de traitement</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_event_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>event.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_event_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>event.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module multi-processus (MPM) <code class="module"><a href="../mod/event.html">event</a></code> est conçu - pour permettre le traitement d'un nombre accru de requêtes - simultanées en déléguant certaines tâches à des threads de support, - libérant par là-même le thread principal et lui permettant de - traiter les nouvelles requêtes. Il s'inspire du MPM - <code class="module"><a href="../mod/worker.html">worker</a></code> qui implémente un serveur hybride - multi-processus/multi-threads. Les directives de configuration à - l'exécution sont identiques à celles du MPM + <p>Le module multi-processus (MPM) <code class="module"><a href="../mod/event.html">event</a></code> est conçu + pour permettre le traitement d'un nombre accru de requêtes + simultanées en déléguant certaines tâches à des threads de support, + libérant par là -même le thread principal et lui permettant de + traiter les nouvelles requêtes. Il s'inspire du MPM + <code class="module"><a href="../mod/worker.html">worker</a></code> qui implémente un serveur hybride + multi-processus/multi-threads. Les directives de configuration à + l'exécution sont identiques à celles du MPM <code class="module"><a href="../mod/worker.html">worker</a></code>.</p> <p>Pour utiliser le MPM <code class="module"><a href="../mod/event.html">event</a></code>, ajoutez @@ -55,7 +55,7 @@ mobiliser des threads que pour les connexions en cours de traitement</td></tr> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment tout cela fonctionne</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#requirements">Prérequis</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requirements">Prérequis</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#asyncrequestworkerfactor">AsyncRequestWorkerFactor</a></li> @@ -86,78 +86,78 @@ mobiliser des threads que pour les connexions en cours de traitement</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="how-it-works" id="how-it-works">Comment tout cela fonctionne</a></h2> - <p>Ce MPM essaie de résoudre le 'problème keep alive' de HTTP. - Lorsqu'un client a soumis une première requête, il peut garder la - connexion ouverte, et envoyer les requêtes suivantes en utilisant le - même socket. Ceci permet de réduire de manière significative la - surcharge due à la création de connexions TCP. + <p>Ce MPM essaie de résoudre le 'problème keep alive' de HTTP. + Lorsqu'un client a soumis une première requête, il peut garder la + connexion ouverte, et envoyer les requêtes suivantes en utilisant le + même socket. Ceci permet de réduire de manière significative la + surcharge due à la création de connexions TCP. Cependant, le serveur HTTP Apache - mobilise en principe à cet effet un processus/thread enfant en - attente des données du client, ce qui amène son propre lot - d'inconvénients. Pour résoudre ce problème, <code class="module"><a href="../mod/event.html">event</a></code> - utilise un thread dédié qui gère les sockets en - écoute, tous les sockets en état Keep Alive, et les - sockets où les filtres gestionnaires et de protocole ont - fait leur travail et pour lesquels la seule chose restant à faire - consiste à envoyer les données au client. La page d'état de + mobilise en principe à cet effet un processus/thread enfant en + attente des données du client, ce qui amène son propre lot + d'inconvénients. Pour résoudre ce problème, <code class="module"><a href="../mod/event.html">event</a></code> + utilise un thread dédié qui gère les sockets en + écoute, tous les sockets en état Keep Alive, et les + sockets où les filtres gestionnaires et de protocole ont + fait leur travail et pour lesquels la seule chose restant à faire + consiste à envoyer les données au client. La page d'état de <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> montre les connexions qui se trouvent - dans les situations mentionnées.</p> + dans les situations mentionnées.</p> - <p>Le gestionnaire de connexion amélioré peut ne pas - fonctionner pour les filtres de connexion qui se déclarent eux-mêmes + <p>Le gestionnaire de connexion amélioré peut ne pas + fonctionner pour les filtres de connexion qui se déclarent eux-mêmes comme incompatibles avec le MPM event. Dans ce cas, le MPM event adopte le comportement du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> et - réserve un thread par connexion. Tous les modules fournis + réserve un thread par connexion. Tous les modules fournis avec le serveur sont compatibles avec le MPM event.</p> - <p>Une restriction similaire existe pour les requêtes qui utilisent + <p>Une restriction similaire existe pour les requêtes qui utilisent un filtre en sortie qui doit lire et/ou modifier l'ensemble du corps - de réponse, comme dans le cas de mod_ssl, mod_deflate, ou + de réponse, comme dans le cas de mod_ssl, mod_deflate, ou mod_include. Si la connexion avec le client se bloque pendant que le - filtre traite les données, et si la quantité de données générée par - ce filtre est trop importante pour être mise en tampon mémoire, le - thread utilisé pour la requête n'est pas libéré pendant que httpd - attend que toutes les données restantes aient été transmises au + filtre traite les données, et si la quantité de données générée par + ce filtre est trop importante pour être mise en tampon mémoire, le + thread utilisé pour la requête n'est pas libéré pendant que httpd + attend que toutes les données restantes aient été transmises au client.</p> - <p>Le MPM présuppose que l'implémentation <code>apr_pollset</code> - sous-jacente est raisonnablement sûre du point de vue des threads. - Ceci permet au MPM d'éviter un verrouillage de haut niveau excessif, - ou de devoir activer le thread en écoute afin de lui envoyer un + <p>Le MPM présuppose que l'implémentation <code>apr_pollset</code> + sous-jacente est raisonnablement sûre du point de vue des threads. + Ceci permet au MPM d'éviter un verrouillage de haut niveau excessif, + ou de devoir activer le thread en écoute afin de lui envoyer un socket keep alive. Tout ceci n'est actuellement compatible qu'avec KQueue et EPoll.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="requirements" id="requirements">Prérequis</a></h2> - <p>Ce MPM dépend des opérations atomiques compare-and-swap +<h2><a name="requirements" id="requirements">Prérequis</a></h2> + <p>Ce MPM dépend des opérations atomiques compare-and-swap d'<a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> pour la synchronisation des threads. Si vous compilez pour une plate-forme x86 et n'avez pas besoin du support 386, ou si vous compilez pour une plate-forme SPARC et n'avez pas besoin du support pre-UltraSPARC, ajoutez <code>--enable-nonportable-atomics=yes</code> aux arguments du - script <code class="program"><a href="../programs/configure.html">configure</a></code>. Ceci permettra à APR - d'implémenter les opérations atomiques en utilisant des instructions + script <code class="program"><a href="../programs/configure.html">configure</a></code>. Ceci permettra à APR + d'implémenter les opérations atomiques en utilisant des instructions performantes indisponibles avec les processeurs plus anciens.</p> - <p>Ce MPM ne fonctionne pas de manière optimale sur les - plates-formes plus anciennes qui ne gèrent pas correctement les - threads, mais ce problème est sans objet du fait du prérequis + <p>Ce MPM ne fonctionne pas de manière optimale sur les + plates-formes plus anciennes qui ne gèrent pas correctement les + threads, mais ce problème est sans objet du fait du prérequis concernant EPoll ou KQueue.</p> <ul> <li>Pour utiliser ce MPM sous FreeBSD, la version 5.3 ou - supérieure de ce système est recommandée. Il est cependant - possible d'exécuter ce MPM sous FreeBSD 5.2.1 si vous utilisez + supérieure de ce système est recommandée. Il est cependant + possible d'exécuter ce MPM sous FreeBSD 5.2.1 si vous utilisez <code>libkse</code> (voir <code>man libmap.conf</code>).</li> <li>Pour NetBSD, il est recommander d'utiliser la version 2.0 ou - supérieure.</li> + supérieure.</li> - <li>Pour Linux, un noyau 2.6 est recommandé. Il faut aussi - s'assurer que votre version de <code>glibc</code> a été compilée + <li>Pour Linux, un noyau 2.6 est recommandé. Il faut aussi + s'assurer que votre version de <code>glibc</code> a été compilée avec le support pour EPoll.</li> </ul> @@ -165,36 +165,36 @@ mobiliser des threads que pour les connexions en cours de traitement</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="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>Limite le nombre de connexions simultanées par thread</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#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>Disponible depuis la version 2.3.13</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>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 : tout d'abord, il limite le nombre de connexions - simultanées par thread en fonction du nombre de processus - inactifs. Ensuite, 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 + <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 : tout d'abord, il limite le nombre de connexions + simultanées par thread en fonction du nombre de processus + inactifs. Ensuite, 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.</p> <p>Cette directive permet de personnaliser finement la limite du nombre de connexions par thread. Un processus n'acceptera de nouvelles connexions que si le nombre actuel de connexions (sans - compter les connexions à l'état "closing") est - inférieur à :</p> + 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> + @@ -202,7 +202,7 @@ mobiliser des threads que pour les connexions en cours de traitement</td></tr> <var>nombre de threads inactifs</var>) </strong></p> - <p>En d'autres termes, le nombre maximum de connexions simultanées + <p>En d'autres termes, le nombre maximum de connexions simultanées sera :</p> <p class="indent"><strong> @@ -212,7 +212,7 @@ mobiliser des threads que pour les connexions en cours de traitement</td></tr> <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 + ci-dessus montre que cet ancien nom ne correspondait pas à sa signification exacte pour le MPM event.</p> <p>La directive <code class="directive">AsyncRequestWorkerFactor</code> @@ -223,7 +223,7 @@ mobiliser des threads que pour les connexions en cours de traitement</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/event.html" title="Français"> fr </a></p> +<a href="../fr/mod/event.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -242,7 +242,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/event.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html index 5512d43913..01a90859e9 100644 --- a/docs/manual/mod/index.html +++ b/docs/manual/mod/index.html @@ -14,7 +14,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: index.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: index.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/index.html.fr b/docs/manual/mod/index.html.fr index adb42ed902..77738e55dc 100644 --- a/docs/manual/mod/index.html.fr +++ b/docs/manual/mod/index.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -25,36 +25,36 @@ <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/" title="Français"> fr </a> | +<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" title="Français"> fr </a> | <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | <a href="../zh-cn/mod/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> </div> <p> Ci-dessous se trouve la liste de tous les modules qui font partie de - la distribution du serveur HTTP Apache. Voir aussi la liste alphabétique complète + la distribution du serveur HTTP Apache. Voir aussi la liste alphabétique complète de <a href="directives.html">toutes les directives du serveur HTTP Apache</a>. </p> </div> <div id="quickview"><ul id="toc"> -<li><img alt="" src="../images/down.gif" /> <a href="#core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></li><li><img alt="" src="../images/down.gif" /> <a href="#other">Autres Modules</a></li></ul><h3>Voir aussi</h3> +<li><img alt="" src="../images/down.gif" /> <a href="#core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></li><li><img alt="" src="../images/down.gif" /> <a href="#other">Autres Modules</a></li></ul><h3>Voir aussi</h3> <ul class="seealso"> <li><a href="../mpm.html">Modules multi-processus (MPMs)</a> </li> -<li><a href="quickreference.html">Document de référence rapide des directives</a> +<li><a href="quickreference.html">Document de référence rapide des directives</a> </li> </ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"><h2><a id="core" name="core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></h2> +<div class="section"><h2><a id="core" name="core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></h2> <dl> -<dt><a href="core.html">core</a></dt><dd>Fonctionnalités de base du serveur HTTP Apache toujours +<dt><a href="core.html">core</a></dt><dd>Fonctionnalités de base du serveur HTTP Apache toujours disponibles</dd> <dt><a href="mpm_common.html">mpm_common</a></dt><dd class="separate">A collection of directives that are implemented by more than one multi-processing module (MPM)</dd> -<dt><a href="event.html">event</a></dt><dd>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne +<dt><a href="event.html">event</a></dt><dd>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne mobiliser des threads que pour les connexions en cours de traitement</dd> <dt><a href="mpm_netware.html">mpm_netware</a></dt><dd>Multi-Processing Module implementing an exclusively threaded web server optimized for Novell NetWare</dd> @@ -67,32 +67,32 @@ mobiliser des threads que pour les connexions en cours de traitement</dd> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"><h2><a id="other" name="other">Autres Modules</a></h2> <p class="letters"><a href="#A"> A </a> | <a href="#B"> B </a> | <a href="#C"> C </a> | <a href="#D"> D </a> | <a href="#E"> E </a> | <a href="#F"> F </a> | <a href="#H"> H </a> | <a href="#I"> I </a> | <a href="#J"> J </a> | <a href="#L"> L </a> | <a href="#M"> M </a> | <a href="#N"> N </a> | <a href="#P"> P </a> | <a href="#R"> R </a> | <a href="#S"> S </a> | <a href="#U"> U </a> | <a href="#V"> V </a> | <a href="#W"> W </a> | <a href="#X"> X </a></p> -<dl><dt><a href="mod_access_compat.html" id="A" name="A">mod_access_compat</a></dt><dd>Autorisations de groupe à base de nom d'hôte (nom ou +<dl><dt><a href="mod_access_compat.html" id="A" name="A">mod_access_compat</a></dt><dd>Autorisations de groupe à base de nom d'hôte (nom ou adresse IP)</dd> -<dt><a href="mod_actions.html">mod_actions</a></dt><dd>Exécution des scripts CGI en fonction du -type de média ou de la méthode de requête.</dd> -<dt><a href="mod_alias.html">mod_alias</a></dt><dd>Permet d'atteindre différentes parties du système de +<dt><a href="mod_actions.html">mod_actions</a></dt><dd>Exécution des scripts CGI en fonction du +type de média ou de la méthode de requête.</dd> +<dt><a href="mod_alias.html">mod_alias</a></dt><dd>Permet d'atteindre différentes parties du système de fichiers depuis l'arborescence des documents du site web, ainsi que la redirection d'URL</dd> <dt><a href="mod_allowhandlers.html">mod_allowhandlers</a></dt><dd>Easily restrict what HTTP handlers can be used on the server</dd> -<dt><a href="mod_allowmethods.html">mod_allowmethods</a></dt><dd>Limitation simple des méthodes HTTP acceptées par e serveur</dd> -<dt><a href="mod_asis.html">mod_asis</a></dt><dd>Envoie des fichiers contenant leurs propres en-têtes +<dt><a href="mod_allowmethods.html">mod_allowmethods</a></dt><dd>Limitation simple des méthodes HTTP acceptées par e serveur</dd> +<dt><a href="mod_asis.html">mod_asis</a></dt><dd>Envoie des fichiers contenant leurs propres en-têtes HTTP</dd> <dt><a href="mod_auth_basic.html">mod_auth_basic</a></dt><dd>Authentification HTTP de base</dd> -<dt><a href="mod_auth_digest.html">mod_auth_digest</a></dt><dd>Authentification utilisateur utilisant les condensés +<dt><a href="mod_auth_digest.html">mod_auth_digest</a></dt><dd>Authentification utilisateur utilisant les condensés MD5</dd> -<dt><a href="mod_auth_form.html">mod_auth_form</a></dt><dd>Authentification à l'aide d'un formulaire</dd> -<dt><a href="mod_authn_anon.html">mod_authn_anon</a></dt><dd>Permet un accès "anonyme" à des zones -authentifiées</dd> +<dt><a href="mod_auth_form.html">mod_auth_form</a></dt><dd>Authentification à l'aide d'un formulaire</dd> +<dt><a href="mod_authn_anon.html">mod_authn_anon</a></dt><dd>Permet un accès "anonyme" à des zones +authentifiées</dd> <dt><a href="mod_authn_core.html">mod_authn_core</a></dt><dd>Le noyau de l'authentification</dd> -<dt><a href="mod_authn_dbd.html">mod_authn_dbd</a></dt><dd>Authentification utilisateur à l'aide d'une base de données +<dt><a href="mod_authn_dbd.html">mod_authn_dbd</a></dt><dd>Authentification utilisateur à l'aide d'une base de données SQL</dd> <dt><a href="mod_authn_dbm.html">mod_authn_dbm</a></dt><dd>Authentification utilisateur utilisant des fichiers DBM</dd> -<dt><a href="mod_authn_file.html">mod_authn_file</a></dt><dd>Authentification utilisateur à l'aide de fichiers +<dt><a href="mod_authn_file.html">mod_authn_file</a></dt><dd>Authentification utilisateur à l'aide de fichiers texte</dd> -<dt><a href="mod_authn_socache.html">mod_authn_socache</a></dt><dd>Gère un cache des données d'authentification pour diminuer -la charge des serveurs d'arrière-plan</dd> +<dt><a href="mod_authn_socache.html">mod_authn_socache</a></dt><dd>Gère un cache des données d'authentification pour diminuer +la charge des serveurs d'arrière-plan</dd> <dt><a href="mod_authnz_fcgi.html">mod_authnz_fcgi</a></dt><dd>Allows a FastCGI authorizer application to handle Apache httpd authentication and authorization</dd> <dt><a href="mod_authnz_ldap.html">mod_authnz_ldap</a></dt><dd>Permet d'utiliser un annuaire LDAP pour l'authentification @@ -100,70 +100,70 @@ HTTP de base.</dd> <dt><a href="mod_authz_core.html">mod_authz_core</a></dt><dd>Socle d'autorisation</dd> <dt><a href="mod_authz_dbd.html">mod_authz_dbd</a></dt><dd>Autorisation par groupe ou par identifiant via SQL</dd> <dt><a href="mod_authz_dbm.html">mod_authz_dbm</a></dt><dd>Autorisation par groupes sur base de fichiers DBM</dd> -<dt><a href="mod_authz_groupfile.html">mod_authz_groupfile</a></dt><dd>Autorisation de groupes à base de fichiers +<dt><a href="mod_authz_groupfile.html">mod_authz_groupfile</a></dt><dd>Autorisation de groupes à base de fichiers textes</dd> -<dt><a href="mod_authz_host.html">mod_authz_host</a></dt><dd>Autorisations de groupe basées sur l'hôte (nom ou adresse +<dt><a href="mod_authz_host.html">mod_authz_host</a></dt><dd>Autorisations de groupe basées sur l'hôte (nom ou adresse IP)</dd> -<dt><a href="mod_authz_owner.html">mod_authz_owner</a></dt><dd>Autorisation basée sur l'appartenance des +<dt><a href="mod_authz_owner.html">mod_authz_owner</a></dt><dd>Autorisation basée sur l'appartenance des fichiers</dd> -<dt><a href="mod_authz_user.html">mod_authz_user</a></dt><dd>Autorisation basée sur l'utilisateur</dd> -<dt><a href="mod_autoindex.html">mod_autoindex</a></dt><dd>Génère automatiquement des index de répertoires d'une -manière similaire à la commande Unix <code>ls</code>, ou à la commande +<dt><a href="mod_authz_user.html">mod_authz_user</a></dt><dd>Autorisation basée sur l'utilisateur</dd> +<dt><a href="mod_autoindex.html">mod_autoindex</a></dt><dd>Génère automatiquement des index de répertoires d'une +manière similaire à la commande Unix <code>ls</code>, ou à la commande shell Win32 <code>dir</code></dd> -<dt><a href="mod_buffer.html" id="B" name="B">mod_buffer</a></dt><dd>Support de la mise en tampon des requêtes</dd> -<dt><a href="mod_cache.html" id="C" name="C">mod_cache</a></dt><dd>Filtre de mise en cache HTTP conforme à la RFC 2616</dd> +<dt><a href="mod_buffer.html" id="B" name="B">mod_buffer</a></dt><dd>Support de la mise en tampon des requêtes</dd> +<dt><a href="mod_cache.html" id="C" name="C">mod_cache</a></dt><dd>Filtre de mise en cache HTTP conforme à la RFC 2616</dd> <dt><a href="mod_cache_disk.html">mod_cache_disk</a></dt><dd>Module de stockage sur disque pour le filtre de mise en cache HTTP.</dd> -<dt><a href="mod_cache_socache.html">mod_cache_socache</a></dt><dd>Module de stockage à base de cache d'objets partagés +<dt><a href="mod_cache_socache.html">mod_cache_socache</a></dt><dd>Module de stockage à base de cache d'objets partagés (socache) pour le filtre de mise en cache HTTP.</dd> -<dt><a href="mod_cern_meta.html">mod_cern_meta</a></dt><dd>La sémantique des métafichiers du serveur httpd du +<dt><a href="mod_cern_meta.html">mod_cern_meta</a></dt><dd>La sémantique des métafichiers du serveur httpd du CERN</dd> -<dt><a href="mod_cgi.html">mod_cgi</a></dt><dd>Exécution des scripts CGI</dd> -<dt><a href="mod_cgid.html">mod_cgid</a></dt><dd>Exécution des scripts CGI par l'intermédiaire d'un démon +<dt><a href="mod_cgi.html">mod_cgi</a></dt><dd>Exécution des scripts CGI</dd> +<dt><a href="mod_cgid.html">mod_cgid</a></dt><dd>Exécution des scripts CGI par l'intermédiaire d'un démon CGI externe</dd> -<dt><a href="mod_charset_lite.html">mod_charset_lite</a></dt><dd>Spécifie dans quel jeu de caractère doivent s'effectuer les -traductions ou les réencodages</dd> -<dt><a href="mod_data.html" id="D" name="D">mod_data</a></dt><dd>Convertit un corps de réponse en URL de type données RFC2397</dd> -<dt><a href="mod_dav.html">mod_dav</a></dt><dd>Fonctionnalité de création et gestion de versions de +<dt><a href="mod_charset_lite.html">mod_charset_lite</a></dt><dd>Spécifie dans quel jeu de caractère doivent s'effectuer les +traductions ou les réencodages</dd> +<dt><a href="mod_data.html" id="D" name="D">mod_data</a></dt><dd>Convertit un corps de réponse en URL de type données RFC2397</dd> +<dt><a href="mod_dav.html">mod_dav</a></dt><dd>Fonctionnalité de création et gestion de versions de documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</dd> -<dt><a href="mod_dav_fs.html">mod_dav_fs</a></dt><dd>Implémente le fournisseur filesystem pour +<dt><a href="mod_dav_fs.html">mod_dav_fs</a></dt><dd>Implémente le fournisseur filesystem pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></dd> -<dt><a href="mod_dav_lock.html">mod_dav_lock</a></dt><dd>Module de verrouillage générique pour +<dt><a href="mod_dav_lock.html">mod_dav_lock</a></dt><dd>Module de verrouillage générique pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></dd> -<dt><a href="mod_dbd.html">mod_dbd</a></dt><dd>Gestion des connexions à une base de données SQL</dd> +<dt><a href="mod_dbd.html">mod_dbd</a></dt><dd>Gestion des connexions à une base de données SQL</dd> <dt><a href="mod_deflate.html">mod_deflate</a></dt><dd>Comprime le contenu avant de le servir au client</dd> -<dt><a href="mod_dialup.html">mod_dialup</a></dt><dd>Envoie le contenu statique avec une bande passante limitée -définie par les différents standards des anciens modems.</dd> +<dt><a href="mod_dialup.html">mod_dialup</a></dt><dd>Envoie le contenu statique avec une bande passante limitée +définie par les différents standards des anciens modems.</dd> <dt><a href="mod_dir.html">mod_dir</a></dt><dd>Permet la redirection des adresses se terminant par un -répertoire sans slash de fin et la mise à disposition des fichiers index -de répertoire</dd> -<dt><a href="mod_dumpio.html">mod_dumpio</a></dt><dd>Enregistre toutes les entrées/sorties dans le journal des -erreurs de la manière souhaitée.</dd> -<dt><a href="mod_echo.html" id="E" name="E">mod_echo</a></dt><dd>Un simple serveur d'écho pour illustrer les modules de +répertoire sans slash de fin et la mise à disposition des fichiers index +de répertoire</dd> +<dt><a href="mod_dumpio.html">mod_dumpio</a></dt><dd>Enregistre toutes les entrées/sorties dans le journal des +erreurs de la manière souhaitée.</dd> +<dt><a href="mod_echo.html" id="E" name="E">mod_echo</a></dt><dd>Un simple serveur d'écho pour illustrer les modules de protocole</dd> <dt><a href="mod_env.html">mod_env</a></dt><dd>Modifie l'environnement transmis aux scripts CGI et aux pages SSI</dd> <dt><a href="mod_example_hooks.html">mod_example_hooks</a></dt><dd>Illustration de l'API des modules Apache</dd> -<dt><a href="mod_expires.html">mod_expires</a></dt><dd>Génération des en-têtes HTTP <code>Expires</code> et -<code>Cache-Control</code> en fonction de critères spécifiés par +<dt><a href="mod_expires.html">mod_expires</a></dt><dd>Génération des en-têtes HTTP <code>Expires</code> et +<code>Cache-Control</code> en fonction de critères spécifiés par l'utilisateur</dd> -<dt><a href="mod_ext_filter.html">mod_ext_filter</a></dt><dd>Fait traiter le corps de la réponse par un programme +<dt><a href="mod_ext_filter.html">mod_ext_filter</a></dt><dd>Fait traiter le corps de la réponse par un programme externe avant de l'envoyer au client</dd> -<dt><a href="mod_file_cache.html" id="F" name="F">mod_file_cache</a></dt><dd>Mise en cache mémoire d'une liste statique de +<dt><a href="mod_file_cache.html" id="F" name="F">mod_file_cache</a></dt><dd>Mise en cache mémoire d'une liste statique de fichiers</dd> <dt><a href="mod_filter.html">mod_filter</a></dt><dd>Context-sensitive smart filter configuration module</dd> <dt><a href="mod_firehose.html">mod_firehose</a></dt><dd>Multiplexes all I/O to a given file or pipe.</dd> -<dt><a href="mod_headers.html" id="H" name="H">mod_headers</a></dt><dd>Personnalisation des en-têtes de requêtes et de réponses +<dt><a href="mod_headers.html" id="H" name="H">mod_headers</a></dt><dd>Personnalisation des en-têtes de requêtes et de réponses HTTP</dd> <dt><a href="mod_heartbeat.html">mod_heartbeat</a></dt><dd>Sends messages with server status to frontend proxy</dd> <dt><a href="mod_heartmonitor.html">mod_heartmonitor</a></dt><dd>Centralized monitor for mod_heartbeat origin servers</dd> <dt><a href="mod_http2.html">mod_http2</a></dt><dd>Support for the HTTP/2 transport layer</dd> -<dt><a href="mod_ident.html" id="I" name="I">mod_ident</a></dt><dd>Recherche d'identité conformément à la RFC +<dt><a href="mod_ident.html" id="I" name="I">mod_ident</a></dt><dd>Recherche d'identité conformément à la RFC 1413</dd> <dt><a href="mod_imagemap.html">mod_imagemap</a></dt><dd>Server-side imagemap processing</dd> <dt><a href="mod_include.html">mod_include</a></dt><dd>Server-parsed html documents (Server Side Includes)</dd> -<dt><a href="mod_info.html">mod_info</a></dt><dd>Affiche une présentation complète de la configuration du +<dt><a href="mod_info.html">mod_info</a></dt><dd>Affiche une présentation complète de la configuration du serveur</dd> <dt><a href="mod_isapi.html">mod_isapi</a></dt><dd>ISAPI Extensions within Apache for Windows</dd> <dt><a href="mod_journald.html" id="J" name="J">mod_journald</a></dt><dd>Provides "journald" ErrorLog provider</dd> @@ -172,14 +172,14 @@ serveur</dd> <dt><a href="mod_lbmethod_bytraffic.html">mod_lbmethod_bytraffic</a></dt><dd>Weighted Traffic Counting load balancer scheduler algorithm for <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dd> <dt><a href="mod_lbmethod_heartbeat.html">mod_lbmethod_heartbeat</a></dt><dd>Heartbeat Traffic Counting load balancer scheduler algorithm for <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dd> <dt><a href="mod_ldap.html">mod_ldap</a></dt><dd>Conservation des connexions LDAP et services de mise en -cache du résultat à destination des autres modules LDAP</dd> +cache du résultat à destination des autres modules LDAP</dd> <dt><a href="mod_log_config.html">mod_log_config</a></dt><dd>Logging of the requests made to the server</dd> <dt><a href="mod_log_debug.html">mod_log_debug</a></dt><dd>Additional configurable debug logging</dd> -<dt><a href="mod_log_forensic.html">mod_log_forensic</a></dt><dd>Journalisation légale des requêtes envoyées au +<dt><a href="mod_log_forensic.html">mod_log_forensic</a></dt><dd>Journalisation légale des requêtes envoyées au serveur</dd> <dt><a href="mod_logio.html">mod_logio</a></dt><dd>Logging of input and output bytes per request</dd> -<dt><a href="mod_lua.html">mod_lua</a></dt><dd>Fournit des points d'entrée Lua dans différentes parties du -traitement des requêtes httpd</dd> +<dt><a href="mod_lua.html">mod_lua</a></dt><dd>Fournit des points d'entrée Lua dans différentes parties du +traitement des requêtes httpd</dd> <dt><a href="mod_macro.html" id="M" name="M">mod_macro</a></dt><dd>Ce module permet d'utiliser des macros dans les fichiers de configuration Apache.</dd> <dt><a href="mod_mime.html">mod_mime</a></dt><dd>Associates the requested filename's extensions @@ -188,7 +188,7 @@ de configuration Apache.</dd> encoding)</dd> <dt><a href="mod_mime_magic.html">mod_mime_magic</a></dt><dd>Determines the MIME type of a file by looking at a few bytes of its contents</dd> -<dt><a href="mod_negotiation.html" id="N" name="N">mod_negotiation</a></dt><dd>Effectue la <a href="../content-negotiation.html">négociation de +<dt><a href="mod_negotiation.html" id="N" name="N">mod_negotiation</a></dt><dd>Effectue la <a href="../content-negotiation.html">négociation de contenu</a></dd> <dt><a href="mod_nw_ssl.html">mod_nw_ssl</a></dt><dd>Enable SSL encryption for NetWare</dd> <dt><a href="mod_policy.html" id="P" name="P">mod_policy</a></dt><dd>HTTP protocol compliance enforcement.</dd> @@ -212,35 +212,35 @@ under different user IDs.</dd> <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> <dt><a href="mod_proxy_html.html">mod_proxy_html</a></dt><dd>Rewrite HTML links in to ensure they are addressable from Clients' networks in a proxy context.</dd> -<dt><a href="mod_proxy_http.html">mod_proxy_http</a></dt><dd>Module fournissant le support HTTP à +<dt><a href="mod_proxy_http.html">mod_proxy_http</a></dt><dd>Module fournissant le support HTTP à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> <dt><a href="mod_proxy_scgi.html">mod_proxy_scgi</a></dt><dd>SCGI gateway module for <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> <dt><a href="mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></dt><dd>Websockets support module for <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> <dt><a href="mod_ratelimit.html" id="R" name="R">mod_ratelimit</a></dt><dd>Bandwidth Rate Limiting for Clients</dd> <dt><a href="mod_reflector.html">mod_reflector</a></dt><dd>Reflect a request body as a response via the output filter stack.</dd> -<dt><a href="mod_remoteip.html">mod_remoteip</a></dt><dd>Remplace l'adresse IP et le nom d'hôte apparents du client -pour la requête par l'adresse IP présentée par un mandataire ou un -répartiteur de charge via les en-têtes de la requête. +<dt><a href="mod_remoteip.html">mod_remoteip</a></dt><dd>Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. </dd> <dt><a href="mod_reqtimeout.html">mod_reqtimeout</a></dt><dd>Set timeout and minimum data rate for receiving requests </dd> <dt><a href="mod_request.html">mod_request</a></dt><dd>Filters to handle and make available HTTP request bodies</dd> -<dt><a href="mod_rewrite.html">mod_rewrite</a></dt><dd>Ce module fournit un moteur de réécriture à base de -règles permettant de réécrire les URLs des requêtes -à la volée</dd> -<dt><a href="mod_sed.html" id="S" name="S">mod_sed</a></dt><dd>Filtre les contenus en entrée (requêtes) et en sortie -(réponses) en utilisant la syntaxe de <code>sed</code></dd> +<dt><a href="mod_rewrite.html">mod_rewrite</a></dt><dd>Ce module fournit un moteur de réécriture à base de +règles permettant de réécrire les URLs des requêtes +à la volée</dd> +<dt><a href="mod_sed.html" id="S" name="S">mod_sed</a></dt><dd>Filtre les contenus en entrée (requêtes) et en sortie +(réponses) en utilisant la syntaxe de <code>sed</code></dd> <dt><a href="mod_session.html">mod_session</a></dt><dd>Session support</dd> <dt><a href="mod_session_cookie.html">mod_session_cookie</a></dt><dd>Cookie based session support</dd> <dt><a href="mod_session_crypto.html">mod_session_crypto</a></dt><dd>Session encryption support</dd> <dt><a href="mod_session_dbd.html">mod_session_dbd</a></dt><dd>DBD/SQL based session support</dd> -<dt><a href="mod_setenvif.html">mod_setenvif</a></dt><dd>Permet de définir des variables d'environnement en fonction -de caractéristiques de la requête</dd> +<dt><a href="mod_setenvif.html">mod_setenvif</a></dt><dd>Permet de définir des variables d'environnement en fonction +de caractéristiques de la requête</dd> <dt><a href="mod_slotmem_plain.html">mod_slotmem_plain</a></dt><dd>Slot-based shared memory provider.</dd> <dt><a href="mod_slotmem_shm.html">mod_slotmem_shm</a></dt><dd>Slot-based shared memory provider.</dd> -<dt><a href="mod_so.html">mod_so</a></dt><dd>Chargement de modules ou de code exécutable au cours du -démarrage ou du redémarrage du serveur</dd> +<dt><a href="mod_so.html">mod_so</a></dt><dd>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</dd> <dt><a href="mod_socache_dbm.html">mod_socache_dbm</a></dt><dd>DBM based shared object cache provider.</dd> <dt><a href="mod_socache_dc.html">mod_socache_dc</a></dt><dd>Distcache based shared object cache provider.</dd> <dt><a href="mod_socache_memcache.html">mod_socache_memcache</a></dt><dd>Memcache based shared object cache provider.</dd> @@ -252,7 +252,7 @@ misspellings.</dd> Layer (SSL) and Transport Layer Security (TLS) protocols</dd> <dt><a href="mod_ssl_ct.html">mod_ssl_ct</a></dt><dd>Implementation of Certificate Transparency (RFC 6962) </dd> -<dt><a href="mod_status.html">mod_status</a></dt><dd>Fournit des informations sur les performances et l'activité +<dt><a href="mod_status.html">mod_status</a></dt><dd>Fournit des informations sur les performances et l'activité du serveur</dd> <dt><a href="mod_substitute.html">mod_substitute</a></dt><dd>Perform search and replace operations on response bodies</dd> <dt><a href="mod_suexec.html">mod_suexec</a></dt><dd>Allows CGI scripts to run as a specified user @@ -260,7 +260,7 @@ and Group</dd> <dt><a href="mod_syslog.html">mod_syslog</a></dt><dd>Provides "syslog" ErrorLog provider</dd> <dt><a href="mod_systemd.html">mod_systemd</a></dt><dd>Provides better support for systemd integration</dd> <dt><a href="mod_unique_id.html" id="U" name="U">mod_unique_id</a></dt><dd>Fournit une variable d'environnement contenant un -identifiant unique pour chaque requête</dd> +identifiant unique pour chaque requête</dd> <dt><a href="mod_unixd.html">mod_unixd</a></dt><dd>Basic (required) security for Unix-family platforms.</dd> <dt><a href="mod_userdir.html">mod_userdir</a></dt><dd>User-specific directories</dd> <dt><a href="mod_usertrack.html">mod_usertrack</a></dt><dd> @@ -277,14 +277,14 @@ filter modules</dd> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | -<a href="../fr/mod/" title="Français"> fr </a> | +<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" title="Français"> fr </a> | <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | <a href="../zh-cn/mod/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> </div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_access_compat.html b/docs/manual/mod/mod_access_compat.html index d142e4db74..b1fac5056c 100644 --- a/docs/manual/mod/mod_access_compat.html +++ b/docs/manual/mod/mod_access_compat.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_access_compat.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_access_compat.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_access_compat.html.fr b/docs/manual/mod/mod_access_compat.html.fr index 73a230c2f9..539a1cfdd6 100644 --- a/docs/manual/mod/mod_access_compat.html.fr +++ b/docs/manual/mod/mod_access_compat.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,18 +27,18 @@ <div id="preamble"><h1>Module Apache mod_access_compat</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe à base de nom d'hôte (nom ou +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe à base de nom d'hôte (nom ou adresse IP)</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>access_compat_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_access_compat.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans la version 2.3 du serveur HTTP Apache -à des fins de compatibilité -avec les précédentes versions d'Apache httpd 2.x. Les directives fournies par -ce module sont devenues obsolètes depuis la refonte d'authz. Voir +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>access_compat_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_access_compat.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans la version 2.3 du serveur HTTP Apache +à des fins de compatibilité +avec les précédentes versions d'Apache httpd 2.x. Les directives fournies par +ce module sont devenues obsolètes depuis la refonte d'authz. Voir <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></td></tr></table> <h3>Sommaire</h3> @@ -48,41 +48,41 @@ ce module sont devenues obsolètes depuis la refonte d'authz. Voir <code class="directive"><a href="../mod/core.html#files"><Files></a></code> et <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, ainsi que dans les fichiers <code><a href="core.html#accessfilename">.htaccess</a></code> et permettent - de contrôler l'accès à certaines parties du serveur. On peut - contrôler cet accès en fonction du nom d'hôte du client, de son - adresse IP ou d'autres caractéristiques de la requête, telles - qu'elles sont enregistrées dans les <a href="../env.html">variables - d'environnement</a>. Les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> permettent de spécifier - quels clients sont ou ne sont pas autorisés à accéder au serveur, - alors que la directive <code class="directive"><a href="#order">Order</a></code> définit le statut - d'accès par défaut, et détermine la manière dont les directives + de contrôler l'accès à certaines parties du serveur. On peut + contrôler cet accès en fonction du nom d'hôte du client, de son + adresse IP ou d'autres caractéristiques de la requête, telles + qu'elles sont enregistrées dans les <a href="../env.html">variables + d'environnement</a>. Les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> permettent de spécifier + quels clients sont ou ne sont pas autorisés à accéder au serveur, + alors que la directive <code class="directive"><a href="#order">Order</a></code> définit le statut + d'accès par défaut, et détermine la manière dont les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> interagissent entre elles.</p> - <p>Les restrictions d'accès à base de nom d'hôte et - l'authentification à base de mot de passe peuvent être implémentées - simultanément. Dans ce cas, on utilise la directive <code class="directive"><a href="#satisfy">Satisfy</a></code> pour déterminer la - manière dont ces deux modes de restrictions interagissent.</p> + <p>Les restrictions d'accès à base de nom d'hôte et + l'authentification à base de mot de passe peuvent être implémentées + simultanément. Dans ce cas, on utilise la directive <code class="directive"><a href="#satisfy">Satisfy</a></code> pour déterminer la + manière dont ces deux modes de restrictions interagissent.</p> <div class="warning"><h3>Note</h3> <p>Les directives fournies par le module - <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> sont devenues obsolètes depuis + <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> sont devenues obsolètes depuis la refonte d'authz. Voir <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.</p> </div> - <p>En général, les directives de restriction d'accès s'appliquent à - toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite dans la plupart des cas. Il est cependant possible de restreindre - certaines méthodes, alors que les autres méthodes ne se verront - imposée aucune restriction, en regroupant les directives à - l'intérieur d'une section <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p> + certaines méthodes, alors que les autres méthodes ne se verront + imposée aucune restriction, en regroupant les directives à + l'intérieur d'une section <code class="directive"><a href="../mod/core.html#limit"><Limit></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> + <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 id="quickview"><h3 class="directives">Directives</h3> @@ -102,29 +102,29 @@ ce module sont devenues obsolètes depuis la refonte d'authz. Voir <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>Spécifie quels hôtes peuvent accéder à une certaine zone du +<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 +<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> +[<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>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>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 + 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> @@ -134,28 +134,28 @@ d'environnement</var> <pre class="prettyprint lang-config">Allow from example.org Allow from .net example.edu</pre> - <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, + <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 + 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> + <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>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd> + <p>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd> <dt>Une adresse IP partielle</dt> @@ -163,53 +163,53 @@ Allow from 192.168.1.104 192.168.1.205</pre> <pre class="prettyprint lang-config">Allow from 10.1 Allow from 10 172.20 192.168.2</pre> - <p>De un à trois des premiers octets d'une adresse IP, afin de - restreindre l'accès à un sous-réseau.</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>Une paire réseau/masque de sous-réseau</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>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> + <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>Une spécification CIDR réseau/nnn</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>Identique au cas précédent, mis à part que le masque est - constitué des nnn bits de poids fort.</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>Notez que les trois derniers exemples désignent le même ensemble - d'hôtes.</p> + <p>Notez que les trois derniers exemples désignent le même ensemble + d'hôtes.</p> - <p>On peut spécifier des adresses et sous-réseaux IPv6 de la manière + <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>Le troisième format d'argument de la directive - <code class="directive">Allow</code> permet de contrôler l'accès au serveur + <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 + 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 + 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 + 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> + 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> + 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"> @@ -219,32 +219,32 @@ Allow from 2001:db8::a00:20ff:fea7:ccea/10</pre> </Directory></pre> - <p>Dans cet exemple, les navigateurs dont la chaîne user-agent + <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> + l'accès, alors que tous les autres seront rejetés.</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> + <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>Définit quels hôtes ne sont pas autorisés à accéder au +<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 +<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> +[<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>Cette directive permet de restreindre l'accès au serveur en - fonction du nom d'hôte, de l'adresse IP ou de variables + <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> @@ -253,109 +253,109 @@ d'environnement</var> <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>Définit le statut d'accès par défaut et l'ordre dans lequel +<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> +<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#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#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>La directive <code class="directive">Order</code>, associée aux + <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 + 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 + 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 + 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> + statut par défaut a son existence propre.</p> - <p><em>Ordre</em> peut être :</p> + <p><em>Ordre</em> peut être :</p> <dl> <dt><code>Allow,Deny</code></dt> - <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 + <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> + <code class="directive"><a href="#deny">Deny</a></code> est rejetée + par défaut.</dd> <dt><code>Deny,Allow</code></dt> - <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 + <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> + 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>Cet argument a le même effet que <code>Allow,Deny</code> et - est devenu de ce fait obsolète.</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>Les mots-clés ne peuvent être séparés que par des virgules ; + <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>Résultat Allow,Deny</th> - <th>Résultat Deny,Allow</th> + <th>Résultat Allow,Deny</th> + <th>Résultat Deny,Allow</th> </tr><tr> - <th>Correspond à Allow seulement</th> - <td>Requête autorisée</td> - <td>Requête autorisée</td> + <th>Correspond à Allow seulement</th> + <td>Requête autorisée</td> + <td>Requête autorisée</td> </tr><tr> - <th>Correspond à Deny seulement</th> - <td>Requête rejetée</td> - <td>Requête rejetée</td> + <th>Correspond à Deny seulement</th> + <td>Requête rejetée</td> + <td>Requête rejetée</td> </tr><tr> <th>Aucune correspondance</th> - <td>Par défaut la seconde directive : rejet</td> - <td>Par défaut la seconde directive : autorisation</td> + <td>Par défaut la seconde directive : rejet</td> + <td>Par défaut la seconde directive : autorisation</td> </tr><tr> - <th>Correspond à Allow & Deny</th> - <td>La dernière correspondance l'emporte : rejet</td> - <td>La dernière correspondance l'emporte : autorisation</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>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> + <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>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é + <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> + refus d'accès.</p> <pre class="prettyprint lang-config">Order Allow,Deny Allow from example.org @@ -363,80 +363,80 @@ Deny from foo.example.org</pre> <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 + <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 + 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 + 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> + autorisation d'accès.</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> + <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>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>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 + <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 + 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 + 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 + 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> + <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 entre le contrôle d'accès en fonction de l'hôte +<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#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#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_access_compat</td></tr> </table> - <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 + <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 + 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 + 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 + 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 + 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 + 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 @@ -445,10 +445,10 @@ Satisfy Any</pre> <p> - 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 : + 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"> @@ -461,20 +461,20 @@ Satisfy Any</pre> </Directory></pre> - <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>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>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> + <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> + <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> @@ -486,7 +486,7 @@ Satisfy Any</pre> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -506,7 +506,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_access_com } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_actions.html b/docs/manual/mod/mod_actions.html index 65b9912fa9..51dbf6dfc5 100644 --- a/docs/manual/mod/mod_actions.html +++ b/docs/manual/mod/mod_actions.html @@ -10,7 +10,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_actions.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_actions.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_actions.html.fr b/docs/manual/mod/mod_actions.html.fr index b50b9eddbb..3b7b4d6a35 100644 --- a/docs/manual/mod/mod_actions.html.fr +++ b/docs/manual/mod/mod_actions.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -28,23 +28,23 @@ <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI en fonction du -type de média ou de la méthode de requête.</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI en fonction du +type de média ou de la méthode de requête.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>actions_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_actions.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>actions_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_actions.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module possède deux directives. La directive <code class="directive"><a href="#action">Action</a></code> vous permet de lancer - l'exécution de scripts CGI chaque fois qu'un fichier possédant un + <p>Ce module possède deux directives. La directive <code class="directive"><a href="#action">Action</a></code> vous permet de lancer + l'exécution de scripts CGI chaque fois qu'un fichier possédant un certain <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type de contenu MIME</a> - fait l'objet d'une requête. La directive <code class="directive"><a href="#script">Script</a></code> vous permet de lancer - l'exécution de scripts CGI chaque fois que la requête utilise une - méthode particulière. Ceci facilite grandement l'exécution de + fait l'objet d'une requête. La directive <code class="directive"><a href="#script">Script</a></code> vous permet de lancer + l'exécution de scripts CGI chaque fois que la requête utilise une + méthode particulière. Ceci facilite grandement l'exécution de scripts qui traitent des fichiers.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -66,43 +66,43 @@ d'Apache httpd</a></li> 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#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>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 + 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 + 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 + 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 + 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>Dans cet exemple, les requêtes pour des fichiers possédant - le type de contenu MIME <code>image/gif</code> seront traitées par + <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>Dans cet exemple, les requêtes pour des fichiers possédant - l'extension <code>.xyz</code> seront traitées par + <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>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 + 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> @@ -120,36 +120,36 @@ Action my-file-type /cgi-bin/program.cgi</pre> <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>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#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>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 + 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 + 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"> - Tous les noms de méthode peuvent être utilisés. <strong>Les noms - de méthode sont sensibles à la casse</strong>, si bien que + 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. + totalement différents. </div> - <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 + <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 @@ -164,7 +164,7 @@ Script PUT /~bob/put.cgi</pre> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -185,7 +185,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_actions.ht } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_alias.html b/docs/manual/mod/mod_alias.html index 7bf1274e07..c93450ae8e 100644 --- a/docs/manual/mod/mod_alias.html +++ b/docs/manual/mod/mod_alias.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_alias.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_alias.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_alias.html.fr b/docs/manual/mod/mod_alias.html.fr index 76f19a474f..1438ceed46 100644 --- a/docs/manual/mod/mod_alias.html.fr +++ b/docs/manual/mod/mod_alias.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,45 +27,45 @@ <div id="preamble"><h1>Module Apache mod_alias</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | <a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet d'atteindre différentes parties du système de +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet d'atteindre différentes parties du système de fichiers depuis l'arborescence des documents du site web, ainsi que la redirection d'URL</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>alias_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_alias.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>alias_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_alias.c</td></tr></table> <h3>Sommaire</h3> <p>Les directives fournies par ce module permettent de manipuler et - de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les + de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les directives <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> permettent de - faire correspondre des URLs avec des chemins du système de fichiers. - Ceci permet de servir des contenus qui ne sont pas situés dans - l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> comme s'ils y étaient - réellement. La directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> a pour effet - supplémentaire de marquer le répertoire cible comme conteneur de + faire correspondre des URLs avec des chemins du système de fichiers. + Ceci permet de servir des contenus qui ne sont pas situés dans + l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> comme s'ils y étaient + réellement. La directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> a pour effet + supplémentaire de marquer le répertoire cible comme conteneur de scripts CGI.</p> <p>Les directives <code class="directive"><a href="#redirect">Redirect</a></code> - indiquent aux clients qu'ils doivent effectuer une nouvelle requête - avec une URL différente. Elles sont souvent utilisées lorsqu'une - ressource a été déplacée.</p> + indiquent aux clients qu'ils doivent effectuer une nouvelle requête + avec une URL différente. Elles sont souvent utilisées lorsqu'une + ressource a été déplacée.</p> - <p>Lorsque les directives <code class="directive"><a href="#alias">Alias</a></code>, <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="#redirect">Redirect</a></code> sont définies au sein d'une + <p>Lorsque les directives <code class="directive"><a href="#alias">Alias</a></code>, <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="#redirect">Redirect</a></code> sont définies 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>, vous pouvez utiliser la <a href="../expr.html">syntaxe des expressions</a> pour manipuler l'URL ou le chemin de destination. </p> - <p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> est conçu pour traiter des tâches - simples de manipulation d'URL. Pour des tâches plus complexes comme - la manipulation des chaînes d'arguments des requêtes, utilisez - plutôt les outils fournis par le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></p> + <p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> est conçu pour traiter des tâches + simples de manipulation d'URL. Pour des tâches plus complexes comme + la manipulation des chaînes d'arguments des requêtes, utilisez + plutôt les outils fournis par le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></p> </div> <div id="quickview"><h3>Sujets</h3> @@ -86,106 +86,106 @@ redirection d'URL</td></tr> <ul class="seealso"> <li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li> <li><a href="../urlmapping.html">Mise en correspondance des URLs avec le -système de fichiers</a></li> +système de fichiers</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="order" id="order">Chronologie du traitement</a></h2> - <p>Les alias et redirections apparaissant dans différents contextes - sont traités comme les autres directives en respectant les <a href="../sections.html#mergin">règles de fusion</a> standards. Par - contre, ils sont traités selon une chronologie particulière - lorsqu'ils apparaissent dans le même contexte (par exemple, dans la - même section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>).</p> + <p>Les alias et redirections apparaissant dans différents contextes + sont traités comme les autres directives en respectant les <a href="../sections.html#mergin">règles de fusion</a> standards. Par + contre, ils sont traités selon une chronologie particulière + lorsqu'ils apparaissent dans le même contexte (par exemple, dans la + même section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>).</p> - <p>Premièrement, toutes les redirections sont traitées avant les - alias, et ainsi, une requête qui correspond à une directive + <p>Premièrement, toutes les redirections sont traitées avant les + alias, et ainsi, une requête qui correspond à une directive <code class="directive"><a href="#redirect">Redirect</a></code> ou <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> ne se verra jamais - appliquer d'alias. Deuxièmement, les alias et redirections sont - traités selon l'ordre dans lequel ils apparaissent dans le fichier - de configuration, seule la première correspondance étant prise en + appliquer d'alias. Deuxièmement, les alias et redirections sont + traités selon l'ordre dans lequel ils apparaissent dans le fichier + de configuration, seule la première correspondance étant prise en compte.</p> <p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au - même sous-répertoire, vous devez classer les chemins du plus précis - au moins précis afin que toutes les directives puissent - éventuellement s'appliquer, comme dans l'exemple suivant :</p> + même sous-répertoire, vous devez classer les chemins du plus précis + au moins précis afin que toutes les directives puissent + éventuellement s'appliquer, comme dans l'exemple suivant :</p> <pre class="prettyprint lang-config">Alias "/foo/bar" "/baz" Alias "/foo" "/gaq"</pre> - <p>Si l'ordre des directives était inversé, la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument - <code>/foo</code> serait toujours appliquée avant la directive + <p>Si l'ordre des directives était inversé, la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument + <code>/foo</code> serait toujours appliquée avant la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument - <code>/foo/bar</code>, et cette dernière serait toujours - ignorée.</p> + <code>/foo/bar</code>, et cette dernière serait toujours + ignorée.</p> - <p>La définition de directives <code class="directive"><a href="#alias">Alias</a></code>, <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="#redirect">Redirect</a></code> au sein de sections + <p>La définition de directives <code class="directive"><a href="#alias">Alias</a></code>, <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="#redirect">Redirect</a></code> au sein de sections <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> - l'emporte sur d'autres définitions éventuelles de ces mêmes - directives au niveau de la configuration générale du serveur.</p> + l'emporte sur d'autres définitions éventuelles de ces mêmes + directives au niveau de la configuration générale 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="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>Met en correspondance des URLs avec des chemins du système +<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> +<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>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 + 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> + 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>Une requête pour <code>http://example.com/image/foo.gif</code> fera + <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>. + <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 + les expressions rationnelles, veuillez vous reporter à la directive <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</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> + requête. Autrement dit, si vous définissez</p> <pre class="prettyprint lang-config">Alias "/icons/" "/usr/local/apache/icons/"</pre> - <p>l'alias précédent ne s'appliquera pas à l'url - <code>/icons</code> à cause de l'absence du slash final. Ainsi, si + <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> + aussi l'être du <var>chemin du fichier</var>.</p> - <p>Notez qu'il pourra s'avérer nécessaire de définir des sections + <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. + 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 + 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>En particulier, si vous créez un alias ayant pour cible un - répertoire situé en dehors de l'arborescence de votre site web + <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> + probablement permettre explicitement l'accès à ce répertoire.</p> <pre class="prettyprint lang-config">Alias "/image" "/ftp/pub/image" <Directory "/ftp/pub/image"> @@ -193,13 +193,13 @@ de fichiers</td></tr> </Directory></pre> - <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>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>Si la directive <code class="directive">Alias</code> est définie au sein + <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.13 du + 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.13 du serveur HTTP Apache.</p> <pre class="prettyprint lang-config"><Location "/image"> @@ -215,47 +215,47 @@ de fichiers</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="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>Met en correspondance des URLs avec le système de fichiers +<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>chemin fichier</var>|<var>chemin répertoire</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>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 + <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 + 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 + 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> <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> + 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>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 + <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 + 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>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>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>Par exemple, supposons que nous voulions reformuler cet alias avec AliasMatch :</p> @@ -264,30 +264,30 @@ en faisant intervenir les expressions rationnelles</td></tr> <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 + 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>Voici la directive AliasMatch qui produira le même résultat que + <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>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> + <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$" "/fichiers/jpg.images/$1.jpg" AliasMatch "^/image/(.*)\.gif$" "/fichiers/gif.images/$1.gif"</pre> - <p>Les éventuels slashes de tête multiples seront supprimés par le + <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. + comparaisons avec le chemin URL de la requête. </p> @@ -296,101 +296,101 @@ en faisant intervenir les expressions rationnelles</td></tr> <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>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>chemin URL</var>] +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>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#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>La directive Redirect permet de faire correspondre une ancienne - URL à une nouvelle en demandant au client d'aller chercher la ressource à + URL à une nouvelle en demandant au client d'aller chercher la ressource à une autre localisation.</p> - <p>L'ancien <em>chemin URL</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>L'ancien <em>chemin URL</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.</p> + 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.</p> - <p>Ensuite, toute requête commençant par <em>chemin URL</em> va + <p>Ensuite, toute requête commençant par <em>chemin URL</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>chemin - URL</em> sera ajouté à l'URL cible.</p> + élément de chemin supplémentaire situé en aval du <em>chemin + URL</em> sera ajouté à l'URL cible.</p> - <pre class="prettyprint lang-config"># Redirige vers une URL sur un serveur différent + <pre class="prettyprint lang-config"># Redirige vers une URL sur un serveur différent Redirect "/service" "http://foo2.example.com/service" -# Redirige vers une URL sur le même serveur +# Redirige vers une URL sur le même serveur Redirect "/one" "/two"</pre> - <p>Si le client effectue une requête pour l'URL - <code>http://example.com/service/foo.txt</code>, il lui sera demandé + <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 + 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 + seront redirigées vers <code>http://foo2.example.com/service/foo.pl?q=23&a=42</code>. - Notez que les <code>POST</code>s seront ignorés.<br /> + 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 + é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>chemin URL</var> comme décrit ci-dessous. En outre, + correspondance plus complexes utilisant la <a href="../expr.html">syntaxe des expressions</a>, ne spécifiez pas + d'argument <var>chemin URL</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> + rationnelles, veuillez vous reporter à la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p> <div class="note"><h3>Note</h3> - <p>Les directives de redirection ont priorité sur les directives + <p>Les directives de redirection ont priorité sur les directives Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le - fichier de configuration. Les directives Redirect définies au sein + fichier de configuration. Les directives Redirect définies au sein d'une section Location l'emportent sur les directives Redirect et Alias comportant un argument <var>chemin URL</var>.</p></div> - <p>Si aucun argument <var>état</var> n'est spécifié, la + <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> + 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>Renvoie un code de redirection permanente (301), indiquant - que la ressource a été définitivement déplacée.</dd> + que la ressource a été définitivement déplacée.</dd> <dt>temp</dt> <dd>Renvoie un code de redirection temporaire (302). C'est le - comportement par défaut.</dd> + comportement par défaut.</dd> <dt>seeother</dt> <dd>Renvoie un code "See Other" (303) indiquant que la ressource - a été remplacée par une autre.</dd> + a été remplacée par une autre.</dd> <dt>gone</dt> <dd>Renvoie un code "Gone" (410) indiquant que la ressource a - été définitivement supprimée. Lorsque - ce code est utilisé, on ne + été définitivement supprimée. Lorsque + ce code est utilisé, on ne doit pas utiliser l'argument <var>URL</var>.</dd> </dl> - <p>On peut renvoyer d'autres codes en spécifiant le code - numérique comme valeur de l'argument of <var>état</var>. + <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 + <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 + <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> @@ -399,11 +399,11 @@ Redirect "/one" "/two"</pre> Redirect 303 "/three" "http://example.com/other"</pre> - <p>Si une directive <code class="directive">Redirect</code> est définie au + <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>chemin - URL</var> est omis, l'argument <var>URL</var> sera interprété en + 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.13 du + Cette syntaxe est disponible à partir de la version 2.4.13 du serveur HTTP Apache.</p> <pre class="prettyprint lang-config"><Location "/one"> @@ -425,30 +425,30 @@ Redirect 303 "/three" "http://example.com/other"</pre> <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> +<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#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>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 + <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 + 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 + 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://autre.example.com$1.jpg"</pre> - <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 + <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> + détails.</p> </div> @@ -456,16 +456,16 @@ courante</td></tr> <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>Envoie une redirection externe permanente demandant au -client d'effectuer une nouvelle requête avec une URL -différente</td></tr> +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#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>Cette directive informe le client que la redirection est - permanente (code 301). Son comportement est exactement le même + permanente (code 301). Son comportement est exactement le même que celui de <code>Redirect permanent</code>.</p> </div> @@ -473,47 +473,47 @@ différente</td></tr> <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>Envoie une redirection externe temporaire demandant au -client d'effectuer une nouvelle requête avec une URL -différente</td></tr> +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#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>Cette directive informe le client que la redirection n'est - que temporaire (code 302). Son comportement est exactement le même + 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>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#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> +<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>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 + <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 + 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 + 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>Une requête pour <code>http://example.com/cgi-bin/foo</code> - ferait exécuter par le serveur le script + <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> + équivalente à :</p> <pre class="prettyprint lang-config">Alias "/cgi-bin/" "/web/cgi-bin/" <Location "/cgi-bin"> SetHandler cgi-script @@ -527,37 +527,37 @@ et désigne la cible comme script CGI</td></tr> <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"</pre> - <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 + <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">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 + <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 + 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 + 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 : + <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> - 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 + 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>Si la directive <code class="directive">ScriptAlias</code> est définie au + <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 + 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.13 du + Cette syntaxe est disponible à partir de la version 2.4.13 du serveur HTTP Apache.</p> <pre class="prettyprint lang-config"><Location "/cgi-bin"> @@ -577,48 +577,48 @@ et désigne la cible comme script CGI</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="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>Fait correspondre une URL à une zone du système de fichiers -en faisant appel aux expressions rationnelles et en désignant la cible +<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>chemin fichier</var>|<var>chemin répertoire</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>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 + <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 + 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>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 à + <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> + 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>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 + <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> + détails.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | <a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -637,7 +637,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_alias.html } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_allowmethods.html b/docs/manual/mod/mod_allowmethods.html index 5d30fcfc4b..fb301c0944 100644 --- a/docs/manual/mod/mod_allowmethods.html +++ b/docs/manual/mod/mod_allowmethods.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_allowmethods.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_allowmethods.html.fr b/docs/manual/mod/mod_allowmethods.html.fr index f0267b9bd5..a56f6bcafb 100644 --- a/docs/manual/mod/mod_allowmethods.html.fr +++ b/docs/manual/mod/mod_allowmethods.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,16 +27,16 @@ <div id="preamble"><h1>Module Apache mod_allowmethods</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_allowmethods.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_allowmethods.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_allowmethods.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Limitation simple des méthodes HTTP acceptées par e serveur</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>allowmethods_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_allowmethods.c</td></tr></table> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Limitation simple des méthodes HTTP acceptées par e serveur</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>allowmethods_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_allowmethods.c</td></tr></table> <h3>Sommaire</h3> -<p>Ce module fournit une manière simple de restreindre les méthodes HTTP -acceptées par le serveur. La configuration la plus courante +<p>Ce module fournit une manière simple de restreindre les méthodes HTTP +acceptées par le serveur. La configuration la plus courante est du style :</p> <pre class="prettyprint lang-config"><Location "/"> @@ -54,20 +54,20 @@ est du style :</p> <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>Restreint l'accès aux méthodes HTTP spécifiées</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#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#Default">Défaut:</a></th><td><code>AllowMethods reset</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_allowmethods</td></tr> </table> -<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 +<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"> @@ -76,18 +76,18 @@ d'imbrication :</p> <div class="note"><h3>Avertissement</h3> - <p>La méthode TRACE ne peut pas être rejetée par ce module ; pour ce + <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>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> +<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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_allowmethods.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_allowmethods.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_allowmethods.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -106,7 +106,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_allowmetho } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_asis.html b/docs/manual/mod/mod_asis.html index 95bb91308c..9527d7c1c6 100644 --- a/docs/manual/mod/mod_asis.html +++ b/docs/manual/mod/mod_asis.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_asis.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_asis.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_asis.html.fr b/docs/manual/mod/mod_asis.html.fr index e02d4652a7..27df580eba 100644 --- a/docs/manual/mod/mod_asis.html.fr +++ b/docs/manual/mod/mod_asis.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,24 +27,24 @@ <div id="preamble"><h1>Module Apache mod_asis</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_asis.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Envoie des fichiers contenant leurs propres en-têtes +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Envoie des fichiers contenant leurs propres en-têtes HTTP</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>asis_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_asis.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>asis_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_asis.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module fournit le gestionnaire <code>send-as-is</code> qui permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des - en-têtes HTTP habituels.</p> + en-têtes HTTP habituels.</p> - <p>On peut l'utiliser pour envoyer tous types de données en - provenance du serveur, y compris les redirections et autres réponses - HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p> + <p>On peut l'utiliser pour envoyer tous types de données en + provenance du serveur, y compris les redirections et autres réponses + HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p> <p>Pour des raisons historiques, ce module traitera aussi tout fichier dont le type MIME est <code>httpd/send-as-is</code>.</p> @@ -71,17 +71,17 @@ d'Apache httpd</a></li> <pre class="prettyprint lang-config">AddHandler send-as-is asis</pre> - <p>Le contenu de tout fichier possédant l'extension - <code>.asis</code> sera envoyé par Apache httpd au client pratiquement tel - quel. En particulier, les en-têtes HTTP seront déduits du fichier - lui-même selon les règles du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, si - bien qu'un fichier asis doit inclure des en-têtes valides, et - utiliser l'en-tête CGI <code>Status:</code> pour déterminer le code de réponse - HTTP. L'en-tête <code>Content-Length:</code> sera automatiquement - inséré ou, s'il est déjà présent, corrigé par httpd.</p> + <p>Le contenu de tout fichier possédant l'extension + <code>.asis</code> sera envoyé par Apache httpd au client pratiquement tel + quel. En particulier, les en-têtes HTTP seront déduits du fichier + lui-même selon les règles du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, si + bien qu'un fichier asis doit inclure des en-têtes valides, et + utiliser l'en-tête CGI <code>Status:</code> pour déterminer le code de réponse + HTTP. L'en-tête <code>Content-Length:</code> sera automatiquement + inséré ou, s'il est déjà présent, corrigé par httpd.</p> - <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel - quel</em> pour informer un client qu'un fichier a été déplacé.</p> + <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel + quel</em> pour informer un client qu'un fichier a été déplacé.</p> <div class="example"><p><code> @@ -94,7 +94,7 @@ d'Apache httpd</a></li> <title>Mauvaises excuses</title><br /> </head><br /> <body><br /> - <h1>La merveilleuse page de Fred a été déplacée vers<br /> + <h1>La merveilleuse page de Fred a été déplacée vers<br /> <a href="http://xyz.example.com/foo/bar.html">le site de Joe</a>.<br /> </h1><br /> @@ -103,17 +103,17 @@ d'Apache httpd</a></li> </code></p></div> <div class="note"><h3>Notes :</h3> - <p>Le serveur ajoute systématiquement les en-têtes - <code>Date:</code> et <code>Server:</code> aux données qu'il envoie - au client, si bien qu'ils n'ont pas besoin d'être inclus dans le - fichier. Le serveur n'ajoute <em>pas</em> d'en-tête + <p>Le serveur ajoute systématiquement les en-têtes + <code>Date:</code> et <code>Server:</code> aux données qu'il envoie + au client, si bien qu'ils n'ont pas besoin d'être inclus dans le + fichier. Le serveur n'ajoute <em>pas</em> d'en-tête <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p> </div> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_asis.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -134,7 +134,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_asis.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_auth_basic.html b/docs/manual/mod/mod_auth_basic.html index a3f5884f6a..476dd9c0e0 100644 --- a/docs/manual/mod/mod_auth_basic.html +++ b/docs/manual/mod/mod_auth_basic.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_auth_basic.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_auth_basic.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_auth_basic.html.fr b/docs/manual/mod/mod_auth_basic.html.fr index c325d263af..72cb990de3 100644 --- a/docs/manual/mod/mod_auth_basic.html.fr +++ b/docs/manual/mod/mod_auth_basic.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,23 +27,23 @@ <div id="preamble"><h1>Module Apache mod_auth_basic</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification HTTP de base</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_basic_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_basic.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_basic_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_basic.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet d'utiliser l'authentification basique HTTP pour - restreindre l'accès en recherchant les utilisateurs dans les - fournisseurs d'authentification spécifiés. Il est en général - combiné avec au moins un module d'authentification comme + restreindre l'accès en recherchant les utilisateurs dans les + fournisseurs d'authentification spécifiés. Il est en général + combiné avec au moins un module d'authentification comme <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et un module d'autorisation comme - <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>. L'authentification HTTP à - base de condensé (digest), quant à elle, est fournie par le module + <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>. L'authentification HTTP à + base de condensé (digest), quant à elle, est fournie par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. </p> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -65,92 +65,92 @@ l'authentification</a></li> <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>Définit si les processus d'autorisation et -d'authentification peuvent être confiés à des modules de plus bas +<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#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#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>Normalement, chaque module d'autorisation énuméré dans la + <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> à + 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 + 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 + <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 + 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>Authentification de base simulée à l'aide des nom +<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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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 + <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> + 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>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>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>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> + prédéfinis sont transmis à un serveur d'arrière-plan :</p> <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"> + d'un mot de passe prédéfinis</h3><pre class="prettyprint lang-config"><Location "/demo"> AuthBasicFake demo demopass </Location></pre> </div> <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> + 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>Exemple d'utilisation avec un certificat</h3><pre class="prettyprint lang-config"><Location "/secure"> AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" </Location></pre> </div> - <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 + <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>Exemple de génération de mot de passe par hashage de + <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>Désactivation de l'authentification simulée</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> @@ -160,22 +160,22 @@ Apache</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="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>Définit le(les) fournisseur(s) d'authentification pour +<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#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>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 + 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 + 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"> @@ -187,13 +187,13 @@ cette zone du site web</td></tr> Require valid-user </Location></pre> </div> - <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un + <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> + 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>Les différents fournisseurs disponibles sont implémentés par les + <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> et <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p> @@ -202,89 +202,89 @@ cette zone du site web</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="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>Vérifie les mots de passe auprès des fournisseurs -d'authentification à la manière de l'authentification de type Digest. +<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#Context">Contexte:</a></th><td>répertoire, .htaccess</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#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>Disponible à partir de la version 2.4.7 du serveur HTTP +<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>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 + 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>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 + 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 + 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 + 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> + Section 3.2.2.2</a> pour plus de détails à propos du type de + chiffrement utilisé pour cette chaîne).</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 + <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é + 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>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 + 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 + 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 + 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. + était définie à <code>Digest</code> et si l'authentification de type + Digest était utilisée. </p> - <p>Grâce à cette directive, un site peut basculer d'une - authentification de type digest à basique sans devoir changer les + <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"> - 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. + 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"> 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 + 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> + refuser l'accès.</div> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -305,7 +305,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_basic } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_auth_digest.html b/docs/manual/mod/mod_auth_digest.html index 1836f36027..8065fe0357 100644 --- a/docs/manual/mod/mod_auth_digest.html +++ b/docs/manual/mod/mod_auth_digest.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_auth_digest.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_auth_digest.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_auth_digest.html.fr b/docs/manual/mod/mod_auth_digest.html.fr index 486c2f6274..e8b303b8a5 100644 --- a/docs/manual/mod/mod_auth_digest.html.fr +++ b/docs/manual/mod/mod_auth_digest.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,33 +27,33 @@ <div id="preamble"><h1>Module Apache mod_auth_digest</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_digest.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur utilisant les condensés +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur utilisant les condensés MD5</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_digest_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_digest.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_digest_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_digest.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module implémente l'authentification HTTP basée sur les - condensés MD5 (<a href="http://www.faqs.org/rfcs/rfc2617.html">RFC2617</a>), et - fournit une alternative à <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> en + <p>Ce module implémente l'authentification HTTP basée sur les + condensés MD5 (<a href="http://www.faqs.org/rfcs/rfc2617.html">RFC2617</a>), et + fournit une alternative à <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> en ne transmettant plus le mot de passe en clair. Cependant, cela ne - suffit pas pour améliorer la sécurité de manière significative par - rapport à l'authentification basique. En outre, le stockage du mot - de passe sur le serveur est encore moins sûr dans le cas - d'une authentification à base de condensé que dans le cas d'une + suffit pas pour améliorer la sécurité de manière significative par + rapport à l'authentification basique. En outre, le stockage du mot + de passe sur le serveur est encore moins sûr dans le cas + d'une authentification à base de condensé que dans le cas d'une authentification basique. C'est pourquoi l'utilisation de - l'authentification basique associée à un chiffrement de la connexion + l'authentification basique associée à un chiffrement de la connexion via <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> constitue une bien meilleure alternative.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de l'authentification à base de -condensés</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de l'authentification à base de +condensés</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#authdigestalgorithm">AuthDigestAlgorithm</a></li> @@ -75,17 +75,17 @@ l'authentification</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="using" id="using">Utilisation de l'authentification à base de -condensés</a></h2> +<h2><a name="using" id="using">Utilisation de l'authentification à base de +condensés</a></h2> - <p>Pour utiliser l'authentification à base de condensés MD5, vous + <p>Pour utiliser l'authentification à base de condensés MD5, vous devez simplement remplacer <code>AuthType Basic</code> et <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> respectivement par <code>AuthType Digest</code> et <code class="directive"><a href="#authdigestprovider">AuthDigestProvider</a></code> lorsque vous configurez l'authentification, puis ajouter une directive <code class="directive"><a href="#authdigestdomain">AuthDigestDomain</a></code> contenant au - moins la(les) URI(s) racine(s) de la zone à protéger.</p> + moins la(les) URI(s) racine(s) de la zone à protéger.</p> - <p>On peut créer les fichiers utilisateur appropriés (au format - texte) à l'aide de l'outil <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</p> + <p>On peut créer les fichiers utilisateur appropriés (au format + texte) à l'aide de l'outil <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</p> <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config"><Location "/private/"> AuthType Digest @@ -99,40 +99,40 @@ condensés</a></h2> </div> <div class="note"><h3>Note</h3> - <p>L'authentification à base de condensé a été conçue pour améliorer - la sécurité par rapport à l'authentification basique, mais il - s'avère que ce but n'a pas été atteint. Un attaquant de type - "man-in-the-middle" peut facilement forcer le navigateur à revenir à - une authentification basique. Même une oreille indiscrète passive + <p>L'authentification à base de condensé a été conçue pour améliorer + la sécurité par rapport à l'authentification basique, mais il + s'avère que ce but n'a pas été atteint. Un attaquant de type + "man-in-the-middle" peut facilement forcer le navigateur à revenir à + une authentification basique. Même une oreille indiscrète passive peut retrouver le mot de passe par force brute avec les moyens - modernes, car l'algorithme de hashage utilisé par l'authentification - à base de condensé est trop rapide. Autre problème, le stockage des - mots de passe sur le serveur n'est pas sûr. Le contenu d'un fichier - htdigest volé peut être utilisé directement pour l'authentification - à base de condensé. Il est donc fortement recommandé d'utiliser + modernes, car l'algorithme de hashage utilisé par l'authentification + à base de condensé est trop rapide. Autre problème, le stockage des + mots de passe sur le serveur n'est pas sûr. Le contenu d'un fichier + htdigest volé peut être utilisé directement pour l'authentification + à base de condensé. Il est donc fortement recommandé d'utiliser <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> pour chiffrer la connexion.</p> <p><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> ne fonctionne correctement que - sur les plates-formes où APR supporte la mémoire partagée.</p> + sur les plates-formes où APR supporte la mémoire partagé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="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>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#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#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#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>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> + 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> n'est pas encore correctement implémenté. + <code>MD5-sess</code> n'est pas encore correctement implémenté. </div> @@ -140,51 +140,51 @@ condensés du défit et de sa réponse</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="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>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#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#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>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 + 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>Cette directive doit toujours être présente et contenir au moins + <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 à + 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>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 + <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> + 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>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#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#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#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"> - Non encore implémenté. + Non encore implémenté. </div> @@ -192,39 +192,39 @@ nombre à valeur unique (nonce) par le serveur</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="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>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#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#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">Non encore implémenté.</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>Durée de validité du nombre à valeur unique du +<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#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>La directive <code class="directive">AuthDigestNonceLifetime</code> - permet de contrôler la durée de validité du nombre à valeur unique + 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 + 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. + <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> @@ -232,22 +232,22 @@ serveur (nonce)</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="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>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#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#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>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 + 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>Voir <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, @@ -259,61 +259,61 @@ zone du site web concernée</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="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>Détermine le niveau de protection fourni par -l'authentification à base de condensé</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#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#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>La directive <code class="directive">AuthDigestQop</code> permet de - définir le <dfn>niveau de protection</dfn> fourni. <code>auth</code> + 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> 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> + 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> n'est pas encore implémenté. + <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>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#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#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>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> + 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>L'argument <var>size</var> s'exprime par défaut en octets, mais + <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> + <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 AuthDigestShmemSize 1024K @@ -324,7 +324,7 @@ AuthDigestShmemSize 1M</pre> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_digest.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -344,7 +344,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_diges } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_auth_form.html b/docs/manual/mod/mod_auth_form.html index 9565e96e40..fdbc129946 100644 --- a/docs/manual/mod/mod_auth_form.html +++ b/docs/manual/mod/mod_auth_form.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_auth_form.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_auth_form.html.fr b/docs/manual/mod/mod_auth_form.html.fr index 70b9a94a24..e32b93439e 100644 --- a/docs/manual/mod/mod_auth_form.html.fr +++ b/docs/manual/mod/mod_auth_form.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,42 +27,42 @@ <div id="preamble"><h1>Module Apache mod_auth_form</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_form.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_auth_form.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification à l'aide d'un formulaire</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification à l'aide d'un formulaire</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_form_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_form.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir d'Apache 2.3</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_form_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_form.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir d'Apache 2.3</td></tr></table> <h3>Sommaire</h3> <div class="warning"><h3>Avertissement</h3> - <p>L'authentification à base de formulaire dépend des modules + <p>L'authentification à base de formulaire dépend des modules <code class="module"><a href="../mod/mod_session.html">mod_session</a></code> qui utilisent les cookies HTTP, et en - tant que tels s'exposent à des attaques de type Cross Site - Scripting, ou risquent de divulguer des informations à caractère - privé aux clients. Assurez-vous que ces risques ont bien été pris + tant que tels s'exposent à des attaques de type Cross Site + Scripting, ou risquent de divulguer des informations à caractère + privé aux clients. Assurez-vous que ces risques ont bien été pris en compte avant d'activer les sessions sur votre serveur.</p> </div> - <p>Ce module permet de restreindre l'accès en recherchant les - utilisateurs dans les fournisseurs spécifiés à l'aide d'un - formulaire de connexion HTML. Les formulaires HTML requièrent - davantage de configuration que les méthodes d'authentification - alternatives, mais ils peuvent s'avérer beaucoup plus conviviaux + <p>Ce module permet de restreindre l'accès en recherchant les + utilisateurs dans les fournisseurs spécifiés à l'aide d'un + formulaire de connexion HTML. Les formulaires HTML requièrent + davantage de configuration que les méthodes d'authentification + alternatives, mais ils peuvent s'avérer beaucoup plus conviviaux pour les utilisateurs. </p> <p>L'authentification HTTP de base est fournie par le module - <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, et l'authentification HTTP à base - de condensé par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. Le - module <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> doit être utilisé avec au + <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, et l'authentification HTTP à base + de condensé par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. Le + module <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> doit être utilisé avec au moins un module d'authentification du style <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et un module d'autorisation comme <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p> - <p>Lorsque l'utilisateur a été authentifié avec succès, ses - informations de connexion sont stockés dans une session fournie par + <p>Lorsque l'utilisateur a été authentifié avec succès, ses + informations de connexion sont stockés dans une session fournie par le module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>. </p> @@ -70,11 +70,11 @@ <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#basicconfig">Configuration de base</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#standalone">Page de connexion dédiée</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#inline">Connexion à la volée</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#inlinepreservebody">Connexion à la volée avec +<li><img alt="" src="../images/down.gif" /> <a href="#standalone">Page de connexion dédiée</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inline">Connexion à la volée</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inlinepreservebody">Connexion à la volée avec conservation du contenu</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#loggingout">Déconnexion</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#loggingout">Déconnexion</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#urlencoding">Noms d'utilisateurs et mots de passe</a></li> </ul><h3 class="directives">Directives</h3> @@ -108,15 +108,15 @@ l'authentification</a></li> <div class="section"> <h2><a name="basicconfig" id="basicconfig">Configuration de base</a></h2> - <p>Pour protéger une URL particulière avec le module - <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, vous devez déterminer l'endroit où - vous allez stocker votre <var>session</var>, ainsi que la méthode + <p>Pour protéger une URL particulière avec le module + <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, vous devez déterminer l'endroit où + vous allez stocker votre <var>session</var>, ainsi que la méthode d'authentification. Dans cet exemple simple, les informations de - connexion sont stockées dans une session à l'aide du module + connexion sont stockées dans une session à l'aide du module <code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et l'authentification utilise un fichier en s'appuyant sur le module - <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Si l'authentification échoue, - l'utilisateur dera redirigé vers la page du formulaire de + <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Si l'authentification échoue, + l'utilisateur dera redirigé vers la page du formulaire de connexion.</p> <div class="example"><h3>Exemple simple</h3><pre class="prettyprint lang-config">AuthFormProvider file @@ -129,40 +129,40 @@ SessionCookieName session path=/ SessionCryptoPassphrase secret</pre> </div> - <p>L'authentification <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> est activée - en affectant la valeur <var>form</var> à la directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>. Les directives + <p>L'authentification <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> est activée + en affectant la valeur <var>form</var> à la directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>. Les directives <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> et <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> - spécifient que les noms d'utilisateurs et mots de passe seront - vérifiés en utilisant le fichier choisi.</p> + spécifient que les noms d'utilisateurs et mots de passe seront + vérifiés en utilisant le fichier choisi.</p> <p>Les directives <code class="directive"><a href="../mod/mod_session.html#session">Session</a></code>, <code class="directive"><a href="../mod/mod_session_cookie.html#sessioncookiename">SessionCookieName</a></code> et <code class="directive"><a href="../mod/mod_session_crypto.html#sessioncryptopassphrase">SessionCryptoPassphrase</a></code> - créent une session chiffrée stockée dans un cookie HTTP au niveau - du navigateur. Pour plus d'informations à propos des différentes - options de configuration des sessions, reportez-vous à la + créent une session chiffrée stockée dans un cookie HTTP au niveau + du navigateur. Pour plus d'informations à propos des différentes + options de configuration des sessions, reportez-vous à la documentation du module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>.</p> - <p>Dans l'exemple simple ci-dessus, une URL a été protégée par + <p>Dans l'exemple simple ci-dessus, une URL a été protégée par <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, mais on doit maintenant fournir - à l'utilisateur un moyen d'entrer un nom et un mot de passe. À cet - effet, on peut soit écrire une page de connexion indépendante - dédiée, soit inclure le formulaire de connexion dans la page + à l'utilisateur un moyen d'entrer un nom et un mot de passe. À cet + effet, on peut soit écrire une page de connexion indépendante + dédiée, soit inclure le formulaire de connexion dans la page courante.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="standalone" id="standalone">Page de connexion dédiée</a></h2> +<h2><a name="standalone" id="standalone">Page de connexion dédiée</a></h2> - <p>Le formulaire de connexion peut être contenu dans une page - indépendante, ou être inclus dans la page courante. </p> + <p>Le formulaire de connexion peut être contenu dans une page + indépendante, ou être inclus dans la page courante. </p> - <p>Lorsque la connexion s'effectue à partir d'une page - indépendante et si la tentative d'authentification échoue, - l'utilisateur doit être redirigé vers un formulaire de connexion, - créé à cet effet sur le site web, en utilisant la directive + <p>Lorsque la connexion s'effectue à partir d'une page + indépendante et si la tentative d'authentification échoue, + l'utilisateur doit être redirigé vers un formulaire de connexion, + créé à cet effet sur le site web, en utilisant la directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>. - En général, la page de connexion contiendra un formulaire HTML - demandant à l'utilisateur de fournir un nom et un mot de passe.</p> + En général, la page de connexion contiendra un formulaire HTML + demandant à l'utilisateur de fournir un nom et un mot de passe.</p> <div class="example"><h3>Exemple de formulaire de connexion</h3><pre class="prettyprint lang-html"><form method="POST" action="/dologin.html"> Username: <input type="text" name="httpd_username" value="" /> @@ -171,8 +171,8 @@ SessionCryptoPassphrase secret</pre> </form></pre> </div> - <p>La partie où s'effectue la connexion proprement dite est - traitée par le gestionnaire <var>form-login-handler</var>. + <p>La partie où s'effectue la connexion proprement dite est + traitée par le gestionnaire <var>form-login-handler</var>. L'action de ce formulaire doit pointer vers ce gestionnaire, ce que l'on configure dans Apache httpd comme suit :</p> @@ -191,19 +191,19 @@ SessionCryptoPassphrase secret</pre> </Location></pre> </div> - <p>L'URL spécifiée par la directive + <p>L'URL spécifiée par la directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code> - référencera en général une page expliquant à l'utilisateur que sa - tentative de connexion a échoué, et qu'il doit la renouveler. La + référencera en général une page expliquant à l'utilisateur que sa + tentative de connexion a échoué, et qu'il doit la renouveler. La directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code> - spécifie l'URL vers laquelle l'utilisateur doit être redirigé s'il - s'est authentifié avec succès.</p> - - <p>Alternativement, l'URL vers laquelle doit être redirigé - l'utilisateur s'il s'est authentifié avec succès peut être - intégrée dans le formulaire de connexion, comme dans l'exemple - ci-dessous. Il en découle que le même gestionnaire - <var>form-login-handler</var> pourra être utilisé pour différentes + spécifie l'URL vers laquelle l'utilisateur doit être redirigé s'il + s'est authentifié avec succès.</p> + + <p>Alternativement, l'URL vers laquelle doit être redirigé + l'utilisateur s'il s'est authentifié avec succès peut être + intégrée dans le formulaire de connexion, comme dans l'exemple + ci-dessous. Il en découle que le même gestionnaire + <var>form-login-handler</var> pourra être utilisé pour différentes zones du site web.</p> <div class="example"><h3>Exemple de formulaire d'authentification multizone</h3><pre class="prettyprint lang-html"><form method="POST" action="/dologin.html"> @@ -216,41 +216,41 @@ SessionCryptoPassphrase secret</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="inline" id="inline">Connexion à la volée</a></h2> +<h2><a name="inline" id="inline">Connexion à la volée</a></h2> <div class="warning"><h3>Avertissement</h3> <p>Il existe un risque, dans certaines circonstances, que le - formulaire de connexion configuré pour une connexion à la volée - soit soumis plusieurs fois, révélant de ce fait les paramètres - de connexion à l'application sous-jacente. L'administrateur doit - s'assurer que cette dernière est correctement sécurisée afin - d'éviter les éventuels abus. En cas de doute, utilisez une page - de connexion indépendante dédiée.</p> + formulaire de connexion configuré pour une connexion à la volée + soit soumis plusieurs fois, révélant de ce fait les paramètres + de connexion à l'application sous-jacente. L'administrateur doit + s'assurer que cette dernière est correctement sécurisée afin + d'éviter les éventuels abus. En cas de doute, utilisez une page + de connexion indépendante dédiée.</p> </div> - <p>Comme alternative à la page de connexion dédiée pour un site + <p>Comme alternative à la page de connexion dédiée pour un site web, il est possible de configurer <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> - pour authentifier les utilisateurs à la volée, sans les rediriger - vers une autre page, ce qui permet de conserver l'état de la page - courante au cours de la tentative de connexion. Ceci peut s'avérer - utile dans le cas d'une session limitée dans le temps, si le délai - de la session a expiré pendant la requête de l'utilisateur. Ce - dernier peut alors se réauthentifier à la même place, et - poursuivre son activité à partir du point où il en était resté.</p> - - <p>Si un utilisateur non authentifié tente d'accéder à une page - protégée par <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, et si ce dernier - n'est pas configuré avec une directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>, - un code de statut <var>HTTP_UNAUTHORIZED</var> est renvoyé vers le - navigateur, indiquant à l'utilisateur qu'il n'est pas autorisé à - accéder à cette page.</p> - - <p>Pour configurer l'authentification à la volée, l'administrateur - remplace le message d'erreur renvoyé par le code de statut - <var>HTTP_UNAUTHORIZED</var> par un message d'erreur personnalisé + pour authentifier les utilisateurs à la volée, sans les rediriger + vers une autre page, ce qui permet de conserver l'état de la page + courante au cours de la tentative de connexion. Ceci peut s'avérer + utile dans le cas d'une session limitée dans le temps, si le délai + de la session a expiré pendant la requête de l'utilisateur. Ce + dernier peut alors se réauthentifier à la même place, et + poursuivre son activité à partir du point où il en était resté.</p> + + <p>Si un utilisateur non authentifié tente d'accéder à une page + protégée par <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, et si ce dernier + n'est pas configuré avec une directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>, + un code de statut <var>HTTP_UNAUTHORIZED</var> est renvoyé vers le + navigateur, indiquant à l'utilisateur qu'il n'est pas autorisé à + accéder à cette page.</p> + + <p>Pour configurer l'authentification à la volée, l'administrateur + remplace le message d'erreur renvoyé par le code de statut + <var>HTTP_UNAUTHORIZED</var> par un message d'erreur personnalisé contenant le formulaire de connexion comme suit :</p> - <div class="example"><h3>Exemple simple d'authentification à la volée</h3><pre class="prettyprint lang-config">AuthFormProvider file + <div class="example"><h3>Exemple simple d'authentification à la volée</h3><pre class="prettyprint lang-config">AuthFormProvider file ErrorDocument 401 "/login.shtml" AuthUserFile "conf/passwd" AuthType form @@ -262,47 +262,47 @@ SessionCryptoPassphrase secret</pre> </div> <p>La page du message d'erreur doit contenir un formulaire de - connexion dont la propriété action est vide, comme dans l'exemple - ci-dessous. Ceci a pour effet de soumettre le formulaire à l'URL - protégée originale, cette dernière n'ayant pas besoin d'être + connexion dont la propriété action est vide, comme dans l'exemple + ci-dessous. Ceci a pour effet de soumettre le formulaire à l'URL + protégée originale, cette dernière n'ayant pas besoin d'être connue de la page en cours.</p> - <div class="example"><h3>Exemple de formulaire de connexion à la volée</h3><pre class="prettyprint lang-html"><form method="POST" <strong>action=""</strong>> + <div class="example"><h3>Exemple de formulaire de connexion à la volée</h3><pre class="prettyprint lang-html"><form method="POST" <strong>action=""</strong>> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> </form></pre> </div> - <p>Lorsque l'utilisateur final a entré ses informations de - connexion, le formulaire effectue une requête HTTP POST pour l'URL - originale protégée par mot de passe. - <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> va alors intercepter cette requête - POST, et dans le cas où des champs HTML Utilisateur et Mot de - passe corrects sont présents, l'utilisateur sera connecté, et - l'URL originale protégée par mot de passe lui sera retournée en - tant que requête GET.</p> + <p>Lorsque l'utilisateur final a entré ses informations de + connexion, le formulaire effectue une requête HTTP POST pour l'URL + originale protégée par mot de passe. + <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> va alors intercepter cette requête + POST, et dans le cas où des champs HTML Utilisateur et Mot de + passe corrects sont présents, l'utilisateur sera connecté, et + l'URL originale protégée par mot de passe lui sera retournée en + tant que requête GET.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="inlinepreservebody" id="inlinepreservebody">Connexion à la volée avec +<h2><a name="inlinepreservebody" id="inlinepreservebody">Connexion à la volée avec conservation du contenu</a></h2> - <p>Il existe une limite à la technique de connexion à la volée - décrite ci-dessus ; si un formulaire HTML POST entraîne une - demande d'authentification ou de réauthentification, le contenu du - formulaire original envoyé par le navigateur sera perdu. Cela peut - s'avérer plus ou moins gênant pour l'utilisateur final selon la + <p>Il existe une limite à la technique de connexion à la volée + décrite ci-dessus ; si un formulaire HTML POST entraîne une + demande d'authentification ou de réauthentification, le contenu du + formulaire original envoyé par le navigateur sera perdu. Cela peut + s'avérer plus ou moins gênant pour l'utilisateur final selon la fonction du site web.</p> - <p>Comme solution à ce problème, <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> - permet d'intégrer la méthode et le contenu de la requête originale - dans le formulaire de connexion. Si l'authentification réussit, - Apache httpd pourra refaire une tentative avec la méthode et le contenu - originaux, tout en conservant l'état de la requête originale.</p> + <p>Comme solution à ce problème, <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> + permet d'intégrer la méthode et le contenu de la requête originale + dans le formulaire de connexion. Si l'authentification réussit, + Apache httpd pourra refaire une tentative avec la méthode et le contenu + originaux, tout en conservant l'état de la requête originale.</p> <p>Pour mettre en oeuvre la conservation du contenu, vous devez - ajouter trois champs supplémentaires au formulaire de connexion + ajouter trois champs supplémentaires au formulaire de connexion comme dans l'exemple suivant :</p> <div class="example"><h3>Exemple de formulaire avec conservation du @@ -316,19 +316,19 @@ SessionCryptoPassphrase secret</pre> </form></pre> </div> - <p>La manière dont la méthode, le type MIME et le contenu de la - requête originale seront intégrés dans le formulaire de connexion - vont dépendre de la plate-forme et de la technologie utilisées au + <p>La manière dont la méthode, le type MIME et le contenu de la + requête originale seront intégrés dans le formulaire de connexion + vont dépendre de la plate-forme et de la technologie utilisées au sein du site web. </p> - <p>Une option consiste à utiliser le module + <p>Une option consiste à utiliser le module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> en association avec la directive <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>, ainsi - qu'un script CGI adapté pour intégrer les variables dans le + qu'un script CGI adapté pour intégrer les variables dans le formulaire.</p> - <p>Une autre option consiste à présenter le formulaire de + <p>Une autre option consiste à présenter le formulaire de connexion en utilisant un script CGI ou une autre technologie dynamique.</p> @@ -339,23 +339,23 @@ SessionCryptoPassphrase secret</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="loggingout" id="loggingout">Déconnexion</a></h2> +<h2><a name="loggingout" id="loggingout">Déconnexion</a></h2> - <p>Pour permettre à un utilisateur de se déconnecter d'une session - particulière, vous devez configurer une page pour qu'elle soit - traitée par le gestionnaire <var>form-logout-handler</var>. Tout - accès à cette URL va entraîner la suppression de l'Utilisateur et + <p>Pour permettre à un utilisateur de se déconnecter d'une session + particulière, vous devez configurer une page pour qu'elle soit + traitée par le gestionnaire <var>form-logout-handler</var>. Tout + accès à cette URL va entraîner la suppression de l'Utilisateur et du Mot de passe de la session courante, ce qui aura pour effet de - déconnecter l'utilisateur.</p> + déconnecter l'utilisateur.</p> - <p>Vous pouvez spécifier une URL vers laquelle le navigateur sera - redirigé en cas de déconnection réussie, en définissant la + <p>Vous pouvez spécifier une URL vers laquelle le navigateur sera + redirigé en cas de déconnection réussie, en définissant la directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>. Cette - URL devra expliquer à l'utilisateur qu'il a été déconnecté, et lui - donner la possibilité de se connecter à nouveau.</p> + URL devra expliquer à l'utilisateur qu'il a été déconnecté, et lui + donner la possibilité de se connecter à nouveau.</p> <div class="example"><h3>Exemple simple de configuration de la - déconnexion</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler + déconnexion</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler AuthName realm AuthFormLogoutLocation "http://example.com/loggedout.html" Session On @@ -363,18 +363,18 @@ SessionCookieName session path=/ SessionCryptoPassphrase secret</pre> </div> - <p>Notez que la déconnexion d'un utilisateur ne supprime pas la + <p>Notez que la déconnexion d'un utilisateur ne supprime pas la session ; elle supprime seulement l'utilisateur et le mot de passe - de la session. Si la session qui en résulte est vide, elle sera - probablement supprimée, mais ce n'est pas garanti. Si vous voulez - être sûr que la session sera supprimée, affectez une valeur faible - à la directive <code class="directive"><a href="../mod/mod_session.html#sessionmaxage">SessionMaxAge</a></code>, par exemple 1 - (affecter à cette directive la valeur zéro signifie une session - sans limite d'âge). + de la session. Si la session qui en résulte est vide, elle sera + probablement supprimée, mais ce n'est pas garanti. Si vous voulez + être sûr que la session sera supprimée, affectez une valeur faible + à la directive <code class="directive"><a href="../mod/mod_session.html#sessionmaxage">SessionMaxAge</a></code>, par exemple 1 + (affecter à cette directive la valeur zéro signifie une session + sans limite d'âge). </p> - <div class="example"><h3>Exemple simple avec durée de validité de session - limitée</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler + <div class="example"><h3>Exemple simple avec durée de validité de session + limitée</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionMaxAge 1 @@ -387,103 +387,103 @@ SessionCryptoPassphrase secret</pre> <h2><a name="urlencoding" id="urlencoding">Noms d'utilisateurs et mots de passe</a></h2> <p>Notez que la soumission d'un formulaire implique l'encodage URL - (URLEncoding) des données du formulaire, ici le nom d'utilisateur et + (URLEncoding) des données du formulaire, ici le nom d'utilisateur et le mot de passe. Vous devez donc choisir des noms d'utilisateurs et - mots de passe qui ne contiennent pas de caractères susceptibles - d'être encodés URL lors de la soumission du formulaire, sous peine - d'obtenir des résultats inattendus.</p> + mots de passe qui ne contiennent pas de caractères susceptibles + d'être encodés URL lors de la soumission du formulaire, sous peine + d'obtenir des résultats inattendus.</p> </div> <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>Détermine si l'autorisation et l'authentification sont confiés à +<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#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#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>Normalement, chacun des modules d'autorisation spécifiés par la + <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 + 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 + <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 + 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> + 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>Le nom du champ de formulaire contenant le corps de la -requête à effectuer en cas de connexion réussie</td></tr> +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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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> + 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>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 + <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>Désactive l'en-tête CacheControl no-store sur la page de +<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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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 + 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> + 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>Simule une en-tête d'authentification de base</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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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é à + 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> @@ -492,74 +492,74 @@ connexion</td></tr> <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>Le nom du champ de formulaire qui contiendra l'URL vers -laquelle l'utilisateur sera redirigé en cas de connexion -réussie</td></tr> +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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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 + 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> + 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>L'URL de la page vers laquelle on doit être redirigé si une +<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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP -Apache. L'interprétation des expressions rationnelles est supportée +<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>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> + 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>Vous pouvez utiliser cette directive si vous voulez présenter une - page de connexion personnalisée à vos utilisateurs.</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>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#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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP -Apache. L'interprétation des expressions rationnelles est supportée +<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>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>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 + 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>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> @@ -567,26 +567,26 @@ depuis la version 2.4.4.</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="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>L'URL vers laquelle un utilisateur devra être redirigé -après s'être déconnecté</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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP -Apache. L'interprétation des expressions rationnelles est supportée +<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>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> + 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>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> + <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>Exemple</h3><pre class="prettyprint lang-config"><Location "/logout"> SetHandler form-logout-handler @@ -596,33 +596,33 @@ depuis la version 2.4.4.</td></tr> </Location></pre> </div> - <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> + <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>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#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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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> + 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>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 + <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> @@ -630,22 +630,22 @@ requête à effectuer en cas de connexion réussie</td></tr> <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>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> +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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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> + 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>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 + <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> @@ -655,36 +655,36 @@ réussie</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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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> + 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>Définit le(s) fournisseur(s) d'authentification pour la -zone concernée</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#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>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 + 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> + choisi soit bien présent dans le serveur.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/secure"> AuthType form @@ -697,7 +697,7 @@ zone concernée</td></tr> </Location></pre> </div> - <p>Les différents fournisseurs sont implémentés par les modules + <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> @@ -706,39 +706,39 @@ zone concernée</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="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>Court-circuite l'authentification pour les sites à fort +<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#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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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 + 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 + <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é + <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 + <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 + 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> + 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> @@ -749,22 +749,22 @@ trafic</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#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>Disponible depuis la version 2.3.0 du serveur HTTP Apache</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>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 + <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>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 + <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>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 + <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> @@ -775,21 +775,21 @@ extraites les informations de connexion</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#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#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>Disponible depuis la version 2.3.3 du serveur HTTP Apache</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>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> + 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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_auth_form.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_auth_form.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -808,7 +808,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_form. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_anon.html b/docs/manual/mod/mod_authn_anon.html index c98bacbf4b..66f20d70d9 100644 --- a/docs/manual/mod/mod_authn_anon.html +++ b/docs/manual/mod/mod_authn_anon.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_anon.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authn_anon.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authn_anon.html.fr b/docs/manual/mod/mod_authn_anon.html.fr index a937040f0a..858e4c4777 100644 --- a/docs/manual/mod/mod_authn_anon.html.fr +++ b/docs/manual/mod/mod_authn_anon.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,37 +27,37 @@ <div id="preamble"><h1>Module Apache mod_authn_anon</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_anon.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_anon.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_anon.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_anon.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_anon.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet un accès "anonyme" à des zones -authentifiées</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet un accès "anonyme" à des zones +authentifiées</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_anon_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_anon.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_anon_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_anon.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet aux frontaux d'authentification comme <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> d'authentifier les utilisateurs - à la manière des sites FTP anonymes, c'est à dire - en fournissant l'identifiant utilisateur spécial 'anonymous' et - l'adresse email comme mot de passe. Ces adresses email peuvent être - journalisées.</p> + à la manière des sites FTP anonymes, c'est à dire + en fournissant l'identifiant utilisateur spécial 'anonymous' et + l'adresse email comme mot de passe. Ces adresses email peuvent être + journalisées.</p> - <p>En combinaison avec d'autres méthodes de contrôle d'accès (base - de données), ce module permet d'effectuer un véritable suivi des - utilisateurs et une personnalisation de leurs accès en fonction de - leur profil, tout en conservant l'accessibilité du site aux - utilisateurs 'non enregistrés'. Un avantage du suivi des - utilisateurs basé sur l'authentification réside dans le fait qu'il - est, à l'opposé des cookies magiques et des drôles d'URLs avec - préfixes ou suffixes, entièrement indépendant du navigateur et qu'il + <p>En combinaison avec d'autres méthodes de contrôle d'accès (base + de données), ce module permet d'effectuer un véritable suivi des + utilisateurs et une personnalisation de leurs accès en fonction de + leur profil, tout en conservant l'accessibilité du site aux + utilisateurs 'non enregistrés'. Un avantage du suivi des + utilisateurs basé sur l'authentification réside dans le fait qu'il + est, à l'opposé des cookies magiques et des drôles d'URLs avec + préfixes ou suffixes, entièrement indépendant du navigateur et qu'il permet de partager des URLs entre plusieurs utilisateurs.</p> <p>Si l'on utilise le module <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, le - module <code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code> est invoqué en affectant la - valeur <code>anon</code> à la directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>.</p> + module <code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code> est invoqué en affectant la + valeur <code>anon</code> à la directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -74,29 +74,29 @@ authentifiées</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="example" id="example">Exemple</a></h2> - <p>L'exemple ci-dessous présente un exemple de combinaison avec - l'authentification à base de fichier htpasswd "normale", et permet - la connexion d'utilisateurs en tant qu'invités avec les propriétés + <p>L'exemple ci-dessous présente un exemple de combinaison avec + l'authentification à base de fichier htpasswd "normale", et permet + la connexion d'utilisateurs en tant qu'invités avec les propriétés suivantes :</p> <ul> - <li>Il incite l'utilisateur à fournir un identifiant. + <li>Il incite l'utilisateur à fournir un identifiant. (<code class="directive"><a href="#anonymous_nouserid">Anonymous_NoUserID</a></code>)</li> - <li>Il incite l'utilisateur à fournir un mot de passe. + <li>Il incite l'utilisateur à fournir un mot de passe. (<code class="directive"><a href="#anonymous_mustgiveemail">Anonymous_MustGiveEmail</a></code>)</li> - <li>Le mot de passe fourni doit être une adresse email valide, - c'est à dire contenant au moins un '@' et un '.'. + <li>Le mot de passe fourni doit être une adresse email valide, + c'est à dire contenant au moins un '@' et un '.'. (<code class="directive"><a href="#anonymous_verifyemail">Anonymous_VerifyEmail</a></code>)</li> <li>Les valeurs possibles pour l'identifiant utilisateur sont <code>anonymous, guest, www, test ou welcome</code>, et la - vérification n'est <strong>pas</strong> sensible à la casse. + vérification n'est <strong>pas</strong> sensible à la casse. (<code class="directive"><a href="#anonymous">Anonymous</a></code>)</li> - <li>Les adresses email entrées dans le champ passwd sont - enregistrées dans le fichier journal des erreurs. + <li>Les adresses email entrées dans le champ passwd sont + enregistrées dans le fichier journal des erreurs. (<code class="directive"><a href="#anonymous_logemail">Anonymous_LogEmail</a></code>)</li> </ul> @@ -119,117 +119,117 @@ authentifiées</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="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>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#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#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>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 + <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> + ou ", ou le caractère d'échappement \.</p> - <p>Veuillez noter que la vérification <strong>n'est pas sensible à + <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 + Il est fortement conseillé d'intégrer l'utilisateur spécial '<code>anonymous</code>' dans la liste des identifiants.</p> <div class="example"><h3>Exemple:</h3><pre class="prettyprint lang-config">Anonymous anonymous "Not Registered" "I don't know"</pre> </div> - <p>Dans cet exemple, l'utilisateur peut accéder au site sans - vérification du mot de passe en utilisant l'identifiant "anonymous", + <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>Depuis Apache 2.1, il est possible de remplacer la liste des - identifiants autorisés par le caractère "<code>*</code>", ce qui + 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> + 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>Détermine si le mot de passe fourni sera enregistré dans le +<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#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#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>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> + <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>Détermine si l'abscence de mot de passe est -autorisée</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#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#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>Détermine si l'utilisateur doit spécifier une adresse email comme - mot de passe. Lorsque cette directive est définie à <code>On</code>, + <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>Détermine si le champ identifiant peut être +<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#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#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>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 + <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 + 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>Détermine s'il faut vérifier que le format de l'adresse +<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#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#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>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 + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_anon.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_anon.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_anon.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_anon.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_anon.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -250,7 +250,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_anon } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_core.html b/docs/manual/mod/mod_authn_core.html index 08c846a709..6df5ef41bf 100644 --- a/docs/manual/mod/mod_authn_core.html +++ b/docs/manual/mod/mod_authn_core.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_core.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authn_core.html.fr b/docs/manual/mod/mod_authn_core.html.fr index e810d4d3e7..01e57ded0b 100644 --- a/docs/manual/mod/mod_authn_core.html.fr +++ b/docs/manual/mod/mod_authn_core.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,24 +27,24 @@ <div id="preamble"><h1>Module Apache mod_authn_core</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Le noyau de l'authentification</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_core_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_core.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_core_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_core.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit le coeur des fonctionnalités d'authentification - permettant d'accorder ou de refuser l'accès à certaines zones du + <p>Ce module fournit le coeur des fonctionnalités d'authentification + permettant d'accorder ou de refuser l'accès à certaines zones du site web. Les directives fournies par le module - <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> sont communes à tous les + <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> sont communes à tous les fournisseurs d'authentification.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#authnalias">Création d'alias de fournisseurs +<li><img alt="" src="../images/down.gif" /> <a href="#authnalias">Création d'alias de fournisseurs d'authentification</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -55,30 +55,30 @@ d'authentification</a></li> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="authnalias" id="authnalias">Création d'alias de fournisseurs +<h2><a name="authnalias" id="authnalias">Création d'alias de fournisseurs d'authentification</a></h2> - <p>Il est possible de créer des fournisseurs d'authentification - étendus dans le fichier de configuration et de leur assigner un - alias. Le fournisseur ainsi nommé peut alors être référencé à l'aide + <p>Il est possible de créer des fournisseurs d'authentification + étendus dans le fichier de configuration et de leur assigner un + alias. Le fournisseur ainsi nommé peut alors être référencé à 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> tout comme - un fournisseur d'authentification de base. Outre la possibilité de - créer et attribuer un alias à un fournisseur étendu, le même - fournisseur d'authentification peut aussi être référencé par - plusieurs sections relatives à une zone du site web.</p> + un fournisseur d'authentification de base. Outre la possibilité de + créer et attribuer un alias à un fournisseur étendu, le même + fournisseur d'authentification peut aussi être référencé par + plusieurs sections relatives à une zone du site web.</p> <h3><a name="example" id="example">Exemples</a></h3> - <p>Cet exemple vérifie les mots de passe dans deux fichiers - textes différents.</p> + <p>Cet exemple vérifie les mots de passe dans deux fichiers + textes différents.</p> - <div class="example"><h3>Vérification dans plusieurs fichiers de mots de - passe au format texte</h3><pre class="prettyprint lang-config"># Première vérification + <div class="example"><h3>Vérification dans plusieurs fichiers de mots de + passe au format texte</h3><pre class="prettyprint lang-config"># Première vérification <AuthnProviderAlias file file1> AuthUserFile "/www/conf/passwords1" </AuthnProviderAlias> -# Vérification suivante +# Vérification suivante <AuthnProviderAlias file file2> AuthUserFile "/www/conf/passwords2" </AuthnProviderAlias> @@ -95,12 +95,12 @@ d'authentification</a></h2> <p>Dans l'exemple ci-dessous, deux fournisseurs - d'authentification ldap sont créés à partir du fournisseur ldap + d'authentification ldap sont créés à partir du fournisseur ldap de base, et se voient attribuer un alias. L'authentification - d'une même zone peut alors être traitée par plusieurs serveurs + d'une même zone peut alors être traitée par plusieurs serveurs ldap :</p> - <div class="example"><h3>Vérification auprès de plusieurs serveurs + <div class="example"><h3>Vérification auprès de plusieurs serveurs LDAP</h3><pre class="prettyprint lang-config"><AuthnProviderAlias ldap ldap-alias1> AuthLDAPBindDN "cn=youruser,o=ctx" AuthLDAPBindPassword yourpassword @@ -122,7 +122,7 @@ Alias "/secure" "/webpages/secure" Require valid-user # Notez que Require ldap-* ne fonctionnerait pas ici, car # AuthnProviderAlias ne fournit pas de configuration pour les - # fournisseurs d'autorisation implémentés dans le même module que le + # fournisseurs d'autorisation implémentés dans le même module que le # fournisseur d'authentification. </Directory></pre> </div> @@ -132,21 +132,21 @@ Alias "/secure" "/webpages/secure" <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>L'identifiant de l'autorisation à utiliser avec +<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#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>Cette directive permet de définir l'identifiant d'autorisation - pour un répertoire. Cet identifiant est fourni au client de façon à + <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 + 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 + 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> @@ -154,12 +154,12 @@ l'authentification HTTP</td></tr> <pre class="prettyprint lang-config">AuthName "Top Secret"</pre> - <p>La chaîne fournie comme argument à <code>AuthName</code> - apparaîtra dans la boîte de dialogue d'authentification pour la + <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>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>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>Exemple :</p> @@ -169,8 +169,8 @@ l'authentification HTTP</td></tr> <h3>Voir aussi</h3> <ul> -<li><a href="../howto/auth.html">Authentification, autorisation et contrôle - d'accès</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> @@ -179,7 +179,7 @@ l'authentification HTTP</td></tr> <table class="directive"> <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> +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> @@ -188,11 +188,11 @@ l'alias spécifié</td></tr> </table> <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> + 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 + d'autorisation, même pour les modules qui fournissent à la fois l'authentification et l'autorisation.</div> @@ -202,17 +202,17 @@ l'alias spécifié</td></tr> <table class="directive"> <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#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>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é + <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 + (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 @@ -221,14 +221,14 @@ l'alias spécifié</td></tr> 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, + <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 + 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"> @@ -245,27 +245,27 @@ l'alias spécifié</td></tr> </Directory></pre> - <p>A partir de la version 2.4.13, il est possible de définir cette + <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> + spécifier le type d'authentification de manière dynamique.</p> <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 + 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">Authentification, autorisation et contrôle - d'accès</a></li> +<li><a href="../howto/auth.html">Authentification, autorisation et contrôle + d'accès</a></li> </ul> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -284,7 +284,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_core } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_dbd.html b/docs/manual/mod/mod_authn_dbd.html index 33b20dc84c..e9d8ad1712 100644 --- a/docs/manual/mod/mod_authn_dbd.html +++ b/docs/manual/mod/mod_authn_dbd.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_dbd.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authn_dbd.html.fr b/docs/manual/mod/mod_authn_dbd.html.fr index aa69bcf818..7ff77fa71a 100644 --- a/docs/manual/mod/mod_authn_dbd.html.fr +++ b/docs/manual/mod/mod_authn_dbd.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,35 +27,35 @@ <div id="preamble"><h1>Module Apache mod_authn_dbd</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_dbd.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur à l'aide d'une base de données +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur à l'aide d'une base de données SQL</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_dbd_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_dbd.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_dbd_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_dbd.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet aux frontaux d'authentification comme <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> et <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> d'authentifier les utilisateurs en les recherchant dans une base de - données SQL. <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, par exemple, fournit - une fonctionnalité similaire.</p> - <p>Ce module s'appuie sur <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour spécifier le - pilote de la base de données sous-jacente et les paramètres de - connexion, mais aussi pour gérer les connexions à la base de - données.</p> + données SQL. <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, par exemple, fournit + une fonctionnalité similaire.</p> + <p>Ce module s'appuie sur <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour spécifier le + pilote de la base de données sous-jacente et les paramètres de + connexion, mais aussi pour gérer les connexions à la base de + données.</p> <p>Si l'on utilise <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>, on peut invoquer ce module en - affectant la valeur <code>dbd</code> à la directive <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> + affectant la valeur <code>dbd</code> à la directive <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> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#socache">Performances et mise en cache</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#example">Exemple de configuration</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#exposed">Mise à disposition des informations de connexion</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#security">Prévention contre les injections SQL</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#exposed">Mise à disposition des informations de connexion</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Prévention contre les injections SQL</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#authdbduserpwquery">AuthDBDUserPWQuery</a></li> @@ -81,20 +81,20 @@ passe</a></li> <h2><a name="socache" id="socache">Performances et mise en cache</a></h2> <p>Certains utilisateurs de l'authentification DBD sous HTTPD 2.2/2.4 ont -signalé une charge problématique au niveau de la base de données. Cela -se produit en général lorsqu'une page HTML contient des centaines d'objets -(comme des images, des scripts, etc...), chacun d'entre eux nécessitant +signalé une charge problématique au niveau de la base de données. Cela +se produit en général lorsqu'une page HTML contient des centaines d'objets +(comme des images, des scripts, etc...), chacun d'entre eux nécessitant une authentification. Les utilisateurs qui rencontrent ce genre de -problème peuvent utiliser le module <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code> -qui permet de mettre les données d'authentification en cache, et -soulager ainsi la base de données de la plus grande partie de la charge.</p> +problème peuvent utiliser le module <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code> +qui permet de mettre les données d'authentification en cache, et +soulager ainsi la base de données de la plus grande partie de la charge.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="example" id="example">Exemple de configuration</a></h2> <p>Voici un exemple simple d'utilisation de ce module dans un contexte -d'authentification et de bases de données.</p> -<pre class="prettyprint lang-config"># configuration de mod_dbd modifiée pour inclure la mise en cache de +d'authentification et de bases de données.</p> +<pre class="prettyprint lang-config"># configuration de mod_dbd modifiée pour inclure la mise en cache de # l'authentification DBDriver pgsql DBDParams "dbname=apacheauth user=apache password=xxxxxx" @@ -110,11 +110,11 @@ DBDExptime 300 AuthType Basic AuthName "Mon serveur" - # Pour mettre en cache les données d'authentification, placez socache + # Pour mettre en cache les données d'authentification, placez socache # avant dbd AuthBasicProvider socache dbd - # Aussi nécessaire à la mise en cache : dire au cache de mettre en + # Aussi nécessaire à la mise en cache : dire au cache de mettre en # cache les recherches dbd ! AuthnCacheProvideFor dbd AuthnCacheContext mon-serveur @@ -122,123 +122,123 @@ DBDExptime 300 # configuration de mod_authz_core Require valid-user - # la requête SQL de mod_authn_dbd pour authentifier un utilisateur + # la requête SQL de mod_authn_dbd pour authentifier un utilisateur AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" </Directory></pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="exposed" id="exposed">Mise à disposition des informations de connexion</a></h2> +<h2><a name="exposed" id="exposed">Mise à disposition des informations de connexion</a></h2> <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>, pour chaque requête envoyée au serveur de -base de données, toutes les valeurs de colonnes du premier -enregistrement renvoyé par la requête sont affectées à des variables -d'environnement avec le préfixe "AUTHENTICATE_". +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>, pour chaque requête envoyée au serveur de +base de données, toutes les valeurs de colonnes du premier +enregistrement renvoyé par la requête sont affectées à des variables +d'environnement avec le préfixe "AUTHENTICATE_". </p> -<p>Par exemple, si une requête renvoie un nom d'utilisateur, un nom -complet et un numéro de téléphone, un programme CGI pourra accéder à ces -informations sans avoir besoin d'effectuer une deuxième requête vers la -base de données.</p> -<p>Ceci va entraîner une simplification considérable du code et de la -configuration nécessaire de certaines applications web. +<p>Par exemple, si une requête renvoie un nom d'utilisateur, un nom +complet et un numéro de téléphone, un programme CGI pourra accéder à ces +informations sans avoir besoin d'effectuer une deuxième requête vers la +base de données.</p> +<p>Ceci va entraîner une simplification considérable du code et de la +configuration nécessaire de certaines applications web. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="security" id="security">Prévention contre les injections SQL</a></h2> +<h2><a name="security" id="security">Prévention contre les injections SQL</a></h2> - <p>Selon le driver DBD et le serveur d'arrière-plan que vous utilisez, - vous devrez prendre garde à la sécurité dans le domaine SQL. - Avec la plupart des drivers, vous n'avez rien à faire : la - requête est préparée par la base de données au démarrage, et l'entrée - utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez - peut-être à nettoyer cette entrée. Au moment où ces lignes sont - écrites, le seul driver qui peut nécessiter le nettoyage de l'entrée + <p>Selon le driver DBD et le serveur d'arrière-plan que vous utilisez, + vous devrez prendre garde à la sécurité dans le domaine SQL. + Avec la plupart des drivers, vous n'avez rien à faire : la + requête est préparée par la base de données au démarrage, et l'entrée + utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez + peut-être à nettoyer cette entrée. Au moment où ces lignes sont + écrites, le seul driver qui peut nécessiter le nettoyage de l'entrée est FreeTDS.</p> - <p>Veuillez vous référez à la documentation de - <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour plus d'informations à propos de la - sécurité dans ce domaine.</p> + <p>Veuillez vous référez à la documentation de + <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour plus d'informations à propos de la + sécurité dans ce domaine.</p> </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>Requête SQL servant à vérifier le mot de passe d'un +<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#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>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> + 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>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 + <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>Le format du mot de passe chiffré dépend du frontal - d'authentification utilisé (par exemple + <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> + 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>Requête SQL servant à vérifier une empreinte de mot de +<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>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#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>La directive <code class="directive">AuthDBDUserRealmQuery</code> spécifie - une requête SQL servant à vérifier une empreinte de mot + <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 + 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> + 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>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 + <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>Le format du mot de passe chiffré dépend du frontal - d'authentification utilisé (par exemple + <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> + plus de détails.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_dbd.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -257,7 +257,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_dbd. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_dbm.html b/docs/manual/mod/mod_authn_dbm.html index fda22b5226..4e1a6cf23d 100644 --- a/docs/manual/mod/mod_authn_dbm.html +++ b/docs/manual/mod/mod_authn_dbm.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_dbm.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authn_dbm.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authn_dbm.html.fr b/docs/manual/mod/mod_authn_dbm.html.fr index 1733dcd60d..265f93635f 100644 --- a/docs/manual/mod/mod_authn_dbm.html.fr +++ b/docs/manual/mod/mod_authn_dbm.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,26 +27,26 @@ <div id="preamble"><h1>Module Apache mod_authn_dbm</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_dbm.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_dbm.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_dbm.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_dbm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur utilisant des fichiers DBM</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_dbm_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_dbm.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_dbm_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_dbm.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet aux frontaux comme <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> et <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> d'authentifier les utilisateurs en les recherchant dans des fichiers de mots de passe <dfn>dbm</dfn>. <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> - fournit une fonctionnalité similaire.</p> + fournit une fonctionnalité similaire.</p> <p>Lorsqu'on utilise <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>, ce module est invoqué en affectant - la valeur <code>dbm</code> à la directive <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> + <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>, ce module est invoqué en affectant + la valeur <code>dbm</code> à la directive <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> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -72,76 +72,76 @@ passe</a></li> <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>Définit le type de fichier de base de données utilisé pour +<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#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#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>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 <a href="../install.html#dbm">configuration de la compilation</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 <a href="../install.html#dbm">configuration de la compilation</a>.</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> + <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>Définit le nom d'un fichier de base de données pour +<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#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>La directive <code class="directive">AuthDBMUserFile</code> définit - le nom d'un fichier de base de données pour + <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> + mots de passe. <var>chemin-fichier</var> doit être un chemin absolu + vers le fichier de base de données.</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> + <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>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 + <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> + 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>Le format de mot de passe chiffré dépend du frontal - d'authentification utilisé (par exemple + <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> + passe</a> pour plus de détails.</p> - <p>Note importante concernant la compatibilité : l'implémentation de + <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 + 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> + 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>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 + <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> @@ -150,7 +150,7 @@ des utilisateurs et de leurs mots de passe</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_dbm.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_dbm.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_dbm.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_dbm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -171,7 +171,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_dbm. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_file.html b/docs/manual/mod/mod_authn_file.html index c718bed0b8..b94160d41d 100644 --- a/docs/manual/mod/mod_authn_file.html +++ b/docs/manual/mod/mod_authn_file.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_file.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authn_file.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authn_file.html.fr b/docs/manual/mod/mod_authn_file.html.fr index a501784d5b..701bd16a32 100644 --- a/docs/manual/mod/mod_authn_file.html.fr +++ b/docs/manual/mod/mod_authn_file.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,26 +27,26 @@ <div id="preamble"><h1>Module Apache mod_authn_file</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_file.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur à l'aide de fichiers +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur à l'aide de fichiers texte</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_file_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_file.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_file_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_file.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet aux frontaux d'authentification comme <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> et <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> d'authentifier les utilisateurs en les recherchant dans des fichiers de mots de passe au format texte. <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> - fournit une fonctionnalité similaire.</p> + fournit une fonctionnalité similaire.</p> <p>Lorsqu'on utilise <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>, ce module peut être invoqué en - affectant la valeur <code>file</code> à la directive <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> + <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>, ce module peut être invoqué en + affectant la valeur <code>file</code> à la directive <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> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -69,44 +69,44 @@ passe</a></li> <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>Définit le nom d'un fichier texte pour l'authentification +<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#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>La directive <code class="directive">AuthUserFile</code> permet de - définir le nom d'un fichier texte pour l'authentification contenant + 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> + 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>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> + 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>Le format du mot de passe chiffré dépend du frontal - d'authentification utilisé (par exemple + <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> + passe</a> pour plus de détails.</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 + 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> + détails. En bref :</p> - <p>On crée un fichier de mots de passe <code>nom-fichier</code> avec + <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> + passe correspondant sera alors demandé :</p> <div class="example"><p><code> htpasswd -c nom-fichier nom-utilisateur @@ -119,29 +119,29 @@ passe</td></tr> htpasswd nom-fichier nom-utilisateur2 </code></p></div> - <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 + <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>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> + 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>Sécurité</h3> + <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 + 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> + 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> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_file.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -162,7 +162,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_file } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authn_socache.html b/docs/manual/mod/mod_authn_socache.html index 48df116504..6677148624 100644 --- a/docs/manual/mod/mod_authn_socache.html +++ b/docs/manual/mod/mod_authn_socache.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authn_socache.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authn_socache.html.fr b/docs/manual/mod/mod_authn_socache.html.fr index d06f852c4f..57e700c50c 100644 --- a/docs/manual/mod/mod_authn_socache.html.fr +++ b/docs/manual/mod/mod_authn_socache.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,22 +27,22 @@ <div id="preamble"><h1>Module Apache mod_authn_socache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_socache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_socache.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_socache.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gère un cache des données d'authentification pour diminuer -la charge des serveurs d'arrière-plan</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gère un cache des données d'authentification pour diminuer +la charge des serveurs d'arrière-plan</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_socache_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_socache.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.3 et ultérieures</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_socache_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_socache.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.3 et ultérieures</td></tr></table> <h3>Sommaire</h3> - <p>Maintient un cache des données d'authentification pour limiter - les sollicitations du serveur d'arrière-plan.</p> + <p>Maintient un cache des données d'authentification pour limiter + les sollicitations du serveur d'arrière-plan.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#intro">Mise en cache des données d'authentification</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#intro">Mise en cache des données d'authentification</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#usage">Utilisation</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#dev">La mise en cache avec les modules tiers</a></li> </ul><h3 class="directives">Directives</h3> @@ -56,35 +56,35 @@ la charge des serveurs d'arrière-plan</td></tr> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="intro" id="intro">Mise en cache des données d'authentification</a></h2> +<h2><a name="intro" id="intro">Mise en cache des données d'authentification</a></h2> <p>Certains utilisateurs qui mettent oeuvre une authentification - lourde s'appuyant par exemple sur des requêtes SQL - (<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>) ont signalé une charge induite + lourde s'appuyant par exemple sur des requêtes SQL + (<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>) ont signalé une charge induite inacceptable sur leur fournisseur d'authentification. Cela se - produit typiquement dans le cas où une page HTML contient des + produit typiquement dans le cas où une page HTML contient des centaines d'objets (images, scripts, pages de styles, media, - etc...), et où une requête pour cette page génère des centaines de - sous-requêtes à effet immédiat pour des contenus supplémentaires - authentifiés.</p> - <p>Pour résoudre ce problème, mod_authn_socache fournit une solution - qui permet de maintenir un cache des données d'authentification.</p> + etc...), et où une requête pour cette page génère des centaines de + sous-requêtes à effet immédiat pour des contenus supplémentaires + authentifiés.</p> + <p>Pour résoudre ce problème, mod_authn_socache fournit une solution + qui permet de maintenir un cache des données d'authentification.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="usage" id="usage">Utilisation</a></h2> - <p>Le cache d'authentification doit être utilisé lorsque les - requêtes d'authentification induisent une charge significative sur le - serveur, le serveur d'arrière-plan ou le réseau. Cette mise en cache - n'apportera probablement aucune amélioration dans le cas d'une - authentification à base de fichier (<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>) - ou de base de données dbm (<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>) car ces - méthodes sont de par leur conception rapides et légères (la mise en - cache peut cependant s'avérer utile dans le cas où le fichier est - situé sur un montage réseau). Les fournisseurs d'authentification - basés sur SQL ou LDAP ont plus de chances de tirer parti de cette - mise en cache, en particulier lorsqu'un problème de performances est - détecté. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> gérant son propre cache, - seul <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> est concerné par notre sujet.</p> - <p>Les principales règles à appliquer pour la mise en cache sont :</p> + <p>Le cache d'authentification doit être utilisé lorsque les + requêtes d'authentification induisent une charge significative sur le + serveur, le serveur d'arrière-plan ou le réseau. Cette mise en cache + n'apportera probablement aucune amélioration dans le cas d'une + authentification à base de fichier (<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>) + ou de base de données dbm (<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>) car ces + méthodes sont de par leur conception rapides et légères (la mise en + cache peut cependant s'avérer utile dans le cas où le fichier est + situé sur un montage réseau). Les fournisseurs d'authentification + basés sur SQL ou LDAP ont plus de chances de tirer parti de cette + mise en cache, en particulier lorsqu'un problème de performances est + détecté. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> gérant son propre cache, + seul <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> est concerné par notre sujet.</p> + <p>Les principales règles à appliquer pour la mise en cache sont :</p> <ol><li>Inclure le fournisseur pour lequel vous voulez effectuer une mise en cache dans une directive <code class="directive">AuthnCacheProvideFor</code>.</li> @@ -93,10 +93,10 @@ la charge des serveurs d'arrière-plan</td></tr> <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>.</li> </ol> - <p>Voici un exemple simple permettant d'accélérer + <p>Voici un exemple simple permettant d'accélérer <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et utilisant dbm comme moteur de la mise en cache :</p> - <pre class="prettyprint lang-config"> #AuthnCacheSOCache est optionnel. S'il est défini, il l'est pour + <pre class="prettyprint lang-config"> #AuthnCacheSOCache est optionnel. S'il est défini, il l'est pour #l'ensemble du serveur AuthnCacheSOCache dbm <Directory "/usr/www/myhost/private"> @@ -113,44 +113,44 @@ AuthnCacheSOCache dbm </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="dev" id="dev">La mise en cache avec les modules tiers</a></h2> - <p>Les développeurs de modules doivent savoir que la mise en cache - avec mod_authn_socache doit être activée dans leurs modules. La + <p>Les développeurs de modules doivent savoir que la mise en cache + avec mod_authn_socache doit être activée dans leurs modules. La fonction de l'API <var>ap_authn_cache_store</var> permet de - mettre en cache les données d'authentification qu'un fournisseur - vient de rechercher ou de générer. Vous trouverez des exemples - d'utilisation à <a href="http://svn.eu.apache.org/viewvc?view=revision&revision=957072">r957072</a>, où trois fournisseurs authn sont activés pour la mise + mettre en cache les données d'authentification qu'un fournisseur + vient de rechercher ou de générer. Vous trouverez des exemples + d'utilisation à <a href="http://svn.eu.apache.org/viewvc?view=revision&revision=957072">r957072</a>, où trois fournisseurs authn sont activés pour la mise 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="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>Spécifie une chaîne de contexte à utiliser dans la clé du +<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#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>Cette directive permet de spécifier une chaîne à utiliser avec le + <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 + 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 + <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, + <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 + 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 + <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> @@ -166,37 +166,37 @@ endroit</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>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 + <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> + 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>Spécifie le fournisseur pour lequel on veut effectuer une +<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#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>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 + <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>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> + <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> @@ -204,59 +204,59 @@ mise en cache</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="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>Sélectionne le fournisseur socache d'arrière-plan à +<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#Override">AllowOverride:</a></th><td>None</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>Les arguments optionnels du fournisseur sont disponibles -à partir de la version 2.4.7 du serveur HTTP Apache</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>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 + <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> + "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>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#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>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 + <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 + 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> + définissez la durée de vie.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_socache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authn_socache.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authn_socache.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -275,7 +275,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_soca } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authnz_ldap.html b/docs/manual/mod/mod_authnz_ldap.html index 57d34079e2..b7e42e9dd0 100644 --- a/docs/manual/mod/mod_authnz_ldap.html +++ b/docs/manual/mod/mod_authnz_ldap.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authnz_ldap.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authnz_ldap.html.fr b/docs/manual/mod/mod_authnz_ldap.html.fr index 6cf220cd89..47db9b0451 100644 --- a/docs/manual/mod/mod_authnz_ldap.html.fr +++ b/docs/manual/mod/mod_authnz_ldap.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,52 +27,52 @@ <div id="preamble"><h1>Module Apache mod_authnz_ldap</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authnz_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authnz_ldap.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authnz_ldap.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet d'utiliser un annuaire LDAP pour l'authentification HTTP de base.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authnz_ldap_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authnz_ldap.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authnz_ldap_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authnz_ldap.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet aux frontaux d'authentification comme <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> d'authentifier les utilisateurs via un annuaire ldap.</p> - <p><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> supporte les fonctionnalités + <p><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> supporte les fonctionnalités suivantes :</p> <ul> - <li>Support vérifié du <a href="http://www.openldap.org/">OpenLDAP SDK</a> (versions 1.x et + <li>Support vérifié du <a href="http://www.openldap.org/">OpenLDAP SDK</a> (versions 1.x et 2.x), du <a href="http://developer.novell.com/ndk/cldap.htm"> Novell LDAP SDK</a> et du SDK <a href="http://www.iplanet.com/downloads/developer/">iPlanet (Netscape)</a>.</li> - <li>Implémentation de politiques d'autorisation complexes en les - définissant via des filtres LDAP.</li> + <li>Implémentation de politiques d'autorisation complexes en les + définissant via des filtres LDAP.</li> - <li>Mise en oeuvre d'une mise en cache des opérations LDAP - élaborée via <a href="mod_ldap.html">mod_ldap</a>.</li> + <li>Mise en oeuvre d'une mise en cache des opérations LDAP + élaborée via <a href="mod_ldap.html">mod_ldap</a>.</li> - <li>Support de LDAP via SSL (nécessite le SDK Netscape) ou TLS - (nécessite le SDK OpenLDAP 2.x ou le SDK LDAP Novell).</li> + <li>Support de LDAP via SSL (nécessite le SDK Netscape) ou TLS + (nécessite le SDK OpenLDAP 2.x ou le SDK LDAP Novell).</li> </ul> <p>Lorsqu'on utilise <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, ce module est - invoqué en affectant la valeur <code>ldap</code> à la directive + invoqué en affectant la valeur <code>ldap</code> à la directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#contents">Sommaire</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#gcaveats">Mises en garde à caractère général</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#operation">Mode opératoire</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#gcaveats">Mises en garde à caractère général</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#operation">Mode opératoire</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives requises</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#usingtls">Utilisation de TLS</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#usingssl">Utilisation de SSL</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#exposed">Mise à disposition des informations de +<li><img alt="" src="../images/down.gif" /> <a href="#exposed">Mise à disposition des informations de connexion</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#activedirectory">Utilisation d'Active Directory</a></li> @@ -112,8 +112,8 @@ Directory</a></li> <h2><a name="contents" id="contents">Sommaire</a></h2> <ul> - <li> <a href="#gcaveats">Mises en garde à caractère général</a> </li> - <li> <a href="#operation">Mode opératoire</a> + <li> <a href="#gcaveats">Mises en garde à caractère général</a> </li> + <li> <a href="#operation">Mode opératoire</a> <ul> <li><a href="#authenphase">La phase @@ -139,7 +139,7 @@ Directory</a></li> <li><a href="#examples">Exemples</a></li> <li><a href="#usingtls">Utilisation de TLS</a></li> <li><a href="#usingssl">Utilisation de SSL</a></li> - <li><a href="#exposed">Mise à disposition des informations de + <li><a href="#exposed">Mise à disposition des informations de connexion</a></li> <li><a href="#activedirectory">Utilisation d'Active Directory</a></li> <li> @@ -147,46 +147,46 @@ Directory</a></li> <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></a> <ul> - <li><a href="#howitworks">Comment ça marche</a></li> + <li><a href="#howitworks">Comment ça marche</a></li> <li><a href="#fpcaveats">Mises en garde</a></li> </ul> </li> </ul> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="gcaveats" id="gcaveats">Mises en garde à caractère général</a></h2> -<p>Ce module effectue une mise en cache des résultats du processus +<h2><a name="gcaveats" id="gcaveats">Mises en garde à caractère général</a></h2> +<p>Ce module effectue une mise en cache des résultats du processus d'authentification et d'autorisation en fonction de la configuration du -module <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. Les modifications effectuées au niveau -du serveur LDAP d'arrière-plan comme les -verrouillages ou révocations d'utilisateurs, les changements de mot de -passe, ou les changements d'appartenance à un groupe (et cette liste -n'est pas exhaustive), ne seront pas immédiatement propagées jusqu'au +module <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. Les modifications effectuées au niveau +du serveur LDAP d'arrière-plan comme les +verrouillages ou révocations d'utilisateurs, les changements de mot de +passe, ou les changements d'appartenance à un groupe (et cette liste +n'est pas exhaustive), ne seront pas immédiatement propagées jusqu'au serveur HTTP. Consultez les directives du module -<code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> pour plus de détails à propos de la +<code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> pour plus de détails à propos de la configuration de la mise en cache. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="operation" id="operation">Mode opératoire</a></h2> +<h2><a name="operation" id="operation">Mode opératoire</a></h2> - <p>L'utilisateur se voit accorder l'accès selon un processus en deux - phases. La première phase est l'authentification, au cours de + <p>L'utilisateur se voit accorder l'accès selon un processus en deux + phases. La première phase est l'authentification, au cours de laquelle le fournisseur d'authentification - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> vérifie que les informations de + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> vérifie que les informations de connexion de l'utilisateur sont valides. Elle est aussi connue sous le nom de phase de <em>recherche/connexion</em> (NdT : en anglais ou - dans le code source : <em>search/bind</em>). La deuxième + dans le code source : <em>search/bind</em>). La deuxième phase est l'autorisation, au cours de laquelle - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> détermine si l'utilisateur - authentifié a la permission d'accéder à la ressource considérée. + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> détermine si l'utilisateur + authentifié a la permission d'accéder à la ressource considérée. Elle est aussi connue sous le nom de phase de <em>comparaison</em> (<em>compare</em>).</p> <p><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> comporte un fournisseur d'authentification authn_ldap et un gestionnaire d'autorisation - authz_ldap. Le fournisseur d'authentification authn_ldap peut être - invoqué en affectant la valeur <code>ldap</code> à la directive + authz_ldap. Le fournisseur d'authentification authn_ldap peut être + invoqué en affectant la valeur <code>ldap</code> à la directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>. Le gestionnaire d'autorisation authz_ldap enrichit la liste des types d'autorisations de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> en y ajoutant les @@ -196,34 +196,34 @@ configuration de la mise en cache. <h3><a name="authenphase" id="authenphase">La phase d'authentification</a></h3> <p>Au cours de la phase d'authentification, - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> recherche une entrée de l'annuaire + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> recherche une entrée de l'annuaire LDAP qui correspond au nom d'utilisateur fourni par le client HTTP. - Si une correspondance unique est trouvée, + Si une correspondance unique est trouvée, <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tente de se connecter au serveur - hébergeant l'annuaire LDAP en utilisant le DN de l'entrée et le mot + hébergeant l'annuaire LDAP en utilisant le DN de l'entrée et le mot de passe fourni par le client HTTP. Comme ce processus effectue tout d'abord une recherche, puis une connexion, il est aussi connu sous - le nom de phase de recherche/connexion. Voici le détail des étapes + le nom de phase de recherche/connexion. Voici le détail des étapes constituant la phase de recherche/connexion :</p> <ol> <li>Confection d'un filtre de recherche en combinant les attribut - et filtre définis par la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> avec le nom d'utilisateur et le mot de + et filtre définis par la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> avec le nom d'utilisateur et le mot de passe fournis par le client HTTP.</li> <li>Recherche dans l'annuaire LDAP en utilisant le filtre - confectionné précédemment. Si le résultat de la recherche est - négatif ou comporte plusieurs entrées, refus ou restriction de - l'accès.</li> + confectionné précédemment. Si le résultat de la recherche est + négatif ou comporte plusieurs entrées, refus ou restriction de + l'accès.</li> - <li>Extraction du DN (distinguished name) de l'entrée issue du - résultat de la recherche, et tentative de connexion au serveur + <li>Extraction du DN (distinguished name) de l'entrée issue du + résultat de la recherche, et tentative de connexion au serveur LDAP en utilisant ce DN et le mot de passe fournis par le client - HTTP. Si la connexion échoue, refus ou restriction de - l'accès.</li> + HTTP. Si la connexion échoue, refus ou restriction de + l'accès.</li> </ol> - <p>Les directives utilisées durant la phase de recherche/connexion + <p>Les directives utilisées durant la phase de recherche/connexion sont les suivantes :</p> <table> @@ -231,9 +231,9 @@ configuration de la mise en cache. <tr> <td><code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code></td> - <td>Spécifie le serveur LDAP, le DN de base, l'attribut à + <td>Spécifie le serveur LDAP, le DN de base, l'attribut à utiliser pour la recherche, ainsi que les filtres de recherche - supplémentaires.</td> + supplémentaires.</td> </tr> <tr> @@ -255,70 +255,70 @@ configuration de la mise en cache. <h3><a name="authorphase" id="authorphase">La phase d'autorisation</a></h3> <p>Au cours de la phase d'autorisation, - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tente de déterminer si - l'utilisateur est autorisé à accéder à la ressource considérée. Une - grande partie de cette vérification consiste pour - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> en des opérations de comparaison au + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> tente de déterminer si + l'utilisateur est autorisé à accéder à la ressource considérée. Une + grande partie de cette vérification consiste pour + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> en des opérations de comparaison au niveau du serveur LDAP. C'est pourquoi cette phase est aussi connue sous le nom de phase de comparaison. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> accepte les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> suivantes pour - déterminer si les informations de connexion permettent d'accorder - l'accès à l'utilisateur :</p> + déterminer si les informations de connexion permettent d'accorder + l'accès à l'utilisateur :</p> <ul> <li>Avec la directive <a href="#reqgroup"><code>Require ldap-user</code></a>, - l'autorisation d'accès est accordée si le nom d'utilisateur - spécifié par la directive correspond au nom d'utilisateur fourni + l'autorisation d'accès est accordée si le nom d'utilisateur + spécifié par la directive correspond au nom d'utilisateur fourni par le client.</li> <li>Avec la directive <a href="#reqdn"><code>Require - ldap-dn</code></a>, l'autorisation d'accès est accordée si le DN - spécifié par la directive correspond au DN extrait du résultat de + ldap-dn</code></a>, l'autorisation d'accès est accordée si le DN + spécifié par la directive correspond au DN extrait du résultat de la recherche dans l'annuaire LDAP.</li> <li>Avec la directive <a href="#reqgroup"><code>Require ldap-group</code></a>, - l'autorisation d'accès est accordée si le DN extrait du résultat de + l'autorisation d'accès est accordée si le DN extrait du résultat de la recherche dans l'annuaire LDAP (ou le nom d'utilisateur fourni - par le client) appartient au groupe LDAP spécifié par la - directive, ou éventuellement à un de ses sous-groupes.</li> + par le client) appartient au groupe LDAP spécifié par la + directive, ou éventuellement à un de ses sous-groupes.</li> <li>Avec la directive <a href="#reqattribute"> - <code>Require ldap-attribute</code></a>, l'autorisation d'accès - est accordée si la valeur de l'attribut extraite de la recherche - dans l'annuaire LDAP correspond à la valeur spécifiée par la + <code>Require ldap-attribute</code></a>, l'autorisation d'accès + est accordée si la valeur de l'attribut extraite de la recherche + dans l'annuaire LDAP correspond à la valeur spécifiée par la directive.</li> <li>Avec la directive <a href="#reqfilter"> - <code>Require ldap-filter</code></a>, l'autorisation d'accès - est accordée si le filtre de recherche renvoie un objet + <code>Require ldap-filter</code></a>, l'autorisation d'accès + est accordée si le filtre de recherche renvoie un objet utilisateur unique qui corresponde au DN de l'utilisateur - authentifié.</li> + authentifié.</li> <li>Avec la directive <a href="#reqsearch"> - <code>Require ldap-search</code></a>, l'autorisation d'accès - est accordée si le filtre de recherche renvoie avec succès - un seul objet correspondant aux critères avec tout nom distinctif + <code>Require ldap-search</code></a>, l'autorisation d'accès + est accordée si le filtre de recherche renvoie avec succès + un seul objet correspondant aux critères avec tout nom distinctif (DN).</li> <li>dans tous les autres cas, refus ou restriction de - l'accès.</li> + l'accès.</li> </ul> - <p>Sous réserve du chargement de modules d'autorisation - supplémentaires, d'autres valeurs de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> peuvent être - spécifiées.</p> + <p>Sous réserve du chargement de modules d'autorisation + supplémentaires, d'autres valeurs de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> peuvent être + spécifiées.</p> <ul> - <li>L'accès est accordé à tous les utilisateurs authentifiés si + <li>L'accès est accordé à tous les utilisateurs authentifiés si une directive <a href="#requser"><code>Require - valid-user</code></a> est présente (nécessite le module + valid-user</code></a> est présente (nécessite le module <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>).</li> <li>Avec la directive <a href="#reqgroup"><code>Require group</code></a>, l'autorisation - d'accès est accordée si le module - <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> a été chargé et si la - directive <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> a été - définie.</li> + d'accès est accordée si le module + <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> a été chargé et si la + directive <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> a été + définie.</li> <li>etc...</li> </ul> @@ -333,59 +333,59 @@ configuration de la mise en cache. <td><code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> </td> - <td>On utilise l'attribut spécifié dans l'URL pour les - opérations de comparaison initiées par la directive + <td>On utilise l'attribut spécifié dans l'URL pour les + opérations de comparaison initiées par la directive <code>Require ldap-user</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapcomparednonserver">AuthLDAPCompareDNOnServer</a></code></td> - <td>Détermine le comportement de la directive <code>Require + <td>Détermine le comportement de la directive <code>Require ldap-dn</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapgroupattribute">AuthLDAPGroupAttribute</a></code></td> - <td>Détermine l'attribut utilisé pour les opérations de - comparaison initiées par la directive <code>Require + <td>Détermine l'attribut utilisé pour les opérations de + comparaison initiées par la directive <code>Require ldap-group</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapgroupattributeisdn">AuthLDAPGroupAttributeIsDN</a></code></td> - <td>Spécifie si l'on doit utiliser le DN ou le nom de - l'utilisateur lors des opérations de comparaison initiées par la + <td>Spécifie si l'on doit utiliser le DN ou le nom de + l'utilisateur lors des opérations de comparaison initiées par la directive <code>Require ldap-group</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapmaxsubgroupdepth">AuthLDAPMaxSubGroupDepth</a></code></td> - <td>Détermine la profondeur maximale de l'arborescence des - sous-groupes qui seront évalués au cours des opérations de - comparaisons initiées par la directive <code>Require + <td>Détermine la profondeur maximale de l'arborescence des + sous-groupes qui seront évalués au cours des opérations de + comparaisons initiées par la directive <code>Require ldap-group</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapsubgroupattribute">AuthLDAPSubGroupAttribute</a></code></td> - <td>Détermine l'attribut à utiliser lors de l'extraction de + <td>Détermine l'attribut à utiliser lors de l'extraction de membres de sous-groupes du groupe courant au cours des - opérations de comparaison initiées par la directive + opérations de comparaison initiées par la directive <code>Require ldap-group</code>.</td> </tr> <tr> <td><code class="directive"><a href="#authldapsubgroupclass">AuthLDAPSubGroupClass</a></code></td> - <td>Spécifie les valeurs de classe d'objet LDAP à utiliser pour - déterminer si les objets extraits de l'annuaire sont bien des + <td>Spécifie les valeurs de classe d'objet LDAP à utiliser pour + déterminer si les objets extraits de l'annuaire sont bien des objets de type groupe (et non des objets de type utilisateur), - au cours du traitement des sous-groupes initié par la directive + au cours du traitement des sous-groupes initié par la directive <code>Require ldap-group</code>.</td> </tr> </table> @@ -394,79 +394,79 @@ configuration de la mise en cache. <div class="section"> <h2><a name="requiredirectives" id="requiredirectives">Les directives requises</a></h2> - <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache sont utilisées + <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache sont utilisées au cours de la phase d'autorisation afin de s'assurer que - l'utilisateur est autorisé à accéder à une ressource. + l'utilisateur est autorisé à accéder à une ressource. mod_authnz_ldap enrichit la liste des types d'autorisations avec les valeurs <code>ldap-user</code>, <code>ldap-dn</code>, <code>ldap-group</code>, <code>ldap-attribute</code> et <code>ldap-filter</code>. D'autres types d'autorisations sont - disponibles, sous réserve du chargement de modules d'autorisation - supplémentaires.</p> + disponibles, sous réserve du chargement de modules d'autorisation + supplémentaires.</p> <p>A partir de la version 2.4.8, les directives require LDAP supportent les <a href="../expr.html">expressions</a>.</p> <h3><a name="requser" id="requser">Require ldap-user</a></h3> - <p>La directive <code>Require ldap-user</code> permet de spécifier - les noms des utilisateurs autorisés à accéder à la ressource. + <p>La directive <code>Require ldap-user</code> permet de spécifier + les noms des utilisateurs autorisés à accéder à la ressource. Lorsque <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> a extrait un DN unique de - l'annuaire LDAP, il effectue une opération de comparaison LDAP en - utilisant le nom d'utilisateur spécifié par la directive - <code>Require ldap-user</code>, pour vérifier si ce nom - d'utilisateur correspond à l'entrée LDAP extraite. On peut accorder - l'accès à plusieurs utilisateurs en plaçant plusieurs nom - d'utilisateurs sur la même ligne séparés par des espaces. Si un nom - d'utilisateur contient des espaces, il doit être entouré de - guillemets. On peut aussi accorder l'accès à plusieurs utilisateurs + l'annuaire LDAP, il effectue une opération de comparaison LDAP en + utilisant le nom d'utilisateur spécifié par la directive + <code>Require ldap-user</code>, pour vérifier si ce nom + d'utilisateur correspond à l'entrée LDAP extraite. On peut accorder + l'accès à plusieurs utilisateurs en plaçant plusieurs nom + d'utilisateurs sur la même ligne séparés par des espaces. Si un nom + d'utilisateur contient des espaces, il doit être entouré de + guillemets. On peut aussi accorder l'accès à plusieurs utilisateurs en utilisant une directive <code>Require ldap-user</code> par - utilisateur. Par exemple, avec la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> définie à - <code>ldap://ldap/o=Example?cn</code> (spécifiant donc que l'attribut - <code>cn</code> sera utilisé pour les recherches), on pourra - utiliser les directives Require suivantes pour restreindre l'accès + utilisateur. Par exemple, avec la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> définie à + <code>ldap://ldap/o=Example?cn</code> (spécifiant donc que l'attribut + <code>cn</code> sera utilisé pour les recherches), on pourra + utiliser les directives Require suivantes pour restreindre l'accès :</p> <pre class="prettyprint lang-config">Require ldap-user "Barbara Jenson" Require ldap-user "Fred User" Require ldap-user "Joe Manager"</pre> - <p>De par la manière dont <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> traite + <p>De par la manière dont <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> traite cette directive, Barbara Jenson peut s'authentifier comme <em>Barbara Jenson</em>, <em>Babs Jenson</em> ou tout autre - <code>cn</code> sous lequel elle est enregistrée dans l'annuaire + <code>cn</code> sous lequel elle est enregistrée dans l'annuaire LDAP. Une seule ligne <code>Require ldap-user</code> suffit pour - toutes les valeurs de l'attribut dans l'entrée LDAP de + toutes les valeurs de l'attribut dans l'entrée LDAP de l'utilisateur.</p> - <p>Si l'attribut <code>uid</code> avait été spécifié à la place de - l'attribut <code>cn</code> dans l'URL précédente, les trois lignes - ci-dessus auraient pû être condensées en une seule ligne :</p> + <p>Si l'attribut <code>uid</code> avait été spécifié à la place de + l'attribut <code>cn</code> dans l'URL précédente, les trois lignes + ci-dessus auraient pû être condensées en une seule ligne :</p> <pre class="prettyprint lang-config">Require ldap-user bjenson fuser jmanager</pre> <h3><a name="reqgroup" id="reqgroup">Require ldap-group</a></h3> - <p>Cette directive permet de spécifier un groupe LDAP dont les - membres auront l'autorisation d'accès. Elle prend comme argument le + <p>Cette directive permet de spécifier un groupe LDAP dont les + membres auront l'autorisation d'accès. Elle prend comme argument le DN du groupe LDAP. Note : n'entourez pas le nom du groupe avec des - guillemets. Par exemple, supposons que l'entrée suivante existe dans + guillemets. Par exemple, supposons que l'entrée suivante existe dans l'annuaire LDAP :</p> <div class="example"><pre>dn: cn=Administrators, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Barbara Jenson, o=Example uniqueMember: cn=Fred User, o=Example</pre></div> - <p>La directive suivante autoriserait alors l'accès à Fred et + <p>La directive suivante autoriserait alors l'accès à Fred et Barbara :</p> <pre class="prettyprint lang-config">Require ldap-group cn=Administrators, o=Example</pre> <p>Les membres peuvent aussi se trouver dans les sous-groupes du - groupe LDAP spécifié si la directive <code class="directive"><a href="#authldapmaxsubgroupdepth">AuthLDAPMaxSubGroupDepth</a></code> a été - définie à une valeur supérieure à 0. Par exemple, supposons que les - entrées suivantes existent dans l'annuaire LDAP :</p> + groupe LDAP spécifié si la directive <code class="directive"><a href="#authldapmaxsubgroupdepth">AuthLDAPMaxSubGroupDepth</a></code> a été + définie à une valeur supérieure à 0. Par exemple, supposons que les + entrées suivantes existent dans l'annuaire LDAP :</p> <div class="example"><pre>dn: cn=Employees, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Managers, o=Example @@ -494,16 +494,16 @@ objectClass: groupOfUniqueNames uniqueMember: cn=Jim Swenson, o=Example uniqueMember: cn=Elliot Rhodes, o=Example</pre></div> - <p>Les directives suivantes autoriseraient alors l'accès à Bob + <p>Les directives suivantes autoriseraient alors l'accès à Bob Ellis, Tom Jackson, Barbara Jenson, Fred User, Allan Jefferson, et - Paul Tilley, mais l'interdiraient à Jim Swenson, ou Elliot Rhodes - (car ils sont situés dans un sous-groupe de niveau de profondeur 2) + Paul Tilley, mais l'interdiraient à Jim Swenson, ou Elliot Rhodes + (car ils sont situés dans un sous-groupe de niveau de profondeur 2) :</p> <pre class="prettyprint lang-config">Require ldap-group cn=Employees, o=Example AuthLDAPMaxSubGroupDepth 1</pre> - <p>Le comportement de cette directive est modifié par les directives + <p>Le comportement de cette directive est modifié par les directives <code class="directive"><a href="#authldapgroupattribute">AuthLDAPGroupAttribute</a></code>, <code class="directive"><a href="#authldapgroupattributeisdn">AuthLDAPGroupAttributeIsDN</a></code>, <code class="directive"><a href="#authldapmaxsubgroupdepth">AuthLDAPMaxSubGroupDepth</a></code>, @@ -513,49 +513,49 @@ AuthLDAPMaxSubGroupDepth 1</pre> <h3><a name="reqdn" id="reqdn">Require ldap-dn</a></h3> - <p>La directive <code>Require ldap-dn</code> permet à - l'administrateur d'accorder l'utorisation d'accès en fonction du DN. - Elle permet de spécifier un DN pour lequel l'accès est autorisé. Si + <p>La directive <code>Require ldap-dn</code> permet à + l'administrateur d'accorder l'utorisation d'accès en fonction du DN. + Elle permet de spécifier un DN pour lequel l'accès est autorisé. Si le DN extrait de - l'annuaire correspond au DN spécifié par la directive <code>Require - ldap-dn</code>, l'autorisation d'accès est accordée. Note : + l'annuaire correspond au DN spécifié par la directive <code>Require + ldap-dn</code>, l'autorisation d'accès est accordée. Note : n'entourez pas Le DN de guillemets.</p> - <p>La directive suivante accorderait l'accès à un DN spécifique + <p>La directive suivante accorderait l'accès à un DN spécifique :</p> <pre class="prettyprint lang-config">Require ldap-dn cn=Barbara Jenson, o=Example</pre> - <p>Le comportement ce cette directive est modifié par la directive + <p>Le comportement ce cette directive est modifié par la directive <code class="directive"><a href="#authldapcomparednonserver">AuthLDAPCompareDNOnServer</a></code>.</p> <h3><a name="reqattribute" id="reqattribute">Require ldap-attribute</a></h3> - <p>La directive <code>Require ldap-attribute</code> permet à - l'administrateur d'accorder l'autorisation d'accès en fonction des - attributs de l'utilisateur authentifié dans l'annuaire LDAP. Si la - valeur de l'attribut dans l'annuaire correspond à la valeur - spécifiée par la directive, l'autorisation d'accès est accordée.</p> + <p>La directive <code>Require ldap-attribute</code> permet à + l'administrateur d'accorder l'autorisation d'accès en fonction des + attributs de l'utilisateur authentifié dans l'annuaire LDAP. Si la + valeur de l'attribut dans l'annuaire correspond à la valeur + spécifiée par la directive, l'autorisation d'accès est accordée.</p> - <p>La directive suivante accorderait l'autorisation d'accès à tout + <p>La directive suivante accorderait l'autorisation d'accès à tout utilisateur dont l'attribut employeeType a pour valeur "actif" :</p> <pre class="prettyprint lang-config">Require ldap-attribute "employeeType=active"</pre> - <p>Plusieurs paires attribut/valeur peuvent être spécifiées par une - même directive en les séparant par des espaces, ou en définissant + <p>Plusieurs paires attribut/valeur peuvent être spécifiées par une + même directive en les séparant par des espaces, ou en définissant plusieurs directives <code>Require ldap-attribute</code>. La logique - sous-jacente à une liste de paires attribut/valeur est une opération - OU. L'autorisation d'accès sera accordée si au moins une paire - attribut/valeur de la liste spécifiée correspond à la paire - attribut/valeur de l'utilisateur authentifié. Si elle contient des - espaces, la valeur, et seulement la valeur, doit être entourée de + sous-jacente à une liste de paires attribut/valeur est une opération + OU. L'autorisation d'accès sera accordée si au moins une paire + attribut/valeur de la liste spécifiée correspond à la paire + attribut/valeur de l'utilisateur authentifié. Si elle contient des + espaces, la valeur, et seulement la valeur, doit être entourée de guillemets.</p> - <p>La directive suivante accorderait l'autorisation d'accès à tout + <p>La directive suivante accorderait l'autorisation d'accès à tout utilisateur dont l'attribut city aurait pour valeur "San Jose", ou donc l'attribut status aurait pour valeur "actif" :</p> @@ -567,15 +567,15 @@ AuthLDAPMaxSubGroupDepth 1</pre> <h3><a name="reqfilter" id="reqfilter">Require ldap-filter</a></h3> - <p>La directive <code>Require ldap-filter</code> permet à - l'administrateur d'accorder l'autorisation d'accès en fonction d'un - filtre de recherche LDAP complexe. L'autorisation d'accès est - accordée si le DN renvoyé par le filtre de recherche correspond au - DN de l'utilisateur authentifié.</p> + <p>La directive <code>Require ldap-filter</code> permet à + l'administrateur d'accorder l'autorisation d'accès en fonction d'un + filtre de recherche LDAP complexe. L'autorisation d'accès est + accordée si le DN renvoyé par le filtre de recherche correspond au + DN de l'utilisateur authentifié.</p> - <p>La directive suivante accorderait l'autorisation d'accès à tout - utilisateur possédant un téléphone cellulaire et faisant partie du - département "marketing" :</p> + <p>La directive suivante accorderait l'autorisation d'accès à tout + utilisateur possédant un téléphone cellulaire et faisant partie du + département "marketing" :</p> <pre class="prettyprint lang-config">Require ldap-filter "&(cell=*)(department=marketing)"</pre> @@ -583,17 +583,17 @@ AuthLDAPMaxSubGroupDepth 1</pre> <p>Alors que la directive <code>Require ldap-attribute</code> se contente d'une simple comparaison d'attributs, la directive - <code>Require ldap-filter</code> effectue une opération de recherche - dans l'annuaire LDAP en utilisant le filtre de recherche spécifié. - Si une simple comparaison d'attributs suffit, l'opération de - comparaison effectuée par <code>ldap-attribute</code> sera plus - rapide que l'opération de recherche effectuée par + <code>Require ldap-filter</code> effectue une opération de recherche + dans l'annuaire LDAP en utilisant le filtre de recherche spécifié. + Si une simple comparaison d'attributs suffit, l'opération de + comparaison effectuée par <code>ldap-attribute</code> sera plus + rapide que l'opération de recherche effectuée par <code>ldap-filter</code>, en particulier dans le cas d'un annuaire LDAP de grande taille.</p> <p>Lorsqu'on utilise une <a href="../expr.html">expression rationnelle</a> au sein d'un filtre, il faut bien s'assurer que les - filtres LDAP sont correctement échappés afin de se prémunir contre + filtres LDAP sont correctement échappés afin de se prémunir contre toute injection LDAP. A cet effet, il est possible d'utiliser la fonction ldap.</p> @@ -607,14 +607,14 @@ AuthLDAPMaxSubGroupDepth 1</pre> <h3><a name="reqsearch" id="reqsearch">Require ldap-search</a></h3> - <p>La directive <code>Require ldap-search</code> permet à - l'administrateur d'autoriser l'accès en fonction d'un filtre de - recherche LDAP générique contenant une <a href="../expr.html">expression rationnelle</a>. Si le filtre de - recherche renvoie une et une seule correspondance, l'accès est - accordé sans tenir compte du DN.</p> + <p>La directive <code>Require ldap-search</code> permet à + l'administrateur d'autoriser l'accès en fonction d'un filtre de + recherche LDAP générique contenant une <a href="../expr.html">expression rationnelle</a>. Si le filtre de + recherche renvoie une et une seule correspondance, l'accès est + accordé sans tenir compte du DN.</p> - <p>La directive suivante accorderait l'accès aux URLs correspondant - aux objets spécifiés dans le serveur LDAP :</p> + <p>La directive suivante accorderait l'accès aux URLs correspondant + aux objets spécifiés dans le serveur LDAP :</p> <pre class="prettyprint lang-config"><LocationMatch "^/dav/(?<SITENAME>[^/]+)/"> Require ldap-search "(cn=%{ldap:%{unescape:%{env:MATCH_SITENAME}} @@ -623,7 +623,7 @@ Website)" <p>Note : il faut bien s'assurer que les - expressions sont correctement échappés afin de se prémunir contre + expressions sont correctement échappés afin de se prémunir contre toute injection LDAP. A cet effet, il est possible d'utiliser la fonction <strong>ldap</strong> comme dans l'exemple ci-dessus.</p> @@ -635,7 +635,7 @@ Website)" <ul> <li> - Accorde l'autorisation d'accès à tout utilisateur présent dans + Accorde l'autorisation d'accès à tout utilisateur présent dans l'annuaire LDAP, en utilisant son UID pour effectuer la recherche : <pre class="prettyprint lang-config">AuthLDAPURL "ldap://ldap1.example.com:389/ou=People, o=Example?uid?sub?(objectClass=*)" @@ -644,23 +644,23 @@ Require valid-user</pre> </li> <li> - L'exemple suivant est similaire au précédent, mais les champs - dont les valeurs par défaut conviennent sont omis. Notez aussi - la présence d'un annuaire LDAP redondant : + L'exemple suivant est similaire au précédent, mais les champs + dont les valeurs par défaut conviennent sont omis. Notez aussi + la présence d'un annuaire LDAP redondant : <pre class="prettyprint lang-config">AuthLDAPURL "ldap://ldap1.example.com ldap2.example.com/ou=People, o=Example" Require valid-user</pre> </li> <li> - Encore un exemple similaire aux précédents, mais cette fois, - c'est l'attribut cn qui est utilisé pour la recherche à la place - de l'UID. Notez que ceci peut poser problème si plusieurs - utilisateurs de l'annuaire partagent le même <code>cn</code>, + Encore un exemple similaire aux précédents, mais cette fois, + c'est l'attribut cn qui est utilisé pour la recherche à la place + de l'UID. Notez que ceci peut poser problème si plusieurs + utilisateurs de l'annuaire partagent le même <code>cn</code>, car une recherche sur le <code>cn</code> <strong>doit</strong> - retourner une entrée et une seule. C'est pourquoi cette - approche n'est pas recommandée : il est préférable de choisir un - attribut de votre annuaire dont l'unicité soit garantie, comme + retourner une entrée et une seule. C'est pourquoi cette + approche n'est pas recommandée : il est préférable de choisir un + attribut de votre annuaire dont l'unicité soit garantie, comme <code>uid</code>. <pre class="prettyprint lang-config">AuthLDAPURL "ldap://ldap.example.com/ou=People, o=Example?cn" Require valid-user</pre> @@ -668,7 +668,7 @@ Require valid-user</pre> </li> <li> - Accorde l'autorisation d'accès à tout utilisateur appartenant au + Accorde l'autorisation d'accès à tout utilisateur appartenant au groupe Administrateurs. Les utilisateurs doivent s'authentifier en utilisant leur UID : <pre class="prettyprint lang-config">AuthLDAPURL ldap://ldap.example.com/o=Example?uid @@ -677,8 +677,8 @@ Require ldap-group cn=Administrators, o=Example</pre> </li> <li> - Accorde l'accès à tout utilisateur appartenant au groupe dont le - nom correspond au nom d'hôte du serveur virtuel. Dans cet exemple, + Accorde l'accès à tout utilisateur appartenant au groupe dont le + nom correspond au nom d'hôte du serveur virtuel. Dans cet exemple, on utilise une <a href="../expr.html">expression</a> pour construire le filtre. <pre class="prettyprint lang-config">AuthLDAPURL ldap://ldap.example.com/o=Example?uid @@ -688,10 +688,10 @@ Require ldap-group cn=%{SERVER_NAME}, o=Example</pre> <li> Pour l'exemple suivant, on suppose que tout utilisateur de chez - Example qui dispose d'un bippeur alphanumérique possèdera un + Example qui dispose d'un bippeur alphanumérique possèdera un attribut LDAP <code>qpagePagerID</code>. Seuls ces utilisateurs - (authentifiés via leur UID) se verront accorder l'autorisation - d'accès : + (authentifiés via leur UID) se verront accorder l'autorisation + d'accès : <pre class="prettyprint lang-config">AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(qpagePagerID=*) Require valid-user</pre> @@ -699,35 +699,35 @@ Require valid-user</pre> <li> <p>L'exemple suivant illustre la puissance des filtres pour - effectuer des requêtes complexes. Sans les filtres, il aurait - été nécessaire de créer un nouveau groupe LDAP et de s'assurer + effectuer des requêtes complexes. Sans les filtres, il aurait + été nécessaire de créer un nouveau groupe LDAP et de s'assurer de la synchronisation des membres du groupe avec les - utilisateurs possédant un bippeur. Tout devient limpide avec les - filtres. Nous avons pour but d'accorder l'autorisation d'accès à - tout utilisateur disposant d'un bippeur ainsi qu'à Joe Manager - qui ne possède pas de bippeur, mais doit tout de même pouvoir - accéder à la ressource :</p> + utilisateurs possédant un bippeur. Tout devient limpide avec les + filtres. Nous avons pour but d'accorder l'autorisation d'accès à + tout utilisateur disposant d'un bippeur ainsi qu'à Joe Manager + qui ne possède pas de bippeur, mais doit tout de même pouvoir + accéder à la ressource :</p> <pre class="prettyprint lang-config">AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(|(qpagePagerID=*)(uid=jmanager)) Require valid-user</pre> <p>Ce dernier exemple peut sembler confus au premier abord ; en - fait, il permet de mieux comprendre à quoi doit ressembler le + fait, il permet de mieux comprendre à quoi doit ressembler le filtre en fonction de l'utilisateur qui se connecte. Si Fred User se connecte en tant que <code>fuser</code>, le filtre devra - ressembler à :</p> + ressembler à :</p> <div class="example"><p><code>(&(|(qpagePagerID=*)(uid=jmanager))(uid=fuser))</code></p></div> <p>Un recherche avec le filtre ci-dessus ne retournera un - résultat positif que si <em>fuser</em> dispose d'un bippeur. Si + résultat positif que si <em>fuser</em> dispose d'un bippeur. Si Joe Manager se connecte en tant que <em>jmanager</em>, le filtre - devra ressembler à :</p> + devra ressembler à :</p> <div class="example"><p><code>(&(|(qpagePagerID=*)(uid=jmanager))(uid=jmanager))</code></p></div> <p>Un recherche avec le filtre ci-dessus retournera un - résultat positif que <em>jmanager</em> dispose d'un + résultat positif que <em>jmanager</em> dispose d'un bippeur ou non</p> </li> </ul> @@ -738,12 +738,12 @@ Require valid-user</pre> <p>Pour l'utilisation de TLS, voir les directives du module <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> et <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p> - <p>Un second paramètre optionnel peut être ajouté à la directive + <p>Un second paramètre optionnel peut être ajouté à la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> pour - remplacer le type de connexion par défaut défini par la directive + remplacer le type de connexion par défaut défini par la directive <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>. Ceci - permettra de promouvoir la connexion établie via une URL du type - <em>ldap://</em> au statut de connection sécurisée sur le même + permettra de promouvoir la connexion établie via une URL du type + <em>ldap://</em> au statut de connection sécurisée sur le même port.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> @@ -752,62 +752,62 @@ Require valid-user</pre> <p>Pour l'utilisation de SSL, voir les directives du module <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> et <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p> - <p>Pour spécifier un serveur LDAP sécurisé, utilisez + <p>Pour spécifier un serveur LDAP sécurisé, utilisez <em>ldaps://</em> au lieu de <em>ldap://</em> dans la directive <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="exposed" id="exposed">Mise à disposition des informations de +<h2><a name="exposed" id="exposed">Mise à disposition des informations de connexion</a></h2> <p>Au cours du processus d'<em>authentification</em>, les attributs LDAP - spécifiés par la directive <code class="directive"><a href="#authldapurl">authldapurl</a></code> sont enregistrés - dans des variables d'environnement préfixées par la chaîne + spécifiés par la directive <code class="directive"><a href="#authldapurl">authldapurl</a></code> sont enregistrés + dans des variables d'environnement préfixées par la chaîne "AUTHENTICATE_".</p> <p>Au cours du processus d'<em>autorisation</em>, les attributs LDAP - spécifiés par la directive <code class="directive"><a href="#authldapurl">authldapurl</a></code> sont enregistrés - dans des variables d'environnement préfixées par la chaîne + spécifiés par la directive <code class="directive"><a href="#authldapurl">authldapurl</a></code> sont enregistrés + dans des variables d'environnement préfixées par la chaîne "AUTHORIZE_".</p> - <p>Si les champs attribut contiennent le nom, le CN et le numéro de - téléphone d'un utilisateur, un programme CGI pourra accéder à ces - informations sans devoir effectuer une autre requête LDAP pour + <p>Si les champs attribut contiennent le nom, le CN et le numéro de + téléphone d'un utilisateur, un programme CGI pourra accéder à ces + informations sans devoir effectuer une autre requête LDAP pour les extraire de l'annuaire.</p> - <p>Ceci a pour effet de simplifier considérablement le code et la - configuration nécessaire de certaines applications web.</p> + <p>Ceci a pour effet de simplifier considérablement le code et la + configuration nécessaire de certaines applications web.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="activedirectory" id="activedirectory">Utilisation d'Active Directory</a></h2> - <p>Active Directory peut supporter plusieurs domaines à la fois. + <p>Active Directory peut supporter plusieurs domaines à la fois. Pour faire la distinction entre les utilisateurs de plusieurs - domaines, on peut ajouter à l'entrée de l'utilisateur dans - l'annuaire un identifiant appelé Nom + domaines, on peut ajouter à l'entrée de l'utilisateur dans + l'annuaire un identifiant appelé Nom Principal d'Utilisateur (User Principle Name ou UPN). Cet UPN se - compose en général du nom de compte de l'utilisateur, suivi du nom - du domaine considéré, par exemple <em>untel@nz.example.com</em>.</p> + compose en général du nom de compte de l'utilisateur, suivi du nom + du domaine considéré, par exemple <em>untel@nz.example.com</em>.</p> <p>Vous voudrez probablement configurer le module <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> afin de pouvoir authentifier les - utilisateurs de n'importe quel domaine de la forêt Active Directory. + utilisateurs de n'importe quel domaine de la forêt Active Directory. Ainsi, <em>untel@nz.example.com</em> et - <em>untel@au.example.com</em> pourront être authentifiés en une - seule fois par la même requête.</p> + <em>untel@au.example.com</em> pourront être authentifiés en une + seule fois par la même requête.</p> <p>Pour y parvenir, on utilise le concept de Catalogue Global d'Active Directory. Ce Catalogue Global est une copie en lecture - seule des attributs sélectionnés de tous les serveurs de la forêt - Active Directory. Une requête vers le + seule des attributs sélectionnés de tous les serveurs de la forêt + Active Directory. Une requête vers le Catalogue Global permet donc d'atteindre tous les domaines en une - seule fois, sans avoir à se connecter aux différents serveurs, via - des liaisons dont certaines peuvent être lentes.</p> + seule fois, sans avoir à se connecter aux différents serveurs, via + des liaisons dont certaines peuvent être lentes.</p> - <p>Lorsqu'il est activé, la Catalogue Global est un serveur - d'annuaire indépendant accessible sur le port 3268 (3269 pour SSL). + <p>Lorsqu'il est activé, la Catalogue Global est un serveur + d'annuaire indépendant accessible sur le port 3268 (3269 pour SSL). Pour rechercher un utilisateur, effectuez une recherche sur l'attribut <em>userPrincipalName</em>, avec une base de recherche vide, comme suit :</p> @@ -826,82 +826,82 @@ AuthLDAPURL ldap://10.0.0.1:3268/?userPrincipalName?sub</pre> FrontPage avec mod_authnz_ldap</a></h2> <p>Normalement, FrontPage utilise des fichiers utilisateur/groupe - spécifiques à FrontPage-web (c'est à dire les modules + spécifiques à FrontPage-web (c'est à dire les modules <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code>) pour effectuer toute l'authentification. Malheureusement, il ne suffit pas de modifier - l'authentification LDAP en ajoutant les directives appropriées, car + l'authentification LDAP en ajoutant les directives appropriées, car ceci corromprait les formulaires de <em>Permissions</em> dans le - client FrontPage, qui sont censés modifier les fichiers + client FrontPage, qui sont censés modifier les fichiers d'autorisation standards au format texte.</p> - <p>Lorsqu'un site web FrontPage a été créé, lui adjoindre - l'authentification LDAP consiste à ajouter les directives suivantes - à <em>chaque</em> fichier <code>.htaccess</code> qui sera créé dans + <p>Lorsqu'un site web FrontPage a été créé, lui adjoindre + l'authentification LDAP consiste à ajouter les directives suivantes + à <em>chaque</em> fichier <code>.htaccess</code> qui sera créé dans le site web :</p> <pre class="prettyprint lang-config">AuthLDAPURL "the url" AuthGroupFile mygroupfile Require group mygroupfile</pre> -<h3><a name="howitworks" id="howitworks">Comment ça marche</a></h3> +<h3><a name="howitworks" id="howitworks">Comment ça marche</a></h3> - <p>FrontPage restreint l'accès à un site web en ajoutant la + <p>FrontPage restreint l'accès à un site web en ajoutant la directive <code>Require valid-user</code> aux fichiers <code>.htaccess</code>. La directive <code>Require valid-user</code> - permettra l'accès à tout utilisateur valide <em>du point de vue - LDAP</em>. Cela signifie que tout utilisateur possédant une entrée - dans l'annuaire LDAP sera considéré comme valide, alors que - FrontPage ne considère comme valides que les utilisateurs - enregistrés dans le fichier des utilisateurs local. En remplaçant + permettra l'accès à tout utilisateur valide <em>du point de vue + LDAP</em>. Cela signifie que tout utilisateur possédant une entrée + dans l'annuaire LDAP sera considéré comme valide, alors que + FrontPage ne considère comme valides que les utilisateurs + enregistrés dans le fichier des utilisateurs local. En remplaçant l'autorisation par groupe LDAP par une autorisation par fichier de groupe, Apache sera en mesure de consulter le fichier des - utilisateurs local (géré par FrontPage) - au lieu de l'annuaire LDAP + utilisateurs local (géré par FrontPage) - au lieu de l'annuaire LDAP - lors du processus d'autorisation des utilisateurs.</p> - <p>Une fois les directives ajoutées selon ce qui précède, les - utilisateurs FrontPage pourront effectuer toutes les opérations de - gestion à partir du client FrontPage.</p> + <p>Une fois les directives ajoutées selon ce qui précède, les + utilisateurs FrontPage pourront effectuer toutes les opérations de + gestion à partir du client FrontPage.</p> <h3><a name="fpcaveats" id="fpcaveats">Avertissements</a></h3> <ul> - <li>Lors du choix de l'URL LDAP, l'attribut à utiliser pour - l'authentification doit aussi être valide pour le fichier des + <li>Lors du choix de l'URL LDAP, l'attribut à utiliser pour + l'authentification doit aussi être valide pour le fichier des utilisateurs de <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. A cette fin, - l'UID est idéal.</li> + l'UID est idéal.</li> <li>Lorsqu'ils ajoutent des utilisateurs via FrontPage, les administrateurs de FrontPage doivent choisir des noms - d'utilisateurs qui existent déjà dans l'annuaire LDAP (pour des - raisons évidentes). De même, le mot de passe que l'administrateur - entre dans le formulaire est ignoré, car pour l'authentification, + d'utilisateurs qui existent déjà dans l'annuaire LDAP (pour des + raisons évidentes). De même, le mot de passe que l'administrateur + entre dans le formulaire est ignoré, car pour l'authentification, Apache utilise le mot de passe de l'annuaire LDAP, et non le mot - de passe enregistré dans le fichier des utilisateurs, ce qui peut + de passe enregistré dans le fichier des utilisateurs, ce qui peut semer la confusion parmi les administrateurs web.</li> - <li>Pour supporter FrontPage, Apache doit être compilé avec + <li>Pour supporter FrontPage, Apache doit être compilé avec <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> - et <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code>. Ceci est dû au fait + et <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code>. Ceci est dû au fait qu'Apache doit utiliser le fichier de groupes de - <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> pour déterminer le niveau - d'accès d'un utilisateur au site web FrontPage.</li> + <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> pour déterminer le niveau + d'accès d'un utilisateur au site web FrontPage.</li> - <li>Les directives doivent être placées dans les fichiers + <li>Les directives doivent être placées dans les fichiers <code>.htaccess</code>. Elles ne fonctionneront pas si vous les - placez dans une section <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>. Ceci est dû au fait que pour savoir - où se trouve la liste des utilisateurs valides, - <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> doit être en mesure d'atteindre + placez dans une section <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>. Ceci est dû au fait que pour savoir + où se trouve la liste des utilisateurs valides, + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> doit être en mesure d'atteindre la directive <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> qui se trouve dans les fichiers <code>.htaccess</code> de FrontPage. Si les directives - de <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> ne sont pas situées dans le - même fichier <code>.htaccess</code> que les directives FrontPage, + de <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> ne sont pas situées dans le + même fichier <code>.htaccess</code> que les directives FrontPage, la configuration ne fonctionnera pas, car <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> ne sera jamais en mesure de - traiter le fichier <code>.htaccess</code>, et par conséquent ne - pourra jamais trouver le fichier des utilisateurs géré par + traiter le fichier <code>.htaccess</code>, et par conséquent ne + pourra jamais trouver le fichier des utilisateurs géré par FrontPage.</li> </ul> @@ -909,26 +909,26 @@ Require group mygroupfile</pre> <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>Spécifie le préfixe ajouté aux variables d'environnement +<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#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>Disponible depuis la version 2.3.6</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>Cette directive permet de spécifier le préfixe ajouté aux + <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 + 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> - Aucune variable d'autorisation n'est définie lorsqu'un utilisateur - s'est vu autoriser l'accès via la directive <code>Require + 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> @@ -936,31 +936,31 @@ durant la phase d'autorisation</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="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>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 +<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<em>off|on</em></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#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#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>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 + <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"><a href="#authldapbindauthoritative">AuthLDAPBindAuthoritative</a></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 + 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 + <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 + l'utilisateur est verrouillé ou que son mot de passe est inutilisable pour une raison quelconque.</p> <h3>Voir aussi</h3> @@ -975,48 +975,48 @@ DN.</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#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>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 + <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>Mot de passe à utiliser en conjonction avec le DN de +<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#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> est disponible depuis la version 2.4.5 du +<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>Cette directive permet de spécifier un mot de passe à utiliser en + <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 + 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"><a href="#authldapbindpassword">AuthLDAPBindPassword</a></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 + <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 -#Exécute /path/to/program pour obtenir le mot de passe +#Exécute /path/to/program pour obtenir le mot de passe AuthLDAPBindPassword exec:/path/to/program -#Exécute /path/to/otherProgram avec un argument pour obtenir le mot de passe +#Exécute /path/to/otherProgram avec un argument pour obtenir le mot de passe AuthLDAPBindPassword "exec:/path/to/otherProgram argument1"</pre> @@ -1026,65 +1026,65 @@ AuthLDAPBindPassword "exec:/path/to/otherProgram argument1"</pre> <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>Chemin du fichier de configuration de la correspondance -langage/jeu de caractères</td></tr> +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>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 + 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 + 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> + langage courantes à leurs jeux de caractères.</p> <p>Le fichier contient des lignes au format suivant :</p> <div class="example"><p><code> - <var>extension de langage</var> <var>jeu de caractères</var> + <var>extension de langage</var> <var>jeu de caractères</var> [<var>Nom du langage</var>] ... </code></p></div> - <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> + <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>Utilisation des données d'authentification de l'utilisateur +<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#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>Disponible depuis la version version 2.3.6</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>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 + <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> + 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>, + <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 + <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> + est aussi activée.</p> - <p>Cette directive ne doit être utilisée que si votre serveur LDAP + <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>. + utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>. </p> <h3>Voir aussi</h3> @@ -1098,59 +1098,59 @@ pour effectuer les comparaisons pour l'attribution des autorisations</td></tr> <table class="directive"> <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#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#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>Lorsque cette directive est définie à on, + <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. 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 + 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>À quel moment le module va déréférencer les +<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#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#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>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 + <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>L'attribut LDAP utilisé pour vérifier l'appartenance d'un -utilisateur à un groupe.</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#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>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, + <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> @@ -1158,62 +1158,62 @@ utilisateur à un groupe.</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="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>Utilise le DN de l'utilisateur pour vérifier son -appartenance à un groupe</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#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#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>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 + <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 + 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> + 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>Détermine si le serveur effectue la recherche initiale du +<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> +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 <em>off|on</em></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#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>Disponible depuis la version 2.3.6</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>Par défaut, le serveur convertit le nom d'utilisateur pour + <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 + 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> + 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 + <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>. + utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>. </p> <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. + n'est utilisé que pour les processus d'autorisation. </div> <h3>Voir aussi</h3> @@ -1227,31 +1227,31 @@ codées en dur pour le serveur</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="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>Spécifie la modification a apporter au nom d'utilisateur -pour l'authentification de base lors de l'authentification auprès du +<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 (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#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>Disponible depuis la version 2.3.6</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>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> + 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 + <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 + <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 + <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>. + 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> @@ -1262,12 +1262,12 @@ distant utilisé tel quel)</code></td></tr> <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. + 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 + <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é + rationnelle ne convient pas, le nom d'utilisateur est utilisé tel quel. </div> @@ -1280,37 +1280,37 @@ distant utilisé tel quel)</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>Spécifie la profondeur d'imbrication des sous-groupes +<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#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>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> +<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>Lorsque cette directive est définie à une valeur <code>X</code> + <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 à + <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> + 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> + <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> + 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> @@ -1318,25 +1318,25 @@ premières versions 2.5</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="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>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 +<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#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>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authnz_ldap</td></tr> </table> - <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 + <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 + 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> @@ -1345,20 +1345,20 @@ d'environnement REMOTE_USER</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="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>Utilise le DN de l'utilisateur pour définir la variable +<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#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#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>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>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> @@ -1366,34 +1366,34 @@ d'environnement REMOTE_USER</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="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>Utilise les données d'authentification de l'utilisateur +<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#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>Disponible depuis la version 2.3.6</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>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 + <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 + <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> + est aussi activée.</p> - <p>Cette directive ne doit être utilisée que si votre serveur LDAP + <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>. + utiliser de nom d'utilisateur dédié via la directive <code class="directive"><a href="#authldapbinddn">AuthLDAPBindDN</a></code>. </p> @@ -1406,207 +1406,207 @@ pour la recherche des autorisations</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="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>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 +<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#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>Disponible à partir de la version 2.3.0 du serveur HTTP +<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>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>AuthLDAPSubGroupAttribute</code> spécifie l'attribut utilisé + utilisateurs et des membres qui sont eux-mêmes des groupes (appelés + sous-groupes ou groupes imbriqués). La directive + <code>AuthLDAPSubGroupAttribute</code> spécifie l'attribut utilisé pour identifier les groupes, alors que la directive - <code>AuthLDAPGroupAttribute</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>AuthLDAPGroupAttribute</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>Spécifie quelles valeurs d'objectClass LDAP identifient les +<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#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>Disponible à partir de la version 2.3.0 du serveur HTTP +<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>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 + utilisateurs et des membres qui sont eux-mêmes des groupes (appelés + sous-groupes ou groupes imbriqués). La directive <code>AuthLDAPSubGroupAttribute</code> permet d'identifier les - membres qui sont des sous-groupes du groupe courant (à l'opposé des + membres qui sont des sous-groupes du groupe courant (à l'opposé des membres utilisateurs). La directive - <code>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 + <code>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 + 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 + 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>L'URL permettant de spécifier les paramètres de la +<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#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>Une URL conforme à la RFC 2255 qui permet de spécifier les - paramètres à utiliser pour la recherche dans l'annuaire LDAP. La + <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 +<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>Mise en garde : </strong>Si vous spécifiez plusieurs +<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 +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> +entendu ajouter des paramètres de recherche à chacun des serveurs +spécifiés.</p> <dl> <dt>ldap</dt> - <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> + <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>hôte:port</dt> +<dt>hôte:port</dt> <dd> <p>Il s'agit du nom/port du serveur ldap - (dont la valeur par défaut est + (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. + 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 + à 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 + <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 + 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> + suivants. Notez que ce processus n'a rien à voir avec une + véritable recherche de type round-robin.</p> </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> + <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. + <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, + 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> + 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> +<dt>portée</dt> - <dd>Il s'agit de la portée de la recherche. Elle peut prendre + <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> + 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 à + 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 + 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. Le mot-clé <code>none</code> permet de désactiver - l'utilisation des filtres, ce qui peut s'avérer nécessaire avec + d'Apache), ce qui s'avère plus que suffisant pour la plupart des + applications. 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>Pour une recherche, les attribut, filtre et nom d'utilisateur - fournis par le client HTTP sont combinés pour créer un filtre de + 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>Par exemple, considérons l'URL + <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>On peut encore ajouter un paramètre optionnel pour permettre à - l'URL LDAP de surcharger le type de connexion. Ce paramètre peut + <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>Établit une connexion non sécurisée sur le port LDAP par - défaut, ce qui est équivalent à <code>ldap://</code> sur le port + <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>Établit une connexion sécurisée sur le port LDAP sécurisé - par défaut, ce qui est équivalent à <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>É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> + <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>Voir plus haut pour des exemples d'URLs définies par la directive + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authnz_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authnz_ldap.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authnz_ldap.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -1625,7 +1625,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authnz_lda } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_core.html b/docs/manual/mod/mod_authz_core.html index 8d3da5b111..cb59875d20 100644 --- a/docs/manual/mod/mod_authz_core.html +++ b/docs/manual/mod/mod_authz_core.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_core.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_core.html.fr b/docs/manual/mod/mod_authz_core.html.fr index 8f63a28748..61b5bbac8d 100644 --- a/docs/manual/mod/mod_authz_core.html.fr +++ b/docs/manual/mod/mod_authz_core.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,31 +27,31 @@ <div id="preamble"><h1>Module Apache mod_authz_core</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Socle d'autorisation</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_core_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_core.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_core_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_core.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache HTTPD</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit un socle de fonctionnalités d'autorisation - permettant d'accorder ou refuser l'accès à certaines zones du site - web aux utilisateurs authentifiés. <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> - donne la possibilité d'enregistrer divers fournisseurs - d'autorisation. Il est en général utilisé avec un module fournisseur + <p>Ce module fournit un socle de fonctionnalités d'autorisation + permettant d'accorder ou refuser l'accès à certaines zones du site + web aux utilisateurs authentifiés. <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> + donne la possibilité d'enregistrer divers fournisseurs + d'autorisation. Il est en général utilisé avec un module fournisseur d'authentification comme <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, et un module d'autorisation comme <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>. Il - permet aussi l'application d'une logique élaborée au déroulement du + permet aussi l'application d'une logique élaborée au déroulement du processus d'autorisation.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#logic">Conteneurs d'autorisation</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#authzalias">Création des alias du fournisseur +<li><img alt="" src="../images/down.gif" /> <a href="#authzalias">Création des alias du fournisseur d'autorisation</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -70,18 +70,18 @@ d'autorisation</a></li> <p>Les directives de conteneur d'autorisation <code class="directive"><a href="#requireall"><RequireAll></a></code>, <code class="directive"><a href="#requireany"><RequireAny></a></code> et <code class="directive"><a href="#requirenone"><RequireNone></a></code> - peuvent être combinées entre elles et avec la directive <code class="directive"><a href="#require">Require</a></code> pour construire une + peuvent être combinées entre elles et avec la directive <code class="directive"><a href="#require">Require</a></code> pour construire une logique d'autorisation complexe.</p> <p>L'exemple ci-dessous illustre la logique d'autorisation suivante. - Pour pouvoir accéder à la ressource, l'utilisateur doit être + Pour pouvoir accéder à la ressource, l'utilisateur doit être l'utilisateur <code>superadmin</code>, ou appartenir aux deux groupes LDAP <code>admins</code> et <code>Administrateurs</code> et soit appartenir au groupe <code>ventes</code>, soit avoir <code>ventes</code> comme valeur de l'attribut LDAP - <code>dept</code>. De plus, pour pouvoir accéder à la ressource, + <code>dept</code>. De plus, pour pouvoir accéder à la ressource, l'utilisateur ne doit appartenir ni au groupe <code>temps</code>, ni - au groupe LDAP <code>Employés temporaires</code>.</p> + au groupe LDAP <code>Employés temporaires</code>.</p> <pre class="prettyprint lang-config"><Directory "/www/mydocs"> <RequireAll> @@ -98,7 +98,7 @@ d'autorisation</a></li> </RequireAny> <RequireNone> Require group temps - Require ldap-group "cn=Employés temporaires,o=Airius" + Require ldap-group "cn=Employés temporaires,o=Airius" </RequireNone> </RequireAll> </Directory></pre> @@ -107,22 +107,22 @@ d'autorisation</a></li> <div class="section"> <h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a></h2> - <p>Le module <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> met à disposition des - fournisseurs d'autorisation génériques utilisables avec la directive + <p>Le module <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> met à disposition des + fournisseurs d'autorisation génériques utilisables avec la directive <code class="directive"><a href="#require">Require</a></code>.</p> <h3><a name="reqenv" id="reqenv">Require env</a></h3> - <p>Le fournisseur <code>env</code> permet de contrôler l'accès au + <p>Le fournisseur <code>env</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>Require - env <var>env-variable</var></code> est spécifié, la requête se voit - autoriser l'accès si la variable d'environnement - <var>env-variable</var> existe. Le serveur permet de définir + env <var>env-variable</var></code> est spécifié, la requête se voit + autoriser l'accès si la variable d'environnement + <var>env-variable</var> existe. Le serveur permet de définir facilement des variables d'environnement en fonction des - caractéristiques de la requête du client via les directives fournies + caractéristiques de la requête du client via les directives fournies par le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. Cette directive Require - env permet donc de contrôler l'accès en fonction des - valeurs des en-têtes de la requête HTTP tels que + env permet donc de contrôler l'accès en fonction des + valeurs des en-têtes de la requête HTTP tels que <code>User-Agent</code> (type de navigateur), <code>Referer</code>, entre autres.</p> @@ -132,28 +132,28 @@ d'autorisation</a></li> </Directory></pre> - <p>Avec cet exemple, les navigateurs dont la chaîne user-agent + <p>Avec cet exemple, les navigateurs dont la chaîne user-agent commence par <code>KnockKnock/2.0</code> se verront autoriser - l'accès, alors que tous les autres seront rejetés.</p> + l'accès, alors que tous les autres seront rejetés.</p> - <p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="../glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la - recherche d'un <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un - listing du contenu d'un répertoire via le module - <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des - variables d'environnement spécifiques à la requête. En outre, à cause + <p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="../glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la + recherche d'un <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un + listing du contenu d'un répertoire via le module + <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des + variables d'environnement spécifiques à la requête. En outre, à cause des phases de l'API auxquelles <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> prend - part, les directives <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas évaluées - séparément dans la sous-requête.</p> + part, les directives <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas évaluées + séparément dans la sous-requête.</p> <h3><a name="reqall" id="reqall">Require all</a></h3> - <p>Le fournisseur <code>all</code> reproduit la fonctionnalité - précédemment fournie par les directives 'Allow from all' et 'Deny + <p>Le fournisseur <code>all</code> reproduit la fonctionnalité + précédemment fournie par les directives 'Allow from all' et 'Deny from all'. Il accepte un argument dont les deux valeurs possibles sont : 'granted' ou 'denied'. Les exemples suivants autorisent ou - interdisent l'accès à toutes les requêtes.</p> + interdisent l'accès à toutes les requêtes.</p> <pre class="prettyprint lang-config">Require all granted</pre> @@ -165,25 +165,25 @@ d'autorisation</a></li> <h3><a name="reqmethod" id="reqmethod">Require method</a></h3> - <p>Le fournisseur <code>method</code> permet d'utiliser la méthode - HTTP dans le processus d'autorisation. Les méthodes GET et HEAD sont - ici considérées comme équivalentes. La méthode TRACE n'est pas - supportée par ce fournisseur ; utilisez à la place la directive + <p>Le fournisseur <code>method</code> permet d'utiliser la méthode + HTTP dans le processus d'autorisation. Les méthodes GET et HEAD sont + ici considérées comme équivalentes. La méthode TRACE n'est pas + supportée par ce fournisseur ; utilisez à la place la directive <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code>.</p> - <p>Dans l'exemple suivant, seules les méthodes GET, HEAD, POST, et - OPTIONS sont autorisées :</p> + <p>Dans l'exemple suivant, seules les méthodes GET, HEAD, POST, et + OPTIONS sont autorisées :</p> <pre class="prettyprint lang-config">Require method GET POST OPTIONS</pre> - <p>Dans l'exemple suivant, les méthodes GET, HEAD, POST, et OPTIONS - sont autorisées sans authentification, alors que toutes les autres - méthodes nécessitent un utilisateur valide :</p> + <p>Dans l'exemple suivant, les méthodes GET, HEAD, POST, et OPTIONS + sont autorisées sans authentification, alors que toutes les autres + méthodes nécessitent un utilisateur valide :</p> <pre class="prettyprint lang-config"><RequireAny> - Require method GET POST OPTIONS - Require valid-user +  Require method GET POST OPTIONS +  Require valid-user </RequireAny></pre> @@ -191,7 +191,7 @@ d'autorisation</a></li> <h3><a name="reqexpr" id="reqexpr">Require expr</a></h3> <p>Le fournisseur <code>expr</code> permet d'accorder l'autorisation - d'accès en fonction d'expressions arbitraires.</p> + d'accès en fonction d'expressions arbitraires.</p> <pre class="prettyprint lang-config">Require expr %{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17</pre> @@ -205,35 +205,35 @@ d'autorisation</a></li> <pre class="prettyprint lang-config">Require expr "!(%{QUERY_STRING} =~ /secret/) && %{REQUEST_URI} in { '/example.cgi', '/other.cgi' }"</pre> - <p>La syntaxe de l'expression est décrite dans la documentation de <a href="../expr.html">ap_expr</a>.</p> + <p>La syntaxe de l'expression est décrite dans la documentation de <a href="../expr.html">ap_expr</a>.</p> - <p>Normalement, l'expression est évaluée avant l'authentification. - Cependant, si l'expression renvoie false et se réfère à la variable + <p>Normalement, l'expression est évaluée avant l'authentification. + Cependant, si l'expression renvoie false et se réfère à la variable <code>%{REMOTE_USER}</code>, le processus d'authentification sera - engagé et l'expression réévaluée.</p> + engagé et l'expression réévaluée.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="authzalias" id="authzalias">Création des alias du fournisseur +<h2><a name="authzalias" id="authzalias">Création des alias du fournisseur d'autorisation</a></h2> - <p>Il est possible de créer des fournisseurs d'autorisation étendus + <p>Il est possible de créer des fournisseurs d'autorisation étendus dans le fichier de configuration et de leur assigner un nom d'alias. - On peut ensuite utiliser ces fournisseurs aliasés dans une + On peut ensuite utiliser ces fournisseurs aliasés dans une directive <code class="directive"><a href="#require">Require</a></code> de - la même manière qu'on le ferait pour des fournisseurs d'autorisation - de base. En plus de la possibilité de créer et d'aliaser un - fournisseur étendu, le même fournisseur d'autorisation étendu peut - être référencé par diverses localisations. + la même manière qu'on le ferait pour des fournisseurs d'autorisation + de base. En plus de la possibilité de créer et d'aliaser un + fournisseur étendu, le même fournisseur d'autorisation étendu peut + être référencé par diverses localisations. </p> <h3><a name="example" id="example">Exemple</a></h3> - <p>Dans l'exemple suivant, on crée deux alias de fournisseur - d'autorisation ldap différents basés sur le fournisseur + <p>Dans l'exemple suivant, on crée deux alias de fournisseur + d'autorisation ldap différents basés sur le fournisseur d'autorisation ldap-group. Il est ainsi possible pour un seul - répertoire de vérifier l'appartenance à un groupe dans plusieurs + répertoire de vérifier l'appartenance à un groupe dans plusieurs serveurs ldap : </p> @@ -258,7 +258,7 @@ Alias "/secure" "/webpages/secure" AuthType Basic AuthName LDAP_Protected_Place - #Opération logique implicite : OU inclusif + #Opération logique implicite : OU inclusif Require ldap-group-alias1 Require ldap-group-alias2 </Directory></pre> @@ -269,51 +269,51 @@ Alias "/secure" "/webpages/secure" <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>Définit la manière dont chaque logique d'autorisation des +<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> +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#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#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>Lorsque l'autorisation est activée, elle est normalement héritée + <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 + 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 + <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 + 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 + 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 + 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 + <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, + 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 + 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>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 + 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 à + 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"> @@ -338,11 +338,11 @@ configuration précédentes.</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="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>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#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>> +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> @@ -351,8 +351,8 @@ Paramètres-Require</var>> </table> <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> + 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> @@ -360,71 +360,71 @@ Paramètres-Require</var>> <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>Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si -l'authentification réussit et si l'autorisation a été refusée. +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#Context">Contexte:</a></th><td>répertoire, .htaccess</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#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> -<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.11 d'Apache HTTPD</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>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 + <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> + 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 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>Vérifie si un utilisateur authentifié a une -autorisation d'accès accordée par un fournisseur +<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>] +<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#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>Cette directive permet de vérifier si un utilisateur authentifié - a l'autorisation d'accès accordée pour un certain fournisseur + <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> + <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>L'accès est autorisé sans restriction.</dd> + <dd>L'accès est autorisé sans restriction.</dd> <dt><code>Require all denied</code></dt> - <dd>L'accès est systématiquement refusé.</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>L'accès n'est autorisé que si l'une au moins des variables - d'environnement spécifiées est définie.</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>L'accès n'est autorisé que pour les méthodes HTTP spécifiées.</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>L'accès est autorisé si <var>expression</var> est évalué à + <dd>L'accès est autorisé si <var>expression</var> est évalué à vrai.</dd> </dl> - <p>Voici quelques exemples de syntaxes autorisées par + <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> @@ -432,35 +432,35 @@ d'autorisation.</td></tr> <dt><code>Require user <var>identifiant utilisateur</var> [<var>identifiant utilisateur</var>] ...</code></dt> - <dd>Seuls les utilisateurs spécifiés auront accès à la + <dd>Seuls les utilisateurs spécifiés auront accès à la ressource.</dd> <dt><code>Require group <var>nom groupe</var> [<var>nom groupe</var>] ...</code></dt> - <dd>Seuls les utilisateurs appartenant aux groupes spécifiés - auront accès à la ressource.</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>Tous les utilisateurs valides auront accès à la + <dd>Tous les utilisateurs valides auront accès à la ressource.</dd> <dt><code>Require ip 10 172.20 192.168.2</code></dt> <dd>Les clients dont les adresses IP font partie des tranches - spécifiées auront accès à la ressource.</dd> + spécifiées auront accès à la ressource.</dd> </dl> <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> + 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 + 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> + définition des utilisateurs et des groupes). Exemple :</p> <pre class="prettyprint lang-config">AuthType Basic AuthName "Restricted Resource" @@ -470,23 +470,23 @@ AuthGroupFile "/web/groups" Require group admin</pre> - <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 + <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>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>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>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 + d'accès, à l'exception de ceux appartenant au groupe <code>reject</code>.</p> <pre class="prettyprint lang-config"><Directory "/www/docs"> @@ -498,30 +498,30 @@ Require group admin</pre> <p>Lorsque plusieurs directives <code class="directive">Require</code> sont - placées dans une même <a href="../sections.html#merging">section de + 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 + 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 + 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> + <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">Tutoriel du contrôle d'accès</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> @@ -531,43 +531,43 @@ Require group admin</pre> <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>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 +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#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>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> + 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> + <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">Conteneurs d'autorisation</a></li> <li><a href="../howto/auth.html">Authentification, autorisation et -contrôle d'accès</a></li> +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>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> +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#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> @@ -575,76 +575,76 @@ retourne elle-même un résultat positif.</td></tr> <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 + 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). + 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> + d'autorisation inversées dans une directive <code class="directive"><RequireAny></code>.</div> <h3>Voir aussi</h3> <ul> <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> +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>Regroupe des directives d'autorisation dont aucune ne doit -retourner un résultat positif pour que la directive globale n'échoue +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#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>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> + 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 + 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> + 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>. + <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> + d'autorisation inversées dans une directive <code class="directive"><RequireNone></code>.</div> <h3>Voir aussi</h3> <ul> <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> +contrôle d'accès</a></li> </ul> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -663,7 +663,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_core } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_dbd.html b/docs/manual/mod/mod_authz_dbd.html index ce414fc781..dd8d25e4f3 100644 --- a/docs/manual/mod/mod_authz_dbd.html +++ b/docs/manual/mod/mod_authz_dbd.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_dbd.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_dbd.html.fr b/docs/manual/mod/mod_authz_dbd.html.fr index 0854348b00..b7521efee6 100644 --- a/docs/manual/mod/mod_authz_dbd.html.fr +++ b/docs/manual/mod/mod_authz_dbd.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,38 +27,38 @@ <div id="preamble"><h1>Module Apache mod_authz_dbd</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation par groupe ou par identifiant via SQL</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_dbd_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_dbd.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les version 2.4 et supérieures +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_dbd_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_dbd.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les version 2.4 et supérieures d'Apache</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit des fonctionnalités d'autorisation permettant - d'accorder ou de refuser aux utilisateurs authentifiés l'accès à - certaines zones du site web en fonction de leur appartenance à tel + <p>Ce module fournit des fonctionnalités d'autorisation permettant + d'accorder ou de refuser aux utilisateurs authentifiés l'accès à + certaines zones du site web en fonction de leur appartenance à tel ou tel groupe. Les modules <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> fournissent une fonctionnalité - similaire, mais ici le module interroge une base de données SQL pour - déterminer si un utilisateur appartient ou non à tel ou tel groupe.</p> - <p>Ce module peut aussi fournir des fonctionnalités de connexion - utilisateur s'appuyant sur une base de données. Ceci prend le plus souvent - sens lorsque le module est utilisé conjointement avec + <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code> fournissent une fonctionnalité + similaire, mais ici le module interroge une base de données SQL pour + déterminer si un utilisateur appartient ou non à tel ou tel groupe.</p> + <p>Ce module peut aussi fournir des fonctionnalités de connexion + utilisateur s'appuyant sur une base de données. Ceci prend le plus souvent + sens lorsque le module est utilisé conjointement avec <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p> - <p>Ce module s'appuie sur <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour spécifier le - pilote de la base de données sous-jacente et les paramètres de - connexion, et gérer les connexions à la base de données.</p> + <p>Ce module s'appuie sur <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour spécifier le + pilote de la base de données sous-jacente et les paramètres de + connexion, et gérer les connexions à la base de données.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#login">Connexion s'appuyant sur une base de données</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#client">Intégration des ouvertures de sessions côté client</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#login">Connexion s'appuyant sur une base de données</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#client">Intégration des ouvertures de sessions côté client</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#example">Exemple de configuration</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#security">Prévention contre les injections SQL</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Prévention contre les injections SQL</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#authzdbdlogintoreferer">AuthzDBDLoginToReferer</a></li> @@ -80,7 +80,7 @@ d'Apache</td></tr></table> <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache permettent, au cours de la phase d'autorisation, de s'assurer qu'un utilisateur - est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute + est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute les types d'autorisation <code>dbd-group</code>, <code>dbd-login</code> et <code>dbd-logout</code>.</p> @@ -89,8 +89,8 @@ d'Apache</td></tr></table> <h3><a name="reqgroup" id="reqgroup">Require dbd-group</a></h3> - <p>Cette directive permet de spécifier à quel groupe un utilisateur - doit appartenir pour obtenir l'autorisation d'accès.</p> + <p>Cette directive permet de spécifier à quel groupe un utilisateur + doit appartenir pour obtenir l'autorisation d'accès.</p> <pre class="prettyprint lang-config"> Require dbd-group team AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"</pre> @@ -100,8 +100,8 @@ d'Apache</td></tr></table> <h3><a name="reqlogin" id="reqlogin">Require dbd-login</a></h3> - <p>Cette directive permet de spécifier une requête à exécuter pour - indiquer que l'utilisateur s'est authentifié.</p> + <p>Cette directive permet de spécifier une requête à exécuter pour + indiquer que l'utilisateur s'est authentifié.</p> <pre class="prettyprint lang-config"> Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"</pre> @@ -111,8 +111,8 @@ d'Apache</td></tr></table> <h3><a name="reqlogout" id="reqlogout">Require dbd-logout</a></h3> - <p>Cette directive permet de spécifier une requête à exécuter pour - indiquer que l'utilisateur s'est déconnecté.</p> + <p>Cette directive permet de spécifier une requête à exécuter pour + indiquer que l'utilisateur s'est déconnecté.</p> <pre class="prettyprint lang-config"> Require dbd-logout AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"</pre> @@ -122,35 +122,35 @@ d'Apache</td></tr></table> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="login" id="login">Connexion s'appuyant sur une base de données</a></h2> +<h2><a name="login" id="login">Connexion s'appuyant sur une base de données</a></h2> <p> -Outre sa fonction d'autorisation standard consistant à vérifier -l'appartenance à des groupes, ce module permet également de gérer des -sessions utilisateur côté serveur grâce à sa fonctionnalité de gestion de login/logout -via base de données. En particulier, il peut mettre à -jour le statut de session de l'utilisateur dans la base de données -chaque fois que celui-ci visite certaines URLs (sous réserve bien +Outre sa fonction d'autorisation standard consistant à vérifier +l'appartenance à des groupes, ce module permet également de gérer des +sessions utilisateur côté serveur grâce à sa fonctionnalité de gestion de login/logout +via base de données. En particulier, il peut mettre à +jour le statut de session de l'utilisateur dans la base de données +chaque fois que celui-ci visite certaines URLs (sous réserve bien entendu que l'utilisateur fournisse les informations de connexion -nécessaires).</p> -<p>Pour cela, il faut definir deux directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> spéciales : <code>Require -dbd-login</code> et <code>Require dbd-logout</code>. Pour les détails de +nécessaires).</p> +<p>Pour cela, il faut definir deux directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> spéciales : <code>Require +dbd-login</code> et <code>Require dbd-logout</code>. Pour les détails de leur utilisation, voir l'exemple de configuration ci-dessous.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="client" id="client">Intégration des ouvertures de sessions côté client</a></h2> - -<p>Pour les administrateurs qui désirent implémenter une gestion de -session côté client fonctionnant de concert avec les fonctionnalités de -connexion/déconnexion côté serveur offertes par ce module, il est possible -de définir ou en d'annuler par exemple un cookie HTTP ou un jeton -de connextion lorsqu'un utilisateur se connecte ou se déconnecte.</p> -<p> Pour supporter une telle intégration, <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code> exporte -un déclenchement optionnel (hook) qui sera lancé chaque fois -que le statut d'un utilisateur sera mis à jour dans la base de données. +<h2><a name="client" id="client">Intégration des ouvertures de sessions côté client</a></h2> + +<p>Pour les administrateurs qui désirent implémenter une gestion de +session côté client fonctionnant de concert avec les fonctionnalités de +connexion/déconnexion côté serveur offertes par ce module, il est possible +de définir ou en d'annuler par exemple un cookie HTTP ou un jeton +de connextion lorsqu'un utilisateur se connecte ou se déconnecte.</p> +<p> Pour supporter une telle intégration, <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code> exporte +un déclenchement optionnel (hook) qui sera lancé chaque fois +que le statut d'un utilisateur sera mis à jour dans la base de données. D'autres modules de gestion de session pourront alors utiliser ce -déclencheur pour utiliser des fonctions d'ouverture et de -fermeture de sessions côté client.</p> +déclencheur pour utiliser des fonctions d'ouverture et de +fermeture de sessions côté client.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="example" id="example">Exemple de configuration</a></h2> @@ -171,7 +171,7 @@ DBDExptime 300 AuthName Team AuthBasicProvider dbd - # requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se + # requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se # connecte AuthDBDUserPWQuery \ "SELECT password FROM authn WHERE user = %s AND login = 'true'" @@ -182,28 +182,28 @@ DBDExptime 300 # configuration de mod_authz_dbd AuthzDBDQuery "SELECT group FROM authz WHERE user = %s" - # lorsqu'un utilisateur échoue dans sa tentative d'authentification ou - # d'autorisation, on l'invite à se connecter ; cette page doit + # lorsqu'un utilisateur échoue dans sa tentative d'authentification ou + # d'autorisation, on l'invite à se connecter ; cette page doit # contenir un lien vers /team-private/login.html ErrorDocument 401 /login-info.html <Files "login.html"> - # il n'est pas nécessaire que l'utilisateur soit déjà connecté ! + # il n'est pas nécessaire que l'utilisateur soit déjà connecté ! AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" - # le processus de connexion dbd exécute une requête pour enregistrer + # le processus de connexion dbd exécute une requête pour enregistrer # la connexion de l'utilisateur Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s" # redirige l'utilisateur vers la page d'origine (si elle existe) - # après une connexion réussie + # après une connexion réussie AuthzDBDLoginToReferer On </Files> <Files "logout.html"> - # le processus de déconnexion dbd exécute une requête pour - # enregistrer la déconnexion de l'utilisateur + # le processus de déconnexion dbd exécute une requête pour + # enregistrer la déconnexion de l'utilisateur Require dbd-logout AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s" </Files> @@ -211,117 +211,117 @@ DBDExptime 300 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="security" id="security">Prévention contre les injections SQL</a></h2> - - <p>Selon le pilote DBD choisi et le serveur d'arrière-plan que vous utilisez, - vous devrez prendre garde à la sécurité dans le domaine SQL. - Avec la plupart des pilotes, vous n'avez rien à faire : la - requête est préparée par la base de données au démarrage, et l'entrée - utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez - peut-être à nettoyer cette entrée. Au moment où ces lignes sont - écrites, le seul pilote DBD qui peut nécessiter le nettoyage de l'entrée +<h2><a name="security" id="security">Prévention contre les injections SQL</a></h2> + + <p>Selon le pilote DBD choisi et le serveur d'arrière-plan que vous utilisez, + vous devrez prendre garde à la sécurité dans le domaine SQL. + Avec la plupart des pilotes, vous n'avez rien à faire : la + requête est préparée par la base de données au démarrage, et l'entrée + utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez + peut-être à nettoyer cette entrée. Au moment où ces lignes sont + écrites, le seul pilote DBD qui peut nécessiter le nettoyage de l'entrée est FreeTDS.</p> - <p>Veuillez vous référez à la documentation de - <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour plus d'informations à propos de la - sécurité dans ce domaine.</p> + <p>Veuillez vous référez à la documentation de + <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour plus d'informations à propos de la + sécurité dans ce domaine.</p> </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>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#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#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>Utilisée en conjonction avec <code>Require dbd-login</code> ou + <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> + 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>Définit la requête SQL pour l'opération +<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#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>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 + 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>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 + <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 + 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>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>. + <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>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> + 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>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#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>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 + <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>La première colonne du premier enregistrement renvoyé par la - requête doit contenir une chaîne de caractères correspondant à une + <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> + 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> + sur cette directive si les deux sont définies.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -340,7 +340,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_dbd. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_dbm.html b/docs/manual/mod/mod_authz_dbm.html index ce23dc1d0e..477bde9729 100644 --- a/docs/manual/mod/mod_authz_dbm.html +++ b/docs/manual/mod/mod_authz_dbm.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_dbm.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authz_dbm.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_authz_dbm.html.fr b/docs/manual/mod/mod_authz_dbm.html.fr index f0f2d1c7e4..e3fe01944a 100644 --- a/docs/manual/mod/mod_authz_dbm.html.fr +++ b/docs/manual/mod/mod_authz_dbm.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,19 +27,19 @@ <div id="preamble"><h1>Module Apache mod_authz_dbm</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbm.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_dbm.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_dbm.html" title="Français"> fr </a> | <a href="../ko/mod/mod_authz_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation par groupes sur base de fichiers DBM</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_dbm_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_dbm.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_dbm_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_dbm.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module propose d'autoriser ou d'interdire l'accès à certaines - zones du site web aux utilisateurs authentifiés en fonction de leur - appartenance à un groupe spécifié. Le module - <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> fournit une fonctionnalité + <p>Ce module propose d'autoriser ou d'interdire l'accès à certaines + zones du site web aux utilisateurs authentifiés en fonction de leur + appartenance à un groupe spécifié. Le module + <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> fournit une fonctionnalité similaire.</p> </div> <div id="quickview"><h3>Sujets</h3> @@ -61,7 +61,7 @@ <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache permettent, au cours de la phase d'autorisation, de s'assurer qu'un utilisateur - est bien autorisé à accéder à une ressource. mod_authz_dbm ajoute + est bien autorisé à accéder à une ressource. mod_authz_dbm ajoute les types d'autorisation <code>dbm-group</code> et <code>dbm-file-group</code>.</p> <p>A partir de la version 2.4.8, les directives require DBM @@ -69,8 +69,8 @@ <h3><a name="reqgroup" id="reqgroup">Require dbm-group</a></h3> - <p>Cette directive permet de spécifier à quel groupe un utilisateur - doit appartenir pour obtenir l'autorisation d'accès.</p> + <p>Cette directive permet de spécifier à quel groupe un utilisateur + doit appartenir pour obtenir l'autorisation d'accès.</p> <pre class="prettyprint lang-config">Require dbm-group admin</pre> @@ -79,8 +79,8 @@ <h3><a name="reqfilegroup" id="reqfilegroup">Require dbm-file-group</a></h3> - <p>Lorsque cette directive est définie, l'utilisateur doit - appartenir au groupe du fichier pour pouvoir y accéder.</p> + <p>Lorsque cette directive est définie, l'utilisateur doit + appartenir au groupe du fichier pour pouvoir y accéder.</p> <pre class="prettyprint lang-config">Require dbm-file-group</pre> @@ -91,8 +91,8 @@ <div class="section"> <h2><a name="examples" id="examples">Exemple d'utilisation</a></h2> -<p><em>Notez que si vous utilisez mod_authz_dbm, le mot-clé pour les -groupes d'authentification qui était auparavant <code>group</code> est +<p><em>Notez que si vous utilisez mod_authz_dbm, le mot-clé pour les +groupes d'authentification qui était auparavant <code>group</code> est maintenant <code>dbm-group</code> :</em> </p> <pre class="prettyprint lang-config"><Directory "/foo/bar"> @@ -108,90 +108,90 @@ maintenant <code>dbm-group</code> :</em> <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>Définit le nom du fichier de base de données qui liste +<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#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>La directive <code class="directive">AuthDBMGroupFile</code> définit + <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. + 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, + <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> + 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 + <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> +<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>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 + <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>La clé du fichier DBM unique est le nom d'utilisateur. La - valeur associée à la clé contient :</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> - Mot de passe chiffré : Liste de groupes [ : (ignoré) ] + Mot de passe chiffré : Liste de groupes [ : (ignoré) ] </code></p></div> <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. C'est - le format utilisé par www.telescope.org pour sa base de données - combinée groupes et mots de passe.</p> + 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. C'est + le format utilisé par www.telescope.org pour sa base de données + combinée groupes et mots de passe.</p> </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>Définit le type de fichier de base de données contenant +<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#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#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>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 + <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> + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbm.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_dbm.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_dbm.html" title="Français"> fr </a> | <a href="../ko/mod/mod_authz_dbm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -211,7 +211,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_dbm. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_groupfile.html b/docs/manual/mod/mod_authz_groupfile.html index f0ae9677b7..ea8826b775 100644 --- a/docs/manual/mod/mod_authz_groupfile.html +++ b/docs/manual/mod/mod_authz_groupfile.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_groupfile.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authz_groupfile.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authz_groupfile.html.fr b/docs/manual/mod/mod_authz_groupfile.html.fr index 8abaae4d7f..8940bcff0b 100644 --- a/docs/manual/mod/mod_authz_groupfile.html.fr +++ b/docs/manual/mod/mod_authz_groupfile.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,21 +27,21 @@ <div id="preamble"><h1>Module Apache mod_authz_groupfile</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_groupfile.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_groupfile.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_groupfile.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_groupfile.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_groupfile.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation de groupes à base de fichiers +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation de groupes à base de fichiers textes</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_groupfile_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_groupfile.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_groupfile_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_groupfile.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet d'autoriser ou d'interdire l'accès à -certaines zones du site web aux utilisateurs authentifiés en -fonction de leur appartenance à un groupe spécifié. Le module -<code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code> fournit une fonctionnalité similaire.</p> + <p>Ce module permet d'autoriser ou d'interdire l'accès à +certaines zones du site web aux utilisateurs authentifiés en +fonction de leur appartenance à un groupe spécifié. Le module +<code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code> fournit une fonctionnalité similaire.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -60,7 +60,7 @@ fonction de leur appartenance à un groupe spécifié. Le module <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache permettent, au cours de la phase d'autorisation, de s'assurer qu'un utilisateur - est bien autorisé à accéder à une ressource. mod_authz_groupfile ajoute + est bien autorisé à accéder à une ressource. mod_authz_groupfile ajoute les types d'autorisation <code>group</code> et <code>file-group</code>. </p> @@ -69,8 +69,8 @@ fonction de leur appartenance à un groupe spécifié. Le module <h3><a name="reqgroup" id="reqgroup">Require group</a></h3> - <p>Cette directive permet de spécifier à quel groupe un utilisateur - doit appartenir pour obtenir l'autorisation d'accès.</p> + <p>Cette directive permet de spécifier à quel groupe un utilisateur + doit appartenir pour obtenir l'autorisation d'accès.</p> <pre class="prettyprint lang-config">Require group admin</pre> @@ -79,8 +79,8 @@ fonction de leur appartenance à un groupe spécifié. Le module <h3><a name="reqfilegroup" id="reqfilegroup">Require file-group</a></h3> - <p>Lorsque cette directive est définie, l'utilisateur doit - appartenir au groupe du fichier pour pouvoir y accéder.</p> + <p>Lorsque cette directive est définie, l'utilisateur doit + appartenir au groupe du fichier pour pouvoir y accéder.</p> <pre class="prettyprint lang-config">Require file-group</pre> @@ -91,46 +91,46 @@ fonction de leur appartenance à un groupe spécifié. Le module <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>Définit le nom d'un fichier texte contenant la liste des -groupes d'utilisateurs permettant de définir les autorisations des +<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#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>La directive <code class="directive">AuthGroupFile</code> définit + <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. +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 +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> +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>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 +<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>Sécurité</h3> + <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> +ê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> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_groupfile.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_groupfile.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_groupfile.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_groupfile.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_groupfile.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -151,7 +151,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_grou } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_host.html b/docs/manual/mod/mod_authz_host.html index f46aa2e275..ac45e3bfd3 100644 --- a/docs/manual/mod/mod_authz_host.html +++ b/docs/manual/mod/mod_authz_host.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_host.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_host.html.fr b/docs/manual/mod/mod_authz_host.html.fr index 0a6f471a37..ce0a0fca83 100644 --- a/docs/manual/mod/mod_authz_host.html.fr +++ b/docs/manual/mod/mod_authz_host.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,31 +27,31 @@ <div id="preamble"><h1>Module Apache mod_authz_host</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe basées sur l'hôte (nom ou adresse +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe basées sur l'hôte (nom ou adresse IP)</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_host_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_host.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_host_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_host.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures d'Apache</td></tr></table> <h3>Sommaire</h3> - <p>Les fournisseurs d'autorisation implémentés par le module - <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> sont enregistrés à l'aide de + <p>Les fournisseurs d'autorisation implémentés par le module + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> sont enregistrés à l'aide de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. On peut - utiliser cette directive à l'intérieur de sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ou <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou de fichiers + utiliser cette directive à l'intérieur de sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ou <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou de fichiers <code><a href="core.html#accessfilename">.htaccess</a> </code> pour - contrôler l'accès à certaines zones du serveur. Le contrôle d'accès - peut être effectué en fonction du nom d'hôte ou de l'adresse IP.</p> + contrôler l'accès à certaines zones du serveur. Le contrôle d'accès + peut être effectué en fonction du nom d'hôte ou de l'adresse IP.</p> - <p>En général, les directives de restriction d'accès s'appliquent à - toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite dans la plupart des cas. Il est cependant possible de ne restreindre - l'accès que pour certaines méthodes, tout en laissant les autres - méthodes sans protection, en plaçant les directives dans une section + l'accès que pour certaines méthodes, tout en laissant les autres + méthodes sans protection, en plaçant les directives dans une section <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p> </div> <div id="quickview"><h3>Sujets</h3> @@ -62,24 +62,24 @@ d'Apache</td></tr></table> <h3>Voir aussi</h3> <ul class="seealso"> <li><a href="../howto/auth.html">Authentification, autorisation et -contrôle d'accès</a></li> +contrôle d'accès</a></li> <li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a></h2> - <p>La directive Apache <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> est utilisée au cours de - la phase d'autorisation pour vérifier si un utilisateur se voit - accorder ou refuser l'accès à une ressource. mod_authz_host fournit + <p>La directive Apache <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> est utilisée au cours de + la phase d'autorisation pour vérifier si un utilisateur se voit + accorder ou refuser l'accès à une ressource. mod_authz_host fournit les types d'autorisation <code>ip</code>, <code>host</code> et <code>local</code>. D'autres types d'autorisation - sont aussi disponibles, mais nécessitent le chargement des modules - d'autorisation appropriés.</p> + sont aussi disponibles, mais nécessitent le chargement des modules + d'autorisation appropriés.</p> - <p>Ces fournisseurs d'autorisation permettent de déterminer quels - hôtes peuvent accéder à une zone du serveur. On peut contrôler - l'accès en fonction du nom d'hôte, de l'adresse IP, ou d'un intervalle + <p>Ces fournisseurs d'autorisation permettent de déterminer quels + hôtes peuvent accéder à une zone du serveur. On peut contrôler + l'accès en fonction du nom d'hôte, de l'adresse IP, ou d'un intervalle d'adresses IP.</p> <p>A partir de la version 2.4.8, les directives require host @@ -87,46 +87,46 @@ contrôle d'accès</a></li> <h3><a name="reqip" id="reqip">Require ip</a></h3> - <p>Le fournisseur <code>ip</code> permet de contrôler l'accès au + <p>Le fournisseur <code>ip</code> permet de contrôler l'accès au serveur en fonction de l'adresse IP du client distant. Lorsque - <code>Require ip <var>adresse-ip</var></code> est spécifié, la - requête est autorisée si l'adresse IP du client distant correspond - à</p> + <code>Require ip <var>adresse-ip</var></code> est spécifié, la + requête est autorisée si l'adresse IP du client distant correspond + à </p> - <p>Une adresse IP complète :</p> + <p>Une adresse IP complète :</p> <pre class="prettyprint lang-config">Require ip 10.1.2.3 Require ip 192.168.1.104 192.168.1.205</pre> - <p>L'adresse IP d'un hôte pour qui l'accès est accordé</p> + <p>L'adresse IP d'un hôte pour qui l'accès est accordé</p> <p>Une adresse IP partielle :</p> <pre class="prettyprint lang-config">Require ip 10.1 Require ip 10 172.20 192.168.2</pre> - <p>Les 1 à 3 premiers octets d'une adresse IP, pour une restriction - à un sous-réseau.</p> + <p>Les 1 à 3 premiers octets d'une adresse IP, pour une restriction + à un sous-réseau.</p> - <p>Une paire réseau/masque de sous-réseau :</p> + <p>Une paire réseau/masque de sous-réseau :</p> <pre class="prettyprint lang-config">Require ip 10.1.0.0/255.255.0.0</pre> - <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une - restriction de sous-réseau plus fine.</p> + <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une + restriction de sous-réseau plus fine.</p> - <p>Une spécification CIDR réseau/nnn :</p> + <p>Une spécification CIDR réseau/nnn :</p> <pre class="prettyprint lang-config">Require ip 10.1.0.0/16</pre> - <p>Identique au cas précédent, excepté que le masque de sous-réseau - représente les nnn premiers bits de poids fort.</p> + <p>Identique au cas précédent, excepté que le masque de sous-réseau + représente les nnn premiers bits de poids fort.</p> <p>Notez que les trois derniers exemples correspondent exectement au - même ensemble d'hôtes.</p> + même ensemble d'hôtes.</p> - <p>On peut spécifier des adresses et des sous-réseaux IPv6 comme + <p>On peut spécifier des adresses et des sous-réseaux IPv6 comme suit :</p> <pre class="prettyprint lang-config">Require ip 2001:db8::a00:20ff:fea7:ccea @@ -135,67 +135,67 @@ Require ip 2001:db8:2:1::/64 Require ip 2001:db8:3::/48</pre> - <p>Note: comme les adresses IP sont lues au démarrage, les - expressions ne sont pas évaluées au moment de la requête.</p> + <p>Note: comme les adresses IP sont lues au démarrage, les + expressions ne sont pas évaluées au moment de la requête.</p> <h3><a name="reqhost" id="reqhost">Require host</a></h3> - <p>Le fournisseur <code>host</code> permet de contrôler l'accès au - serveur en fonction du nom d'hôte du client distant. Lorsque - <code>Require host <var>nom-hôte</var></code> est spécifié, la - requête est autorisée si le nom d'hôte correspond à</p> + <p>Le fournisseur <code>host</code> permet de contrôler l'accès au + serveur en fonction du nom d'hôte du client distant. Lorsque + <code>Require host <var>nom-hôte</var></code> est spécifié, la + requête est autorisée si le nom d'hôte correspond à </p> - <p>Un nom de domaine (éventuellement partiel)</p> + <p>Un nom de domaine (éventuellement partiel)</p> <pre class="prettyprint lang-config">Require host example.org Require host .net example.edu</pre> - <p>Les hôtes dont les noms correspondent ou se terminent par la - chaîne spécifiée se voient accorder l'accès. Seuls les élément de + <p>Les hôtes dont les noms correspondent ou se terminent par la + chaîne spécifiée se voient accorder l'accès. Seuls les élément de nom de domaine complets sont mis en correspondance ; ainsi, - l'exemple ci-dessus correspondra à <code>foo.example.org</code>, mais - ne correspondra pas à <code>fooexample.org</code>. Avec cette + l'exemple ci-dessus correspondra à <code>foo.example.org</code>, mais + ne correspondra pas à <code>fooexample.org</code>. Avec cette configuration, Apache va effectuer une double recherche DNS sur - l'adresse IP du client, sans tenir compte de la définition de la + 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>. Il va effectuer une recherche DNS inverse sur l'adresse IP pour trouver - le nom d'hôte associé, puis une recherche DNS directe sur le nom - d'hôte pour vérifier 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 sont cohérentes.</p> + le nom d'hôte associé, puis une recherche DNS directe sur le nom + d'hôte pour vérifier 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 sont cohérentes.</p> <h3><a name="reqlocal" id="reqlocal">Require local</a></h3> - <p>Le fournisseur <code>local</code> autorise l'accès au serveur si + <p>Le fournisseur <code>local</code> autorise l'accès au serveur si l'une au moins de ces conditions est satisfaite :</p> <ul> - <li>l'adresse IP du client correspond à 127.0.0.0/8</li> + <li>l'adresse IP du client correspond à 127.0.0.0/8</li> <li>l'adresse IP du client est ::1</li> <li>les adresses IP du client et du serveur sont identiques</li> </ul> - <p>L'exemple suivant montre une méthode simple pour sélectionner les - connexions en provenance de l'hôte local :</p> + <p>L'exemple suivant montre une méthode simple pour sélectionner les + connexions en provenance de l'hôte local :</p> <pre class="prettyprint lang-config">Require local</pre> -<h3><a name="proxy" id="proxy">Note concernant la sécurité</a></h3> +<h3><a name="proxy" id="proxy">Note concernant la sécurité</a></h3> - <p>Si le contenu de votre serveur est mandaté, vous devez garder à - l'esprit que l'adresse client correspondra à l'adresse de votre - serveur mandataire et non à l'adresse du client, et l'utilisation de + <p>Si le contenu de votre serveur est mandaté, vous devez garder à + l'esprit que l'adresse client correspondra à l'adresse de votre + serveur mandataire et non à l'adresse du client, et l'utilisation de la directive <code>Require</code> dans ce contexte ne provoquera pas - forcément l'effet désiré. Voir <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> pour - une solution possible à ce problème.</p> + forcément l'effet désiré. Voir <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> pour + une solution possible à ce problème.</p> @@ -203,7 +203,7 @@ Require host .net example.edu</pre> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -222,7 +222,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_host } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_owner.html b/docs/manual/mod/mod_authz_owner.html index e021070ec1..ceeec6fadd 100644 --- a/docs/manual/mod/mod_authz_owner.html +++ b/docs/manual/mod/mod_authz_owner.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_owner.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authz_owner.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authz_owner.html.fr b/docs/manual/mod/mod_authz_owner.html.fr index c8bb69963f..6e75f4517a 100644 --- a/docs/manual/mod/mod_authz_owner.html.fr +++ b/docs/manual/mod/mod_authz_owner.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,58 +27,58 @@ <div id="preamble"><h1>Module Apache mod_authz_owner</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_owner.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basée sur l'appartenance des +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basée sur l'appartenance des fichiers</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_owner_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_owner.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_owner_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_owner.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet de contrôler l'accès aux fichiers en comparant - l'identifiant utilisateur ayant servi à l'authentification HTTP - (l'identifiant utilisateur web) avec le propriétaire ou le groupe - du fichier demandé du point de vue du système de fichiers. Le nom - d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par + <p>Ce module permet de contrôler l'accès aux fichiers en comparant + l'identifiant utilisateur ayant servi à l'authentification HTTP + (l'identifiant utilisateur web) avec le propriétaire ou le groupe + du fichier demandé du point de vue du système de fichiers. Le nom + d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par un module d'authentification comme <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>. - <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> reconnaît deux arguments pour la + <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> reconnaît deux arguments pour la directive <code class="directive"><a href="../mod/core.html#require">Require</a></code> : <code>file-owner</code> et <code>file-group</code> :</p> <dl> <dt><code>file-owner</code></dt> - <dd>Le nom d'utilisateur web utilisé pour l'authentification doit - correspondre au nom système du propriétaire du fichier demandé. En - d'autres termes, si le système indique <code>jones</code> comme - propriétaire du fichier demandé, le nom d'utilisateur fourni pour - l'authentification HTTP doit aussi être <code>jones</code>.</dd> + <dd>Le nom d'utilisateur web utilisé pour l'authentification doit + correspondre au nom système du propriétaire du fichier demandé. En + d'autres termes, si le système indique <code>jones</code> comme + propriétaire du fichier demandé, le nom d'utilisateur fourni pour + l'authentification HTTP doit aussi être <code>jones</code>.</dd> <dt><code>file-group</code></dt> - <dd>Le nom du groupe système du fichier demandé doit être présent - dans une base de données de groupes fournie, par exemple, par + <dd>Le nom du groupe système du fichier demandé doit être présent + dans une base de données de groupes fournie, par exemple, par <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> ou <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, et le nom d'utilisateur web fourni - pour l'authentification doit être un membre de ce groupe. Par - exemple, si le système indique que le groupe (système) du fichier - demandé est <code>accounts</code>, le groupe <code>accounts</code> - doit apparaître dans la base de données des groupes, et le nom - d'utilisateur web utilisé pour l'authentification doit être un + pour l'authentification doit être un membre de ce groupe. Par + exemple, si le système indique que le groupe (système) du fichier + demandé est <code>accounts</code>, le groupe <code>accounts</code> + doit apparaître dans la base de données des groupes, et le nom + d'utilisateur web utilisé pour l'authentification doit être un membre de ce groupe.</dd> </dl> <div class="note"><h3>Note</h3> - <p>Si le module <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> est utilisé pour - vérifier l'autorisation d'accès à une ressource qui n'est pas - vraiment présente dans le système de fichiers (en d'autres termes - une ressource virtuelle), il refusera l'accès.</p> + <p>Si le module <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> est utilisé pour + vérifier l'autorisation d'accès à une ressource qui n'est pas + vraiment présente dans le système de fichiers (en d'autres termes + une ressource virtuelle), il refusera l'accès.</p> - <p>En particulier, il n'accordera jamais l'accès à une ressource + <p>En particulier, il n'accordera jamais l'accès à une ressource du type <a href="../content-negotiation.html#multiviews">"Vues - multiples" (MultiViews) d'un contenu négocié</a>.</p> + multiples" (MultiViews) d'un contenu négocié</a>.</p> </div> </div> <div id="quickview"><h3>Sujets</h3> @@ -95,18 +95,18 @@ fichiers</td></tr> <h2><a name="examples" id="examples">Exemples de configuration</a></h2> <h3><a name="examples.file-owner" id="examples.file-owner">Require file-owner</a></h3> - <p>Considérons un serveur Web Apache fonctionnant sous un système - multi-utilisateurs, où les fichiers de chaque utilisateur sont - stockés dans <code>~/public_html/private</code>. En supposant - qu'il n'existe qu'une seule base de données contenant les noms + <p>Considérons un serveur Web Apache fonctionnant sous un système + multi-utilisateurs, où les fichiers de chaque utilisateur sont + stockés dans <code>~/public_html/private</code>. En supposant + qu'il n'existe qu'une seule base de données contenant les noms d'utilisateurs web, et que ces noms d'utilisateurs correspondent - aux noms d'utilisateurs système qui sont les propriétaires + aux noms d'utilisateurs système qui sont les propriétaires effectifs des fichiers, la configuration de l'exemple suivant - n'accordera l'autorisation d'accès aux fichiers qu'à leur - propriétaire. L'utilisateur <code>jones</code> ne sera pas - autorisé à accéder aux fichiers situés dans - <code>/home/smith/public_html/private</code>, à moins que leur - propriétaire ne soit <code>jones</code> au lieu de + n'accordera l'autorisation d'accès aux fichiers qu'à leur + propriétaire. L'utilisateur <code>jones</code> ne sera pas + autorisé à accéder aux fichiers situés dans + <code>/home/smith/public_html/private</code>, à moins que leur + propriétaire ne soit <code>jones</code> au lieu de <code>smith</code>.</p> <pre class="prettyprint lang-config"><Directory "/home/*/public_html/private"> @@ -120,17 +120,17 @@ fichiers</td></tr> <h3><a name="examples.file-group" id="examples.file-group">Require file-group</a></h3> - <p>Considérons un système similaire à celui décrit ci-dessus, mais - où certains utilisateurs partagent leurs fichiers de projets dans - <code>~/public_html/project-foo</code>. Le groupe système des + <p>Considérons un système similaire à celui décrit ci-dessus, mais + où certains utilisateurs partagent leurs fichiers de projets dans + <code>~/public_html/project-foo</code>. Le groupe système des fichiers est <code>foo</code>, et il n'existe qu'une seule base de - données <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> qui contient + données <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> qui contient tous les noms d'utilisateurs web et leurs groupes d'appartenance. Ces noms d'utilisateurs web doivent alors appartenir au moins au groupe <code>foo</code>. En d'autres termes, si <code>jones</code> et <code>smith</code> sont tous deux membres du groupe - <code>foo</code>, ils seront autorisés à accéder aux - répertoires <code>project-foo</code> de chacun d'entre eux.</p> + <code>foo</code>, ils seront autorisés à accéder aux + répertoires <code>project-foo</code> de chacun d'entre eux.</p> <pre class="prettyprint lang-config"><Directory "/home/*/public_html/project-foo"> AuthType Basic @@ -150,7 +150,7 @@ fichiers</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_owner.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -171,7 +171,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_owne } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_authz_user.html b/docs/manual/mod/mod_authz_user.html index 82294b4184..f6e1bcd2f5 100644 --- a/docs/manual/mod/mod_authz_user.html +++ b/docs/manual/mod/mod_authz_user.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_authz_user.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_authz_user.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_authz_user.html.fr b/docs/manual/mod/mod_authz_user.html.fr index 7fdc224888..53b1b667b9 100644 --- a/docs/manual/mod/mod_authz_user.html.fr +++ b/docs/manual/mod/mod_authz_user.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,23 +27,23 @@ <div id="preamble"><h1>Module Apache mod_authz_user</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_user.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basée sur l'utilisateur</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basée sur l'utilisateur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_user_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_user.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_user_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_user.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet d'accorder ou de refuser l'accès à certaines - zones du site web aux utilisateurs authentifiés. - <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code> accorde l'accès si l'utilisateur - authentifié fait partie de la liste spécifiée par une directive + <p>Ce module permet d'accorder ou de refuser l'accès à certaines + zones du site web aux utilisateurs authentifiés. + <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code> accorde l'accès si l'utilisateur + authentifié fait partie de la liste spécifiée par une directive <code>Require user</code>. On peut aussi utiliser la directive - <code>Require valid-user</code> pour accorder l'accès à tous les - utilisateurs qui ont été authentifiés avec succès.</p> + <code>Require valid-user</code> pour accorder l'accès à tous les + utilisateurs qui ont été authentifiés avec succès.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -60,7 +60,7 @@ <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache permettent, au cours de la phase d'autorisation, de s'assurer qu'un utilisateur - est bien autorisé à accéder à une + est bien autorisé à accéder à une ressource. mod_authz_user ajoute les types d'autorisation <code>user</code> et <code>valid-user</code>. </p> @@ -70,8 +70,8 @@ <h3><a name="requser" id="requser">Require user</a></h3> - <p>Cette directive permet de spécifier une liste d'utilisateurs - autorisés à accéder à la ressource.</p> + <p>Cette directive permet de spécifier une liste d'utilisateurs + autorisés à accéder à la ressource.</p> <pre class="prettyprint lang-config">Require user john paul george ringo</pre> @@ -80,8 +80,8 @@ <h3><a name="reqvaliduser" id="reqvaliduser">Require valid-user</a></h3> - <p>Lorsque cette directive est définie, tout utilisateur qui s'est - authentifié avec succès aura l'autorisation d'accès à la ressource.</p> + <p>Lorsque cette directive est définie, tout utilisateur qui s'est + authentifié avec succès aura l'autorisation d'accès à la ressource.</p> <pre class="prettyprint lang-config">Require valid-user</pre> @@ -92,7 +92,7 @@ </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_user.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -113,7 +113,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_user } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_autoindex.html b/docs/manual/mod/mod_autoindex.html index f4075af741..71fdf44dda 100644 --- a/docs/manual/mod/mod_autoindex.html +++ b/docs/manual/mod/mod_autoindex.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_autoindex.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_autoindex.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_autoindex.html.fr b/docs/manual/mod/mod_autoindex.html.fr index edb39e9ff0..11beffef65 100644 --- a/docs/manual/mod/mod_autoindex.html.fr +++ b/docs/manual/mod/mod_autoindex.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,61 +27,61 @@ <div id="preamble"><h1>Module Apache mod_autoindex</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> | <a href="../ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Génère automatiquement des index de répertoires d'une -manière similaire à la commande Unix <code>ls</code>, ou à la commande +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Génère automatiquement des index de répertoires d'une +manière similaire à la commande Unix <code>ls</code>, ou à la commande shell Win32 <code>dir</code></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>autoindex_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_autoindex.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>autoindex_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_autoindex.c</td></tr></table> <h3>Sommaire</h3> - <p>L'index d'un répertoire peut être généré de deux manières :</p> + <p>L'index d'un répertoire peut être généré de deux manières :</p> <ul> - <li>Un fichier situé dans ce répertoire, en général appelé - <code>index.html</code>, mais dont le nom de ce ou ces fichiers peut être défini par la + <li>Un fichier situé dans ce répertoire, en général appelé + <code>index.html</code>, mais dont le nom de ce ou ces fichiers peut être défini par la directive <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>. C'est le module <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> qui traite alors cet index.</li> - <li>Un listing généré par le serveur, dont le format est contrôlé + <li>Un listing généré par le serveur, dont le format est contrôlé par un certain nombre de directives. Les directives <code class="directive"><a href="#addicon">AddIcon</a></code>, <code class="directive"><a href="#addiconbyencoding">AddIconByEncoding</a></code> et <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> permettent de - définir une liste d'icônes à afficher en fonction des différents - types de fichiers ; pour chaque fichier listé, le premier icône - qui correspond au type du fichier est affiché. C'est le module + définir une liste d'icônes à afficher en fonction des différents + types de fichiers ; pour chaque fichier listé, le premier icône + qui correspond au type du fichier est affiché. C'est le module <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> qui traite alors cet index.</li> </ul> - <p>Les deux fonctions sont séparées, si bien que vous pouvez - entièrement supprimer (ou remplacer) la génération automatique + <p>Les deux fonctions sont séparées, si bien que vous pouvez + entièrement supprimer (ou remplacer) la génération automatique d'index, si vous le souhaitez.</p> - <p>On active la génération automatique d'index en spécifiant - <code>Options +Indexes</code>. Voir la directive <code class="directive"><a href="../mod/core.html#options">Options</a></code> pour plus de détails.</p> - - <p>Si la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code> est spécifiée avec - l'option <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>, les en-têtes de colonnes sont des liens - qui permettent de contrôler l'ordre de tri de l'affichage. Si vous - actionnez le lien d'un en-tête, le listing sera généré à nouveau, - trié en fonction des valeurs de la colonne concernée. Si l'on - actionne de manière répétitive le même en-tête, l'ordre de tri est - commuté entre les ordres croissant et décroissant. On peut supprimer - ces liens d'en-têtes de colonnes à l'aide de l'option + <p>On active la génération automatique d'index en spécifiant + <code>Options +Indexes</code>. Voir la directive <code class="directive"><a href="../mod/core.html#options">Options</a></code> pour plus de détails.</p> + + <p>Si la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code> est spécifiée avec + l'option <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>, les en-têtes de colonnes sont des liens + qui permettent de contrôler l'ordre de tri de l'affichage. Si vous + actionnez le lien d'un en-tête, le listing sera généré à nouveau, + trié en fonction des valeurs de la colonne concernée. Si l'on + actionne de manière répétitive le même en-tête, l'ordre de tri est + commuté entre les ordres croissant et décroissant. On peut supprimer + ces liens d'en-têtes de colonnes à l'aide de l'option <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code> de la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code>.</p> - <p>Notez que lorsque l'affichage est trié en fonction de la taille, - c'est la taille <em>réelle</em> qui est prise en compte, et non la - valeur affichée - ainsi, un fichier de 1010 octets sera toujours - affiché avant un fichier de 1011 octets (en ordre croissant), même - si la taille affichée des deux fichiers est "1K".</p> + <p>Notez que lorsque l'affichage est trié en fonction de la taille, + c'est la taille <em>réelle</em> qui est prise en compte, et non la + valeur affichée - ainsi, un fichier de 1010 octets sera toujours + affiché avant un fichier de 1011 octets (en ordre croissant), même + si la taille affichée des deux fichiers est "1K".</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#query">Arguments de la requête d'autoindexation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#query">Arguments de la requête d'autoindexation</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#addalt">AddAlt</a></li> @@ -104,27 +104,27 @@ shell Win32 <code>dir</code></td></tr> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="query" id="query">Arguments de la requête d'autoindexation</a></h2> +<h2><a name="query" id="query">Arguments de la requête d'autoindexation</a></h2> - <p>La chaîne de paramètres de la requête peut contenir de nombreux - arguments permettant dans une certaine mesure au client de contrôler - l'ordre de l'index du répertoire, ainsi que la liste des fichiers à - afficher. Si vous souhaitez désactiver cette fonctionnalité, + <p>La chaîne de paramètres de la requête peut contenir de nombreux + arguments permettant dans une certaine mesure au client de contrôler + l'ordre de l'index du répertoire, ainsi que la liste des fichiers à + afficher. Si vous souhaitez désactiver cette fonctionnalité, utilisez l'option <code><a href="#indexoptions.ignoreclient">IndexOptions IgnoreClient</a></code>.</p> - <p>Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens - auto-référant qui ajoutent les options de tri à la requête énumérées - ci-dessous qui peuvent être ajoutées à toute requête concernant la - ressource répertoire.</p> + <p>Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens + auto-référant qui ajoutent les options de tri à la requête énumérées + ci-dessous qui peuvent être ajoutées à toute requête concernant la + ressource répertoire.</p> <ul> <li><code>C=N</code> trie l'affichage en fonction du nom de fichier</li> <li><code>C=M</code> trie l'affichage en fonction de la date de - dernière modification, puis du nom de fichier</li> + dernière modification, puis du nom de fichier</li> <li><code>C=S</code> trie l'affichage en fonction de la taille, puis du nom de fichier</li> @@ -135,41 +135,41 @@ shell Win32 <code>dir</code></td></tr> <li><code>O=A</code> trie l'affichage selon l'ordre croissant</li> <li class="separate"><code>O=D</code> trie l'affichage selon - l'ordre décroissant</li> + l'ordre décroissant</li> <li><code>F=0</code> affiche le listing sous la forme d'une simple liste (sans FancyIndex)</li> - <li><code>F=1</code> affiche le listing avec en-têtes de colonnes + <li><code>F=1</code> affiche le listing avec en-têtes de colonnes sous forme de liens hyper-textes (FancyIndexed)</li> <li class="separate"><code>F=2</code> affiche le listing sous - forme de table HTML avec en-têtes de colonnes contenant des liens + forme de table HTML avec en-têtes de colonnes contenant des liens hyper-textes (FancyIndexed)</li> - <li><code>V=0</code> désactive le tri en fonction de la + <li><code>V=0</code> désactive le tri en fonction de la version</li> <li class="separate"><code>V=1</code> active le tri en fonction de la version</li> - <li><code>P=<var>modèle</var></code> n'affiche que les fichiers - correspondant au <var>modèle</var> spécifié</li> + <li><code>P=<var>modèle</var></code> n'affiche que les fichiers + correspondant au <var>modèle</var> spécifié</li> </ul> - <p>Notez que l'argument 'P' (pour Pattern) n'est testé - qu'<em>après</em> que les directives habituelles <code class="directive"><a href="#indexignore">IndexIgnore</a></code> ont été traitées, - et que tous les noms de fichiers sont encore assujettis aux mêmes - critères que pour tout autre listing auto-indexé. L'interpréteur - d'arguments de requête de <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> s'arrête - immédiatement s'il rencontre une option non reconnue. Les arguments - de requête doivent être bien formés, selon la table ci-dessus.</p> + <p>Notez que l'argument 'P' (pour Pattern) n'est testé + qu'<em>après</em> que les directives habituelles <code class="directive"><a href="#indexignore">IndexIgnore</a></code> ont été traitées, + et que tous les noms de fichiers sont encore assujettis aux mêmes + critères que pour tout autre listing auto-indexé. L'interpréteur + d'arguments de requête de <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> s'arrête + immédiatement s'il rencontre une option non reconnue. Les arguments + de requête doivent être bien formés, selon la table ci-dessus.</p> - <p>Les options de requêtes sont illustrées par l'exemple ci-dessous, - qui peut être copié et collé dans un fichier header.html. Notez que + <p>Les options de requêtes sont illustrées par l'exemple ci-dessous, + qui peut être copié et collé dans un fichier header.html. Notez que l'argument inconnu "X", pour le bouton submit, est introduit en - dernier afin de s'assurer que tous les arguments ont été - interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.</p> + dernier afin de s'assurer que tous les arguments ont été + interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.</p> <div class="example"><p><code> <form action="" method="get"><br /> @@ -178,12 +178,12 @@ shell Win32 <code>dir</code></td></tr> <span class="indent"> <option value="0"> liste simple</option><br /> <option value="1" selected="selected"> liste avec - en-têtes</option><br /> - <option value="2"> liste avec en-tête sous forme de + en-têtes</option><br /> + <option value="2"> liste avec en-tête sous forme de table</option><br /> </span> </select><br /> - triée par <select name="C"><br /> + triée par <select name="C"><br /> <span class="indent"> <option value="N" selected="selected"> nom</option><br /> <option value="M"> date de modification</option><br /> @@ -194,7 +194,7 @@ shell Win32 <code>dir</code></td></tr> <select name="O"><br /> <span class="indent"> <option value="A" selected="selected"> croissant</option><br /> - <option value="D"> décroissant</option><br /> + <option value="D"> décroissant</option><br /> </span> </select><br /> <select name="V"><br /> @@ -204,7 +204,7 @@ shell Win32 <code>dir</code></td></tr> <option value="1"> en fonction de la version</option><br /> </span> </select><br /> - correspondant à <input type="text" name="P" value="*" /><br /> + correspondant à <input type="text" name="P" value="*" /><br /> <input type="submit" name="X" value="Go" /><br /> </span> </form> @@ -214,25 +214,25 @@ shell Win32 <code>dir</code></td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>Texte optionnel à afficher à la place d'un icône pour un +<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#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>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 + 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 + 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> + <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> @@ -242,24 +242,24 @@ 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>Texte optionnel à afficher à la place d'un icône pour un +<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#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>La directive <code class="directive">AddAltByEncoding</code> permet - d'afficher un texte optionnel à la place d'un icône pour un fichier + 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 + <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> + 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> @@ -268,24 +268,24 @@ fichier en fonction de son codage MIME</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="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>Texte optionnel à afficher à la place d'un icône pour un +<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#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>La directive <code class="directive">AddAltByType</code> permet - d'afficher un texte optionnel à la place d'un icône pour un fichier + 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 + <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> + 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 'Fichier texte' text/plain</pre> @@ -296,7 +296,7 @@ fichier en fonction de son type MIME</td></tr> <table class="directive"> <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#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> @@ -304,85 +304,85 @@ fichier en fonction de son type MIME</td></tr> <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 + 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>La taille par défaut, habituelle du champ de description est de + <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 + 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 + <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 + <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> + 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> + <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 + <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> + 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 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> + <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>Icône à afficher pour un fichier en fonction de son +<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>] +<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#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>Cette directive permet de déterminer l'icône à afficher à côté + <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 à + 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 + <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 + <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 @@ -391,32 +391,32 @@ AddIcon /icons/dir.png ^^DIRECTORY^^ AddIcon /icons/backup.png *~</pre> - <p>Lorsque c'est possible, il est préférable d'utiliser <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> plutôt que + <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>Icône à afficher à côté d'un fichier en fonction de son +<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> +<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#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>Cette directive permet de déterminer l'icône à afficher à côté + <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 à + <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 + <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> @@ -426,27 +426,27 @@ codage MIME</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="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>Icône à afficher à côté d'un fichier en fonction de son +<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> +<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#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>Cette directive permet de déterminer l'icône à afficher à côté + <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 à + <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> + <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> @@ -455,19 +455,19 @@ type MIME</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="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>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#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#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>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> + <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> @@ -476,17 +476,17 @@ n'est précisé</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="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>Nom du fichier qui sera inséré au début de la page +<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#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>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> + <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> @@ -494,42 +494,42 @@ contenant l'index</td></tr> <div class="note"> <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 + 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 + 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>nom fichier</var> doit correspondre à un document dont le + <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 à + 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>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 + <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 + <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>Si le fichier spécifié par la directive - <code class="directive">HeaderName</code> contient les en-têtes d'un + <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> + 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> @@ -539,17 +539,17 @@ contenant l'index</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="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>Insère du texte dans la section HEAD de la page +<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#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>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 + 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> @@ -558,22 +558,22 @@ d'index.</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="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>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#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#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>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 + 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 + 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> @@ -589,18 +589,18 @@ de l'index d'un répertoire</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="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>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#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#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>Versions 2.3.10 et supérieures</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>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 + 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"> @@ -612,8 +612,8 @@ contenu d'un répertoire</td></tr> </Directory></pre> - <div class="warning"><p>Revoyez la configuration par défaut pour une - liste de modèles que vous voulez ignorer explicitement après usage + <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> @@ -621,44 +621,44 @@ contenu d'un répertoire</td></tr> <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>Diverses options de configuration pour l'indexation d'un -répertoire</td></tr> +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>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#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>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 + 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>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 + <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>, + 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>. + défini par une des différentes directives <code>AddAlt*</code>. </dd> - <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> + <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 + <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 + 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> @@ -667,251 +667,251 @@ répertoire</td></tr> <dt><a name="indexoptions.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a></dt> - <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de - spécifier la taille en caractères de la colonne description.</dd> + <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de + spécifier la taille en caractères de la colonne description.</dd> <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 + 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> fixe la taille de - la colonne à <var>n</var> octets.</dd> + la colonne à <var>n</var> octets.</dd> <dd><code>DescriptionWidth=*</code> ajuste la taille de la colonne - à la plus longue chaîne de description. + à la plus longue chaîne de description. <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> + inhérants à la troncature des descriptions.</strong></dd> <dt><a name="indexoptions.fancyindexing" id="indexoptions.fancyindexing">FancyIndexing</a></dt> - <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> + <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>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 + <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 + 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> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.htmltable" id="indexoptions.htmltable">HTMLTable</a></dt> <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> + 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>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> + <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>Si cette option est présente, en combinaison avec + <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. + <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> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.iconwidth" id="indexoptions.iconwidth">IconWidth[=<var>pixels</var>]</a></dt> - <dd>Si cette option est présente, en combinaison avec + <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> + <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>Si cette option est activée, les noms sont triés sans tenir + <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). + 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>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 + <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>Le mot-clé <code>NameWidth</code> vous permet de spécifier la + <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>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> + 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> fixe la largeur de la - colonne à <var>n</var> octets.</dd> + colonne à <var>n</var> octets.</dd> - <dd><code>NameWidth=*</code> définit la largeur de colonne à la - valeur nécessaire.</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>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 + 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> + processus est coûteux en ressources disque et CPU.</dd> <dt><a name="indexoptions.showforbidden" id="indexoptions.showforbidden">ShowForbidden</a></dt> - <dd>Si cette option est activée, Apache httpd affichera les fichiers - normalement cachés suite au retour des valeurs + <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> + la sous-requête.</dd> <dt><a name="indexoptions.suppresscolumnsorting" id="indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></dt> - <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 + <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>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 + 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> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.suppresshtmlpreamble" id="indexoptions.suppresshtmlpreamble">SuppressHTMLPreamble</a></dt> - <dd>Si le répertoire contient effectivement le fichier spécifié + <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 + 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 + 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 + 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>L'activation de cette option supprime l'affichage des icônes - dans le cas d'un affichage "amélioré". La combinaison de + <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> + 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>L'activation de cette option supprime l'affichage de la date - de dernière modification dans le cas d'un affichage "amélioré". + de dernière modification dans le cas d'un affichage "amélioré". <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> - est aussi activé.</strong> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.suppressrules" id="indexoptions.suppressrules">SuppressRules</a> </dt> <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 + 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"). + 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> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.suppresssize" id="indexoptions.suppresssize">SuppressSize</a></dt> <dd>L'activation de cette option supprime l'affichage de la taille - du fichier dans le cas d'un affichage "amélioré". + du fichier dans le cas d'un affichage "amélioré". <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> - est aussi activé.</strong> + est aussi activé.</strong> </dd> <dt><a name="indexoptions.trackmodified" id="indexoptions.trackmodified">TrackModified</a></dt> <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 + <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 + 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> + 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> + 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 + <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> @@ -920,13 +920,13 @@ répertoire</td></tr> <dt><a name="indexoptions.versionsort" id="indexoptions.versionsort">VersionSort</a> - (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt> + (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt> - <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. + <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>Exemple :</h3><p><code> foo-1.7<br /> @@ -937,7 +937,7 @@ répertoire</td></tr> foo-1.12 </code></p></div> - <p>Si le nombre commence par le chiffre 0, il est considéré comme + <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> @@ -949,27 +949,27 @@ répertoire</td></tr> </dd> <dt><a name="indexoptions.xhtml" id="indexoptions.xhtml">XHTML</a> - (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt> + (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt> - <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 + <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> + est aussi activé.</strong> </dd> </dl> - <dl><dt>Options d'index incrémentales</dt> + <dl><dt>Options d'index incrémentales</dt> <dd> - <p>Vous devez porter une attention particulière à la manière dont - les <code class="directive">IndexOptions</code> multiples sont traitées.</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>Plusieurs directives <code class="directive">IndexOptions</code> - apparaissant dans la même section directory sont maintenant - fusionnées. Le résultat de : + apparaissant dans la même section directory sont maintenant + fusionnées. Le résultat de : <pre class="prettyprint lang-config"><Directory "/foo"> IndexOptions HTMLTable @@ -977,39 +977,39 @@ répertoire</td></tr> </Directory></pre> - <p>est équivalent à</p> + <p>est équivalent à </p> <pre class="prettyprint lang-config">IndexOptions HTMLTable SuppressColumnsorting</pre> </li> - <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés + <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés avec <code>+</code> ou <code>-</code>).</li> </ul> - <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 + <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<br /> IndexOptions +SuppressSize</pre> - <p>L'effet global est équivalent à l'effet qu'aurait provoqué + <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>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> + 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>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> @@ -1017,19 +1017,19 @@ IndexOptions +SuppressSize</pre> <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>Définit l'ordre d'affichage par défaut d'un index de -répertoire</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#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</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#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>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 + 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> @@ -1039,31 +1039,31 @@ Name|Date|Size|Description</code></td></tr> <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 + 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 + <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 + 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> + 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>Ajoute une feuille de style CSS à l'index du -répertoire</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#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>La directive <code class="directive">IndexStyleSheet</code> permet de - définir le nom du fichier qui servira de feuille de style CSS pour + 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> @@ -1071,18 +1071,18 @@ répertoire</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> + 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> + <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> + 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> + 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 @@ -1097,21 +1097,21 @@ répertoire</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="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>Nom du fichier dont le contenu sera inséré à la fin de +<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#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>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 + <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>. + 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 @@ -1122,17 +1122,17 @@ ReadmeName FOOTER.html</pre> ReadmeName /include/FOOTER.html</pre> - <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> + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> | <a href="../ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -1151,7 +1151,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_autoindex. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_buffer.html b/docs/manual/mod/mod_buffer.html index 8f90c41661..a3d14c4831 100644 --- a/docs/manual/mod/mod_buffer.html +++ b/docs/manual/mod/mod_buffer.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_buffer.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_buffer.html.fr b/docs/manual/mod/mod_buffer.html.fr index 9d7316a5b8..0711a19d73 100644 --- a/docs/manual/mod/mod_buffer.html.fr +++ b/docs/manual/mod/mod_buffer.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,38 +27,38 @@ <div id="preamble"><h1>Module Apache mod_buffer</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_buffer.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Support de la mise en tampon des requêtes</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Support de la mise en tampon des requêtes</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>buffer_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_buffer.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>buffer_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_buffer.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures d'Apache</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit la possibilité de mettre en tampon les piles - des filtres en entrée et sortie.</p> + <p>Ce module fournit la possibilité de mettre en tampon les piles + des filtres en entrée et sortie.</p> - <p>Dans certaines situations, les générateurs de contenu créent des - contenus composés de petits tronçons. Afin de permettre la - réutilisation de la mémoire, les éléments de mémoire attribués aux - tronçons ont toujours une taille de 8k, quelle que soit la taille du - tronçon lui-même. Lorsqu'une requête génère de nombreux petits - tronçons, une grande quantité de mémoire peut être mobilisée par le - traitement de la requête, et une grande quantité de données - transmises sans nécessité. Pour y remédier, l'utilisation d'un - tampon rassemble la réponse en un nombre de tronçons le plus petit + <p>Dans certaines situations, les générateurs de contenu créent des + contenus composés de petits tronçons. Afin de permettre la + réutilisation de la mémoire, les éléments de mémoire attribués aux + tronçons ont toujours une taille de 8k, quelle que soit la taille du + tronçon lui-même. Lorsqu'une requête génère de nombreux petits + tronçons, une grande quantité de mémoire peut être mobilisée par le + traitement de la requête, et une grande quantité de données + transmises sans nécessité. Pour y remédier, l'utilisation d'un + tampon rassemble la réponse en un nombre de tronçons le plus petit possible.</p> - <p>Lorsque httpd est utilisé comme frontal d'un générateur de + <p>Lorsque httpd est utilisé comme frontal d'un générateur de contenu consommant beaucoup de ressources, la mise en tampon de la - réponse peut permettre à ce dernier d'effectuer le traitement et de - libérer les ressources plus ou moins rapidement, en fonction de la - manière dont il a été conçu.</p> + réponse peut permettre à ce dernier d'effectuer le traitement et de + libérer les ressources plus ou moins rapidement, en fonction de la + manière dont il a été conçu.</p> - <p>Le filtre de mise en tampon peut être ajouté aux piles des - filtres en entrée ou en sortie, selon les besoins, à l'aide des + <p>Le filtre de mise en tampon peut être ajouté aux piles des + filtres en entrée ou en sortie, selon les besoins, à l'aide des directives <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>, <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> ou <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>.</p> @@ -66,13 +66,13 @@ d'Apache</td></tr></table> </div> <div class="warning">Les filtres de mise en tampon lisent la - requête/réponse en RAM, puis la reconditionnent sous la forme d'un - nombre d'éléments mémoire le plus petit possible, au prix d'une - consommation de temps CPU. Lorsque la requête/réponse est déjà - conditionnée de manière satisfaisante, sa mise en tampon pourrait - s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. - C'est pourquoi ces filtres doivent être utilisés avec précautions, - et seulement si nécessaire.</div> + requête/réponse en RAM, puis la reconditionnent sous la forme d'un + nombre d'éléments mémoire le plus petit possible, au prix d'une + consommation de temps CPU. Lorsque la requête/réponse est déjà + conditionnée de manière satisfaisante, sa mise en tampon pourrait + s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. + C'est pourquoi ces filtres doivent être utilisés avec précautions, + et seulement si nécessaire.</div> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -89,21 +89,21 @@ d'Apache</td></tr></table> <table class="directive"> <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#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>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 + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_buffer.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -122,7 +122,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_buffer.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cache.html b/docs/manual/mod/mod_cache.html index 7e5b0535f2..81f79769b5 100644 --- a/docs/manual/mod/mod_cache.html +++ b/docs/manual/mod/mod_cache.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cache.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_cache.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_cache.html.fr b/docs/manual/mod/mod_cache.html.fr index 050fe81981..8ce2779c67 100644 --- a/docs/manual/mod/mod_cache.html.fr +++ b/docs/manual/mod/mod_cache.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,87 +27,87 @@ <div id="preamble"><h1>Module Apache mod_cache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cache.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filtre de mise en cache HTTP conforme à la RFC 2616</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filtre de mise en cache HTTP conforme à la RFC 2616</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache.c</td></tr></table> <h3>Sommaire</h3> - <div class="warning">Ce module doit être utilisé avec précautions - car lorsque la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> est définie à sa - valeur par défaut <strong>on</strong>, les directives <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> and <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> sont court-circuitées. Vous + <div class="warning">Ce module doit être utilisé avec précautions + car lorsque la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> est définie à sa + valeur par défaut <strong>on</strong>, les directives <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> and <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> sont court-circuitées. Vous ne devez donc pas activer la gestion rapide de la mise en cache pour - un contenu auquel vous souhaitez limiter l'accès en fonction du nom - d'hôte du client, de l'adresse IP ou d'une variable + un contenu auquel vous souhaitez limiter l'accès en fonction du nom + d'hôte du client, de l'adresse IP ou d'une variable d'environnement.</div> - <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> implémente un <strong>filtre de mise - en cache de contenu HTTP</strong> conforme à la <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec - support de la mise en cache des réponses dont le contenu a été - négocié et comportant l'en-tête Vary.</p> + <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> implémente un <strong>filtre de mise + en cache de contenu HTTP</strong> conforme à la <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec + support de la mise en cache des réponses dont le contenu a été + négocié et comportant l'en-tête Vary.</p> - <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme - permettant de vérifier si un contenu expiré ou dépassé est encore à + <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme + permettant de vérifier si un contenu expiré ou dépassé est encore à jour, et peut apporter un gain de performances significatif si le - serveur original supporte les <strong>requêtes - conditionnelles</strong> en prenant en compte l'en-tête de requête + serveur original supporte les <strong>requêtes + conditionnelles</strong> en prenant en compte l'en-tête de requête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">If-None-Match</a>. - Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non - lorsqu'il a expiré.</p> + Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non + lorsqu'il a expiré.</p> - <p>En tant que filtre, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être placé + <p>En tant que filtre, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être placé en face d'un contenu issu de tout gestionnaire, y compris - <strong>des fichiers à accès séquentiel</strong> (servis depuis un + <strong>des fichiers à accès séquentiel</strong> (servis depuis un disque lent mis en cache sur un gros disque), la sortie d'un <strong>script - CGI</strong> ou d'un <strong>générateur de contenu - dynamique</strong>, ou du contenu <strong>mandaté depuis un autre + CGI</strong> ou d'un <strong>générateur de contenu + dynamique</strong>, ou du contenu <strong>mandaté depuis un autre serveur</strong>.</p> - <p>Dans la configuration par défaut, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> + <p>Dans la configuration par défaut, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> place le filtre de mise en cache aussi loin que possible dans la pile de filtres, utilisant le <strong>gestionnaire rapide</strong> - pour court-circuiter tout traitement par requête lors de l'envoi du - contenu au client. Dans ce mode opératoire, - <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être considéré comme un serveur - mandataire avec cache fixé en tête du serveur web, alors qu'il - s'exécute dans ce même serveur web.</p> + pour court-circuiter tout traitement par requête lors de l'envoi du + contenu au client. Dans ce mode opératoire, + <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être considéré comme un serveur + mandataire avec cache fixé en tête du serveur web, alors qu'il + s'exécute dans ce même serveur web.</p> - <p>Lorsque le gestionnaire rapide est désactivé via la directive + <p>Lorsque le gestionnaire rapide est désactivé via la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code>, il - devient possible d'insérer le filtre <strong>CACHE</strong> à un + devient possible d'insérer le filtre <strong>CACHE</strong> à un point de la pile de filtres choisi par l'administrateur. Ceci permet de mettre en cache un contenu avant que celui-ci ne soit - personnalisé par le filtre <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, ou - éventuellement compressé par le filtre <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p> + personnalisé par le filtre <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, ou + éventuellement compressé par le filtre <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p> <p>Dans le mode de fonctionnement normal, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> - peut être contrôlé par les en-têtes <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">Cache-Control</a> + peut être contrôlé par les en-têtes <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">Cache-Control</a> et <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.32">Pragma</a> - envoyés par un client dans une requête, ou par un serveur dans une - réponse. Dans des circonstances exceptionnelles, - <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut cependant être configuré pour - outrepasser ces en-têtes et forcer un comportement spécifique au - site, bien qu'un tel comportement sera limité à ce cache seulement, - et n'affectera pas les opérations des autres caches qui peuvent - s'insérer entre le client et le serveur, et ce type de configuration - ne doit donc être utiliser qu'en cas de nécessité absolue.</p> - - <p>La RFC 2616 permet au cache de renvoyer des données périmées - pendant que l'entrée périmée correspondante est mise à jour depuis + envoyés par un client dans une requête, ou par un serveur dans une + réponse. Dans des circonstances exceptionnelles, + <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut cependant être configuré pour + outrepasser ces en-têtes et forcer un comportement spécifique au + site, bien qu'un tel comportement sera limité à ce cache seulement, + et n'affectera pas les opérations des autres caches qui peuvent + s'insérer entre le client et le serveur, et ce type de configuration + ne doit donc être utiliser qu'en cas de nécessité absolue.</p> + + <p>La RFC 2616 permet au cache de renvoyer des données périmées + pendant que l'entrée périmée correspondante est mise à jour depuis le serveur original, et <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> supporte cette - fonctionnalité lorsque la directive <code class="directive"><a href="#cachelock">CacheLock</a></code> est configurée en - conséquence. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> - contenant un code de réponse 110. La RFC 2616 permet aussi au cache - de renvoyer des données périmées lorsque la tentative de mise à jour - des données périmées renvoie une erreur 500 ou supérieure, et cette - fonctionnalité est supportée par défaut par - <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> - contenant un code de réponse 111.</p> + fonctionnalité lorsque la directive <code class="directive"><a href="#cachelock">CacheLock</a></code> est configurée en + conséquence. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> + contenant un code de réponse 110. La RFC 2616 permet aussi au cache + de renvoyer des données périmées lorsque la tentative de mise à jour + des données périmées renvoie une erreur 500 ou supérieure, et cette + fonctionnalité est supportée par défaut par + <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> + contenant un code de réponse 111.</p> <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> requiert les services d'un ou plusieurs modules de gestion de stockage. La distribution Apache de base @@ -115,33 +115,33 @@ <dl> <dt><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></dt> - <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes - et corps sont stockés séparément sur le disque dans une structure de - répertoires basée sur le condensé md5 de l'URL mise en cache. - Plusieurs réponses à contenu négocié peuvent être stockées en même + <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes + et corps sont stockés séparément sur le disque dans une structure de + répertoires basée sur le condensé md5 de l'URL mise en cache. + Plusieurs réponses à contenu négocié peuvent être stockées en même temps, mais la mise en cache de contenus partiels n'est pas - supportée par ce module. L'utilitaire + supportée par ce module. L'utilitaire <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et de supprimer les - URLs mises en cache, et de maintenir le cache en deçà de + URLs mises en cache, et de maintenir le cache en deçà de certaines limites de taille et de nombre d'inodes.</dd> <dt><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></dt> - <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets - partagés. Les en-têtes et corps sont stockés ensemble sous une seule - clé basée sur l'URL de la réponse mise en cache. Des réponses à - contenus multiples négociés peuvent être stockées simultanément, mais + <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets + partagés. Les en-têtes et corps sont stockés ensemble sous une seule + clé basée sur l'URL de la réponse mise en cache. Des réponses à + contenus multiples négociés peuvent être stockées simultanément, mais ce module ne supporte pas la mise en cache de contenus partiels.</dd> </dl> - <p>Pour de plus amples détails, une description, et des exemples, + <p>Pour de plus amples détails, une description, et des exemples, reportez-vous au <a href="../caching.html">Guide de la mise en cache</a>.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#related">Modules apparentés et directives</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#related">Modules apparentés et directives</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#sampleconf">Exemple de configuration</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#thunderingherd">Eviter une tempête de requête</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#finecontrol">Contrôle fin via le filtre CACHE</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#thunderingherd">Eviter une tempête de requête</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#finecontrol">Contrôle fin via le filtre CACHE</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#status">Etat du cache et journalisation</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -175,8 +175,8 @@ cache</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="related" id="related">Modules apparentés et directives</a></h2> - <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheminfilesize">CacheMinFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachemaxfilesize">CacheMaxFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxtime">CacheSocacheMaxTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemintime">CacheSocacheMinTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxsize">CacheSocacheMaxSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadsize">CacheSocacheReadSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadtime">CacheSocacheReadTime</a></code></li></ul></td></tr></table> +<h2><a name="related" id="related">Modules apparentés et directives</a></h2> + <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheminfilesize">CacheMinFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachemaxfilesize">CacheMaxFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxtime">CacheSocacheMaxTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemintime">CacheSocacheMinTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxsize">CacheSocacheMaxSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadsize">CacheSocacheReadSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadtime">CacheSocacheReadTime</a></code></li></ul></td></tr></table> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="sampleconf" id="sampleconf">Exemple de configuration</a></h2> @@ -194,69 +194,69 @@ LoadModule cache_module modules/mod_cache.so </IfModule> # Lorsqu'on sert de mandataire, on ne met pas en cache la liste -# des mises à jour de sécurité +# des mises à jour de sécurité CacheDisable http://security.update.server/update-list/ </IfModule></pre> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="thunderingherd" id="thunderingherd">Eviter une tempête de requête</a></h2> - <p>Lorsqu'une entrée du cache est périmée, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> - soumet une requête conditionnelle au processus d'arrière-plan, qui est - censé confirmer la validité de l'entrée du cache, ou dans la négative - envoyer une entrée mise à jour.</p> - <p>Un court mais non négligeable laps de temps existe entre le moment - où l'entrée du cache est périmée, et le moment où elle est mise à - jour. Sur un serveur fortement chargé, un certain nombre de requêtes +<h2><a name="thunderingherd" id="thunderingherd">Eviter une tempête de requête</a></h2> + <p>Lorsqu'une entrée du cache est périmée, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> + soumet une requête conditionnelle au processus d'arrière-plan, qui est + censé confirmer la validité de l'entrée du cache, ou dans la négative + envoyer une entrée mise à jour.</p> + <p>Un court mais non négligeable laps de temps existe entre le moment + où l'entrée du cache est périmée, et le moment où elle est mise à + jour. Sur un serveur fortement chargé, un certain nombre de requêtes peut arriver pendant ce laps de temps, et provoquer une - <strong>tempête</strong> de requêtes susceptibles de saturer le - processus d'arrière-plan de manière soudaine et imprédictible.</p> - <p>Pour contenir cette tempête, on peut utiliser la directive - <code class="directive">CacheLock</code> afin de définir un répertoire où - seront créés <strong>à la volée</strong> des verrous pour les URLs. - Ces verrous sont utilisés comme autant d'<strong>indications</strong> - par les autres requêtes, soit pour empêcher une tentative de mise en - cache (un autre processus est en train de récupérer l'entité), soit - pour indiquer qu'une entrée périmée est en cours de mise à jour - (pendant ce temps, c'est le contenu périmé qui sera renvoyé). + <strong>tempête</strong> de requêtes susceptibles de saturer le + processus d'arrière-plan de manière soudaine et imprédictible.</p> + <p>Pour contenir cette tempête, on peut utiliser la directive + <code class="directive">CacheLock</code> afin de définir un répertoire où + seront créés <strong>à la volée</strong> des verrous pour les URLs. + Ces verrous sont utilisés comme autant d'<strong>indications</strong> + par les autres requêtes, soit pour empêcher une tentative de mise en + cache (un autre processus est en train de récupérer l'entité), soit + pour indiquer qu'une entrée périmée est en cours de mise à jour + (pendant ce temps, c'est le contenu périmé qui sera renvoyé). </p> - <h3>Mise en cache initiale d'une entrée</h3> + <h3>Mise en cache initiale d'une entrée</h3> - <p>Lorsqu'une entité est mise en cache pour la première fois, un - verrou est créé pour cette entité jusqu'à ce que la réponse ait été - entièrement mise en cache. Pendant la durée de vie du verrou, le - cache va empêcher une seconde tentative de mise en cache de la même - entité. Bien que cela ne suffise pas à contenir la tempête de - requêtes, toute tentative de mettre en cache la même entité - plusieurs fois simultanément est stoppée. + <p>Lorsqu'une entité est mise en cache pour la première fois, un + verrou est créé pour cette entité jusqu'à ce que la réponse ait été + entièrement mise en cache. Pendant la durée de vie du verrou, le + cache va empêcher une seconde tentative de mise en cache de la même + entité. Bien que cela ne suffise pas à contenir la tempête de + requêtes, toute tentative de mettre en cache la même entité + plusieurs fois simultanément est stoppée. </p> - <h3>Mise à jour d'une entrée périmée</h3> + <h3>Mise à jour d'une entrée périmée</h3> - <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et - devient par conséquent périmée, un verrou est créé pour cette entité - jusqu'à ce que la réponse ait été soit confirmée comme encore - valide, soit remplacée par le processus d'arrière-plan. Pendant la - durée de vie du verrou, une seconde requête entrante va provoquer le - renvoi de la donnée périmée, et la tempête de requêtes sera + <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et + devient par conséquent périmée, un verrou est créé pour cette entité + jusqu'à ce que la réponse ait été soit confirmée comme encore + valide, soit remplacée par le processus d'arrière-plan. Pendant la + durée de vie du verrou, une seconde requête entrante va provoquer le + renvoi de la donnée périmée, et la tempête de requêtes sera contenue.</p> - <h3>Verrous et en-tête Cache-Control: no-cache</h3> + <h3>Verrous et en-tête Cache-Control: no-cache</h3> - <p>Les verrous ne sont utilisés <strong>qu'à titre - indicatif</strong> pour enjoindre le cache à être plus coopératif - avec les serveurs d'arrière-plan, et il est possible de passer outre - si nécessaire. Si le client envoie une requête contenant un en-tête - Cache-Control imposant un nouveau téléchargement de l'entité, tout - verrou éventuel sera ignoré, la requête du client sera honorée - immédiatement, et l'entrée du cache mise à jour.</p> - - <p>Comme mécanisme de sécurité supplémentaire, la durée de vie + <p>Les verrous ne sont utilisés <strong>qu'à titre + indicatif</strong> pour enjoindre le cache à être plus coopératif + avec les serveurs d'arrière-plan, et il est possible de passer outre + si nécessaire. Si le client envoie une requête contenant un en-tête + Cache-Control imposant un nouveau téléchargement de l'entité, tout + verrou éventuel sera ignoré, la requête du client sera honorée + immédiatement, et l'entrée du cache mise à jour.</p> + + <p>Comme mécanisme de sécurité supplémentaire, la durée de vie maximale des verrous est configurable. Lorsque cette limite est - atteinte, le verrou est supprimé et une autre requête peut alors en - créer un nouveau. Cette durée de vie peut être définie via la + atteinte, le verrou est supprimé et une autre requête peut alors en + créer un nouveau. Cette durée de vie peut être définie via la directive <code class="directive">CacheLockMaxAge</code>, et sa valeur par - défaut est de 5 secondes. + défaut est de 5 secondes. </p> <h3>Exemple de configuration</h3> @@ -273,37 +273,37 @@ LoadModule cache_module modules/mod_cache.so </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="finecontrol" id="finecontrol">Contrôle fin via le filtre CACHE</a></h2> - <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous - la forme d'un gestionnaire rapide, court-circuitant la majorité des +<h2><a name="finecontrol" id="finecontrol">Contrôle fin via le filtre CACHE</a></h2> + <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous + la forme d'un gestionnaire rapide, court-circuitant la majorité des traitements du serveur et fournissant ainsi une mise en cache - possédant les plus hautes performances disponibles.</p> + possédant les plus hautes performances disponibles.</p> <p>Dans ce mode, le cache <strong>s'incruste</strong> devant le - serveur, comme si un mandataire de mise en cache indépendant RFC 2616 - était placé devant ce dernier.</p> + serveur, comme si un mandataire de mise en cache indépendant RFC 2616 + était placé devant ce dernier.</p> <p>Bien que que ce mode offre les meilleures performances, les administrateurs peuvent souhaiter, dans certaines circonstances, - effectuer des traitements sur la requête après que cette dernière ait - été mise en cache, comme ajouter du contenu personnalisé à la page + effectuer des traitements sur la requête après que cette dernière ait + été mise en cache, comme ajouter du contenu personnalisé à la page mise en cache, ou appliquer des restrictions d'autorisations au - contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de - placer des serveurs mandataires inverses indépendants soit derrière, + contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de + placer des serveurs mandataires inverses indépendants soit derrière, soit devant le serveur de mise en cache.</p> - <p>Pour résoudre ce problème, la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> peut être définie à + <p>Pour résoudre ce problème, la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> peut être définie à <strong>off</strong>, afin que le serveur traite toutes les phases - normalement exécutées par une requête non mise en cache, y compris les + normalement exécutées par une requête non mise en cache, y compris les phases <strong>d'authentification et d'autorisation</strong>.</p> - <p>En outre, l'administrateur peut éventuellement spécifier le - <strong>point précis dans la chaîne de filtrage</strong> où devra + <p>En outre, l'administrateur peut éventuellement spécifier le + <strong>point précis dans la chaîne de filtrage</strong> où devra intervenir la mise en cache en ajoutant le filtre - <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p> + <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p> <p>Par exemple, pour mettre en cache le contenu avant d'appliquer une - compression à la réponse, placez le filtre <strong>CACHE</strong> + compression à la réponse, placez le filtre <strong>CACHE</strong> avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant :</p> @@ -312,12 +312,12 @@ CacheQuickHandler off AddOutputFilterByType CACHE;DEFLATE text/plain</pre> - <p>Une autre possibilité consiste à mettre en cache le contenu avant - l'ajout de contenu personnalisé via <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> (ou + <p>Une autre possibilité consiste à mettre en cache le contenu avant + l'ajout de contenu personnalisé via <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> (ou tout autre filtre de traitement de contenu). Dans l'exemple suivant, - les modèles contenant des balises comprises par - <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont mis en cache avant d'être - interprétés :</p> + les modèles contenant des balises comprises par + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont mis en cache avant d'être + interprétés :</p> <pre class="prettyprint lang-config"># Mise en cache du contenu avant l'intervention de mod_include et # mod_deflate @@ -325,10 +325,10 @@ CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre> - <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point - de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis - en cache après avoir été interprété par <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, - mais avant d'être traité par <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> :</p> + <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point + de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis + en cache après avoir été interprété par <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, + mais avant d'être traité par <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> :</p> <pre class="prettyprint lang-config"># Mise en cache du contenu entre les interventions de mod_include et # mod_deflate @@ -338,39 +338,39 @@ AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html</pre> <div class="warning"><h3>Avertissement :</h3>Si pour une raison ou pour une autre, le point d'insertion du filtre - <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous - devez <strong>vider votre cache</strong> pour être sûr que les données - servies soient à jour. En effet, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> n'est pas - en mesure d'effectuer cette opération à votre place.</div> + <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous + devez <strong>vider votre cache</strong> pour être sûr que les données + servies soient à jour. En effet, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> n'est pas + en mesure d'effectuer cette opération à votre place.</div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="status" id="status">Etat du cache et journalisation</a></h2> - <p>Lorsque <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> a décidé s'il devait ou non - servir une entité depuis le cache, les raisons précises de cette - décision sont enregistrées dans l'environnement du sous-processus - interne à la requête sous la clé <strong>cache-status</strong>. - Cette information peut être journalisée via la directive <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> comme suit :</p> + <p>Lorsque <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> a décidé s'il devait ou non + servir une entité depuis le cache, les raisons précises de cette + décision sont enregistrées dans l'environnement du sous-processus + interne à la requête sous la clé <strong>cache-status</strong>. + Cette information peut être journalisée via la directive <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> comme suit :</p> <pre class="prettyprint lang-config">LogFormat "%{cache-status}e ..."</pre> - <p>En fonction de la décision prise, l'information est aussi écrite - dans l'environnement du sous-processus sous une des quatre clés + <p>En fonction de la décision prise, l'information est aussi écrite + dans l'environnement du sous-processus sous une des quatre clés suivantes :</p> <dl> - <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd> - <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été - mis à jour avec succès, puis servi depuis le cache.</dd> - <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été - servi directement depuis le serveur demandé.</dd> - <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide - suite à une requête d'un type autre que GET ou HEAD.</dd> + <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd> + <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été + mis à jour avec succès, puis servi depuis le cache.</dd> + <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été + servi directement depuis le serveur demandé.</dd> + <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide + suite à une requête d'un type autre que GET ou HEAD.</dd> </dl> <p>Il est alors possible d'envisager une journalisation conditionnelle - du traitement des requêtes par rapport au cache comme dans l'exemple + du traitement des requêtes par rapport au cache comme dans l'exemple suivant :</p> <pre class="prettyprint lang-config">CustomLog "cached-requests.log" common env=cache-hit @@ -379,30 +379,30 @@ CustomLog "revalidated-requests.log" common env=cache-revalidate CustomLog "invalidated-requests.log" common env=cache-invalidate</pre> - <p>Pour les concepteurs de modules, une accroche (hook) nommée + <p>Pour les concepteurs de modules, une accroche (hook) nommée <var>cache_status</var> est disponible et permet aux modules de - répondre aux résultats de la vérification du cache ci-dessus de manière - personnalisée.</p> + répondre aux résultats de la vérification du cache ci-dessus de manière + personnalisé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="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>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#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#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>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> + 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> @@ -411,32 +411,32 @@ lorsqu'aucune date d'expiration n'a été spécifiée.</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="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>Ajoute un en-tête X-Cache-Detail à la réponse.</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#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>Disponible depuis la version 2.3.9 d'Apache</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>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 + <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> + 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 + <pre class="prettyprint lang-config"># Active l'en-tête X-Cache-Detail CacheDetailHeader on</pre> @@ -449,24 +449,24 @@ 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>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#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>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> + spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux + inférieurs.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">CacheDisable /fichiers_locaux</pre> </div> - <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 + <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>Exemple</h3><pre class="prettyprint lang-config"><Location "/foo"> @@ -474,9 +474,9 @@ spécifiées</td></tr> </Location></pre> </div> - <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> + <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> @@ -487,47 +487,47 @@ Apache</a></li> <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>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 +<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#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>Une chaîne URL telle que '/' s'appliquait à tout contenu -en mandat direct dans les versions 2.2 et antérieures.</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>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 + <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 + <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> + 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 + 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 + 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 + <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 + 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 + 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> + <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 @@ -541,32 +541,32 @@ CacheQuickHandler off CacheEnable disk </LocationMatch> -# Mise en cache de tous les contenus, à l'exception des URLs -# mandatées en direct (gestionnaire normal ou rapide) +# Mise en cache de tous les contenus, à l'exception des URLs +# mandatées en direct (gestionnaire normal ou rapide) CacheEnable disk / -# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide) +# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide) CacheEnable disk ftp:// -# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide) +# 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>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> + <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"># Correspond à www.example.org et fooexample.org + <pre class="prettyprint lang-config"># Correspond à www.example.org et fooexample.org CacheEnable disk http://*example.org/ -# Correspond à www.example.org, mais pas à fooexample.org +# Correspond à www.example.org, mais pas à fooexample.org CacheEnable disk http://.example.org/</pre> - <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> + <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> @@ -578,35 +578,35 @@ Apache</a></li> <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>Ajoute un en-tête X-Cache à la réponse.</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#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>Disponible depuis la version 2.3.9 d'Apache</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>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 + <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 + 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> + ignorée.</p> <dl> - <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été + <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> + <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"># Active l'en-tête X-Cache + <pre class="prettyprint lang-config"># Active l'en-tête X-Cache CacheHeader on</pre> @@ -619,21 +619,21 @@ CacheHeader 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="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 les en-têtes de requête enjoignant de ne pas servir +<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#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>Normalement, les requêtes contenant des en-têtes tels que + <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 + cache, même si la requête contient un en-tête no-cache.</p> <pre class="prettyprint lang-config">CacheIgnoreCacheControl On</pre> @@ -641,8 +641,8 @@ le contenu au client depuis le cache</td></tr> <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é. + 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> @@ -654,18 +654,18 @@ le contenu au client depuis le cache</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="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>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le 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>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#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>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 + <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> @@ -680,16 +680,16 @@ le contenu au client depuis le cache</td></tr> </ul> <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 + 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 + 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 class="directive">CacheIgnoreHeaders</code> peut être définie à <code>None</code>.</p> <div class="example"><h3>Exemple 1</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders Set-Cookie</pre> @@ -699,35 +699,35 @@ le contenu au client depuis le cache</td></tr> </div> <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 + 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. + 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 le fait qu'une réponse ne possède pas d'en-tête Last +<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#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>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 + <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 + <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> @@ -738,25 +738,25 @@ Modified.</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="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 la chaîne de paramètres lors de la mise en +<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#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>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 + <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> + 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> @@ -766,12 +766,12 @@ cache</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="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 les identifiants de session définis encodés dans +<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>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#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> @@ -783,17 +783,17 @@ l'URL lors de la mise en cache <li><code>/une-application/image.gif;jsessionid=123456789</code></li> <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li> </ul> - <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 + <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 + 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> vide la liste - des identifiants ignorés. Autrement, chaque identifiant spécifié est - ajouté à la liste.</p> + des identifiants ignorés. Autrement, chaque identifiant spécifié est + ajouté à la liste.</p> <div class="example"><h3>Exemple 1</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers jsessionid</pre> </div> @@ -806,30 +806,30 @@ l'URL lors de la mise en cache <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>Remplace l'URL de base des clés du cache mandatées en +<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#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>Disponible depuis la version 2.3.9 d'Apache</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>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. + <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">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 + <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> @@ -837,32 +837,32 @@ CacheKeyBaseURL http://www.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="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>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#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#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>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 + <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 + <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 * + <code>délai-expiration = durée-depuis-date-dernière-modification * <var>facteur</var> - date-expiration = date-courante + délai-expiration</code> + 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 + 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 = + 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 + 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> @@ -873,19 +873,19 @@ fonction de la date de dernière modification.</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="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>Active la protection contre les tempêtes de requêtes.</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#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>La directive <code class="directive">CacheLock</code> active la protection - contre les tempêtes de requêtes pour l'espace d'adressage donné.</p> + contre les tempêtes de requêtes pour l'espace d'adressage donné.</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 + 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"># Active le verrouillage du cache @@ -893,7 +893,7 @@ CacheLock on</pre> <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 + URLs présentes dont le contenu est périmé ; ils consomment dont bien moins de ressources que le cache disque traditionnel.</p> @@ -901,37 +901,37 @@ CacheLock 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="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>Définit la durée de vie maximale d'un verrou de cache.</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#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>La directive <code class="directive">CacheLockMaxAge</code> permet de - spécifier la durée de vie maximale d'un verrou de cache.</p> + spécifier la durée de vie maximale d'un verrou de cache.</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> + <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>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#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>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 + 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> @@ -939,21 +939,21 @@ CacheLock 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="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>La durée maximale en secondes de mise en cache d'un +<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#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>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 + 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> + 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> @@ -963,19 +963,19 @@ document</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="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>La durée minimale en secondes de mise en cache d'un +<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#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>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 + 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 + que dans le cas où le document ne possède aucune date d'expiration valide.</p> <pre class="prettyprint lang-config">CacheMinExpire 3600</pre> @@ -985,39 +985,39 @@ document</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="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>Exécute le cache à partir d'un gestionnaire rapide.</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#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>Disponible à partir de la version 2.3.3 du serveur HTTP +<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>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>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 + <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> + <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> + <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 + <pre class="prettyprint lang-config"># Exécute le cache comme un gestionnaire normal CacheQuickHandler off</pre> - <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 + <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"># Mise en cache du contenu avant l'intervention de mod_include et @@ -1026,7 +1026,7 @@ CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre> - <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière + <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière instance qui sera prise en compte.</p> @@ -1034,24 +1034,24 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/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="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>Sert du contenu non à jour à la place de réponses 5xx.</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#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>Disponible depuis la version 2.3.9 d'Apache</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>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 + <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. + <pre class="prettyprint lang-config"># Sert des données non mises à jour en cas d'erreur. CacheStaleOnError on</pre> @@ -1060,22 +1060,22 @@ 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>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#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#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>Depuis la version 2.2.4, les réponses qui sont arrivées à - expiration ne sont pas stockées dans le cache. La directive + <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> + 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> @@ -1085,21 +1085,21 @@ considère comme arrivées à expiration</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="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>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#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#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>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 + <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> + <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> @@ -1107,13 +1107,13 @@ l'entête Cache-Control: a pour valeur no-store.</td></tr> <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 + 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. + été prévenus. </div> <h3>Voir aussi</h3> @@ -1125,21 +1125,21 @@ l'entête Cache-Control: a pour valeur no-store.</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="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>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#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#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>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 + <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> + <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> @@ -1147,10 +1147,10 @@ marquées comme privées</td></tr> <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é'. + 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> @@ -1162,7 +1162,7 @@ marquées comme privées</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cache.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -1183,7 +1183,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache.html } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cache_disk.html b/docs/manual/mod/mod_cache_disk.html index 650b6e301c..70efd6e643 100644 --- a/docs/manual/mod/mod_cache_disk.html +++ b/docs/manual/mod/mod_cache_disk.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cache_disk.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_cache_disk.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_cache_disk.html.fr b/docs/manual/mod/mod_cache_disk.html.fr index 69ca1d5b6a..b29548233a 100644 --- a/docs/manual/mod/mod_cache_disk.html.fr +++ b/docs/manual/mod/mod_cache_disk.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,54 +27,54 @@ <div id="preamble"><h1>Module Apache mod_cache_disk</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de stockage sur disque pour le filtre de mise en cache HTTP.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_disk_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_disk.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_disk_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_disk.c</td></tr></table> <h3>Sommaire</h3> - <p><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> implémente un gestionnaire de + <p><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> implémente un gestionnaire de stockage sur disque pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> - <p>Les en-têtes et corps des réponses mises en cache sont stockés - séparément sur le disque, dans une structure de répertoires basée - sur le condensé md5 de l'URL mise en cache.</p> + <p>Les en-têtes et corps des réponses mises en cache sont stockés + séparément sur le disque, dans une structure de répertoires basée + sur le condensé md5 de l'URL mise en cache.</p> - <p>Plusieurs réponses au contenu négocié peuvent être stockées en - même temps, mais la mise en cache de contenus partiels n'est pas - supportée actuellement par ce module.</p> + <p>Plusieurs réponses au contenu négocié peuvent être stockées en + même temps, mais la mise en cache de contenus partiels n'est pas + supportée actuellement par ce module.</p> - <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête - et de corps peuvent être effectuées sans verrouillage en - enregistrant les numéros d'inode et de périphérique du fichier de - corps dans le fichier d'en-tête. Ceci implique que les entrées du - cache déplacées manuellement dans le cache seront ignorées.</p> + <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête + et de corps peuvent être effectuées sans verrouillage en + enregistrant les numéros d'inode et de périphérique du fichier de + corps dans le fichier d'en-tête. Ceci implique que les entrées du + cache déplacées manuellement dans le cache seront ignorées.</p> <p>L'utilitaire <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et - de supprimer les URLs du cache, ou de maintenir le cache en deçà de + de supprimer les URLs du cache, ou de maintenir le cache en deçà de certaines limites de taille et/ou de nombre d'inodes. L'utilitaire - peut être exécuté à la demande, ou automatiquement pour assurer un - contrôle continu des tailles des répertoires.</p> + peut être exécuté à la demande, ou automatiquement pour assurer un + contrôle continu des tailles des répertoires.</p> <div class="note"><h3>Note :</h3> - <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé avant + <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé avant <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> pour que ce dernier puisse fonctionner.</p> </div> <div class="note"><h3>Note :</h3> - <p>Lorsque la plate-forme la supporte, et si elle est activée via la + <p>Lorsque la plate-forme la supporte, et si elle est activée via la directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code>, - <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> utilise la fonctionnalité sendfile - pour servir les fichiers à partir du cache. Cependant, + <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> utilise la fonctionnalité sendfile + pour servir les fichiers à partir du cache. Cependant, <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> ignore la configuration de la directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> dans - un contexte de répertoire ou de fichier .htaccess, car le module ne - dispose pas des définitions correspondantes lorsque la requête est + un contexte de répertoire ou de fichier .htaccess, car le module ne + dispose pas des définitions correspondantes lorsque la requête est servie depuis le cache.</p> </div> </div> @@ -98,30 +98,30 @@ cache HTTP.</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="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>Le nombre de caractères des noms des -sous-répertoires</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#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>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 + 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 + 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> + 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>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> + doit pas dépasser 20.</p> </div> @@ -129,28 +129,28 @@ sous-répertoires</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="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>Le nombre de niveaux de sous-répertoires que comportera le +<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>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#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>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> + 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 + 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>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> + doit pas dépasser 20.</p> </div> @@ -159,15 +159,15 @@ cache.</td></tr> <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>>La taille maximale (en octets) d'un document pour pouvoir -être stocké dans le cache</td></tr> +ê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#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>La directive <code class="directive">CacheMaxFileSize</code> permet de - définir la taille maximale d'un document, en octets, pour que + 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> @@ -178,15 +178,15 @@ cache.</td></tr> <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>La taille minimale (en octets) d'un document pour pouvoir -être stocké dans le cache</td></tr> +ê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#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>La directive <code class="directive">CacheMinFileSize</code> permet de - définir la taille minimale d'un document, en octets, pour que + 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> @@ -196,26 +196,26 @@ cache.</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="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>La quantité minimale (en octets) de données à lire et à +<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#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>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 + 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 à + <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> @@ -225,29 +225,29 @@ mettre en cache avant de les envoyer au client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>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#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#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>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 + 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>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 + <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> + où les données arriveraient plus vite que prévu.</p> <pre class="prettyprint lang-config">CacheReadTime 1000</pre> @@ -256,22 +256,22 @@ avant d'envoyer les données au client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>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#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>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 + <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> + définir la structure des sous-répertoires du répertoire racine + spécifié.</p> <pre class="prettyprint lang-config">CacheRoot c:/cacheroot</pre> @@ -280,7 +280,7 @@ seront stockés</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -301,7 +301,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_disk } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cache_socache.html b/docs/manual/mod/mod_cache_socache.html index 99cdd08a48..e44081890f 100644 --- a/docs/manual/mod/mod_cache_socache.html +++ b/docs/manual/mod/mod_cache_socache.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cache_socache.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_cache_socache.html.fr b/docs/manual/mod/mod_cache_socache.html.fr index bd73e5bc2a..a5700ca32d 100644 --- a/docs/manual/mod/mod_cache_socache.html.fr +++ b/docs/manual/mod/mod_cache_socache.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,27 +27,27 @@ <div id="preamble"><h1>Module Apache mod_cache_socache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_socache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache_socache.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_cache_socache.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de stockage à base de cache d'objets partagés +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de stockage à base de cache d'objets partagés (socache) pour le filtre de mise en cache HTTP.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_socache_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_socache.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_socache_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_socache.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> implémente un - gestionnaire de stockage à base de cache d'objets partagés (socache) + <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> implémente un + gestionnaire de stockage à base de cache d'objets partagés (socache) pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> - <p>Les en-têtes et corps des réponses mises en cache sont rassemblés - et stockés sous une même clé dans le cache d'objets partagés. Il est - possible de choisir entre plusieurs <a href="../socache.html">implémentations</a> de caches d'objets - partagés.</p> + <p>Les en-têtes et corps des réponses mises en cache sont rassemblés + et stockés sous une même clé dans le cache d'objets partagés. Il est + possible de choisir entre plusieurs <a href="../socache.html">implémentations</a> de caches d'objets + partagés.</p> - <p>Des réponses avec différents contenus négociés peuvent être - stockées simultanément ; cependant, la mise en cache de contenus - partiels n'est pas encore supportée par ce module.</p> + <p>Des réponses avec différents contenus négociés peuvent être + stockées simultanément ; cependant, la mise en cache de contenus + partiels n'est pas encore supportée par ce module.</p> <pre class="prettyprint lang-config"># Activation de la mise en cache CacheSocache shmcb @@ -56,7 +56,7 @@ CacheSocacheMaxSize 102400 CacheEnable socache </Location> -# Possibilité de se rabattre sur le cache disque +# Possibilité de se rabattre sur le cache disque CacheSocache shmcb CacheSocacheMaxSize 102400 <Location "/foo"> @@ -68,7 +68,7 @@ CacheSocacheMaxSize 102400 <div class="note"><h3>Note :</h3> <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> requiert les services du module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> qui doit donc avoir - été préalablement chargé.</p> + été préalablement chargé.</p> </div> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -90,19 +90,19 @@ CacheSocacheMaxSize 102400 <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>Implémentation du cache d'objets partagés à utiliser</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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>La directive <code class="directive">CacheSocache</code> - définit l'implémentation du cache d'objets partagés à utiliser, + 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> + 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> @@ -111,28 +111,28 @@ Apache</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="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>La taille maximale d'une entrée pouvant être placée dans le +<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>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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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> + 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>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 + 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 + 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> @@ -142,20 +142,20 @@ Apache</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="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>La durée maximale de stockage d'un document dans le cache -avant péremption</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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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> + 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> @@ -164,21 +164,21 @@ Apache</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="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>La durée minimale de stockage d'un document dans le 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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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> + 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> @@ -187,28 +187,28 @@ Apache</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="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>La quantité minimale de données du document à lire et +<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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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 + 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>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 + <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">CacheReadSize 102400</pre> @@ -218,31 +218,31 @@ Apache</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="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>La durée minimale de lecture avant l'envoi des données</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#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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>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 + 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>La valeur par défaut 0 désactive cette directive.</p> + <p>La valeur par défaut 0 désactive cette directive.</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 + <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> + 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> @@ -251,7 +251,7 @@ Apache</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_socache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cache_socache.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_cache_socache.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -270,7 +270,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_soca } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cern_meta.html b/docs/manual/mod/mod_cern_meta.html index ce935a92f1..45ea0ef486 100644 --- a/docs/manual/mod/mod_cern_meta.html +++ b/docs/manual/mod/mod_cern_meta.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cern_meta.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_cern_meta.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_cern_meta.html.fr b/docs/manual/mod/mod_cern_meta.html.fr index e2de5ffff7..95bcb43a72 100644 --- a/docs/manual/mod/mod_cern_meta.html.fr +++ b/docs/manual/mod/mod_cern_meta.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,27 +27,27 @@ <div id="preamble"><h1>Module Apache mod_cern_meta</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cern_meta.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | <a href="../ko/mod/mod_cern_meta.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>La sémantique des métafichiers du serveur httpd du +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>La sémantique des métafichiers du serveur httpd du CERN</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cern_meta_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cern_meta.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cern_meta_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cern_meta.c</td></tr></table> <h3>Sommaire</h3> - <p>Il s'agit d'une émulation de la sémantique des métafichiers du - serveur httpd du CERN. Les métafichiers sont des en-têtes HTTP - qui peuvent s'ajouter au jeu d'en-têtes habituels pour chaque - fichier accédé. Ils ressemblent beaucoup aux fichiers .asis - d'Apache, et permettent d'influencer de manière rudimentaire - l'en-tête Expires:, ainsi que d'autres curiosités. Il existe de - nombreuses méthodes pour gérer les métainformations, mais le choix - s'est porté sur celle-ci car il existe déjà un grand nombre + <p>Il s'agit d'une émulation de la sémantique des métafichiers du + serveur httpd du CERN. Les métafichiers sont des en-têtes HTTP + qui peuvent s'ajouter au jeu d'en-têtes habituels pour chaque + fichier accédé. Ils ressemblent beaucoup aux fichiers .asis + d'Apache, et permettent d'influencer de manière rudimentaire + l'en-tête Expires:, ainsi que d'autres curiosités. Il existe de + nombreuses méthodes pour gérer les métainformations, mais le choix + s'est porté sur celle-ci car il existe déjà un grand nombre d'utilisateurs du CERN qui peuvent exploiter ce module.</p> - <p>Pour plus d'information, voir le document sur la <a href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir">sémantique des métafichiers du CERN</a>.</p> + <p>Pour plus d'information, voir le document sur la <a href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir">sémantique des métafichiers du CERN</a>.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -64,27 +64,27 @@ CERN</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="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>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#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>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> + <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>Ou, pour rechercher dans un sous-répertoire du répertoire - contenant le fichier à accéder :</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> @@ -93,37 +93,37 @@ métainformations dans le style du CERN</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="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>Active le traitement des métafichiers du CERN</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#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#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>Active ou désactive le traitement des métafichiers pour certains - répertoires.</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>Suffixe du fichier contenant les métainformations dans le +<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#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>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 + <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 + 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 + son contenu pour générer les informations quant aux en-têtes MIME additionnels.</p> <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config">MetaSuffix .meta</pre> @@ -133,7 +133,7 @@ style du CERN</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cern_meta.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | <a href="../ko/mod/mod_cern_meta.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -153,7 +153,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cern_meta. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cgi.html b/docs/manual/mod/mod_cgi.html index 52ef69efd1..dc3516906f 100644 --- a/docs/manual/mod/mod_cgi.html +++ b/docs/manual/mod/mod_cgi.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cgi.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_cgi.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_cgi.html.fr b/docs/manual/mod/mod_cgi.html.fr index 1ce394ecb3..a8410d55c9 100644 --- a/docs/manual/mod/mod_cgi.html.fr +++ b/docs/manual/mod/mod_cgi.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,41 +27,41 @@ <div id="preamble"><h1>Module Apache mod_cgi</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cgi.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cgi.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cgi_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cgi.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cgi_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cgi.c</td></tr></table> <h3>Sommaire</h3> <p>Tout fichier pris en compte par le gestionnaire - <code>cgi-script</code> sera traité en tant que script CGI et - exécuté par le serveur, sa sortie étant renvoyée au client. Les - fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent - un nom contenant une extension définie par la directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>, soit parce qu'ils se - situent dans un répertoire défini par une directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</p> + <code>cgi-script</code> sera traité en tant que script CGI et + exécuté par le serveur, sa sortie étant renvoyée au client. Les + fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent + un nom contenant une extension définie par la directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>, soit parce qu'ils se + situent dans un répertoire défini par une directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</p> - <p>Comme introduction à l'utilisation des scripts CGI avec Apache, + <p>Comme introduction à l'utilisation des scripts CGI avec Apache, voir notre tutoriel <a href="../howto/cgi.html">Les contenus dynamiques avec CGI</a>.</p> - <p>Le module <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> doit être utilisé à la place + <p>Le module <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> doit être utilisé à la place du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> lorsqu'on utilise un module MPM - multi-threadé sous Unix. Vus de l'utilisateur, les deux modules + multi-threadé sous Unix. Vus de l'utilisateur, les deux modules sont pratiquement identiques.</p> - <p>À des fins de compatibilité ascendante, le gestionnaire - cgi-script sera également activé pour tout fichier possédant le type + <p>À des fins de compatibilité ascendante, le gestionnaire + cgi-script sera également activé pour tout fichier possédant le type MIME <code>application/x-httpd-cgi</code>. L'utilisation du type - MIME magic est obsolète.</p> + MIME magic est obsolète.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#env">Les variables d'environnement CGI</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#cgi-debug">Débogage des scripts CGI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cgi-debug">Débogage des scripts CGI</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#scriptlog">ScriptLog</a></li> @@ -74,52 +74,52 @@ <li><code class="directive"><a href="../mod/core.html#options">Options</a></code> ExecCGI</li> <li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li> <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li> -<li><a href="../suexec.html">Exécuter des programmes CGI sous des -utilisateurs différents</a></li> -<li><a href="http://www.ietf.org/rfc/rfc3875">La spécification +<li><a href="../suexec.html">Exécuter des programmes CGI sous des +utilisateurs différents</a></li> +<li><a href="http://www.ietf.org/rfc/rfc3875">La spécification CGI</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="env" id="env">Les variables d'environnement CGI</a></h2> - <p>Le serveur va définir les variables d'environnement CGI comme - décrit dans la <a href="http://www.ietf.org/rfc/rfc3875">Spécification CGI</a>, de la - manière suivante :</p> + <p>Le serveur va définir les variables d'environnement CGI comme + décrit dans la <a href="http://www.ietf.org/rfc/rfc3875">Spécification CGI</a>, de la + manière suivante :</p> <dl> <dt>PATH_INFO</dt> <dd>Cette variable ne sera pas disponible si la directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> est - explicitement définie à <code>off</code>. Par défaut, si la - directive <code class="directive">AcceptPathInfo</code> n'est pas définie, + explicitement définie à <code>off</code>. Par défaut, si la + directive <code class="directive">AcceptPathInfo</code> n'est pas définie, <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> acceptera des informations de chemin (en - ajoutant /infos/chemin après le nom du script dans l'URI), alors + ajoutant /infos/chemin après le nom du script dans l'URI), alors que le serveur de base retournera une erreur 404 NOT FOUND pour - les requêtes contenant des informations de chemin supplémentaires. - Ne pas définir la directive <code class="directive">AcceptPathInfo</code> - a le même effet sur les requêtes avec <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> que - de la définir à <code>On</code>.</dd> + les requêtes contenant des informations de chemin supplémentaires. + Ne pas définir la directive <code class="directive">AcceptPathInfo</code> + a le même effet sur les requêtes avec <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> que + de la définir à <code>On</code>.</dd> <dt>REMOTE_HOST</dt> - <dd>Cette variable ne sera définie que si la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> est définie à - <code>on</code> (elle est à <code>off</code> par défaut), et si - une recherche DNS inverse sur l'adresse IP de l'hôte client - aboutit effectivement à un nom d'hôte.</dd> + <dd>Cette variable ne sera définie que si la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> est définie à + <code>on</code> (elle est à <code>off</code> par défaut), et si + une recherche DNS inverse sur l'adresse IP de l'hôte client + aboutit effectivement à un nom d'hôte.</dd> <dt>REMOTE_IDENT</dt> - <dd>Cette variable ne sera définie que si la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> - est définie à <code>on</code>, et si l'hôte client supporte le + <dd>Cette variable ne sera définie que si la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> + est définie à <code>on</code>, et si l'hôte client supporte le protocole ident. Notez que l'on ne peut accorder une confiance - aveugle au contenu de cette variable car il peut être aisément - falsifié, et si un mandataire s'intercale entre le client et le + aveugle au contenu de cette variable car il peut être aisément + falsifié, et si un mandataire s'intercale entre le client et le serveur, il est totalement inutilisable.</dd> <dt>REMOTE_USER</dt> - <dd>Cette variable ne sera définie que si le script CGI fait + <dd>Cette variable ne sera définie que si le script CGI fait l'objet d'une authentification.</dd> </dl> @@ -129,47 +129,47 @@ CGI</a></li> <dl> <dt>DOCUMENT_ROOT</dt> - <dd>Prend la valeur définie par la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.</dd> + <dd>Prend la valeur définie par la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.</dd> <dt>SERVER_NAME</dt> - <dd>Le nom de domaine pleinement qualifié pour la requête considérée</dd> + <dd>Le nom de domaine pleinement qualifié pour la requête considérée</dd> <dt>SERVER_ADDR</dt> - <dd>L'adresse IP du serveur virtuel qui traite la requête</dd> + <dd>L'adresse IP du serveur virtuel qui traite la requête</dd> <dt>SERVER_ADMIN</dt> - <dd>Prend la valeur définie par la directive <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>.</dd> + <dd>Prend la valeur définie par la directive <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>.</dd> </dl> - <p>Pour une liste exhaustive de ces variables, vous pouvez écrire un script - CGI basique qui extrait toutes les variables d'environnement passées par - Apache selon un format adapté. + <p>Pour une liste exhaustive de ces variables, vous pouvez écrire un script + CGI basique qui extrait toutes les variables d'environnement passées par + Apache selon un format adapté. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="cgi-debug" id="cgi-debug">Débogage des scripts CGI</a></h2> - <p>Le débogage des scripts CGI était difficile par le passé, - principalement parce qu'il n'était pas possible d'étudier la sortie - (sortie standard et erreurs) des scripts dont l'exécution échouait. - Ces directives permettent une journalisation plus détaillée des +<h2><a name="cgi-debug" id="cgi-debug">Débogage des scripts CGI</a></h2> + <p>Le débogage des scripts CGI était difficile par le passé, + principalement parce qu'il n'était pas possible d'étudier la sortie + (sortie standard et erreurs) des scripts dont l'exécution échouait. + Ces directives permettent une journalisation plus détaillée des erreurs.</p> <h3>Format du fichier journal CGI</h3> - <p>Lorsqu'il est configuré, le journal des erreurs CGI enregistre - la sortie de tout programme CGI dont l'exécution ne s'effectue pas - correctement. Un script CGI dont l'exécution échoue provoque la - journalisation d'une grande quantité d'informations. Les deux - premières lignes possèdent toujours le format suivant :</p> + <p>Lorsqu'il est configuré, le journal des erreurs CGI enregistre + la sortie de tout programme CGI dont l'exécution ne s'effectue pas + correctement. Un script CGI dont l'exécution échoue provoque la + journalisation d'une grande quantité d'informations. Les deux + premières lignes possèdent toujours le format suivant :</p> <div class="example"><p><code> - %% [<var>date</var>] <var>requête</var><br /> - %% <var>état HTTP</var> <var>nom du script CGI</var> + %% [<var>date</var>] <var>requête</var><br /> + %% <var>état HTTP</var> <var>nom du script CGI</var> </code></p></div> - <p>Si le script CGI n'a pas pu démarrer, le fichier journal - contiendra les deux lignes supplémentaires suivantes :</p> + <p>Si le script CGI n'a pas pu démarrer, le fichier journal + contiendra les deux lignes supplémentaires suivantes :</p> <div class="example"><p><code> %%erreur<br /> @@ -177,16 +177,16 @@ CGI</a></li> </code></p></div> <p>Par contre, si l'erreur provient du renvoi par le script - d'informations incorrectes dans les en-têtes (dû souvent à une - bogue du script), les informations suivantes sont journalisées + d'informations incorrectes dans les en-têtes (dû souvent à une + bogue du script), les informations suivantes sont journalisées :</p> <div class="example"><p><code> - %requête<br /> - <var>Tous les en-têtes de requête HTTP reçus</var><br /> - <var>Les entités POST ou PUT (s'il en existe)</var><br /> - %réponse<br /> - <var>Tous les en-têtes générés par le script CGI</var><br /> + %requête<br /> + <var>Tous les en-têtes de requête HTTP reçus</var><br /> + <var>Les entités POST ou PUT (s'il en existe)</var><br /> + %réponse<br /> + <var>Tous les en-têtes générés par le script CGI</var><br /> %stdout<br /> <var>la sortie standard CGI</var><br /> %stderr<br /> @@ -194,7 +194,7 @@ CGI</a></li> </code></p></div> <p>(Les parties %stdout et %stderr seront absentes si le script - n'a rien envoyé sur la sortie standard ou la sortie + n'a rien envoyé sur la sortie standard ou la sortie d'erreurs).</p> </div> @@ -208,54 +208,54 @@ CGI</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>La directive <code class="directive">ScriptLog</code> définit + <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 + 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>. + 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>Exemple</h3><pre class="prettyprint lang-config">ScriptLog logs/cgi_log</pre> </div> <p>Ce journal sera ouvert par l'utilisateur sous lequel les - processus enfants s'exécutent, c'est à dire l'utilisateur spécifié + 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 + 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> + 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> + 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>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#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#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>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. + 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> + 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> @@ -264,26 +264,26 @@ enregistrées dans le journal du script</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#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>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 + 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 + 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> + enregistrée.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cgi.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cgi.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -304,7 +304,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cgi.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_cgid.html b/docs/manual/mod/mod_cgid.html index e6a8efa3a4..d13f7681c5 100644 --- a/docs/manual/mod/mod_cgid.html +++ b/docs/manual/mod/mod_cgid.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_cgid.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_cgid.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_cgid.html.fr b/docs/manual/mod/mod_cgid.html.fr index 5af336cd53..f51eb12176 100644 --- a/docs/manual/mod/mod_cgid.html.fr +++ b/docs/manual/mod/mod_cgid.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,44 +27,44 @@ <div id="preamble"><h1>Module Apache mod_cgid</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cgid.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cgid.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cgid.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cgid.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cgid.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI par l'intermédiaire d'un démon +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Exécution des scripts CGI par l'intermédiaire d'un démon CGI externe</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cgid_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cgid.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Uniquement compatible avec les MPMs Unix -threadés</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cgid_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cgid.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Uniquement compatible avec les MPMs Unix +threadés</td></tr></table> <h3>Sommaire</h3> - <p>Exceptées les optimisations et la directive additionnelle - <code class="directive"><a href="#scriptsock">ScriptSock</a></code> décrite - ci-dessous, <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> a un comportement similaire à - celui de <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. <strong>Voir le résumé de - <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> pour plus de détails à propos d'Apache et + <p>Exceptées les optimisations et la directive additionnelle + <code class="directive"><a href="#scriptsock">ScriptSock</a></code> décrite + ci-dessous, <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> a un comportement similaire à + celui de <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. <strong>Voir le résumé de + <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> pour plus de détails à propos d'Apache et CGI.</strong></p> - <p>Sur certains systèmes d'exploitation de type unix, le branchement - (forking) d'un processus depuis un serveur multi-threadé est une - opération très lourde car le nouveau processus va répliquer tous les - threads du processus parent. Pour éviter cette dépense de ressouces + <p>Sur certains systèmes d'exploitation de type unix, le branchement + (forking) d'un processus depuis un serveur multi-threadé est une + opération très lourde car le nouveau processus va répliquer tous les + threads du processus parent. Pour éviter cette dépense de ressouces pour chaque invocation d'un programme CGI, <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> - crée un démon externe qui est responsable du branchement de - processus enfants destinés au lancement de scripts CGI. Le serveur - principal communique avec ce démon par l'intermédiaire d'un socket + crée un démon externe qui est responsable du branchement de + processus enfants destinés au lancement de scripts CGI. Le serveur + principal communique avec ce démon par l'intermédiaire d'un socket de domaine unix.</p> - <p>Si un MPM multi-threadé a été sélectionné lors du processus de - compilation, c'est ce module qui est utilisé par défaut à la place + <p>Si un MPM multi-threadé a été sélectionné lors du processus de + compilation, c'est ce module qui est utilisé par défaut à la place de <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. Du point de vue de l'utilisateur, ce - module est identique à <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> quant à sa - configuration et son utilisation. La seule différence est la + module est identique à <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> quant à sa + configuration et son utilisation. La seule différence est la directive additionnelle <code>ScriptSock</code> qui permet de - définir le nom du socket à utiliser pour la communication avec le - démon CGI.</p> + définir le nom du socket à utiliser pour la communication avec le + démon CGI.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -77,26 +77,26 @@ threadés</td></tr></table> <h3>Voir aussi</h3> <ul class="seealso"> <li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li> -<li><a href="../suexec.html">Exécution de programmes CGI sous des -utilisateurs différents</a></li> +<li><a href="../suexec.html">Exécution de programmes CGI sous des +utilisateurs différents</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</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="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>Durée maximale d'attente de la prochaine sortie du +<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>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#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>La valeur de CGIDScriptTimeout est 0 dans les versions -2.4 et antérieures +<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>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 + <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>Exemple</h3><pre class="prettyprint lang-config">CGIDScriptTimeout 20</pre> @@ -107,25 +107,25 @@ programme CGI</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="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>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#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#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>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 + <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> + 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>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> + 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>Exemple</h3><pre class="prettyprint lang-config">ScriptSock /var/run/cgid.sock</pre> </div> @@ -135,7 +135,7 @@ communiquer avec le démon CGI</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cgid.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_cgid.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_cgid.html" title="Français"> fr </a> | <a href="../ja/mod/mod_cgid.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_cgid.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -156,7 +156,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cgid.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_charset_lite.html b/docs/manual/mod/mod_charset_lite.html index 2fbf3af75e..af19fc8bb8 100644 --- a/docs/manual/mod/mod_charset_lite.html +++ b/docs/manual/mod/mod_charset_lite.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_charset_lite.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_charset_lite.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_charset_lite.html.fr b/docs/manual/mod/mod_charset_lite.html.fr index d0c7ca2b06..02d0303175 100644 --- a/docs/manual/mod/mod_charset_lite.html.fr +++ b/docs/manual/mod/mod_charset_lite.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,35 +27,35 @@ <div id="preamble"><h1>Module Apache mod_charset_lite</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_charset_lite.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_charset_lite.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_charset_lite.html" title="Français"> fr </a> | <a href="../ko/mod/mod_charset_lite.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Spécifie dans quel jeu de caractère doivent s'effectuer les -traductions ou les réencodages</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Spécifie dans quel jeu de caractère doivent s'effectuer les +traductions ou les réencodages</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>charset_lite_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_charset_lite.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>charset_lite_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_charset_lite.c</td></tr></table> <h3>Sommaire</h3> <p>Le module <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> permet au serveur de - modifier le jeu de caractères des réponses avant de les envoyer aux + modifier le jeu de caractères des réponses avant de les envoyer aux clients. Dans un environnement EBCDIC, Apache traduit toujours les - contenus au protocole HTTP (par exemples les en-têtes de réponses) + contenus au protocole HTTP (par exemples les en-têtes de réponses) de la page de code de la locale du processus Apache vers ISO-8859-1, - mais pas le corps des réponses. Dans tous les environnements, on - peut utiliser <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> pour spécifier que - les corps des réponses doivent être traduits. Par exemple, si les - fichiers sont stockés sous forme EBCDIC, + mais pas le corps des réponses. Dans tous les environnements, on + peut utiliser <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> pour spécifier que + les corps des réponses doivent être traduits. Par exemple, si les + fichiers sont stockés sous forme EBCDIC, <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> pourra les traduire en ISO-8859-1 avant de les envoyer au client.</p> - <p>Ce module fournit quelques procédés de configuration implémentés + <p>Ce module fournit quelques procédés de configuration implémentés par Apache version russe, ainsi que son module - <code>mod_charset</code> associé.</p> + <code>mod_charset</code> associé.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#problems">Problèmes courants</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#problems">Problèmes courants</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#charsetdefault">CharsetDefault</a></li> @@ -65,64 +65,64 @@ traductions ou les réencodages</td></tr> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="problems" id="problems">Problèmes courants</a></h2> +<h2><a name="problems" id="problems">Problèmes courants</a></h2> - <h3>Noms de jeux de caractères non valides</h3> + <h3>Noms de jeux de caractères non valides</h3> - <p>Les noms des jeux de caractères passés en paramètres aux + <p>Les noms des jeux de caractères passés en paramètres aux directives <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code> et <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code> - doivent être reconnus par le mécanisme de traduction utilisé par - <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> sur le système où - <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> est utilisé. Ces noms de jeux de - caractères ne sont pas standardisés, et sont en général différents - des valeurs qui leur correspondent dans les en-têtes HTTP. + doivent être reconnus par le mécanisme de traduction utilisé par + <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> sur le système où + <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> est utilisé. Ces noms de jeux de + caractères ne sont pas standardisés, et sont en général différents + des valeurs qui leur correspondent dans les en-têtes HTTP. Actuellement, APR ne peut utiliser que iconv(3) ; vous pouvez donc - tester facilement vos noms de jeux de caractères en utilisant le - programme iconv(1), de la manière suivante :</p> + tester facilement vos noms de jeux de caractères en utilisant le + programme iconv(1), de la manière suivante :</p> <div class="example"><p><code> iconv -f valeur-charsetsourceenc -t valeur-charsetdefault </code></p></div> - <h3>Incompatibilité entre le jeu de caractères du - contenu et les règles de traduction</h3> + <h3>Incompatibilité entre le jeu de caractères du + contenu et les règles de traduction</h3> - <p>Si les règles de traduction ne peuvent s'appliquer au contenu, - la traduction peut échouer avec des conséquences diverses, comme + <p>Si les règles de traduction ne peuvent s'appliquer au contenu, + la traduction peut échouer avec des conséquences diverses, comme :</p> <ul> - <li>Le mécanisme de traduction peut renvoyer un mauvais code de + <li>Le mécanisme de traduction peut renvoyer un mauvais code de retour, et la connexion sera interrompue.</li> - <li>Le mécanisme de traduction peut insérer silencieusement des - caractères spéciaux (par exemple des points d'interrogation) dans + <li>Le mécanisme de traduction peut insérer silencieusement des + caractères spéciaux (par exemple des points d'interrogation) dans le tampon de sortie lorsqu'il n'est pas en mesure de traduire le - tampon d'entrée.</li> + tampon d'entrée.</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="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>Jeu de caractère vers lequel la traduction doit +<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#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>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> + spécifie le jeu de caractères vers lequel le contenu situé dans le + conteneur associé devra être traduit.</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> + <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>Exemple</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert"> CharsetSourceEnc UTF-16BE @@ -131,51 +131,51 @@ s'effectuer</td></tr> </div> <div class="note"> - Spécifier le même jeu de caractères pour les deux directives + 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. + 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>Précise les détails de la traduction du jeu de -caractères</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#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#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>La directive <code class="directive">CharsetOptions</code> - précise certains détails du comportement du module + 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>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 + <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>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 + 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> + <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> @@ -183,21 +183,21 @@ caractères</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="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>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#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>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> + spécifie un jeu de caractères source pour les fichiers situés dans + le conteneur associé.</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> + <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>Exemple</h3><pre class="prettyprint lang-config"><Directory "/export/home/trawick/apacheinst/htdocs/convert"> CharsetSourceEnc UTF-16BE @@ -205,23 +205,23 @@ caractères</td></tr> </Directory></pre> </div> - <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> + <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"> - Spécifier le même jeu de caractères pour les deux directives + 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. + 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"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_charset_lite.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_charset_lite.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_charset_lite.html" title="Français"> fr </a> | <a href="../ko/mod/mod_charset_lite.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -241,7 +241,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_charset_li } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_data.html b/docs/manual/mod/mod_data.html index 57601121be..3d8f69d4b2 100644 --- a/docs/manual/mod/mod_data.html +++ b/docs/manual/mod/mod_data.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_data.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_data.html.fr b/docs/manual/mod/mod_data.html.fr index 10f1ff1d3c..24f03a3c0b 100644 --- a/docs/manual/mod/mod_data.html.fr +++ b/docs/manual/mod/mod_data.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,27 +27,27 @@ <div id="preamble"><h1>Module Apache mod_data</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_data.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_data.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_data.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Convertit un corps de réponse en URL de type données RFC2397</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Convertit un corps de réponse en URL de type données RFC2397</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>data_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_data.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 du serveur HTTP Apache</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>data_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_data.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 du serveur HTTP Apache</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet de convertir une réponse en <a href="http://tools.ietf.org/html/rfc2397">URL de type données + <p>Ce module permet de convertir une réponse en <a href="http://tools.ietf.org/html/rfc2397">URL de type données RFC2397</a>. </p> - <p>Les URLs de type données peuvent être incluses en ligne dans les + <p>Les URLs de type données peuvent être incluses en ligne dans les pages web via le module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> par exemple, - afin d'éviter aux clients d'avoir à effectuer des connexions - séparées pour éventuellement extraire un grand nombre de petites - images. Les URLs de type données peuvent aussi être incluses dans - des pages générées par langages de scripting tels que PHP.</p> + afin d'éviter aux clients d'avoir à effectuer des connexions + séparées pour éventuellement extraire un grand nombre de petites + images. Les URLs de type données peuvent aussi être incluses dans + des pages générées par langages de scripting tels que PHP.</p> - <div class="example"><h3>Un exemple d'URL de type données</h3><p><code> + <div class="example"><h3>Un exemple d'URL de type données</h3><p><code> data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAw<br /> AAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFz<br /> ByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSp<br /> @@ -57,9 +57,9 @@ hhx4dbgYKAAA7<br /> </code></p></div> - <p>Le filtre n'accepte aucun paramètre, et peut être ajouté à la + <p>Le filtre n'accepte aucun paramètre, et peut être ajouté à la pile des filtres via la directive <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>, ou toute autre directive - supportée par le module <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</p> + supportée par le module <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</p> <div class="example"><h3>Configuration du filtre</h3><pre class="prettyprint lang-config"><Location "/data/images"> SetOutputFilter DATA @@ -77,7 +77,7 @@ </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_data.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_data.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_data.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -96,7 +96,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_data.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dav.html b/docs/manual/mod/mod_dav.html index 02a71d348f..5843afe15d 100644 --- a/docs/manual/mod/mod_dav.html +++ b/docs/manual/mod/mod_dav.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dav.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_dav.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_dav.html.fr b/docs/manual/mod/mod_dav.html.fr index 0701457f18..a90a2110e7 100644 --- a/docs/manual/mod/mod_dav.html.fr +++ b/docs/manual/mod/mod_dav.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,28 +27,28 @@ <div id="preamble"><h1>Module Apache mod_dav</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalité de création et gestion de versions de +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalité de création et gestion de versions de documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module ajoute à Apache une fonctionnalité <a href="http://www.webdav.org">WebDAV</a> de classes 1 et 2 - ('Web-based Distributed Authoring and Versioning' ou Création et + <p>Ce module ajoute à Apache une fonctionnalité <a href="http://www.webdav.org">WebDAV</a> de classes 1 et 2 + ('Web-based Distributed Authoring and Versioning' ou Création et gestion de versions de documents via le web). Il s'agit d'une - extension du protocole HTTP qui permet de créer, déplacer, copier et + extension du protocole HTTP qui permet de créer, déplacer, copier et supprimer des ressources ou collections de ressources sur un serveur web distant.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#example">Activation de WebDAV</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes concernant la sécurité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes concernant la sécurité</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#complex">Configurations complexes</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -66,37 +66,37 @@ documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</td></tr> <div class="section"> <h2><a name="example" id="example">Activation de WebDAV</a></h2> <p>Pour activer le module <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, ajoutez la ligne - suivante à un conteneur de votre fichier <code>httpd.conf</code> + suivante à un conteneur de votre fichier <code>httpd.conf</code> :</p> <pre class="prettyprint lang-config">Dav On</pre> - <p>Ceci active le fournisseur de système de fichier DAV implémenté par - le module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Ce dernier doit donc être - compilé dans le serveur ou chargé au démarrage à l'aide de la + <p>Ceci active le fournisseur de système de fichier DAV implémenté par + le module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Ce dernier doit donc être + compilé dans le serveur ou chargé au démarrage à l'aide de la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</p> - <p>En outre, vous devez indiquer où se trouve la base de données des + <p>En outre, vous devez indiquer où se trouve la base de données des verrous DAV via une directive <code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> dans la section globale de votre fichier <code>httpd.conf</code> :</p> <pre class="prettyprint lang-config">DavLockDB "/usr/local/apache2/var/DavLock"</pre> - <p>Le répertoire contenant le fichier de la base de données des - verrous doit avoir des droits en écriture pour l'utilisateur et le - groupe sous lesquels Apache s'exécute et définis respectivement par + <p>Le répertoire contenant le fichier de la base de données des + verrous doit avoir des droits en écriture pour l'utilisateur et le + groupe sous lesquels Apache s'exécute et définis respectivement 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>.</p> - <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est - activé, vous pouvez ajouter une clause <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> dans la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> considérée. Pour - définir la quantité maximale de données en octets qu'un client - DAV peut envoyer par requête, vous devez utiliser la directive + <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est + activé, vous pouvez ajouter une clause <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> dans la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> considérée. Pour + définir la quantité maximale de données en octets qu'un client + DAV peut envoyer par requête, vous devez utiliser la directive <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code>, car La directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> - "habituelle" n'a aucune incidence sur les requêtes DAV.</p> + "habituelle" n'a aucune incidence sur les requêtes DAV.</p> <div class="example"><h3>Exemple complet</h3><pre class="prettyprint lang-config">DavLockDB "/usr/local/apache2/var/DavLock" @@ -116,61 +116,61 @@ documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</td></tr> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="security" id="security">Problèmes concernant la sécurité</a></h2> +<h2><a name="security" id="security">Problèmes concernant la sécurité</a></h2> - <p>Etant donné que les méthodes d'accès DAV permettent à des clients + <p>Etant donné que les méthodes d'accès DAV permettent à des clients distants de manipuler des fichiers sur le serveur, vous devez vous - assurer que votre serveur est bien sécurisé avant d'activer + assurer que votre serveur est bien sécurisé avant d'activer <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>.</p> - <p>Tout répertoire du serveur où DAV est activé doit être protégé - par une procédure d'authentification. L'utilisation de - l'authentification HTTP de base n'est pas recommandée. Vous devez - utiliser au moins l'authentification HTTP à base de condensés - qu'implémente le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. - Pratiquement tous les clients WebDAV supportent cette méthode + <p>Tout répertoire du serveur où DAV est activé doit être protégé + par une procédure d'authentification. L'utilisation de + l'authentification HTTP de base n'est pas recommandée. Vous devez + utiliser au moins l'authentification HTTP à base de condensés + qu'implémente le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. + Pratiquement tous les clients WebDAV supportent cette méthode d'authentification. Vous pouvez aussi utiliser l'authentification de - base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p> + base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p> <p>Pour que <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> puisse manipuler des fichiers, - il doit avoir des permissions en écriture sur les répertoires et les - fichiers qui sont sous son contrôle ; en d'autre termes, c'est - l'utilisateur et le groupe sous lesquels Apache s'exécute et définis + il doit avoir des permissions en écriture sur les répertoires et les + fichiers qui sont sous son contrôle ; en d'autre termes, c'est + l'utilisateur et le groupe sous lesquels Apache s'exécute et 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> qui doivent avoir - les droits en écriture sur ces fichiers et répertoires. Les fichiers - nouvellement créés appartiendront aussi à ces utilisateur et groupe. - Par conséquent, il est important de contrôler l'accès à ce compte. - Les répertoires DAV sont considérés comme privés du point de vue + les droits en écriture sur ces fichiers et répertoires. Les fichiers + nouvellement créés appartiendront aussi à ces utilisateur et groupe. + Par conséquent, il est important de contrôler l'accès à ce compte. + Les répertoires DAV sont considérés comme privés du point de vue d'Apache, et la modification des fichiers qu'ils contiennent - autrement que par l'intermédiaire d'Apache (par exemple par FTP ou - par des outils du niveau du système de fichiers) ne doit pas être + autrement que par l'intermédiaire d'Apache (par exemple par FTP ou + par des outils du niveau du système de fichiers) ne doit pas être permise.</p> <p><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut faire l'objet de plusieurs sortes - d'attaques par déni de service. La directive <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code> permet de limiter la - quantité de mémoire consommée pour interpréter des requêtes DAV de - grande taille. En outre, la directive <code class="directive"><a href="#davdepthinfinity">DavDepthInfinity</a></code> permet d'empêcher les - requêtes <code>PROPFIND</code> concernant un répertoire de très - grande taille de consommer de grandes quantités de mémoire. Un autre - type d'attaque par déni de service peut aussi être mené par un + d'attaques par déni de service. La directive <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code> permet de limiter la + quantité de mémoire consommée pour interpréter des requêtes DAV de + grande taille. En outre, la directive <code class="directive"><a href="#davdepthinfinity">DavDepthInfinity</a></code> permet d'empêcher les + requêtes <code>PROPFIND</code> concernant un répertoire de très + grande taille de consommer de grandes quantités de mémoire. Un autre + type d'attaque par déni de service peut aussi être mené par un client qui remplit simplement tout l'espace disque disponible avec - des fichiers de très grande taille. Etant donné qu'il n'existe aucun - moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez - accorder des accès DAV qu'à des utilisateurs de confiance.</p> + des fichiers de très grande taille. Etant donné qu'il n'existe aucun + moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez + accorder des accès DAV qu'à des utilisateurs de confiance.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="complex" id="complex">Configurations complexes</a></h2> - <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques + <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques (scripts PHP, scripts CGI, etc...) en utilisant <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont courantes. Ce traitement n'est pas - évident car une requête - <code>GET</code> va toujours tenter d'exécuter le script, plutôt que - de télécharger son contenu. Pour éviter cet inconvénient, une - méthode possible consiste à faire correspondre deux URLs - différentes au même contenu, l'une d'entre elles servant à lancer le - script, alors que l'autre peut être utilisée pour le télécharger et + évident car une requête + <code>GET</code> va toujours tenter d'exécuter le script, plutôt que + de télécharger son contenu. Pour éviter cet inconvénient, une + méthode possible consiste à faire correspondre deux URLs + différentes au même contenu, l'une d'entre elles servant à lancer le + script, alors que l'autre peut être utilisée pour le télécharger et le manipuler avec DAV.</p> <pre class="prettyprint lang-config">Alias "/phparea" "/home/gstein/php_files" @@ -182,23 +182,23 @@ ForceType text/plain <p>Avec cette configuration, on peut utiliser - <code>http://example.com/phparea</code> pour afficher le résultat de - l'exécution des scripts PHP, et + <code>http://example.com/phparea</code> pour afficher le résultat de + l'exécution des scripts PHP, et <code>http://example.com/php-source</code> pour les manipuler avec DAV.</p> </div> <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>Active les méthodes HTTP WebDAV</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#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>La directive <code class="directive">Dav</code> active les - méthodes HTTP WebDAV pour le conteneur condidéré :</p> + méthodes HTTP WebDAV pour le conteneur condidéré :</p> <pre class="prettyprint lang-config"><Location "/foo"> Dav On @@ -206,62 +206,62 @@ ForceType text/plain <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 + 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> + reportez-vous à la <a href="#example">section précédente</a>.</p> <div class="warning"> - N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si + 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. + 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>Autorise les requêtes PROPFIND avec en-tête Depth: +<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#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>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 + 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>Durée minimale pendant laquelle le serveur maintient un +<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#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>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 + 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> + 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 @@ -272,7 +272,7 @@ verrou sur une ressource DAV</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -293,7 +293,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dav.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dav_fs.html b/docs/manual/mod/mod_dav_fs.html index d071695fa2..dc75d14f7c 100644 --- a/docs/manual/mod/mod_dav_fs.html +++ b/docs/manual/mod/mod_dav_fs.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dav_fs.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_dav_fs.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_dav_fs.html.fr b/docs/manual/mod/mod_dav_fs.html.fr index 15120fe677..d07d574014 100644 --- a/docs/manual/mod/mod_dav_fs.html.fr +++ b/docs/manual/mod/mod_dav_fs.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,28 +27,28 @@ <div id="preamble"><h1>Module Apache mod_dav_fs</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_fs.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav_fs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dav_fs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Implémente le fournisseur filesystem pour +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Implémente le fournisseur filesystem pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_fs_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_fs.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_fs_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_fs.c</td></tr></table> <h3>Sommaire</h3> - <p>L'activation de ce module <em>nécessite</em> l'utilisation de - <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. C'est un module de support pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> et à ce titre, il permet l'accès à des ressources - situées dans le système de fichiers du serveur. Le nom formel de ce + <p>L'activation de ce module <em>nécessite</em> l'utilisation de + <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. C'est un module de support pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> et à ce titre, il permet l'accès à des ressources + situées dans le système de fichiers du serveur. Le nom formel de ce fournisseur est <code>filesystem</code>. Les fournisseurs supports - de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont invoqués via la directive + de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont invoqués via la directive <code class="directive"><a href="../mod/mod_dav.html#dav">Dav</a></code> :</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">Dav filesystem</pre> </div> - <p>Comme <code>filesystem</code> est le fournisseur par défaut de + <p>Comme <code>filesystem</code> est le fournisseur par défaut de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, vous pouvez vous contenter d'utiliser la valeur <code>On</code> comme argument de Dav.</p> </div> @@ -64,17 +64,17 @@ <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>Chemin de la base de données des verrous DAV</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>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 + <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> @@ -82,14 +82,14 @@ <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DavLockDB var/DavLock</pre> </div> - <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 + <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> @@ -99,7 +99,7 @@ </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_fs.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav_fs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dav_fs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -120,7 +120,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dav_fs.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dav_lock.html b/docs/manual/mod/mod_dav_lock.html index 81b865ab21..d26d9bb1fe 100644 --- a/docs/manual/mod/mod_dav_lock.html +++ b/docs/manual/mod/mod_dav_lock.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dav_lock.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_dav_lock.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_dav_lock.html.fr b/docs/manual/mod/mod_dav_lock.html.fr index bbae8d90e3..c25ea010b8 100644 --- a/docs/manual/mod/mod_dav_lock.html.fr +++ b/docs/manual/mod/mod_dav_lock.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,36 +27,36 @@ <div id="preamble"><h1>Module Apache mod_dav_lock</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de verrouillage générique pour +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de verrouillage générique pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_lock_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_lock.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_lock_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_lock.c</td></tr></table> <h3>Sommaire</h3> - <p>ce module implémente une API de verrouillage générique que tout + <p>ce module implémente une API de verrouillage générique que tout fournisseur support de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut utiliser. Son - activation nécessite l'utilisation de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Mais + activation nécessite l'utilisation de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Mais sans fournisseur support pour l'utiliser, il n'est d'aucun service - et ne doit pas être chargé dans le serveur. <a href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui - implémente le fournisseur subversion, est un exemple + et ne doit pas être chargé dans le serveur. <a href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui + implémente le fournisseur subversion, est un exemple de module de support qui utilise effectivement <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code>.</p> <p>Notez que <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> n'a <em>pas</em> besoin de - ce module de verrouillage générique, car il utilise sa propre - version plus spécifique.</p> + ce module de verrouillage générique, car il utilise sa propre + version plus spécifique.</p> <p>Pour que <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> puisse fonctionner, il - vous suffit de spécifier le chemin de la base de données des verrous - à l'aide de la directive <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> décrite + vous suffit de spécifier le chemin de la base de données des verrous + à l'aide de la directive <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> décrite ci-dessous.</p> - <div class="note"><h3>Note du développeur</h3> - <p>Pour déterminer le pointeur de la fonction du fournisseur de + <div class="note"><h3>Note du développeur</h3> + <p>Pour déterminer le pointeur de la fonction du fournisseur de verrouillage, vous devez utiliser l'API <code>ap_lookup_provider</code> avec les arguments <code>dav-lock</code>, <code>generic</code> et <code>0</code>.</p> @@ -74,30 +74,30 @@ <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>Chemin de la base de données des verrous DAV</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#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>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 + <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>Exemple</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre> </div> - <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 + <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> @@ -107,7 +107,7 @@ </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -127,7 +127,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dav_lock.h } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dbd.html b/docs/manual/mod/mod_dbd.html index 22015efed5..baa63ccaf0 100644 --- a/docs/manual/mod/mod_dbd.html +++ b/docs/manual/mod/mod_dbd.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dbd.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_dbd.html.fr b/docs/manual/mod/mod_dbd.html.fr index 86982850f6..c4cffb2b9b 100644 --- a/docs/manual/mod/mod_dbd.html.fr +++ b/docs/manual/mod/mod_dbd.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,30 +27,30 @@ <div id="preamble"><h1>Module Apache mod_dbd</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_dbd.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gestion des connexions à une base de données SQL</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gestion des connexions à une base de données SQL</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dbd_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dbd.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dbd_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dbd.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> gère les connexions - à une base de données SQL via <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Il permet - aux modules qui requièrent des fonctions liées aux bases de données - SQL de se connecter à une base de données à la demande, et s'efforce - de conférer aux bases de données une efficacité et une - évolutivité optimales pour les MPMs threadés ou non threadés. Pour - plus de détails, voir le site web <a href="http://apr.apache.org/">APR</a>, + <p>Le module <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> gère les connexions + à une base de données SQL via <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Il permet + aux modules qui requièrent des fonctions liées aux bases de données + SQL de se connecter à une base de données à la demande, et s'efforce + de conférer aux bases de données une efficacité et une + évolutivité optimales pour les MPMs threadés ou non threadés. Pour + plus de détails, voir le site web <a href="http://apr.apache.org/">APR</a>, ainsi que cette vue d'ensemble de l'<a href="http://people.apache.org/~niq/dbd.html">environnement de - développement d'Apache DBD</a> par son développeur initial. + développement d'Apache DBD</a> par son développeur initial. </p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#pooling">Regroupement des connexions</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#API">API DBD d'Apache</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#prepared">Requêtes SQL préparées</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#prepared">Requêtes SQL préparées</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#security">AVERTISSEMENT DE SECURITE</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -72,20 +72,20 @@ passe</a></li> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="pooling" id="pooling">Regroupement des connexions</a></h2> - <p>Ce module gère de manière optimisée en fonction de la plate-forme - les connexions aux bases de données. Sur les plates-formes non - threadées, il maintient une connexion persistente à la manière d'un + <p>Ce module gère de manière optimisée en fonction de la plate-forme + les connexions aux bases de données. Sur les plates-formes non + threadées, il maintient une connexion persistente à la manière d'un LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les - plates-formes threadées, il maintient un <em>groupe de - connexions</em> à la fois plus évolutif et plus efficace, comme - décrit dans <a href="http://www.apachetutor.org/dev/reslist">cet + plates-formes threadées, il maintient un <em>groupe de + connexions</em> à la fois plus évolutif et plus efficace, comme + décrit dans <a href="http://www.apachetutor.org/dev/reslist">cet article d'ApacheTutor</a>. Notez que <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> - remplace les modules présentés dans cet article.</p> + remplace les modules présentés dans cet article.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="API" id="API">API DBD d'Apache</a></h2> <p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> exporte cinq fonctions que d'autres - modules pourront utiliser. L'API se présente comme suit :</p> + modules pourront utiliser. L'API se présente comme suit :</p> <pre class="prettyprint lang-c">typedef struct { apr_dbd_t *handle; @@ -93,9 +93,9 @@ passe</a></li> apr_hash_t *prepared; } ap_dbd_t; -/* Fonctions exportées pour accéder à la base de données */ +/* Fonctions exportées pour accéder à la base de données */ -/* ouvre une connexion qui DEVRA être explicitement fermée. +/* ouvre une connexion qui DEVRA être explicitement fermée. * Renvoie NULL en cas d'erreur */ AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*); @@ -103,24 +103,24 @@ AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*); /* ferme une connexion ouverte avec ap_dbd_open */ AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*); -/* acquiert une connexion qui aura la durée de vie de la requête et qui - * NE DEVRA PAS être explicitement fermée. Renvoie NULL en cas - * d'erreur. C'est la fonction recommandée pour la plupart des +/* acquiert une connexion qui aura la durée de vie de la requête et qui + * NE DEVRA PAS être explicitement fermée. Renvoie NULL en cas + * d'erreur. C'est la fonction recommandée pour la plupart des * applications. */ AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*); -/* acquiert une connexion qui aura la durée de vie d'une connexion et - * qui NE DEVRA PAS être explicitement fermée. Renvoie NULL en cas +/* acquiert une connexion qui aura la durée de vie d'une connexion et + * qui NE DEVRA PAS être explicitement fermée. Renvoie NULL en cas * d'erreur. */ AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*); -/* Prépare une requête qu'un module client pourra utiliser */ +/* Prépare une requête qu'un module client pourra utiliser */ AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*); -/* Exporte aussi ces fonctions à titre optionnel mour les modules qui - * péfèreraient les utiliser */ +/* Exporte aussi ces fonctions à titre optionnel mour les modules qui + * péfèreraient les utiliser */ APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*)); APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*)); APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*)); @@ -129,102 +129,102 @@ APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const c </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="prepared" id="prepared">Requêtes SQL préparées</a></h2> - <p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> supporte les requêtes SQL préparées pour - le compte des modules qui pourraient les utiliser. Chaque requête - préparée doit posséder un nom (étiquette), et est stockée dans un - condensé (hash) : les condensés sont du type - <code>apr_dbd_prepared_t</code> et s'utilisent dans toute requête - SQL ou commande select préparée par apr_dbd.</p> +<h2><a name="prepared" id="prepared">Requêtes SQL préparées</a></h2> + <p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> supporte les requêtes SQL préparées pour + le compte des modules qui pourraient les utiliser. Chaque requête + préparée doit posséder un nom (étiquette), et est stockée dans un + condensé (hash) : les condensés sont du type + <code>apr_dbd_prepared_t</code> et s'utilisent dans toute requête + SQL ou commande select préparée par apr_dbd.</p> <p>Il est du ressort des modules utilisateurs de dbd d'utiliser les - requêtes préparées et de préciser quelles requêtes doivent être - spécifiées dans httpd.conf, ou de fournir leurs propres directives + requêtes préparées et de préciser quelles requêtes doivent être + spécifiées dans httpd.conf, ou de fournir leurs propres directives et d'utiliser <code>ap_dbd_prepare</code>.</p> <div class="warning"><h3>Avertissement</h3> - Lorsqu'on utilise des requêtes préparées avec des bases de - données MySQL, il est préférable de définir - <code>reconnect</code> à 0 dans la chaîne de connexion, afin - d'éviter des erreurs provoquées par un client MySQL qui se - reconnecterait sans réinitialiser correctement les requêtes - préparées. Si <code>reconnect</code> est défini à 1, toute - connexion défectueuse sera sensée être réparée, mais comme - mod_dbd n'en est pas informé, les requêtes préparées seront - invalidées. + Lorsqu'on utilise des requêtes préparées avec des bases de + données MySQL, il est préférable de définir + <code>reconnect</code> à 0 dans la chaîne de connexion, afin + d'éviter des erreurs provoquées par un client MySQL qui se + reconnecterait sans réinitialiser correctement les requêtes + préparées. Si <code>reconnect</code> est défini à 1, toute + connexion défectueuse sera sensée être réparée, mais comme + mod_dbd n'en est pas informé, les requêtes préparées seront + invalidées. </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="security" id="security">AVERTISSEMENT DE SECURITE</a></h2> - <p>Toute application web impliquant une base de données doit se - protéger elle-même contre les attaques de type injection SQL. Dans - la plupart des cas Apache DBD est sûr, car les applications - utilisent des requêtes préparées, et les entrées non sûres ne seront - utilisées qu'à titre de données. Bien entendu, si vous l'utilisez - via un module tiers, vous devez être au fait des précautions à + <p>Toute application web impliquant une base de données doit se + protéger elle-même contre les attaques de type injection SQL. Dans + la plupart des cas Apache DBD est sûr, car les applications + utilisent des requêtes préparées, et les entrées non sûres ne seront + utilisées qu'à titre de données. Bien entendu, si vous l'utilisez + via un module tiers, vous devez être au fait des précautions à prendre.</p> <p>Cependant, le pilote <var>FreeTDS</var> est <strong>non - sûr</strong> de par sa nature même. Comme la bibliothèque - sous-jacente ne supporte pas les requêtes préparées, le pilote en - effectue une émulation, et les entrées non sûres sont fusionnées - avec la requête SQL.</p> - <p>Il peut être sécurisé en <em>décontaminant</em> toutes les - entrées : un processus inspiré de la recherche de contaminations de - Perl (NdT : <code>taint checking</code>). Chaque entrée est comparée - à une expression rationnelle, et - seules les entrées qui correspondent sont utilisées, en accord avec + sûr</strong> de par sa nature même. Comme la bibliothèque + sous-jacente ne supporte pas les requêtes préparées, le pilote en + effectue une émulation, et les entrées non sûres sont fusionnées + avec la requête SQL.</p> + <p>Il peut être sécurisé en <em>décontaminant</em> toutes les + entrées : un processus inspiré de la recherche de contaminations de + Perl (NdT : <code>taint checking</code>). Chaque entrée est comparée + à une expression rationnelle, et + seules les entrées qui correspondent sont utilisées, en accord avec le raccourci Perl :</p> <div class="example"><pre><code> $untrusted =~ /([a-z]+)/; $trusted = $1;</code></pre></div> <p>Pour utiliser ceci, les expressions rationnelles de - décontamination doivent être incluses dans les requêtes préparées. - L'expression rationnelle doit se situer immédiatement après le - caractère % dans la requête préparée, et doit être entourée - d'accolades {}. Par exemple, si votre application attend une entrée - alphanumérique, vous pouvez utiliser :</p> + décontamination doivent être incluses dans les requêtes préparées. + L'expression rationnelle doit se situer immédiatement après le + caractère % dans la requête préparée, et doit être entourée + d'accolades {}. Par exemple, si votre application attend une entrée + alphanumérique, vous pouvez utiliser :</p> <div class="example"><p><code> <code>"SELECT foo FROM bar WHERE input = %s"</code> </code></p></div> - <p>avec d'autres pilotes, et ne risquer au pire qu'une requête - en échec. Mais avec FreeTDS, vous devez utiliser :</p> + <p>avec d'autres pilotes, et ne risquer au pire qu'une requête + en échec. Mais avec FreeTDS, vous devez utiliser :</p> <div class="example"><p><code> <code>"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"</code> </code></p></div> - <p>tout ce qui ne correspond pas à l'expression rationnelle est - alors rejeté, et la requête est ainsi désormais sûre.</p> + <p>tout ce qui ne correspond pas à l'expression rationnelle est + alors rejeté, et la requête est ainsi désormais sûre.</p> <p>Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui - offre la sécurité des requêtes préparées authentiques.</p> + offre la sécurité des requêtes préparées authentiques.</p> </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>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#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>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> + <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>Exécute une instruction SQL après connexion à une base de -données</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>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> + <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> @@ -232,14 +232,14 @@ données</td></tr> <table class="directive"> <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#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>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> + <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> @@ -247,13 +247,13 @@ données</td></tr> <table class="directive"> <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#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>Cette directive définit le nombre maximum effectif de - connexions par processus (plates-formes threadées seulement).</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> @@ -261,33 +261,33 @@ données</td></tr> <table class="directive"> <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#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>Cette directive définit le nombre minimum de connexions - par processus (plates-formes threadées seulement).</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>Paramètres de la connexion à la base de -données</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>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>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> + <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 (pour MSSQL et SyBase)</dt> <dd>username, password, appname, dbname, host, charset, lang, server</dd> @@ -296,13 +296,13 @@ données</td></tr> <dt>Oracle</dt> <dd>user, pass, dbname, server</dd> <dt>PostgreSQL</dt> - <dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd> + <dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd> <dt>SQLite2</dt> - <dd>La chaîne de connexion est scindée avec comme séparateur le - caractère ':', et <code>partie1:partie2</code> est utilisé dans + <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>La chaîne de connexion est passée directement à <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> @@ -317,16 +317,16 @@ données</td></tr> <tr><th><a href="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>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 à + <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>Par défaut, les groupes de connexions persistentes sont activés + <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 + 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>Avant la version 2.2.2, cette directive n'acceptait que les @@ -337,39 +337,39 @@ données</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="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>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#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>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> + 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>Spécifie un pilote SQL</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>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> + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dbd.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_dbd.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -388,7 +388,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dbd.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_deflate.html b/docs/manual/mod/mod_deflate.html index 43202fbb41..d98001e2e2 100644 --- a/docs/manual/mod/mod_deflate.html +++ b/docs/manual/mod/mod_deflate.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_deflate.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_deflate.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_deflate.html.fr b/docs/manual/mod/mod_deflate.html.fr index 10a11c697f..1d1ab219e4 100644 --- a/docs/manual/mod/mod_deflate.html.fr +++ b/docs/manual/mod/mod_deflate.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,28 +27,28 @@ <div id="preamble"><h1>Module Apache mod_deflate</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_deflate.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_deflate.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_deflate.html" title="Français"> fr </a> | <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Comprime le contenu avant de le servir au client</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>deflate_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_deflate.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>deflate_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_deflate.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> implémente le filtre de + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> implémente le filtre de sortie <code>DEFLATE</code> qui permet de comprimer la sortie de - votre serveur avant de l'envoyer au client sur le réseau.</p> + votre serveur avant de l'envoyer au client sur le réseau.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#supportedencodings">Codages supportés</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#supportedencodings">Codages supportés</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#recommended">Exemples de configurations</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation de la compression</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#proxies">Prise en compte des serveurs mandataires</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#precompressed">Servir du contenu précompressé</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#precompressed">Servir du contenu précompressé</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#deflatealteretag">DeflateAlterETag</a></li> @@ -67,23 +67,23 @@ client</td></tr> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="supportedencodings" id="supportedencodings">Codages supportés</a></h2> - <p>Le seul codage supporté est <code>gzip</code> afin d'assurer une complète - compatibilité avec les anciens navigateurs. Le codage <code>deflate</code> - n'est donc pas supporté ; voir à ce sujet la <a href="http://www.gzip.org/zlib/zlib_faq.html#faq38">documentation de zlib</a> - pour une explication détaillée. +<h2><a name="supportedencodings" id="supportedencodings">Codages supportés</a></h2> + <p>Le seul codage supporté est <code>gzip</code> afin d'assurer une complète + compatibilité avec les anciens navigateurs. Le codage <code>deflate</code> + n'est donc pas supporté ; voir à ce sujet la <a href="http://www.gzip.org/zlib/zlib_faq.html#faq38">documentation de zlib</a> + pour une explication détaillée. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="recommended" id="recommended">Exemples de configurations</a></h2> <div class="warning"><h3>Compression et TLS</h3> - <p>Certaines applications web sont vulnérables à une attaque pour + <p>Certaines applications web sont vulnérables à une attaque pour vol d'informations lorsqu'une connexion TLS transporte des - données compressées par deflate. Pour plus de détails, + données compressées par deflate. Pour plus de détails, documentez-vous sur la famille d'attaques "BREACH".</p> </div> <p>Voici un exemple simple de configuration qui permet de comprimer - les types de contenu à base de texte.</p> + les types de contenu à base de texte.</p> <div class="example"><h3>Ne comprime que certains types de documents</h3><pre class="prettyprint lang-config">AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript</pre> </div> @@ -92,24 +92,24 @@ client</td></tr> <div class="section"> <h2><a name="enable" id="enable">Activation de la compression</a></h2> <div class="warning"><h3>Compression et TLS</h3> - <p>Certaines applications web sont vulnérables à une attaque pour + <p>Certaines applications web sont vulnérables à une attaque pour vol d'informations lorsqu'une connexion TLS transporte des - données compressées par deflate. Pour plus de détails, + données compressées par deflate. Pour plus de détails, documentez-vous sur la famille d'attaques "BREACH".</p> </div> <h3><a name="output" id="output">Compression de la sortie</a></h3> - <p>La compression est implémentée par le <a href="../filter.html">filtre</a> <code>DEFLATE</code>. La + <p>La compression est implémentée par le <a href="../filter.html">filtre</a> <code>DEFLATE</code>. La directive suivante active la compression des documents dans le - conteneur où elle est placée :</p> + conteneur où elle est placée :</p> <pre class="prettyprint lang-config">SetOutputFilter DEFLATE SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> - <p>Si vous voulez limiter la compression à certains types MIME + <p>Si vous voulez limiter la compression à certains types MIME particuliers, vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Voici un exemple - où la compression n'est activée que pour les fichiers html de la + où la compression n'est activée que pour les fichiers html de la documentation d'Apache :</p> <pre class="prettyprint lang-config"><Directory "/your-server-root/manual"> @@ -118,23 +118,23 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> <div class="note"><h3>Note</h3> - Le filtre <code>DEFLATE</code> est toujours inséré après les + Le filtre <code>DEFLATE</code> est toujours inséré après les filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les - sous-requêtes internes. + sous-requêtes internes. </div> <div class="note"><h3>Note</h3> - La variable d'environnement <code>force-gzip</code>, définie à + La variable d'environnement <code>force-gzip</code>, définie à l'aide de la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>, permet d'ignorer la - configuration de votre navigateur quant aux codages acceptés, et - d'envoyer sans condition une sortie comprimée. + configuration de votre navigateur quant aux codages acceptés, et + d'envoyer sans condition une sortie comprimée. </div> - <h3><a name="inflate" id="inflate">Décompression de la sortie</a></h3> + <h3><a name="inflate" id="inflate">Décompression de la sortie</a></h3> <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit aussi un filtre - permettant de décomprimer un corps de réponse comprimé par gzip. - Pour activer cette fonctionnalité, vous devez insérer le filtre - <code>INFLATE</code> dans la chaîne de filtrage en sortie via la + permettant de décomprimer un corps de réponse comprimé par gzip. + Pour activer cette fonctionnalité, vous devez insérer le filtre + <code>INFLATE</code> dans la chaîne de filtrage en sortie via la directive <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, comme dans l'exemple suivant :</p> @@ -145,17 +145,17 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> </Location></pre> - <p>Dans cet exemple, les sorties comprimées par gzip en - provenance de example.com seront décomprimées afin de pouvoir - être éventuellement traitées par d'autres filtres. + <p>Dans cet exemple, les sorties comprimées par gzip en + provenance de example.com seront décomprimées afin de pouvoir + être éventuellement traitées par d'autres filtres. </p> - <h3><a name="input" id="input">Décompression de l'entrée</a></h3> - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit également un filtre - permettant de décomprimer un corps de requête comprimé par gzip. - Pour activer cette fonctionnalité, vous devez insérer le filtre - <code>DEFLATE</code> dans la chaîne de filtrage en entrée via la + <h3><a name="input" id="input">Décompression de l'entrée</a></h3> + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit également un filtre + permettant de décomprimer un corps de requête comprimé par gzip. + Pour activer cette fonctionnalité, vous devez insérer le filtre + <code>DEFLATE</code> dans la chaîne de filtrage en entrée via la directive <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, comme dans l'exemple suivant :</p> @@ -165,79 +165,79 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> </Location></pre> - <p>Désormais, si une requête contient un en-tête + <p>Désormais, si une requête contient un en-tête <code>Content-Encoding: gzip</code>, son corps sera - automatiquement décomprimé. Peu de navigateurs sont actuellement - en mesure de comprimer les corps de requêtes. Cependant, - certaines applications spécialisées supportent les requêtes - comprimées, comme par exemple certains clients <a href="http://www.webdav.org">WebDAV</a>.</p> + automatiquement décomprimé. Peu de navigateurs sont actuellement + en mesure de comprimer les corps de requêtes. Cependant, + certaines applications spécialisées supportent les requêtes + comprimées, comme par exemple certains clients <a href="http://www.webdav.org">WebDAV</a>.</p> - <div class="warning"><h3>Note à propos de l'en-tête + <div class="warning"><h3>Note à propos de l'en-tête <code>Content-Length</code></h3> - <p>Si vous évaluez vous-même la taille du corps de requête, - <em>ne faites pas confiance à l'en-tête - <code>Content-Length</code>!</em> L'en-tête - Content-Length indique la longueur des données en provenance du - client, et <em>non</em> la quantité d'octets que représente le - flux de données décompressé.</p> + <p>Si vous évaluez vous-même la taille du corps de requête, + <em>ne faites pas confiance à l'en-tête + <code>Content-Length</code>!</em> L'en-tête + Content-Length indique la longueur des données en provenance du + client, et <em>non</em> la quantité d'octets que représente le + flux de données décompressé.</p> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="proxies" id="proxies">Prise en compte des serveurs mandataires</a></h2> - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> envoie un en-tête de - réponse HTTP <code>Vary: Accept-Encoding</code> pour avertir les - mandataires qu'une réponse enregistrée dans le cache ne doit être - envoyée qu'aux clients qui ont envoyé l'en-tête de requête - <code>Accept-Encoding</code> approprié. Ceci permet d'éviter l'envoi - d'un contenu comprimé à un client qui ne sera pas en mesure - de l'interpréter.</p> - - <p>Si vous avez défini des exclusions spécifiques dépendant, par - exemple, de l'en-tête <code>User-Agent</code>, vous devez - ajouter manuellement des données à l'en-tête <code>Vary</code> afin - d'informer les mandataires des restrictions supplémentaires. Par - exemple, dans la configuration classique où l'addition du filtre - <code>DEFLATE</code> dépend du contenu de l'en-tête - <code>User-Agent</code>, vous devez spécifier :</p> + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> envoie un en-tête de + réponse HTTP <code>Vary: Accept-Encoding</code> pour avertir les + mandataires qu'une réponse enregistrée dans le cache ne doit être + envoyée qu'aux clients qui ont envoyé l'en-tête de requête + <code>Accept-Encoding</code> approprié. Ceci permet d'éviter l'envoi + d'un contenu comprimé à un client qui ne sera pas en mesure + de l'interpréter.</p> + + <p>Si vous avez défini des exclusions spécifiques dépendant, par + exemple, de l'en-tête <code>User-Agent</code>, vous devez + ajouter manuellement des données à l'en-tête <code>Vary</code> afin + d'informer les mandataires des restrictions supplémentaires. Par + exemple, dans la configuration classique où l'addition du filtre + <code>DEFLATE</code> dépend du contenu de l'en-tête + <code>User-Agent</code>, vous devez spécifier :</p> <pre class="prettyprint lang-config">Header append Vary User-Agent</pre> - <p>Si votre décision de comprimer le contenu dépend d'autres - informations que celles contenues dans les en-têtes de la requête - (par exemple la version HTTP), vous devez attribuer à l'en-tête - <code>Vary</code> la valeur <code>*</code>, ce qui permet d'empêcher + <p>Si votre décision de comprimer le contenu dépend d'autres + informations que celles contenues dans les en-têtes de la requête + (par exemple la version HTTP), vous devez attribuer à l'en-tête + <code>Vary</code> la valeur <code>*</code>, ce qui permet d'empêcher les mandataires compatibles de tout mettre en cache.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">Header set Vary *</pre> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="precompressed" id="precompressed">Servir du contenu précompressé</a></h2> +<h2><a name="precompressed" id="precompressed">Servir du contenu précompressé</a></h2> - <p>Comme <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> recompresse le contenu demandé à - chaque requête, il est possible de gagner en performances en - précompressant ce contenu, et en forçant mod_deflate à servir ce - contenu précompressé sans avoir à le recompresser à chaque requête. + <p>Comme <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> recompresse le contenu demandé à + chaque requête, il est possible de gagner en performances en + précompressant ce contenu, et en forçant mod_deflate à servir ce + contenu précompressé sans avoir à le recompresser à chaque requête. Pour ce faire, utilisez une configuration du style :</p> <pre class="prettyprint lang-config"><IfModule mod_headers.c> - # Servir des fichiers CSS compressés avec gzip, s'ils existent, et + # Servir des fichiers CSS compressés avec gzip, s'ils existent, et # si le client accepte gzip. RewriteCond "%{HTTP:Accept-encoding}" "gzip" RewriteCond "%{REQUEST_FILENAME}\.gz" "-s" RewriteRule "^(.*)\.css" "$1\.css\.gz" [QSA] - # Servir des fichiers JS compressés avec gzip, s'ils existent, et + # Servir des fichiers JS compressés avec gzip, s'ils existent, et # si le client accepte gzip. RewriteCond "%{HTTP:Accept-encoding}" "gzip" RewriteCond "%{REQUEST_FILENAME}\.gz" "-s" RewriteRule "^(.*)\.js" "$1\.js\.gz" [QSA] - # Servir des types de contenus corrects, et empêcher mod_deflate + # Servir des types de contenus corrects, et empêcher mod_deflate # d'effectuer un double gzip. RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1] RewriteRule "\.js\.gz$" "-" [T=text/javascript,E=no-gzip:1] @@ -247,8 +247,8 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> # Servir le type de codage correct. Header append Content-Encoding gzip - # Force les mandataires à mettre en cache séparément les fichiers - # css/js gzippés & non gzippés. + # Force les mandataires à mettre en cache séparément les fichiers + # css/js gzippés & non gzippés. Header append Vary Accept-Encoding </FilesMatch> </IfModule></pre> @@ -258,36 +258,36 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-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="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>Comment l'en-tête sortant ETag doit être modifié au cours +<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#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>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> + 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>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> + <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>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> + <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>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> + <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> @@ -297,42 +297,42 @@ de la compression</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#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>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 + 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> + 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>Le niveau de compression que nous appliquons à la +<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#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>La directive <code class="directive">DeflateCompressionLevel</code> - permet de spécifier le niveau de compression à utiliser ; plus + 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 + sera aussi le temps CPU nécessaire pour effectuer le traitement.</p> - <p>La valeur doit être comprise entre 1 (compression minimale) et 9 + <p>La valeur doit être comprise entre 1 (compression minimale) et 9 (compression maximale).</p> </div> @@ -340,17 +340,17 @@ sortie</td></tr> <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>Enregistre le taux de compression sous la forme d'une note -à des fins de journalisation</td></tr> +à 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>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> + 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 @@ -358,14 +358,14 @@ sortie</td></tr> CustomLog "logs/deflate_log" deflate</pre> </div> - <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. + <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>Enregistre dans la note la taille en octets du flux en entrée + <dd>Enregistre dans la note la taille en octets du flux en entrée du filtre.</dd> <dt><code>Output</code></dt> @@ -373,15 +373,15 @@ sortie</td></tr> du filtre.</dd> <dt><code>Ratio</code></dt> - <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 + <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>Vous pouvez donc configurer votre journalisation de la manière + <p>Vous pouvez donc configurer votre journalisation de la manière suivante :</p> - <div class="example"><h3>Journalisation détaillée</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 @@ -397,99 +397,99 @@ CustomLog "logs/deflate_log" deflate</pre> <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>Taille maximale des corps de requête décompressés</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>Aucune limite, mais LimitRequestBody s'applique après la +<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#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_deflate</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 +<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>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> + 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>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#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#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#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>Disponible à partir de la version 2.4.10 du serveur HTTP +<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>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> + 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>Ratio de décompression maximum pour les corps de requêtes</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#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#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>Disponible à partir de la version 2.4.10 du serveur HTTP +<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>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 + 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> + 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>La quantité de mémoire utilisable par zlib pour la +<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#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>La directive <code class="directive">DeflateMemLevel</code> permet de - spécifier la quantité de mémoire utilisable par zlib pour la + 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>Taille de la fenêtre de compression zlib</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#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>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 + 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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_deflate.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_deflate.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_deflate.html" title="Français"> fr </a> | <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -510,7 +510,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_deflate.ht } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dialup.html b/docs/manual/mod/mod_dialup.html index 304290064a..ff40ffcb6e 100644 --- a/docs/manual/mod/mod_dialup.html +++ b/docs/manual/mod/mod_dialup.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dialup.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_dialup.html.fr b/docs/manual/mod/mod_dialup.html.fr index 4d68233e3d..23db1b8bf2 100644 --- a/docs/manual/mod/mod_dialup.html.fr +++ b/docs/manual/mod/mod_dialup.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,17 +27,17 @@ <div id="preamble"><h1>Module Apache mod_dialup</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dialup.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dialup.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_dialup.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Envoie le contenu statique avec une bande passante limitée -définie par les différents standards des anciens modems.</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dialup_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dialup.c</td></tr></table> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Envoie le contenu statique avec une bande passante limitée +définie par les différents standards des anciens modems.</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dialup_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dialup.c</td></tr></table> <h3>Sommaire</h3> <p>Il s'agit d'un module qui envoie le contenu statique avec une bande -passante limitée définie par les différents standards des anciens +passante limitée définie par les différents standards des anciens modems. Ainsi, il est possible de naviguer sur votre site avec un modem 56k V.92 en positionnant une configuration de ce type :</p> @@ -47,12 +47,12 @@ modems. Ainsi, il est possible de naviguer sur votre site avec un modem <p>Auparavant, pour faire des modules de limitation de bande passante, -il fallait monopoliser un thread, pour chaque client, et insérer des -temporisations pour diminuer la bande passante. Grâce à cette nouvelle -fonctionnalité, un gestionnaire peut recevoir les réponses à ses -callbacks après N millisecondes, et il sera invoqué par le module MPM -Event dans un thread différent à la fin du délai indiqué. À partir de ce -moment, le gestionnaire peut continuer à envoyer des données au +il fallait monopoliser un thread, pour chaque client, et insérer des +temporisations pour diminuer la bande passante. Grâce à cette nouvelle +fonctionnalité, un gestionnaire peut recevoir les réponses à ses +callbacks après N millisecondes, et il sera invoqué par le module MPM +Event dans un thread différent à la fin du délai indiqué. À partir de ce +moment, le gestionnaire peut continuer à envoyer des données au client.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -64,13 +64,13 @@ client.</p> <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>Standard de modem à simuler</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.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#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>Cette directive permet de spécifier le standard de modem que vous +<p>Cette directive permet de spécifier le standard de modem que vous souhaitez simuler.</p> <pre class="prettyprint lang-config"><Location "/mysite"> @@ -83,7 +83,7 @@ souhaitez simuler.</p> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dialup.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dialup.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_dialup.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -102,7 +102,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dialup.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dir.html b/docs/manual/mod/mod_dir.html index 4c66e6a467..ccc0e06ac6 100644 --- a/docs/manual/mod/mod_dir.html +++ b/docs/manual/mod/mod_dir.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dir.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_dir.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_dir.html.fr b/docs/manual/mod/mod_dir.html.fr index fa7687713d..bf7ae2d1aa 100644 --- a/docs/manual/mod/mod_dir.html.fr +++ b/docs/manual/mod/mod_dir.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,38 +27,38 @@ <div id="preamble"><h1>Module Apache mod_dir</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dir.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dir.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dir.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dir.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dir.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet la redirection des adresses se terminant par un -répertoire sans slash de fin et la mise à disposition des fichiers index -de répertoire</td></tr> +répertoire sans slash de fin et la mise à disposition des fichiers index +de répertoire</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dir_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dir.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dir_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dir.c</td></tr></table> <h3>Sommaire</h3> - <p>L'index d'un répertoire peut provenir de deux sources :</p> + <p>L'index d'un répertoire peut provenir de deux sources :</p> <ul> - <li>Un fichier écrit par l'utilisateur, dont le nom, en général - appelé <code>index.html</code>, peut être défini à l'aide de la + <li>Un fichier écrit par l'utilisateur, dont le nom, en général + appelé <code>index.html</code>, peut être défini à l'aide de la directive <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> fournie par le module <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>.</li> - <li>Un listing généré par le serveur, par l'intermédiaire du + <li>Un listing généré par le serveur, par l'intermédiaire du module <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>.</li> </ul> <p>Les deux fonctions sont bien distinctes, si bien que vous pouvez - supprimer (ou remplacer) la génération automatique d'index, si vous + supprimer (ou remplacer) la génération automatique d'index, si vous le souhaitez.</p> - <p>Une redirection "slash de fin" est effectuée lorsque le serveur - reçoit une requête pour une URL du style - <code>http://nom-serveur/foo/nom-rep</code> où <code>nom-rep</code> - est le nom d'un répertoire. Comme les répertoires nécessitent un slash de + <p>Une redirection "slash de fin" est effectuée lorsque le serveur + reçoit une requête pour une URL du style + <code>http://nom-serveur/foo/nom-rep</code> où <code>nom-rep</code> + est le nom d'un répertoire. Comme les répertoires nécessitent un slash de fin, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> effectue une redirection vers <code>http://nom-serveur/foo/nom-rep/</code>.</p> </div> @@ -75,104 +75,104 @@ de répertoire</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="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>Définit la réponse de ce module lorsqu'un autre -gestionnaire est utilisé</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#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>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> +<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>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 + 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 à + <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>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#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>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#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>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> + 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>Avec cette configuration, une requête pour l'URL + <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 + existe, ou provoquerait la génération du listing du répertoire si la ressource n'existe pas.</p> - <p>Notez qu'il n'est pas nécessaire que les documents soient - relatifs au répertoire ;</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>provoquerait l'exécution du script CGI + <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> + répertoire considéré.</p> - <p>La spécification du seul argument "disabled" empêche + <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>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 : + "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>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"># Exemple A: définit index.html comme page d'index, ainsi qu'index.php. + <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> -# Exemple B: identique à l'exemple A, mais avec une seule directive. +# Exemple B: identique à l'exemple A, mais avec une seule directive. <Directory "/foo"> DirectoryIndex index.html index.php </Directory> # 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 +# 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 @@ -186,33 +186,33 @@ client envoie une requête pour un répertoire</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="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>Définit une redirection externe pour les index de -répertoires. +<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> </code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DirectoryIndexRedirect 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#Default">Défaut:</a></th><td><code>DirectoryIndexRedirect 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>Disponible depuis la version 2.3.14</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>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 + <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>Les arguments acceptés sont :</p> + <p>Les arguments acceptés sont :</p> <ul> <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> + <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> @@ -220,7 +220,7 @@ répertoires. <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DirectoryIndexRedirect on</pre> </div> - <p>Une requête pour <code>http://example.com/docs/</code> se + <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> @@ -230,111 +230,111 @@ répertoires. <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>Activation/Désactivation de la redirection "slash de +<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#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#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>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> + 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>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 + <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>La requête de l'utilisateur contiendra finalement l'URL + <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 + <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>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> + 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"># voir l'avertissement de sécurité ci-dessous ! + <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>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ù + <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 + +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 + <code>index.html</code> ; <strong>par contre, une requête sans slash de fin afficherait un listing du contenu du - répertoire</strong>.</p> + répertoire</strong>.</p> </div> <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> + 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>Définit une URL par défaut pour les requêtes qui ne ciblent +<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#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>L'argument <code>disabled</code> est disponible depuis la +<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>Cette directive permet de définir un traitement pour toute URL - qui ne correspond à aucune ressource de votre système de fichiers, + <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>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>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> + 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>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> + 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> @@ -347,10 +347,10 @@ version 2.4.4 du serveur HTTP Apache</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dir.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dir.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dir.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dir.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_dir.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -369,7 +369,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dir.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_dumpio.html b/docs/manual/mod/mod_dumpio.html index 01af4cdcfc..a12bbebce4 100644 --- a/docs/manual/mod/mod_dumpio.html +++ b/docs/manual/mod/mod_dumpio.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_dumpio.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_dumpio.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_dumpio.html.fr b/docs/manual/mod/mod_dumpio.html.fr index ecebee8880..b7940aa580 100644 --- a/docs/manual/mod/mod_dumpio.html.fr +++ b/docs/manual/mod/mod_dumpio.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,26 +27,26 @@ <div id="preamble"><h1>Module Apache mod_dumpio</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dumpio.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dumpio.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dumpio.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Enregistre toutes les entrées/sorties dans le journal des -erreurs de la manière souhaitée.</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Enregistre toutes les entrées/sorties dans le journal des +erreurs de la manière souhaitée.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dumpio_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dumpio.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dumpio_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dumpio.c</td></tr></table> <h3>Sommaire</h3> - <p><code>mod_dumpio</code> permet d'enregistrer toutes les entrées - reçues par Apache et/ou toutes les sorties envoyées par ce dernier + <p><code>mod_dumpio</code> permet d'enregistrer toutes les entrées + reçues par Apache et/ou toutes les sorties envoyées par ce dernier dans le fichier error.log. </p> - <p>L'enregistrement des données s'effectue juste après - le décodage SSL (pour les entrées), et juste avant le codage SSL (pour les - sorties). Comme on peut s'y attendre, tout ceci peut représenter un - volume important de données, et ne doit être - utilisé qu'à des fins de débogage.</p> + <p>L'enregistrement des données s'effectue juste après + le décodage SSL (pour les entrées), et juste avant le codage SSL (pour les + sorties). Comme on peut s'y attendre, tout ceci peut représenter un + volume important de données, et ne doit être + utilisé qu'à des fins de débogage.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -62,27 +62,27 @@ erreurs de la manière souhaitée.</td></tr> <h2><a name="enable" id="enable">Activation du support dumpio</a></h2> - <p>Pour activer le module, ce dernier doit être compilé et chargé - par l'intermédiaire de la configuration de votre instance d'Apache. - La journalisation peut ensuite être activée ou - désactivée séparément - pour les entrées et sorties à l'aide des directives ci-dessous. En - outre, <code class="module"><a href="../mod/mod_dumpio.html">mod_dumpio</a></code> doit être configuré à <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> <code>trace7</code> :</p> + <p>Pour activer le module, ce dernier doit être compilé et chargé + par l'intermédiaire de la configuration de votre instance d'Apache. + La journalisation peut ensuite être activée ou + désactivée séparément + pour les entrées et sorties à l'aide des directives ci-dessous. En + outre, <code class="module"><a href="../mod/mod_dumpio.html">mod_dumpio</a></code> doit être configuré à <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> <code>trace7</code> :</p> <pre class="prettyprint lang-config">LogLevel dumpio:trace7</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="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>Enregistre toutes les entrées dans le journal des +<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#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>Active la journalisation de toutes les entrées.</p> + <p>Active la journalisation de toutes les entrées.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DumpIOInput On</pre> </div> @@ -94,7 +94,7 @@ erreurs</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#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> @@ -108,7 +108,7 @@ erreurs</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dumpio.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_dumpio.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_dumpio.html" title="Français"> fr </a> | <a href="../ja/mod/mod_dumpio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -128,7 +128,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dumpio.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_echo.html b/docs/manual/mod/mod_echo.html index c10e97b491..3d4f463fcf 100644 --- a/docs/manual/mod/mod_echo.html +++ b/docs/manual/mod/mod_echo.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_echo.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_echo.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_echo.html.fr b/docs/manual/mod/mod_echo.html.fr index 239ad149ef..0b53bdb1e9 100644 --- a/docs/manual/mod/mod_echo.html.fr +++ b/docs/manual/mod/mod_echo.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,19 +27,19 @@ <div id="preamble"><h1>Module Apache mod_echo</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_echo.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | <a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Un simple serveur d'écho pour illustrer les modules de +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Un simple serveur d'écho pour illustrer les modules de protocole</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>echo_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_echo.c</td></tr></table> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>echo_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_echo.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module est un module de protocole exemple permettant d'en - illustrer le concept. Il fournit un simple serveur d'écho. Envoyez + illustrer le concept. Il fournit un simple serveur d'écho. Envoyez lui une phrase par telnet, et il vous la renverra.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -51,15 +51,15 @@ protocole</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="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>Active ou désactive le serveur d'écho</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#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#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>La directive <code class="directive">ProtocolEcho</code> permet d'activer - ou de désactiver le serveur d'écho.</p> + ou de désactiver le serveur d'écho.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProtocolEcho On</pre> </div> @@ -68,7 +68,7 @@ protocole</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_echo.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | <a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -89,7 +89,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_echo.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_env.html b/docs/manual/mod/mod_env.html index 98ef2d976a..c1e4505ae7 100644 --- a/docs/manual/mod/mod_env.html +++ b/docs/manual/mod/mod_env.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_env.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_env.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_env.html.fr b/docs/manual/mod/mod_env.html.fr index c37f52a093..542b4d76aa 100644 --- a/docs/manual/mod/mod_env.html.fr +++ b/docs/manual/mod/mod_env.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,26 +27,26 @@ <div id="preamble"><h1>Module Apache mod_env</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_env.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | <a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Modifie l'environnement transmis aux scripts CGI et aux pages SSI</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>env_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_env.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>env_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_env.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet de contrôler les variables d'environnement - internes utilisées par divers modules du serveur HTTP Apache. Ces + <p>Ce module permet de contrôler les variables d'environnement + internes utilisées par divers modules du serveur HTTP Apache. Ces variables sont aussi accessibles aux scripts CGI en tant que - variables d'environnement système natives, et disponibles dans les + variables d'environnement système natives, et disponibles dans les pages SSI. Les variables d'environnement peuvent - être transmises depuis le shell qui a lancé le processus - <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Elles peuvent également être définies ou - supprimées au cours du processus de configuration.</p> + être transmises depuis le shell qui a lancé le processus + <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Elles peuvent également être définies ou + supprimées au cours du processus de configuration.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> @@ -67,17 +67,17 @@ pages SSI</td></tr> 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#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>Cette directive permet de spécifier quelles variables - d'environnement système natives doivent être disponibles en tant que + <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> + 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>Exemple</h3><pre class="prettyprint lang-config">PassEnv LD_LIBRARY_PATH</pre> </div> @@ -86,14 +86,14 @@ shell</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="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>Définit des variables d'environnement</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#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>Définit une variable d'environnement interne, cette dernière étant + <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> @@ -101,16 +101,16 @@ shell</td></tr> </div> <p>Si l'argument <var>valeur</var> est absent, la variable est - définie à la valeur d'une chaîne vide.</p> + définie à la valeur d'une chaîne vide.</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 + <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 + 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> @@ -126,7 +126,7 @@ shell</td></tr> <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#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> @@ -141,10 +141,10 @@ shell</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_env.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | <a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -163,7 +163,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_env.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_example_hooks.html b/docs/manual/mod/mod_example_hooks.html index c823e0d60f..f877c4e0fd 100644 --- a/docs/manual/mod/mod_example_hooks.html +++ b/docs/manual/mod/mod_example_hooks.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_example_hooks.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_example_hooks.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_example_hooks.html.fr b/docs/manual/mod/mod_example_hooks.html.fr index 6d018a04eb..55c20d7339 100644 --- a/docs/manual/mod/mod_example_hooks.html.fr +++ b/docs/manual/mod/mod_example_hooks.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,31 +27,31 @@ <div id="preamble"><h1>Module Apache mod_example_hooks</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_example_hooks.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_example_hooks.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_example_hooks.html" title="Français"> fr </a> | <a href="../ko/mod/mod_example_hooks.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Illustration de l'API des modules Apache</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>example_hooks_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_example_hooks.c</td></tr></table> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>example_hooks_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_example_hooks.c</td></tr></table> <h3>Sommaire</h3> - <p>Certains fichiers situés dans le répertoire + <p>Certains fichiers situés dans le répertoire <code>modules/examples</code> de l'arborescence de la - distribution d'Apache sont fournis à titre d'exemples pour ceux qui - souhaitent écrire des modules qui utilisent l'API d'Apache.</p> + distribution d'Apache sont fournis à titre d'exemples pour ceux qui + souhaitent écrire des modules qui utilisent l'API d'Apache.</p> <p>Le fichier principal est <code>mod_example_hooks.c</code>, qui - constitue une illustration exhaustive des différents mécanismes et - syntaxes d'appels. En aucun cas un module additionnel n'aura à - inclure des routines pour tous les appels - il n'en nécessitera au + constitue une illustration exhaustive des différents mécanismes et + syntaxes d'appels. En aucun cas un module additionnel n'aura à + inclure des routines pour tous les appels - il n'en nécessitera au contraire qu'un petit nombre !</p> - <p>Le module example_hooks fonctionne réellement. Si vous le chargez dans + <p>Le module example_hooks fonctionne réellement. Si vous le chargez dans votre serveur, activez le gestionnaire "example-hooks-handler" dans une - section location, et essayez d'accéder à la zone du site web + section location, et essayez d'accéder à la zone du site web correspondante, vous verrez s'afficher certaines sorties que le - module example_hooks produit au cours des différents appels.</p> + module example_hooks produit au cours des différents appels.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -68,13 +68,13 @@ <h2><a name="compiling" id="compiling">Compilation du module example_hooks</a></h2> <p>Pour inclure le module example_hooks dans votre serveur, effectuez les - étapes suivantes :</p> + étapes suivantes :</p> <ol> - <li>Exécutez <code class="program"><a href="../programs/configure.html">configure</a></code> avec l'option + <li>Exécutez <code class="program"><a href="../programs/configure.html">configure</a></code> avec l'option <code>--enable-example-hooks</code>.</li> - <li>Compilez le serveur (exécutez la commande + <li>Compilez le serveur (exécutez la commande "<code>make</code>").</li> </ol> @@ -86,35 +86,35 @@ <li>Modifiez le fichier.</li> - <li>Créez <code>modules/nouveau_module/config.m4</code>. + <li>Créez <code>modules/nouveau_module/config.m4</code>. <ol> <li>Ajoutez <code>APACHE_MODPATH_INIT(nouveau_module)</code>.</li> <li>Copiez la ligne APACHE_MODULE contenant "example_hooks" depuis <code>modules/examples/config.m4</code>.</li> <li>Remplacez le premier argument "example-hooks" par <em>monexemple</em>.</li> - <li>Remplacez le second argument par une brève description de - votre module. Cette description sera utilisée par la commande + <li>Remplacez le second argument par une brève description de + votre module. Cette description sera utilisée par la commande <code>configure --help</code>.</li> - <li>Si la compilation de votre module nécessite des drapeaux - de compilation C, des drapeaux d'édition de liens, ou de - bibliothèques supplémentaires, ajoutez les respectivement à + <li>Si la compilation de votre module nécessite des drapeaux + de compilation C, des drapeaux d'édition de liens, ou de + bibliothèques supplémentaires, ajoutez les respectivement à CFLAGS, LDFLAGS et LIBS. Reportez-vous aux fichiers - <code>config.m4</code> des répertoires des autres modules pour + <code>config.m4</code> des répertoires des autres modules pour plus d'exemples.</li> <li>Ajoutez <code>APACHE_MODPATH_FINISH</code>.</li> </ol> </li> - <li>Créez le fichier + <li>Créez le fichier <code>module/nouveau_module/Makefile.in</code>. - Si la compilation de votre module ne nécessite pas d'instructions - particulières, ce fichier ne doit contenir que la ligne + Si la compilation de votre module ne nécessite pas d'instructions + particulières, ce fichier ne doit contenir que la ligne <code>include $(top_srcdir)/build/special.mk</code>.</li> - <li>Exécutez ./buildconf à la racine du répertoire.</li> + <li>Exécutez ./buildconf à la racine du répertoire.</li> - <li>Compilez le serveur après avoir exécuté la commande configure + <li>Compilez le serveur après avoir exécuté la commande configure avec l'option --enable-monexemple.</li> </ol> @@ -123,7 +123,7 @@ <h2><a name="using" id="using">Utilisation du module <code>mod_example_hooks</code></a></h2> - <p>Pour activer le module example_hooks, ajoutez à votre fichier + <p>Pour activer le module example_hooks, ajoutez à votre fichier <code>httpd.conf</code> un bloc du style :</p> <pre class="prettyprint lang-config"><Location "/example-hooks-info"> SetHandler example-hooks-handler @@ -131,34 +131,34 @@ <p>Vous pouvez aussi ajouter ce qui suit dans un fichier <a href="core.html#accessfilename"><code>.htaccess</code></a>, puis - accéder au fichier "test.example" à partir du répertoire + accéder au fichier "test.example" à partir du répertoire correspondant :</p> <pre class="prettyprint lang-config">AddHandler example-hooks-handler .example</pre> - <p>Après avoir rechargé la configuration ou redémarré votre serveur, - vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui - a été décrit plus haut.</p> + <p>Après avoir rechargé la configuration ou redémarré votre serveur, + vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui + a été décrit 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="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>Directive de démonstration pour illustrer l'API des modules +<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#Status">Statut:</a></th><td>Expérimental</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_example_hooks</td></tr> </table> <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 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 + 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> @@ -166,7 +166,7 @@ Apache</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_example_hooks.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_example_hooks.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_example_hooks.html" title="Français"> fr </a> | <a href="../ko/mod/mod_example_hooks.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -186,7 +186,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_example_ho } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_expires.html b/docs/manual/mod/mod_expires.html index 81ce3d4278..fda0d45805 100644 --- a/docs/manual/mod/mod_expires.html +++ b/docs/manual/mod/mod_expires.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_expires.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_expires.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_expires.html.fr b/docs/manual/mod/mod_expires.html.fr index 537c803e9e..8a7ccc5703 100644 --- a/docs/manual/mod/mod_expires.html.fr +++ b/docs/manual/mod/mod_expires.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,46 +27,46 @@ <div id="preamble"><h1>Module Apache mod_expires</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_expires.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_expires.html" title="Français"> fr </a> | <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Génération des en-têtes HTTP <code>Expires</code> et -<code>Cache-Control</code> en fonction de critères spécifiés par +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Génération des en-têtes HTTP <code>Expires</code> et +<code>Cache-Control</code> en fonction de critères spécifiés par l'utilisateur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>expires_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_expires.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>expires_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_expires.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet de contrôler la définition de l'en-tête HTTP + <p>Ce module permet de contrôler la définition de l'en-tête HTTP <code>Expires</code> et la directive <code>max-age</code> de - l'en-tête HTTP <code>Cache-Control</code> dans les réponses du - serveur. La date d'expiration peut être définie soit par rapport à - la date de dernière modification du fichier source, soit - par rapport à l'heure d'accès du client.</p> + l'en-tête HTTP <code>Cache-Control</code> dans les réponses du + serveur. La date d'expiration peut être définie soit par rapport à + la date de dernière modification du fichier source, soit + par rapport à l'heure d'accès du client.</p> - <p>Ces en-têtes HTTP permettent d'informer le client quant à la - validité et à la persistence du document. S'il est présent dans le - cache, et tant qu'il n'est pas arrivé à expiration, le document sera - servi à partir de ce dernier, plutôt qu'à partir du document source. - Après expiration, la copie du document dans le cache sera considérée - comme "expirée" et donc invalide, et une nouvelle copie devra être - obtenue à partir du document source.</p> + <p>Ces en-têtes HTTP permettent d'informer le client quant à la + validité et à la persistence du document. S'il est présent dans le + cache, et tant qu'il n'est pas arrivé à expiration, le document sera + servi à partir de ce dernier, plutôt qu'à partir du document source. + Après expiration, la copie du document dans le cache sera considérée + comme "expirée" et donc invalide, et une nouvelle copie devra être + obtenue à partir du document source.</p> - <p>Pour modifier les directives de contrôle du cache autres + <p>Pour modifier les directives de contrôle du cache autres que <code>max-age</code> (voir la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC 2616 section 14.9</a>), vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>.</p> - <p>Lorsque l'en-tête <code>Expires</code> est déjà présent dans la - réponse générée par le serveur, par exemple s'il a été créé par un + <p>Lorsque l'en-tête <code>Expires</code> est déjà présent dans la + réponse générée par le serveur, par exemple s'il a été créé par un script CGI ou un serveur original via un serveur mandataire, ce - module n'ajoute aucun en-tête <code>Expires</code> ou + module n'ajoute aucun en-tête <code>Expires</code> ou <code>Cache-Control</code>.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de définition de +<li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de définition de l'intervalle</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -77,7 +77,7 @@ l'intervalle</a></li> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="AltSyn" id="AltSyn">Autre syntaxe de définition de +<h2><a name="AltSyn" id="AltSyn">Autre syntaxe de définition de l'intervalle</a></h2> <p>Pour une syntaxe plus lisible, on peut aussi utiliser les directives <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> et <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> comme suit :</p> @@ -86,20 +86,20 @@ l'intervalle</a></h2> ExpiresByType type/encoding "<var>base</var> [plus <var>num</var> <var>type</var>] [<var>num</var> <var>type</var>] ..."</pre> - <p>où <var>base</var> peut être :</p> + <p>où <var>base</var> peut être :</p> <ul> <li><code>access</code></li> - <li><code>now</code> (équivalent à + <li><code>now</code> (équivalent à '<code>access</code>')</li> <li><code>modification</code></li> </ul> - <p>Le mot-clé <code>plus</code> est optionnel. <var>num</var> doit - correspondre à une valeur entière [compatible avec - <code>atoi()</code>], et <var>type</var> peut être choisi parmi :</p> + <p>Le mot-clé <code>plus</code> est optionnel. <var>num</var> doit + correspondre à une valeur entière [compatible avec + <code>atoi()</code>], et <var>type</var> peut être choisi parmi :</p> <ul> <li><code>years</code></li> @@ -111,144 +111,144 @@ ExpiresByType type/encoding "<var>base</var> [plus <var>num</var> <var>type</va <li><code>seconds</code></li> </ul> - <p>Par exemple, pour faire expirer par défaut les documents 1 mois - après leur accès, on peut utiliser une des directives suivantes :</p> + <p>Par exemple, pour faire expirer par défaut les documents 1 mois + après leur accès, on peut utiliser une des directives suivantes :</p> <pre class="prettyprint lang-config">ExpiresDefault "access plus 1 month" ExpiresDefault "access plus 4 weeks" ExpiresDefault "access plus 30 days"</pre> - <p>La date d'expiration peut être définie plus précisément en + <p>La date d'expiration peut être définie plus précisément en ajoutant plusieurs clauses '<var>num</var> <var>type</var>' :</p> <pre class="prettyprint lang-config">ExpiresByType text/html "access plus 1 month 15 days 2 hours" ExpiresByType image/gif "modification plus 5 hours 3 minutes"</pre> - <p>Notez que si vous utilisez une configuration basée sur la date de - modification, l'en-tête Expires ne sera pas ajouté à un contenu qui + <p>Notez que si vous utilisez une configuration basée sur la date de + modification, l'en-tête Expires ne sera pas ajouté à un contenu qui ne provient pas directement d'un fichier sur disque ; et ceci tout - simplement parce que ce type de contenu ne possède pas de date de + simplement parce que ce type de contenu ne possède pas de date de modification.</p> </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>Active la génération d'en-têtes +<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#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#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>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 + <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 + 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 + 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>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> + <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>Définition de la valeur de l'en-tête <code>Expires</code> +<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#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>Cette directive permet de définir la valeur de l'en-tête + <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 + 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 + date de la requête de la date d'expiration et s'exprime en secondes.</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> + <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 + 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 + où le client a accédé au document qui doit être utilisé comme temps de base.</p> - <p>La différence d'effet est subtile. Si on utilise <code>M</code>, + <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 + 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 + 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>Exemple :</h3><pre class="prettyprint lang-config"># active la génération des en-têtes Expires + <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config"># active la génération des en-têtes Expires ExpiresActive On # les images GIF expirent au bout d'un mois dans le cache du # client ExpiresByType image/gif A2592000 -# les documents HTML restent valables une semaine après leur date -# de dernière modification +# les documents HTML restent valables une semaine après leur date +# de dernière modification ExpiresByType text/html M604800</pre> </div> <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> + <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>Vous pouvez aussi définir le mode de calcul de la date + <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> + 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>Mode de calcul par défaut de la date +<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#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>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 + <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 + 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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_expires.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_expires.html" title="Français"> fr </a> | <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -269,7 +269,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_expires.ht } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_ext_filter.html b/docs/manual/mod/mod_ext_filter.html index 4d0b1e3e8d..f185ab9ec8 100644 --- a/docs/manual/mod/mod_ext_filter.html +++ b/docs/manual/mod/mod_ext_filter.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_ext_filter.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_ext_filter.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_ext_filter.html.fr b/docs/manual/mod/mod_ext_filter.html.fr index 3c1c170864..4eefe8452e 100644 --- a/docs/manual/mod/mod_ext_filter.html.fr +++ b/docs/manual/mod/mod_ext_filter.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,38 +27,38 @@ <div id="preamble"><h1>Module Apache mod_ext_filter</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ext_filter.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ext_filter.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_ext_filter.html" title="Français"> fr </a> | <a href="../ja/mod/mod_ext_filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ext_filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fait traiter le corps de la réponse par un programme +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fait traiter le corps de la réponse par un programme externe avant de l'envoyer au client</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ext_filter_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_ext_filter.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ext_filter_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_ext_filter.c</td></tr></table> <h3>Sommaire</h3> - <p><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> représente un modèle de + <p><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> représente un modèle de programmation simple et bien connu pour les <a href="../filter.html">filtres</a>. Avec ce module, tout programme - qui lit l'entrée standard stdin et écrit sur la sortie standard + qui lit l'entrée standard stdin et écrit sur la sortie standard stdout (autrement dit une commande filtre de style Unix) peut - servir de filtre pour Apache. Ce mécanisme de filtrage est beaucoup - plus lent qu'un filtre spécialement écrit pour - l'API d'Apache et faisant partie intégrante du processus du serveur - Apache, mais il présente les avantages suivants :</p> + servir de filtre pour Apache. Ce mécanisme de filtrage est beaucoup + plus lent qu'un filtre spécialement écrit pour + l'API d'Apache et faisant partie intégrante du processus du serveur + Apache, mais il présente les avantages suivants :</p> <ul> - <li>le modèle de programmation est beaucoup plus simple</li> + <li>le modèle de programmation est beaucoup plus simple</li> - <li>tout langage de script ou de programmation peut être utilisé, - pourvu qu'il permette au programme de lire l'entrée standard et - d'écrire sur la sortie standard.</li> + <li>tout langage de script ou de programmation peut être utilisé, + pourvu qu'il permette au programme de lire l'entrée standard et + d'écrire sur la sortie standard.</li> <li>on peut utiliser des programmes existants comme filtres Apache sans modification.</li> </ul> - <p>Même dans le cas où le niveau de performance est insuffisant pour + <p>Même dans le cas où le niveau de performance est insuffisant pour une utilisation en production, on peut utiliser <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> comme prototype d'environnement pour les filtres.</p> @@ -80,13 +80,13 @@ externe avant de l'envoyer au client</td></tr> <div class="section"> <h2><a name="examples" id="examples">Exemples</a></h2> - <h3>Générer du HTML à partir d'un autre type de + <h3>Générer du HTML à partir d'un autre type de contenu</h3> - <pre class="prettyprint lang-config"># la directive de mod_ext_filter définissant un filtre + <pre class="prettyprint lang-config"># la directive de mod_ext_filter définissant un filtre # permettant de mettre des fichiers text/c au format HTML en # utilisant le programme externe /usr/bin/enscript, le type du -# fichier résultant étant défini à text/html +# fichier résultant étant défini à text/html ExtFilterDefine c-to-html mode=output \ intype=text/c outtype=text/html \ cmd="/usr/bin/enscript --color -W html -Ec -o - -" @@ -96,21 +96,21 @@ ExtFilterDefine c-to-html mode=output \ # nouveau filtre SetOutputFilter c-to-html - # directive de mod_mime définissant le type des fichiers dont - # le nom possède l'extension .c à text/c + # directive de mod_mime définissant le type des fichiers dont + # le nom possède l'extension .c à text/c AddType text/c .c </Directory></pre> - <h3>Implémentation d'un filtre de codage de + <h3>Implémentation d'un filtre de codage de contenu</h3> - <p>Note : cet exemple avec gzip n'est fourni qu'à titre - d'illustration. Veuillez vous reporter à la documentation de - <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> pour un exemple d'implémentation plus + <p>Note : cet exemple avec gzip n'est fourni qu'à titre + d'illustration. Veuillez vous reporter à la documentation de + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> pour un exemple d'implémentation plus pratique.</p> - <pre class="prettyprint lang-config"># la directive de mod_ext_filter qui définit le filtre externe + <pre class="prettyprint lang-config"># la directive de mod_ext_filter qui définit le filtre externe ExtFilterDefine gzip mode=output cmd=/bin/gzip <Location "/gzipped"> @@ -120,7 +120,7 @@ ExtFilterDefine gzip mode=output cmd=/bin/gzip SetOutputFilter gzip # la directive de mod_headers permettant d'ajouter le champ - # d'en-tête "Content-Encoding: gzip" + # d'en-tête "Content-Encoding: gzip" Header set Content-Encoding gzip </Location></pre> @@ -128,10 +128,10 @@ ExtFilterDefine gzip mode=output cmd=/bin/gzip <h3>Ralentissement du serveur</h3> - <pre class="prettyprint lang-config"># directive de mod_ext_filter définissant un filtre qui fait + <pre class="prettyprint lang-config"># directive de mod_ext_filter définissant un filtre qui fait # passer tous les flux en sortie par la commande cat ; cat ne # modifie rien ; elle ne fait que compliquer le cheminement des -# flux et consommer des ressources supplémentaires +# flux et consommer des ressources supplémentaires ExtFilterDefine slowdown mode=output cmd=/bin/cat \ ExtFilterDefine slowdown mode=output cmd=/bin/cat \ preservescontentlength @@ -146,10 +146,10 @@ ExtFilterDefine slowdown mode=output cmd=/bin/cat \ <h3>Utilisation de sed pour remplacer du texte dans la - réponse</h3> + réponse</h3> - <pre class="prettyprint lang-config"># directive de mod_ext_filter définissant un filtre qui -# remplace du texte dans la réponse + <pre class="prettyprint lang-config"># directive de mod_ext_filter définissant un filtre qui +# remplace du texte dans la réponse # ExtFilterDefine fixtext mode=output intype=text/html \ cmd="/bin/sed s/verdana/arial/g" @@ -163,15 +163,15 @@ ExtFilterDefine fixtext mode=output intype=text/html \ <div class="note"> <p>Vous pouvez aussi utiliser <code class="module"><a href="../mod/mod_substitute.html">mod_substitute</a></code> pour -effectuer le même traitement sans avoir à invoquer un programme +effectuer le même traitement sans avoir à invoquer un programme externe.</p> </div> <h3>Tracer un autre filtre</h3> - <pre class="prettyprint lang-config"># Trace les données lues et écrites par mod_deflate pour un -# client particulier (IP 192.168.1.31) qui a des problèmes de + <pre class="prettyprint lang-config"># Trace les données lues et écrites par mod_deflate pour un +# client particulier (IP 192.168.1.31) qui a des problèmes de # compression. # Ce premier filtre va tracer ce qui entre dans mod_deflate. ExtFilterDefine tracebefore \ @@ -179,12 +179,12 @@ ExtFilterDefine tracebefore \ EnableEnv=trace_this_client # Ce second filtre va tracer ce qui sort de mod_deflate. -# Notez que sans le paramètre ftype, le type de filtre par -# défaut AP_FTYPE_RESOURCE placerait le filtre *avant* -# mod_deflate dans la chaîne de filtrage. Le fait d'affecter -# à ce paramètre une valeur numérique sensiblement supérieure à +# Notez que sans le paramètre ftype, le type de filtre par +# défaut AP_FTYPE_RESOURCE placerait le filtre *avant* +# mod_deflate dans la chaîne de filtrage. Le fait d'affecter +# à ce paramètre une valeur numérique sensiblement supérieure à # AP_FTYPE_CONTENT_SET permet de s'assurer que le filtre sera -# placé après mod_deflate. +# placé après mod_deflate. ExtFilterDefine traceafter \ cmd="/bin/tracefilter.pl /tmp/traceafter" \ EnableEnv=trace_this_client ftype=21 @@ -195,7 +195,7 @@ ExtFilterDefine traceafter \ </Directory></pre> - <div class="example"><h3>Voici le filtre qui trace les données :</h3><pre class="prettyprint lang-perl">#!/usr/local/bin/perl -w + <div class="example"><h3>Voici le filtre qui trace les données :</h3><pre class="prettyprint lang-perl">#!/usr/local/bin/perl -w use strict; open(SAVE, ">$ARGV[0]") @@ -213,100 +213,100 @@ close(SAVE);</pre> <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>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#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>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 + 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> + <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>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 + <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 + 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> + DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également + définies pour le programme.</dd> <dt><code>mode=<var>mode</var></code></dt> - <dd>Utilisez <code>mode=output</code> (valeur par défaut) pour les - filtres qui traitent les réponses. Utilisez + <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 + requêtes. <code>mode=input</code> est disponible depuis la version 2.1 d'Apache.</dd> <dt><code>intype=<var>type MIME</var></code></dt> - <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> + <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>type MIME</var></code></dt> - <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> + <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>Le mot-clé <code>PreservesContentLength</code> indique que le + <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 + 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>type de filtre</var></code></dt> - <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 + <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> + 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>Ce paramètre spécifie le nom d'une variable - d'environnement qui, si elle est définie, va désactiver le + <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>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> + <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> @@ -316,44 +316,44 @@ close(SAVE);</pre> <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#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>La directive <code class="directive">ExtFilterOptions</code> - spécifie des options de traitement particulières pour + 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>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 + <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>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 + <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>Les messages envoyés vers la sortie d'erreurs standard du filtre - seront enregistrés dans le journal des erreurs d'Apache.</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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ext_filter.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ext_filter.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_ext_filter.html" title="Français"> fr </a> | <a href="../ja/mod/mod_ext_filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ext_filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -374,7 +374,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_ext_filter } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_file_cache.html b/docs/manual/mod/mod_file_cache.html index 5707262c77..9562d986d2 100644 --- a/docs/manual/mod/mod_file_cache.html +++ b/docs/manual/mod/mod_file_cache.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_file_cache.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_file_cache.html.ko.euc-kr Content-Language: ko diff --git a/docs/manual/mod/mod_file_cache.html.fr b/docs/manual/mod/mod_file_cache.html.fr index 9eba0a4ac6..8f770f0a42 100644 --- a/docs/manual/mod/mod_file_cache.html.fr +++ b/docs/manual/mod/mod_file_cache.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,43 +27,43 @@ <div id="preamble"><h1>Module Apache mod_file_cache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_file_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_file_cache.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_file_cache.html" title="Français"> fr </a> | <a href="../ko/mod/mod_file_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Mise en cache mémoire d'une liste statique de +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Mise en cache mémoire d'une liste statique de fichiers</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>file_cache_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_file_cache.c</td></tr></table> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>file_cache_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_file_cache.c</td></tr></table> <h3>Sommaire</h3> <div class="warning"> - Ce module doit être utilisé avec précautions. Il est recommandé de + Ce module doit être utilisé avec précautions. Il est recommandé de lire attentivement ce document, car une mauvaise utilisation de - <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> peut facilement conduire à la - création d'un site inopérant. + <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> peut facilement conduire à la + création d'un site inopérant. </div> - <p>La mise en cache de fichiers souvent demandés mais rarement - modifiés est une technique qui peut réduire la charge du + <p>La mise en cache de fichiers souvent demandés mais rarement + modifiés est une technique qui peut réduire la charge du serveur. <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> met en oeuvre deux techniques de mise en cache de fichiers <em>statiques</em> - fréquemment demandés. Des directives de configuration vous - permettent d'indiquer à <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> soit - d'ouvrir et de charger une image en mémoire d'un fichier avec - <code>mmap()</code>, soit de pré-ouvrir un fichier et de maintenir en + fréquemment demandés. Des directives de configuration vous + permettent d'indiquer à <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> soit + d'ouvrir et de charger une image en mémoire d'un fichier avec + <code>mmap()</code>, soit de pré-ouvrir un fichier et de maintenir en service le <em>gestionnaire</em> du fichier. Chacune de ces techniques - amène à réduire la charge du serveur lors du traitement des - requêtes concernant ces fichiers, en accomplissant une partie du - travail nécessaire à la mise à disposition de ces fichiers (en - particulier les opérations d'entrées/sorties sur les fichiers) au - démarrage du serveur, plutôt qu'au cours de chaque requête.</p> + amène à réduire la charge du serveur lors du traitement des + requêtes concernant ces fichiers, en accomplissant une partie du + travail nécessaire à la mise à disposition de ces fichiers (en + particulier les opérations d'entrées/sorties sur les fichiers) au + démarrage du serveur, plutôt qu'au cours de chaque requête.</p> - <p>Note : ces techniques sont inutilisables pour accélérer des + <p>Note : ces techniques sont inutilisables pour accélérer des programmes CGI ou d'autres fichiers servis par des gestionnaires de - contenu spéciaux. Elles ne peuvent être utilisées que pour des - fichiers standards en général servis par le gestionnaire de contenu + contenu spéciaux. Elles ne peuvent être utilisées que pour des + fichiers standards en général servis par le gestionnaire de contenu de base d'Apache.</p> <p>Ce module est une extension et s'inspire fortement du module @@ -82,77 +82,77 @@ fichiers</td></tr> <div class="section"> <h2><a name="using" id="using">Utilisation de mod_file_cache</a></h2> - <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> gère la mise en cache d'une liste - de fichiers définie de manière statique via une des directives + <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> gère la mise en cache d'une liste + de fichiers définie de manière statique via une des directives <code class="directive"><a href="#mmapfile">MMapFile</a></code> ou <code class="directive"><a href="#cachefile">CacheFile</a></code> au niveau de la configuration du serveur principal.</p> - <p>Les deux directives ne sont pas supportées par toutes les + <p>Les deux directives ne sont pas supportées par toutes les plates-formes. Par exemple, Apache pour Windows ne supporte pas actuellement la directive <code class="directive"><a href="#mmapfile">MMapFile</a></code>, alors que d'autres plates-formes, comme AIX, supportent les deux. Vous recevrez un message d'erreur dans le journal des erreurs du serveur si vous - essayez d'utiliser une directive non supportée. Si vous utilisez une - directive non supportée, le serveur démarrera, mais les fichiers ne + essayez d'utiliser une directive non supportée. Si vous utilisez une + directive non supportée, le serveur démarrera, mais les fichiers ne seront pas mis en cache. Sur les plates-formes qui supportent les - deux directives, vous devez faire des essais afin de déterminer + deux directives, vous devez faire des essais afin de déterminer quelle directive vous convient le mieux.</p> <h3>Directive MMapFile</h3> <p>La directive <code class="directive"><a href="#mmapfile">MMapFile</a></code> du module - <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> permet de transférer en mémoire - une liste statique de fichiers à l'aide de l'appel système - <code>mmap()</code>. Cet appel système est disponible sur la + <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> permet de transférer en mémoire + une liste statique de fichiers à l'aide de l'appel système + <code>mmap()</code>. Cet appel système est disponible sur la plupart des plates-formes de style Unix, mais pas sur toutes. Il - existe parfois des limites spécifiques au système quant à la - taille et au nombre de fichiers qui peuvent être - <code>mmap()</code>és, et l'expérimentation est probablement la - méthode la plus simple pour déterminer ces limites.</p> + existe parfois des limites spécifiques au système quant à la + taille et au nombre de fichiers qui peuvent être + <code>mmap()</code>és, et l'expérimentation est probablement la + méthode la plus simple pour déterminer ces limites.</p> - <p>Ce <code>mmap()</code>age n'est effectué qu'une seul fois au - démarrage ou redémarrage du serveur. Ainsi, chaque fois qu'un des - fichiers chargés en mémoire est modifié au niveau du système de - fichiers, vous <em>devez</em> redémarrer le serveur (voir la - documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>). Pour bien - insister sur ce point, si des fichiers sont modifiés <em>sur - disque</em>, et si vous ne redémarrez pas le serveur, vous allez - finir par servir des contenus complètement obsolètes. Vous devez - mettre à jour les fichiers en renommant l'ancienne version et en + <p>Ce <code>mmap()</code>age n'est effectué qu'une seul fois au + démarrage ou redémarrage du serveur. Ainsi, chaque fois qu'un des + fichiers chargés en mémoire est modifié au niveau du système de + fichiers, vous <em>devez</em> redémarrer le serveur (voir la + documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>). Pour bien + insister sur ce point, si des fichiers sont modifiés <em>sur + disque</em>, et si vous ne redémarrez pas le serveur, vous allez + finir par servir des contenus complètement obsolètes. Vous devez + mettre à jour les fichiers en renommant l'ancienne version et en enregistrant la nouvelle sur disque. Pour y parvenir, on peut utiliser des outils comme <code>rdist</code> et <code>mv</code>. La raison pour laquelle ce module ne prend pas en compte les - modifications de fichiers réside dans le fait que cette - vérification nécessiterait un appel à <code>stat()</code> à chaque - accès, et en fin de compte, l'augmentation de la consommation de + modifications de fichiers réside dans le fait que cette + vérification nécessiterait un appel à <code>stat()</code> à chaque + accès, et en fin de compte, l'augmentation de la consommation de ressources finirait par aller contre le but initial de - réduire les entrées/sorties.</p> + réduire les entrées/sorties.</p> <h3>Directive CacheFile</h3> <p>La directive <code class="directive"><a href="#cachefile">CacheFile</a></code> du module <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> permet d'associer un - <em>gestionnaire</em> ou <em>descripteur de fichier</em> à chaque - fichier énuméré dans la directive de configuration et place ces + <em>gestionnaire</em> ou <em>descripteur de fichier</em> à chaque + fichier énuméré dans la directive de configuration et place ces gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des - fichier est demandé, le serveur sélectionne son gestionnaire dans - le cache et le transmet à l'API <code>sendfile()</code> (ou + fichier est demandé, le serveur sélectionne son gestionnaire dans + le cache et le transmet à l'API <code>sendfile()</code> (ou <code>TransmitFile()</code> sous Windows).</p> - <p>Cette mise en cache des gestionnaire n'est effectuée qu'une - seule fois au démarrage ou redémarrage du système. Ainsi, chaque - fois qu'un des fichiers chargés en mémoire est modifié au niveau - du système de fichiers, vous <em>devez</em> redémarrer le serveur - (voir la documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>). + <p>Cette mise en cache des gestionnaire n'est effectuée qu'une + seule fois au démarrage ou redémarrage du système. Ainsi, chaque + fois qu'un des fichiers chargés en mémoire est modifié au niveau + du système de fichiers, vous <em>devez</em> redémarrer le serveur + (voir la documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>). Pour bien - insister sur ce point, si des fichiers sont modifiés <em>sur - disque</em>, et si vous ne redémarrez pas le serveur, vous allez - finir par servir des contenus complètement obsolètes. Vous devez - mettre à jour les fichiers en renommant l'ancienne version et en + insister sur ce point, si des fichiers sont modifiés <em>sur + disque</em>, et si vous ne redémarrez pas le serveur, vous allez + finir par servir des contenus complètement obsolètes. Vous devez + mettre à jour les fichiers en renommant l'ancienne version et en enregistrant la nouvelle sur disque. Pour y parvenir, on peut utiliser des outils comme <code>rdist</code> et <code>mv</code>.</p> @@ -160,8 +160,8 @@ fichiers</td></tr> <div class="note"><h3>Note</h3> <p>Ne cherchez pas de directive qui met tous les - fichiers d'un répertoire en cache, de manière récursive. Pour y - parvenir, vous pouvez vous reporter à la directive <code class="directive"><a href="../mod/core.html#include">Include</a></code>, et considérer cette + fichiers d'un répertoire en cache, de manière récursive. Pour y + parvenir, vous pouvez vous reporter à la directive <code class="directive"><a href="../mod/core.html#include">Include</a></code>, et considérer cette commande :</p> <div class="example"><p><code> @@ -174,29 +174,29 @@ fichiers</td></tr> <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>Met en cache une liste de gestionnaires de fichiers au -démarrage</td></tr> +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#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>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 + 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é + 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>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 + 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. + 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 + 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>Exemple</h3><pre class="prettyprint lang-config">CacheFile /usr/local/apache/htdocs/index.html</pre> @@ -206,30 +206,30 @@ démarrage</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="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>Charge au démarrage une liste de fichiers en -mémoire</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#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>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 + 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>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 + 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. + 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 + 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>Exemple</h3><pre class="prettyprint lang-config">MMapFile /usr/local/apache/htdocs/index.html</pre> @@ -239,7 +239,7 @@ mémoire</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_file_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_file_cache.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_file_cache.html" title="Français"> fr </a> | <a href="../ko/mod/mod_file_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -259,7 +259,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_file_cache } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_headers.html b/docs/manual/mod/mod_headers.html index f737b4dc88..a9d1e93c98 100644 --- a/docs/manual/mod/mod_headers.html +++ b/docs/manual/mod/mod_headers.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_headers.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_headers.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_headers.html.fr b/docs/manual/mod/mod_headers.html.fr index c7feee10a4..431e1ddbb2 100644 --- a/docs/manual/mod/mod_headers.html.fr +++ b/docs/manual/mod/mod_headers.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,25 +27,25 @@ <div id="preamble"><h1>Module Apache mod_headers</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Personnalisation des en-têtes de requêtes et de réponses +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Personnalisation des en-têtes de requêtes et de réponses HTTP</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>headers_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_headers.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>headers_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_headers.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit des directives permettant de contrôler et - modifier les en-têtes de requêtes et de réponses HTTP. Les en-têtes - peuvent être fusionnés, remplacés ou supprimés.</p> + <p>Ce module fournit des directives permettant de contrôler et + modifier les en-têtes de requêtes et de réponses HTTP. Les en-têtes + peuvent être fusionnés, remplacés ou supprimés.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#order">Chronologie du traitement</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#early">Traitement précoce et traitement +<li><img alt="" src="../images/down.gif" /> <a href="#early">Traitement précoce et traitement tardif</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> </ul><h3 class="directives">Directives</h3> @@ -59,47 +59,47 @@ tardif</a></li> <h2><a name="order" id="order">Chronologie du traitement</a></h2> <p>Les directives fournies par <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> peuvent - s'insérer presque partout dans la configuration du serveur, et on - peut limiter leur portée en les plaçant dans des <a href="../sections.html">sections de configuration</a>.</p> + s'insérer presque partout dans la configuration du serveur, et on + peut limiter leur portée en les plaçant dans des <a href="../sections.html">sections de configuration</a>.</p> - <p>La chronologie du traitement est importante et est affectée par + <p>La chronologie du traitement est importante et est affectée par l'ordre d'apparition des directives dans le fichier de configuration et par leur placement dans les <a href="../sections.html#mergin">sections de configuration</a>. Ainsi, - ces deux directives ont un effet différent si leur ordre est inversé + ces deux directives ont un effet différent si leur ordre est inversé :</p> <pre class="prettyprint lang-config">RequestHeader append MirrorID "mirror 12" RequestHeader unset MirrorID</pre> - <p>Dans cet ordre, l'en-tête <code>MirrorID</code> n'est pas défini. - Si l'ordre des directives était inversé, l'en-tête - <code>MirrorID</code> serait défini à "mirror 12".</p> + <p>Dans cet ordre, l'en-tête <code>MirrorID</code> n'est pas défini. + Si l'ordre des directives était inversé, l'en-tête + <code>MirrorID</code> serait défini à "mirror 12".</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="early" id="early">Traitement précoce et traitement +<h2><a name="early" id="early">Traitement précoce et traitement tardif</a></h2> - <p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> peut agir soir précocement, soit - tardivement au niveau de la requête. Le mode normal est le mode - tardif, lorsque les en-têtes de <em>requête</em> sont définis, immédiatement - avant l'exécution du générateur de contenu, et pour les en-têtes de - <em>réponse</em>, juste au moment où la réponse est envoyée sur le réseau. + <p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> peut agir soir précocement, soit + tardivement au niveau de la requête. Le mode normal est le mode + tardif, lorsque les en-têtes de <em>requête</em> sont définis, immédiatement + avant l'exécution du générateur de contenu, et pour les en-têtes de + <em>réponse</em>, juste au moment où la réponse est envoyée sur le réseau. Utilisez toujours le mode tardif sur un serveur en production.</p> - <p>Le mode précoce a été conçu à des fins d'aide aux tests et au - débogage pour les développeurs. Les directives définies en utilisant - le mot-clé <code>early</code> sont censées agir au tout début du - traitement de la requête. Cela signifie que l'on peut les utiliser - pour simuler différentes requêtes et définir des situations de test, - tout en gardant à l'esprit que les en-têtes peuvent être modifiés à - tout moment par d'autres modules avant que le réponse ne soit - générée.</p> - - <p>Comme les directives précoces sont traitées avant que le - chemin de la requête ne soit parcouru, les en-têtes - précoces ne peuvent être définis que dans un contexte de serveur - principal ou de serveur virtuel. Les directives précoces ne peuvent - pas dépendre d'un chemin de requête, si bien qu'elles échoueront + <p>Le mode précoce a été conçu à des fins d'aide aux tests et au + débogage pour les développeurs. Les directives définies en utilisant + le mot-clé <code>early</code> sont censées agir au tout début du + traitement de la requête. Cela signifie que l'on peut les utiliser + pour simuler différentes requêtes et définir des situations de test, + tout en gardant à l'esprit que les en-têtes peuvent être modifiés à + tout moment par d'autres modules avant que le réponse ne soit + générée.</p> + + <p>Comme les directives précoces sont traitées avant que le + chemin de la requête ne soit parcouru, les en-têtes + précoces ne peuvent être définis que dans un contexte de serveur + principal ou de serveur virtuel. Les directives précoces ne peuvent + pas dépendre d'un chemin de requête, si bien qu'elles échoueront dans des contextes tels que <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>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> @@ -107,99 +107,99 @@ tardif</a></h2> <ol> <li> - Copie tous les en-têtes de requête qui commencent par "TS" vers - les en-têtes de la réponse : + Copie tous les en-têtes de requête qui commencent par "TS" vers + les en-têtes de la réponse : <pre class="prettyprint lang-config">Header echo ^TS</pre> </li> <li> - Ajoute à la réponse un en-tête, <code>mon-en-tête</code>, qui - contient un horodatage permettant de déterminer le moment où la - requête a été reçue, et le temps qui s'est écoulé jusqu'à ce que - la requête ait commencé à être servie. Cet en-tête peut être - utilisé par le client pour estimer la charge du serveur ou - isoler les goulets d'étranglement entre le client et le + Ajoute à la réponse un en-tête, <code>mon-en-tête</code>, qui + contient un horodatage permettant de déterminer le moment où la + requête a été reçue, et le temps qui s'est écoulé jusqu'à ce que + la requête ait commencé à être servie. Cet en-tête peut être + utilisé par le client pour estimer la charge du serveur ou + isoler les goulets d'étranglement entre le client et le serveur. - <pre class="prettyprint lang-config">Header set mon-en-tête "%D %t"</pre> + <pre class="prettyprint lang-config">Header set mon-en-tête "%D %t"</pre> - <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> <div class="example"><p><code> - mon-en-tête: D=3775428 t=991424704447256 + mon-en-tête: D=3775428 t=991424704447256 </code></p></div> </li> <li> - Dit Bonjour à Joe + Dit Bonjour à Joe <div class="example"><p><code> - Header set mon-en-tête "Bonjour Joe. Il a fallu %D microsecondes \<br /> - à Apache pour servir cette requête." + Header set mon-en-tête "Bonjour Joe. Il a fallu %D microsecondes \<br /> + à Apache pour servir cette requête." </code></p></div> - <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> - <pre class="prettyprint lang-config"> Header set MyHeader "Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache - pour servir cette requête."</pre> + <pre class="prettyprint lang-config"> Header set MyHeader "Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache + pour servir cette requête."</pre> </li> <li> - Ajoute l'en-tête <code>mon-en-tête</code> à la réponse si et - seulement si l'en-tête <code>mon-en-tête-requête</code> est - présent dans la requête. Ceci peut s'avérer utile pour générer - des en-têtes de réponse "à la tête du client". Notez que cet - exemple nécessite les services du module + Ajoute l'en-tête <code>mon-en-tête</code> à la réponse si et + seulement si l'en-tête <code>mon-en-tête-requête</code> est + présent dans la requête. Ceci peut s'avérer utile pour générer + des en-têtes de réponse "à la tête du client". Notez que cet + exemple nécessite les services du module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. <pre class="prettyprint lang-config">SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader</pre> - <p>Si l'en-tête <code>mon-en-tête-requête: mavaleur</code> est - présent dans la requête HTTP, la réponse contiendra un en-tête + <p>Si l'en-tête <code>mon-en-tête-requête: mavaleur</code> est + présent dans la requête HTTP, la réponse contiendra un en-tête du type :</p> <div class="example"><p><code> - mon-en-tête: D=3775428 t=991424704447256 montexte + mon-en-tête: D=3775428 t=991424704447256 montexte </code></p></div> </li> <li> - Permet à DAV de fonctionner avec Apache sur SSL (voir la <a href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description - du problème</a>) en remplaçant <var>https:</var> par - <var>http:</var> dans l'en-tête <var>Destination</var> : + Permet à DAV de fonctionner avec Apache sur SSL (voir la <a href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description + du problème</a>) en remplaçant <var>https:</var> par + <var>http:</var> dans l'en-tête <var>Destination</var> : <pre class="prettyprint lang-config">RequestHeader edit Destination ^https: http: early</pre> </li> <li> - Définit la valeur d'un même en-tête sous de multiples conditions - non exclusives, mais ne duplique pas une valeur déjà définie - dans l'en-tête qui en résulte. Si toutes les conditions - suivantes sont satisfaites pour une requête (en d'autres termes, + Définit la valeur d'un même en-tête sous de multiples conditions + non exclusives, mais ne duplique pas une valeur déjà définie + dans l'en-tête qui en résulte. Si toutes les conditions + suivantes sont satisfaites pour une requête (en d'autres termes, si les trois variables d'environnement <code>CGI</code>, <code>NO_CACHE</code> et <code>NO_STORE</code> existent pour la - requête) : + requête) : <pre class="prettyprint lang-config">Header merge Cache-Control no-cache env=CGI Header merge Cache-Control no-cache env=NO_CACHE Header merge Cache-Control no-store env=NO_STORE</pre> - <p>alors, la réponse contiendra l'en-tête suivant :</p> + <p>alors, la réponse contiendra l'en-tête suivant :</p> <div class="example"><p><code> Cache-Control: no-cache, no-store </code></p></div> - <p>Si <code>append</code> avait été utilisé à la place de - <code>merge</code>, la réponse aurait contenu l'en-tête suivant + <p>Si <code>append</code> avait été utilisé à la place de + <code>merge</code>, la réponse aurait contenu l'en-tête suivant :</p> <div class="example"><p><code> @@ -207,14 +207,14 @@ Header merge Cache-Control no-store env=NO_STORE</pre> </code></p></div> </li> <li> - Définit un cookie de test si et seulement si le client n'envoie + Définit un cookie de test si et seulement si le client n'envoie pas de cookie <pre class="prettyprint lang-config">Header set Set-Cookie testcookie "expr=-z %{req:Cookie}"</pre> </li> <li> - Ajoute un en-tête de mise en cache pour les réponses avec un - code d'état HTTP de 200 + Ajoute un en-tête de mise en cache pour les réponses avec un + code d'état HTTP de 200 <pre class="prettyprint lang-config">Header append Cache-Control s-maxage=600 "expr=%{REQUEST_STATUS} == 200"</pre> </li> @@ -224,192 +224,192 @@ Header merge Cache-Control no-store env=NO_STORE</pre> <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 les en-têtes d'une réponse HTTP</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>en-tête</var> [[expr=]<var>valeur</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#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 est disponible depuis la version 2.4.7 du -serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la +<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>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 + 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 + <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> + 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 + <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> + 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>Vous ajoutez un en-tête à une réponse - générée localement et échouée (non-2xx), + <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 + 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> + 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>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 + <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>L'action que cette directive provoque est déterminée par le + <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 + <var>condition</var> est spécifiée). Il peut prendre une des valeurs suivantes :</p> <dl> <dt><code>add</code></dt> - <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 + <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>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> + <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>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> + <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>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <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 + 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> + 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>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 + <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>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 + <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>L'en-tête est défini, mais seulement s'il n'existe - aucun en-tête avec le même nom.<br /> + <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>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> + <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>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> + <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>, + <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> + <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 + <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> + 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> + <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>Le caractère pourcentage</td></tr> + <td>Le caractère pourcentage</td></tr> <tr class="odd"><td><code>%t</code></td> - <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 + <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>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> + <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>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 /> + 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>Le pourcentage courant de httpd au repos (de 0 à 100) + <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 /> + 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>Le pourcentage courant de httpd utilisé (de 0 à 100) + <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 /> + 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>%{NOM_VARIABLE}e</code></td> @@ -418,31 +418,31 @@ version 2.4.10</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> + <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>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 + <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 + <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 à 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> + <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>Le point de départ de la syntaxe est 'string' au lieu de + <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 + 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> @@ -451,172 +451,172 @@ version 2.4.10</td></tr> </ul> </div> - <p><code>edit</code>nécessite les deux arguments + <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 + 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> + contenir des spécificateurs de format.</p> - <p>La directive <code class="directive">Header</code> peut être suivie d'un + <p>La directive <code class="directive">Header</code> peut être suivie d'un argument additionnel qui peut prendre les valeurs suivantes :</p> <dl> <dt><code>early</code></dt> - <dd>Spécifie <a href="#early">traitement préalable</a>.</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> + <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> + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> <dt><code>expr=<var>expression</var></code></dt> <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>. + 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>. <div class="example"><p><code> - # Cet exemple retarde l'évaluation de la clause de condition par - # rapport à <If> + # 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$#" </code></p></div> </dd> </dl> - <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> + <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 les en-têtes d'une requête HTTP</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>en-tête</var> [[expr=]<var>valeur</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#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 est disponible depuis la version 2.4.7 du -serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la +<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>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 + 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>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 + <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>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> + <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>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <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 + 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> + elle apparaît plusieurs fois.</dd> <dt><code>merge</code></dt> - <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 + <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>L'en-tête est défini, remplaçant tout en-tête préexistant avec - le même nom.</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>L'en-tête est défini, mais seulement s'il n'existe - aucun en-tête avec le même nom.<br /> + <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>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> + <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>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>, + <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 + 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> + 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 + <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>Spécifie <a href="#early">traitement préalable</a>.</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> + <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> + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> <dt><code>expr=<var>expression</var></code></dt> <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> + 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é 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 + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -637,7 +637,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_headers.ht } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_ident.html b/docs/manual/mod/mod_ident.html index b6f2cea8a1..56eeaef844 100644 --- a/docs/manual/mod/mod_ident.html +++ b/docs/manual/mod/mod_ident.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_ident.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_ident.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_ident.html.fr b/docs/manual/mod/mod_ident.html.fr index c97c0554cc..410697d94f 100644 --- a/docs/manual/mod/mod_ident.html.fr +++ b/docs/manual/mod/mod_ident.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,19 +27,19 @@ <div id="preamble"><h1>Module Apache mod_ident</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ident.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | <a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Recherche d'identité conformément à la RFC +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Recherche d'identité conformément à la RFC 1413</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ident_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_ident.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ident_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_ident.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module interroge un démon compatible <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> sur un - serveur distant afin de déterminer le propriétaire d'une + <p>Ce module interroge un démon compatible <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> sur un + serveur distant afin de déterminer le propriétaire d'une connexion.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -55,59 +55,59 @@ <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>Active la journalisation de l'identité RFC 1413 de +<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#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>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> + 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"> 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. + absolue, et elle ne doit être utilisée que dans le cadre d'un + traçage grossier. </div> - <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 + <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 + 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>Détermine le délai d'attente pour les requêtes +<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#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>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 + <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> + 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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ident.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | <a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -128,7 +128,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_ident.html } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_info.html b/docs/manual/mod/mod_info.html index 23d714e208..ba3799821b 100644 --- a/docs/manual/mod/mod_info.html +++ b/docs/manual/mod/mod_info.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_info.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_info.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_info.html.fr b/docs/manual/mod/mod_info.html.fr index ff50f84885..87bc5b40c0 100644 --- a/docs/manual/mod/mod_info.html.fr +++ b/docs/manual/mod/mod_info.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,27 +27,27 @@ <div id="preamble"><h1>Module Apache mod_info</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du serveur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table> <h3>Sommaire</h3> <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes - suivantes à votre fichier <code>httpd.conf</code>.</p> + suivantes à votre fichier <code>httpd.conf</code>.</p> <pre class="prettyprint lang-config"><Location "/server-info"> SetHandler server-info </Location></pre> - <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> à - l'intérieur de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> afin de restreindre l'accès aux + <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> à + l'intérieur de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> afin de restreindre l'accès aux informations de configuration de votre serveur :</p> <pre class="prettyprint lang-config"><Location "/server-info"> @@ -56,15 +56,15 @@ serveur</td></tr> </Location></pre> - <p>Une fois cette configuration effectuée, les informations du - serveur sont disponibles à l'adresse + <p>Une fois cette configuration effectuée, les informations du + serveur sont disponibles à l'adresse <code>http://votre-serveur.com/infos-serveur</code>.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#startup">Affichage de la configuration au démarrage</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#startup">Affichage de la configuration au démarrage</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -73,123 +73,123 @@ serveur</td></tr> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2> - <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa - fonctionnalité de gestionnaire est disponible dans <em>tous</em> les +<h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2> + <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa + fonctionnalité de gestionnaire est disponible dans <em>tous</em> les fichiers de configuration, y compris les fichiers de configuration - des répertoires (par exemple <code>.htaccess</code>). Ceci peut - avoir des répercutions en matière de sécurité pour votre site.</p> + des répertoires (par exemple <code>.htaccess</code>). Ceci peut + avoir des répercutions en matière de sécurité pour votre site.</p> - <p>En particulier, l'utilisation de ce module peut conduire à la - divulgation d'informations sensibles à partir des directives de - configuration d'autres modules Apache comme des chemins systèmes, + <p>En particulier, l'utilisation de ce module peut conduire à la + divulgation d'informations sensibles à partir des directives de + configuration d'autres modules Apache comme des chemins systèmes, des couples nom d'utilisateur/mot de passe, des noms de bases de - données, etc... C'est pourquoi ce module ne doit être utilisé - <strong>que</strong> dans un environnement sous contrôle et toujours - avec les plus grandes précautions.</p> + données, etc... C'est pourquoi ce module ne doit être utilisé + <strong>que</strong> dans un environnement sous contrôle et toujours + avec les plus grandes précautions.</p> - <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour - restreindre l'accès aux informations de configuration de votre + <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour + restreindre l'accès aux informations de configuration de votre serveur.</p> - <div class="example"><h3>Contrôle d'accès</h3><pre class="prettyprint lang-config"><Location "/server-info"> + <div class="example"><h3>Contrôle d'accès</h3><pre class="prettyprint lang-config"><Location "/server-info"> SetHandler server-info - # Autorisation d'accès depuis le serveur lui-même + # Autorisation d'accès depuis le serveur lui-même Require ip 127.0.0.1 - # Autorisation d'accès depuis une station de travail du réseau + # Autorisation d'accès depuis une station de travail du réseau # local Require ip 192.168.1.17 </Location></pre> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2> - <p>Par défaut, les informations affichées comprennent une liste de - tous les modules activés, et pour chaque module, une description des +<h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2> + <p>Par défaut, les informations affichées comprennent une liste de + tous les modules activés, et pour chaque module, une description des directives qu'il accepte, les branchements (hooks) qu'il - implémente, ainsi que les directives concernées dans la + implémente, ainsi que les directives concernées dans la configuration courante.</p> <p>Il est possible d'afficher d'autres vues de la configuration en - ajoutant un argument à la requête <code>infos-serveur</code>. Par + ajoutant un argument à la requête <code>infos-serveur</code>. Par exemple, <code>http://votre-serveur.com/infos-serveur?config</code> affichera toutes les directives de configuration.</p> <dl> <dt><code>?<module-name></code></dt> <dd>Uniquement les informations relatives au module - spécifié</dd> + spécifié</dd> <dt><code>?config</code></dt> - <dd>Uniquement les directives de configuration, non triées + <dd>Uniquement les directives de configuration, non triées par module</dd> <dt><code>?hooks</code></dt> <dd>Uniquement la liste des branchements (hooks) - auxquels le module est attaché</dd> + auxquels le module est attaché</dd> <dt><code>?list</code></dt> - <dd>Une simple liste des modules activés</dd> + <dd>Une simple liste des modules activés</dd> <dt><code>?server</code></dt> <dd>Uniquement des informations de base sur le serveur</dd> </dl> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="startup" id="startup">Affichage de la configuration au démarrage</a></h2> +<h2><a name="startup" id="startup">Affichage de la configuration au démarrage</a></h2> <p>Si la directive de configuration define - <code>-DDUMP_CONFIG</code> est utilisée, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va - envoyer la configuration préinterprétée vers <code>stdout</code> au - cours du démarrage du serveur. "Préinterprétée" signifie que - les directives telles que <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> sont évaluées et les variables - d'environnement remplacées par leurs valeurs. Cela ne représente - cependant pas la configuration définitive. En particulier, les - fusions ou écrasementsde définitions en cas de directives multiples ne sont pas - représentés.</p> - - <p>Le résultat est équivalent à celui de la requête + <code>-DDUMP_CONFIG</code> est utilisée, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va + envoyer la configuration préinterprétée vers <code>stdout</code> au + cours du démarrage du serveur. "Préinterprétée" signifie que + les directives telles que <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> sont évaluées et les variables + d'environnement remplacées par leurs valeurs. Cela ne représente + cependant pas la configuration définitive. En particulier, les + fusions ou écrasementsde définitions en cas de directives multiples ne sont pas + représentés.</p> + + <p>Le résultat est équivalent à celui de la requête <code>?config</code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="limitations" id="limitations">Limitations connues</a></h2> <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de - la configuration interprétée, et non du fichier de configuration - original. La manière dont l'arbre de configuration interprété est - créé induit quelques limitations :</p> + la configuration interprétée, et non du fichier de configuration + original. La manière dont l'arbre de configuration interprété est + créé induit quelques limitations :</p> <ul> - <li>Les directives qui sont traitées immédiatement sans être - enregistrées dans l'arbre de configuration interprété ne sont pas + <li>Les directives qui sont traitées immédiatement sans être + enregistrées dans l'arbre de configuration interprété ne sont pas prises en compte. Celles-ci comprennent <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> et <code class="directive"><a href="../mod/mod_so.html#loadfile">LoadFile</a></code>.</li> - <li>Les directives qui contrôlent le fichier de configuration - lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>, + <li>Les directives qui contrôlent le fichier de configuration + lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>, <code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> et <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> ne sont pas prises en compte, mais les directives de configuration incluses le sont.</li> - <li>Les commentaires ne sont pas pris en compte (Ce qui peut être - considéré comme une fonctionnalité).</li> + <li>Les commentaires ne sont pas pris en compte (Ce qui peut être + considéré comme une fonctionnalité).</li> <li>Les directives de configuration des fichiers <code>.htaccess</code> ne sont pas prises en compte (car elles ne font pas partie de la configuration permanente du serveur).</li> - <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sont affichées + <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sont affichées normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de - déterminer le numéro de ligne de la balise fermante + déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#directory"></Directory></a></code>.</li> - <li>Les directives générées par des modules tiers comme - <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être + <li>Les directives générées par des modules tiers comme + <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être prises en compte.</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="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>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#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>Cette directive permet d'afficher le contenu de <var>chaîne</var> - en tant qu'<strong>Information supplémentaire</strong> interprétée + <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 \ @@ -201,7 +201,7 @@ module affichées par le gestionnaire server-info</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -222,7 +222,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_info.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_ldap.html b/docs/manual/mod/mod_ldap.html index 7e3eb258e7..c5c33fcf6b 100644 --- a/docs/manual/mod/mod_ldap.html +++ b/docs/manual/mod/mod_ldap.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_ldap.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_ldap.html.fr b/docs/manual/mod/mod_ldap.html.fr index a018f54eaa..c6f54d7b12 100644 --- a/docs/manual/mod/mod_ldap.html.fr +++ b/docs/manual/mod/mod_ldap.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,33 +27,33 @@ <div id="preamble"><h1>Module Apache mod_ldap</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ldap.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_ldap.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Conservation des connexions LDAP et services de mise en -cache du résultat à destination des autres modules LDAP</td></tr> +cache du résultat à destination des autres modules LDAP</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ldap_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>util_ldap.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>ldap_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>util_ldap.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module a été conçu dans le but d'améliorer les performances - des sites web s'appuyant sur des connexions en arrière-plan vers des + <p>Ce module a été conçu dans le but d'améliorer les performances + des sites web s'appuyant sur des connexions en arrière-plan vers des serveurs LDAP. Il ajoute aux fonctions fournies par les - bibliothèques standards LDAP la conservation des connexions LDAP - ainsi qu'un cache LDAP partagé en mémoire.</p> + bibliothèques standards LDAP la conservation des connexions LDAP + ainsi qu'un cache LDAP partagé en mémoire.</p> - <p>Pour activer ce module, le support LDAP doit être compilé dans + <p>Pour activer ce module, le support LDAP doit être compilé dans apr-util. Pour ce faire, on ajoute l'option <code>--with-ldap</code> au script <code class="program"><a href="../programs/configure.html">configure</a></code> lorsqu'on construit Apache.</p> - <p>Le support SSL/TLS est conditionné par le kit de développement - LDAP qui a été lié à <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Au moment où ces - lignes sont écrites, APR-util supporte <a href="http://www.openldap.org/">OpenLDAP SDK</a> (version 2.x ou - supérieure), <a href="http://developer.novell.com/ndk/cldap.htm">Novell LDAP + <p>Le support SSL/TLS est conditionné par le kit de développement + LDAP qui a été lié à <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Au moment où ces + lignes sont écrites, APR-util supporte <a href="http://www.openldap.org/">OpenLDAP SDK</a> (version 2.x ou + supérieure), <a href="http://developer.novell.com/ndk/cldap.htm">Novell LDAP SDK</a>, <a href="https://wiki.mozilla.org/LDAP_C_SDK"> - Mozilla LDAP SDK</a>, le SDK LDAP Solaris natif (basé sur Mozilla) - ou le SDK LDAP Microsoft natif. Voir le site web <a href="http://apr.apache.org">APR</a> pour plus de détails.</p> + Mozilla LDAP SDK</a>, le SDK LDAP Solaris natif (basé sur Mozilla) + ou le SDK LDAP Microsoft natif. Voir le site web <a href="http://apr.apache.org">APR</a> pour plus de détails.</p> </div> <div id="quickview"><h3>Sujets</h3> @@ -89,13 +89,13 @@ cache du résultat à destination des autres modules LDAP</td></tr> <div class="section"> <h2><a name="exampleconfig" id="exampleconfig">Exemple de configuration</a></h2> <p>Ce qui suit est un exemple de configuration qui utilise - <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> pour améliorer les performances de + <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> pour améliorer les performances de l'authentification HTTP de base fournie par <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p> - <pre class="prettyprint lang-config"># Active la conservation des connexions LDAP et le cache partagé en -# mémoire. Active le gestionnaire de statut du cache LDAP. -# Nécessite le chargement de mod_ldap et de mod_authnz_ldap. + <pre class="prettyprint lang-config"># Active la conservation des connexions LDAP et le cache partagé en +# mémoire. Active le gestionnaire de statut du cache LDAP. +# Nécessite le chargement de mod_ldap et de mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -122,102 +122,102 @@ LDAPOpCacheTTL 600 <div class="section"> <h2><a name="pool" id="pool">Conservation des connexions LDAP</a></h2> - <p>Les connexions LDAP sont conservées de requête en requête. Ceci - permet de rester connecté et identifié au serveur LDAP, ce dernier - étant ainsi prêt pour la prochaine requête, sans avoir à se - déconnecter, reconnecter et réidentifier. Le gain en performances - est similaire à celui des connexions persistantes (keepalives) + <p>Les connexions LDAP sont conservées de requête en requête. Ceci + permet de rester connecté et identifié au serveur LDAP, ce dernier + étant ainsi prêt pour la prochaine requête, sans avoir à se + déconnecter, reconnecter et réidentifier. Le gain en performances + est similaire à celui des connexions persistantes (keepalives) HTTP.</p> - <p>Sur un serveur très sollicité, il est possible que de nombreuses - requêtes tentent d'accéder simultanément à la même connexion au - serveur LDAP. Lorsqu'une connexion LDAP est utilisée, Apache en crée - une deuxième en parallèle à la première, ce qui permet d'éviter que - le système de conservation des connexions ne devienne un goulot - d'étranglement.</p> + <p>Sur un serveur très sollicité, il est possible que de nombreuses + requêtes tentent d'accéder simultanément à la même connexion au + serveur LDAP. Lorsqu'une connexion LDAP est utilisée, Apache en crée + une deuxième en parallèle à la première, ce qui permet d'éviter que + le système de conservation des connexions ne devienne un goulot + d'étranglement.</p> - <p>Il n'est pas nécessaire d'activer explicitement la conservation + <p>Il n'est pas nécessaire d'activer explicitement la conservation des connexions dans la configuration d'Apache. Tout module utilisant - le module ldap pour accéder aux services LDAP partagera le jeu de + le module ldap pour accéder aux services LDAP partagera le jeu de connexions.</p> - <p>Les connexions LDAP peuvent garder la trace des données - d'identification du client ldap utilisées pour l'identification - auprès du serveur LDAP. Ces données peuvent être fournies aux + <p>Les connexions LDAP peuvent garder la trace des données + d'identification du client ldap utilisées pour l'identification + auprès du serveur LDAP. Ces données peuvent être fournies aux serveurs LDAP qui ne permettent pas les connexions anonymes au cours lors des tentatives de sauts vers des serveurs alternatifs. Pour - contrôler cette fonctionnalité, voir les directives <code class="directive"><a href="#ldapreferrals">LDAPReferrals</a></code> et <code class="directive"><a href="#ldapreferralhoplimit">LDAPReferralHopLimit</a></code>. Cette - fonctionnalité est activée par défaut.</p> + contrôler cette fonctionnalité, voir les directives <code class="directive"><a href="#ldapreferrals">LDAPReferrals</a></code> et <code class="directive"><a href="#ldapreferralhoplimit">LDAPReferralHopLimit</a></code>. Cette + fonctionnalité est activée par défaut.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="cache" id="cache">Cache LDAP</a></h2> - <p>Pour améliorer les performances, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> met en - oeuvre une stratégie de mise en cache agressive visant à minimiser - le nombre de fois que le serveur LDAP doit être contacté. La mise en - cache peut facilement doubler et même tripler le débit d'Apache - lorsqu'il sert des pages protégées par mod_authnz_ldap. De plus, le - serveur LDAP verra lui-même sa charge sensiblement diminuée.</p> + <p>Pour améliorer les performances, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> met en + oeuvre une stratégie de mise en cache agressive visant à minimiser + le nombre de fois que le serveur LDAP doit être contacté. La mise en + cache peut facilement doubler et même tripler le débit d'Apache + lorsqu'il sert des pages protégées par mod_authnz_ldap. De plus, le + serveur LDAP verra lui-même sa charge sensiblement diminuée.</p> <p><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> supporte deux types de mise en cache LDAP : un <em>cache recherche/identification</em> durant la phase - de recherche/identification et deux <em>caches d'opérations</em> - durant la phase de comparaison. Chaque URL LDAP utilisée par le + de recherche/identification et deux <em>caches d'opérations</em> + durant la phase de comparaison. Chaque URL LDAP utilisée par le serveur a son propre jeu d'instances dans ces trois caches.</p> <h3><a name="search-bind" id="search-bind">Le cache recherche/identification</a></h3> <p>Les processus de recherche et d'identification sont les - opérations LDAP les plus consommatrices en temps, en particulier + opérations LDAP les plus consommatrices en temps, en particulier si l'annuaire est de grande taille. Le cache de recherche/identification met en cache toutes les recherches qui - ont abouti à une identification positive. Les résultats négatifs - (c'est à dire les recherches sans succès, ou les recherches qui - n'ont pas abouti à une identification positive) ne sont pas mis en - cache. La raison de cette décision réside dans le fait que les - connexions avec des données d'identification invalides ne - représentent qu'un faible pourcentage du nombre total de + ont abouti à une identification positive. Les résultats négatifs + (c'est à dire les recherches sans succès, ou les recherches qui + n'ont pas abouti à une identification positive) ne sont pas mis en + cache. La raison de cette décision réside dans le fait que les + connexions avec des données d'identification invalides ne + représentent qu'un faible pourcentage du nombre total de connexions, et ainsi, le fait de ne pas mettre en cache les - données d'identification invalides réduira d'autant la taille du + données d'identification invalides réduira d'autant la taille du cache.</p> <p><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> met en cache le nom d'utilisateur, le - DN extrait, le mot de passe utilisé pour l'identification, ainsi + DN extrait, le mot de passe utilisé pour l'identification, ainsi que l'heure de l'identification. Chaque fois qu'une nouvelle - connexion est initialisée avec le même nom d'utilisateur, + connexion est initialisée avec le même nom d'utilisateur, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> compare le mot de passe de la nouvelle - connexion avec le mot de passe enregistré dans le cache. Si les - mots de passe correspondent, et si l'entrée du cache n'est pas + connexion avec le mot de passe enregistré dans le cache. Si les + mots de passe correspondent, et si l'entrée du cache n'est pas trop ancienne, <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> court-circuite la phase de recherche/identification.</p> - <p>Le cache de recherche/identification est contrôlé par les + <p>Le cache de recherche/identification est contrôlé par les directives <code class="directive"><a href="#ldapcacheentries">LDAPCacheEntries</a></code> et <code class="directive"><a href="#ldapcachettl">LDAPCacheTTL</a></code>.</p> - <h3><a name="opcaches" id="opcaches">Les caches d'opérations</a></h3> - <p>Au cours des opérations de comparaison d'attributs et de noms + <h3><a name="opcaches" id="opcaches">Les caches d'opérations</a></h3> + <p>Au cours des opérations de comparaison d'attributs et de noms distinctifs (DN), <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> utilise deux caches - d'opérations pour mettre en cache les opérations de comparaison. - Le premier cache de comparaison sert à mettre en cache les - résultats de comparaisons effectuées pour vérifier l'appartenance - à un groupe LDAP. Le second cache de comparaison sert à mettre en - cache les résultats de comparaisons entre DNs.</p> + d'opérations pour mettre en cache les opérations de comparaison. + Le premier cache de comparaison sert à mettre en cache les + résultats de comparaisons effectuées pour vérifier l'appartenance + à un groupe LDAP. Le second cache de comparaison sert à mettre en + cache les résultats de comparaisons entre DNs.</p> - <p>Notez que, lorsque l'appartenance à un groupe est vérifiée, + <p>Notez que, lorsque l'appartenance à un groupe est vérifiée, toute comparaison de sous-groupes est mise en cache afin - d'accélérer les comparaisons de sous-groupes ultérieures.</p> + d'accélérer les comparaisons de sous-groupes ultérieures.</p> - <p>Le comportement de ces deux caches est contrôlé par les + <p>Le comportement de ces deux caches est contrôlé par les directives <code class="directive"><a href="#ldapopcacheentries">LDAPOpCacheEntries</a></code> et <code class="directive"><a href="#ldapopcachettl">LDAPOpCacheTTL</a></code>.</p> <h3><a name="monitoring" id="monitoring">Superviser le cache</a></h3> - <p><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> possède un gestionnaire de contenu + <p><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> possède un gestionnaire de contenu qui permet aux administrateurs de superviser les performances du cache. Le nom du gestionnaire de contenu est <code>ldap-status</code>, et on peut utiliser les directives - suivantes pour accéder aux informations du cache de + suivantes pour accéder aux informations du cache de <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> :</p> <pre class="prettyprint lang-config"><Location "/server/cache-info"> @@ -225,31 +225,31 @@ LDAPOpCacheTTL 600 </Location></pre> - <p>En se connectant à l'URL + <p>En se connectant à l'URL <code>http://nom-serveur/infos-cache</code>, l'administrateur peut obtenir un rapport sur le statut de chaque cache qu'utilise <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>. Notez que si Apache ne supporte pas la - mémoire partagée, chaque instance de <code class="program"><a href="../programs/httpd.html">httpd</a></code> - possèdera son propre cache, et chaque fois que l'URL sera - rechargée, un résultat différent pourra être affiché, en fonction + mémoire partagée, chaque instance de <code class="program"><a href="../programs/httpd.html">httpd</a></code> + possèdera son propre cache, et chaque fois que l'URL sera + rechargée, un résultat différent pourra être affiché, en fonction de l'instance de <code class="program"><a href="../programs/httpd.html">httpd</a></code> qui traitera la - requête.</p> + requête.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="usingssltls" id="usingssltls">Utiliser SSL/TLS</a></h2> - <p>La possibilité de créer des connexions SSL et TLS avec un serveur - LDAP est définie par les directives <code class="directive"><a href="#ldaptrustedglobalcert"> + <p>La possibilité de créer des connexions SSL et TLS avec un serveur + LDAP est définie par les directives <code class="directive"><a href="#ldaptrustedglobalcert"> LDAPTrustedGlobalCert</a></code>, <code class="directive"><a href="#ldaptrustedclientcert"> LDAPTrustedClientCert</a></code> et <code class="directive"><a href="#ldaptrustedmode"> - LDAPTrustedMode</a></code>. Ces directives permettent de spécifier - l'autorité de certification (CA), les certificats clients éventuels, - ainsi que le type de chiffrement à utiliser pour la connexion (none, + LDAPTrustedMode</a></code>. Ces directives permettent de spécifier + l'autorité de certification (CA), les certificats clients éventuels, + ainsi que le type de chiffrement à utiliser pour la connexion (none, SSL ou TLS/STARTTLS).</p> <pre class="prettyprint lang-config"># Etablissement d'une connexion SSL LDAP sur le port 636. -# Nécessite le chargement de mod_ldap et mod_authnz_ldap. +# Nécessite le chargement de mod_ldap et mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -270,7 +270,7 @@ LDAPTrustedGlobalCert CA_DER /certs/certfile.der <pre class="prettyprint lang-config"># Etablissement d'une connexion TLS LDAP sur le port 389. -# Nécessite le chargement de mod_ldap et mod_authnz_ldap. +# Nécessite le chargement de mod_ldap et mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -294,42 +294,42 @@ LDAPTrustedGlobalCert CA_DER /certs/certfile.der <div class="section"> <h2><a name="settingcerts" id="settingcerts">Certificats SSL/TLS</a></h2> - <p>Les différents SDKs LDAP disposent de nombreuses méthodes pour - définir et gérer les certificats des clients et des autorités de + <p>Les différents SDKs LDAP disposent de nombreuses méthodes pour + définir et gérer les certificats des clients et des autorités de certification (CA).</p> <p>Si vous avez l'intention d'utiliser SSL ou TLS, lisez cette - section ATTENTIVEMENT de façon à bien comprendre les différences de - configurations entre les différents SDKs LDAP supportés.</p> + section ATTENTIVEMENT de façon à bien comprendre les différences de + configurations entre les différents SDKs LDAP supportés.</p> <h3><a name="settingcerts-netscape" id="settingcerts-netscape">SDK Netscape/Mozilla/iPlanet</a></h3> - <p>Les certificat de CA sont enregistrés dans un fichier nommé + <p>Les certificat de CA sont enregistrés dans un fichier nommé cert7.db. Le SDK ne dialoguera avec aucun serveur LDAP dont le - certificat n'a pas été signé par une CA spécifiée dans ce + certificat n'a pas été signé par une CA spécifiée dans ce fichier. Si des certificats clients sont requis, un fichier - key3.db ainsi qu'un mot de passe optionnels peuvent être - spécifiés. On peut aussi spécifier le fichier secmod si - nécessaire. Ces fichiers sont du même format que celui utilisé + key3.db ainsi qu'un mot de passe optionnels peuvent être + spécifiés. On peut aussi spécifier le fichier secmod si + nécessaire. Ces fichiers sont du même format que celui utilisé par les navigateurs web Netscape Communicator ou Mozilla. Le - moyen le plus simple pour obtenir ces fichiers consiste à les + moyen le plus simple pour obtenir ces fichiers consiste à les extraire de l'installation de votre navigateur.</p> - <p>Les certificats clients sont spécifiés pour chaque connexion + <p>Les certificats clients sont spécifiés pour chaque connexion en utilisant la directive LDAPTrustedClientCert et en se - référant au certificat "nickname". On peut éventuellement - spécifier un mot de passe pour déverrouiller la clé privée du + référant au certificat "nickname". On peut éventuellement + spécifier un mot de passe pour déverrouiller la clé privée du certificat.</p> <p>Le SDK supporte seulement SSL. Toute tentative d'utilisation de STARTTLS engendrera une erreur lors des tentatives de - contacter le serveur LDAP pendant l'exécution.</p> + contacter le serveur LDAP pendant l'exécution.</p> - <pre class="prettyprint lang-config"># Spécifie un fichier de certificats de CA Netscape + <pre class="prettyprint lang-config"># Spécifie un fichier de certificats de CA Netscape LDAPTrustedGlobalCert CA_CERT7_DB /certs/cert7.db -# Spécifie un fichier key3db optionnel pour le support des +# Spécifie un fichier key3db optionnel pour le support des # certificats clients LDAPTrustedGlobalCert CERT_KEY3_DB /certs/key3.db -# Spécifie le fichier secmod si nécessaire +# Spécifie le fichier secmod si nécessaire LDAPTrustedGlobalCert CA_SECMOD /certs/secmod <Location "/ldap-status"> SetHandler ldap-status @@ -350,28 +350,28 @@ LDAPTrustedGlobalCert CA_SECMOD /certs/secmod <h3><a name="settingcerts-novell" id="settingcerts-novell">SDK Novell</a></h3> - <p>Un ou plusieurs certificats de CA doivent être spécifiés pour + <p>Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK Novell fonctionne correctement. Ces certificats - peuvent être spécifiés sous forme de fichiers au format binaire - DER ou codés en Base64 (PEM).</p> + peuvent être spécifiés sous forme de fichiers au format binaire + DER ou codés en Base64 (PEM).</p> - <p>Note: Les certificats clients sont spécifiés globalement - plutôt qu'à chaque connexion, et doivent être spécifiés à l'aide - de la directive LDAPTrustedGlobalCert comme ci-dessous. Définir + <p>Note: Les certificats clients sont spécifiés globalement + plutôt qu'à chaque connexion, et doivent être spécifiés à l'aide + de la directive LDAPTrustedGlobalCert comme ci-dessous. Définir des certificats clients via la directive LDAPTrustedClientCert - engendrera une erreur qui sera journalisée, au moment de la + engendrera une erreur qui sera journalisée, au moment de la tentative de connexion avec le serveur LDAP.</p> - <p>Le SDK supporte SSL et STARTTLS, le choix étant défini par le - paramètre de la directive LDAPTrustedMode. Si une URL de type - ldaps:// est spécifiée, le mode SSL est forcé, et l'emporte sur + <p>Le SDK supporte SSL et STARTTLS, le choix étant défini par le + paramètre de la directive LDAPTrustedMode. Si une URL de type + ldaps:// est spécifiée, le mode SSL est forcé, et l'emporte sur cette directive.</p> - <pre class="prettyprint lang-config"># Spécifie deux fichiers contenant des certificats de CA + <pre class="prettyprint lang-config"># Spécifie deux fichiers contenant des certificats de CA LDAPTrustedGlobalCert CA_DER /certs/cacert1.der LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem -# Spécifie un fichier contenant des certificats clients -# ainsi qu'une clé +# Spécifie un fichier contenant des certificats clients +# ainsi qu'une clé LDAPTrustedGlobalCert CERT_BASE64 /certs/cert1.pem LDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password] # N'utilisez pas cette directive, sous peine de provoquer @@ -383,24 +383,24 @@ LDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password] <h3><a name="settingcerts-openldap" id="settingcerts-openldap">SDK OpenLDAP</a></h3> - <p>Un ou plusieurs certificats de CA doivent être spécifiés pour + <p>Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK OpenLDAP fonctionne correctement. Ces certificats - peuvent être spécifiés sous forme de fichiers au format binaire - DER ou codés en Base64 (PEM).</p> + peuvent être spécifiés sous forme de fichiers au format binaire + DER ou codés en Base64 (PEM).</p> - <p>Les certificats clients sont spécifiés pour chaque connexion - à l'aide de la directive LDAPTrustedClientCert.</p> + <p>Les certificats clients sont spécifiés pour chaque connexion + à l'aide de la directive LDAPTrustedClientCert.</p> - <p>La documentation du SDK prétend que SSL et STARTTLS sont - supportés ; cependant, STARTTLS semble ne pas fonctionner avec - toutes les versions du SDK. Le mode SSL/TLS peut être défini en - utilisant le paramètre de la directive LDAPTrustedMode. Si une + <p>La documentation du SDK prétend que SSL et STARTTLS sont + supportés ; cependant, STARTTLS semble ne pas fonctionner avec + toutes les versions du SDK. Le mode SSL/TLS peut être défini en + utilisant le paramètre de la directive LDAPTrustedMode. Si une URL de type - ldaps:// est spécifiée, le mode SSL est forcé. La documentation - OpenLDAP indique que le support SSL (ldaps://) tend à être - remplacé par TLS, bien que le mode SSL fonctionne toujours.</p> + ldaps:// est spécifiée, le mode SSL est forcé. La documentation + OpenLDAP indique que le support SSL (ldaps://) tend à être + remplacé par TLS, bien que le mode SSL fonctionne toujours.</p> - <pre class="prettyprint lang-config"># Spécifie deux fichiers contenant des certificats de CA + <pre class="prettyprint lang-config"># Spécifie deux fichiers contenant des certificats de CA LDAPTrustedGlobalCert CA_DER /certs/cacert1.der LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <Location "/ldap-status"> @@ -426,24 +426,24 @@ LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <h3><a name="settingcerts-solaris" id="settingcerts-solaris">SDK Solaris</a></h3> - <p>SSL/TLS pour les bibliothèques LDAP propres à Solaris n'est - pas encore supporté. Si nécessaire, installez et utilisez plutôt - les bibliothèques OpenLDAP.</p> + <p>SSL/TLS pour les bibliothèques LDAP propres à Solaris n'est + pas encore supporté. Si nécessaire, installez et utilisez plutôt + les bibliothèques OpenLDAP.</p> <h3><a name="settingcerts-microsoft" id="settingcerts-microsoft">SDK Microsoft</a></h3> <p>La configuration des certificats SSL/TLS pour les - bibliothèques LDAP propres à Microsoft s'effectue à l'intérieur - du registre système, et aucune directive de configuration n'est + bibliothèques LDAP propres à Microsoft s'effectue à l'intérieur + du registre système, et aucune directive de configuration n'est requise.</p> - <p>SSL et TLS sont tous deux supportés en utilisant des URLs de - type ldaps://, ou en définissant la directive LDAPTrustedMode à + <p>SSL et TLS sont tous deux supportés en utilisant des URLs de + type ldaps://, ou en définissant la directive LDAPTrustedMode à cet effet.</p> - <p>Note: L'état du support des certificats clients n'est pas + <p>Note: L'état du support des certificats clients n'est pas encore connu pour ce SDK.</p> @@ -452,77 +452,77 @@ LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <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>Nombre maximum d'entrées dans le cache LDAP +<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#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>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> + <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>Durée pendant laquelle les entrées du cache restent +<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#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>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 + <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>Désactive les connexions d'arrière-plan qui sont restées +<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#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>Disponible à partir de la version 2.3.12 du serveur HTTP +<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>Cette directive permet de spécifier la durée maximale, en + <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> + 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>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>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 : + 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> @@ -530,7 +530,7 @@ Apache</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="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>Spécifie le délai d'attente en secondes de la socket de +<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> @@ -538,24 +538,24 @@ connexion</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> </table> <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_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 + <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 + comportement final est entièrement dicté par la bibliothèque client LDAP. </div> @@ -563,33 +563,33 @@ connexion</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="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>Active le débogage dans le SDK LDAP</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#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>Active les options de débogage LDAP spécifiques au SDK, qui - entraînent en général une journalisation d'informations verbeuses du + <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> + 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 + 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>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 + <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> + utilisée.</p> </div> @@ -597,57 +597,57 @@ connexion</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="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>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#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#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>Cette directive permet de spécifier le nombre d'entrées que + <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> + 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>Durée pendant laquelle les entrées du cache d'opérations +<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#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>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> + <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>Le nombre maximum de redirections vers des serveurs -alternatifs (referrals) avant l'abandon de la requête +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#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>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 + <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>L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.</p> +<p>L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.</p> </div> </div> @@ -655,22 +655,22 @@ LDAP.</td></tr> <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>Active la redirection vers des serveurs alternatifs au -cours des requêtes vers le serveur LDAP.</td></tr> +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#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>Le paramètre <var>default</var> est disponible depuis la +<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>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 + 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 @@ -679,128 +679,128 @@ version 2.4.7 du serveur HTTP Apache.</td></tr> <dl> <dt>"on"</dt> <dd> <p>Avec la valeur "on", la prise en compte des redirections - LDAP par le SDK sous-jacent est activée, la directive + 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> + "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.</p></dd> <dt>"off"</dt> <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> + LDAP par le SDK sous-jacent est complètement désactivée.</p></dd> <dt>"default"</dt> <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 + 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> + "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.</p></dd> </dl> <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> + 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>Définit le nombre maximum de tentatives de connexions au +<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#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>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>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> + 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>Définit le temps d'attente avant un autre essai de connexion au +<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#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>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>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>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> + 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>Définit le fichier du cache en mémoire -partagée</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>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 + <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>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> + 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>Taille en octets du cache en mémoire partagée</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#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>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> + <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>Spécifie le délai d'attente pour les opérations de +<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#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>Disponible à partir de la version 2.3.5 du serveur HTTP +<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>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, + <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>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 + <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 + pare-feu est configuré pour envoyer des paquets TCP RST au lieu de rejeter silencieusement les paquets.</p> <div class="note"> - <p>Les délais pour les opérations de comparaison LDAP nécessitent un + <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> @@ -809,45 +809,45 @@ Apache</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="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>Définit le nom de fichier contenant un certificat client ou -un alias renvoyant vers un certificat client spécifique à une connexion. +<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#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_ldap</td></tr> </table> - <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 + <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 + 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> + 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 - 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>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> + <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>Définit le nom de fichier ou la base de données contenant -les Autorités de Certification de confiance globales ou les certificats +<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> @@ -855,87 +855,87 @@ clients globaux</td></tr> <tr><th><a href="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>Cette directive permet de spécifier le chemin et le nom du + <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 + 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 + 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 + 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> + é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 - 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 + <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 + <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> + <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>Spécifie le mode (SSL ou TLS) à utiliser lors de la -connexion à un serveur LDAP.</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>Les modes suivants sont supportés :</p> + <p>Les modes suivants sont supportés :</p> <ul> <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> + <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>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>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>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> + <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 la vérification du certificat du +<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#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>Cette directive permet de spécifier s'il faut forcer la - vérification d'un certificat de serveur lors de l'établissement + <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="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_ldap.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_ldap.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -954,7 +954,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_ldap.html' } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_log_forensic.html b/docs/manual/mod/mod_log_forensic.html index 45ef827707..5594ccb7f6 100644 --- a/docs/manual/mod/mod_log_forensic.html +++ b/docs/manual/mod/mod_log_forensic.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_log_forensic.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_log_forensic.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_log_forensic.html.fr b/docs/manual/mod/mod_log_forensic.html.fr index 1fd1ade007..c068fcb506 100644 --- a/docs/manual/mod/mod_log_forensic.html.fr +++ b/docs/manual/mod/mod_log_forensic.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,58 +27,58 @@ <div id="preamble"><h1>Module Apache mod_log_forensic</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_forensic.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_log_forensic.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_log_forensic.html" title="Français"> fr </a> | <a href="../ja/mod/mod_log_forensic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | -<a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation légale des requêtes envoyées au +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation légale des requêtes envoyées au serveur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>log_forensic_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_log_forensic.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>log_forensic_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_log_forensic.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet la journalisation légale des requêtes client.</p> + <p>Ce module permet la journalisation légale des requêtes client.</p> - <p>La création du fichier journal correspondant s'effectue via la + <p>La création du fichier journal correspondant s'effectue via la directive <code class="directive">ForensicLog</code> comme suit :</p> <pre class="prettyprint lang-config">ForensicLog logs/forensic_log</pre> - <p>La journalisation s'effectuant avant et après le traitement de la - requête, le journal légal contient deux lignes pour chaque requête. - Le processus de journalisation légale est très strict, à savoir + <p>La journalisation s'effectuant avant et après le traitement de la + requête, le journal légal contient deux lignes pour chaque requête. + Le processus de journalisation légale est très strict, à savoir :</p> <ul> - <li>Le format est figé. Vous ne pouvez pas modifier le format du - journal à l'exécution.</li> - <li>S'il ne peut pas enregistrer ses données, le processus enfant se - termine aussitôt, et peut éventuellement enregistrer un vidage - mémoire (selon la définition de la directive <code class="directive"><a href="../mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code>).</li> + <li>Le format est figé. Vous ne pouvez pas modifier le format du + journal à l'exécution.</li> + <li>S'il ne peut pas enregistrer ses données, le processus enfant se + termine aussitôt, et peut éventuellement enregistrer un vidage + mémoire (selon la définition de la directive <code class="directive"><a href="../mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code>).</li> </ul> - <p>Pour interpréter les données du journal - légal afin d'identifier les requêtes dont le traitement n'a - pas été mené à bien, vous pouvez vous + <p>Pour interpréter les données du journal + légal afin d'identifier les requêtes dont le traitement n'a + pas été mené à bien, vous pouvez vous aider du script <code>check_forensic</code> qui se trouve dans le - répertoire support de la distribution.</p> + répertoire support de la distribution.</p> <div class="example"><p><code> check-forensic forensic_log </code></p></div> - <div class="note">Note de traduction : le terme "légal" utilisé dans le présent document ne suggère aucunement que - ce module apporte une valeur juridique aux journaux. Il est à comprendre dans le contexte - similaire à ce que l'on trouve en analyse medico-légale. En d'autres termes, la finalité de ce module - est de simplifier les opérations d'investigation autour du traitement des requêtes par le serveur.</div> + <div class="note">Note de traduction : le terme "légal" utilisé dans le présent document ne suggère aucunement que + ce module apporte une valeur juridique aux journaux. Il est à comprendre dans le contexte + similaire à ce que l'on trouve en analyse medico-légale. En d'autres termes, la finalité de ce module + est de simplifier les opérations d'investigation autour du traitement des requêtes par le serveur.</div> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#formats">Format du journal Forensic</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de -sécurité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de +sécurité</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#forensiclog">ForensicLog</a></li> @@ -92,24 +92,24 @@ d'Apache</a></li> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="formats" id="formats">Format du journal Forensic</a></h2> - <p>Chaque requête fait l'objet d'une double journalisation. La - requête est journalisée une première fois avant son traitement - (c'est à dire après la réception des en-têtes). La deuxième entrée - du journal est écrite <em>après</em> le traitement de la requête, en + <p>Chaque requête fait l'objet d'une double journalisation. La + requête est journalisée une première fois avant son traitement + (c'est à dire après la réception des en-têtes). La deuxième entrée + du journal est écrite <em>après</em> le traitement de la requête, en fait au moment de la journalisation habituelle.</p> - <p>Un identifiant unique est attribué à chaque requête afin de - pouvoir l'identifier. Cette identifiant légal peut faire l'objet - d'un enregistrement dans le journal standard en utilisant l'élément - de chaîne de format <code>%{forensic-id}n</code>. Si vous utilisez - <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>, c'est l'identifiant qu'il génère qui - sera utilisé.</p> + <p>Un identifiant unique est attribué à chaque requête afin de + pouvoir l'identifier. Cette identifiant légal peut faire l'objet + d'un enregistrement dans le journal standard en utilisant l'élément + de chaîne de format <code>%{forensic-id}n</code>. Si vous utilisez + <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>, c'est l'identifiant qu'il génère qui + sera utilisé.</p> - <p>La première partie de la journalisation de la requête enregistre - l'identifiant légal, la ligne de la requête et tous les en-têtes - reçus séparés par des caractères pipe (<code>|</code>). Voici à - titre d'exemple à quoi pourrait ressembler une telle entrée (tout - étant rassemblé sur une seule ligne) :</p> + <p>La première partie de la journalisation de la requête enregistre + l'identifiant légal, la ligne de la requête et tous les en-têtes + reçus séparés par des caractères pipe (<code>|</code>). Voici à + titre d'exemple à quoi pourrait ressembler une telle entrée (tout + étant rassemblé sur une seule ligne) :</p> <div class="example"><p><code> +yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif @@ -118,9 +118,9 @@ d'Apache</a></li> Firefox/0.8|Accept:image/png, <var>etc...</var> </code></p></div> - <p>Le caractère plus ('+') de début indique qu'il s'agit de la - première entrée de journal pour cette requête. La seconde entrée ne - contiendra qu'un caractère moins ('-') suivi de l'identifiant :</p> + <p>Le caractère plus ('+') de début indique qu'il s'agit de la + première entrée de journal pour cette requête. La seconde entrée ne + contiendra qu'un caractère moins ('-') suivi de l'identifiant :</p> <div class="example"><p><code> -yQtJf8CoAB4AAFNXBIEAAAAA @@ -129,69 +129,69 @@ d'Apache</a></li> <p>Le script <code>check_forensic</code> prend comme argument le nom du fichier journal. Il recherche ces paires d'identifiants <code>+</code>/<code>-</code> et affiche un message d'erreur si la - journalisation d'une requête n'est pas complète.</p> + journalisation d'une requête n'est pas complète.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="security" id="security">Considérations à propos de -sécurité</a></h2> - <p>Voir le document <a href="../misc/security_tips.html#serverroot">conseils en matière de - sécurité</a> pour des détails sur les raisons pour lesquelles votre - sécurité pourrait être compromise si le répertoire dans lequel les - fichiers journaux sont stockés sont inscriptibles par tout autre - utilisateur que celui qui démarre le serveur.</p> - <p>Les fichiers journaux peuvent contenir des données sensibles - comme le contenu des en-têtes <code>Authorization:</code> (qui - peuvent contenir des mots de passe) ; ils ne doivent donc être - lisibles que par l'utilisateur qui démarre le serveur.</p> +<h2><a name="security" id="security">Considérations à propos de +sécurité</a></h2> + <p>Voir le document <a href="../misc/security_tips.html#serverroot">conseils en matière de + sécurité</a> pour des détails sur les raisons pour lesquelles votre + sécurité pourrait être compromise si le répertoire dans lequel les + fichiers journaux sont stockés sont inscriptibles par tout autre + utilisateur que celui qui démarre le serveur.</p> + <p>Les fichiers journaux peuvent contenir des données sensibles + comme le contenu des en-têtes <code>Authorization:</code> (qui + peuvent contenir des mots de passe) ; ils ne doivent donc être + lisibles que par l'utilisateur qui démarre 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="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>Définit le nom de fichier du journal légal</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>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 + 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> + <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 + <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>nom-fichier</var></dt> - <dd>Un nom de fichier relatif au répertoire défini par la + <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>Le caractère pipe "<code>|</code>", suivi du chemin vers un + <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>. + 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é + <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 + 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>Lors de la spécification d'un chemin de fichier sur les + <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 + 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> @@ -200,9 +200,9 @@ sécurité</a></h2> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_forensic.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_log_forensic.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_log_forensic.html" title="Français"> fr </a> | <a href="../ja/mod/mod_log_forensic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | -<a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -221,7 +221,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_log_forens } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_lua.html b/docs/manual/mod/mod_lua.html index 021f52ce8d..f5280d8545 100644 --- a/docs/manual/mod/mod_lua.html +++ b/docs/manual/mod/mod_lua.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_lua.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_lua.html.fr b/docs/manual/mod/mod_lua.html.fr index ca1f02a898..2f0b31d07e 100644 --- a/docs/manual/mod/mod_lua.html.fr +++ b/docs/manual/mod/mod_lua.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,39 +27,39 @@ <div id="preamble"><h1>Module Apache mod_lua</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_lua.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_lua.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_lua.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des points d'entrée Lua dans différentes parties du -traitement des requêtes httpd</td></tr> -<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>lua_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_lua.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>versions 2.3 et supérieures</td></tr></table> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des points d'entrée Lua dans différentes parties du +traitement des requêtes httpd</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>lua_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_lua.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>versions 2.3 et supérieures</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet d'ajouter au serveur des extensions sous forme de -scripts écrits dans le langage de programmation Lua. +scripts écrits dans le langage de programmation Lua. <code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> fournit de nombreuses extensions (hooks) disponibles avec les modules natifs du serveur HTTP Apache, -comme les associations de requêtes à des fichiers, la génération de -réponses dynamiques, le contrôle d'accès, l'authentification et +comme les associations de requêtes à des fichiers, la génération de +réponses dynamiques, le contrôle d'accès, l'authentification et l'autorisation.</p> -<p>Vous trouverez davantage d'informations à propos du langage de +<p>Vous trouverez davantage d'informations à propos du langage de programmation Lua sur <a href="http://www.lua.org/">le site web de Lua</a>.</p> -<div class="note"><code>mod_lua</code> est encore au stade expérimental. Son mode -d'utilisation et son comportement pourront changer à tout moment jusqu'à -ce qu'il passe au stade stable, et ce même entre deux versions stables -2.4.x. N'oublez pas de consulter le fichier CHANGES avant toute mise à +<div class="note"><code>mod_lua</code> est encore au stade expérimental. Son mode +d'utilisation et son comportement pourront changer à tout moment jusqu'à +ce qu'il passe au stade stable, et ce même entre deux versions stables +2.4.x. N'oublez pas de consulter le fichier CHANGES avant toute mise à jour.</div> <div class="warning"><h3>Avertissement</h3> -<p>Ce module possède une grande capacité d'action sur le fonctrionnement -de httpd, ce qui lui confère une grande puissance, mais peut aussi -induire un risque de sécurité. Il est déconseillé d'utiliser ce module -sur un serveur partagé avec des utilisateurs auxquels vous ne pouvez pas +<p>Ce module possède une grande capacité d'action sur le fonctrionnement +de httpd, ce qui lui confère une grande puissance, mais peut aussi +induire un risque de sécurité. Il est déconseillé d'utiliser ce module +sur un serveur partagé avec des utilisateurs auxquels vous ne pouvez pas accorder une confiance absolue, car il peut permettre de modifier le fonctionnement interne de httpd.</p> </div> @@ -72,12 +72,12 @@ fonctionnement interne de httpd.</p> <li><img alt="" src="../images/down.gif" /> <a href="#writingauthzproviders">Ecriture de fournisseurs d'autorisation</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#writinghooks">Ecriture de fonctions d'accroche (hooks)</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#datastructures">Structures de données</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#functions">Méthodes de l'objet request_rec</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#datastructures">Structures de données</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#functions">Méthodes de l'objet request_rec</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#logging">Fonctions de journalisation</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#apache2">Paquet apache2</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#modifying_buckets">Modification de contenu avec les filtres lua</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#databases">Connectivité aux bases de données</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#databases">Connectivité aux bases de données</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#luaauthzprovider">LuaAuthzProvider</a></li> @@ -112,8 +112,8 @@ fonctionnement interne de httpd.</p> <p> -<code>mod_lua</code> fournit un gestionnaire nommé -<code>lua-script</code> qui peut être utilisé avec une directive +<code>mod_lua</code> fournit un gestionnaire nommé +<code>lua-script</code> qui peut être utilisé avec une directive <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> :</p> <pre class="prettyprint lang-config"><Files "*.lua"> @@ -122,26 +122,26 @@ fonctionnement interne de httpd.</p> <p> -Ceci aura pour effet de faire traiter les requêtes pour les fichiers +Ceci aura pour effet de faire traiter les requêtes pour les fichiers dont l'extension est <code>.lua</code> par <code>mod_lua</code> en invoquant cette fonction de <code>gestion</code> de fichier. </p> -<p>Pour plus de détails, voir la directive +<p>Pour plus de détails, voir la directive <code class="directive">LuaMapHandler</code>. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="writinghandlers" id="writinghandlers">Ecrire des gestionnaires</a></h2> <p>Dans l'API du serveur HTTP Apache, un gestionnaire est une sorte de -point d'accroche (hook) spécifique responsable de la génération de la -réponse. <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> et +point d'accroche (hook) spécifique responsable de la génération de la +réponse. <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> et <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> sont des exemples de modules comportant un gestionnaire.</p> -<p><code>mod_lua</code> cherche toujours à invoquer une fonction Lua pour le -gestionnaire, plutôt que de simplement évaluer le corps d'un script dans -le style de CGI. Une fonction de gestionnaire se présente comme suit :</p> +<p><code>mod_lua</code> cherche toujours à invoquer une fonction Lua pour le +gestionnaire, plutôt que de simplement évaluer le corps d'un script dans +le style de CGI. Une fonction de gestionnaire se présente comme suit :</p> <pre class="prettyprint lang-lua"> @@ -151,9 +151,9 @@ le style de CGI. Une fonction de gestionnaire se présente comme suit :</p> require "string" --[[ - Il s'agit du nom de méthode par défaut pour les gestionnaires Lua ; + Il s'agit du nom de méthode par défaut pour les gestionnaires Lua ; voir les noms de fonctions optionnels dans la directive - LuaMapHandler pour choisir un point d'entrée différent. + LuaMapHandler pour choisir un point d'entrée différent. --]] function handle(r) r.content_type = "text/plain" @@ -170,7 +170,7 @@ function handle(r) end else elseif r.method == 'PUT' then --- message d'erreur personnalisé +-- message d'erreur personnalisé r:puts("Unsupported HTTP method " .. r.method) r.status = 405 return apache2.OK @@ -183,13 +183,13 @@ end</pre> <p> -Ce gestionnaire se contente d'afficher les arguments codés d'un uri ou +Ce gestionnaire se contente d'afficher les arguments codés d'un uri ou d'un formulaire dans un page au format texte. </p> <p> -Cela signifie que vous pouvez (et êtes encouragé à) avoir plusieurs -gestionnaires (ou points d'entrée, ou filtres) dans le même script. +Cela signifie que vous pouvez (et êtes encouragé à ) avoir plusieurs +gestionnaires (ou points d'entrée, ou filtres) dans le même script. </p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -198,25 +198,25 @@ gestionnaires (ou points d'entrée, ou filtres) dans le même script. <p><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> fournit une interface d'autorisation -de haut niveau bien plus facile à utiliser que dans les hooks -correspondants. Le premier argument de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> permet de spécifier le -fournisseur d'autorisation à utiliser. Pour chaque directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, +de haut niveau bien plus facile à utiliser que dans les hooks +correspondants. Le premier argument de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> permet de spécifier le +fournisseur d'autorisation à utiliser. Pour chaque directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> appellera le fournisseur d'autorisation -spécifié, le reste de la ligne constituant les paramètres. Le -fournisseur considéré va alors vérifier les autorisations et fournir le -résultat dans une valeur de retour.</p> +spécifié, le reste de la ligne constituant les paramètres. Le +fournisseur considéré va alors vérifier les autorisations et fournir le +résultat dans une valeur de retour.</p> -<p>En général, le fournisseur authz est appelé avant l'authentification. -S'il doit connaître le nom d'utilisateur authentifié (ou si -l'utilisateur est appelé à être authentifié), le fournisseur doit +<p>En général, le fournisseur authz est appelé avant l'authentification. +S'il doit connaître le nom d'utilisateur authentifié (ou si +l'utilisateur est appelé à être authentifié), le fournisseur doit renvoyer <code>apache2.AUTHZ_DENIED_NO_USER</code>, ce qui va -déclancher le processus d'authentification et un deuxième appel du +déclancher le processus d'authentification et un deuxième appel du fournisseur authz.</p> <p>La fonction du fournisseur authz ci-dessous accepte deux arguments, -une adresse IP et un nom d'utilisateur. Elle autorise l'accès dans le -cas où la requête provient de l'adresse IP spécifiée, ou si -l'utilisateur authentifié correspond au second argument :</p> +une adresse IP et un nom d'utilisateur. Elle autorise l'accès dans le +cas où la requête provient de l'adresse IP spécifiée, ou si +l'utilisateur authentifié correspond au second argument :</p> <pre class="prettyprint lang-lua"> <strong>authz_provider.lua</strong><br /> @@ -249,11 +249,11 @@ fournisseur <code>foo</code>, et la configure por l'URL <code>/</code> :</p> <h2><a name="writinghooks" id="writinghooks">Ecriture de fonctions d'accroche (hooks)</a></h2> -<p>Les fonctions d'accroche déterminent la manière dont les modules (et -les scripts Lua) participent au traitement des requêtes. Chaque type -d'accroche proposé par le serveur a un rôle spécifique, comme -l'association de requêtes au système de fichiers, le contrôle d'accès, -ou la définition de types MIME : </p> +<p>Les fonctions d'accroche déterminent la manière dont les modules (et +les scripts Lua) participent au traitement des requêtes. Chaque type +d'accroche proposé par le serveur a un rôle spécifique, comme +l'association de requêtes au système de fichiers, le contrôle d'accès, +ou la définition de types MIME : </p> <table class="bordered"><tr class="header"> <th>Phase d'accroche</th> @@ -263,91 +263,91 @@ ou la définition de types MIME : </p> <tr> <td>Gestionnaire rapide</td> <td><code class="directive"><a href="#luaquickhandler">LuaQuickHandler</a></code></td> - <td>Il s'agit de la première accroche appelée lorsqu'une requête - a été associée à un serveur ou un serveur virtuel.</td> + <td>Il s'agit de la première accroche appelée lorsqu'une requête + a été associée à un serveur ou un serveur virtuel.</td> </tr> <tr class="odd"> <td>Phase de traduction</td> <td><code class="directive"><a href="#luahooktranslatename">LuaHookTranslateName</a></code></td> - <td>Cette phase traduit l'URI de la requête en nom de fichier - sur le système. Ce sont des modules comme + <td>Cette phase traduit l'URI de la requête en nom de fichier + sur le système. Ce sont des modules comme <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> et <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> qui interviennent au cours de cette phase.</td> </tr> <tr> <td>Choix du lieu de stockage de la ressource</td> <td><code class="directive"><a href="#luahookmaptostorage">LuaHookMapToStorage</a></code></td> - <td>Cette phase définit le lieu de stockage de la ressource : - physique, en cache ou externe/mandaté. Elle est assurée par les + <td>Cette phase définit le lieu de stockage de la ressource : + physique, en cache ou externe/mandaté. Elle est assurée par les modules de mandat ou de mise en cache.</td> </tr> <tr class="odd"> - <td>Autorisation d'accès</td> + <td>Autorisation d'accès</td> <td><code class="directive"><a href="#luahookaccesschecker">LuaHookAccessChecker</a></code></td> - <td>Cette phase vérifie si un client a l'autorisation d'accès à - la ressource. Elle s'exécute avant l'authentification de - l'utisateur ; il faut donc être prudent. + <td>Cette phase vérifie si un client a l'autorisation d'accès à + la ressource. Elle s'exécute avant l'authentification de + l'utisateur ; il faut donc être prudent. </td> </tr> <tr> - <td>Vérification de l'identifiant utilisateur</td> + <td>Vérification de l'identifiant utilisateur</td> <td><code class="directive"><a href="#luahookcheckuserid">LuaHookCheckUserID</a></code></td> - <td>Cette phase vérifie l'identifiant de l'utilisateur ayant - fait l'objet d'une négociation.</td> + <td>Cette phase vérifie l'identifiant de l'utilisateur ayant + fait l'objet d'une négociation.</td> </tr> <tr class="odd"> - <td>Vérification de l'autorisation d'accès</td> + <td>Vérification de l'autorisation d'accès</td> <td><code class="directive"><a href="#luahookauthchecker">LuaHookAuthChecker</a></code> ou <code class="directive"><a href="#luaauthzprovider">LuaAuthzProvider</a></code></td> - <td>Cette phase vérifie l'autorisation d'accès d'un utilisateur - en fonction des ses paramètres de connexion, comme + <td>Cette phase vérifie l'autorisation d'accès d'un utilisateur + en fonction des ses paramètres de connexion, comme l'identifiant, le certificat, etc... </td> </tr> <tr> - <td>Vérification du type de la ressource</td> + <td>Vérification du type de la ressource</td> <td><code class="directive"><a href="#luahooktypechecker">LuaHookTypeChecker</a></code></td> - <td>Cette phase assigne un type de contenu et un gestionnaire à + <td>Cette phase assigne un type de contenu et un gestionnaire à la ressource.</td> </tr> <tr class="odd"> - <td>Derniers réglages</td> + <td>Derniers réglages</td> <td><code class="directive"><a href="#luahookfixups">LuaHookFixups</a></code></td> - <td>C'est la dernière phase avant l'activation des gestionnaires - de contenu. Toute modification de dernière minute à la requête - doit être effectuée ici.</td> + <td>C'est la dernière phase avant l'activation des gestionnaires + de contenu. Toute modification de dernière minute à la requête + doit être effectuée ici.</td> </tr> <tr> <td>Gestionnaire de contenu</td> <td>fichiers fx. <code>.lua</code> ou directive <code class="directive"><a href="#luamaphandler">LuaMapHandler</a></code></td> - <td>C'est durant cette phase que le contenu est traité. Les - fichiers sont lus, interprétés, certains sont exécutés, et le - résultat obtenu est envoyé au client.</td> + <td>C'est durant cette phase que le contenu est traité. Les + fichiers sont lus, interprétés, certains sont exécutés, et le + résultat obtenu est envoyé au client.</td> </tr> <tr class="odd"> <td>Journalisation</td> <td><code class="directive"><a href="#luahooklog">LuaHookLog</a></code></td> - <td>Lorsqu'une requête a été traitée, plusieurs phases de - journalisation interviennent, et enregistrent leurs résultats - dans les fichiers d'erreur ou d'accès. Mod_lua peut - s'intercaler au départ de ce processus et ainsi contrôler la + <td>Lorsqu'une requête a été traitée, plusieurs phases de + journalisation interviennent, et enregistrent leurs résultats + dans les fichiers d'erreur ou d'accès. Mod_lua peut + s'intercaler au départ de ce processus et ainsi contrôler la journalisation.</td> </tr> </table> -<p>Les fonctions d'accroche reçoivent l'objet de la requête comme seul -argument (sauf LuaAuthzProvider qui reçoit aussi des arguments en +<p>Les fonctions d'accroche reçoivent l'objet de la requête comme seul +argument (sauf LuaAuthzProvider qui reçoit aussi des arguments en provenance de la directive Require). Elles peuvent renvoyer une valeur, -selon la fonction, mais il s'agit en général d'un -code d'état HTTP ou des valeurs OK, DONE, ou DECLINED, -que vous pouvez écrire dans Lua sous la forme <code>apache2.OK</code>, +selon la fonction, mais il s'agit en général d'un +code d'état HTTP ou des valeurs OK, DONE, ou DECLINED, +que vous pouvez écrire dans Lua sous la forme <code>apache2.OK</code>, <code>apache2.DONE</code>, ou <code>apache2.DECLINED</code>.</p> <pre class="prettyprint lang-lua"> <strong>translate_name.lua</strong><br /> --- exemple d'accroche qui réécrit un URI en chemin du système de fichiers. +-- exemple d'accroche qui réécrit un URI en chemin du système de fichiers. require 'apache2' @@ -356,7 +356,7 @@ function translate_name(r) r.filename = r.document_root .. "/find_me.txt" return apache2.OK end - -- on ne gère pas cette URL et on donne sa chance à un autre module + -- on ne gère pas cette URL et on donne sa chance à un autre module return apache2.DECLINED end</pre> @@ -364,13 +364,13 @@ end</pre> <pre class="prettyprint lang-lua"> <strong>translate_name2.lua</strong><br /> ---[[ exemple d'accroche qui réécrit un URI vers un autre URI. Il renvoie - un apache2.DECLINED pour permettre à un autre interpréteur d'URL de +--[[ exemple d'accroche qui réécrit un URI vers un autre URI. Il renvoie + un apache2.DECLINED pour permettre à un autre interpréteur d'URL de travailler sur la substitution, y compris l'accroche translate_name de base dont les tables de correspondances se basent sur DocumentRoot. Note: utilisez le drapeau early/late de la directive pour - l'exécuter avant ou après mod_alias. + l'exécuter avant ou après mod_alias. --]] require 'apache2' @@ -385,18 +385,18 @@ end</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="datastructures" id="datastructures">Structures de données</a></h2> +<h2><a name="datastructures" id="datastructures">Structures de données</a></h2> <dl> <dt>request_rec</dt> <dd> - <p>request_rec est considérée en tant que donnée utilisateur. - Elle possède une métatable qui vous permet d'accomplir des - choses intéressantes. Pour la plus grande partie, elle possède - les mêmes champs que la structure request_rec, la - plupart d'entre eux étant accessibles en lecture et écriture (le - contenu des champs de la table peut être modifié, mais les - champs eux-mêmes ne peuvent pas être établis en tant que tables + <p>request_rec est considérée en tant que donnée utilisateur. + Elle possède une métatable qui vous permet d'accomplir des + choses intéressantes. Pour la plus grande partie, elle possède + les mêmes champs que la structure request_rec, la + plupart d'entre eux étant accessibles en lecture et écriture (le + contenu des champs de la table peut être modifié, mais les + champs eux-mêmes ne peuvent pas être établis en tant que tables distinctes).</p> <table class="bordered"><tr class="header"> @@ -409,68 +409,68 @@ end</pre> <td><code>allowoverrides</code></td> <td>string</td> <td>non</td> - <td>L'option AllowOverride s'applique à la requête courante.</td> + <td>L'option AllowOverride s'applique à la requête courante.</td> </tr> <tr class="odd"> <td><code>ap_auth_type</code></td> <td>string</td> <td>non</td> - <td>Ce champ contient le type d'authentification effectuée + <td>Ce champ contient le type d'authentification effectuée (par exemple <code>basic</code>)</td> </tr> <tr> <td><code>args</code></td> <td>string</td> <td>oui</td> - <td>La chaîne de paramètres de la requête (par exemple + <td>La chaîne de paramètres de la requête (par exemple <code>foo=bar&name=johnsmith</code>)</td> </tr> <tr class="odd"> <td><code>assbackwards</code></td> <td>boolean</td> <td>non</td> - <td>contient true s'il s'agit d'une requête de style HTTP/0.9 - (par exemple <code>GET /foo</code> (sans champs d'en-tête) )</td> + <td>contient true s'il s'agit d'une requête de style HTTP/0.9 + (par exemple <code>GET /foo</code> (sans champs d'en-tête) )</td> </tr> <tr> <td><code>auth_name</code></td> <td>string</td> <td>non</td> - <td>La chaîne d'identification utilisée pour la vérification - de l'autorisation d'accès (si elle est disponible).</td> + <td>La chaîne d'identification utilisée pour la vérification + de l'autorisation d'accès (si elle est disponible).</td> </tr> <tr class="odd"> <td><code>banner</code></td> <td>string</td> <td>non</td> - <td>La bannière du serveur, par exemple <code>Apache HTTP + <td>La bannière du serveur, par exemple <code>Apache HTTP Server/2.4.3 openssl/0.9.8c</code></td> </tr> <tr> <td><code>basic_auth_pw</code></td> <td>string</td> <td>non</td> - <td>Le mot de passe pour l'authentification de base envoyé - avec la requête, s'il existe</td> + <td>Le mot de passe pour l'authentification de base envoyé + avec la requête, s'il existe</td> </tr> <tr class="odd"> <td><code>canonical_filename</code></td> <td>string</td> <td>non</td> - <td>Le nom de fichier canonique de la requête</td> + <td>Le nom de fichier canonique de la requête</td> </tr> <tr> <td><code>content_encoding</code></td> <td>string</td> <td>non</td> - <td>Le type de codage du contenu de la requête courante</td> + <td>Le type de codage du contenu de la requête courante</td> </tr> <tr class="odd"> <td><code>content_type</code></td> <td>string</td> <td>oui</td> - <td>Le type de contenu de la requête courante, tel qu'il a été - déterminé au cours de la phase type_check (par exemple + <td>Le type de contenu de la requête courante, tel qu'il a été + déterminé au cours de la phase type_check (par exemple <code>image/gif</code> ou <code>text/html</code>)</td> </tr> <tr> @@ -495,31 +495,31 @@ end</pre> <td><code>err_headers_out</code></td> <td>table</td> <td>non</td> - <td>L'en-tête MIME de l'environnement pour la réponse, écrit - même en cas d'erreur et conservé pendant les redirections + <td>L'en-tête MIME de l'environnement pour la réponse, écrit + même en cas d'erreur et conservé pendant les redirections internes</td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>oui</td> - <td>Le nom de fichier correspondant à la requête, par exemple - /www/example.com/foo.txt. Il peut être modifié au cours des + <td>Le nom de fichier correspondant à la requête, par exemple + /www/example.com/foo.txt. Il peut être modifié au cours des phases translate-name ou map-to-storage du traitement de la - requête pour permettre au gestionnaire par défaut (ou aux + requête pour permettre au gestionnaire par défaut (ou aux gestionnaires de script) de servir une version du fichier - autre que celle demandée.</td> + autre que celle demandée.</td> </tr> <tr class="odd"> <td><code>handler</code></td> <td>string</td> <td>oui</td> <td>Le nom du <a href="../handler.html">gestionnaire</a> qui - doit traiter la requête, par exemple <code>lua-script</code> - si elle doit être traitée par mod_lua. Cette valeur est en - général définie via les directives <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> ou <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, mais peut aussi l'être - via mod_lua pour permettre à un autre gestionnaire de traiter - une requête spécifique qui ne serait pas traitée par défaut + doit traiter la requête, par exemple <code>lua-script</code> + si elle doit être traitée par mod_lua. Cette valeur est en + général définie via les directives <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> ou <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, mais peut aussi l'être + via mod_lua pour permettre à un autre gestionnaire de traiter + une requête spécifique qui ne serait pas traitée par défaut par ce dernier. </td> </tr> @@ -527,108 +527,108 @@ end</pre> <td><code>headers_in</code></td> <td>table</td> <td>oui</td> - <td>Les en-têtes MIME de l'environnement de la requête. Il - s'agit des en-têtes comme <code>Host, User-Agent, + <td>Les en-têtes MIME de l'environnement de la requête. Il + s'agit des en-têtes comme <code>Host, User-Agent, Referer</code>, etc...</td> </tr> <tr class="odd"> <td><code>headers_out</code></td> <td>table</td> <td>oui</td> - <td>Les en-têtes MIME de l'environnement de la réponse.</td> + <td>Les en-têtes MIME de l'environnement de la réponse.</td> </tr> <tr> <td><code>hostname</code></td> <td>string</td> <td>non</td> - <td>Le nom d'hôte, tel que défini par l'en-tête + <td>Le nom d'hôte, tel que défini par l'en-tête <code>Host:</code> ou par un URI complet.</td> </tr> <tr class="odd"> <td><code>is_https</code></td> <td>boolean</td> <td>non</td> - <td>Indique si la requête à été faite via HTTPS</td> + <td>Indique si la requête à été faite via HTTPS</td> </tr> <tr> <td><code>is_initial_req</code></td> <td>boolean</td> <td>non</td> - <td>Indique si la requête courante est la requête initiale ou - une sous-requête.</td> + <td>Indique si la requête courante est la requête initiale ou + une sous-requête.</td> </tr> <tr class="odd"> <td><code>limit_req_body</code></td> <td>number</td> <td>non</td> - <td>La taille maximale du corps de la requête, ou 0 si aucune + <td>La taille maximale du corps de la requête, ou 0 si aucune limite.</td> </tr> <tr> <td><code>log_id</code></td> <td>string</td> <td>non</td> - <td>L'identifiant de la requête dans les journaux d'accès ou + <td>L'identifiant de la requête dans les journaux d'accès ou d'erreur.</td> </tr> <tr class="odd"> <td><code>method</code></td> <td>string</td> <td>non</td> - <td>La méthode de la requête, par exemple <code>GET</code> ou + <td>La méthode de la requête, par exemple <code>GET</code> ou <code>POST</code>.</td> </tr> <tr> <td><code>notes</code></td> <td>table</td> <td>oui</td> - <td>Une liste de notes qui peuvent être transmises d'un module - à l'autre.</td> + <td>Une liste de notes qui peuvent être transmises d'un module + à l'autre.</td> </tr> <tr class="odd"> <td><code>options</code></td> <td>string</td> <td>non</td> - <td>La valeur de la directive Options pour la requête + <td>La valeur de la directive Options pour la requête courante.</td> </tr> <tr> <td><code>path_info</code></td> <td>string</td> <td>non</td> - <td>La valeur de PATH_INFO extraite de la requête.</td> + <td>La valeur de PATH_INFO extraite de la requête.</td> </tr> <tr class="odd"> <td><code>port</code></td> <td>number</td> <td>non</td> - <td>Le port du serveur utilisé par la requête.</td> + <td>Le port du serveur utilisé par la requête.</td> </tr> <tr> <td><code>protocol</code></td> <td>string</td> <td>non</td> - <td>Le protocole utilisé, par exemple <code>HTTP/1.1</code></td> + <td>Le protocole utilisé, par exemple <code>HTTP/1.1</code></td> </tr> <tr class="odd"> <td><code>proxyreq</code></td> <td>string</td> <td>oui</td> - <td>Indique s'il s'agit d'une requête mandatée ou non. Cette - valeur est en général définie au cours de la phase - post_read_request/translate_name du traitement de la requête.</td> + <td>Indique s'il s'agit d'une requête mandatée ou non. Cette + valeur est en général définie au cours de la phase + post_read_request/translate_name du traitement de la requête.</td> </tr> <tr> <td><code>range</code></td> <td>string</td> <td>non</td> - <td>Le contenu de l'en-tête <code>Range:</code>.</td> + <td>Le contenu de l'en-tête <code>Range:</code>.</td> </tr> <tr class="odd"> <td><code>remaining</code></td> <td>number</td> <td>non</td> - <td>Le nombre d'octets du corps de la requête restant à lire.</td> + <td>Le nombre d'octets du corps de la requête restant à lire.</td> </tr> <tr> <td><code>server_built</code></td> @@ -640,82 +640,82 @@ end</pre> <td><code>server_name</code></td> <td>string</td> <td>non</td> - <td>Le nom du serveur pour cette requête.</td> + <td>Le nom du serveur pour cette requête.</td> </tr> <tr> <td><code>some_auth_required</code></td> <td>boolean</td> <td>non</td> - <td>Indique si une autorisation est/était requise pour cette - requête.</td> + <td>Indique si une autorisation est/était requise pour cette + requête.</td> </tr> <tr class="odd"> <td><code>subprocess_env</code></td> <td>table</td> <td>oui</td> - <td>Le jeu de variables d'environnement pour cette requête.</td> + <td>Le jeu de variables d'environnement pour cette requête.</td> </tr> <tr> <td><code>started</code></td> <td>number</td> <td>non</td> - <td>Le moment où le serveur a été (re)démarré, en secondes + <td>Le moment où le serveur a été (re)démarré, en secondes depuis epoch (1er janvier 1970)</td> </tr> <tr class="odd"> <td><code>status</code></td> <td>number</td> <td>oui</td> - <td>Le code de retour (courant) pour cette requête, par + <td>Le code de retour (courant) pour cette requête, par exemple <code>200</code> ou <code>404</code>.</td> </tr> <tr> <td><code>the_request</code></td> <td>string</td> <td>non</td> - <td>La chaîne de la requête telle qu'elle a été envoyée par le + <td>La chaîne de la requête telle qu'elle a été envoyée par le client, par exemple <code>GET /foo/bar HTTP/1.1</code>.</td> </tr> <tr class="odd"> <td><code>unparsed_uri</code></td> <td>string</td> <td>non</td> - <td>La partie URI non interprétée de la requête</td> + <td>La partie URI non interprétée de la requête</td> </tr> <tr> <td><code>uri</code></td> <td>string</td> <td>oui</td> - <td>L'URI après interprétation par httpd</td> + <td>L'URI après interprétation par httpd</td> </tr> <tr class="odd"> <td><code>user</code></td> <td>string</td> <td>oui</td> - <td>Si une authentification a été effectuée, nom de - l'utilisateur authentifié.</td> + <td>Si une authentification a été effectuée, nom de + l'utilisateur authentifié.</td> </tr> <tr> <td><code>useragent_ip</code></td> <td>string</td> <td>non</td> - <td>L'adresse IP de l'agent qui a envoyé la requête</td> + <td>L'adresse IP de l'agent qui a envoyé la requête</td> </tr> </table> </dd> </dl> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="functions" id="functions">Méthodes de l'objet request_rec</a></h2> +<h2><a name="functions" id="functions">Méthodes de l'objet request_rec</a></h2> -<p>L'objet request_rec possède (au minimum) les méthodes suivantes :</p> +<p>L'objet request_rec possède (au minimum) les méthodes suivantes :</p> <pre class="prettyprint lang-lua">r:flush() -- vide le tampon de sortie - -- Renvoie true si le vidage a été effectué avec succès, + -- Renvoie true si le vidage a été effectué avec succès, -- false dans le cas contraire. -while nous_avons_des_données_à_envoyer do - r:puts("Bla bla bla\n") -- envoi des données à envoyer vers le tampon +while nous_avons_des_données_à _envoyer do + r:puts("Bla bla bla\n") -- envoi des données à envoyer vers le tampon r:flush() -- vidage du tampon (envoi au client) r.usleep(500000) -- mise en attente pendant 0.5 secondes et bouclage end</pre> @@ -723,11 +723,11 @@ end</pre> <pre class="prettyprint lang-lua">r:addoutputfilter(name|function) -- ajoute un filtre en sortie -r:addoutputfilter("fooFilter") -- insère le filtre fooFilter dans le flux de sortie</pre> +r:addoutputfilter("fooFilter") -- insère le filtre fooFilter dans le flux de sortie</pre> <pre class="prettyprint lang-lua">r:sendfile(filename) -- envoie un fichier entier au client en utilisant sendfile s'il est - -- supporté par la plateforme : + -- supporté par la plateforme : if use_sendfile_thing then r:sendfile("/var/www/large_file.img") @@ -735,75 +735,75 @@ end</pre> <pre class="prettyprint lang-lua">r:parseargs() -- renvoie deux tables : une table standard de couples - -- clé/valeur pour les données GET simples, - -- et une autre pour les données - -- multivaluées (par exemple foo=1&foo=2&foo=3) : + -- clé/valeur pour les données GET simples, + -- et une autre pour les données + -- multivaluées (par exemple foo=1&foo=2&foo=3) : local GET, GETMULTI = r:parseargs() r:puts("Votre nom est : " .. GET['name'] or "Unknown")</pre> -<pre class="prettyprint lang-lua">r:parsebody()([sizeLimit]) -- interprète le corps de la - -- requête en tant que POST et renvoie +<pre class="prettyprint lang-lua">r:parsebody()([sizeLimit]) -- interprète le corps de la + -- requête en tant que POST et renvoie -- deux tables lua, comme r:parseargs(). Un - -- nombre optionnel peut être fourni - -- pour spécifier le nombre maximal - -- d'octets à interpréter. La - -- valeur par défaut est 8192. + -- nombre optionnel peut être fourni + -- pour spécifier le nombre maximal + -- d'octets à interpréter. La + -- valeur par défaut est 8192. local POST, POSTMULTI = r:parsebody(1024*1024) r:puts("Votre nom est : " .. POST['name'] or "Unknown")</pre> -<pre class="prettyprint lang-lua">r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la réponse</pre> +<pre class="prettyprint lang-lua">r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la réponse</pre> -<pre class="prettyprint lang-lua">r:write("une simple chaîne") -- affichage dans le corps de la réponse</pre> +<pre class="prettyprint lang-lua">r:write("une simple chaîne") -- affichage dans le corps de la réponse</pre> -<pre class="prettyprint lang-lua">r:escape_html("<html>test</html>") -- Echappe le code HTML et renvoie le résultat</pre> +<pre class="prettyprint lang-lua">r:escape_html("<html>test</html>") -- Echappe le code HTML et renvoie le résultat</pre> -<pre class="prettyprint lang-lua">r:base64_encode(string) -- Encode une chaîne à l'aide du standard de codage Base64. +<pre class="prettyprint lang-lua">r:base64_encode(string) -- Encode une chaîne à l'aide du standard de codage Base64. local encoded = r:base64_encode("This is a test") -- returns VGhpcyBpcyBhIHRlc3Q=</pre> -<pre class="prettyprint lang-lua">r:base64_decode(string) -- Décode une chaîne codée en Base64. +<pre class="prettyprint lang-lua">r:base64_decode(string) -- Décode une chaîne codée en Base64. local decoded = r:base64_decode("VGhpcyBpcyBhIHRlc3Q=") -- returns 'This is a test'</pre> -<pre class="prettyprint lang-lua">r:md5(string) -- Calcule et renvoie le condensé MD5 d'une chaîne en mode binaire (binary safe). +<pre class="prettyprint lang-lua">r:md5(string) -- Calcule et renvoie le condensé MD5 d'une chaîne en mode binaire (binary safe). local hash = r:md5("This is a test") -- returns ce114e4501d2f4e2dcea3e17b546f339</pre> -<pre class="prettyprint lang-lua">r:sha1(string) -- Calcule et renvoie le condensé SHA1 d'une chaîne en mode binaire (binary safe). +<pre class="prettyprint lang-lua">r:sha1(string) -- Calcule et renvoie le condensé SHA1 d'une chaîne en mode binaire (binary safe). local hash = r:sha1("This is a test") -- returns a54d88e06612d820bc3be72877c74f257b561b19</pre> -<pre class="prettyprint lang-lua">r:escape(string) -- Echappe une chaîne de type URL. +<pre class="prettyprint lang-lua">r:escape(string) -- Echappe une chaîne de type URL. local url = "http://foo.bar/1 2 3 & 4 + 5" local escaped = r:escape(url) -- renvoie 'http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5'</pre> -<pre class="prettyprint lang-lua">r:unescape(string) -- Déséchappe une chaîne de type URL. +<pre class="prettyprint lang-lua">r:unescape(string) -- Déséchappe une chaîne de type URL. local url = "http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5" local unescaped = r:unescape(url) -- renvoie 'http://foo.bar/1 2 3 & 4 + 5'</pre> -<pre class="prettyprint lang-lua">r:construct_url(string) -- Construit une URL à partir d'un URI +<pre class="prettyprint lang-lua">r:construct_url(string) -- Construit une URL à partir d'un URI local url = r:construct_url(r.uri)</pre> -<pre class="prettyprint lang-lua">r.mpm_query(number) -- Interroge le serveur à propos de son module MPM via la requête ap_mpm_query. +<pre class="prettyprint lang-lua">r.mpm_query(number) -- Interroge le serveur à propos de son module MPM via la requête ap_mpm_query. local mpm = r.mpm_query(14) if mpm == 1 then @@ -811,95 +811,95 @@ if mpm == 1 then end</pre> -<pre class="prettyprint lang-lua">r:expr(string) -- Evalue une chaîne de type <a href="../expr.html">expr</a>. +<pre class="prettyprint lang-lua">r:expr(string) -- Evalue une chaîne de type <a href="../expr.html">expr</a>. if r:expr("%{HTTP_HOST} =~ /^www/") then - r:puts("Ce nom d'hôte commence par www") + r:puts("Ce nom d'hôte commence par www") end</pre> -<pre class="prettyprint lang-lua">r:scoreboard_process(a) -- Interroge le serveur à propos du - -- processus à la position <code>a</code>. +<pre class="prettyprint lang-lua">r:scoreboard_process(a) -- Interroge le serveur à propos du + -- processus à la position <code>a</code>. local process = r:scoreboard_process(1) r:puts("Le serveur 1 a comme PID " .. process.pid)</pre> -<pre class="prettyprint lang-lua">r:scoreboard_worker(a, b) -- Interroge le serveur à propos du +<pre class="prettyprint lang-lua">r:scoreboard_worker(a, b) -- Interroge le serveur à propos du -- thread <code>b</code>, dans le processus <code>a</code>. local thread = r:scoreboard_worker(1, 1) r:puts("L'ID du thread 1 du serveur 1 est " .. thread.tid .. " et son -état est " .. thread.status)</pre> +état est " .. thread.status)</pre> -<pre class="prettyprint lang-lua">r:clock() -- Renvoie l'heure courante avec une précision d'une microseconde.</pre> +<pre class="prettyprint lang-lua">r:clock() -- Renvoie l'heure courante avec une précision d'une microseconde.</pre> -<pre class="prettyprint lang-lua">r:requestbody(filename) -- Lit et renvoie le corps d'une requête. - -- Si 'filename' est spécifié, le - -- corps de requête n'est pas - -- renvoyé, mais sauvegardé dans +<pre class="prettyprint lang-lua">r:requestbody(filename) -- Lit et renvoie le corps d'une requête. + -- Si 'filename' est spécifié, le + -- corps de requête n'est pas + -- renvoyé, mais sauvegardé dans -- le fichier correspondant. local input = r:requestbody() -r:puts("Vous m'avez envoyé le corps de requête suivant :\n") +r:puts("Vous m'avez envoyé le corps de requête suivant :\n") r:puts(input)</pre> -<pre class="prettyprint lang-lua">r:add_input_filter(filter_name) -- Ajoute le filtre en entrée 'filter_name'.</pre> +<pre class="prettyprint lang-lua">r:add_input_filter(filter_name) -- Ajoute le filtre en entrée 'filter_name'.</pre> -<pre class="prettyprint lang-lua">r:module_info(module_name) -- Interroge le serveur à propos d'un module. +<pre class="prettyprint lang-lua">r:module_info(module_name) -- Interroge le serveur à propos d'un module. local mod = r.module_info("mod_lua.c") if mod then for k, v in pairs(mod.commands) do r:puts( ("%s: %s\n"):format(k,v)) -- affiche toutes les directives - -- implémentées par ce module. + -- implémentées par ce module. end end</pre> -<pre class="prettyprint lang-lua">r:loaded_modules() -- Renvoie une liste des modules chargés par httpd. +<pre class="prettyprint lang-lua">r:loaded_modules() -- Renvoie une liste des modules chargés par httpd. for k, module in pairs(r:loaded_modules()) do - r:puts("J'ai chargé le module " .. module .. "\n") + r:puts("J'ai chargé le module " .. module .. "\n") end</pre> -<pre class="prettyprint lang-lua">r:runtime_dir_relative(filename) -- Génère le nom d'un fichier run-time - -- (par exemple la mémoire partagée - -- "file") relativement au répertoire de run-time.</pre> +<pre class="prettyprint lang-lua">r:runtime_dir_relative(filename) -- Génère le nom d'un fichier run-time + -- (par exemple la mémoire partagée + -- "file") relativement au répertoire de run-time.</pre> -<pre class="prettyprint lang-lua">r:server_info() -- Renvoie une table contenant des informations à +<pre class="prettyprint lang-lua">r:server_info() -- Renvoie une table contenant des informations à -- propos du serveur, comme le nom de - -- l'exécutable httpd, le module mpm utilisé, etc...</pre> + -- l'exécutable httpd, le module mpm utilisé, etc...</pre> -<pre class="prettyprint lang-lua">r:set_document_root(file_path) -- Définit la racine des documents - -- pour la requête à file_path.</pre> +<pre class="prettyprint lang-lua">r:set_document_root(file_path) -- Définit la racine des documents + -- pour la requête à file_path.</pre> -<pre class="prettyprint lang-lua">r:add_version_component(component_string) -- Ajoute un élément à - -- la bannière du serveur.</pre> +<pre class="prettyprint lang-lua">r:add_version_component(component_string) -- Ajoute un élément à + -- la bannière du serveur.</pre> -<pre class="prettyprint lang-lua">r:set_context_info(prefix, docroot) -- Définit le préfixe et la - -- racine des documents du contexte pour une requête.</pre> +<pre class="prettyprint lang-lua">r:set_context_info(prefix, docroot) -- Définit le préfixe et la + -- racine des documents du contexte pour une requête.</pre> -<pre class="prettyprint lang-lua">r:os_escape_path(file_path) -- Convertit un chemin du système de - -- fichiers en URL indépendamment du système d'exploitation.</pre> +<pre class="prettyprint lang-lua">r:os_escape_path(file_path) -- Convertit un chemin du système de + -- fichiers en URL indépendamment du système d'exploitation.</pre> -<pre class="prettyprint lang-lua">r:escape_logitem(string) -- Echappe une chaîne pour journalisation.</pre> +<pre class="prettyprint lang-lua">r:escape_logitem(string) -- Echappe une chaîne pour journalisation.</pre> -<pre class="prettyprint lang-lua">r.strcmp_match(string, pattern) -- Vérifie si 'string' correspond à +<pre class="prettyprint lang-lua">r.strcmp_match(string, pattern) -- Vérifie si 'string' correspond à -- 'pattern' via la fonction strcmp_match (GLOBs). Par exemple, est-ce que - -- 'www.example.com' correspond à '*.example.com' ? + -- 'www.example.com' correspond à '*.example.com' ? local match = r.strcmp_match("foobar.com", "foo*.com") if match then @@ -907,118 +907,118 @@ if match then end</pre> -<pre class="prettyprint lang-lua">r:set_keepalive() -- Définit l'état de persistance d'une requête. +<pre class="prettyprint lang-lua">r:set_keepalive() -- Définit l'état de persistance d'une requête. -- Renvoie true dans la mesure du possible, false dans le cas contraire.</pre> -<pre class="prettyprint lang-lua">r:make_etag() -- Génère et renvoie le etag pour la requête courante.</pre> +<pre class="prettyprint lang-lua">r:make_etag() -- Génère et renvoie le etag pour la requête courante.</pre> -<pre class="prettyprint lang-lua">r:send_interim_response(clear) -- Renvoie une réponse d'intérim (1xx) au - -- client. Si 'clear' est vrai, les en-têtes disponibles - -- seront envoyés et effacés.</pre> +<pre class="prettyprint lang-lua">r:send_interim_response(clear) -- Renvoie une réponse d'intérim (1xx) au + -- client. Si 'clear' est vrai, les en-têtes disponibles + -- seront envoyés et effacés.</pre> -<pre class="prettyprint lang-lua">r:custom_response(status_code, string) -- Génère et définit une réponse - -- personnalisée pour un code d'état particulier. - -- Le fonctionnement est très proche de celui de la directive ErrorDocument. +<pre class="prettyprint lang-lua">r:custom_response(status_code, string) -- Génère et définit une réponse + -- personnalisée pour un code d'état particulier. + -- Le fonctionnement est très proche de celui de la directive ErrorDocument. r:custom_response(404, "Baleted!")</pre> -<pre class="prettyprint lang-lua">r.exists_config_define(string) -- Vérifie si une définition de configuration existe. +<pre class="prettyprint lang-lua">r.exists_config_define(string) -- Vérifie si une définition de configuration existe. if r.exists_config_define("FOO") then - r:puts("httpd a probablement été lancé avec l'option -DFOO, ou FOO a - été défini dans la configuration") + r:puts("httpd a probablement été lancé avec l'option -DFOO, ou FOO a + été défini dans la configuration") end</pre> -<pre class="prettyprint lang-lua">r:state_query(string) -- Interroge le serveur à propos de son état.</pre> +<pre class="prettyprint lang-lua">r:state_query(string) -- Interroge le serveur à propos de son état.</pre> -<pre class="prettyprint lang-lua">r:stat(filename [,wanted]) -- Exécute stat() sur un fichier, et renvoie une table contenant - -- des informations à propos de ce fichier. +<pre class="prettyprint lang-lua">r:stat(filename [,wanted]) -- Exécute stat() sur un fichier, et renvoie une table contenant + -- des informations à propos de ce fichier. local info = r:stat("/var/www/foo.txt") if info then - r:puts("Ce fichier existe et a été modifié pour la dernière fois à : " .. info.modified) + r:puts("Ce fichier existe et a été modifié pour la dernière fois à : " .. info.modified) end</pre> -<pre class="prettyprint lang-lua">r:regex(string, pattern [,flags]) -- Exécute une recherche à base d'expression rationnelle - -- sur une chaîne, et renvoie les éventuelles correspondances trouvées. +<pre class="prettyprint lang-lua">r:regex(string, pattern [,flags]) -- Exécute une recherche à base d'expression rationnelle + -- sur une chaîne, et renvoie les éventuelles correspondances trouvées. local matches = r:regex("foo bar baz", [[foo (\w+) (\S*)]]) if matches then r:puts("L'expression rationnelle correspond et le dernier mot - capturé ($2) est : " .. matches[2]) + capturé ($2) est : " .. matches[2]) end --- Exemple avec insensibilité à la casse : +-- Exemple avec insensibilité à la casse : local matches = r:regex("FOO bar BAz", [[(foo) bar]], 1) --- les drapeaux peuvent être une combibaison bit à bit de : --- 0x01: insensibilité à la casse +-- les drapeaux peuvent être une combibaison bit à bit de : +-- 0x01: insensibilité à la casse -- 0x02: recherche multiligne</pre> -<pre class="prettyprint lang-lua">r.usleep(microsecondes) -- Interrompt l'exécution du script pendant le nombre de microsecondes spécifié.</pre> +<pre class="prettyprint lang-lua">r.usleep(microsecondes) -- Interrompt l'exécution du script pendant le nombre de microsecondes spécifié.</pre> -<pre class="prettyprint lang-lua">r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une base de données et renvoie une classe database. - -- Voir '<a href="#databases">Connectivité aux bases de données</a>' - -- pour plus de détails.</pre> +<pre class="prettyprint lang-lua">r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une base de données et renvoie une classe database. + -- Voir '<a href="#databases">Connectivité aux bases de données</a>' + -- pour plus de détails.</pre> -<pre class="prettyprint lang-lua">r:ivm_set("key", value) -- Défini une variable Inter-VM avec une valeur spécifique. - -- Ces valeurs sont conservées même si la VM est - -- arrêtée ou non utilisée, et ne doivent donc être - -- utilisées que si MaxConnectionsPerChild > 0. - -- Les valeurs peuvent être de type number, string - -- ou boolean et sont stockées séparément pour +<pre class="prettyprint lang-lua">r:ivm_set("key", value) -- Défini une variable Inter-VM avec une valeur spécifique. + -- Ces valeurs sont conservées même si la VM est + -- arrêtée ou non utilisée, et ne doivent donc être + -- utilisées que si MaxConnectionsPerChild > 0. + -- Les valeurs peuvent être de type number, string + -- ou boolean et sont stockées séparément pour -- chaque processus (elles ne seront donc pas d'une - -- grande utilité si l'on utilise le mpm prefork). + -- grande utilité si l'on utilise le mpm prefork). -r:ivm_get("key") -- Lit le contenu d'une variable définie via ivm_set. Renvoie +r:ivm_get("key") -- Lit le contenu d'une variable définie via ivm_set. Renvoie -- le contenu de la variable si elle existe, ou nil -- dans le cas contraire. --- Voici un exemple de lecture/écriture qui sauvegarde une variable +-- Voici un exemple de lecture/écriture qui sauvegarde une variable -- globale en dehors de la VM : function handle(r) - -- La première VM qui effectue l'appel suivant n'obtiendra aucune - -- valeur, et devra la créer + -- La première VM qui effectue l'appel suivant n'obtiendra aucune + -- valeur, et devra la créer local foo = r:ivm_get("cached_data") if not foo then foo = do_some_calcs() -- simulation de valeurs de retour - r:ivm_set("cached_data", foo) -- définition globale de la variable + r:ivm_set("cached_data", foo) -- définition globale de la variable end - r:puts("La donnée en cache est : ", foo) + r:puts("La donnée en cache est : ", foo) end</pre> -<pre class="prettyprint lang-lua">r:htpassword(string [,algorithm [,cost]]) -- Génère un hash de mot de passe à partir d'une chaîne. - -- algorithm: 0 = APMD5 (défaut), 1 = SHA, 2 = BCRYPT, 3 = CRYPT. - -- cost: ne s'utilise qu'avec l'algorythme BCRYPT (défaut = 5).</pre> +<pre class="prettyprint lang-lua">r:htpassword(string [,algorithm [,cost]]) -- Génère un hash de mot de passe à partir d'une chaîne. + -- algorithm: 0 = APMD5 (défaut), 1 = SHA, 2 = BCRYPT, 3 = CRYPT. + -- cost: ne s'utilise qu'avec l'algorythme BCRYPT (défaut = 5).</pre> -<pre class="prettyprint lang-lua">r:mkdir(dir [,mode]) -- Crée un répertoire et définit son mode via le paramètre optionnel mode.</pre> +<pre class="prettyprint lang-lua">r:mkdir(dir [,mode]) -- Crée un répertoire et définit son mode via le paramètre optionnel mode.</pre> -<pre class="prettyprint lang-lua">r:mkrdir(dir [,mode]) -- Crée des répertoires de manière récursive et définit - -- leur mode via le paramètre optionnel mode.</pre> +<pre class="prettyprint lang-lua">r:mkrdir(dir [,mode]) -- Crée des répertoires de manière récursive et définit + -- leur mode via le paramètre optionnel mode.</pre> -<pre class="prettyprint lang-lua">r:rmdir(dir) -- Supprime un répertoire.</pre> +<pre class="prettyprint lang-lua">r:rmdir(dir) -- Supprime un répertoire.</pre> -<pre class="prettyprint lang-lua">r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à +<pre class="prettyprint lang-lua">r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à -- la valeur optionnelle mtime en msec.</pre> -<pre class="prettyprint lang-lua">r:get_direntries(dir) -- Renvoie une table contenant toutes les entrées de répertoires. +<pre class="prettyprint lang-lua">r:get_direntries(dir) -- Renvoie une table contenant toutes les entrées de répertoires. --- Renvoie un chemin sous forme éclatée en chemin, fichier, extension +-- Renvoie un chemin sous forme éclatée en chemin, fichier, extension function handle(r) local dir = r.context_document_root for _, f in ipairs(r:get_direntries(dir)) do @@ -1032,61 +1032,61 @@ function handle(r) end</pre> -<pre class="prettyprint lang-lua">r.date_parse_rfc(string) -- Interprète une chaîne date/heure et renvoie l'équivalent en secondes depuis epoche.</pre> +<pre class="prettyprint lang-lua">r.date_parse_rfc(string) -- Interprète une chaîne date/heure et renvoie l'équivalent en secondes depuis epoche.</pre> <pre class="prettyprint lang-lua">r:getcookie(key) -- Obtient un cookie HTTP</pre> -<pre class="prettyprint lang-lua">r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple : +<pre class="prettyprint lang-lua">r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple : r:setcookie("foo", "bar and stuff", false, os.time() + 86400)</pre> -<pre class="prettyprint lang-lua">r:wsupgrade() -- Met à jour une connexion vers les WebSockets si possible (et si demandé) : -if r:wsupgrade() then -- si la mise à jour est possible : - r:wswrite("Bienvenue dans les websockets!") -- écrit quelque chose à l'intention du client +<pre class="prettyprint lang-lua">r:wsupgrade() -- Met à jour une connexion vers les WebSockets si possible (et si demandé) : +if r:wsupgrade() then -- si la mise à jour est possible : + r:wswrite("Bienvenue dans les websockets!") -- écrit quelque chose à l'intention du client r:wsclose() -- Au revoir ! end</pre> -<pre class="prettyprint lang-lua">r:wsread() -- Lit un cadre de websocket depuis une connexion vers websocket mise à jour (voir ci-dessus) : +<pre class="prettyprint lang-lua">r:wsread() -- Lit un cadre de websocket depuis une connexion vers websocket mise à jour (voir ci-dessus) : local line, isFinal = r:wsread() -- isFinal indique s'il s'agit du cadre final. -- dans le cas contraire, on peut lire les cadres suivants -r:wswrite("Vous avez écrit : " .. line)</pre> +r:wswrite("Vous avez écrit : " .. line)</pre> -<pre class="prettyprint lang-lua">r:wswrite(line) -- écrit un cadre vers un client WebSocket : +<pre class="prettyprint lang-lua">r:wswrite(line) -- écrit un cadre vers un client WebSocket : r:wswrite("Bonjour le Monde !")</pre> -<pre class="prettyprint lang-lua">r:wsclose() -- ferme une requête WebSocket et l'achève pour httpd : +<pre class="prettyprint lang-lua">r:wsclose() -- ferme une requête WebSocket et l'achève pour httpd : if r:wsupgrade() then r:wswrite("Ecrire quelque chose : ") local line = r:wsread() or "nothing" - r:wswrite("Vous avez écrit : " .. line); + r:wswrite("Vous avez écrit : " .. line); r:wswrite("Au revoir !") r:wsclose() end</pre> -<pre class="prettyprint lang-lua">r:wspeek() -- Vérifie s'il y a des données à lire +<pre class="prettyprint lang-lua">r:wspeek() -- Vérifie s'il y a des données à lire --- Se met en sommeil tant que rien ne nous est envoyé ... +-- Se met en sommeil tant que rien ne nous est envoyé ... while r:wspeek() == false do r.usleep(50000) end --- Il y a des données à lire ! +-- Il y a des données à lire ! local line = r:wsread()</pre> <pre class="prettyprint lang-lua">r:config() -- Extrait une arborescence de l'ensemble de - -- la configuration de httpd pouvant être parcourue</pre> + -- la configuration de httpd pouvant être parcourue</pre> <pre class="prettyprint lang-lua">r:activeconfig() -- Extrait une arborescence de la configuration active - -- de httpd (pour le serveur virtuel sélectionné)</pre> + -- de httpd (pour le serveur virtuel sélectionné)</pre> @@ -1096,7 +1096,7 @@ local line = r:wsread()</pre> <pre class="prettyprint lang-lua"> -- exemples de messages de journalisation r:trace1("Ceci est un message de journalisation de niveau - trace") -- les niveaux valides vont de trace1 à trace8 <br /> + trace") -- les niveaux valides vont de trace1 à trace8 <br /> r:debug("Ceci est un message de journalisation de niveau debug")<br /> r:info("Ceci est un message de journalisation de niveau info")<br /> r:notice("Ceci est un message de journalisation de niveau notice")<br /> @@ -1111,87 +1111,87 @@ local line = r:wsread()</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="apache2" id="apache2">Paquet apache2</a></h2> -<p>Le paquet nommé <code>apache2</code> est fourni avec (au minimum) le +<p>Le paquet nommé <code>apache2</code> est fourni avec (au minimum) le contenu suivant :</p> <dl> <dt>apache2.OK</dt> <dd>Constante interne OK. Les gestionnaires renverront cette valeur - s'ils ont traité la requête.</dd> + s'ils ont traité la requête.</dd> <dt>apache2.DECLINED</dt> <dd>Constante interne DECLINED. Les gestionnaires renverront cette - valeur s'ils n'ont pas l'intention de traiter la requête.</dd> + valeur s'ils n'ont pas l'intention de traiter la requête.</dd> <dt>apache2.DONE</dt> <dd>Constante interne DONE.</dd> <dt>apache2.version</dt> - <dd>Chaîne contenant la version du serveur HTTP Apache</dd> + <dd>Chaîne contenant la version du serveur HTTP Apache</dd> <dt>apache2.HTTP_MOVED_TEMPORARILY</dt> - <dd>Code d'état HTTP</dd> + <dd>Code d'état HTTP</dd> <dt>apache2.PROXYREQ_NONE, apache2.PROXYREQ_PROXY, apache2.PROXYREQ_REVERSE, apache2.PROXYREQ_RESPONSE</dt> - <dd>Constantes internes utilisées par <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> + <dd>Constantes internes utilisées par <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> <dt>apache2.AUTHZ_DENIED, apache2.AUTHZ_GRANTED, apache2.AUTHZ_NEUTRAL, apache2.AUTHZ_GENERAL_ERROR, apache2.AUTHZ_DENIED_NO_USER</dt> - <dd>constantes internes utilisées par <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code></dd> + <dd>constantes internes utilisées par <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code></dd> </dl> -<p>Les autres codes d'état HTTP ne sont pas encore implémentés.</p> +<p>Les autres codes d'état HTTP ne sont pas encore implémentés.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="modifying_buckets" id="modifying_buckets">Modification de contenu avec les filtres lua</a></h2> <p> - Les fonctions de filtrage implémentées via les directives <code class="directive"><a href="#luainputfilter">LuaInputFilter</a></code> ou <code class="directive"><a href="#luaoutputfilter">LuaOutputFilter</a></code> sont conçues comme des - fonctions de 3ème phase non blocantes utilisant des sous-routines - pour suspendre et reprendre l'exécution d'une fonction lorsque des - paquets de données sont envoyés à la chaîne de filtrage. La + Les fonctions de filtrage implémentées via les directives <code class="directive"><a href="#luainputfilter">LuaInputFilter</a></code> ou <code class="directive"><a href="#luaoutputfilter">LuaOutputFilter</a></code> sont conçues comme des + fonctions de 3ème phase non blocantes utilisant des sous-routines + pour suspendre et reprendre l'exécution d'une fonction lorsque des + paquets de données sont envoyés à la chaîne de filtrage. La structure de base d'une telle fonction est : </p> <pre class="prettyprint lang-lua">function filter(r) - -- Nous indiquons tout d'abord que nous sommes prêts à recevoir des - -- blocs de données. - -- Avant ceci, nous pouvons définir notre environnement, tester - -- certaines conditions, et, si nous le jugeons nécessaire, refuser le - -- filtrage d'une requête : + -- Nous indiquons tout d'abord que nous sommes prêts à recevoir des + -- blocs de données. + -- Avant ceci, nous pouvons définir notre environnement, tester + -- certaines conditions, et, si nous le jugeons nécessaire, refuser le + -- filtrage d'une requête : if something_bad then - return -- Le filtrage est sauté + return -- Le filtrage est sauté end - -- Sans se préoccuper des données que nous devons éventuellement ajouter, un arrêt est réalisé ici. - -- Noter que les filtres de sortie sont les seuls capables d'ajouter des éléments au début des données. - -- Les filtres en entrée peuvent ajouter des éléments à la fin des données au stade final. + -- Sans se préoccuper des données que nous devons éventuellement ajouter, un arrêt est réalisé ici. + -- Noter que les filtres de sortie sont les seuls capables d'ajouter des éléments au début des données. + -- Les filtres en entrée peuvent ajouter des éléments à la fin des données au stade final. coroutine.yield([optional header to be prepended to the content]) - -- Après cet arrêt, nous allons recevoir d'autres blocs de données, un par un ; - -- nous pouvons les traiter comme il nous plaît et procéder à la réponse. - -- Ces blocs sont conservés dans la variable globale 'bucket', nous réalisons donc - -- une boucle pour vérifier que 'bucket' n'est pas vide : + -- Après cet arrêt, nous allons recevoir d'autres blocs de données, un par un ; + -- nous pouvons les traiter comme il nous plaît et procéder à la réponse. + -- Ces blocs sont conservés dans la variable globale 'bucket', nous réalisons donc + -- une boucle pour vérifier que 'bucket' n'est pas vide : while bucket ~= nil do local output = mangle(bucket) -- Do some stuff to the content coroutine.yield(output) -- Return our new content to the filter chain end - -- Une fois les blocs de données épuisés, 'bucket' est positionné à une valeur vide ('nil'), - -- ce qui va nous faire sortir de cette boucle et nous amener à l'étape suivante. - -- On peut ajouter ce qu'on veut à la fin des données à cette étape, qui constitue le dernier - -- arrêt. Les filtres d'entrée comme de sortie peuvent servir à ajouter des éléments à la fin - -- des données à cette étape. + -- Une fois les blocs de données épuisés, 'bucket' est positionné à une valeur vide ('nil'), + -- ce qui va nous faire sortir de cette boucle et nous amener à l'étape suivante. + -- On peut ajouter ce qu'on veut à la fin des données à cette étape, qui constitue le dernier + -- arrêt. Les filtres d'entrée comme de sortie peuvent servir à ajouter des éléments à la fin + -- des données à cette étape. coroutine.yield([optional footer to be appended to the content]) end</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="databases" id="databases">Connectivité aux bases de données</a></h2> +<h2><a name="databases" id="databases">Connectivité aux bases de données</a></h2> - <p>Mod_lua implémente une fonctionnalité basique de connexion aux -bases de données permettant d'envoyer des requêtes ou d'exécuter des -commandes auprès des moteurs de base de données les plus courants + <p>Mod_lua implémente une fonctionnalité basique de connexion aux +bases de données permettant d'envoyer des requêtes ou d'exécuter des +commandes auprès des moteurs de base de données les plus courants (mySQL, PostgreSQL, FreeTDS, ODBC, SQLite, Oracle), ainsi que mod_dbd. </p> - <p>L'exemple suivant montre comment se connecter à une base de -données et extraire des informations d'une table :</p> + <p>L'exemple suivant montre comment se connecter à une base de +données et extraire des informations d'une table :</p> <pre class="prettyprint lang-lua">function handle(r) - -- connexion à la base de données + -- connexion à la base de données local database, err = r:dbacquire("mysql", "server=localhost,user=someuser,pass=somepass,dbname=mydb") if not err then - -- Sélection de certaines informations + -- Sélection de certaines informations local results, err = database:select(r, "SELECT `name`, `age` FROM `people` WHERE 1") if not err then local rows = results(0) -- extrait tous les enregistrements en mode synchrone @@ -1203,80 +1203,80 @@ données et extraire des informations d'une table :</p> end database:close() else - r:puts("Connexion à la base de données impossible : " .. err) + r:puts("Connexion à la base de données impossible : " .. err) end end</pre> <p> - Pour utiliser <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code>, spécifiez -<code>mod_dbd</code> comme type de base de données, ou laissez le champ + Pour utiliser <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code>, spécifiez +<code>mod_dbd</code> comme type de base de données, ou laissez le champ vide : </p> <pre class="prettyprint lang-lua">local database = r:dbacquire("mod_dbd")</pre> - <h3><a name="database_object" id="database_object">L'objet database et ses méthodes</a></h3> + <h3><a name="database_object" id="database_object">L'objet database et ses méthodes</a></h3> - <p>L'objet database renvoyé par <code>dbacquire</code> possède -les méthodes suivantes :</p> - <p><strong>Sélection normale et requête vers une base de données + <p>L'objet database renvoyé par <code>dbacquire</code> possède +les méthodes suivantes :</p> + <p><strong>Sélection normale et requête vers une base de données :</strong></p> - <pre class="prettyprint lang-lua">-- Exécution d'une requête et renvoie du nombre d'enregistrements -affectés : + <pre class="prettyprint lang-lua">-- Exécution d'une requête et renvoie du nombre d'enregistrements +affectés : local affected, errmsg = database:query(r, "DELETE FROM `tbl` WHERE 1") --- Exécution d'une requête et renvoie du résultat qui peut être utilisé +-- Exécution d'une requête et renvoie du résultat qui peut être utilisé en mode synchrone ou asynchrone : local result, errmsg = database:select(r, "SELECT * FROM `people` WHERE 1")</pre> - <p><strong>Utilisation de requêtes préparées (recommandé) :</strong></p> - <pre class="prettyprint lang-lua">-- Création et exécution d'une requête préparée : + <p><strong>Utilisation de requêtes préparées (recommandé) :</strong></p> + <pre class="prettyprint lang-lua">-- Création et exécution d'une requête préparée : local statement, errmsg = database:prepare(r, "DELETE FROM `tbl` WHERE `age` > %u") if not errmsg then - local result, errmsg = statement:query(20) -- exécute la requête pour age > 20 + local result, errmsg = statement:query(20) -- exécute la requête pour age > 20 end --- Extrait une requête préparée depuis une directive DBDPrepareSQL : +-- Extrait une requête préparée depuis une directive DBDPrepareSQL : local statement, errmsg = database:prepared(r, "someTag") if not errmsg then - local result, errmsg = statement:select("John Doe", 123) -- injecte les valeurs "John Doe" et 123 dans la requête + local result, errmsg = statement:select("John Doe", 123) -- injecte les valeurs "John Doe" et 123 dans la requête end</pre> - <p><strong>Echappement de valeurs, fermeture de la base données, + <p><strong>Echappement de valeurs, fermeture de la base données, etc...</strong></p> - <pre class="prettyprint lang-lua">-- Echappe une valeur pour pouvoir l'utiliser dans une requête : + <pre class="prettyprint lang-lua">-- Echappe une valeur pour pouvoir l'utiliser dans une requête : local escaped = database:escape(r, [["'|blabla]]) --- Ferme une base de données et libère les liens vers cette dernière : +-- Ferme une base de données et libère les liens vers cette dernière : database:close() --- Vérifie si une connexion à une base de données est en service et -opérationnelle : +-- Vérifie si une connexion à une base de données est en service et +opérationnelle : local connected = database:active()</pre> - <h3><a name="result_sets" id="result_sets">Travail avec les jeux d'enregistrements renvoyés par les requêtes</a></h3> + <h3><a name="result_sets" id="result_sets">Travail avec les jeux d'enregistrements renvoyés par les requêtes</a></h3> - <p>Les jeux d'enregistrements renvoyés par <code>db:select</code> ou par des -requêtes préparées créées par <code>db:prepare</code> permettent de -sélectionner des enregistrements en mode synchrone ou -asynchrone, selon le nombre d'enregistrements spécifié :<br /> - <code>result(0)</code> sélectionne tous les enregistrements en mode + <p>Les jeux d'enregistrements renvoyés par <code>db:select</code> ou par des +requêtes préparées créées par <code>db:prepare</code> permettent de +sélectionner des enregistrements en mode synchrone ou +asynchrone, selon le nombre d'enregistrements spécifié :<br /> + <code>result(0)</code> sélectionne tous les enregistrements en mode synchrone en renvoyant une table d'enregistrements.<br /> - <code>result(-1)</code> sélectionne le prochain enregistrement disponible en + <code>result(-1)</code> sélectionne le prochain enregistrement disponible en mode asynchrone.<br /> - <code>result(N)</code> sélectionne l'enregistrement numéro + <code>result(N)</code> sélectionne l'enregistrement numéro <code>N</code> en mode asynchrone. </p> - <pre class="prettyprint lang-lua">-- extrait un jeu d'enregistrements via une requête régulière : + <pre class="prettyprint lang-lua">-- extrait un jeu d'enregistrements via une requête régulière : local result, err = db:select(r, "SELECT * FROM `tbl` WHERE 1") -local rows = result(0) -- sélectionne tous les enregistrements en mode synchrone -local row = result(-1) -- sélectionne le prochain enregistrement disponible en mode asynchrone -local row = result(1234) -- sélectionne l'enregistrement 1234 en mode asynchrone +local rows = result(0) -- sélectionne tous les enregistrements en mode synchrone +local row = result(-1) -- sélectionne le prochain enregistrement disponible en mode asynchrone +local row = result(1234) -- sélectionne l'enregistrement 1234 en mode asynchrone local row = result(-1, true) -- Lit l'enregistrement suivant en utilisant les noms d'enregistrements comme index.</pre> <p>Il est possible de construire une fonction qui renvoie une -fonction itérative permettant de traiter tous les enregistrement en mode +fonction itérative permettant de traiter tous les enregistrement en mode synchrone ou asynchrone selon la valeur de l'argument async : </p> <pre class="prettyprint lang-lua">function rows(resultset, async) @@ -1295,7 +1295,7 @@ end local statement, err = db:prepare(r, "SELECT * FROM `tbl` WHERE `age` > %u") if not err then - -- sélectionne des enregistrements en mode asynchrone : + -- sélectionne des enregistrements en mode asynchrone : local result, err = statement:select(20) if not err then for index, row in rows(result, true) do @@ -1303,7 +1303,7 @@ if not err then end end - -- sélectionne des enregistrements en mode synchrone : + -- sélectionne des enregistrements en mode synchrone : local result, err = statement:select(20) if not err then for index, row in rows(result, false) do @@ -1313,37 +1313,37 @@ if not err then end</pre> - <h3><a name="closing_databases" id="closing_databases">Fermeture d'une connexion à une base de données</a></h3> + <h3><a name="closing_databases" id="closing_databases">Fermeture d'une connexion à une base de données</a></h3> - <p>Lorsqu'elles ne sont plus utilisées, les connexions aux bases de -données doivent être fermées avec <code>database:close()</code>. Si vous -ne les fermez pas manuellement, mod_lua les fermera peut-être en tant -que résidus collectés, mais si ce n'est pas le cas, vous pouvez finir -pas avoir trop de connexions vers la base de données inutilisées. Les + <p>Lorsqu'elles ne sont plus utilisées, les connexions aux bases de +données doivent être fermées avec <code>database:close()</code>. Si vous +ne les fermez pas manuellement, mod_lua les fermera peut-être en tant +que résidus collectés, mais si ce n'est pas le cas, vous pouvez finir +pas avoir trop de connexions vers la base de données inutilisées. Les deux mesures suivantes sont pratiquement identiques : </p> - <pre class="prettyprint lang-lua">-- Méthode 1 : fermeture manuelle de la connexion + <pre class="prettyprint lang-lua">-- Méthode 1 : fermeture manuelle de la connexion local database = r:dbacquire("mod_dbd") database:close() -- c'est tout --- Méthode 2 : on laisse le collecteur de résidus la fermer +-- Méthode 2 : on laisse le collecteur de résidus la fermer local database = r:dbacquire("mod_dbd") database = nil -- on coupe le lien -collectgarbage() -- fermeture de la connexion par le collecteur de résidus</pre> +collectgarbage() -- fermeture de la connexion par le collecteur de résidus</pre> - <h3><a name="database_caveat" id="database_caveat">Précautions à prendre lorsque l'on travaille avec les bases -de données</a></h3> + <h3><a name="database_caveat" id="database_caveat">Précautions à prendre lorsque l'on travaille avec les bases +de données</a></h3> <p>Bien que les fonctions <code>query</code> et <code>run</code> -soient toujours disponibles, il est recommandé d'utiliser des requêtes -préparées chaque fois que possible, afin d'une part d'optimiser les +soient toujours disponibles, il est recommandé d'utiliser des requêtes +préparées chaque fois que possible, afin d'une part d'optimiser les performances (si votre connexion reste longtemps en vie), et d'autre part minimiser le risque d'attaques par injection SQL. Les fonctions -<code>run</code> et <code>query</code> ne doivent être utilisées que -lorsque la requête ne contient pas de variables (requête statique). Dans -le cas des requêtes dynamiques, utilisez <code>db:prepare</code> ou +<code>run</code> et <code>query</code> ne doivent être utilisées que +lorsque la requête ne contient pas de variables (requête statique). Dans +le cas des requêtes dynamiques, utilisez <code>db:prepare</code> ou <code>db:prepared</code>. </p> @@ -1356,12 +1356,12 @@ le cas des requêtes dynamiques, utilisez <code>db:prepare</code> ou </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#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>Disponible depuis la version 2.4.3 du serveur HTTP Apache</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>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> +<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 @@ -1382,26 +1382,26 @@ 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="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 le cache de code compilé.</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#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#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#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> - 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 + 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> + en développement.</p> <div class="example"><h3>Exemples :</h3><pre class="prettyprint lang-config">LuaCodeCache stat LuaCodeCache forever @@ -1413,58 +1413,58 @@ LuaCodeCache never</pre> <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>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#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#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#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>Le troisième argument optionnel est disponible depuis la +<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>Ajoute votre fonction d'accroche à la phase access_checker. Une -fonction d'accroche access checker renvoie en général OK, DECLINED, ou +<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> + "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>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#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#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#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>Le troisième argument optionnel est disponible depuis la +<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>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 : +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' -- 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. +-- 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) -- recherche des informations d'authentification auth = r.headers_in['Authorization'] if auth ~= nil then - -- définition d'un utilisateur par défaut + -- définition d'un utilisateur par défaut r.user = 'foo' end @@ -1483,35 +1483,35 @@ function authcheck_hook(r) end</pre> <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> + "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>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#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#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#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> </div> <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>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#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#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#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> - Idem LuaHookTranslateName, mais s'exécute durant la phase de + Idem LuaHookTranslateName, mais s'exécute durant la phase de correction. </p> @@ -1519,33 +1519,33 @@ traitement de la requête</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="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>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#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#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#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>Non encore implémenté</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>Permet une insertion dans la phase de journalisation du -traitement d'une requête</td></tr> +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#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#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> - Ce dispositif d'insertion simple permet d'exécuter une fonction + 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 + 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 @@ -1556,24 +1556,24 @@ traitement d'une requête</td></tr> <pre class="prettyprint lang-lua">-- /path/to/script.lua -- function logger(r) - -- 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 + -- 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 -- On effectue notre propre journalisation et le journal - -- standard n'est pas alimenté + -- standard n'est pas alimenté local f = io.open("/foo/secret.log", "a") if f then - f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n") + f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n") f:close() end - return apache2.DONE -- On dit à httpd de ne rien enregistrer + return apache2.DONE -- On dit à httpd de ne rien enregistrer --dans le journal standard else - r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données + r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données return apache2.OK -- et httpd doit alors les enregistrer. end end</pre> @@ -1583,19 +1583,19 @@ 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>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#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#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#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>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> + <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" @@ -1614,18 +1614,18 @@ end function check_cache(r) 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 + local file = cached_files[r.filename] -- Vérifie les entrées du cache if not file then file = read_file(r.filename) -- Lit le fichier vers le cache end if file then -- Si le fichier existe, on l'envoie r.status = 200 r:write(file) - 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 + 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 -- Si nous n'avons rien eu à faire, nous laissons les autres s'en charger + return apache2.DECLINED -- Si nous n'avons rien eu à faire, nous laissons les autres s'en charger end</pre> @@ -1634,29 +1634,29 @@ 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>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#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#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>Le troisième argument optionnel est disponible depuis la +<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> - 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, + 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 + <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> + traitement de la requête doit être interrompu, la valeur renvoyée + doit être apache2.DONE.</p> <p>Exemple :</p> @@ -1676,38 +1676,38 @@ function silly_mapper(r) end</pre> - <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>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> + "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>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#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#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#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> - 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 : + 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-lua"> function type_checker(r) 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é + 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 @@ -1719,45 +1719,45 @@ traitement de la requête</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="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>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#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#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#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>Versions 2.4.0 et supérieures</td></tr> -</table><p>Par défaut, si des directives LuaHook* se trouvent dans +<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 + 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 + <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>Fournit une fonction Lua pour le filtrage en entrée</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#Status">Statut:</a></th><td>Expérimental</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>Disponible depuis la version 2.4.5 du serveur HTTP +<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>Cette directive permet d'ajouter un filtre en entrée sous la forme +<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 +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 +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> @@ -1767,35 +1767,35 @@ sont transmis au script Lua : </Files></pre> <pre class="prettyprint lang-lua">--[[ - Exemple de filtre en entrée qui convertit toutes les données POST en + Exemple de filtre en entrée qui convertit toutes les données POST en majuscules. ]]-- function input_filter(r) - print("luaInputFilter called") -- pour débogage - coroutine.yield() -- attend des paquets de données + 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 + 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 - -- plus aucune donnée à traiter. - coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin + -- plus aucune donnée à traiter. + coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin end</pre> <p> -Le filtre en entrée peut interdire ou sauter un filtre s'il est -considéré comme indésirable : +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 -- Empêche tout simplement le filtrage et transmet le contenu original + return -- Empêche tout simplement le filtrage et transmet le contenu original end - coroutine.yield() -- attend des paquets de données + coroutine.yield() -- attend des paquets de données ... -- insert les filtres ici end</pre> <p> Voir "<a href="#modifying_buckets">Modification de contenu avec les -filtres Lua</a>" pour plus de détails. +filtres Lua</a>" pour plus de détails. </p> </div> @@ -1805,30 +1805,30 @@ filtres Lua</a>" pour plus de détails. <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#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#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>Cette directive permet de faire correspondre un modèle d'uri avec - une fonction de gestionnaire située dans un fichier spécifique. Elle + <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 + 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>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> + après chargement de ce fichier.</p> <pre class="prettyprint lang-config">LuaMapHandler /bingo /scripts/wombat.lua</pre> <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> + 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> @@ -1838,18 +1838,18 @@ filtres Lua</a>" pour plus de détails. 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#Status">Statut:</a></th><td>Expérimental</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>Disponible à partir de la version 2.4.5 du serveur HTTP +<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>>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 +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 +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> @@ -1859,41 +1859,41 @@ sont transmis au script Lua : </Files></pre> <pre class="prettyprint lang-lua">--[[ - Exemple de filtre en sortie qui échappe toutes les entités HTML en + 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") -- Ajoute des données au début de la sortie, - -- puis attend des paquets de données à traiter + 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 + 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 - -- plus aucune donnée à traiter. + -- plus aucune donnée à traiter. end</pre> <p> -Comme les filres en entrée, le filtre en sortie peut interdire ou sauter un filtre s'il est -considéré comme indésirable : +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 -- Empêche tout simplement le filtrage et transmet le contenu original + return -- Empêche tout simplement le filtrage et transmet le contenu original end - coroutine.yield() -- attend des paquets de données + coroutine.yield() -- attend des paquets de données ... -- insert les filtres ici end</pre> <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 à +filtrage ne fonctionnera que si <var>filter-name</var> est identique à <var>provider-name</var>. </p> </div> <p> Voir "<a href="#modifying_buckets">Modification de contenu avec les -filtres Lua</a>" pour plus de détails. +filtres Lua</a>" pour plus de détails. </p> @@ -1901,15 +1901,15 @@ filtres Lua</a>" pour plus de détails. <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>Ajoute un répertoire au package.cpath de lua</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#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#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>Cette directive permet d'ajouter un chemin à la liste des chemins - de recherche des bibliothèques partagées de lua. Ceci modifie le + <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> @@ -1917,14 +1917,14 @@ filtres Lua</a>" pour plus de détails. <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>Ajoute un répertoire au package.path de lua</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#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#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>Cette directive permet d'ajouter un chemin à la liste des - chemins de recherche du module lua. Elle suit les mêmes conventions +</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>Exemples :</h3><pre class="prettyprint lang-config">LuaPackagePath /scripts/lib/?.lua @@ -1935,102 +1935,102 @@ LuaPackagePath /scripts/lib/?/init.lua</pre> <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>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#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, répertoire, .htaccess</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#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>Cette phase s'exécute juste après l'attribution de la requête à + <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 + 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. + sont pas encore prises en compte, car Les URI n'ont pas encore été + entièrement interprétés. </p> - <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>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>Spécifie le chemin de base pour la résolution des chemins +<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#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#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>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> + <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>Une valeur parmi once, request, conn, thread -- la valeur par défaut est 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#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#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#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>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> + <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>utilise l'interpréteur une fois.</dd> + <dt>once:</dt> <dd>utilise l'interpréteur une fois.</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>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>idem request, mais attaché à connection_rec</dd> + <dt>conn:</dt> <dd>idem request, mais attaché à connection_rec</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>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>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 + <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 + de spécifier les nombres minimaux et maximaux d'états lua à stocker dans la liste.</dd> </dl> - <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>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> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_lua.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_lua.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_lua.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -2049,7 +2049,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_lua.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_macro.html b/docs/manual/mod/mod_macro.html index 1b2896af11..53ca83fcb9 100644 --- a/docs/manual/mod/mod_macro.html +++ b/docs/manual/mod/mod_macro.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_macro.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_macro.html.fr b/docs/manual/mod/mod_macro.html.fr index 8048450fef..bfb4bdf939 100644 --- a/docs/manual/mod/mod_macro.html.fr +++ b/docs/manual/mod/mod_macro.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,21 +27,21 @@ <div id="preamble"><h1>Module Apache mod_macro</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_macro.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module permet d'utiliser des macros dans les fichiers de configuration Apache.</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>macro_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_macro.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>macro_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_macro.c</td></tr></table> <h3>Sommaire</h3> <p>Ce module permet d'utiliser des macros dans les fichiers de - configuration à l'exécution du serveur HTTP Apache afin de faciliter - la création de nombreux blocs de configuration similaires. Quand le - serveur démarre, les macros sont exécutées avec les paramètres - fournis, et le résultat obtenu est traité au même titre que le reste + configuration à l'exécution du serveur HTTP Apache afin de faciliter + la création de nombreux blocs de configuration similaires. Quand le + serveur démarre, les macros sont exécutées avec les paramètres + fournis, et le résultat obtenu est traité au même titre que le reste du fichier de configuration.</p> </div> @@ -60,13 +60,13 @@ de configuration Apache.</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="usage" id="usage">Utilisation</a></h2> -<p>On définit une macro à l'aide des blocs <code class="directive"><Macro></code> qui contiennent la portion de votre -configuration qui intervient de manière répétitive, y compris les -variables pour les parties qui devront être substituées.</p> +<p>On définit une macro à l'aide des blocs <code class="directive"><Macro></code> qui contiennent la portion de votre +configuration qui intervient de manière répétitive, y compris les +variables pour les parties qui devront être substituées.</p> -<p>Par exemple, vous pouvez utiliser une macro pour définir un bloc +<p>Par exemple, vous pouvez utiliser une macro pour définir un bloc <code class="directive"><VirtualHost></code>, afin de pouvoir -définir de nombreux serveurs virtuels similaires :</p> +définir de nombreux serveurs virtuels similaires :</p> <pre class="prettyprint lang-config"><Macro VHost $name $domain> <VirtualHost *:80> @@ -81,11 +81,11 @@ définir de nombreux serveurs virtuels similaires :</p> <p>Comme les directives de configuration httpd, les noms des macros sont -insensibles à la casse, à la différence des variables qui y sont, elles, +insensibles à la casse, à la différence des variables qui y sont, elles, sensibles.</p> <p>Vous pouvez alors invoquer cette macro autant de fois que vous le -voulez pour créer des serveurs virtuels </p> +voulez pour créer des serveurs virtuels </p> <pre class="prettyprint lang-config">Use VHost example example.com Use VHost myhost hostname.org @@ -94,44 +94,44 @@ Use VHost apache apache.org UndefMacro VHost</pre> -<p>Au démarrage du serveur, chacune de ces invocations -<code class="directive">Use</code> sera remplacée par une définition de serveur -virtuel complète, comme décrit dans la définition de la +<p>Au démarrage du serveur, chacune de ces invocations +<code class="directive">Use</code> sera remplacée par une définition de serveur +virtuel complète, comme décrit dans la définition de la <code class="directive">Macro</code>.</p> -<p>La directive <code class="directive">UndefMacro</code> permet d'éviter les -conflits de définitions qui pourraient provenir de l'utilisation -ultérieure de macros contenant les mêmes noms de variables.</p> +<p>La directive <code class="directive">UndefMacro</code> permet d'éviter les +conflits de définitions qui pourraient provenir de l'utilisation +ultérieure de macros contenant les mêmes noms de variables.</p> -<p>Vous trouverez une version plus élaborée de cet exemple plus loin +<p>Vous trouverez une version plus élaborée de cet exemple plus loin dans la section Exemples.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="tips" id="tips">Conseils</a></h2> -<p>Les noms de paramètres doivent commencer par un sigil tel que -<code>$</code>, <code>%</code>, ou <code>@</code>, de façon à ce qu'ils +<p>Les noms de paramètres doivent commencer par un sigil tel que +<code>$</code>, <code>%</code>, ou <code>@</code>, de façon à ce qu'ils soient clairement identifiables, mais aussi afin de faciliter les interactions avec les autres directives, comme la directive de base <code class="directive"><a href="../mod/core.html#define">Define</a></code>. Dans le cas contraire, vous -recevrez un avertissement. En tout état de cause, il est conseillé +recevrez un avertissement. En tout état de cause, il est conseillé d'avoir une bonne connaissance globale de la configuration du serveur, -afin d'éviter la réutilisation des mêmes variables à différents niveaux, -ce qui peut être à l'origine de confusions.</p> +afin d'éviter la réutilisation des mêmes variables à différents niveaux, +ce qui peut être à l'origine de confusions.</p> -<p>Les paramètres préfixés par <code>$</code> ou <code>%</code> ne sont -pas échappés. Les paramètres préfixés par <code>@</code> sont échappés +<p>Les paramètres préfixés par <code>$</code> ou <code>%</code> ne sont +pas échappés. Les paramètres préfixés par <code>@</code> sont échappés entre guillemets.</p> -<p>Evitez de préfixer un paramètre par le nom d'un autre paramètre (par -exemple, présence simultanée des paramètres <code>$win</code> et +<p>Evitez de préfixer un paramètre par le nom d'un autre paramètre (par +exemple, présence simultanée des paramètres <code>$win</code> et <code>$winter</code>), car ceci peut introduire de la confusion lors de -l'évaluation des expressions. Si cela se produit, c'est le nom de -paramètre le plus long possible qui sera utilisé.</p> +l'évaluation des expressions. Si cela se produit, c'est le nom de +paramètre le plus long possible qui sera utilisé.</p> -<p>Si vous désirez insérer une valeur dans une chaîne, il est conseillé -de l'entourer d'accolades afin d'éviter toute confusion :</p> +<p>Si vous désirez insérer une valeur dans une chaîne, il est conseillé +de l'entourer d'accolades afin d'éviter toute confusion :</p> <pre class="prettyprint lang-config"><Macro DocRoot ${docroot}> DocumentRoot "/var/www/${docroot}/htdocs" @@ -143,13 +143,13 @@ de l'entourer d'accolades afin d'éviter toute confusion :</p> <h2><a name="examples" id="examples">Exemples</a></h2> -<h3>Définition de serveurs virtuels</h3> +<h3>Définition de serveurs virtuels</h3> <p>Un exemple typique d'utilisation de <code class="module"><a href="../mod/mod_macro.html">mod_macro</a></code> est la -création dynamique de serveurs virtuels.</p> +création dynamique de serveurs virtuels.</p> -<pre class="prettyprint lang-config">## Définition d'une macro VHost pour les configurations répétitives +<pre class="prettyprint lang-config">## Définition d'une macro VHost pour les configurations répétitives <Macro VHost $host $port $dir> Listen $port @@ -163,14 +163,14 @@ création dynamique de serveurs virtuels.</p> Require all granted </Directory> - # restriction d'accès au sous-répertoire intranet. + # restriction d'accès au sous-répertoire intranet. <Directory "$dir/intranet"> Require ip 10.0.0.0/8 </Directory> </VirtualHost> </Macro> -## Utilisation de la macro VHost avec différents arguments. +## Utilisation de la macro VHost avec différents arguments. Use VHost www.apache.org 80 /vhosts/apache/htdocs Use VHost example.org 8080 /vhosts/example/htdocs @@ -178,12 +178,12 @@ Use VHost www.example.fr 1234 /vhosts/example.fr/htdocs</pre> -<h3>Suppression d'une définition de macro</h3> +<h3>Suppression d'une définition de macro</h3> -<p>Il est recommandé de supprimer la définition d'une macro après -l'avoir utilisée. Ceci permet d'éviter les confusions au sein d'un -fichier de configuration complexe où des conflits entre noms de +<p>Il est recommandé de supprimer la définition d'une macro après +l'avoir utilisée. Ceci permet d'éviter les confusions au sein d'un +fichier de configuration complexe où des conflits entre noms de variables peuvent survenir.</p> <pre class="prettyprint lang-config"><Macro DirGroup $dir $group> @@ -204,20 +204,20 @@ UndefMacro DirGroup</pre> <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>Définition d'une macro dans un fichier de configuration</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>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#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_macro</td></tr> </table> - <p>La directive <code class="directive">Macro</code> permet de définir une macro + <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. + 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> @@ -235,7 +235,7 @@ UndefMacro DirGroup</pre> <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#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</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_macro</td></tr> </table><p>La documentation de cette directive @@ -247,22 +247,22 @@ UndefMacro DirGroup</pre> <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#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_macro</td></tr> </table> <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> + 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>est équivalent, avec les macros définies ci-dessus à :</p> + <p>est équivalent, avec les macros définies ci-dessus à :</p> <pre class="prettyprint lang-config">Require ip 10.2.16.0/24 ... @@ -273,7 +273,7 @@ Require ip 192.54.172.0/24 192.54.148.0/24</pre> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_macro.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_macro.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -292,7 +292,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_macro.html } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_negotiation.html b/docs/manual/mod/mod_negotiation.html index d6d7332ba8..e616887365 100644 --- a/docs/manual/mod/mod_negotiation.html +++ b/docs/manual/mod/mod_negotiation.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_negotiation.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_negotiation.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_negotiation.html.fr b/docs/manual/mod/mod_negotiation.html.fr index 3f8ce900e3..235a5eb3cc 100644 --- a/docs/manual/mod/mod_negotiation.html.fr +++ b/docs/manual/mod/mod_negotiation.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,29 +27,29 @@ <div id="preamble"><h1>Module Apache mod_negotiation</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | <a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Effectue la <a href="../content-negotiation.html">négociation de +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Effectue la <a href="../content-negotiation.html">négociation de contenu</a></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>negotiation_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_negotiation.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>negotiation_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_negotiation.c</td></tr></table> <h3>Sommaire</h3> - <p>La négociation de contenu, ou plus précisément la sélection de - contenu, est la sélection parmi plusieurs documents disponibles, du - document qui "colle" au plus près des possibilités du client. Pour y - parvenir, deux méthodes sont employées.</p> + <p>La négociation de contenu, ou plus précisément la sélection de + contenu, est la sélection parmi plusieurs documents disponibles, du + document qui "colle" au plus près des possibilités du client. Pour y + parvenir, deux méthodes sont employées.</p> <ul> - <li>Une table de correspondances de types (un fichier associé au + <li>Une table de correspondances de types (un fichier associé au gestionnaire <code>type-map</code>) qui contient une liste - explicite des fichiers contenant les différentes variantes.</li> + explicite des fichiers contenant les différentes variantes.</li> - <li>Une recherche multivues (Multiviews) (activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), où le - serveur effectue une recherche de correspondance de modèle de nom - de fichier implicite, et fait son choix parmi les résultats.</li> + <li>Une recherche multivues (Multiviews) (activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), où le + serveur effectue une recherche de correspondance de modèle de nom + de fichier implicite, et fait son choix parmi les résultats.</li> </ul> </div> <div id="quickview"><h3>Sujets</h3> @@ -66,73 +66,73 @@ contenu</a></td></tr> <ul class="seealso"> <li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li> <li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li> -<li><a href="../content-negotiation.html">Négociation de +<li><a href="../content-negotiation.html">Négociation de contenu</a></li> <li><a href="../env.html">Variables d'environnement</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="typemaps" id="typemaps">Tables de correspondances de types</a></h2> - <p>Une table de correspondances de types possède un format similaire - à celui des en-têtes de messagerie RFC822. Elle contient des - descriptions de documents séparées par des lignes vides, toute ligne - commençant par un dièse ('#') étant considérée comme un + <p>Une table de correspondances de types possède un format similaire + à celui des en-têtes de messagerie RFC822. Elle contient des + descriptions de documents séparées par des lignes vides, toute ligne + commençant par un dièse ('#') étant considérée comme un commentaire. Une description de document comporte plusieurs - enregistrements d'en-têtes ; chaque enregistrement peut être réparti - sur plusieurs lignes à condition que les lignes supplémentaires + enregistrements d'en-têtes ; chaque enregistrement peut être réparti + sur plusieurs lignes à condition que les lignes supplémentaires commencent par un ou plusieurs espaces. Lors du traitement, les - espaces de début de ligne seront supprimés et les lignes - concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui - se termine toujours par un caractère "deux-points" ':', suivi d'une - valeur. Les espaces sont autorisés entre le nom d'en-tête et sa - valeur, ainsi qu'entre les différents éléments de la valeur. Les - en-têtes autorisés sont :</p> + espaces de début de ligne seront supprimés et les lignes + concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui + se termine toujours par un caractère "deux-points" ':', suivi d'une + valeur. Les espaces sont autorisés entre le nom d'en-tête et sa + valeur, ainsi qu'entre les différents éléments de la valeur. Les + en-têtes autorisés sont :</p> <dl> <dt><code>Content-Encoding:</code></dt> - <dd>Le codage du fichier. Apache ne reconnaît que les codages - définis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus - les codages <code>x-compress</code> pour les fichiers compressés - avec compress, et <code>x-gzip</code> pour les fichiers compressés - avec gzip. Le préfixe <code>x-</code> est ignoré lors des + <dd>Le codage du fichier. Apache ne reconnaît que les codages + définis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus + les codages <code>x-compress</code> pour les fichiers compressés + avec compress, et <code>x-gzip</code> pour les fichiers compressés + avec gzip. Le préfixe <code>x-</code> est ignoré lors des comparaisons de codages.</dd> <dt><code>Content-Language:</code></dt> <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de langage Internet standard (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par - exemple, <code>en</code> correspond à l'anglais. Si la variante - contient plusieurs langages, ils sont séparés par des + exemple, <code>en</code> correspond à l'anglais. Si la variante + contient plusieurs langages, ils sont séparés par des virgules.</dd> <dt><code>Content-Length:</code></dt> - <dd>La taille du fichier en octets. Si cet en-tête n'est pas - présent, c'est la taille réelle du fichier qui est utilisée.</dd> + <dd>La taille du fichier en octets. Si cet en-tête n'est pas + présent, c'est la taille réelle du fichier qui est utilisée.</dd> <dt><code>Content-Type:</code></dt> <dd> Le <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type MIME</a> du document - avec des paramètres optionnels. Les paramètres sont séparés du - type de médium ainsi qu'entre eux par un point-virgule, et - possèdent la syntaxe <code>nom=valeur</code>. Les paramètres + avec des paramètres optionnels. Les paramètres sont séparés du + type de médium ainsi qu'entre eux par un point-virgule, et + possèdent la syntaxe <code>nom=valeur</code>. Les paramètres courants sont : <dl> <dt><code>level</code></dt> - <dd>un entier spécifiant la version du type de média. Pour - <code>text/html</code>, la valeur par défaut est 2, sinon + <dd>un entier spécifiant la version du type de média. Pour + <code>text/html</code>, la valeur par défaut est 2, sinon 0.</dd> <dt><code>qs</code></dt> - <dd>un nombre en virgule flottante de 0[.000] à 1[.000], indiquant la - "qualité" relative de la variante courante par rapport aux - autres variantes disponibles, indépendamment des possibilités - du client. Par exemple, un fichier jpeg est en général une - source de qualité supérieure à un fichier ascii s'il est censé - représenter une image. Cependant, si la ressource représentée - est une image ascii, un fichier ascii possèdera une qualité - supérieure à un fichier jpeg. Toutes les valeurs de - <code>qs</code> sont donc spécifiques à une certaine + <dd>un nombre en virgule flottante de 0[.000] à 1[.000], indiquant la + "qualité" relative de la variante courante par rapport aux + autres variantes disponibles, indépendamment des possibilités + du client. Par exemple, un fichier jpeg est en général une + source de qualité supérieure à un fichier ascii s'il est censé + représenter une image. Cependant, si la ressource représentée + est une image ascii, un fichier ascii possèdera une qualité + supérieure à un fichier jpeg. Toutes les valeurs de + <code>qs</code> sont donc spécifiques à une certaine ressource.</dd> </dl> @@ -142,21 +142,21 @@ contenu</a></li> </dd> <dt><code>URI:</code></dt> - <dd>l'URI du fichier contenant la variante (du type de médium - donné, codé selon le codage de contenu donné). Cet URI est - considéré comme relatif au fichier de correspondances ; il doit - être situé sur le même serveur, et doit faire référence au - fichier auquel le client se verrait accorder l'accès s'il était + <dd>l'URI du fichier contenant la variante (du type de médium + donné, codé selon le codage de contenu donné). Cet URI est + considéré comme relatif au fichier de correspondances ; il doit + être situé sur le même serveur, et doit faire référence au + fichier auquel le client se verrait accorder l'accès s'il était requis directement.</dd> <dt><code>Body:</code></dt> - <dd>Le contenu réel de la ressource - peut être inclus dans la table de correspondances en utilisant - l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un - délimiteur pour le contenu du corps. Les lignes suivantes du - fichier de correspondances de types seront alors considérées comme - parties du corps de la ressource jusqu'à ce que le délimiteur soit - détecté. + <dd>Le contenu réel de la ressource + peut être inclus dans la table de correspondances en utilisant + l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un + délimiteur pour le contenu du corps. Les lignes suivantes du + fichier de correspondances de types seront alors considérées comme + parties du corps de la ressource jusqu'à ce que le délimiteur soit + détecté. <div class="example"><h3>Exemple:</h3><p><code> Body:----xyz----<br /> @@ -170,8 +170,8 @@ contenu</a></li> </dd> </dl> - <p>Considérons une ressource, <code>document.html</code>, disponible - en anglais, en français et en allemand. Les fichiers correspondants + <p>Considérons une ressource, <code>document.html</code>, disponible + en anglais, en français et en allemand. Les fichiers correspondants se nomment respectivement <code>document.html.en</code>, <code>document.html.fr</code>, et <code>document.html.de</code>. Le fichier de correspondances de types se nommera @@ -195,67 +195,67 @@ contenu</a></li> </code></p></div> - <p>Ces quatre fichiers doivent se trouver dans le même répertoire, - et le fichier <code>.var</code> doit être associé au gestionnaire + <p>Ces quatre fichiers doivent se trouver dans le même répertoire, + et le fichier <code>.var</code> doit être associé au gestionnaire <code>type-map</code> via une directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> :</p> <pre class="prettyprint lang-config">AddHandler type-map .var</pre> - <p>A l'arrivée d'une requête pour la ressource + <p>A l'arrivée d'une requête pour la ressource <code>document.html.var</code>, la variante de - <code>document.html</code> qui correspond le mieux à la préference - de langage spécifiée dans l'en-tête de la requête de l'utilisateur + <code>document.html</code> qui correspond le mieux à la préference + de langage spécifiée dans l'en-tête de la requête de l'utilisateur <code>Accept-Language</code> sera choisie.</p> - <p>Si <code>Multiviews</code> est activée, et si <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> est définie à - "handlers" ou "any", une requête pour <code>document.html</code> va + <p>Si <code>Multiviews</code> est activée, et si <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> est définie à + "handlers" ou "any", une requête pour <code>document.html</code> va rechercher <code>document.html.var</code>, et continuer la - négociation avec le gestionnaire explicite type-map.</p> + négociation avec le gestionnaire explicite type-map.</p> - <p>D'autres directives de configuration, comme <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, peuvent être utilisées pour + <p>D'autres directives de configuration, comme <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, peuvent être utilisées pour associer <code>document.html</code> avec <code>document.html.var</code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="multiviews" id="multiviews">Multivues</a></h2> - <p>Une recherche Multivues est activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le - serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et - si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt - le répertoire à la recherche de tous les fichiers de nom - <code>foo.*</code>, et simule véritablement une correspondance de - type qui nomme tous ces fichiers en leur assignant les mêmes type - de média et codage de contenu qu'ils auraient eus si le client avait + <p>Une recherche Multivues est activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le + serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et + si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt + le répertoire à la recherche de tous les fichiers de nom + <code>foo.*</code>, et simule véritablement une correspondance de + type qui nomme tous ces fichiers en leur assignant les mêmes type + de média et codage de contenu qu'ils auraient eus si le client avait requis l'un d'entre eux avec son nom complet. Il choisit ensuite le fichier qui correspond le mieux au profile du client, puis renvoie le document.</p> - <p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> définit si Apache doit - prendre en compte les fichiers qui ne comportent pas de métadonnées - de négociation de contenu lors du choix du fichier à servir.</p> + <p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> définit si Apache doit + prendre en compte les fichiers qui ne comportent pas de métadonnées + de négociation de contenu lors du choix du fichier à servir.</p> </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>Permet la mise en cache au niveau des serveurs mandataires -des documents dont le contenu a été négocié</td></tr> +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#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>Si elle est définie à "on", cette directive permet la mise en + <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 + 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> + documents qui ne correspondent pas forcément à leurs attentes.</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 + <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> @@ -263,29 +263,29 @@ des documents dont le contenu a été négocié</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="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 à entreprendre si un document acceptable unique -n'est pas trouvé</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#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#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>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 + 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 + <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 @@ -294,23 +294,23 @@ ForceLanguagePriority Prefer</pre> <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 + 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> + 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>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 + 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 + 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> @@ -321,35 +321,35 @@ ForceLanguagePriority Fallback</pre> <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>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#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#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>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> + 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>Dans le cas d'une requête pour <code>foo.html</code>, si + <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> + le client n'a pas formulé de préférences, c'est le fichier + <code>foo.html.fr</code> qui sera renvoyé.</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 + 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> + 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> @@ -359,7 +359,7 @@ cas où le client n'a pas formulé de préférences</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | <a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -379,7 +379,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_negotiatio } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_proxy.html b/docs/manual/mod/mod_proxy.html index 3cbe01bc81..3d4bac0ff0 100644 --- a/docs/manual/mod/mod_proxy.html +++ b/docs/manual/mod/mod_proxy.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_proxy.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_proxy.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_proxy.html.fr b/docs/manual/mod/mod_proxy.html.fr index fba011f381..dd61f4672d 100644 --- a/docs/manual/mod/mod_proxy.html.fr +++ b/docs/manual/mod/mod_proxy.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,44 +27,44 @@ <div id="preamble"><h1>Module Apache mod_proxy</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_proxy.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_proxy.html" title="Français"> fr </a> | <a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Serveur mandataire/passerelle multi-protocole</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy.c</td></tr></table> <h3>Sommaire</h3> <div class="warning"><h3>Avertissement</h3> - <p>N'activez pas la fonctionnalité de mandataire avec la directive + <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 pour votre réseau, + d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs + mandataires ouverts sont dangereux pour votre réseau, mais aussi pour l'Internet au sens large.</p> </div> - <p><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et ses modules associés implémentent + <p><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et ses modules associés implémentent un mandataire/passerelle pour le serveur HTTP Apache, et supportent de nombreux protocoles courants, ainsi que plusieurs algorithmes de - répartition de charge. Le support de protocoles et d'algorithmes de - répartition de charge supplémentaires peut être assuré par des + répartition de charge. Le support de protocoles et d'algorithmes de + répartition de charge supplémentaires peut être assuré par des modules tiers.</p> - <p>Un jeu de modules chargés dans le serveur permet de fournir les - fonctionnalités souhaitées. Ces modules peuvent être inclus - statiquement à la compilation, ou dynamiquement via la directive + <p>Un jeu de modules chargés dans le serveur permet de fournir les + fonctionnalités souhaitées. Ces modules peuvent être inclus + statiquement à la compilation, ou dynamiquement via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Ce jeu de module doit comporter :</p> <ul> - <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, qui fournit les fonctionnalités de + <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, qui fournit les fonctionnalités de base d'un mandataire</li> <li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et un ou plusieurs modules - de répartition, si la répartition de charge doit être mise en + de répartition, si la répartition de charge doit être mise en oeuvre (Voir la documentation de - <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus de détails).</li> + <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus de détails).</li> <li>un ou plusieurs modules de types de mandataire, ou protocoles : @@ -85,29 +85,29 @@ </li> </ul> - <p>En outre, d'autres modules fournissent des fonctionnalités - étendues. <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> et ses modules associés + <p>En outre, d'autres modules fournissent des fonctionnalités + étendues. <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> et ses modules associés fournissent la mise en cache. Les directives <code>SSLProxy*</code> du module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> permettent de contacter des serveurs distants en utilisant le protocole SSL/TLS. Ces modules - additionnels devront être chargés et configurés pour pouvoir - disposer de ces fonctionnalités.</p> + additionnels devront être chargés et configurés pour pouvoir + disposer de ces fonctionnalités.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#forwardreverse">Mandataires directs et mandataires/passerelles inverses</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples simples</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#handler">Accès via un gestionnaire</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#handler">Accès via un gestionnaire</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#workers">Workers</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#access">Contrôler l'accès à votre +<li><img alt="" src="../images/down.gif" /> <a href="#access">Contrôler l'accès à votre mandataire</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#startup">Ralentissement au démarrage</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#startup">Ralentissement au démarrage</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#intranet">Mandataire en Intranet</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#envsettings">Ajustements relatifs au protocole</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#request-bodies">Corps de requêtes</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#x-headers">En-têtes de requête du mandataire +<li><img alt="" src="../images/down.gif" /> <a href="#request-bodies">Corps de requêtes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#x-headers">En-têtes de requête du mandataire inverse</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -160,66 +160,66 @@ <div class="section"> <h2><a name="forwardreverse" id="forwardreverse">Mandataires directs et mandataires/passerelles inverses</a></h2> - <p>Le serveur HTTP Apache peut être configuré dans les deux modes mandataire - <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé + <p>Le serveur HTTP Apache peut être configuré dans les deux modes mandataire + <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé mode <dfn>passerelle</dfn>).</p> <p>Un <dfn>mandataire direct</dfn> standard est un serveur - intermédiaire qui s'intercale entre le client et le <em>serveur - demandé</em>. Pour obtenir un contenu hébergé par - le serveur demandé, le client envoie une requête au - mandataire en nommant le serveur demandé comme + intermédiaire qui s'intercale entre le client et le <em>serveur + demandé</em>. Pour obtenir un contenu hébergé par + le serveur demandé, le client envoie une requête au + mandataire en nommant le serveur demandé comme cible, puis le mandataire extrait le contenu depuis le - serveur demandé et le renvoie enfin au client. Le client doit être - configuré de manière appropriée pour pouvoir utiliser le mandataire - direct afin d'accéder à d'autres sites.</p> + serveur demandé et le renvoie enfin au client. Le client doit être + configuré de manière appropriée pour pouvoir utiliser le mandataire + direct afin d'accéder à d'autres sites.</p> - <p>L'accès à Internet depuis des clients situés derrière un + <p>L'accès à Internet depuis des clients situés derrière un pare-feu est une utilisation typique du mandataire direct. Le mandataire direct peut aussi utiliser la mise en cache (fournie - par <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>) pour réduire la charge du - réseau.</p> + par <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>) pour réduire la charge du + réseau.</p> - <p>La fonctionnalité de mandataire direct est activée via la + <p>La fonctionnalité de mandataire direct est activée via la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code>. - Comme les mandataires directs permettent aux clients d'accéder à + Comme les mandataires directs permettent aux clients d'accéder à des sites quelconques via votre serveur et de dissimuler leur - véritable origine, il est indispensable de <a href="#access">sécuriser votre serveur</a> de façon à ce que seuls - les clients autorisés puissent accéder à votre serveur avant - d'activer la fonctionnalité de mandataire direct.</p> + véritable origine, il est indispensable de <a href="#access">sécuriser votre serveur</a> de façon à ce que seuls + les clients autorisés puissent accéder à votre serveur avant + d'activer la fonctionnalité de mandataire direct.</p> <p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>), - quant à lui, apparaît au client comme un serveur web standard. - Aucune configuration particulière du client n'est nécessaire. Le + quant à lui, apparaît au client comme un serveur web standard. + Aucune configuration particulière du client n'est nécessaire. Le client adresse ses demandes de contenus ordinaires dans l'espace - de nommage du mandataire inverse. Ce dernier décide alors où - envoyer ces requêtes, et renvoie le contenu au client comme s'il - l'hébergeait lui-même.</p> + de nommage du mandataire inverse. Ce dernier décide alors où + envoyer ces requêtes, et renvoie le contenu au client comme s'il + l'hébergeait lui-même.</p> - <p>L'accès d'utilisateurs depuis Internet vers un serveur situé - derrière un pare-feu est une utilisation typique du mandataire + <p>L'accès d'utilisateurs depuis Internet vers un serveur situé + derrière un pare-feu est une utilisation typique du mandataire inverse. On peut aussi utiliser les mandataires inverses pour - mettre en oeuvre une répartition de charge entre plusieurs - serveurs en arrière-plan, ou fournir un cache pour un serveur - d'arrière-plan plus lent. Les mandataires inverses peuvent aussi - tout simplement servir à rassembler plusieurs serveurs dans le - même espace de nommage d'URLs.</p> + mettre en oeuvre une répartition de charge entre plusieurs + serveurs en arrière-plan, ou fournir un cache pour un serveur + d'arrière-plan plus lent. Les mandataires inverses peuvent aussi + tout simplement servir à rassembler plusieurs serveurs dans le + même espace de nommage d'URLs.</p> - <p>La fonctionnalité de mandataire inverse est activée via la + <p>La fonctionnalité de mandataire inverse est activée via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou le drapeau <code>[P]</code> de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Il n'est - <strong>pas</strong> nécessaire de définir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> pour configurer + <strong>pas</strong> nécessaire de définir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> pour configurer un mandataire inverse.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="examples" id="examples">Exemples simples</a></h2> - <p>Les exemples ci-dessous illustrent de manière très basique la - mise en oeuvre de la fonctionnalité de mandataire et ne sont là que - pour vous aider à démarrer. Reportez-vous à la documentation de + <p>Les exemples ci-dessous illustrent de manière très basique la + mise en oeuvre de la fonctionnalité de mandataire et ne sont là que + pour vous aider à démarrer. Reportez-vous à la documentation de chaque directive.</p> - <p>Si en outre, vous désirez activer la mise en cache, consultez la + <p>Si en outre, vous désirez activer la mise en cache, consultez la documentation de <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> <div class="example"><h3>Mandataire inverse</h3><pre class="prettyprint lang-config">ProxyPass "/foo" "http://foo.example.com/bar" @@ -235,13 +235,13 @@ ProxyVia On </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="handler" id="handler">Accès via un gestionnaire</a></h2> +<h2><a name="handler" id="handler">Accès via un gestionnaire</a></h2> - <p>Vous pouvez aussi forcer le traitement d'une requête en tant que - requête de mandataire inverse en créant un gestionnaire de transfert - approprié. Dans l'exemple suivant, toutes les requêtes pour + <p>Vous pouvez aussi forcer le traitement d'une requête en tant que + requête de mandataire inverse en créant un gestionnaire de transfert + approprié. Dans l'exemple suivant, toutes les requêtes pour des scripts PHP seront transmises au serveur FastCGI - spécifié via un mandat inverse : + spécifié via un mandat inverse : </p> <div class="example"><h3>Scripts PHP et mandataire inverse</h3><pre class="prettyprint lang-config"><FilesMatch "\.php$"> @@ -249,39 +249,39 @@ ProxyVia On </FilesMatch></pre> </div> - <p>Cette fonctionnalité est disponible à partir de la version + <p>Cette fonctionnalité est disponible à partir de la version 2.4.10 du serveur HTTP Apache.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="workers" id="workers">Workers</a></h2> - <p>Le mandataire gère la configuration et les paramètres de - communication des serveurs originaux au sein d'objets nommés + <p>Le mandataire gère la configuration et les paramètres de + communication des serveurs originaux au sein d'objets nommés <dfn>workers</dfn>. Deux types de worker sont fournis : le worker - par défaut du mandataire direct et le worker par défaut du - mandataire inverse. Il est aussi possible de définir explicitement - des workers supplémentaires.</p> + par défaut du mandataire direct et le worker par défaut du + mandataire inverse. Il est aussi possible de définir explicitement + des workers supplémentaires.</p> - <p>Les deux workers par défaut possèdent une configuration figée - et seront utilisés si aucun autre worker ne correspond à la - requête. Ils n'utilisent ni les jeux de connexions (connection + <p>Les deux workers par défaut possèdent une configuration figée + et seront utilisés si aucun autre worker ne correspond à la + requête. Ils n'utilisent ni les jeux de connexions (connection pooling), ni les connexions HTTP persistantes (Keep-Alive). En effet, les - connexions TCP vers le serveur original sont fermées et ouvertes - pour chaque requête.</p> + connexions TCP vers le serveur original sont fermées et ouvertes + pour chaque requête.</p> - <p>Les workers définis explicitement sont identifiés par leur URL. - Ils sont en général définis via les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> lorsqu'on les + <p>Les workers définis explicitement sont identifiés par leur URL. + Ils sont en général définis via les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> lorsqu'on les utilise dans le cadre d'un mandataire inverse :</p> <div class="example"><pre class="prettyprint lang-config">ProxyPass "/example" "http://backend.example.com" connectiontimeout=5 timeout=30</pre> </div> - <p>Cette directive va créer un worker associé à l'URL du serveur + <p>Cette directive va créer un worker associé à l'URL du serveur original <code>http://backend.example.com</code>, qui utilisera les - valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre - d'un mandataire direct, les workers sont en général définis via la + valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre + d'un mandataire direct, les workers sont en général définis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>,</p> <div class="example"><pre class="prettyprint lang-config">ProxySet http://backend.example.com connectiontimeout=5 timeout=30</pre> @@ -295,89 +295,89 @@ ProxyVia On </Proxy></pre> - <p>L'utilisation de workers définis explicitement dans le mode - mandataire direct n'est pas très courante, car les mandataires - directs communiquent en général avec de nombreux serveurs - originaux. La création explicite de workers pour certains serveurs - originaux peut cependant s'avérer utile si ces serveurs sont - très souvent sollicités. A leur niveau, les workers explicitement - définis ne possèdent aucune notion de mandataire direct ou + <p>L'utilisation de workers définis explicitement dans le mode + mandataire direct n'est pas très courante, car les mandataires + directs communiquent en général avec de nombreux serveurs + originaux. La création explicite de workers pour certains serveurs + originaux peut cependant s'avérer utile si ces serveurs sont + très souvent sollicités. A leur niveau, les workers explicitement + définis ne possèdent aucune notion de mandataire direct ou inverse. Ils encapsulent un concept de communication commun avec - les serveurs originaux. Un worker créé via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> pour être utilisé dans le - cadre d'un mandataire inverse sera aussi utilisé dans le cadre + les serveurs originaux. Un worker créé via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> pour être utilisé dans le + cadre d'un mandataire inverse sera aussi utilisé dans le cadre d'un mandataire directe chaque fois que l'URL vers le serveur - original correspondra à l'URL du worker, et vice versa.</p> + original correspondra à l'URL du worker, et vice versa.</p> - <p>L'URL qui identifie un worker correspond à l'URL de son serveur - original, y compris un éventuel chemin donné :</p> + <p>L'URL qui identifie un worker correspond à l'URL de son serveur + original, y compris un éventuel chemin donné :</p> <pre class="prettyprint lang-config">ProxyPass "/examples" "http://backend.example.com/examples" ProxyPass "/docs" "http://backend.example.com/docs"</pre> - <p>Dans cet exemple, deux workers différents sont définis, chacun + <p>Dans cet exemple, deux workers différents sont définis, chacun d'eux utilisant des configurations et jeux de connexions - séparés.</p> + séparés.</p> <div class="warning"><h3>Partage de workers</h3> <p>Le partage de workers intervient lorsque les URLs des workers s'entrecoupent, ce qui arrive lorsque l'URL d'un worker - correspond au début de l'URL d'un autre worker défini plus loin + correspond au début de l'URL d'un autre worker défini plus loin dans le fichier de configuration. Dans l'exemple suivant,</p> <pre class="prettyprint lang-config">ProxyPass "/apps" "http://backend.example.com/" timeout=60 ProxyPass "/examples" "http://backend.example.com/examples" timeout=10</pre> - <p>le second worker n'est pas vraiment créé. C'est le premier - worker qui est en fait utilisé. L'avantage de ceci réside dans + <p>le second worker n'est pas vraiment créé. C'est le premier + worker qui est en fait utilisé. L'avantage de ceci réside dans le fait qu'il n'existe qu'un seul jeu de connexions, ces - dernières étant donc réutilisées plus souvent. Notez que tous - les attributs de configuration définis explicitement pour le - deuxième worker seront ignorés, ce qui sera journalisé en tant + dernières étant donc réutilisées plus souvent. Notez que tous + les attributs de configuration définis explicitement pour le + deuxième worker seront ignorés, ce qui sera journalisé en tant qu'avertissement. Ainsi, dans l'exemple ci-dessus, la valeur de timeout retenue pour l'URL <code>/exemples</code> sera <code>60</code>, et non <code>10</code> !</p> - <p>Si vous voulez empêcher le partage de workers, classez vos - définitions de workers selon la longueur des URLs, de la plus - longue à la plus courte. Si au contraire vous voulez favoriser + <p>Si vous voulez empêcher le partage de workers, classez vos + définitions de workers selon la longueur des URLs, de la plus + longue à la plus courte. Si au contraire vous voulez favoriser ce partage, utilisez l'ordre de classement inverse. Voir aussi - l'avertissement à propos de l'ordre de classement des directives + l'avertissement à propos de l'ordre de classement des directives <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> </div> - <p>Les workers définis explicitement sont de deux sortes : - <dfn>workers directs</dfn> et <dfn>workers de répartition (de + <p>Les workers définis explicitement sont de deux sortes : + <dfn>workers directs</dfn> et <dfn>workers de répartition (de charge)</dfn>. Ils supportent de nombreux attributs de - configuration importants décrits dans la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Ces mêmes attributs - peuvent aussi être définis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>.</p> + configuration importants décrits dans la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Ces mêmes attributs + peuvent aussi être définis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>.</p> - <p>Le jeu d'options disponibles pour un worker direct dépend du - protocole spécifié dans l'URL du serveur original. Les protocoles + <p>Le jeu d'options disponibles pour un worker direct dépend du + protocole spécifié dans l'URL du serveur original. Les protocoles disponibles comprennent <code>ajp</code>, <code>fcgi</code>, <code>ftp</code>, <code>http</code> et <code>scgi</code>.</p> - <p>Les workers de répartition sont des workers virtuels qui + <p>Les workers de répartition sont des workers virtuels qui utilisent les workers directs, connus comme faisant partie de leurs - membres, pour le traitement effectif des requêtes. Chaque - répartiteur peut comporter plusieurs membres. Lorsqu'il traite une - requête, il choisit un de ses membres en fonction de l'algorithme - de répartition de charge défini.</p> + membres, pour le traitement effectif des requêtes. Chaque + répartiteur peut comporter plusieurs membres. Lorsqu'il traite une + requête, il choisit un de ses membres en fonction de l'algorithme + de répartition de charge défini.</p> - <p>Un worker de répartition est créé si son URL de worker comporte + <p>Un worker de répartition est créé si son URL de worker comporte <code>balancer</code> comme indicateur de protocole. L'URL du - répartiteur permet d'identifier de manière unique le worker de - répartition. La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> permet d'ajouter des - membres au répartiteur.</p> + répartiteur permet d'identifier de manière unique le worker de + répartition. La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> permet d'ajouter des + membres au répartiteur.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="access" id="access">Contrôler l'accès à votre +<h2><a name="access" id="access">Contrôler l'accès à votre mandataire</a></h2> - <p>Vous pouvez restreindre l'accès à votre mandataire via le bloc - de contrôle <code class="directive"><a href="#proxy"><Proxy></a></code> comme dans + <p>Vous pouvez restreindre l'accès à votre mandataire via le bloc + de contrôle <code class="directive"><a href="#proxy"><Proxy></a></code> comme dans l'exemple suivant :</p> <pre class="prettyprint lang-config"><Proxy *> @@ -385,70 +385,70 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10</pre> </Proxy></pre> - <p>Pour plus de détails sur les directives de contrôle d'accès, + <p>Pour plus de détails sur les directives de contrôle d'accès, voir la documentation du module <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.</p> - <p>Restreindre l'accès de manière stricte est essentiel si vous - mettez en oeuvre un mandataire direct (en définissant la directive - <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> à "on"). - Dans le cas contraire, votre serveur pourrait être utilisé par - n'importe quel client pour accéder à des serveurs quelconques, - tout en masquant sa véritable identité. Ceci représente un danger - non seulement pour votre réseau, mais aussi pour l'Internet au + <p>Restreindre l'accès de manière stricte est essentiel si vous + mettez en oeuvre un mandataire direct (en définissant la directive + <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> à "on"). + Dans le cas contraire, votre serveur pourrait être utilisé par + n'importe quel client pour accéder à des serveurs quelconques, + tout en masquant sa véritable identité. Ceci représente un danger + non seulement pour votre réseau, mais aussi pour l'Internet au sens large. Dans le cas de la mise en oeuvre d'un mandataire - inverse (en utilisant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> avec <code>ProxyRequests Off</code>), le contrôle - d'accès est moins critique car les clients ne peuvent contacter - que les serveurs que vous avez spécifiés.</p> + inverse (en utilisant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> avec <code>ProxyRequests Off</code>), le contrôle + d'accès est moins critique car les clients ne peuvent contacter + que les serveurs que vous avez spécifiés.</p> <p><strong>Voir aussi</strong> la variable d'environnement <a href="mod_proxy_http.html#env">Proxy-Chain-Auth</a>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="startup" id="startup">Ralentissement au démarrage</a></h2> - <p>Si vous utilisez la directive <code class="directive"><a href="#proxyblock">ProxyBlock</a></code>, les noms d'hôtes sont résolus en adresses - IP puis ces dernières mises en cache au cours du démarrage - à des fins de tests de comparaisons ultérieurs. Ce processus peut +<h2><a name="startup" id="startup">Ralentissement au démarrage</a></h2> + <p>Si vous utilisez la directive <code class="directive"><a href="#proxyblock">ProxyBlock</a></code>, les noms d'hôtes sont résolus en adresses + IP puis ces dernières mises en cache au cours du démarrage + à des fins de tests de comparaisons ultérieurs. Ce processus peut durer plusieurs secondes (ou d'avantage) en fonction de la vitesse - à laquelle s'effectue la résolution des noms d'hôtes.</p> + à laquelle s'effectue la résolution des noms d'hôtes.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="intranet" id="intranet">Mandataire en Intranet</a></h2> - <p>Un serveur mandataire Apache httpd situé à l'intérieur d'un Intranet - doit faire suivre les requêtes destinées à un serveur externe à - travers le pare-feu de l'entreprise (pour ce faire, définissez la + <p>Un serveur mandataire Apache httpd situé à l'intérieur d'un Intranet + doit faire suivre les requêtes destinées à un serveur externe à + travers le pare-feu de l'entreprise (pour ce faire, définissez la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> de - façon à ce qu'elle fasse suivre le <var>protocole</var> concerné - vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder - à des ressources situées dans l'Intranet, il peut se passer du - pare-feu pour accéder aux serveurs. A cet effet, la directive + façon à ce qu'elle fasse suivre le <var>protocole</var> concerné + vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder + à des ressources situées dans l'Intranet, il peut se passer du + pare-feu pour accéder aux serveurs. A cet effet, la directive <code class="directive"><a href="#noproxy">NoProxy</a></code> permet de - spécifier quels hôtes appartiennent à l'Intranet et peuvent donc - être accédés directement.</p> + spécifier quels hôtes appartiennent à l'Intranet et peuvent donc + être accédés directement.</p> - <p>Les utilisateurs d'un Intranet ont tendance à oublier le nom du - domaine local dans leurs requêtes WWW, et demandent par exemple + <p>Les utilisateurs d'un Intranet ont tendance à oublier le nom du + domaine local dans leurs requêtes WWW, et demandent par exemple "http://un-serveur/" au lieu de <code>http://un-serveur.example.com/</code>. Certains serveurs - mandataires commerciaux acceptent ce genre de requête et les + mandataires commerciaux acceptent ce genre de requête et les traitent simplement en utilisant un nom de domaine local - implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilisée et si le - serveur est <a href="#proxyrequests">configuré comme - mandataire</a>, Apache httpd peut renvoyer une réponse de redirection et + implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilisée et si le + serveur est <a href="#proxyrequests">configuré comme + mandataire</a>, Apache httpd peut renvoyer une réponse de redirection et ainsi fournir au client l'adresse de serveur correcte, - entièrement qualifiée. C'est la méthode à privilégier car le + entièrement qualifiée. C'est la méthode à privilégier car le fichier des marque-pages de l'utilisateur contiendra alors des - noms de serveurs entièrement qualifiés.</p> + noms de serveurs entièrement qualifiés.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="envsettings" id="envsettings">Ajustements relatifs au protocole</a></h2> - <p>Pour les cas où <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> envoie des requêtes - vers un serveur qui n'implémente pas correctement les connexions + <p>Pour les cas où <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> envoie des requêtes + vers un serveur qui n'implémente pas correctement les connexions persistantes ou le protocole HTTP/1.1, il existe deux variables - d'environnement qui permettent de forcer les requêtes à utiliser + d'environnement qui permettent de forcer les requêtes à utiliser le protocole HTTP/1.0 avec connexions non persistantes. Elles - peuvent être définies via la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>.</p> + peuvent être définies via la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>.</p> <p>Il s'agit des variables <code>force-proxy-request-1.0</code> et <code>proxy-nokeepalive</code>.</p> @@ -462,191 +462,191 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10</pre> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="request-bodies" id="request-bodies">Corps de requêtes</a></h2> +<h2><a name="request-bodies" id="request-bodies">Corps de requêtes</a></h2> - <p>Certaines méthodes de requêtes comme POST comportent un corps de - requête. Le protocole HTTP stipule que les requêtes qui comportent + <p>Certaines méthodes de requêtes comme POST comportent un corps de + requête. Le protocole HTTP stipule que les requêtes qui comportent un corps doivent soit utiliser un codage de transmission - fractionnée (chunked transfer encoding), soit envoyer un en-tête de requête + fractionnée (chunked transfer encoding), soit envoyer un en-tête de requête <code>Content-Length</code>. Lorsqu'il fait suivre ce genre de - requête vers le serveur demandé, <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> - s'efforce toujours d'envoyer l'en-tête <code>Content-Length</code>. - Par contre, si la taille du corps est importante, et si la requête - originale utilise un codage à fractionnement, ce dernier peut aussi - être utilisé dans la requête montante. Ce comportement peut être - contrôlé à l'aide de <a href="../env.html">variables - d'environnement</a>. Ainsi, si elle est définie, la variable - <code>proxy-sendcl</code> assure une compatibilité maximale avec les - serveurs demandés en imposant l'envoi de l'en-tête + requête vers le serveur demandé, <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> + s'efforce toujours d'envoyer l'en-tête <code>Content-Length</code>. + Par contre, si la taille du corps est importante, et si la requête + originale utilise un codage à fractionnement, ce dernier peut aussi + être utilisé dans la requête montante. Ce comportement peut être + contrôlé à l'aide de <a href="../env.html">variables + d'environnement</a>. Ainsi, si elle est définie, la variable + <code>proxy-sendcl</code> assure une compatibilité maximale avec les + serveurs demandés en imposant l'envoi de l'en-tête <code>Content-Length</code>, alors que <code>proxy-sendchunked</code> diminue la consommation de ressources - en imposant l'utilisation d'un codage à fractionnement.</p> + en imposant l'utilisation d'un codage à fractionnement.</p> <p>Dans certaines circonstances, le serveur doit mettre en file - d'attente sur disque les corps de requêtes afin de satisfaire le - traitement demandé des corps de requêtes. Par exemple, cette mise en - file d'attente se produira si le corps original a été envoyé selon un - codage morcelé (et possède une taille importante), alors que - l'administrateur a demandé que les requêtes du serveur - d'arrière-plan soient envoyées avec l'en-tête Content-Length ou en + d'attente sur disque les corps de requêtes afin de satisfaire le + traitement demandé des corps de requêtes. Par exemple, cette mise en + file d'attente se produira si le corps original a été envoyé selon un + codage morcelé (et possède une taille importante), alors que + l'administrateur a demandé que les requêtes du serveur + d'arrière-plan soient envoyées avec l'en-tête Content-Length ou en HTTP/1.0. Cette mise en file d'attente se produira aussi si le corps - de la requête contient déjà un en-tête Content-Length, alors que le - serveur est configuré pour filtrer les corps des requêtes entrantes.</p> + de la requête contient déjà un en-tête Content-Length, alors que le + serveur est configuré pour filtrer les corps des requêtes entrantes.</p> <p>La directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> ne s'applique qu'aux - corps de requêtes que le serveur met en file d'attente sur disque.</p> + corps de requêtes que le serveur met en file d'attente sur disque.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="x-headers" id="x-headers">En-têtes de requête du mandataire +<h2><a name="x-headers" id="x-headers">En-têtes de requête du mandataire inverse</a></h2> - <p>Lorsqu'il est configuré en mode mandataire inverse (en utilisant + <p>Lorsqu'il est configuré en mode mandataire inverse (en utilisant par exemple la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>), - <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-têtes de requête - afin de transmettre des informations au serveur demandé. Ces - en-têtes sont les suivants :</p> + <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-têtes de requête + afin de transmettre des informations au serveur demandé. Ces + en-têtes sont les suivants :</p> <dl> <dt><code>X-Forwarded-For</code></dt> <dd>L'adresse IP du client.</dd> <dt><code>X-Forwarded-Host</code></dt> - <dd>L'hôte d'origine demandé par le client dans l'en-tête de - requête HTTP <code>Host</code>.</dd> + <dd>L'hôte d'origine demandé par le client dans l'en-tête de + requête HTTP <code>Host</code>.</dd> <dt><code>X-Forwarded-Server</code></dt> - <dd>Le nom d'hôte du serveur mandataire.</dd> + <dd>Le nom d'hôte du serveur mandataire.</dd> </dl> - <p>Ces en-têtes doivent être utilisés avec précautions sur le - serveur demandé, car ils contiendront plus d'une valeur (séparées - par des virgules) si la requête originale contenait déjà un de ces - en-têtes. Par exemple, vous pouvez utiliser - <code>%{X-Forwarded-For}i</code> dans la chaîne de format du journal - du serveur demandé pour enregistrer les adresses IP des clients + <p>Ces en-têtes doivent être utilisés avec précautions sur le + serveur demandé, car ils contiendront plus d'une valeur (séparées + par des virgules) si la requête originale contenait déjà un de ces + en-têtes. Par exemple, vous pouvez utiliser + <code>%{X-Forwarded-For}i</code> dans la chaîne de format du journal + du serveur demandé pour enregistrer les adresses IP des clients originaux, mais il est possible que vous obteniez plusieurs adresses - si la requête passe à travers plusieurs mandataires.</p> + si la requête passe à travers plusieurs mandataires.</p> <p>Voir aussi les directives <code class="directive"><a href="#proxypreservehost">ProxyPreserveHost</a></code> et <code class="directive"><a href="#proxyvia">ProxyVia</a></code> directives, qui permettent - de contrôler d'autres en-têtes de requête.</p> + de contrôler d'autres en-têtes de requête.</p> - <p>Note : Si vous devez ajouter des en-têtes particuliers à la - requête mandatée, utilisez la directive <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>.</p> + <p>Note : Si vous devez ajouter des en-têtes particuliers à la + requête mandatée, utilisez la directive <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</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="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>Nombre de membres supplémentaires pouvant être ajoutés -après la configuration initiale</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#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 est disponible depuis la version 2.3.13 du +<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>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> + <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>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#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#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>Disponible à partir de la version 2.4.5 du serveur +<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>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 + 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>Ajoute un membre à un groupe de répartition de +<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#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>Cette directive permet d'ajouter un membre à un groupe de - répartition de charge. Elle peut se trouver dans un conteneur + <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 + 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 (valeur par défaut) et 100, qui - définit la charge à appliquer au membre en question.</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 (valeur par défaut) et 100, 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 + 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 + <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>Tente de conserver les changements effectués par le - gestionnaire de répartition de charge après un redémarrage du +<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#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 n'est disponible qu'à partir de la +<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>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> + 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>Serveurs, domaines ou réseaux auquels on se connectera +<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>Cette directive n'a d'utilité que pour les serveurs mandataires + <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 + <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 @@ -654,7 +654,7 @@ NoProxy .example.com 192.168.112.0/21</pre> </div> <p>Le type des arguments <var>serveur</var> de la directive - <code class="directive">NoProxy</code> appartiennent à la liste suivante + <code class="directive">NoProxy</code> appartiennent à la liste suivante :</p> <dl> @@ -662,8 +662,8 @@ NoProxy .example.com 192.168.112.0/21</pre> <dt><var><a name="domain" id="domain">Domaine</a></var></dt> <dd> <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 + 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> @@ -671,68 +671,68 @@ NoProxy .example.com 192.168.112.0/21</pre> .com .example.org. </code></p></div> - <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 + <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> + 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>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 + 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> + <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">Sous-réseau</a></var></dt> + <dt><var><a name="subnet" id="subnet">Sous-réseau</a></var></dt> <dd> - <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 + <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 + 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> 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 + <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>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é + <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>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> + <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">Adresse IP</a></var></dt> <dd> <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> + 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>Exemple</h3><p><code> 192.168.123.7 </code></p></div> <div class="note"><h3>Note</h3> - <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 + <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> @@ -740,11 +740,11 @@ NoProxy .example.com 192.168.112.0/21</pre> <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt> <dd> <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 + 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 + 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> @@ -754,40 +754,40 @@ NoProxy .example.com 192.168.112.0/21</pre> <div class="note"><h3>Note</h3> <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 + 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 + 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> + <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">Problèmes liés au DNS</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>Conteneur de directives s'appliquant à des ressources -mandatées</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>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>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>Par exemple, les lignes suivantes n'autoriseront à accéder à un - contenu via votre serveur mandataire que les hôtes appartenant à + <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 *> @@ -795,21 +795,21 @@ mandatées</td></tr> </Proxy></pre> - <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> + <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/*> SetOutputFilter INCLUDES </Proxy></pre> - <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>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> @@ -817,18 +817,18 @@ mandatées</td></tr> </Proxy></pre> - <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 + <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, + 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 + <p>Pour un contrôle plus fin de la correspondance des URL, voir la directive <code class="directive"><ProxyMatch></code>.</p> </div> @@ -841,20 +841,20 @@ mandatées</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="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>Ajoute des informations à propos du mandataire aux -en-têtes X-Forwarded-*</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#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>Disponible depuis la version 2.3.10</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>Cette directive permet de passer au serveur d'arrière-plan des - informations à propos du mandataire via les en-têtes HTTP + <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é + <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> @@ -862,78 +862,78 @@ en-têtes X-Forwarded-*</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="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>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#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#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>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 + 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>Annule la requête et renvoie une réponse de code 502 (mauvaise - passerelle). C'est le comportement par défaut.</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>Traite les lignes d'en-tête incorrectes comme si elles n'avaient - pas été envoyées.</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>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> + <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>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#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>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 + 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 + <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> + <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 + <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 + <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 + 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> + <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> + 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> @@ -941,7 +941,7 @@ incorrectes d'une réponse</td></tr> <p>Notez qu'<code>example</code> suffirait aussi pour atteindre ces sites.</p> - <p>Hosts conviendrait aussi s'il était référencé par adresse IP.</p> + <p>Hosts conviendrait aussi s'il était référencé par adresse IP.</p> <p>Notez aussi que</p> @@ -954,20 +954,20 @@ incorrectes d'une réponse</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="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>Nom de domaine par défaut pour les requêtes -mandatées</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>Cette directive n'a d'utilité que pour les serveurs mandataires + <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> + <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<br /> NoProxy .example.com 192.168.112.0/21<br /> @@ -979,57 +979,57 @@ mandatées</td></tr> <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>Outrepasser les pages d'erreur pour les contenus -mandatés</td></tr> +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#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>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 + 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> + 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 + <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>Détermine la taille du tampon interne de transfert de -données</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#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>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 + 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. + <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 ! + 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 + <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> @@ -1037,25 +1037,25 @@ données</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="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>Conteneur de directives s'appliquant à des ressources -mandatées correspondant à une expression rationnelle</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>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 + 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> + <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> + é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 @@ -1070,90 +1070,90 @@ mandatées correspondant à une expression rationnelle</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="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>Nombre maximum de mandataires à travers lesquelles une -requête peut être redirigée</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#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>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 + 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> + type déni de service.</p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyMaxForwards 15</pre> </div> - <p>Notez que la définition de la directive + <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 + 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, + 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>Référencer des serveurs distants depuis +<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#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>Les Sockets de style Unix (Unix Domain Socket - UDS) sont supportés à partir +<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>Cette directive permet de référencer des serveurs distants depuis + <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 + 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> + serveur distant et ne doit pas contenir de chaîne d'arguments.</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>Cette directive ne peut pas être + utilisée dans un contexte de niveau répertoire.</div> - <div class="warning">En général, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit être définie à + <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>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 + <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> + 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 + <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 + <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 + <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> + 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> @@ -1163,36 +1163,36 @@ de la version 2.4.7 du serveur HTTP Apache</td></tr> </Location></pre> - <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>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>La directive ProxyPass ne peut pas être placée dans une section + <p>La directive ProxyPass 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> <p>Si vous avez besoin d'un configuration de mandataire inverse plus - souple, reportez-vous à la documentaion de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau + souple, reportez-vous à la documentaion de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau <code>[P]</code>.</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> + 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 "/miroir/foo/" "http://backend.example.com/"</pre> <div class="warning"> <p>Si le premier argument se termine par un slash - <strong>/</strong>, il doit en être de même pour le second argument + <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. + 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>Le drapeau <code>!</code> permet de soustraire un sous-répertoire + <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/"> @@ -1207,407 +1207,407 @@ de la version 2.4.7 du serveur HTTP Apache</td></tr> 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 + <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 + <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 + 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> + la plus spécifique qui l'emportera.</p> - <p>Pour les mêmes raisons, les exclusions doivent se situer + <p>Pour les mêmes raisons, les exclusions doivent se situer <em>avant</em> les directives <code class="directive">ProxyPass</code> - générales.</p> + générales.</p> </div> - <p><strong>ProxyPass <code>clé=valeur</code> Paramètres</strong></p> + <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 + 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> - <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 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> + <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 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> <p>Le groupement de connexions est maintenu au niveau de chaque processus enfant du serveur web, et <code>max</code>, ainsi que les - autres paramètres, ne font - l'objet d'aucune coordination entre les différents processus - enfants, sauf si un seul processus enfant est autorisé par la + autres paramètres, ne font + l'objet d'aucune coordination entre les différents processus + enfants, sauf si un seul processus enfant est autorisé par la configuration ou la conception du module multi-processus (MPM).</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>Paramètres de BalancerMember</th></tr></table> + <table class="bordered"><tr><th>Paramètres de BalancerMember</th></tr></table> <table> - <tr><th>Paramètre</th> - <th>Défaut</th> + <tr><th>Paramètre</th> + <th>Défaut</th> <th>Description</th></tr> <tr><td>min</td> <td>0</td> - <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> + <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>Nombre maximum de connexions autorisées vers le serveur - d'arrière-plan. La valeur par défaut correspond au nombre de + <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 + 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>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> + <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>Cette clé permet de définir le délai maximum d'attente pour + <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. + l'état <code>SERVER_BUSY</code> au client. </td></tr> <tr><td>connectiontimeout</td> <td>timeout</td> - <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 + <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. </td></tr> <tr><td>disablereuse</td> <td>Off</td> - <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). Pour désactiver la réutilisation du jeu de - connexions, définissez cette clé à <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). 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>Fournie à l'intention des gestionnaires de projet - qui nécessitent un accord pour la réutilisation des connexions + <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>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 AJP. + <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 AJP. </td></tr> <tr><td>flushwait</td> <td>10</td> - <td>Le délai d'attente pour une entrée additionnelle, en + <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'. + où 'flushpackets' est à 'auto'. </td></tr> <tr><td>iobuffersize</td> <td>8192</td> - <td>Permet de définir la taille du tampon d'entrées/sorties du - bloc-notes interne. Cette clé vous permet d'outrepasser la + <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. + 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>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 + <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. + 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.</p> + 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.</p> </td></tr> <tr><td>lbset</td> <td>0</td> - <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>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>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 + <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 + 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. + 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 + 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. </td></tr> <tr><td>receivebuffersize</td> <td>0</td> - <td>Définit la taille du tampon réseau explicite (TCP/IP) pour - les connexions mandatées. Cette clé vous permet d'outrepasser la + <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. + 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>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é. + 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>Délai entre deux essais du serveur cible du jeu de connexions en + <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 + 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. + 0 implique de toujours essayer les serveurs cibles dans un état d'erreur + sans délai. </td></tr> <tr><td>route</td> <td>-</td> - <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 à + <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>Valeur constituée d'une simple lettre et définissant l'état + <td>Valeur constituée d'une simple lettre et définissant l'état initial de ce serveur cible. <table> - <tr><td>D: le serveur cible est désactivé et n'accepte aucune requête.</td></tr> - <tr><td>S: le serveur cible est arrêté.</td></tr> - <tr><td>I: le serveur cible est en mode "erreurs ignorées", - et sera toujours considéré comme disponible.</td></tr> + <tr><td>D: le serveur cible est désactivé et n'accepte aucune requête.</td></tr> + <tr><td>S: le serveur cible est arrêté.</td></tr> + <tr><td>I: le serveur cible est en mode "erreurs ignorées", + et sera toujours considéré comme disponible.</td></tr> <tr><td>H: le serveur cible est en mode d'attente et ne sera - utilisé que si aucun autre serveur n'est disponible.</td></tr> + utilisé que si aucun autre serveur n'est disponible.</td></tr> <tr><td>E: le serveur cible est en erreur.</td></tr> <tr><td>N: 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> + toutes les autres requêtes.</td></tr> </table> - 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 + 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>Délai d'attente de la connexion en secondes. Le nombre de + <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. + données vers le serveur d'arrière-plan. </td></tr> <tr><td>ttl</td> <td>-</td> - <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. + <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. </td></tr> <tr><td>flusher</td> <td>flush</td> - <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><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> </table> - <p>Si l'URL de la directive Proxy débute par + <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 + 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 + d'informations à propos du fonctionnement du répartiteur de charge. </p> - <table class="bordered"><tr><th>Paramètres du répartiteur</th></tr></table> + <table class="bordered"><tr><th>Paramètres du répartiteur</th></tr></table> <table> - <tr><th>Paramètre</th> - <th>Défaut</th> + <tr><th>Paramètre</th> + <th>Défaut</th> <th>Description</th></tr> <tr><td>lbmethod</td> <td>byrequests</td> - <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 + <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>1 de moins que le nombre de workers, ou 1 avec un seul worker</td> - <td>Nombre maximum d'échecs avant abandon. + <td>Nombre maximum d'échecs avant abandon. </td></tr> <tr><td>nofailover</td> <td>Off</td> - <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>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>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 /> + <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>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>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>Si ce paramètre est défini à <code>On</code>, le caractère - ';' sera utilisé comme séparateur de chemin de session + <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>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 + <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. </td></tr> <tr><td>failonstatus</td> <td>-</td> - <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 + <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>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 + <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>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 + <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>En plus du nombre à usage unique, la page de l'application - <code>balancer-manager</code> peut être protégée par une 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>Nombre de membres supplémentaires que l'on peut ajouter à ce - répartiteur en plus de ceux définis au niveau de la + <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 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 à + <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>Exemple de configuration d'un répartiteur de charge</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 <Proxy balancer://mycluster> @@ -1618,7 +1618,7 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail </Proxy></pre> - <p>Configuration d'un serveur cible de réserve qui ne sera utilisé que si + <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> @@ -1630,38 +1630,38 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail </Proxy></pre> - <p><strong>Mot-clés supplémentaires de ProxyPass</strong></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 + 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> + 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>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 + <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 + 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 + 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 @@ -1681,25 +1681,25 @@ ProxyPassReverse "/mirror/foo/" "https://backend.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="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>Héritage des directives ProxyPass définies au niveau du +<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#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>Disponible à partir de la version 2.4.5 du serveur +<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>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 + <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 + 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> @@ -1709,8 +1709,8 @@ HTTP Apache.</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#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> @@ -1719,19 +1719,19 @@ les configurations de mandataires inverses</td></tr> <code class="directive">ProxyPassReverse</code>, <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 + 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 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> + 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> @@ -1740,21 +1740,21 @@ les configurations de mandataires inverses</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> +[<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>Cette directive est identique à la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des + <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 à + 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 + 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>Cette directive ne peut pas être + utilisée dans un contexte de niveau répertoire.</div> <p>Supposons que le serveur local a pour adresse <code>http://example.com/</code> ; alors</p> @@ -1762,20 +1762,20 @@ du serveur local en utilisant des expressions rationnelles</td></tr> <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 + <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> <div class="note"><h3>Note</h3> - <p>L'argument URL doit pouvoir être interprété en tant qu'URL + <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> + 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 + <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> @@ -1783,10 +1783,10 @@ du serveur local en utilisant des expressions rationnelles</td></tr> </div> <p>Le drapeau <code>!</code> vous permet de ne pas mandater un - sous-répertoire donné.</p> + 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 + 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>Si vous avez besoin d'une configuration du mandataire inverse @@ -1794,17 +1794,17 @@ du serveur local en utilisant des expressions rationnelles</td></tr> <code>[P]</code>.</p> <div class="note"> - <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. + <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>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 + <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 @@ -1815,36 +1815,36 @@ du serveur local en utilisant des expressions rationnelles</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="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>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#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#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>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 + 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 + 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 + <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>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> + 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>Supposons par exemple que le serveur local a pour adresse <code>http://example.com/</code> ; alors</p> @@ -1855,45 +1855,45 @@ ProxyPassReverseCookieDomain backend.example.com public.example.com ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre> - <p>ne va pas seulement provoquer la conversion interne d'une requête + <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 + 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 + <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> + 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 + 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="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 + <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 + 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. + 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>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 + <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> @@ -1901,40 +1901,40 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre> <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>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#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#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>L'utilisation de cette directive est similaire à celle de la +<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 +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>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#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#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> -Cette directive s'avère utile en conjonction avec la directive +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 +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 +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> Dans l'exemple fourni avec la directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, la directive : @@ -1942,7 +1942,7 @@ Dans l'exemple fourni avec la directive <code class="directive"><a href="#proxyp <pre class="prettyprint lang-config">ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre> <p> -va réécrire un cookie possédant un chemin d'arrière-plan <code>/</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> @@ -1951,44 +1951,44 @@ en <code>/mirror/foo/</code>.. <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>Utilise l'en-tête de requête entrante Host pour la requête +<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#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>Utilisable -dans un contexte de répertoire depuis la version 2.3.3.</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>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>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>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> + <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>Taille du tampon réseau pour les connexions mandatées HTTP +<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#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>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> + 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> @@ -1997,19 +1997,19 @@ et FTP</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="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>Mandataire distant à utiliser pour traiter certaines -requêtes</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>Cette directive permet de définir des mandataires distants pour + <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 + 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> @@ -2017,78 +2017,78 @@ requêtes</td></tr> <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>] </code></p></div> - <p><var>protocole</var> est effectivement le protocole à utiliser + <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> + <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>Exemple</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>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 + <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>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é + 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>Le mandataire distant à utiliser pour traiter les requêtes -correspondant à une expression rationnelle</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>La directive <code class="directive">ProxyRemoteMatch</code> est - identique à la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, à l'exception du + 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> + 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>Active la fonctionnalité (standard) de mandataire +<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#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>Cette directive permet d'activer/désactiver la fonctionnalité de - serveur mandataire direct d'Apache httpd. Définir ProxyRequests à + <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>Pour une configuration typique de mandataire inverse ou - passerelle, cette directive doit être définie à + passerelle, cette directive doit être définie à <code>Off</code>.</p> - <p>Afin d'activer la fonctionnalité de mandataire pour des sites + <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 + <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>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> + <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>Avertissement</h3> - <p>N'activez pas la fonctionnalité de mandataire avec la directive + <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 + 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> + réseau, mais aussi pour l'Internet au sens large.</p> </div> <h3>Voir aussi</h3> @@ -2100,21 +2100,21 @@ inverses</a></li> <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>Définit différents paramètres relatifs à la répartition de -charge des mandataires et aux membres des groupes de répartition de +<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#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>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 + <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 + 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> @@ -2136,10 +2136,10 @@ charge</td></tr> <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> + <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> @@ -2147,36 +2147,36 @@ charge</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="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>Définit l'adresse IP locale pour les connexions mandatées +<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>Disponible depuis la version 2.3.9</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>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> + <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>Affiche l'état du répartiteur de charge du mandataire dans +<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#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>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> + <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>L'argument <strong>Full</strong> produit le même effet que + <p>L'argument <strong>Full</strong> produit le même effet que l'argument <strong>On</strong>.</p> </div> @@ -2185,64 +2185,64 @@ mod_status</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="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>Délai d'attente réseau pour les requêtes -mandatées</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>secondes</var></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#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</td></tr> <tr><th><a href="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>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> + <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 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#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#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>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 + <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 + section 14.45 pour une description des lignes d'en-tête <code>Via:</code>.</p> <ul> - <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 + <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 + <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 + <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> + <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> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_proxy.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_proxy.html" title="Français"> fr </a> | <a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- @@ -2262,7 +2262,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy.html } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_proxy_http.html b/docs/manual/mod/mod_proxy_http.html index feb9d289e7..bc2934c98d 100644 --- a/docs/manual/mod/mod_proxy_http.html +++ b/docs/manual/mod/mod_proxy_http.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_proxy_http.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_proxy_http.html.fr b/docs/manual/mod/mod_proxy_http.html.fr index 6a0dca01ea..b94399b547 100644 --- a/docs/manual/mod/mod_proxy_http.html.fr +++ b/docs/manual/mod/mod_proxy_http.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,38 +27,38 @@ <div id="preamble"><h1>Module Apache mod_proxy_http</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_http.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_proxy_http.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_proxy_http.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support HTTP à +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support HTTP à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_http_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_http.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_http_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_http.c</td></tr></table> <h3>Sommaire</h3> <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le chargement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du - mandatement des requêtes HTTP et HTTPS. <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> + mandatement des requêtes HTTP et HTTPS. <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> supporte HTTP/0.9, HTTP/1.0 et HTTP/1.1. Il ne fournit - <em>aucune</em> fonctionnalité de mise en cache. Si vous souhaitez + <em>aucune</em> fonctionnalité de mise en cache. Si vous souhaitez mettre en oeuvre un mandataire qui assure aussi les fonctions de mise en cache, vous devez utiliser les services du module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> - <p>Ainsi, pour pouvoir traiter les requêtes HTTP mandatées, + <p>Ainsi, pour pouvoir traiter les requêtes HTTP mandatées, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, et <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> - doivent être chargés dans le serveur.</p> + doivent être chargés dans le serveur.</p> <div class="warning"><h3>Avertissement</h3> - <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#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> + votre réseau, mais aussi pour l'Internet au sens large.</p> </div> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#env">Variables d'environnement</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#notes">Informations sur les requêtes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#notes">Informations sur les requêtes</a></li> </ul><h3 class="directives">Directives</h3> <p>Ce module ne fournit aucune directive.</p> <h3>Voir aussi</h3> @@ -69,103 +69,103 @@ <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="env" id="env">Variables d'environnement</a></h2> - <p>Outre les directives de configuration qui contrôlent le + <p>Outre les directives de configuration qui contrôlent le comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, plusieurs <dfn>variables - d'environnement</dfn> permettent de contrôler le fournisseur du + d'environnement</dfn> permettent de contrôler le fournisseur du protocole HTTP. Parmi les variables suivantes, celle qui ne - nécessitent pas de valeur particulière sont définies quelle que soit + nécessitent pas de valeur particulière sont définies quelle que soit la valeur qu'on leur affecte.</p> <dl> <dt>proxy-sendextracrlf</dt> <dd>Provoque l'envoi par le mandataire d'une nouvelle ligne - CR-LF supplémentaire à la fin de la requête. + CR-LF supplémentaire à la fin de la requête. Ceci constitue un moyen de contournement d'une bogue de certains navigateurs.</dd> <dt>force-proxy-request-1.0</dt> - <dd>Force le mandataire à envoyer des requêtes vers le serveur - cible selon le protocole HTTP/1.0 et désactive les - fonctionnalités propres à HTTP/1.1.</dd> + <dd>Force le mandataire à envoyer des requêtes vers le serveur + cible selon le protocole HTTP/1.0 et désactive les + fonctionnalités propres à HTTP/1.1.</dd> <dt>proxy-nokeepalive</dt> - <dd>Force le mandataire à fermer la connexion avec le serveur - cible après chaque requête.</dd> + <dd>Force le mandataire à fermer la connexion avec le serveur + cible après chaque requête.</dd> <dt>proxy-chain-auth</dt> <dd>Si le mandataire requiert une authentification, il va lire - et exploiter les données d'authentification pour mandataire - envoyées par le client. Si <var>proxy-chain-auth</var> est - définie, il va <em>aussi</em> faire suivre ces données vers le - mandataire suivant dans la chaîne. Ceci peut s'avérer nécessaire - si une chaîne de mandataires partagent les informations + et exploiter les données d'authentification pour mandataire + envoyées par le client. Si <var>proxy-chain-auth</var> est + définie, il va <em>aussi</em> faire suivre ces données vers le + mandataire suivant dans la chaîne. Ceci peut s'avérer nécessaire + si une chaîne de mandataires partagent les informations d'authentification. - <strong>Avertissement concernant la sécurité :</strong> - Ne définissez cette variable que si vous êtes sûr d'en avoir + <strong>Avertissement concernant la sécurité :</strong> + Ne définissez cette variable que si vous êtes sûr d'en avoir besoin, car elle peut provoquer la divulgation d'informations sensibles !</dd> <dt>proxy-sendcl</dt> - <dd>Avec HTTP/1.0, toutes les requêtes qui possèdent un corps - (par exemple les requêtes POST) doivent comporter un en-tête + <dd>Avec HTTP/1.0, toutes les requêtes qui possèdent un corps + (par exemple les requêtes POST) doivent comporter un en-tête <var>Content-Length</var>. Cette variable d'environnement force - le mandataire Apache à envoyer cet en-tête au serveur cible, - sans tenir compte de ce que lui a envoyé le client. Ceci permet - d'assurer la compatibilité lorsqu'on mandate un serveur cible + le mandataire Apache à envoyer cet en-tête au serveur cible, + sans tenir compte de ce que lui a envoyé le client. Ceci permet + d'assurer la compatibilité lorsqu'on mandate un serveur cible mettant en oeuvre un protocole de type HTTP/1.0 ou inconnu. Elle - peut cependant nécessiter la mise en tampon de l'intégralité de - la requête par le mandataire, ce qui s'avère très inefficace - pour les requêtes de grande taille.</dd> + peut cependant nécessiter la mise en tampon de l'intégralité de + la requête par le mandataire, ce qui s'avère très inefficace + pour les requêtes de grande taille.</dd> <dt>proxy-sendchunks ou proxy-sendchunked</dt> - <dd>Cette variable constitue l'opposé de + <dd>Cette variable constitue l'opposé de <var>proxy-sendcl</var>. Elle permet la transmission des corps - de requêtes vers le serveur cible en utilisant un codage de - transfert fractionné. Ceci permet une transmission des requêtes - plus efficace, mais nécessite que le serveur cible supporte le + de requêtes vers le serveur cible en utilisant un codage de + transfert fractionné. Ceci permet une transmission des requêtes + plus efficace, mais nécessite que le serveur cible supporte le protocole HTTP/1.1.</dd> <dt>proxy-interim-response</dt> <dd>Cette variable peut prendre les valeurs <code>RFC</code> - (valeur par défaut) ou - <code>Suppress</code>. Les versions précédentes de httpd - supprimaient les réponses intermédiaires HTTP (1xx) envoyées par + (valeur par défaut) ou + <code>Suppress</code>. Les versions précédentes de httpd + supprimaient les réponses intermédiaires HTTP (1xx) envoyées par le serveur cible. En pratique, si un serveur cible envoie une - réponse intermédiaire, il se peut qu'il étende lui-même le - protocole d'une manière dont nous n'avons pas connaissance, ou + réponse intermédiaire, il se peut qu'il étende lui-même le + protocole d'une manière dont nous n'avons pas connaissance, ou tout simplement non conforme. Le comportement du mandataire est - donc maintenant configurable : définissez - <code>proxy-interim-response RFC</code> pour être totalement + donc maintenant configurable : définissez + <code>proxy-interim-response RFC</code> pour être totalement compatible avec le protocole, ou <code>proxy-interim-response - Suppress</code> pour supprimer les réponses intermédiaires.</dd> + Suppress</code> pour supprimer les réponses intermédiaires.</dd> <dt>proxy-initial-not-pooled</dt> - <dd>Si cette variable est définie, aucune connexion faisant - partie d'un jeu ne sera réutilisée si la requête - du client est la requête initiale pour une connexion. - Ceci permet d'éviter le message d'erreur - "proxy: error reading status line from remote server" causé par - la situation de compétition au cours de laquelle le serveur - cible ferme la connexion du jeu après la vérification de la - connexion par le mandataire, et avant que les données envoyées + <dd>Si cette variable est définie, aucune connexion faisant + partie d'un jeu ne sera réutilisée si la requête + du client est la requête initiale pour une connexion. + Ceci permet d'éviter le message d'erreur + "proxy: error reading status line from remote server" causé par + la situation de compétition au cours de laquelle le serveur + cible ferme la connexion du jeu après la vérification de la + connexion par le mandataire, et avant que les données envoyées par le mandataire n'atteignent le serveur cible. Il faut - cependant garder à l'esprit que la définition de cette variable - dégrade les performances, particulièrement avec les clients + cependant garder à l'esprit que la définition de cette variable + dégrade les performances, particulièrement avec les clients HTTP/1.0. </dd> </dl> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="notes" id="notes">Informations sur les requêtes</a></h2> +<h2><a name="notes" id="notes">Informations sur les requêtes</a></h2> <p><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> enregistre les informations suivantes pour journalisation via le format <code>%{NOMVAR}n</code> dans les directives <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> ou <code class="directive"><a href="../mod/core.html#errorlogformat">ErrorLogFormat</a></code> : </p> <dl> <dt>proxy-source-port</dt> - <dd>Le port local utilisé pour la connexion vers le serveur - d'arrière-plan.</dd> + <dd>Le port local utilisé pour la connexion vers le serveur + d'arrière-plan.</dd> <dt>proxy-status</dt> - <dd>Le code d'état HTTP reçu du serveur d'arrière-plan.</dd> + <dd>Le code d'état HTTP reçu du serveur d'arrière-plan.</dd> </dl> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_http.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_proxy_http.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_proxy_http.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -184,7 +184,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy_http } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_remoteip.html b/docs/manual/mod/mod_remoteip.html index 45439c7431..303680ecb8 100644 --- a/docs/manual/mod/mod_remoteip.html +++ b/docs/manual/mod/mod_remoteip.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_remoteip.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_remoteip.html.fr b/docs/manual/mod/mod_remoteip.html.fr index 8a1f80327f..c1bee35efa 100644 --- a/docs/manual/mod/mod_remoteip.html.fr +++ b/docs/manual/mod/mod_remoteip.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,43 +27,43 @@ <div id="preamble"><h1>Module Apache mod_remoteip</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP et le nom d'hôte apparents du client -pour la requête par l'adresse IP présentée par un mandataire ou un -répartiteur de charge via les en-têtes de la requête. +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. </td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>remoteip_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_remoteip.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>remoteip_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_remoteip.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module permet de traiter l'hôte distant qui a initié la - requête en tant qu'hôte distant original du point de vue de httpd à - des fins d'autorisation et de connexion, même si cet hôte distant se - trouve derrière un répartiteur de charge, un serveur frontal, ou un + <p>Ce module permet de traiter l'hôte distant qui a initié la + requête en tant qu'hôte distant original du point de vue de httpd à + des fins d'autorisation et de connexion, même si cet hôte distant se + trouve derrière un répartiteur de charge, un serveur frontal, ou un serveur mandataire.</p> - <p>Le module remplace les adresse IP et nom d'hôte apparents - distants (du client) pour la requête par l'adresse IP indiquée dans - l'en-tête de requête configuré via la directive + <p>Le module remplace les adresse IP et nom d'hôte apparents + distants (du client) pour la requête par l'adresse IP indiquée dans + l'en-tête de requête configuré via la directive <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.</p> - <p>Une fois remplacée comme indiqué, cette adresse IP apparente est - utilisée pour la fonctionnalité <code class="directive"><a href="../mod/mod_authz_core.html#require">Require ip</a></code> de - <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affichée par - <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistrée via les directives + <p>Une fois remplacée comme indiqué, cette adresse IP apparente est + utilisée pour la fonctionnalité <code class="directive"><a href="../mod/mod_authz_core.html#require">Require ip</a></code> de + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affichée par + <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistrée via les directives <code>%a</code> et <code>%h</code> du module <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. Elle permet aussi d'identifier la - machine en essayant de lui attribuer une identité inetd via le + machine en essayant de lui attribuer une identité inetd via le module <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> et en fonction de la configuration de la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>.</p> <div class="warning">Il est essentiel de n'activer cette - fonctionnalité que pour les requêtes en provenance des serveurs - intermédiaires (mandataires, etc...) auxquels le serveur peut faire + fonctionnalité que pour les requêtes en provenance des serveurs + intermédiaires (mandataires, etc...) auxquels le serveur peut faire confiance, car il est trivial pour le client distant d'usurper - l'identité d'un autre client.</div> + l'identité d'un autre client.</div> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> @@ -89,73 +89,73 @@ répartiteur de charge via les en-têtes de la requête. <h2><a name="processing" id="processing">Traitement des adresses distantes</a></h2> <p>Apache identifie le client par la valeur remote_ip de la - connexion, et de cette valeur découlent les valeurs remote_host et - remote_logname de la connexion. Ces champs jouent un rôle + connexion, et de cette valeur découlent les valeurs remote_host et + remote_logname de la connexion. Ces champs jouent un rôle dans l'authentification, l'autorisation et la connexion, ainsi que - dans d'autres traitements effectués par d'autres modules + dans d'autres traitements effectués par d'autres modules chargeables.</p> - <p>mod_remoteip remplace la véritable remote_ip par la remote_ip - indiquée par exemple par un mandataire chaque fois que le serveur - effectue une évaluation du client, et réinitialise les valeurs de - remote_host et remote_logname afin de déclencher une nouvelle - requête dns ou ident sur l'adresse IP distante.</p> + <p>mod_remoteip remplace la véritable remote_ip par la remote_ip + indiquée par exemple par un mandataire chaque fois que le serveur + effectue une évaluation du client, et réinitialise les valeurs de + remote_host et remote_logname afin de déclencher une nouvelle + requête dns ou ident sur l'adresse IP distante.</p> - <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP - distantes séparées par des virgules, celles-ci sont traitées de la - droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP - distante courante n'est pas digne de confiance pour présenter - l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de - façon à ne contenir que cette liste d'adresses non confirmées, ou + <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP + distantes séparées par des virgules, celles-ci sont traitées de la + droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP + distante courante n'est pas digne de confiance pour présenter + l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de + façon à ne contenir que cette liste d'adresses non confirmées, ou bien, si toutes les adresses IP sont dignes de confiance, cet - en-tête est tout bonnement supprimé de la requête.</p> + en-tête est tout bonnement supprimé de la requête.</p> <p>Lors du remplacement de l'adresse IP distante, le module stocke - la liste des hôtes intermédiaires dans un mémo + la liste des hôtes intermédiaires dans un mémo remoteip-proxy-ip-list, que l'on peut faire enregistrer par <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> en utilisant le symbole de format <code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit - stocker ceci dans un en-tête additionnel, la même valeur peut aussi - être enregistrée sous la forme d'un en-tête en utilisant la + stocker ceci dans un en-tête additionnel, la même valeur peut aussi + être enregistrée sous la forme d'un en-tête en utilisant la directive <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code>.</p> <div class="note"><h3>Adresses IPv4 converties au format IPv6</h3> - Avec httpd, d'une manière générale, toute adresse IPv4 convertie au - format IPv6 est enregistrée sous sa forme IPv4.</div> + Avec httpd, d'une manière générale, toute adresse IPv4 convertie au + format IPv6 est enregistrée sous sa forme IPv4.</div> - <div class="note"><h3>Adresses internes (privées)</h3> + <div class="note"><h3>Adresses internes (privées)</h3> Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16, 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc - public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque + public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque des mandataires internes (intranet) - <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> sont enregistrés.</div> + <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> sont enregistrés.</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>Définit le champ d'en-tête qui contiendra les adresses IP +<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#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>La directive <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> indique à + <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 + 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 + <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 + <div class="example"><h3>Exemple à usage interne (répartiteur de charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP</pre> </div> @@ -166,24 +166,24 @@ du client</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="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>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#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> +<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>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 + 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> + 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 + <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> @@ -193,53 +193,53 @@ RemoteIPInternalProxy gateway.localdomain</pre> <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>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#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>La directive <code class="directive"><a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></code> - permet de spécifier un fichier parcouru au démarrage du serveur pour + 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 + 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 + <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 + 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 + <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>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> + 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>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#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>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 la véritable - adresse IP distante. 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 + 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 la véritable + adresse IP distante. 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 @@ -251,33 +251,33 @@ RemoteIPProxiesHeader X-Forwarded-By</pre> <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>Restreint les adresses IP clients dignes de -confiance pour présenter la valeur RemoteIPHeader</td></tr> +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> +<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>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 + 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 + <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 + 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 + (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas dignes de confiance en tant qu'adresses IP distantes, et se situent - à gauche dans le contenu de l'en-tête + à 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 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>Exemple d'adresse de confiance (répartiteur de + <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> @@ -288,31 +288,31 @@ RemoteIPTrustedProxy proxy.example.com</pre> <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>Restreint les adresses IP clients dignes de -confiance pour présenter la valeur RemoteIPHeader</td></tr> +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>La directive <code class="directive"><a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></code> - permet de spécifier un fichier parcouru au démarrage du serveur pour + 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 + 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 + <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 + <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/mandataires-de-confiance.lst contents</h3><p><code> - # Mandataires externes identifiés<br /> + # 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> @@ -321,7 +321,7 @@ RemoteIPTrustedProxyList conf/trusted-proxies.lst</pre> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -340,7 +340,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_remoteip.h } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_rewrite.html b/docs/manual/mod/mod_rewrite.html index 0458883652..70dd34b156 100644 --- a/docs/manual/mod/mod_rewrite.html +++ b/docs/manual/mod/mod_rewrite.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_rewrite.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_rewrite.html.fr b/docs/manual/mod/mod_rewrite.html.fr index ed41780176..6f6a0a26c5 100644 --- a/docs/manual/mod/mod_rewrite.html.fr +++ b/docs/manual/mod/mod_rewrite.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,40 +27,40 @@ <div id="preamble"><h1>Module Apache mod_rewrite</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_rewrite.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_rewrite.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de réécriture à base de -règles permettant de réécrire les URLs des requêtes -à la volée</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de réécriture à base de +règles permettant de réécrire les URLs des requêtes +à la volée</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>rewrite_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_rewrite.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>rewrite_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_rewrite.c</td></tr></table> <h3>Sommaire</h3> <p>Le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> utilise un moteur de - réécriture à base de règles, basé sur un interpréteur - d'expressions rationnelles PCRE, pour réécrire les URLs à la volée. Par - défaut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> met en correspondance une URL - avec le système de fichiers. Cependant, on peut aussi l'utiliser + réécriture à base de règles, basé sur un interpréteur + d'expressions rationnelles PCRE, pour réécrire les URLs à la volée. Par + défaut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> met en correspondance une URL + avec le système de fichiers. Cependant, on peut aussi l'utiliser pour rediriger une URL vers une autre URL, ou pour invoquer une - requête interne à destination du mandataire.</p> - <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> fournit une méthode souple et - puissante pour manipuler les URLs en utilisant un nombre illimité - de règles. Chaque règle peut être associée à un nombre illimité de - conditions, afin de vous permettre de réécrire les URLs en + requête interne à destination du mandataire.</p> + <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> fournit une méthode souple et + puissante pour manipuler les URLs en utilisant un nombre illimité + de règles. Chaque règle peut être associée à un nombre illimité de + conditions, afin de vous permettre de réécrire les URLs en fonction de variables du serveur, de variables d'environnement, - d'en-têtes HTTP, ou de repères temporels.</p> - <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> agit sur la totalité de l'URL, y - compris la partie chemin. Une règle de réécriture peut être - invoquée dans <code>httpd.conf</code> ou dans un fichier - <code>.htaccess</code>. Le chemin généré par une règle de - réécriture peut inclure une chaîne de paramètres, ou peut renvoyer + d'en-têtes HTTP, ou de repères temporels.</p> + <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> agit sur la totalité de l'URL, y + compris la partie chemin. Une règle de réécriture peut être + invoquée dans <code>httpd.conf</code> ou dans un fichier + <code>.htaccess</code>. Le chemin généré par une règle de + réécriture peut inclure une chaîne de paramètres, ou peut renvoyer vers un traitement secondaire interne, une redirection vers une - requête externe ou vers le mandataire interne.</p> + requête externe ou vers le mandataire interne.</p> - <p>Vous trouverez d'avantage de détails, discussions et exemples + <p>Vous trouverez d'avantage de détails, discussions et exemples dans la - <a href="../rewrite/">documentation détaillée + <a href="../rewrite/">documentation détaillée sur mod_rewrite</a>.</p> </div> <div id="quickview"><h3>Sujets</h3> @@ -80,34 +80,34 @@ règles permettant de réécrire les URLs des requêtes <div class="section"> <h2><a name="logging" id="logging">Journalisation</a></h2> - <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> offre une journalisation détaillée - de ses actions aux niveaux de journalisation <code>trace1</code> à - <code>trace8</code>. Le niveau de journalisation peut être défini de - manière spécifique à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> via la directive + <p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> offre une journalisation détaillée + de ses actions aux niveaux de journalisation <code>trace1</code> à + <code>trace8</code>. Le niveau de journalisation peut être défini de + manière spécifique à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> via la directive <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> : jusqu'au niveau - <code>debug</code> aucune action n'est journalisée, alors qu'elles + <code>debug</code> aucune action n'est journalisée, alors qu'elles le sont pratiquement toutes au niveau <code>trace8</code>.</p> <div class="note"> - L'utilisation d'un niveau de journalisation élevé pour + L'utilisation d'un niveau de journalisation élevé pour <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> va ralentir votre serveur HTTP Apache - de manière dramatique ! N'utilisez un niveau de journalisation - supérieur à <code>trace2</code> qu'à des fins de débogage ! + de manière dramatique ! N'utilisez un niveau de journalisation + supérieur à <code>trace2</code> qu'à des fins de débogage ! </div> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogLevel alert rewrite:trace3</pre> </div> <div class="note"><h3>RewriteLog</h3> - <p>Ceux qui sont familiers avec les versions précédentes de + <p>Ceux qui sont familiers avec les versions précédentes de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> vont probablement rechercher en vain les directives <code>RewriteLog</code> et - <code>RewriteLogLevel</code>. Elles ont été en effet remplacées + <code>RewriteLogLevel</code>. Elles ont été en effet remplacées par une configuration de la journalisation par module, comme - mentionné plus haut. + mentionné plus haut. </p> - <p>Pour extraire les traces spécifiques à + <p>Pour extraire les traces spécifiques à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, affichez le fichier journal en redirigeant la sortie vers grep :</p> <div class="example"><p><code> @@ -119,47 +119,47 @@ règles permettant de réécrire les URLs des requêtes <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>Définit l'URL de base pour les réécritures au niveau -répertoire</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#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>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">RewriteRule</code> qui réécrivent vers un chemin + spécifier le préfixe d'URL à utiliser dans un contexte de + répertoire (htaccess) pour les directives + <code class="directive">RewriteRule</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> + répertoire (htaccess), sauf si au moins une de ces conditions est + vérifiée :</p> <ul> - <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 + <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">RewriteRule</code>, suffixé par + <li>Le chemin du système de fichiers vers le répertoire + contenant la <code class="directive">RewriteRule</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.11 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 + 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>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> +<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" @@ -175,62 +175,62 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3" <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>Définit une condition qui devra être satisfaite pour que -la réécriture soit effectuée +<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>chaîne_de_test</em> <em>expression_de_comparaison</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> + <em>chaîne_de_test</em> <em>expression_de_comparaison</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>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> est une chaîne qui peut contenir les + <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> est une chaîne qui peut contenir les extensions suivantes en plus du texte simple :</p> <ul> <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> + <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>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 + <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> + courant. %0 donne accès à l'ensemble de la chaîne + correspondant au modèle.</li> <li> - <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. + <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>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 + où <em>NOM_DE_VARIABLE</em> peut contenir une chaîne issue de la liste suivante : <table> <tr> - <th>En-têtes HTTP :</th> <th>connexion & requête:</th> <th /> + <th>En-têtes HTTP :</th> <th>connexion & requête:</th> <th /> </tr> <tr> @@ -265,7 +265,7 @@ la réécriture soit effectuée </tr> <tr> - <th>variables internes au serveur :</th> <th>date et heure :</th> <th>spéciaux :</th> + <th>variables internes au serveur :</th> <th>date et heure :</th> <th>spéciaux :</th> </tr> <tr> @@ -306,18 +306,18 @@ la réécriture soit effectuée </tr> </table> - <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 + <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 et SERVER_PORT dépendent respectivement + <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>Parmi les variables - spécifiques à mod_rewrite, ou trouve les suivantes :</p> + spécifiques à mod_rewrite, ou trouve les suivantes :</p> <div class="note"> <dl> <dt><code>API_VERSION</code></dt> @@ -325,12 +325,12 @@ la réécriture soit effectuée <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 + 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 + utilisé (par exemple, pour la version 1.3.14 d'Apache httpd, - il s'agit de la version 19990320:10), mais intéresse + il s'agit de la version 19990320:10), mais intéresse principalement les auteurs de modules.</dd> <dt><code>CONN_REMOTE_ADDR</code></dt> @@ -343,69 +343,69 @@ la réécriture soit effectuée <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> + (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> <dt><code>IS_SUBREQ</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>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> <dt><code>REMOTE_ADDR</code></dt> - <dd>L'adresse IP de l'hôte distant (se référer au + <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>Le chemin complet local au système de fichiers + <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 + à 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> + 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> - <dd>Contient le protocole de la requête (en général - "http" ou "https"). La valeur peut être modifiée par + <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> - <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 + <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>La ligne de requête HTTP complète envoyée par le + <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> + /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> </div> </li> </ul> - <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>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> + <p>Autres points à connaître ::</p> <ol> <li> <p>Les variables <code>SCRIPT_FILENAME</code> et @@ -413,241 +413,241 @@ la réécriture soit effectuée 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 + 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 + <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, + 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 + 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 + 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:<em>variable</em>}</code>, où <em>variable</em> peut - correspondre à une variable d'environnement quelconque.</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 + <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 + <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 + <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. + 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 + 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> + 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 + 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 + 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> + '<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, + <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 + 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 + <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 + <em>avant</em> cette dernière, vous pouvez vous contenter d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</p></li> <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> + <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>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 à + 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> - <p><em>expression_de_comparaison</em> est en général une + <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> : + disposez des syntaxes supplémentaires suivantes pour effectuer + d'autres tests utiles sur <em>chaîne_de_test</em> : </p> <ol> - <li>Vous pouvez préfixer l'expression avec un caractère - '<code>!</code>' (point d'exclamation) pour inverser le résultat + <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> + comparaison</em> utilisée.</li> <li>Vous pouvez effectuer des comparaisons lexicographiques de - chaînes : + chaînes : <ul> - <li>'<strong><expression</strong>' (inférieur au sens + <li>'<strong><expression</strong>' (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>.</li> + 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>.</li> - <li>'<strong>>expression</strong>' (supérieur au sens + <li>'<strong>>expression</strong>' (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>.</li> + 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>.</li> - <li>'<strong>=expression</strong>' (égal au sens + <li>'<strong>=expression</strong>' (é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 + 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.</li> + <em>chaîne_de_test</em> est comparée à la chaîne vide.</li> - <li>'<strong><=expression de comparaison</strong>' (inférieur ou égal à + <li>'<strong><=expression de comparaison</strong>' (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).</li> + 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).</li> <li>'<strong>>=expression de comparaison</strong>' - (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> + (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).</li> + égale à <em>expression_de_comparaison</em> (les deux chaînes + sont identiques, caractère pour caractère).</li> </ul></li> <li> Vous pouvez effectuer des comparaisons d'entiers : <ul> - <li>'<strong>-eq</strong>' (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 + <li>'<strong>-eq</strong>' (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.</li> - - <li>'<strong>-ge</strong>' (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>.</li> - - <li>'<strong>-gt</strong>' (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>.</li> - - <li>'<strong>-le</strong>' (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> + numériquement égales.</li> + + <li>'<strong>-ge</strong>' (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>.</li> + + <li>'<strong>-gt</strong>' (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>.</li> + + <li>'<strong>-le</strong>' (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>.</li> - <li>'<strong>-lt</strong>' (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> + <li>'<strong>-lt</strong>' (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>.</li> </ul> </li> - <li>Vous pouvez effectuer différents tests sur les attributs de + <li>Vous pouvez effectuer différents tests sur les attributs de fichier : <ul> - <li>'<strong>-d</strong>' (est un répertoire - + <li>'<strong>-d</strong>' (est un répertoire - <strong>d</strong>irectory)<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.</li> + 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.</li> <li>'<strong>-f</strong>' (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.</li> + <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.</li> <li>'<strong>-F</strong>' (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 !</li> + 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 !</li> <li>'<strong>-H</strong>' (est un lien symbolique, selon la convention bash)<br /> Voir <strong>-l</strong>.</li> <li>'<strong>-l</strong>' (est un lien 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 + 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>.</li> @@ -656,31 +656,31 @@ la réécriture soit effectuée convention bash)<br /> Voir <strong>-l</strong>.</li> - <li>'<strong>-s</strong>' (est un fichier régulier d'une + <li>'<strong>-s</strong>' (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.</li> + 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.</li> <li><p>'<strong>-U</strong>' (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> + 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 + 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></li> - - <li>'<strong>-x</strong>' (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 + concernant le code d'état que le gestionnaire configuré + (static file, CGI, proxy, etc...) aurait, quant à lui, + retourné.</p></li> + + <li>'<strong>-x</strong>' (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.</li> </ul> @@ -688,15 +688,15 @@ la réécriture soit effectuée </li> <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>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é. + 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}/*'"<br /> @@ -704,50 +704,50 @@ la réécriture soit effectuée </li> - <li>Vous pouvez aussi définir certains drapeaux pour + <li>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 : + 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 : <ul> <li>'<strong><code>nocase|NC</code></strong>' (<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 + 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> + 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 + vérification par sous-requêtes ou sur le système de fichiers.</li> <li> '<strong><code>ornext|OR</code></strong>' (<strong>ou</strong> condition suivante)<br /> - Permet de chaîner les conditions de règles avec un OU au + 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 ...règles concernant tous ces hôtes...</pre> +RewriteRule ...règles concernant tous ces hôtes...</pre> Sans ce drapeau, les paires - condition/règle devraient être écrites trois fois. + 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 /> - 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 /> + 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. + 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> </li> @@ -755,8 +755,8 @@ RewriteRule ...règles concernant tous ces hôtes...</pre> <p><strong>Exemple :</strong></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 + <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)" @@ -770,7 +770,7 @@ RewriteRule "^/$" "/homepage.std.html" [L]</pre> 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 + sera renvoyée. Dans le cas contraire, ce sera la page d'accueil standard.</p> @@ -778,84 +778,84 @@ RewriteRule "^/$" "/homepage.std.html" [L]</pre> <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>Active ou désactive l'exécution du -moteur de réécriture</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#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#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>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 + 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>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>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>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>Les directives <code class="directive">RewriteMap</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> + 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> </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>Définit une fonction de mise en correspondance pour la -recherche de mots-clés</td></tr> +<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>La directive <code class="directive">RewriteMap</code> définit une - <em>Table de correspondance pour la réécriture</em> que les + <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 + 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 + 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>mot-clé</em> <code>}</code><br /> + <em>mot-clé</em> <code>}</code><br /> <code>${</code> <em>MapName</em> <code>:</code> - <em>mot-clé</em> <code>|</code> <em>valeur par défaut</em> + <em>mot-clé</em> <code>|</code> <em>valeur par défaut</em> <code>}</code></strong> </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> - - <p>Par exemple, vous pouvez définir une directive + <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> + + <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> @@ -867,94 +867,94 @@ recherche de mots-clés</td></tr> <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${map-exemple:$1}"</pre> - <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> + <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> <p>Les combinaisons suivantes pour <em>type de correspondance</em> et <em>MapSource</em> - peuvent être utilisées :</p> + peuvent être utilisées :</p> <dl> <dt>txt</dt> - <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> + <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>Sélection aléatoire d'une entrée depuis un fichier texte (<a href="../rewrite/rewritemap.html#rnd">Détails ...</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>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> + <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>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> + (<a href="../rewrite/rewritemap.html#int">Détails ...</a>).</dd> <dt>prg</dt> <dd>Appelle un programme externe ou un script pour effectuer la - réécriture (<a href="../rewrite/rewritemap.html#prg">Détails + réécriture (<a href="../rewrite/rewritemap.html#prg">Détails ...</a>).</dd> <dt>dbd or fastdbd</dt> - <dd>Une commande SQL SELECT à exécuter pour rechercher la cible - de réécriture (<a href="../rewrite/rewritemap.html#dbd">Détails + <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>Vous trouverez plus de détails et de nombreux exemples dans le <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>Configure certaines options spéciales -pour le moteur de réécriture</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#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>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> + <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>Ceci force la configuration locale à hériter de la - configuration du niveau supérieur. Dans le contexte des hôtes + <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> + 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"> - 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 + 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>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 + <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> @@ -962,52 +962,52 @@ pour le moteur de réécriture</td></tr> <dt><code>InheritDown</code></dt> <dd> - <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 + <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 + 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>L'effet de cette option est équivalent à celui de l'option - <code>InheritDown</code> ci-dessus, mais les règles de la + <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 + 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>Si cette option est activée, les configurations courante et - enfants ignoreront toute règle héritée d'une configuration parente + <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 + Cette option est disponible à partir de la version 2.4.8 du serveur HTTP Apache.</p> </dd> <dt><code>AllowNoSlash</code></dt> <dd> - <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 + <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. + <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 + règles de réécriture qui correspondent à un répertoire sans slash final au sein de fichiers .htaccess.<br /> - Elle est disponible à + Elle est disponible à partir de la version 2.4.0 du serveur HTTP Apache.</p> </dd> @@ -1016,39 +1016,39 @@ pour le moteur de réécriture</td></tr> <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 + <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 /> + 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>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> + <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>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 + <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> @@ -1057,13 +1057,13 @@ pour le moteur de réécriture</td></tr> <dd> <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, + 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 + 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.</p> + utilisent ces informations de contexte étendu.</p> </dd> </dl> @@ -1072,390 +1072,390 @@ pour le moteur de réécriture</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="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>Définit les règles pour le moteur de réécriture</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>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> + <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>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>Modèle</em></a> est une + 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>Modèle</em></a> est une <a id="regexp" name="regexp">expression rationnelle</a> - compatible perl. Dans la première règle de réécriture, - l'expression est comparée au (%-decoded) + compatible perl. Dans la première règle de réécriture, + l'expression est comparée au (%-decoded) <a href="directive-dict.html#Syntax">chemin de l'URL</a> de la - requête, ou, dans un contexte de répertoire (voir - ci-dessous), au chemin de l'URL relativement à ce contexte de - répertoire. Les expressions suivantes sont comparées à la sortie de - la dernière règle de réécriture qui + requête, ou, dans un contexte de répertoire (voir + ci-dessous), au chemin de l'URL relativement à ce contexte de + répertoire. Les expressions suivantes sont comparées à la sortie de + la dernière règle de réécriture qui correspondait.</p> -<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est comparé ?</a></h3> +<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est comparé ?</a></h3> - <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 + <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").</p> - <p>Dans les contextes de répertoire <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et htaccess, le - <em>modèle</em> est tout d'abord comparé au chemin du <em>système - de fichiers</em>, après suppression du préfixe ou chemin de base - ayant conduit le serveur vers la règle <code class="directive">RewriteRule</code> (par + <p>Dans les contextes de répertoire <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et htaccess, le + <em>modèle</em> est tout d'abord comparé au chemin du <em>système + de fichiers</em>, après suppression du préfixe ou chemin de base + ayant conduit le serveur vers la règle <code class="directive">RewriteRule</code> (par exemple "app1/index.html" ou - "index.html" selon l'endroit où les directives sont définies).</p> + "index.html" selon l'endroit où les directives sont définies).</p> <p>Si vous souhaitez faire une comparaison sur le nom - d'hôte, le port, ou la chaîne de requête, utilisez une + 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> </div> -<div class="note"><h3>Réécritures dans un contexte de répertoire</h3> +<div class="note"><h3>Réécritures dans un contexte de répertoire</h3> <ul> -<li>L'utilisation du moteur de réécriture dans les +<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>Lorsqu'on utilise le moteur de réécriture dans un fichier -<code>.htaccess</code>, le chemin de base du répertoire courant (qui est -toujours le même pour ce même répertoire) est automatiquement -<em>supprimé</em> au cours de la comparaison avec le modèle de la règle -de réécriture, et automatiquement <em>ajouté</em> lorsqu'une -substitution relative (ne débutant pas par un slash ou un nom de -protocole) arrive à la fin d'un jeu de règles. Voir la directive +<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>Lorsqu'on utilise le moteur de réécriture dans un fichier +<code>.htaccess</code>, le chemin de base du répertoire courant (qui est +toujours le même pour ce même répertoire) est automatiquement +<em>supprimé</em> au cours de la comparaison avec le modèle de la règle +de réécriture, et automatiquement <em>ajouté</em> lorsqu'une +substitution relative (ne débutant pas par un slash ou un nom de +protocole) arrive à la fin d'un jeu de règles. 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 +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 +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">RewriteCond</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>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 +<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 +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>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 à + <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>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é à + <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> + comparaison avec le modèle inversé, ou dans la dernière règle + par défaut.</p> <div class="note"><h3>Note</h3> -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 +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>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> + <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>un chemin du système de fichiers</dt> + <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 + <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 + 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 + <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> + 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 + <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 + <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>En plus du texte, la chaîne <em>Substition</em> peut + <p>En plus du texte, la chaîne <em>Substition</em> peut comporter :</p> <ol> - <li>des références arrières (<code>$N</code>) vers le modèle + <li>des références arrières (<code>$N</code>) vers le modèle d'une directive RewriteRule</li> - <li>des références arrières (<code>%N</code>) vers le dernier - modèle d'une directive RewriteCond qui correspondait</li> + <li>des références arrières (<code>%N</code>) vers le dernier + modèle d'une directive RewriteCond qui correspondait</li> - <li>des variables du serveur comme dans les chaînes de test de - condition d'une règle (<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>des appels de <a href="#mapfunc">fonctions de comparaison</a> - (<code>${nom correspondance:clé|défaut}</code>)</li> + (<code>${nom correspondance:clé|défaut}</code>)</li> </ol> - <p>Les références arrières sont des identificateurs de la forme + <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 + 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>RewriteCond</code>. Les fonctions de comparaison sont issues de la directive <code>RewriteMap</code> dans la - section de laquelle elles sont décrites. Ces trois types de - variables sont évaluées dans l'ordre ci-dessus.</p> + 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 + <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é + 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 + 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>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 + <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 + nouvelles chaînes de requête avec les anciennes, utilisez le drapeau <code>[QSA]</code>.</p> </div> - <p>En outre, vous pouvez spécifier des <a name="rewriteflags" id="rewriteflags">actions</a> spéciales à effectuer en ajoutant + <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>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> + comme troisième argument de la directive + <code>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>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> + <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>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> + <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>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> + <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>Définit un cookie au niveau du navigateur client. La syntaxe - complète est : + <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> + <em><a href="../rewrite/flags.html#flag_co">détails ...</a></em> </td> </tr> <tr> <td>discardpath|DPI</td> - <td>Supprime la partie PATH_INFO de l'URI réécrit. <em><a href="../rewrite/flags.html#flag_dpi">détails + <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>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> + <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> <td>env|E=[!]<em>VAR</em>[:<em>VAL</em>]</td> - <td>Définit la variable d'environnement <em>VAR</em> (à la valeur + <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> + 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>Renvoie une réponse 403 FORBIDDEN au navigateur client. - <em><a href="../rewrite/flags.html#flag_f">détails ...</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>Renvoie un message d'erreur 410 GONE au navigateur client. <em><a href="../rewrite/flags.html#flag_g">détails ...</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>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> + <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>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> + <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>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 + <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>Rend la comparaison entre modèles insensible à la casse. - <em><a href="../rewrite/flags.html#flag_nc">détails ...</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>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> + <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>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> + <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 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 + que requête mandataire. <em><a href="../rewrite/flags.html#flag_p">détails ...</a></em></td> </tr> <tr> <td>passthrough|PT</td> - <td>L'URI résultant est repassé au moteur de mise en - correspondance des URLs pour y être traité par d'autres + <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> + <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>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> + <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>Supprime toute chaîne de paramètres de l'URI entrant. <em><a href="../rewrite/flags.html#flag_qsd">détails + <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>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> + optionnel. <em><a href="../rewrite/flags.html#flag_r">détails ...</a></em> </td> </tr> <tr> <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> + <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 class="odd"> <td>type|T=<em>MIME-type</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> + spécifié au fichier cible. <em><a href="../rewrite/flags.html#flag_t">détails ...</a></em></td> </tr> </table> -<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 +<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> 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> +<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 @@ -1463,25 +1463,25 @@ utilisé dans la directive <code class="directive"><a href="#rewriterule">Rewrite <p><strong>Dans la configuration au niveau du serveur principal (<code>httpd.conf</code>)<br /> - pour la requête ``<code>GET + pour la requête ``<code>GET /chemin/infochemin</code>'':</strong><br /> </p> <table class="bordered"><tr class="header"> -<th>Règle</th> -<th>Résultat de la substitution</th> +<th>Règle</th> +<th>Résultat de la substitution</th> </tr> <tr> <td>^/un_chemin(.*) autre_chemin$1</td> -<td>invalide, non supporté</td> +<td>invalide, non supporté</td> </tr> <tr class="odd"> <td>^/un_chemin(.*) autre_chemin$1 [R]</td> -<td>invalide, non supporté</td> +<td>invalide, non supporté</td> </tr> <tr> <td>^/un_chemin(.*) autre_chemin$1 [P]</td> -<td>invalide, non supporté</td> +<td>invalide, non supporté</td> </tr> <tr class="odd"> <td>^/un_chemin(.*) /autre_chemin$1</td> @@ -1493,7 +1493,7 @@ utilisé dans la directive <code class="directive"><a href="#rewriterule">Rewrite </tr> <tr class="odd"> <td>^/un_chemin(.*) /autre_chemin$1 [P]</td> -<td>sans objet, non supporté</td> +<td>sans objet, non supporté</td> </tr> <tr> <td>^/un_chemin(.*) http://cet_hote/autre_chemin$1</td> @@ -1505,7 +1505,7 @@ utilisé dans la directive <code class="directive"><a href="#rewriterule">Rewrite </tr> <tr> <td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P]</td> -<td>sans objet, non supporté</td> +<td>sans objet, non supporté</td> </tr> <tr class="odd"> <td>^/un_chemin(.*) http://autre_hote/autre_chemin$1</td> @@ -1522,17 +1522,17 @@ redondant)</td> </tr> </table> - <p><strong>Dans une configuration de niveau répertoire pour + <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 + pour la requête ``<code>GET /chemin/chemin-local/infochemin</code>'':</strong><br /> </p> <table class="bordered"><tr class="header"> -<th>Règle</th> -<th>Résultat de la substitution</th> +<th>Règle</th> +<th>Résultat de la substitution</th> </tr> <tr> <td>^chemin-local(.*) autre-chemin$1</td> @@ -1540,12 +1540,12 @@ redondant)</td> </tr> <tr class="odd"> <td>^chemin-local(.*) autre-chemin$1 [R]</td> -<td>http://cet-hôte/chemin/autre-chemin/infochemin via redirection +<td>http://cet-hôte/chemin/autre-chemin/infochemin via redirection externe</td> </tr> <tr> <td>^chemin-local(.*) autre-chemin$1 [P]</td> -<td>n'a pas lieu d'être, non supporté</td> +<td>n'a pas lieu d'être, non supporté</td> </tr> <tr class="odd"> <td>^chemin-local(.*) /autre-chemin$1</td> @@ -1553,36 +1553,36 @@ externe</td> </tr> <tr> <td>^chemin-local(.*) /autre-chemin$1 [R]</td> -<td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td> +<td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td> </tr> <tr class="odd"> <td>^chemin-local(.*) /autre-chemin$1 [P]</td> -<td>n'a pas lieu d'être, non supporté</td> +<td>n'a pas lieu d'être, non supporté</td> </tr> <tr> -<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1</td> +<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1</td> <td>/autre-chemin/infochemin</td> </tr> <tr class="odd"> -<td>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R]</td> -<td>http://cet-hôte/autre-chemin/infochemin via redirection externe</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>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P]</td> -<td>n'a pas lieu d'être, non supporté</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>^chemin-local(.*) http://autre hôte/autre-chemin$1</td> -<td>http://autre hôte/autre-chemin/infochemin via redirection externe</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>^chemin-local(.*) http://autre hôte/autre-chemin$1 [R]</td> -<td>http://autre hôte/autre-chemin/infochemin via redirection externe +<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>^chemin-local(.*) http://autre hôte/autre-chemin$1 [P]</td> -<td>http://autre hôte/autre-chemin/infochemin via un mandataire interne</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> @@ -1591,7 +1591,7 @@ externe</td> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_rewrite.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_rewrite.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -1610,7 +1610,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_rewrite.ht } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_sed.html b/docs/manual/mod/mod_sed.html index a0393f8298..70580c71f0 100644 --- a/docs/manual/mod/mod_sed.html +++ b/docs/manual/mod/mod_sed.html @@ -6,4 +6,4 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_sed.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_sed.html.fr b/docs/manual/mod/mod_sed.html.fr index d3b884e126..396e8aeaa6 100644 --- a/docs/manual/mod/mod_sed.html.fr +++ b/docs/manual/mod/mod_sed.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,51 +27,51 @@ <div id="preamble"><h1>Module Apache mod_sed</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_sed.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_sed.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_sed.html" title="Français"> fr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filtre les contenus en entrée (requêtes) et en sortie -(réponses) en utilisant la syntaxe de <code>sed</code></td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filtre les contenus en entrée (requêtes) et en sortie +(réponses) en utilisant la syntaxe de <code>sed</code></td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td /></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>sed_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>sed_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table> <h3>Sommaire</h3> <p><code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> est un filtre de contenu "in-process". Le -filtre <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> fournit les commandes d'édition de -<code>sed</code> implémentées par le programme <code>sed</code> de -Solaris 10 comme décrit dans la <a href="http://www.gnu.org/software/sed/manual/sed.txt">page de -manuel</a>. Cependant, à la différence de <code>sed</code>, -<code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> ne reçoit pas de données sur son entrée -standard. Au lieu de cela, le filtre agit sur les données échangées -entre le client et le serveur. <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> peut être -utilisé comme filtre en entrée ou en sortie. <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> +filtre <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> fournit les commandes d'édition de +<code>sed</code> implémentées par le programme <code>sed</code> de +Solaris 10 comme décrit dans la <a href="http://www.gnu.org/software/sed/manual/sed.txt">page de +manuel</a>. Cependant, à la différence de <code>sed</code>, +<code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> ne reçoit pas de données sur son entrée +standard. Au lieu de cela, le filtre agit sur les données échangées +entre le client et le serveur. <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> peut être +utilisé comme filtre en entrée ou en sortie. <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> est un filtre de contenu, ce qui signifie qu'on ne peut pas l'utiliser -pour modifier les en-têtes http du client ou du serveur. +pour modifier les en-têtes http du client ou du serveur. </p> <p> -Le filtre en sortie <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> accepte un tronçon de -données, exécute le script <code>sed</code> sur ces données, puis génère -une sortie qui est transmise au filtre suivant dans la chaîne. +Le filtre en sortie <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> accepte un tronçon de +données, exécute le script <code>sed</code> sur ces données, puis génère +une sortie qui est transmise au filtre suivant dans la chaîne. </p> <p> -Le filtre en entrée <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> reçoit des données en -provenance du filtre suivant dans la chaîne, exécute les scripts -<code>sed</code>, et renvoie les données générées au filtre appelant -dans la chaîne de filtrage. +Le filtre en entrée <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code> reçoit des données en +provenance du filtre suivant dans la chaîne, exécute les scripts +<code>sed</code>, et renvoie les données générées au filtre appelant +dans la chaîne de filtrage. </p> <p> -Les filtres en entrée ou en sortie ne traitent les données que si des -caractères newline sont détectés dans le contenu à filtrer. A la fin des -données, ce qui reste est traité comme la dernière ligne. +Les filtres en entrée ou en sortie ne traitent les données que si des +caractères newline sont détectés dans le contenu à filtrer. A la fin des +données, ce qui reste est traité comme la dernière ligne. </p> <p>Vous trouverez sur le <a href="https://blogs.oracle.com/basant/entry/using_mod_sed_to_filter">blog de l'auteur</a> un article en forme de tutoriel, ainsi que les raisons pour lesquelles ce filtre est plus puissant qu'une simple -recherche/remplacement de chaîne ou d'expression rationnelle.</p> +recherche/remplacement de chaîne ou d'expression rationnelle.</p> </div> <div id="quickview"><h3>Sujets</h3> @@ -87,8 +87,8 @@ recherche/remplacement de chaîne ou d'expression rationnelle.</p> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="sampleconf" id="sampleconf">Exemple de configuration</a></h2> - <div class="example"><h3>Ajout d'un filtre en sortie</h3><pre class="prettyprint lang-config"># Dans l'exemple suivant, le filtre sed va remplacer la chaîne - # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les + <div class="example"><h3>Ajout d'un filtre en sortie</h3><pre class="prettyprint lang-config"># Dans l'exemple suivant, le filtre sed va remplacer la chaîne + # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les # documents html avant de les envoyer au client. <Directory "/var/www/docs/sed"> AddOutputFilter Sed html @@ -97,9 +97,9 @@ recherche/remplacement de chaîne ou d'expression rationnelle.</p> </Directory></pre> </div> - <div class="example"><h3>Ajout d'un filtre en entrée</h3><pre class="prettyprint lang-config"> # Dans l'exemple suivant, le filtre sed va remplacer la chaîne - # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les - # données POST envoyées à PHP. + <div class="example"><h3>Ajout d'un filtre en entrée</h3><pre class="prettyprint lang-config"> # Dans l'exemple suivant, le filtre sed va remplacer la chaîne + # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les + # données POST envoyées à PHP. <Directory "/var/www/docs/sed"> AddInputFilter Sed php InputSed "s/monday/MON/g" @@ -110,13 +110,13 @@ recherche/remplacement de chaîne ou d'expression rationnelle.</p> <div class="section"> <h2><a name="sed_commands" id="sed_commands">Commandes sed</a></h2> <p> - Vous trouverez tous les détails à propos de la commande + Vous trouverez tous les détails à propos de la commande <code>sed</code> dans sa <a href="http://www.gnu.org/software/sed/manual/sed.txt">page de manuel</a>. </p> <dl> <dt><code>b</code></dt> - <dd>Saut vers le label spécifié (similaire à goto).</dd> + <dd>Saut vers le label spécifié (similaire à goto).</dd> <dt><code>h</code></dt> <dd>Copie la ligne courante dans le tampon.</dd> <dt><code>H</code></dt> @@ -124,7 +124,7 @@ recherche/remplacement de chaîne ou d'expression rationnelle.</p> <dt><code>g</code></dt> <dd>Copie le contenu du tampon dans la ligne courante.</dd> <dt><code>G</code></dt> - <dd>Ajoute le contenu du tampon à la ligne courante.</dd> + <dd>Ajoute le contenu du tampon à la ligne courante.</dd> <dt><code>x</code></dt> <dd>Echange les contenus du tampon et de la ligne courante.</dd> </dl> @@ -132,16 +132,16 @@ recherche/remplacement de chaîne ou d'expression rationnelle.</p> <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>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#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#Context">Contexte:</a></th><td>répertoire, .htaccess</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>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>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> @@ -149,22 +149,22 @@ requête (en général des données <code>POST</code>)</td></tr> <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>Commande sed pour le filtrage des contenus de type -réponse</td></tr> +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#Context">Contexte:</a></th><td>répertoire, .htaccess</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>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>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> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_sed.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_sed.html" title="Français"> fr </a></p> +<a href="../fr/mod/mod_sed.html" title="Français"> fr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -183,7 +183,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_sed.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_setenvif.html b/docs/manual/mod/mod_setenvif.html index 124eff9b17..a57bfd9a22 100644 --- a/docs/manual/mod/mod_setenvif.html +++ b/docs/manual/mod/mod_setenvif.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_setenvif.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_setenvif.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_setenvif.html.fr b/docs/manual/mod/mod_setenvif.html.fr index fa8213c796..c0edacd1e5 100644 --- a/docs/manual/mod/mod_setenvif.html.fr +++ b/docs/manual/mod/mod_setenvif.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,45 +27,45 @@ <div id="preamble"><h1>Module Apache mod_setenvif</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_setenvif.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_setenvif.html" title="Français"> fr </a> | <a href="../ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_setenvif.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet de définir des variables d'environnement en fonction -de caractéristiques de la requête</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet de définir des variables d'environnement en fonction +de caractéristiques de la requête</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>setenvif_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_setenvif.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>setenvif_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_setenvif.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> vous permet de définir + <p>Le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> vous permet de définir des variables d'environnement internes en fonction du fait que telle ou telle - caractéristique de la requête correspond ou non aux expressions - rationnelles que vous spécifiez. Ces variables d'environnement - peuvent être utilisées par d'autres parties du serveur pour prendre - des décisions quant aux actions à entreprendre, et pour déterminer - si les scripts CGI et les pages SSI doivent pouvoir y accéder.</p> - - <p>Les directives sont interprétées selon l'ordre dans lequel elles - apparaîssent dans les fichiers de configuration. Ainsi, des - séquences plus complexes peuvent être utilisées, comme dans cet - exemple qui définit netscape si le navigateur est Mozilla et non + caractéristique de la requête correspond ou non aux expressions + rationnelles que vous spécifiez. Ces variables d'environnement + peuvent être utilisées par d'autres parties du serveur pour prendre + des décisions quant aux actions à entreprendre, et pour déterminer + si les scripts CGI et les pages SSI doivent pouvoir y accéder.</p> + + <p>Les directives sont interprétées selon l'ordre dans lequel elles + apparaîssent dans les fichiers de configuration. Ainsi, des + séquences plus complexes peuvent être utilisées, comme dans cet + exemple qui définit netscape si le navigateur est Mozilla et non MSIE.</p> <pre class="prettyprint lang-config">BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape</pre> - <p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="../glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la - recherche d'un <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un - listing du contenu d'un répertoire via le module - <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des - variables d'environnement spécifiques à la requête. En outre, à cause + <p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="../glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la + recherche d'un <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un + listing du contenu d'un répertoire via le module + <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des + variables d'environnement spécifiques à la requête. En outre, à cause des phases de l'API auxquelles <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> prend - part, les directives <code class="directive"><a href="#setenvif">SetEnvIf</a></code> ne sont pas évaluées - séparément dans la sous-requête.</p> + part, les directives <code class="directive"><a href="#setenvif">SetEnvIf</a></code> ne sont pas évaluées + séparément dans la sous-requête.</p> </div> <div id="quickview"><h3 class="directives">Directives</h3> @@ -85,25 +85,25 @@ serveur HTTP Apache</a></li> <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>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#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#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>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 + 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>Quelques exemples supplémentaires :</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> @@ -113,20 +113,20 @@ 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>Définit des variables d'environnement en fonction du -contenu de l'en-tête HTTP User-Agent sans tenir compte de la +<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#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>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> + 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> @@ -135,7 +135,7 @@ BrowserMatchNoCase win platform=windows</pre> <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> + 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> @@ -144,80 +144,80 @@ 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>Définit des variables d'environnement en fonction des -attributs de la requête</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#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>La directive <code class="directive">SetEnvIf</code> permet de définir + <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 quatre formes suivantes :</p> + requête. L'<em>attribut</em> spécifié comme premier argument peut + se présenter sous l'une des quatre formes suivantes :</p> <ol> -<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>, +<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> + 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 : +<li>Une des caractéristiques de la requête suivantes : <ul> - <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_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> + 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 à + <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 + <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", + 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 + <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> + manière de mettre en correspondance votre chaîne d'arguments.</li> </ul> </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 +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 +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> +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>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> +correspond à l'<em>attribut</em>, les arguments suivants sont évalués.</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> +<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>nom-variable</em></code>, or</li> @@ -227,16 +227,16 @@ peuvent se présenter sous les formes suivantes :</p> <li><code><em>nom-variable</em>=<em>valeur</em></code></li> </ol> - <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 + <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> + 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 @@ -251,53 +251,53 @@ SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1 SetEnvIf ^TS ^[a-z] HAVE_TS</pre> - <p>Les trois premières lignes définissent la variable + <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>référant_intra_site</code> si la page référante se trouve + requête est un fichier image, et la quatrième définit la variable + <code>référant_intra_site</code> si la page référante se trouve quelque part dans le site web <code>www.mon-domaine.example.com</code>.</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 + <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">Les variables d'environnement et le -serveur HTTP Apache</a> pour des exemples supplémentaires. +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>Définit des variables d'environnement en fonction d'une expression ap_expr</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>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#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>La directive <code class="directive">SetEnvIfExpr</code> permet de - définir des variables d'environnement en fonction d'une expression + 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 + 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>Dans cet exemple, la variable d'environnement - <code>iso_delivered</code> est définie chaque fois que notre + <code>iso_delivered</code> est définie chaque fois que notre application tente de l'envoyer via <code>X-Sendfile</code>.</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>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> @@ -306,8 +306,8 @@ serveur HTTP Apache</a> pour des exemples supplémentaires. <h3>Voir aussi</h3> <ul> <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 +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> @@ -315,38 +315,38 @@ similaires.</li> <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>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#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#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>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 + 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> + effectuée sans tenir compte de la casse. Par exemple :</p> <pre class="prettyprint lang-config">SetEnvIfNoCase Host Example\.Org site=apache</pre> - <p>Cette ligne va définir la variable d'environnement + <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 + 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> + combinaison des mêmes caractères, sans tenir compte de la casse.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_setenvif.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_setenvif.html" title="Français"> fr </a> | <a href="../ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_setenvif.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -365,7 +365,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_setenvif.h } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_so.html b/docs/manual/mod/mod_so.html index 17eec825b8..52c3a8f8a8 100644 --- a/docs/manual/mod/mod_so.html +++ b/docs/manual/mod/mod_so.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_so.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_so.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_so.html.fr b/docs/manual/mod/mod_so.html.fr index b366bec32e..33be83cd64 100644 --- a/docs/manual/mod/mod_so.html.fr +++ b/docs/manual/mod/mod_so.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,44 +27,44 @@ <div id="preamble"><h1>Module Apache mod_so</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | <a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Chargement de modules ou de code exécutable au cours du -démarrage ou du redémarrage du serveur</td></tr> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>so_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_so.c</td></tr> -<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, c'est un module de base (toujours +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>so_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_so.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, c'est un module de base (toujours inclus)</td></tr></table> <h3>Sommaire</h3> - <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être - utilisé pour charger des modules dans le serveur HTTP Apache en cours d'exécution - grâce au mécanisme des <a href="../dso.html">Dynamic Shared Object ou Objets Partagés - Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une + <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être + utilisé pour charger des modules dans le serveur HTTP Apache en cours d'exécution + grâce au mécanisme des <a href="../dso.html">Dynamic Shared Object ou Objets Partagés + Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une recompilation.</p> - <p>Sous Unix, le code chargé provient en général de fichiers objet - partagés possèdant en général l'extension <code>.so</code>, alors - que sous Windows, l'extension peut être soit <code>.so</code>, soit + <p>Sous Unix, le code chargé provient en général de fichiers objet + partagés possèdant en général l'extension <code>.so</code>, alors + que sous Windows, l'extension peut être soit <code>.so</code>, soit <code>.dll</code>.</p> <div class="warning"><h3>Avertissement</h3> - <p>En général, les modules compilés pour une version majeure du + <p>En général, les modules compilés pour une version majeure du serveur HTTP Apache ne fonctionneront pas avec une autre (par - exemple de 1.3 à 2.0 ou 2.0 à 2.2). D'une version majeure à l'autre, - il y a souvent des modifications d'API qui nécessitent des + exemple de 1.3 à 2.0 ou 2.0 à 2.2). D'une version majeure à l'autre, + il y a souvent des modifications d'API qui nécessitent des modifications du module pour qu'il puisse fonctionner avec la nouvelle version.</p> </div> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#windows">Création de modules chargeables pour +<li><img alt="" src="../images/down.gif" /> <a href="#windows">Création de modules chargeables pour Windows</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> @@ -74,11 +74,11 @@ Windows</a></li> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="windows" id="windows">Création de modules chargeables pour +<h2><a name="windows" id="windows">Création de modules chargeables pour Windows</a></h2> <div class="note"><h3>Note</h3> - <p>Sous Windows, où les modules chargeables possèdent en général + <p>Sous Windows, où les modules chargeables possèdent en général l'extension de nom de fichier <code>.dll</code>, les modules Apache httpd se nomment <code>mod_nom-module.so</code>, tout comme sur les autres plates-formes. Vous trouverez cependant encore des modules @@ -86,40 +86,40 @@ Windows</a></h2> convention de nommage avec extension <code>.dll</code>.</p> <p>Bien que <code>mod_so</code> puisse encore charger des modules - possèdant un nom du style <code>ApacheModuleFoo.dll</code>, - il est préférable d'utiliser la + possèdant un nom du style <code>ApacheModuleFoo.dll</code>, + il est préférable d'utiliser la nouvelle convention de nommage ; si vous modifiez votre module chargeable pour la version 2.0, veuillez aussi modifier son nom pour respecter cette nouvelle convention.</p></div> <p>Les API des modules Apache httpd sous Unix et Windows sont identiques. Alors que certains modules s'appuient sur certains - aspects de l'architecture Unix non présents dans Windows, et ne - fonctionneront donc pas sur cette dernière plate-forme, de nombreux + aspects de l'architecture Unix non présents dans Windows, et ne + fonctionneront donc pas sur cette dernière plate-forme, de nombreux modules fonctionnent sous Windows avec peu ou pas de modification - par rapport à leur version Unix.</p> + par rapport à leur version Unix.</p> - <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de - deux manières. Sous Unix, il peut être compilé dans le serveur. + <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de + deux manières. Sous Unix, il peut être compilé dans le serveur. Comme Apache httpd pour Windows ne dispose pas du programme - <code>Configure</code> propre à Apache httpd pour Unix, le fichier source - du module doit être ajouté au fichier projet Apache de base, et ses - symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p> + <code>Configure</code> propre à Apache httpd pour Unix, le fichier source + du module doit être ajouté au fichier projet Apache de base, et ses + symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p> - <p>La seconde méthode consiste à compiler le module en tant que DLL, - à savoir une bibliothèque partagée qui pourra être chargée dans le - serveur en cours d'exécution via la directive + <p>La seconde méthode consiste à compiler le module en tant que DLL, + à savoir une bibliothèque partagée qui pourra être chargée dans le + serveur en cours d'exécution via la directive <code class="directive">LoadModule</code>. Ces modules DLL - peuvent être distribués et exécutés sur toute installation d'Apache - httpd pour Windows, sans avoir à recompiler le serveur.</p> + peuvent être distribués et exécutés sur toute installation d'Apache + httpd pour Windows, sans avoir à recompiler le serveur.</p> - <p>Pour créer un module DLL, il est nécessaire d'apporter une légère - modification à son fichier source : l'enregistrement du module doit - être exporté depuis la DLL (qui sera elle-même créée plus tard ; + <p>Pour créer un module DLL, il est nécessaire d'apporter une légère + modification à son fichier source : l'enregistrement du module doit + être exporté depuis la DLL (qui sera elle-même créée plus tard ; voir plus loin). Pour ce faire, ajoutez la macro - <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers - d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre - module. Par exemple, si votre module est déclaré comme suit :</p> + <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers + d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre + module. Par exemple, si votre module est déclaré comme suit :</p> <div class="example"><p><code> module foo_module; @@ -131,35 +131,35 @@ Windows</a></h2> </code></p></div> <p>Notez que cette macro ne sera prise en compte que sous Windows, - si bien que le module poura être utilisé sans changement sous Unix, - si besoin est. Alternativement, si vous êtes familier avec les + si bien que le module poura être utilisé sans changement sous Unix, + si besoin est. Alternativement, si vous êtes familier avec les fichiers <code>.DEF</code>, vous pouvez les utiliser pour exporter l'enregistrement du module.</p> - <p>Maintenant, nous sommes prêts à créer une DLL contenant notre - module. Il va falloir pour cela la lier avec la bibliothèque - d'export libhttpd.lib qui a été créée au cours de la compilation de - la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi - nécessaire de modifier la configuration du compilateur pour - s'assurer que les fichiers d'en-têtes d'Apache httpd seront correctement - localisés. Vous trouverez cette bibliothèque à la racine du - répertoire des modules de votre serveur. Il est souhaitable + <p>Maintenant, nous sommes prêts à créer une DLL contenant notre + module. Il va falloir pour cela la lier avec la bibliothèque + d'export libhttpd.lib qui a été créée au cours de la compilation de + la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi + nécessaire de modifier la configuration du compilateur pour + s'assurer que les fichiers d'en-têtes d'Apache httpd seront correctement + localisés. Vous trouverez cette bibliothèque à la racine du + répertoire des modules de votre serveur. Il est souhaitable d'utiliser un fichier de module .dsp existant dans l'arborescence afin de s'assurer que l'environnement de compilation est - correctement configuré, mais vous pouvez aussi comparer les options - de compilation et d'édition de liens à votre fichier .dsp.</p> + correctement configuré, mais vous pouvez aussi comparer les options + de compilation et d'édition de liens à votre fichier .dsp.</p> - <p>Ceci devrait créer une version DLL de votre module. Il vous - suffit maintenant de l'enregistrer dans le répertoire - <code>modules</code> à la racine de votre serveur, et d'utiliser la + <p>Ceci devrait créer une version DLL de votre module. Il vous + suffit maintenant de l'enregistrer dans le répertoire + <code>modules</code> à la racine de votre serveur, et d'utiliser la directive <code class="directive">LoadModule</code> pour la charger.</p> </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>Liaison du fichier objet ou de la bibliothèque -spécifié</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> @@ -167,12 +167,12 @@ spécifié</td></tr> </table> <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 + 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. + 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> + relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</p> <p>Par exemple:</p> @@ -185,7 +185,7 @@ spécifié</td></tr> <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>Liaison avec le serveur du fichier objet ou de la -bibliothèque spécifié, et ajout de ce dernier à la liste des modules +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> @@ -193,10 +193,10 @@ actifs</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_so</td></tr> </table> <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 + 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 + <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>Par exemple :</p> @@ -204,17 +204,17 @@ actifs</td></tr> <pre class="prettyprint lang-config">LoadModule "status_module modules/mod_status.so"</pre> - <p>charge le module spécifié depuis le sous-répertoire des modules - situé à la racine du serveur.</p> + <p>charge le module spécifié depuis le sous-répertoire des modules + situé à la racine du serveur.</p> </div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | <a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -233,7 +233,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_so.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_status.html b/docs/manual/mod/mod_status.html index 22c6f0e3e9..9cb84a09e4 100644 --- a/docs/manual/mod/mod_status.html +++ b/docs/manual/mod/mod_status.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_status.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_status.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_status.html.fr b/docs/manual/mod/mod_status.html.fr index 54f81c8a83..5f794aed43 100644 --- a/docs/manual/mod/mod_status.html.fr +++ b/docs/manual/mod/mod_status.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,76 +27,76 @@ <div id="preamble"><h1>Module Apache mod_status</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | <a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> -<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des informations sur les performances et l'activité +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des informations sur les performances et l'activité du serveur</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>status_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_status.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>status_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_status.c</td></tr></table> <h3>Sommaire</h3> - <p>Le module Status permet à un administrateur de déterminer le - niveau de performances de son serveur. Les statistiques instantanées - du serveur sont présentées dans une page HTML sous une forme - aisément lisible. Si nécessaire, cette page peut être configurée - pour être automatiquement actualisée (sous réserve de - compatibilité du navigateur). Une autre page fournit l'état - instantané du serveur sous la forme d'une simple liste lisible par + <p>Le module Status permet à un administrateur de déterminer le + niveau de performances de son serveur. Les statistiques instantanées + du serveur sont présentées dans une page HTML sous une forme + aisément lisible. Si nécessaire, cette page peut être configurée + pour être automatiquement actualisée (sous réserve de + compatibilité du navigateur). Une autre page fournit l'état + instantané du serveur sous la forme d'une simple liste lisible par une machine.</p> - <p>Les détails fournis sont :</p> + <p>Les détails fournis sont :</p> <ul> - <li>Le nombre de processus servant les requêtes</li> + <li>Le nombre de processus servant les requêtes</li> <li>Le nombre de processus inactifs</li> - <li>L'état de chaque processus, le nombre de requêtes qu'il a - traitées et le nombre total d'octets qu'il a servis (*)</li> + <li>L'état de chaque processus, le nombre de requêtes qu'il a + traitées et le nombre total d'octets qu'il a servis (*)</li> - <li>Le nombre total d'accès effectués et d'octets servis (*)</li> + <li>Le nombre total d'accès effectués et d'octets servis (*)</li> - <li>Le moment où le serveur a été démarré/redémarré et le temps - écoulé depuis</li> + <li>Le moment où le serveur a été démarré/redémarré et le temps + écoulé depuis</li> - <li>Les valeurs moyennes du nombre de requêtes par seconde, du + <li>Les valeurs moyennes du nombre de requêtes par seconde, du nombre d'octets servis par seconde et du nombre d'octets par - requête (*)</li> + requête (*)</li> - <li>Le pourcentage CPU instantané utilisé par chaque processus et + <li>Le pourcentage CPU instantané utilisé par chaque processus et par l'ensemble des processus (*)</li> - <li>Les hôtes et requêtes actuellement en cours de traitement + <li>Les hôtes et requêtes actuellement en cours de traitement (*)</li> </ul> <p>Les lignes se terminant par "(*)" ne sont disponibles que si la directive <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> - est définie à <code>On</code>. Depuis la version - 2.3.6, le chargement de mod_status définit automatiquement - <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> à On.</p> + est définie à <code>On</code>. Depuis la version + 2.3.6, le chargement de mod_status définit automatiquement + <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> à On.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation du rapport d'état</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation du rapport d'état</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#autoupdate">Actualisation automatique</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#machinereadable">Fichier d'état lisible par une machine</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Utilisation de server-status pour la recherche de défauts de +<li><img alt="" src="../images/down.gif" /> <a href="#machinereadable">Fichier d'état lisible par une machine</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Utilisation de server-status pour la recherche de défauts de fonctionnement</a></li> </ul><h3 class="directives">Directives</h3> <p>Ce module ne fournit aucune directive.</p> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="enable" id="enable">Activation du rapport d'état</a></h2> +<h2><a name="enable" id="enable">Activation du rapport d'état</a></h2> - <p>Pour n'activer les rapports d'état que pour les navigateurs - appartenant au domaine example.com, ajoutez ces lignes à votre + <p>Pour n'activer les rapports d'état que pour les navigateurs + appartenant au domaine example.com, ajoutez ces lignes à votre fichier de configuration <code>httpd.conf</code> :</p> <pre class="prettyprint lang-config"><Location "/etat-serveur"> SetHandler server-status @@ -105,71 +105,71 @@ du serveur</td></tr> <p>Il est alors possible d'obtenir les statistiques du serveur en - utilisant un navigateur web et en accédant à la page + utilisant un navigateur web et en accédant à la page <code>http://votre.serveur/etat-serveur</code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="autoupdate" id="autoupdate">Actualisation automatique</a></h2> - <p>Vous pouvez faire en sorte que cette page d'état s'actualise - elle-même automatiquement si votre navigateur supporte "refresh". - Pour ce faire, accédez à la page + <p>Vous pouvez faire en sorte que cette page d'état s'actualise + elle-même automatiquement si votre navigateur supporte "refresh". + Pour ce faire, accédez à la page <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que - cette dernière soit actualisée toutes les N secondes.</p> + cette dernière soit actualisée toutes les N secondes.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="machinereadable" id="machinereadable">Fichier d'état lisible par une machine</a></h2> +<h2><a name="machinereadable" id="machinereadable">Fichier d'état lisible par une machine</a></h2> <p>La page <code>http://votre.serveur/etat-serveur?auto</code> - permet d'obtenir une version du fichier d'état lisible par une - machine. Ceci s'avère intéressant dans le cadre d'une exécution + permet d'obtenir une version du fichier d'état lisible par une + machine. Ceci s'avère intéressant dans le cadre d'une exécution automatique : voir le programme en Perl - <code>log_server_status</code> situé dans le répertoire + <code>log_server_status</code> situé dans le répertoire <code>/support</code> de votre distribution du serveur HTTP Apache.</p> <div class="note"> - <strong>Veuillez noter que si <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a été - chargé dans le serveur, son gestionnaire sera disponible dans + <strong>Veuillez noter que si <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a été + chargé dans le serveur, son gestionnaire sera disponible dans <em>tous</em> les fichiers de configuration, y compris les - fichiers de configuration de <em>niveau répertoire</em> (par + fichiers de configuration de <em>niveau répertoire</em> (par exemple <code>.htaccess</code>), ce qui peut avoir des - répercutions quant à la sécurité de votre site.</strong> + répercutions quant à la sécurité de votre site.</strong> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="troubleshoot" id="troubleshoot">Utilisation de server-status pour la recherche de défauts de +<h2><a name="troubleshoot" id="troubleshoot">Utilisation de server-status pour la recherche de défauts de fonctionnement</a></h2> - <p>La page <code>server-status</code> peut servir de point de départ - à la recherche de défauts de fonctionnement lorsque votre serveur - mobilise toutes les ressources disponibles (CPU ou mémoire), pour - identifier quels clients ou requêtes sont la cause du problème.</p> + <p>La page <code>server-status</code> peut servir de point de départ + à la recherche de défauts de fonctionnement lorsque votre serveur + mobilise toutes les ressources disponibles (CPU ou mémoire), pour + identifier quels clients ou requêtes sont la cause du problème.</p> - <p>Tout d'abord, assurez-vous que la directive <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> est bien définie à on, de - façon à ce que vous puissiez avoir accès à toutes les informations à - propos de la requête et du client pour chaque processus enfant ou + <p>Tout d'abord, assurez-vous que la directive <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> est bien définie à on, de + façon à ce que vous puissiez avoir accès à toutes les informations à + propos de la requête et du client pour chaque processus enfant ou thread.</p> - <p>Consultez ensuite la liste des processus en cours (à l'aide de + <p>Consultez ensuite la liste des processus en cours (à l'aide de <code>top</code>, ou d'un utilitaire de listage des processus similaire), afin d'identifier les processus coupables. Triez - l'affichage de <code>top</code> par utilisation CPU ou mémoire, en - fonction du problème rencontré.</p> + l'affichage de <code>top</code> par utilisation CPU ou mémoire, en + fonction du problème rencontré.</p> <p>Rechargez la page <code>server-status</code> et recherchez - les identifiants des processus trouvés précédemment ; vous pourrez - alors déterminer quelle requête est traitée par ces processus, pour - quel client. Les requêtes peuvent apparaître de manière fugitive, et + les identifiants des processus trouvés précédemment ; vous pourrez + alors déterminer quelle requête est traitée par ces processus, pour + quel client. Les requêtes peuvent apparaître de manière fugitive, et il se peut que vous deviez effectuer plusieurs essais avant de - parvenir à les prendre en flagrant délit, pour ainsi dire.</p> + parvenir à les prendre en flagrant délit, pour ainsi dire.</p> - <p>Cette procédure <em>devrait</em> vous permettre de cerner quel - client, ou type de requête, sont à l'origine de vos problèmes de + <p>Cette procédure <em>devrait</em> vous permettre de cerner quel + client, ou type de requête, sont à l'origine de vos problèmes de charge. Il est probable que vous identifiiez une application web au comportement anormal, ou un client en train d'attaquer votre site.</p> @@ -177,10 +177,10 @@ du serveur</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | <a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | -<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> <script type="text/javascript"><!--//--><![CDATA[//><!-- var comments_shortname = 'httpd'; @@ -199,7 +199,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_status.htm } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); diff --git a/docs/manual/mod/mod_unique_id.html b/docs/manual/mod/mod_unique_id.html index 11d0f0066a..257b0469f8 100644 --- a/docs/manual/mod/mod_unique_id.html +++ b/docs/manual/mod/mod_unique_id.html @@ -6,7 +6,7 @@ Content-type: text/html; charset=ISO-8859-1 URI: mod_unique_id.html.fr Content-Language: fr -Content-type: text/html; charset=ISO-8859-1 +Content-type: text/html; charset=UTF-8 URI: mod_unique_id.html.ja.utf8 Content-Language: ja diff --git a/docs/manual/mod/mod_unique_id.html.fr b/docs/manual/mod/mod_unique_id.html.fr index 42922c3686..09755f1469 100644 --- a/docs/manual/mod/mod_unique_id.html.fr +++ b/docs/manual/mod/mod_unique_id.html.fr @@ -1,7 +1,7 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> -<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT @@ -27,212 +27,212 @@ <div id="preamble"><h1>Module Apache mod_unique_id</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_unique_id.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit une variable d'environnement contenant un -identifiant unique pour chaque requête</td></tr> +identifiant unique pour chaque requête</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> -<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>unique_id_module</td></tr> -<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_unique_id.c</td></tr></table> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>unique_id_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_unique_id.c</td></tr></table> <h3>Sommaire</h3> - <p>Ce module fournit un identifiant dont l'unicité est garantie - parmi "toutes" les requêtes sous des conditions très précises. + <p>Ce module fournit un identifiant dont l'unicité est garantie + parmi "toutes" les requêtes sous des conditions très précises. L'identifiant unique le sera aussi parmi plusieurs machines - appartenant à un cluster correctement configuré. L'identifiant est - affecté à la variable d'environnement <code>UNIQUE_ID</code> pour - chaque requête. Les identifiants uniques sont utiles pour diverses - raisons dont la nature se situe au delà de la portée de ce + appartenant à un cluster correctement configuré. L'identifiant est + affecté à la variable d'environnement <code>UNIQUE_ID</code> pour + chaque requête. Les identifiants uniques sont utiles pour diverses + raisons dont la nature se situe au delà de la portée de ce document.</p> </div> <div id="quickview"><h3>Sujets</h3> <ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#theory">Théorie</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#theory">Théorie</a></li> </ul><h3 class="directives">Directives</h3> <p>Ce module ne fournit aucune directive.</p> <ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="theory" id="theory">Théorie</a></h2> +<h2><a name="theory" id="theory">Théorie</a></h2> - <p>Tout d'abord un bref rappel de la manière dont le serveur Apache - fonctionne sous Unix (cette fonctionnalité n'étant actuellement pas - supportée sous Windows NT). Sous Unix, Apache crée plusieurs - processus enfants, ces derniers traitant les requêtes une par une. - Chaque processus enfant peut traiter plusieurs requêtes pendant sa - durée de vie. Dans le cadre de cette discussion, nous supposerons - que les différents processus enfants ne s'échangent pas de données - entre eux. Nous nous référerons aux processus enfants sous le nom de + <p>Tout d'abord un bref rappel de la manière dont le serveur Apache + fonctionne sous Unix (cette fonctionnalité n'étant actuellement pas + supportée sous Windows NT). Sous Unix, Apache crée plusieurs + processus enfants, ces derniers traitant les requêtes une par une. + Chaque processus enfant peut traiter plusieurs requêtes pendant sa + durée de vie. Dans le cadre de cette discussion, nous supposerons + que les différents processus enfants ne s'échangent pas de données + entre eux. Nous nous référerons aux processus enfants sous le nom de <dfn>processus httpd</dfn>.</p> - <p>Votre site web est réparti entre une ou plusieurs machines dont - vous êtes l'administrateur, et que nous nommerons cluster de - serveurs. Chaque serveur peut exécuter plusieurs instances d'Apache. - L'ensemble de ces dernières sera considéré comme "l'Univers", et - sous certaines hypothèses, nous montrerons qu'il est possible dans - cet univers, de générer des identifiants uniques pour chaque - requête, sans pour autant nécessiter une communication importante - entre les différents serveurs du cluster.</p> + <p>Votre site web est réparti entre une ou plusieurs machines dont + vous êtes l'administrateur, et que nous nommerons cluster de + serveurs. Chaque serveur peut exécuter plusieurs instances d'Apache. + L'ensemble de ces dernières sera considéré comme "l'Univers", et + sous certaines hypothèses, nous montrerons qu'il est possible dans + cet univers, de générer des identifiants uniques pour chaque + requête, sans pour autant nécessiter une communication importante + entre les différents serveurs du cluster.</p> <p>Les machines de votre cluster doivent satisfaire ces conditions - (même si le cluster ne comporte qu'une machine, vous devez + (même si le cluster ne comporte qu'une machine, vous devez synchroniser son horloge avec NTP) :</p> <ul> - <li>Les temps des machines sont synchronisés via NTP ou tout autre - protocole de synchronisation du temps en réseau.</li> + <li>Les temps des machines sont synchronisés via NTP ou tout autre + protocole de synchronisation du temps en réseau.</li> - <li>Les nom d'hôtes des machines sont tous différents, de façon à - ce que le module puisse recevoir une adresse IP différente pour + <li>Les nom d'hôtes des machines sont tous différents, de façon à + ce que le module puisse recevoir une adresse IP différente pour chaque machine du cluster en effectuant une recherche sur le nom - d'hôte.</li> + d'hôte.</li> </ul> - <p>Au vu des caractéristiques actuelles du système d'exploitation, - nous supposerons que les pids (identifiants processus) sont codés - sur 32 bits. Si le système d'exploitation utilise plus de 32 bits - pour un pid, la correction est triviale mais doit être effectuée + <p>Au vu des caractéristiques actuelles du système d'exploitation, + nous supposerons que les pids (identifiants processus) sont codés + sur 32 bits. Si le système d'exploitation utilise plus de 32 bits + pour un pid, la correction est triviale mais doit être effectuée dans le code.</p> - <p>Ces hypothèses posées, à un instant donné, nous pouvons + <p>Ces hypothèses posées, à un instant donné, nous pouvons distinguer tout processus httpd sur toute machine du cluster de tous les autres processus httpd. Pour ce faire, il suffit d'utiliser l'adresse IP de la machine et le pid du processus httpd. Un - processus httpd peut traiter plusieurs requêtes simultanément si - vous utilisez un module MPM multi-threadé. Pour identifier les + processus httpd peut traiter plusieurs requêtes simultanément si + vous utilisez un module MPM multi-threadé. Pour identifier les threads, Apache httpd utilise en interne un index de threads. Ainsi, - afin de générer des identifiants uniques pour chaque requête, il + afin de générer des identifiants uniques pour chaque requête, il suffit d'effectuer une distinction en fonction du temps.</p> - <p>Pour déterminer le temps, nous utiliserons un repère de temps - Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un - compteur 16 bits. La précision du repère de temps n'étant que d'une - seconde, le compteur va représenter 65536 valeurs par seconde. Le - quadruplet <em>(adresse IP, pid, repère de temps, compteur)</em> est - en mesure de distinguer 65536 requêtes par seconde par processus - httpd. Il peut cependant arriver que le même pid soit réutilisé au - cours du temps, et le compteur est là pour pallier cet - inconvénient.</p> + <p>Pour déterminer le temps, nous utiliserons un repère de temps + Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un + compteur 16 bits. La précision du repère de temps n'étant que d'une + seconde, le compteur va représenter 65536 valeurs par seconde. Le + quadruplet <em>(adresse IP, pid, repère de temps, compteur)</em> est + en mesure de distinguer 65536 requêtes par seconde par processus + httpd. Il peut cependant arriver que le même pid soit réutilisé au + cours du temps, et le compteur est là pour pallier cet + inconvénient.</p> - <p>Lorsqu'un processus enfant httpd est créé, le compteur est - initialisé avec (nombre de microsecondes actuel divisé par 10) - modulo 65536 (cette formule a été choisie pour éliminer certains - problème de variance avec les bits de poids faibles du compteur de - microsecondes sur certains systèmes). Lorsqu'un identifiant unique - est généré, le repère de temps utilisé est le moment où la requête - arrive sur le serveur web. Le compteur est incrémenté à chaque - création d'identifiant (et peut repasser à 0 lorsqu'il a atteint sa + <p>Lorsqu'un processus enfant httpd est créé, le compteur est + initialisé avec (nombre de microsecondes actuel divisé par 10) + modulo 65536 (cette formule a été choisie pour éliminer certains + problème de variance avec les bits de poids faibles du compteur de + microsecondes sur certains systèmes). Lorsqu'un identifiant unique + est généré, le repère de temps utilisé est le moment où la requête + arrive sur le serveur web. Le compteur est incrémenté à chaque + création d'identifiant (et peut repasser à 0 lorsqu'il a atteint sa valeur maximale).</p> - <p>Le noyau génère un pid pour chaque processus lors de sa création, - et le compteur de pid est réinitialisé à une certaine valeur - lorsqu'il a atteint sa valeur maximale (les pid sont codés sur 16 - bits sous de nombreux Unixes, mais les systèmes les plus récents les - ont étendus à 32 bits). La même valeur de pid pourra donc être - réutilisée au cours du temps. Cependant, tant qu'elle n'est pas - réutilisée dans la même seconde, elle ne remet pas en cause - l'unicité de notre quadruplet. Nous supposerons donc que le système - ne créera pas plus de 65536 processus en une seconde (ce nombre peut - être de 32768 sous certains Unixes, mais même dans ce cas, on est en - général loin de cette situation).</p> + <p>Le noyau génère un pid pour chaque processus lors de sa création, + et le compteur de pid est réinitialisé à une certaine valeur + lorsqu'il a atteint sa valeur maximale (les pid sont codés sur 16 + bits sous de nombreux Unixes, mais les systèmes les plus récents les + ont étendus à 32 bits). La même valeur de pid pourra donc être + réutilisée au cours du temps. Cependant, tant qu'elle n'est pas + réutilisée dans la même seconde, elle ne remet pas en cause + l'unicité de notre quadruplet. Nous supposerons donc que le système + ne créera pas plus de 65536 processus en une seconde (ce nombre peut + être de 32768 sous certains Unixes, mais même dans ce cas, on est en + général loin de cette situation).</p> - <p>Il est possible que le temps se répète pour une raison + <p>Il est possible que le temps se répète pour une raison quelconque. - Supposons par exemple que l'horloge système soit retardée et repasse - par un temps passé (ou bien, comme elle avançait, elle a été remise - à l'heure, et elle repasse par un temps futur). Dans ce cas, il peut - être facilement démontré que le couple pid/repère de temps peut être - réutilisé. Le choix de la formule d'initialisation du compteur a - été effectué dans l'intention de pallier ce problème. Notez qu'un - nombre vraiment aléatoire serait souhaitable pour initialiser le + Supposons par exemple que l'horloge système soit retardée et repasse + par un temps passé (ou bien, comme elle avançait, elle a été remise + à l'heure, et elle repasse par un temps futur). Dans ce cas, il peut + être facilement démontré que le couple pid/repère de temps peut être + réutilisé. Le choix de la formule d'initialisation du compteur a + été effectué dans l'intention de pallier ce problème. Notez qu'un + nombre vraiment aléatoire serait souhaitable pour initialiser le compteur, mais il n'existe pas de tel nombre directement lisible sur - la plupart des systèmes (c'est à dire que vous ne pouvez pas - utiliser rand() car vous devez déclencher le générateur avec une - valeur unique, et vous ne pouvez pas utiliser le temps à cet effet - car celui-ci , au moins à la seconde près, s'est répété). Il ne - s'agit donc pas d'une défense parfaite.</p> + la plupart des systèmes (c'est à dire que vous ne pouvez pas + utiliser rand() car vous devez déclencher le générateur avec une + valeur unique, et vous ne pouvez pas utiliser le temps à cet effet + car celui-ci , au moins à la seconde près, s'est répété). Il ne + s'agit donc pas d'une défense parfaite.</p> - <p>Même si elle n'est pas parfaite, quel est le degré d'efficacité - de cette défense ? Supposons - qu'une de vos machines serve au plus 500 requêtes par seconde (ce - qui constitue une limite supérieure très raisonnable au moment où ce - document est écrit, car les systèmes ne se contentent en général pas - de débiter des fichiers statiques). Pour y parvenir, un certain nombre - de processus enfants sera nécessaire, qui dépendra du nombre de - clients simultanés présents. Mais soyons pessimiste et supposons - qu'un seul processus enfant soit capable de servir 500 requêtes par + <p>Même si elle n'est pas parfaite, quel est le degré d'efficacité + de cette défense ? Supposons + qu'une de vos machines serve au plus 500 requêtes par seconde (ce + qui constitue une limite supérieure très raisonnable au moment où ce + document est écrit, car les systèmes ne se contentent en général pas + de débiter des fichiers statiques). Pour y parvenir, un certain nombre + de processus enfants sera nécessaire, qui dépendra du nombre de + clients simultanés présents. Mais soyons pessimiste et supposons + qu'un seul processus enfant soit capable de servir 500 requêtes par secondes. - Il existe 1000 valeurs de démarrage possibles du compteur pour - lesquelles deux séquences de 500 requêtes puissent se recouvrir. Il - y a donc 1,5% de chance que le processus enfant répète une valeur de - compteur si le temps se répète (avec une résolution d'une seconde), - et l'unicité sera alors remise en cause. C'est cependant un exemple - très pessimiste, et avec les valeurs du monde réel, il y a bien + Il existe 1000 valeurs de démarrage possibles du compteur pour + lesquelles deux séquences de 500 requêtes puissent se recouvrir. Il + y a donc 1,5% de chance que le processus enfant répète une valeur de + compteur si le temps se répète (avec une résolution d'une seconde), + et l'unicité sera alors remise en cause. C'est cependant un exemple + très pessimiste, et avec les valeurs du monde réel, il y a bien moins de chances que cela ne se produise. Si vous estimez que ceci a - tout de même quelque chances de se produire sur votre système, vous - pouvez migrer vers un compteur à 32 bits (en modifiant le code).</p> + tout de même quelque chances de se produire sur votre système, vous + pouvez migrer vers un compteur à 32 bits (en modifiant le code).</p> <p>On pourrait supposer que ceci a plus de chance de se produire - lors du passage à l'heure d'hiver où l'horloge est "retardée". Cela - ne constitue cependant pas un problème car les temps pris en compte + lors du passage à l'heure d'hiver où l'horloge est "retardée". Cela + ne constitue cependant pas un problème car les temps pris en compte ici sont des temps UTC, qui vont "toujours" de l'avant. Notez que - les Unixes à base de processeur x86 peuvent nécessiter une - configuration particulière pour que ceci soit vrai -- il doivent - être configurés pour assumer que l'horloge système est en UTC et - compenser de manière appropriée. Mais même dans ce cas, si vous - utilisez NTP, votre temps UTC sera correct peu après le - redémarrage.</p> + les Unixes à base de processeur x86 peuvent nécessiter une + configuration particulière pour que ceci soit vrai -- il doivent + être configurés pour assumer que l'horloge système est en UTC et + compenser de manière appropriée. Mais même dans ce cas, si vous + utilisez NTP, votre temps UTC sera correct peu après le + redémarrage.</p> <p>La variable d'environnement <code>UNIQUE_ID</code> est construite par codage du quadruplet de 144 bits (adresse IP sur 32 bits, pid - sur 32 bits, repère de temps sur 32 bits, compteur 16 bits et index + sur 32 bits, repère de temps sur 32 bits, compteur 16 bits et index de threads sur 32 bits) en - utilisant l'alphabet <code>[A-Za-z0-9@-]</code> d'une manière - similaire à celle du codage MIME base64, et sa valeur se présente - sous la forme d'une chaîne de 24 caractères. L'alphabet MIME base64 - est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caractères - <code>+</code> et <code>/</code> nécessitent un codage particulier + utilisant l'alphabet <code>[A-Za-z0-9@-]</code> d'une manière + similaire à celle du codage MIME base64, et sa valeur se présente + sous la forme d'une chaîne de 24 caractères. L'alphabet MIME base64 + est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caractères + <code>+</code> et <code>/</code> nécessitent un codage particulier dans les URLs, ce qui rend leur utilisation peu commode. Toutes les - valeurs sont codées dans l'ordre des octets d'une adresse réseau de - façon à ce - que le codage soit comparable entre des architectures où l'ordre des - octets est différent. L'ordre réel de codage est : repère de temps, - adresse IP, pid, compteur. Cet ordre de codage possède un but - précis, mais il faut souligner que les applications n'ont aucun - intérêt à entrer dans les détails de ce codage. Les applications + valeurs sont codées dans l'ordre des octets d'une adresse réseau de + façon à ce + que le codage soit comparable entre des architectures où l'ordre des + octets est différent. L'ordre réel de codage est : repère de temps, + adresse IP, pid, compteur. Cet ordre de codage possède un but + précis, mais il faut souligner que les applications n'ont aucun + intérêt à entrer dans les détails de ce codage. Les applications doivent se contenter de traiter la variable <code>UNIQUE_ID</code> - comme un symbole opaque, qui peut être comparé avec d'autres - <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p> + comme un symbole opaque, qui peut être comparé avec d'autres + <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p> - <p>L'ordre a été choisi de façon à ce qu'il soit possible de - modifier le codage dans le futur sans avoir à se préoccuper de - conflits éventuels avec une base de données de + <p>L'ordre a été choisi de façon à ce qu'il soit possible de + modifier le codage dans le futur sans avoir à se préoccuper de + conflits éventuels avec une base de données de <code>UNIQUE_ID</code>s existante. Les nouveaux codages doivent - conserver le repère de temps comme premier élément, et pour le - reste, utiliser les même alphabet et longueur en bits. Comme les - repères de temps constituent essentiellement un séquence croissante, - il suffit que toutes les machines du cluster arrêtent de traiter - toute requête dans la même <em>seconde repère</em>, et n'utilisent + conserver le repère de temps comme premier élément, et pour le + reste, utiliser les même alphabet et longueur en bits. Comme les + repères de temps constituent essentiellement un séquence croissante, + il suffit que toutes les machines du cluster arrêtent de traiter + toute requête dans la même <em>seconde repère</em>, et n'utilisent alors plus l'ancien format de codage. Ensuite, elles peuvent - reprendre le traitement des requêtes en utilisant les nouveaux + reprendre le traitement des requêtes en utilisant les nouveaux codages.</p> <p>Nous pensons que ceci apporte une solution relativement portable - au problème. Les - identifiants générés possèdent une durée de vie pratiquement infinie - car les identifiants futurs pourront être allongés selon les + au problème. Les + identifiants générés possèdent une durée de vie pratiquement infinie + car les identifiants futurs pourront être allongés selon les besoins. Pratiquement aucune communication n'est requise entre les machines du cluster (seule la synchronisation NTP est requise, ce - qui représente une charge très faible), et aucune communication - entre les processus httpd n'est nécessaire (la communication est - implicite et incluse dans le pid assigné par le noyau). Dans des - situations très spécifiques, l'identifiant peut être raccourci, mais - dans ce cas, d'avantage d'informations doivent être admises (par + qui représente une charge très faible), et aucune communication + entre les processus httpd n'est nécessaire (la communication est + implicite et incluse dans le pid assigné par le noyau). Dans des + situations très spécifiques, l'identifiant peut être raccourci, mais + dans ce cas, d'avantage d'informations doivent être admises (par exemple, les 32 bits de l'adresse IP sont excessifs pour la plupart des sites, mais il n'existe pas de valeur de remplacement portable plus courte).</p> @@ -240,7 +240,7 @@ identifiant unique pour chaque requête</td></tr> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_unique_id.html" hreflang="en" rel="alternate" title="English"> en </a> | -<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | +<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> @@ -261,7 +261,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_unique_id. } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); |