diff options
| -rw-r--r-- | docs/manual/mod/mod_proxy_scgi.xml.fr | 102 | ||||
| -rw-r--r-- | docs/manual/mod/mod_setenvif.xml.fr | 205 | ||||
| -rw-r--r-- | docs/manual/mod/mod_so.xml.fr | 151 | ||||
| -rw-r--r-- | docs/manual/new_features_2_4.xml.fr | 371 |
4 files changed, 420 insertions, 409 deletions
diff --git a/docs/manual/mod/mod_proxy_scgi.xml.fr b/docs/manual/mod/mod_proxy_scgi.xml.fr index 97d5ef9a9d..820195efe6 100644 --- a/docs/manual/mod/mod_proxy_scgi.xml.fr +++ b/docs/manual/mod/mod_proxy_scgi.xml.fr @@ -1,7 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1678234:1673563 (outdated) --> +<!-- English Revision: 1678234 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -25,7 +25,7 @@ <modulesynopsis metafile="mod_proxy_scgi.xml.meta"> <name>mod_proxy_scgi</name> -<description>Module fournissant le support de la passerelle SCGI à +<description>Module fournissant le support de la passerelle SCGI à <module>mod_proxy</module></description> <status>Extension</status> <sourcefile>mod_proxy_scgi.c</sourcefile> @@ -38,15 +38,15 @@ <a href="http://python.ca/scgi/protocol.txt">protocole SCGI, version 1</a>.</p> - <p>Ainsi, pour être en mesure de traiter le protocole SCGI, + <p>Ainsi, pour être en mesure de traiter le protocole SCGI, <module>mod_proxy</module> et <module>mod_proxy_scgi</module> - doivent être chargés dans le serveur.</p> + doivent être chargés dans le serveur.</p> <note type="warning"><title>Avertissement</title> - <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> </note> </summary> @@ -64,14 +64,14 @@ </highlight> </example> - <p>La passerelle à répartition de charge nécessite le chargement du + <p>La passerelle à répartition de charge nécessite le chargement du module <module>mod_proxy_balancer</module> et d'au moins un module - fournissant un algorithme de répartition de charge, comme + fournissant un algorithme de répartition de charge, comme <module>mod_lbmethod_byrequests</module> en plus des modules - déjà cités. <module>mod_lbmethod_byrequests</module> est le module - par défaut et sera utilisé dans cet exemple de configuration.</p> + déjà cités. <module>mod_lbmethod_byrequests</module> est le module + par défaut et sera utilisé dans cet exemple de configuration.</p> - <example><title>Passerelle à répartition de charge</title> + <example><title>Passerelle à répartition de charge</title> <highlight language="config"> ProxyPass "/scgi-bin/" "balancer://somecluster/" <Proxy "balancer://somecluster"> @@ -84,23 +84,23 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" <section id="env"><title>Variables d'environnement</title> <p>En plus des directives de configuration qui permettent de - contrôler le comportement de <module>mod_proxy</module>, une + contrôler le comportement de <module>mod_proxy</module>, une <dfn>variable d'environnement</dfn> peut aussi - contrôler le fournisseur de protocole SCGI :</p> + contrôler le fournisseur de protocole SCGI :</p> <dl> <dt>proxy-scgi-pathinfo</dt> - <dd>Par défaut, <module>mod_proxy_scgi</module> ne créera ni + <dd>Par défaut, <module>mod_proxy_scgi</module> ne créera ni exportera jamais la variable d'environnement - <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan - de déterminer correctement <var>SCRIPT_NAME</var> et - <var>Script-URI</var>, et de rester en conformité avec la section + <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan + de déterminer correctement <var>SCRIPT_NAME</var> et + <var>Script-URI</var>, et de rester en conformité avec la section 3.3 de la RFC 3875. Si au contraire vous souhaitez que - <module>mod_proxy_scgi</module> génère une estimation la plus - précise possible de <var>PATH_INFO</var>, définissez cette - variable d'environnement. La variable doit être définie avant + <module>mod_proxy_scgi</module> génère une estimation la plus + précise possible de <var>PATH_INFO</var>, définissez cette + variable d'environnement. La variable doit être définie avant que la directive <directive module="env">SetEnv</directive> ne soit effective. Il est possible - d'utiliser à la place la directive <directive + d'utiliser à la place la directive <directive module="setenv">SetEnvIf</directive> : <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code> </dd> </dl> @@ -108,9 +108,9 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" <directivesynopsis> <name>ProxySCGISendfile</name> -<description>Active l'évaluation du pseudo en-tête de réponse +<description>Active l'évaluation du pseudo en-tête de réponse <var>X-Sendfile</var></description> -<syntax>ProxySCGISendfile On|Off|<var>nom-en-tête</var></syntax> +<syntax>ProxySCGISendfile On|Off|<var>nom-en-tête</var></syntax> <default>ProxySCGISendfile Off</default> <contextlist><context>server config</context><context>virtual host</context> <context>directory</context></contextlist> @@ -118,39 +118,39 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" <usage> <p>La directive <directive>ProxySCGISendfile</directive> permet au serveur cible SCGI de faire servir les fichiers directement par la - passerelle. Ceci s'avère bénéfique en - matière de performances — + passerelle. Ceci s'avère bénéfique en + matière de performances — httpd peut alors utiliser <code>sendfile</code> ou d'autres optimisations, ce qui n'est pas possible si les fichiers passent par la socket du serveur cible. En outre, les fichiers ne sont transmis qu'une seule fois.</p> <p>L'argument de la directive - <directive>ProxySCGISendfile</directive> détermine le comportement + <directive>ProxySCGISendfile</directive> détermine le comportement de la passerelle :</p> <dl> <dt><code>Off</code></dt> - <dd>Aucun traitement particulier n'est effectué.</dd> + <dd>Aucun traitement particulier n'est effectué.</dd> <dt><code>On</code></dt> - <dd>La passerelle recherche un en-tête dans la réponse du serveur - cible nommé <code>X-Sendfile</code>, et interprète sa valeur comme - le nom du fichier à servir. L'en-tête est ensuite supprimé de la - réponse finale. Cet argument produit le même effet que + <dd>La passerelle recherche un en-tête dans la réponse du serveur + cible nommé <code>X-Sendfile</code>, et interprète sa valeur comme + le nom du fichier à servir. L'en-tête est ensuite supprimé de la + réponse finale. Cet argument produit le même effet que <code>ProxySCGISendfile X-Sendfile</code>.</dd> <dt>toute autre valeur</dt> - <dd>Identique à <code>On</code>, mais au lieu de rechercher le nom - d'en-tête codé en dur <code>X-Sendfile</code>, c'est la - valeur de l'argument qui constitue le nom de l'en-tête - à rechercher.</dd> + <dd>Identique à <code>On</code>, mais au lieu de rechercher le nom + d'en-tête codé en dur <code>X-Sendfile</code>, c'est la + valeur de l'argument qui constitue le nom de l'en-tête + à rechercher.</dd> </dl> <example><title>Exemple</title> <highlight language="config"> - # Utilise le nom d'en-tête par défaut (X-Sendfile) + # Utilise le nom d'en-tête par défaut (X-Sendfile) ProxySCGISendfile On - # Utilise un nom d'en-tête différent + # Utilise un nom d'en-tête différent ProxySCGISendfile X-Send-Static </highlight> </example> @@ -159,7 +159,7 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" <directivesynopsis> <name>ProxySCGIInternalRedirect</name> -<description>Active ou désactive les réponses de redirection interne en +<description>Active ou désactive les réponses de redirection interne en provenance du serveur cible.</description> <syntax>ProxySCGIInternalRedirect On|Off|<var>Headername</var></syntax> <default>ProxySCGIInternalRedirect On</default> @@ -171,26 +171,26 @@ la version 2.4.13 du serveur HTTP Apache.</compatibility> <usage> <p>La directive <directive>ProxySCGIInternalRedirect</directive> permet au serveur cible de rediriger en interne la passerelle vers - une URL différente. Cette fonctionnalité trouve son origine dans - <module>mod_cgi</module> qui redirige la réponse en interne si - l'état de la réponse est <code>OK</code> (<code>200</code>), et si - la réponse contient un en-tête <code>Location</code> - (ou un autre en-tête défini) dont la valeur - débute par un slash (<code>/</code>). Cette valeur est interprétée + une URL différente. Cette fonctionnalité trouve son origine dans + <module>mod_cgi</module> qui redirige la réponse en interne si + l'état de la réponse est <code>OK</code> (<code>200</code>), et si + la réponse contient un en-tête <code>Location</code> + (ou un autre en-tête défini) dont la valeur + débute par un slash (<code>/</code>). Cette valeur est interprétée comme une nouvelle URL locale vers laquelle Apache httpd effectue sa redirection.</p> - <p>De ce point de vue, <module>mod_proxy_scgi</module> fait la même + <p>De ce point de vue, <module>mod_proxy_scgi</module> fait la même chose que <module>mod_cgi</module>, mais vous pouvez en plus - désactiver la fonctionnalité ou spécifier - l'utilisation d'un en-tête autre que <code>Location</code>.</p> + désactiver la fonctionnalité ou spécifier + l'utilisation d'un en-tête autre que <code>Location</code>.</p> <example><title>Exemple</title> <highlight language="config"> ProxySCGIInternalRedirect Off # Django et certains autres frameworks qualifient pleinement les "URLs -# locales" définies par l'application ; il faut donc utiliser un autre -# en-tête. +# locales" définies par l'application ; il faut donc utiliser un autre +# en-tête. <Location /django-app/> ProxySCGIInternalRedirect X-Location </Location> diff --git a/docs/manual/mod/mod_setenvif.xml.fr b/docs/manual/mod/mod_setenvif.xml.fr index ad6d904334..8fa85d0a78 100644 --- a/docs/manual/mod/mod_setenvif.xml.fr +++ b/docs/manual/mod/mod_setenvif.xml.fr @@ -1,7 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1557618:1727648 (outdated) --> +<!-- English Revision: 1727648 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -25,26 +25,26 @@ <modulesynopsis metafile="mod_setenvif.xml.meta"> <name>mod_setenvif</name> -<description>Permet de définir des variables d'environnement en fonction -de caractéristiques de la requête</description> +<description>Permet de définir des variables d'environnement en fonction +de caractéristiques de la requête</description> <status>Base</status> <sourcefile>mod_setenvif.c</sourcefile> <identifier>setenvif_module</identifier> <summary> - <p>Le module <module>mod_setenvif</module> vous permet de définir + <p>Le module <module>mod_setenvif</module> 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> <highlight language="config"> @@ -53,16 +53,16 @@ BrowserMatch MSIE !netscape </highlight> <p>Lorsque le serveur cherche un chemin via une <glossary - ref="subrequest">sous-requête</glossary> interne (par exemple la + ref="subrequest">sous-requête</glossary> interne (par exemple la recherche d'un <directive - module="mod_dir">DirectoryIndex</directive>), ou lorsqu'il génère un - listing du contenu d'un répertoire via le module - <module>mod_autoindex</module>, la sous-requête n'hérite pas des - variables d'environnement spécifiques à la requête. En outre, à cause + module="mod_dir">DirectoryIndex</directive>), ou lorsqu'il génère un + listing du contenu d'un répertoire via le module + <module>mod_autoindex</module>, 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 <module>mod_setenvif</module> prend part, les directives <directive - module="mod_setenvif">SetEnvIf</directive> ne sont pas évaluées - séparément dans la sous-requête.</p> + module="mod_setenvif">SetEnvIf</directive> ne sont pas évaluées + séparément dans la sous-requête.</p> </summary> @@ -71,8 +71,8 @@ serveur HTTP Apache</a></seealso> <directivesynopsis> <name>BrowserMatch</name> -<description>Définit des variables d'environnement en fonction du -contenu de l'en-tête HTTP User-Agent</description> +<description>Définit des variables d'environnement en fonction du +contenu de l'en-tête HTTP User-Agent</description> <syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>valeur</em>] [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax> <contextlist><context>server config</context> @@ -83,16 +83,16 @@ contenu de l'en-tête HTTP User-Agent</description> <usage> <p>La directive <directive>BrowserMatch</directive> est un cas particulier de la directive <directive - module="mod_setenvif">SetEnvIf</directive>, 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 + module="mod_setenvif">SetEnvIf</directive>, 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> <highlight language="config"> -BrowserMatchNoCase Robot is_a_robot -SetEnvIfNoCase User-Agent Robot is_a_robot +BrowserMatch Robot is_a_robot +SetEnvIf User-Agent Robot is_a_robot </highlight> - <p>Quelques exemples supplémentaires :</p> + <p>Quelques exemples supplémentaires :</p> <highlight language="config"> BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript @@ -103,8 +103,8 @@ BrowserMatch MSIE !javascript <directivesynopsis> <name>BrowserMatchNoCase</name> -<description>Définit des variables d'environnement en fonction du -contenu de l'en-tête HTTP User-Agent sans tenir compte de la +<description>Définit des variables d'environnement en fonction du +contenu de l'en-tête HTTP User-Agent sans tenir compte de la casse</description> <syntax>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>valeur</em>] [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax> @@ -116,9 +116,9 @@ casse</description> <usage> <p>La directive <directive>BrowserMatchNoCase</directive> est - identique sur le plan sémantique à la directive <directive + identique sur le plan sémantique à la directive <directive module="mod_setenvif">BrowserMatch</directive>. Elle permet - cependant une comparaison insensible à la casse. Par exemple :</p> + cependant une comparaison insensible à la casse. Par exemple :</p> <highlight language="config"> BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows @@ -128,7 +128,7 @@ BrowserMatchNoCase win platform=windows <directive>BrowserMatchNoCase</directive> sont des cas particuliers des directives <directive module="mod_setenvif">SetEnvIf</directive> et <directive module="mod_setenvif">SetEnvIfNoCase</directive>. - Ainsi, les deux lignes suivantes produisent le même effet :</p> + Ainsi, les deux lignes suivantes produisent le même effet :</p> <highlight language="config"> BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot @@ -138,8 +138,8 @@ SetEnvIfNoCase User-Agent Robot is_a_robot <directivesynopsis> <name>SetEnvIf</name> -<description>Définit des variables d'environnement en fonction des -attributs de la requête</description> +<description>Définit des variables d'environnement en fonction des +attributs de la requête</description> <syntax>SetEnvIf <em>attribut regex [!]env-variable</em>[=<em>valeur</em>] [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax> @@ -149,73 +149,73 @@ attributs de la requête</description> <override>FileInfo</override> <usage> - <p>La directive <directive>SetEnvIf</directive> permet de définir + <p>La directive <directive>SetEnvIf</directive> 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 +<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>, + 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 <directive module="mod_rewrite">RewriteCond</directive> du module <module>mod_rewrite</module> 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 <directive>SetEnvIf</directive> 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 <glossary ref="regex">expression rationnelle</glossary>. 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> @@ -225,15 +225,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>.</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> <highlight language="config"> SetEnvIf Request_URI "\.gif$" object_is_image=gif @@ -243,32 +244,34 @@ SetEnvIf Request_URI "\.xbm$" object_is_image=xbm SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral SetEnvIf object_is_image xbm XBIT_PROCESSING=1 + +SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1 SetEnvIf ^TS ^[a-z] HAVE_TS </highlight> - <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> </usage> <seealso><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. </seealso> </directivesynopsis> <directivesynopsis> <name>SetEnvIfExpr</name> -<description>Définit des variables d'environnement en fonction d'une expression ap_expr</description> +<description>Définit des variables d'environnement en fonction d'une expression ap_expr</description> <syntax>SetEnvIfExpr <em>expr [!]env-variable</em>[=<em>valeur</em>] [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax> @@ -279,10 +282,10 @@ serveur HTTP Apache</a> pour des exemples supplémentaires. <usage> <p>La directive <directive>SetEnvIfExpr</directive> permet de - définir des variables d'environnement en fonction d'une expression + définir des variables d'environnement en fonction d'une expression <directive module="core" type="section">If</directive> <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 <directive>SetEnvIf</directive>.</p> <highlight language="config"> @@ -290,11 +293,11 @@ serveur HTTP Apache</a> pour des exemples supplémentaires. </highlight> <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> <highlight language="config"> @@ -303,17 +306,17 @@ serveur HTTP Apache</a> pour des exemples supplémentaires. </usage> <seealso><a href="../expr.html">Les expressions dans le serveur HTTP -Apache</a>, pour une référence complète et davantage d'exemples.</seealso> +Apache</a>, pour une référence complète et davantage d'exemples.</seealso> <seealso>La directive <directive module="core" -type="section">If</directive> permet d'obtenir des résultats +type="section">If</directive> permet d'obtenir des résultats similaires.</seealso> <seealso><module>mod_filter</module></seealso> </directivesynopsis> <directivesynopsis> <name>SetEnvIfNoCase</name> -<description>Définit des variables d'environnement en fonction des -attributs de la requête sans tenir compte de la casse</description> +<description>Définit des variables d'environnement en fonction des +attributs de la requête sans tenir compte de la casse</description> <syntax>SetEnvIfNoCase <em>attribut regex [!]env-variable</em>[=<em>valeur</em>] [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax> @@ -325,19 +328,19 @@ attributs de la requête sans tenir compte de la casse</description> <usage> <p>La directive <directive>SetEnvIfNoCase</directive> est identique - d'un point de vue sémantique à la directive <directive + d'un point de vue sémantique à la directive <directive module="mod_setenvif">SetEnvIf</directive>, 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> <highlight language="config"> SetEnvIfNoCase Host Example\.Org site=apache </highlight> - <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> </usage> </directivesynopsis> </modulesynopsis> diff --git a/docs/manual/mod/mod_so.xml.fr b/docs/manual/mod/mod_so.xml.fr index 23ac6986ee..3e9b02d9dd 100644 --- a/docs/manual/mod/mod_so.xml.fr +++ b/docs/manual/mod/mod_so.xml.fr @@ -1,7 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1433863:1727635 (outdated) --> +<!-- English Revision: 1727635 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -25,8 +25,8 @@ <modulesynopsis metafile="mod_so.xml.meta"> <name>mod_so</name> -<description>Chargement de modules ou de code exécutable au cours du -démarrage ou du redémarrage du serveur</description> +<description>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</description> <status>Extension</status> <sourcefile>mod_so.c</sourcefile> <identifier>so_module</identifier> @@ -35,33 +35,33 @@ inclus)</compatibility> <summary> - <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> <note type="warning"><title>Avertissement</title> - <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> </note> </summary> -<section id="windows"><title>Création de modules chargeables pour +<section id="windows"><title>Création de modules chargeables pour Windows</title> <note><title>Note</title> - <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 @@ -69,40 +69,40 @@ Windows</title> 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></note> <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> - - <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><directive>LoadModule</directive></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> - - <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 ; + <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 + <directive>LoadModule</directive>. 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> + + <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> <example> module foo_module; @@ -114,35 +114,35 @@ Windows</title> </example> <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 <directive>LoadModule</directive> pour la charger.</p> </section> <directivesynopsis> <name>LoadFile</name> -<description>Liaison du fichier objet ou de la bibliothèque -spécifié</description> +<description>Liaison du fichier objet ou de la bibliothèque +spécifié</description> <syntax>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</syntax> <contextlist> <context>server config</context> @@ -151,17 +151,20 @@ spécifié</description> <usage> - <p>La directive LoadFile permet de lier le fichier objet ou la - bibliothèque spécifié au serveur lors du démarrage ou du redémarrage + <p>La directive <directive>LoadFile</directive> permet de lier le fichier + objet ou la bibliothèque spécifié au serveur lors du + démarrage ou du redémarrage de ce dernier ; ceci permet d'ajouter tout code additionnel - nécessaire au fonctionnement d'un module. + 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 + relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</p> - <p>Par exemple:</p> + <p>Par exemple :</p> - <highlight language="config">LoadFile libexec/libxmlparse.so</highlight> + <highlight language="config"> +LoadFile "libexec/libxmlparse.so" + </highlight> </usage> </directivesynopsis> @@ -169,7 +172,7 @@ spécifié</description> <directivesynopsis> <name>LoadModule</name> <description>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</description> <syntax>LoadModule <em>module nom-fichier</em></syntax> <contextlist> @@ -178,20 +181,22 @@ actifs</description> </contextlist> <usage> - <p>La directive LoadModule 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 + <p>La directive <directive>LoadModule</directive> permet de lier le fichier objet ou la + bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la + structure de module nommée <em>module</em> à la liste des modules actifs. <em>module</em> est le nom de la variable externe de type - <code>module</code> dans le fichier, et est référencé comme <a + <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. Exemple :</p> + module</a> dans la documentation des modules.</p> + + <p>Par exemple :</p> <highlight language="config"> - LoadModule status_module modules/mod_status.so +LoadModule status_module "modules/mod_status.so" </highlight> - <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> </usage> </directivesynopsis> diff --git a/docs/manual/new_features_2_4.xml.fr b/docs/manual/new_features_2_4.xml.fr index 20f60744a6..23a5e9524b 100644 --- a/docs/manual/new_features_2_4.xml.fr +++ b/docs/manual/new_features_2_4.xml.fr @@ -1,9 +1,9 @@ -<?xml version="1.0" encoding="ISO-8859-1" ?> +<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision: 1688011:1726941 (outdated) --> +<!-- English Revision: 1726941 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -24,52 +24,52 @@ <manualpage metafile="new_features_2_4.xml.meta"> -<title>Vue d'ensemble des nouvelles fonctionnalités de la version 2.4 du +<title>Vue d'ensemble des nouvelles fonctionnalités de la version 2.4 du serveur HTTP Apache</title> <summary> - <p>Ce document décrit les modifications majeures apportées par - la version 2.4 du serveur HTTP Apache. Pour les nouvelles fonctionnalités - ajoutées par la version 2.2, se référer au document - <a href="new_features_2_2.html">Nouvelles fonctionnalités + <p>Ce document décrit les modifications majeures apportées par + la version 2.4 du serveur HTTP Apache. Pour les nouvelles fonctionnalités + ajoutées par la version 2.2, se référer au document + <a href="new_features_2_2.html">Nouvelles fonctionnalités de la version 2.2</a>.</p> </summary> <section id="core"> - <title>Améliorations du noyau</title> + <title>Améliorations du noyau</title> <dl> - <dt>Modules multiprocessus (MPMs) chargeables à l'exécution</dt> - <dd>Plusieurs MPMs peuvent maintenant être <a - href="mpm.html#dynamic">compilés en tant que modules - chargeables</a>. Le choix du MPM à utiliser s'effectue - à l'exécution via la directive <directive + <dt>Modules multiprocessus (MPMs) chargeables à l'exécution</dt> + <dd>Plusieurs MPMs peuvent maintenant être <a + href="mpm.html#dynamic">compilés en tant que modules + chargeables</a>. Le choix du MPM à utiliser s'effectue + à l'exécution via la directive <directive module="mod_so">LoadModule</directive>.</dd> <dt>MPM Event</dt> - <dd>Le <a href="mod/event.html">MPM Event</a> n'en est plus au stade expérimental et est - maintenant pleinement supporté.</dd> + <dd>Le <a href="mod/event.html">MPM Event</a> n'en est plus au stade expérimental et est + maintenant pleinement supporté.</dd> <dt>Support du mode asynchrone</dt> - <dd>Le support des lectures/écritures asynchrones pour les MPMs et - les plateformes qui l'implémentent a été amélioré.</dd> + <dd>Le support des lectures/écritures asynchrones pour les MPMs et + les plateformes qui l'implémentent a été amélioré.</dd> <dt>Configuration du niveau de journalisation (LogLevel) par - module et par répertoire</dt> + module et par répertoire</dt> <dd>La directive <directive module="core">LogLevel</directive> - peut maintenant être définie par module et par répertoire. Les - nouveaux niveaux <code>trace1</code> à <code>trace8</code> ont été - ajoutés au dessus du niveau de journalisation <code>debug</code>.</dd> + peut maintenant être définie par module et par répertoire. Les + nouveaux niveaux <code>trace1</code> à <code>trace8</code> ont été + ajoutés au dessus du niveau de journalisation <code>debug</code>.</dd> - <dt>Sections de configuration au niveau requête</dt> + <dt>Sections de configuration au niveau requête</dt> <dd>Les sections <directive module="core">If</directive>, <directive module="core" type="section">ElseIf</directive> et <directive module="core" type="section">Else</directive> - permettent de définir une configuration en fonction de critères - liés à la requête.</dd> + permettent de définir une configuration en fonction de critères + liés à la requête.</dd> - <dt>Interpréteur d'expressions à usage général</dt> - <dd>Un nouvel interpréteur d'expressions permet de spécifier des - <a href="expr.html">conditions complexes</a> via des directives à + <dt>Interpréteur d'expressions à usage général</dt> + <dd>Un nouvel interpréteur d'expressions permet de spécifier des + <a href="expr.html">conditions complexes</a> via des directives à syntaxe commune comme <directive module="mod_setenvif">SetEnvIfExpr</directive>, <directive module="mod_rewrite">RewriteCond</directive>, <directive @@ -78,30 +78,30 @@ serveur HTTP Apache</title> </dd> <dt>KeepAliveTimeout en millisecondes</dt> - <dd>Il est maintenant possible de définir la directive <directive + <dd>Il est maintenant possible de définir la directive <directive module="core">KeepAliveTimeout</directive> en millisecondes. </dd> <dt>Directive NameVirtualHost</dt> - <dd>Cette directive n'est plus nécessaire et est maintenant obsolète.</dd> + <dd>Cette directive n'est plus nécessaire et est maintenant obsolète.</dd> - <dt>Directives autorisées dans les fichiers <code>.htaccess</code></dt> + <dt>Directives autorisées dans les fichiers <code>.htaccess</code></dt> <dd>La nouvelle directive <directive - module="core">AllowOverrideList</directive> permet de contrôler de - manière plus précise la liste des directives autorisées dans les + module="core">AllowOverrideList</directive> permet de contrôler de + manière plus précise la liste des directives autorisées dans les fichiers <code>.htaccess</code>.</dd> <dt>Variables dans les fichiers de configuration</dt> <dd>La directive <directive module="core">Define</directive> - permet de définir des variables dans les fichiers de - configuration, améliorant ainsi la clareté de la présentation si - la même valeur est utilisée en plusieurs points de la + permet de définir des variables dans les fichiers de + configuration, améliorant ainsi la clareté de la présentation si + la même valeur est utilisée en plusieurs points de la configuration. </dd> - <dt>Diminution de la mémoire utilisée</dt> - <dd>Bien qu'elle propose de nombreuses nouvelles fonctionnalités, - la version 2.4.x tend à utiliser moins de mémoire que la version + <dt>Diminution de la mémoire utilisée</dt> + <dd>Bien qu'elle propose de nombreuses nouvelles fonctionnalités, + la version 2.4.x tend à utiliser moins de mémoire que la version 2.2.x.</dd> </dl> @@ -112,213 +112,216 @@ serveur HTTP Apache</title> <dl> <dt><module>mod_proxy_fcgi</module></dt> - <dd>Mise à disposition du protocole FastCGI pour + <dd>Mise à disposition du protocole FastCGI pour <module>mod_proxy</module>.</dd> <dt><module>mod_proxy_scgi</module></dt> - <dd>Mise à disposition du protocole SCGI pour + <dd>Mise à disposition du protocole SCGI pour <module>mod_proxy</module>.</dd> <dt><module>mod_proxy_express</module></dt> - <dd>Ajoute à <module>mod_proxy</module> la configuration dynamique + <dd>Ajoute à <module>mod_proxy</module> la configuration dynamique de mandataires inverses en masse.</dd> <dt><module>mod_remoteip</module></dt> - <dd>Remplace l'adresse IP distante et le nom d'hôte apparents du - client pour la requête courante par la liste d'adresses IP - présentée par un mandataire ou un répartiteur de charge via les - en-têtes de la requête.</dd> + <dd>Remplace l'adresse IP distante et le nom d'hôte apparents du + client pour la requête courante par la liste d'adresses IP + présentée par un mandataire ou un répartiteur de charge via les + en-têtes de la requête.</dd> <dt><module>mod_heartmonitor</module>, <module>mod_lbmethod_heartbeat</module></dt> - <dd>Permet à <module>mod_proxy_balancer</module> de répartir la + <dd>Permet à <module>mod_proxy_balancer</module> de répartir la charge en fonction du nombre de connexions actives sur les - serveurs d'arrière-plan.</dd> + serveurs d'arrière-plan.</dd> <dt><module>mod_proxy_html</module></dt> <dd>Anciennement module tiers, il supporte la correction des liens - HTML dans une situation de mandat inverse, où le serveur - d'arrière-plan génère des URLs qui ne sont pas valides du point de + HTML dans une situation de mandat inverse, où le serveur + d'arrière-plan génère des URLs qui ne sont pas valides du point de vue des clients du mandataire.</dd> <dt><module>mod_sed</module></dt> - <dd>Une amélioration de <module>mod_substitute</module> qui permet - d'éditer le corps de la réponse avec toute la puissance de la + <dd>Une amélioration de <module>mod_substitute</module> qui permet + d'éditer le corps de la réponse avec toute la puissance de la commande sed.</dd> <dt><module>mod_auth_form</module></dt> - <dd>Implémente une authentification à base de formulaire.</dd> + <dd>Implémente une authentification à base de formulaire.</dd> <dt><module>mod_session</module></dt> - <dd>Permet de conserver les données de sessions des clients sous - forme de cookies ou dans une base de données.</dd> + <dd>Permet de conserver les données de sessions des clients sous + forme de cookies ou dans une base de données.</dd> <dt><module>mod_allowmethods</module></dt> <dd>Permet de restreindre l'utilisation de - certaines méthodes HTTP sans interférer avec l'authentification et + certaines méthodes HTTP sans interférer avec l'authentification et l'autorisation.</dd> <dt><module>mod_lua</module></dt> <dd>Embarque le langage <a href="http://www.lua.org/">Lua</a> dans httpd pour la configuration et les fonctions logiques courantes - (Expérimental).</dd> + (Expérimental).</dd> <dt><module>mod_log_debug</module></dt> - <dd>Permet d'introduire une journalisation personnalisée à - différentes phases du traitement de la requête.</dd> + <dd>Permet d'introduire une journalisation personnalisée à + différentes phases du traitement de la requête.</dd> <dt><module>mod_buffer</module></dt> - <dd>Fournit un tampon pour les piles des filtres en entrée et en + <dd>Fournit un tampon pour les piles des filtres en entrée et en sortie.</dd> <dt><module>mod_data</module></dt> - <dd>Convertit un corps de réponse en URL de type données RFC2397.</dd> + <dd>Convertit un corps de réponse en URL de type données RFC2397.</dd> <dt><module>mod_ratelimit</module></dt> <dd>Permet de limiter la bande passante pour certains clients.</dd> <dt><module>mod_request</module></dt> - <dd>Fournit des filtres permettant de gérer et de mettre à - disposition les corps des requêtes HTTP.</dd> + <dd>Fournit des filtres permettant de gérer et de mettre à + disposition les corps des requêtes HTTP.</dd> <dt><module>mod_reflector</module></dt> - <dd>Permet de renvoyer comme réponse le corps de la requête via la + <dd>Permet de renvoyer comme réponse le corps de la requête via la pile du filtre de sortie.</dd> <dt><module>mod_slotmem_shm</module></dt> - <dd>Met à disposition un fournisseur de mémoire partagée à base de + <dd>Met à disposition un fournisseur de mémoire partagée à base de slots (du style tableau de bord).</dd> <dt><module>mod_xml2enc</module></dt> <dd>Anciennement module tiers, il supporte l'internationalisation - dans les modules de filtrage basés sur libxml2 (support du + dans les modules de filtrage basés sur libxml2 (support du markup)</dd> - <dt><module>mod_macro</module> (disponible à partir de la version 2.4.5)</dt> + <dt><module>mod_macro</module> (disponible à partir de la version 2.4.5)</dt> <dd>Permet d'utiliser des macros au sein des fichiers de configuration.</dd> - <dt><module>mod_proxy_wstunnel</module> (disponible à partir de la version 2.4.5)</dt> + <dt><module>mod_proxy_wstunnel</module> (disponible à partir de la version 2.4.5)</dt> <dd>Support des tunnels web-socket.</dd> - <dt><module>mod_authnz_fcgi</module> (disponible à partir de la version 2.4.10)</dt> + <dt><module>mod_authnz_fcgi</module> (disponible à partir de la version 2.4.10)</dt> <dd>Permet aux applications d'autorisation FastCGI d'authentifier et/ou autoriser les clients.</dd> + <dt><module>mod_http2</module> (disponible à partir de la version 2.4.17)</dt> + <dd>Support de la couche transport HTTP/2.</dd> + </dl> </section> <section id="module"> - <title>Améliorations des modules</title> + <title>Améliorations des modules</title> <dl> <dt><module>mod_ssl</module></dt> - <dd><module>mod_ssl</module> peut maintenant vérifier la - validité des certificats clients en se connectant à - un serveur OCSP. Il est possible de définir un - répondeur par défaut, et de choisir si l'on - préfère le répondeur désigné + <dd><module>mod_ssl</module> peut maintenant vérifier la + validité des certificats clients en se connectant à + un serveur OCSP. Il est possible de définir un + répondeur par défaut, et de choisir si l'on + préfère le répondeur désigné dans le certificat client.</dd> <dd>En outre, <module>mod_ssl</module> supporte maintenant l'estampillage OCSP (OCSP stapling), qui permet au serveur - d'attester la validité de son certificat auprès du client au - cours de la phase de négociation de la connexion.</dd> + d'attester la validité de son certificat auprès du client au + cours de la phase de négociation de la connexion.</dd> - <dd>Enfin, <module>mod_ssl</module> peut maintenant être configuré pour - que celui-ci partage les données de session SSL entre les serveurs + <dd>Enfin, <module>mod_ssl</module> peut maintenant être configuré pour + que celui-ci partage les données de session SSL entre les serveurs via memcached.</dd> - <dd>Le support des clés EC a été ajouté à celui des clés RSA et + <dd>Le support des clés EC a été ajouté à celui des clés RSA et DSA.</dd> - <dd>Support de TLS-SRP (disponible à partir de la version 2.4.4).</dd> + <dd>Support de TLS-SRP (disponible à partir de la version 2.4.4).</dd> <dt><module>mod_proxy</module></dt> <dd>La directive <directive - module="mod_proxy">ProxyPass</directive> est maintenant configurée - de manière optimale dans les sections <directive + module="mod_proxy">ProxyPass</directive> est maintenant configurée + de manière optimale dans les sections <directive module="core">Location</directive> ou <directive module="core">LocationMatch</directive>, et offre un gain de - performances important par rapport à la syntaxe traditionnelle à - deux paramètres lorsqu'elle est présente en grand nombre.</dd> + performances important par rapport à la syntaxe traditionnelle à + deux paramètres lorsqu'elle est présente en grand nombre.</dd> <dd>Il est maintenant possible de configurer l'adresse source dans - les requêtes mandatées.</dd> + les requêtes mandatées.</dd> <dd>Support des sockets de type Unix vers le serveur - d'arrière-plan (disponible à partir de la version 2.4.7).</dd> + d'arrière-plan (disponible à partir de la version 2.4.7).</dd> <dt><module>mod_proxy_balancer</module></dt> - <dd>Le gestionnaire de répartition de charge propose de nouvelles - fonctionnalités. Ainsi, les possibilités de configuration des - membres du groupe de répartition de charge pendant l'exécution ont - été améliorées (possibilité d'ajout d'un membre supplémentaire).</dd> + <dd>Le gestionnaire de répartition de charge propose de nouvelles + fonctionnalités. Ainsi, les possibilités de configuration des + membres du groupe de répartition de charge pendant l'exécution ont + été améliorées (possibilité d'ajout d'un membre supplémentaire).</dd> - <dd>Configuration à l'exécution d'un sous-ensemble de paramètres - de répartition de charge.</dd> + <dd>Configuration à l'exécution d'un sous-ensemble de paramètres + de répartition de charge.</dd> - <dd>Les membres du groupe de répartition peuvent être définis à - 'Drain' de façon à ce qu'ils ne répondent qu'aux sessions + <dd>Les membres du groupe de répartition peuvent être définis à + 'Drain' de façon à ce qu'ils ne répondent qu'aux sessions persistantes existantes, ce qui permet de les mettre hors ligne en douceur.</dd> - <dd>Les règlages du répartiteur de charge peuvent être rendus - persistants après redémarrage.</dd> + <dd>Les règlages du répartiteur de charge peuvent être rendus + persistants après redémarrage.</dd> <dt><module>mod_cache</module></dt> - <dd>Le filtre CACHE du module <module>mod_cache</module> peut être - inséré à un certain point de la chaîne de filtrage pour contrôler + <dd>Le filtre CACHE du module <module>mod_cache</module> peut être + inséré à un certain point de la chaîne de filtrage pour contrôler plus finement la mise en cache. </dd> <dd><module>mod_cache</module> peut maintenant mettre en cache des - requêtes HEAD.</dd> + requêtes HEAD.</dd> <dd>Chaque fois que cela est possible, les directives de - <module>mod_cache</module> peuvent maintenant être définies au - niveau du répertoire, et non plus seulement au niveau du serveur + <module>mod_cache</module> peuvent maintenant être définies au + niveau du répertoire, et non plus seulement au niveau du serveur principal.</dd> - <dd>L'URL de base des URLs en cache peut être personnalisée de - façon à ce qu'un cluster de caches puisse partager le même préfixe + <dd>L'URL de base des URLs en cache peut être personnalisée de + façon à ce qu'un cluster de caches puisse partager le même préfixe d'URL.</dd> <dd><module>mod_cache</module> peut maintenant servir du contenu - non mis à jour lorsqu'un serveur d'arrière-plan n'est pas + non mis à jour lorsqu'un serveur d'arrière-plan n'est pas disponible (erreur 5xx).</dd> - <dd><module>mod_cache</module> peut maintenant insérer - HIT/MISS/REVALIDATE dans un en-tête X-Cache.</dd> + <dd><module>mod_cache</module> peut maintenant insérer + HIT/MISS/REVALIDATE dans un en-tête X-Cache.</dd> <dt><module>mod_include</module></dt> - <dd>Support de l'attribut 'onerror' dans un élément 'include', - permettant de renvoyer un message d'erreur personnalisé à la place - du message d'erreur par défaut.</dd> + <dd>Support de l'attribut 'onerror' dans un élément 'include', + permettant de renvoyer un message d'erreur personnalisé à la place + du message d'erreur par défaut.</dd> <dt><module>mod_cgi</module>, <module>mod_include</module>, <module>mod_isapi</module>, ...</dt> - <dd>La traduction des en-têtes en variables d'environnement est + <dd>La traduction des en-têtes en variables d'environnement est plus stricte qu'avant, ce qui permet de diminuer l'exposition aux attaques - de type cross-site-scripting via injection d'en-têtes. Les - en-têtes contenant des caractères invalides (comme les caractères - de soulignement) sont maintenant ignorés. Le document <a + de type cross-site-scripting via injection d'en-têtes. Les + en-têtes contenant des caractères invalides (comme les caractères + de soulignement) sont maintenant ignorés. Le document <a href="env.html">Les variables d'environnement dans Apache</a> - présente quelques pistes pour contourner ce problème avec les - clients anciens qui nécessitent de tels en-têtes (Ceci affecte + présente quelques pistes pour contourner ce problème avec les + clients anciens qui nécessitent de tels en-têtes (Ceci affecte tous les modules qui utilisent ces variables d'environnement).</dd> <dt><module>mod_authz_core</module> Conteneurs de logique d'autorisation</dt> <dd>La directive <directive module="mod_authz_core">Require</directive> et les directives de - conteneurs associées, comme <directive module="mod_authz_core" - type="section">RequireAll</directive>, permettent de définir une - logique d'autorisation avancée.</dd> + conteneurs associées, comme <directive module="mod_authz_core" + type="section">RequireAll</directive>, permettent de définir une + logique d'autorisation avancée.</dd> @@ -326,67 +329,67 @@ serveur HTTP Apache</title> <dd>La directive <directive module="mod_rewrite">RewriteRule</directive> dispose maintenant des drapeaux <code>[QSD]</code> (Query String Discard) et - <code>[END]</code> qui permettent de simplifier les scénarios de - réécriture courants.</dd> - <dd>Possibilité d'utiliser des expressions booléennes complexes + <code>[END]</code> qui permettent de simplifier les scénarios de + réécriture courants.</dd> + <dd>Possibilité d'utiliser des expressions booléennes complexes dans la directive <directive module="mod_rewrite">RewriteCond</directive>.</dd> - <dd>Possibilité d'utiliser des requêtes SQL en tant que fonctions + <dd>Possibilité d'utiliser des requêtes SQL en tant que fonctions dans la directive <directive module="mod_rewrite">RewriteMap</directive>.</dd> <dt><module>mod_ldap</module>, <module>mod_authnz_ldap</module></dt> <dd><module>mod_authnz_ldap</module> ajoute le support des - groupes imbriqués.</dd> + groupes imbriqués.</dd> <dd><module>mod_ldap</module> apporte les directives <directive module="mod_ldap">LDAPConnectionPoolTTL</directive> et <directive module="mod_ldap">LDAPTimeout</directive>, ainsi que d'autres - améliorations dans le traitement des délais. Ceci s'avère utile - pour les configurations où un pare-feu à mémoire d'état (stateful) - rejète les connexions inactives vers le serveur LDAP.</dd> + améliorations dans le traitement des délais. Ceci s'avère utile + pour les configurations où un pare-feu à mémoire d'état (stateful) + rejète les connexions inactives vers le serveur LDAP.</dd> <dd><module>mod_ldap</module> propose la directive <directive module="mod_ldap">LDAPLibraryDebug</directive> qui permet de - journaliser les informations de débogage fournies par la boîte à - outils LDAP utilisée.</dd> + journaliser les informations de débogage fournies par la boîte à + outils LDAP utilisée.</dd> <dt><module>mod_info</module></dt> <dd><module>mod_info</module> est maintenant capable d'afficher la - configuration préinterprétée sur stdout au cours du démarrage du + configuration préinterprétée sur stdout au cours du démarrage du serveur.</dd> <dt><module>mod_auth_basic</module></dt> - <dd>Nouveau mécanisme générique permettant d'effectuer une - authentification basique (disponible à partir de la version 2.4.5).</dd> + <dd>Nouveau mécanisme générique permettant d'effectuer une + authentification basique (disponible à partir de la version 2.4.5).</dd> </dl> </section> <section id="programs"> - <title>Améliorations des programmes</title> + <title>Améliorations des programmes</title> <dl> <dt><program>fcgistarter</program></dt> - <dd>Nouvel utilitaire pour le démarrage des démons + <dd>Nouvel utilitaire pour le démarrage des démons FastCGI.</dd> <dt><program>htcacheclean</program></dt> - <dd>Les URLs présentes dans le cache peuvent maintenant être - affichées, accompagnées éventuellement de leurs métadonnées.</dd> - <dd>Possibilité de supprimer explicitement des URLs individuelles - présentes dans le cache.</dd> - <dd>Les tailles de fichiers peuvent maintenant être arrondies au - multiple de la taille de bloc donnée, les limites de taille - collant de ce fait d'avantage à la taille réelle sur disque.</dd> - <dd>La taille du cache peut maintenant être limitée par le - nombre d'inodes, en plus de la possibilité de limitation par la + <dd>Les URLs présentes dans le cache peuvent maintenant être + affichées, accompagnées éventuellement de leurs métadonnées.</dd> + <dd>Possibilité de supprimer explicitement des URLs individuelles + présentes dans le cache.</dd> + <dd>Les tailles de fichiers peuvent maintenant être arrondies au + multiple de la taille de bloc donnée, les limites de taille + collant de ce fait d'avantage à la taille réelle sur disque.</dd> + <dd>La taille du cache peut maintenant être limitée par le + nombre d'inodes, en plus de la possibilité de limitation par la taille des fichiers.</dd> <dt><program>rotatelogs</program></dt> - <dd>Possibilité de créer un lien vers le fichier journal + <dd>Possibilité de créer un lien vers le fichier journal courant.</dd> - <dd>Possibilité d'invoquer un script personnalisé après la + <dd>Possibilité d'invoquer un script personnalisé après la rotation.</dd> <dt><program>htpasswd</program>, <program>htdbm</program></dt> - <dd>Support de l'algorithme bcrypt (disponible à partir de la + <dd>Support de l'algorithme bcrypt (disponible à partir de la version 2.4.4). </dd> </dl> @@ -397,56 +400,56 @@ serveur HTTP Apache</title> <dl> <dt>mod_rewrite</dt> <dd>La documentation du module <module>mod_rewrite</module> a - été réorganisée et presque entièrement réécrite en mettant + été réorganisée et presque entièrement réécrite en mettant l'accent sur les exemples et l'utilisation courante, ainsi que - sur l'incitation à utiliser d'autres solutions lorsque cela - s'avère plus approprié. Le document <a href="rewrite/">Rewrite + sur l'incitation à utiliser d'autres solutions lorsque cela + s'avère plus approprié. Le document <a href="rewrite/">Rewrite Guide</a> constitue maintenant une section de premier niveau ; - il est mieux organisé et contient beaucoup plus de détails.</dd> + il est mieux organisé et contient beaucoup plus de détails.</dd> <dt>mod_ssl</dt> - <dd>La documentation du module <module>mod_ssl</module> a été - grandement améliorée, avec plus d'exemples et un niveau "Bien - démarrer" qui s'ajoutent aux détails techniques déjà présents - dans la précédente documentation.</dd> + <dd>La documentation du module <module>mod_ssl</module> a été + grandement améliorée, avec plus d'exemples et un niveau "Bien + démarrer" qui s'ajoutent aux détails techniques déjà présents + dans la précédente documentation.</dd> <dt>Caching Guide</dt> <dd>Le <a href="caching.html">Guide de la mise en cache</a> a - été réécrit afin de bien faire la différence entre les - fonctionnalités de mise en cache de la RFC2616 HTTP/1.1 fournies + été réécrit afin de bien faire la différence entre les + fonctionnalités de mise en cache de la RFC2616 HTTP/1.1 fournies par le module <module>mod_cache</module>, et la mise en cache - générique de type clé/valeur fournie par l'interface <a + générique de type clé/valeur fournie par l'interface <a href="socache.html">socache</a>, mais aussi pour couvrir la mise - en cache spécialisée fournie par des mécanismes tels que ceux du + en cache spécialisée fournie par des mécanismes tels que ceux du module <module>mod_file_cache</module>.</dd> </dl> </section> <section id="developer"> - <title>Modifications concernant les développeur de modules</title> + <title>Modifications concernant les développeur de modules</title> <dl> - <dt>Ajout de code pour la vérification de la configuration</dt> - - <dd>Une nouvelle fonction, <code>check_config</code>, a été ajoutée et - s'exécute entre les fonctions <code>pre_config</code> et - <code>open_logs</code>. Elle s'exécute aussi avant la fonction - <code>test_config</code> si l'option <code>-t</code> est passée au - démon <program>httpd</program>. La fonction <code>check_config</code> - permet aux modules de vérifier l'interdépendance des valeurs des + <dt>Ajout de code pour la vérification de la configuration</dt> + + <dd>Une nouvelle fonction, <code>check_config</code>, a été ajoutée et + s'exécute entre les fonctions <code>pre_config</code> et + <code>open_logs</code>. Elle s'exécute aussi avant la fonction + <code>test_config</code> si l'option <code>-t</code> est passée au + démon <program>httpd</program>. La fonction <code>check_config</code> + permet aux modules de vérifier l'interdépendance des valeurs des directives de configuration et d'ajuster ces valeurs, alors que les - messages du serveur peuvent encore être affichés sur la console. + messages du serveur peuvent encore être affichés sur la console. L'utilisateur est ainsi averti des erreurs de configuration avant que la fonction du noyau <code>open_logs</code> ne redirige les sorties de la console vers le journal des erreurs.</dd> <dt>Ajout d'un analyseur syntaxique d'expressions</dt> - <dd>Nous disposons à présent d'un analyseur générique d'expressions, dont l'API - est décrite dans <var>ap_expr.h</var>. Il s'agit d'une adaptation de + <dd>Nous disposons à présent d'un analyseur générique d'expressions, dont l'API + est décrite dans <var>ap_expr.h</var>. Il s'agit d'une adaptation de l'analyseur qu'on trouvait auparavant dans <module>mod_ssl</module>.</dd> <dt>Conteneurs de logique d'autorisation</dt> - <dd>Afin de fournir une logique d'autorisation avancée via des + <dd>Afin de fournir une logique d'autorisation avancée via des directives telles que <directive module="mod_authz_core" type="section">RequireAll</directive>, les modules d'autorisation s'enregistrent maintenant en tant @@ -454,28 +457,28 @@ serveur HTTP Apache</title> <dt>Interface de mise en cache des petits objets</dt> - <dd>Le fichier d'en-têtes <var>ap_socache.h</var> fournit une - interface à base de fournisseur pour la mise en cache des petits - objets de données, en s'inspirant de - l'implémentation précédente - du cache de session par <module>mod_ssl</module>. Sont supportés + <dd>Le fichier d'en-têtes <var>ap_socache.h</var> fournit une + interface à base de fournisseur pour la mise en cache des petits + objets de données, en s'inspirant de + l'implémentation précédente + du cache de session par <module>mod_ssl</module>. Sont supportés actuellement : les fournisseurs utilisant un tampon cyclique en - mémoire partagée, les fichiers dbm sur disque, et les caches - distribués de type memcache.</dd> + mémoire partagée, les fichiers dbm sur disque, et les caches + distribués de type memcache.</dd> <dt>Ajout du point d'ancrage Cache Status</dt> <dd>Le module <module>mod_cache</module> inclut maintenant un - nouveau point d'ancrage, <code>cache_status</code>, qui est appelé - lorsque la décision à propos de la mise en cache est connue. Il en - existe une implémentation par défaut qui ajoute les en-têtes - optionnels <code>X-Cache</code> et <code>X-Cache-Detail</code> à - la réponse.</dd> + nouveau point d'ancrage, <code>cache_status</code>, qui est appelé + lorsque la décision à propos de la mise en cache est connue. Il en + existe une implémentation par défaut qui ajoute les en-têtes + optionnels <code>X-Cache</code> et <code>X-Cache-Detail</code> à + la réponse.</dd> </dl> - <p>La documentation du développeur contient une <a - href="developer/new_api_2_4.html">liste détaillée des modifications + <p>La documentation du développeur contient une <a + href="developer/new_api_2_4.html">liste détaillée des modifications de l'API</a>.</p> </section> |