diff options
| author | Lucien Gentis <lgentis@apache.org> | 2016-01-30 17:43:13 +0100 |
|---|---|---|
| committer | Lucien Gentis <lgentis@apache.org> | 2016-01-30 17:43:13 +0100 |
| commit | 906c370c6282bab88553a917557b19ea523e92ab (patch) | |
| tree | 61e51cc1096a5e20342c312345419ddc24c7af6a /docs/manual/mod/mod_setenvif.xml.fr | |
| parent | Fix a tag in the Spanish doc (diff) | |
| download | apache2-906c370c6282bab88553a917557b19ea523e92ab.tar.xz apache2-906c370c6282bab88553a917557b19ea523e92ab.zip | |
XML updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1727726 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_setenvif.xml.fr')
| -rw-r--r-- | docs/manual/mod/mod_setenvif.xml.fr | 205 |
1 files changed, 104 insertions, 101 deletions
diff --git a/docs/manual/mod/mod_setenvif.xml.fr b/docs/manual/mod/mod_setenvif.xml.fr index 745d97a38f..80141de413 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 : 1673947 --> +<!-- English Revision : 1727647 --> <!-- 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> |