14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<?xml version="1.0"?>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<modulesynopsis metafile="mod_setenvif.xml.meta">

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<name>mod_setenvif</name>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<description>Permet de d&eacute;finir des variables d'environnement en fonction

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowede caract&eacute;ristiques de la requ&ecirc;te</description>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<status>Base</status>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<sourcefile>mod_setenvif.c</sourcefile>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<identifier>setenvif_module</identifier>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<summary>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe <p>Le module <module>mod_setenvif</module> vous permet de d&eacute;finir

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe des variables d'environnement internes en fonction du fait que telle ou telle

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe caract&eacute;ristique de la requ&ecirc;te correspond ou non aux expressions

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe rationnelles que vous sp&eacute;cifiez. Ces variables d'environnement

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe peuvent &ecirc;tre utilis&eacute;es par d'autres parties du serveur pour prendre

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe des d&eacute;cisions quant aux actions &agrave; entreprendre, et pour d&eacute;terminer

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe si les scripts CGI et les pages SSI doivent pouvoir y acc&eacute;der.</p>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe <p>Les directives sont interpr&eacute;t&eacute;es selon l'ordre dans lequel elles

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe appara&icirc;ssent dans les fichiers de configuration. Ainsi, des

56e85d89d42a6980f31b800266649efbed338da3wrowe s&eacute;quences plus complexes peuvent &ecirc;tre utilis&eacute;es, comme dans cet

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe exemple qui d&eacute;finit netscape si le navigateur est Mozilla et non

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe MSIE.</p>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

37ad54b8fd2611b7a4f2b269eec3d27ed784a25dwrowe<highlight language="config">

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweBrowserMatch ^Mozilla netscape

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweBrowserMatch MSIE !netscape

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe</highlight>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

94b262d3639149df0b02642a9daa6db8bff58577wrowe <p>Lorsque le serveur cherche un chemin via une <glossary

94b262d3639149df0b02642a9daa6db8bff58577wrowe ref="subrequest">sous-requ&ecirc;te</glossary> interne (par exemple la

94b262d3639149df0b02642a9daa6db8bff58577wrowe recherche d'un <directive

94b262d3639149df0b02642a9daa6db8bff58577wrowe module="mod_dir">DirectoryIndex</directive>), ou lorsqu'il g&eacute;n&egrave;re un

94b262d3639149df0b02642a9daa6db8bff58577wrowe listing du contenu d'un r&eacute;pertoire via le module

94b262d3639149df0b02642a9daa6db8bff58577wrowe <module>mod_autoindex</module>, la sous-requ&ecirc;te n'h&eacute;rite pas des

94b262d3639149df0b02642a9daa6db8bff58577wrowe variables d'environnement sp&eacute;cifiques &agrave; la requ&ecirc;te. En outre, &agrave; cause

94b262d3639149df0b02642a9daa6db8bff58577wrowe des phases de l'API auxquelles <module>mod_setenvif</module> prend

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe part, les directives <directive

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe module="mod_setenvif">SetEnvIf</directive> ne sont pas &eacute;valu&eacute;es

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe s&eacute;par&eacute;ment dans la sous-requ&ecirc;te.</p>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe</summary>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<seealso><a href="/env.html">Les variables d'environnement et le

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweserveur HTTP Apache</a></seealso>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<directivesynopsis>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<name>BrowserMatch</name>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<description>D&eacute;finit des variables d'environnement en fonction du

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowecontenu de l'en-t&ecirc;te HTTP User-Agent</description>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>valeur</em>]

5ac28f3fe2417368757f29cf381338357605fd52wrowe[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax>

e1ad80c048e29e968221817698529d73098f07a4wrowe<contextlist><context>server config</context>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<context>virtual host</context><context>directory</context>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<context>.htaccess</context></contextlist>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<override>FileInfo</override>

37ad54b8fd2611b7a4f2b269eec3d27ed784a25dwrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<usage>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe <p>La directive <directive>BrowserMatch</directive> est un cas

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe particulier de la directive <directive

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe module="mod_setenvif">SetEnvIf</directive>, qui d&eacute;finit des variables

94b262d3639149df0b02642a9daa6db8bff58577wrowe d'environnement en fonction du contenu de l'en-t&ecirc;te de requ&ecirc;te HTTP

94b262d3639149df0b02642a9daa6db8bff58577wrowe <code>User-Agent</code>. Les deux lignes suivantes produisent le m&ecirc;me

94b262d3639149df0b02642a9daa6db8bff58577wrowe effet :</p>

94b262d3639149df0b02642a9daa6db8bff58577wrowe<highlight language="config">

94b262d3639149df0b02642a9daa6db8bff58577wroweBrowserMatchNoCase Robot is_a_robot

94b262d3639149df0b02642a9daa6db8bff58577wroweSetEnvIfNoCase User-Agent Robot is_a_robot

94b262d3639149df0b02642a9daa6db8bff58577wrowe</highlight>

94b262d3639149df0b02642a9daa6db8bff58577wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe <p>Quelques exemples suppl&eacute;mentaires :</p>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<highlight language="config">

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweBrowserMatch ^Mozilla forms jpeg=yes browser=netscape

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweBrowserMatch "^Mozilla/[2-3]" tables agif frames javascript

14d5b1a7866541c4eb974f2d213d2aea59743c95wroweBrowserMatch MSIE !javascript

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe</highlight>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe</usage>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe</directivesynopsis>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<directivesynopsis>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<name>BrowserMatchNoCase</name>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<description>D&eacute;finit des variables d'environnement en fonction du

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowecontenu de l'en-t&ecirc;te HTTP User-Agent sans tenir compte de la

8c8173f49dd7122e10636b3d20ae841551bd0b43wrowecasse</description>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<syntax>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>valeur</em>]

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe [[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax>

14d5b1a7866541c4eb974f2d213d2aea59743c95wrowe<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<override>FileInfo</override>

<usage>

<p>La directive <directive>BrowserMatchNoCase</directive> est

identique sur le plan s&eacute;mantique &agrave; la directive <directive

module="mod_setenvif">BrowserMatch</directive>. Elle permet

cependant une comparaison insensible &agrave; la casse. Par exemple :</p>

<highlight language="config">

BrowserMatchNoCase mac platform=macintosh

BrowserMatchNoCase win platform=windows

</highlight>

<p>Les directives <directive>BrowserMatch</directive> et

<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&ecirc;me effet :</p>

<highlight language="config">

BrowserMatchNoCase Robot is_a_robot

SetEnvIfNoCase User-Agent Robot is_a_robot

</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>SetEnvIf</name>

<description>D&eacute;finit des variables d'environnement en fonction des

attributs de la requ&ecirc;te</description>

<syntax>SetEnvIf <em>attribut

regex [!]env-variable</em>[=<em>valeur</em>]

[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</syntax>

<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<override>FileInfo</override>

<usage>

<p>La directive <directive>SetEnvIf</directive> permet de d&eacute;finir

des variables d'environnement en fonction des attributs de la

requ&ecirc;te. L'<em>attribut</em> sp&eacute;cifi&eacute; comme premier argument peut

se pr&eacute;senter sous l'une des quatre formes suivantes :</p>

<ol>

<li>Un champ d'en-t&ecirc;te de requ&ecirc;te HTTP (voir la <a

href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a> pour

plus d'information &agrave; 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&eacute;cifier un jeu d'en-t&ecirc;tes de

requ&ecirc;te.</li>

<li>Une des caract&eacute;ristiques de la requ&ecirc;te suivantes :

<ul>

<li><code>Remote_Host</code> - le nom d'h&ocirc;te (s'il est disponible)

du client qui effectue la requ&ecirc;te</li>

<li><code>Remote_Addr</code> - l'adresse IP du client qui effectue

la requ&ecirc;te</li>

<li><code>Server_Addr</code> - l'adresse IP du serveur qui a re&ccedil;u

la requ&ecirc;te (uniquement &agrave; partir des versions sup&eacute;rieures &agrave;

2.0.43)</li>

<li><code>Request_Method</code> - Le nom de la m&eacute;thode HTTP

utilis&eacute;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&eacute; pour la requ&ecirc;te (par exemple "HTTP/0.9",

"HTTP/1.1", <em>etc...</em>)</li>

<li><code>Request_URI</code> - la ressource demand&eacute;e dans la ligne

de requ&ecirc;te HTTP -- en g&eacute;n&eacute;ral la partie de l'URL suivant le

protocole et le nom du serveur, sans la cha&icirc;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&egrave;re de mettre en correspondance votre cha&icirc;ne d'arguments.</li>

</ul>

</li>

<li>Le nom d'une variable d'environnement parmi la liste de celles qui

sont associ&eacute;es &agrave; la requ&ecirc;te. Ceci permet &agrave; la directive

<directive>SetEnvIf</directive> d'effectuer des tests en fonction du

r&eacute;sultat de comparaisons pr&eacute;c&eacute;dentes. Seules les variables

d'environnement d&eacute;finies par des directives

<code>SetEnvIf[NoCase]</code> pr&eacute;c&eacute;dentes sont disponibles pour

effectuer des tests de cette mani&egrave;re. 'Pr&eacute;c&eacute;dentes' signifie qu'elles se

trouvent &agrave; 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 &eacute;t&eacute; trouv&eacute;e parmi les

caract&eacute;ristiques de la requ&ecirc;te, et si <em>attribut</em> n'a pas &eacute;t&eacute;

sp&eacute;cifi&eacute; 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 &agrave; l'<em>attribut</em>, les arguments suivants sont &eacute;valu&eacute;s.</p>

<p>Le reste des arguments constitue les noms des variables &agrave; d&eacute;finir,

ainsi que les valeurs optionnelles qui doivent leur &ecirc;tre affect&eacute;es. Ils

peuvent se pr&eacute;senter sous les formes suivantes :</p>

<ol>

<li><code><em>nom-variable</em></code>, or</li>

<li><code>!<em>nom-variable</em></code>, or</li>

<li><code><em>nom-variable</em>=<em>valeur</em></code></li>

</ol>

<p>Dans la premi&egrave;re forme, la valeur sera d&eacute;finie &agrave; "1". Dans la

seconde forme, la variable sera supprim&eacute;e si elle a &eacute;t&eacute; d&eacute;finie au

pr&eacute;alable, et dans la troisi&egrave;me forme, la variable sera d&eacute;finie &agrave; la

valeur litt&eacute;rale sp&eacute;cifi&eacute;e par <code><em>valeur</em></code>. Depuis

la version 2.0.51, Apache httpd reconna&icirc;t les occurrences de variables

<code>$1</code>..<code>$9</code> &agrave; l'int&eacute;rieur de

<code><em>valeur</em></code>, et les remplace par les

sous-expressions entre parenth&egrave;ses correspondantes de

<var>regex</var>.</p>

<highlight language="config">

SetEnvIf Request_URI "\.gif$" object_is_image=gif

SetEnvIf Request_URI "\.jpg$" object_is_image=jpg

SetEnvIf Request_URI "\.xbm$" object_is_image=xbm

SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral

SetEnvIf object_is_image xbm XBIT_PROCESSING=1

SetEnvIf ^TS ^[a-z] HAVE_TS

</highlight>

<p>Les trois premi&egrave;res lignes d&eacute;finissent la variable

d'environnement <code>objet_est_une_image</code> si l'objet de la

requ&ecirc;te est un fichier image, et la quatri&egrave;me d&eacute;finit la variable

<code>r&eacute;f&eacute;rant_intra_site</code> si la page r&eacute;f&eacute;rante se trouve

quelque part dans le site web

<code>www.mon-domaine.example.com</code>.</p>

<p>La derni&egrave;re ligne d&eacute;finit la variable d'environnement

<code>HAVE_TS</code> si la requ&ecirc;te contient un en-t&ecirc;te dont le nom

commence par "TS" et dont la valeur commence par tout caract&egrave;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&eacute;mentaires.

</seealso>

</directivesynopsis>

<directivesynopsis>

<name>SetEnvIfExpr</name>

<description>D&eacute;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>

<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<override>FileInfo</override>

<usage>

<p>La directive <directive>SetEnvIfExpr</directive> permet de

d&eacute;finir des variables d'environnement en fonction d'une expression

<directive type="section">If</directive> <code>ap_expr</code>. Cette

expression est &eacute;valu&eacute;e &agrave; l'ex&eacute;cution, et utilise les variables

d'environnement <em>env-variable</em> de la m&ecirc;me mani&egrave;re que la

directive <directive>SetEnvIf</directive>.</p>

<highlight language="config">

SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered

</highlight>

<p>Dans cet exemple, la variable d'environnement

<code>iso_delivered</code> est d&eacute;finie chaque fois que notre

application tente de l'envoyer via <code>X-Sendfile</code>.</p>

<p>Il pourrait &ecirc;tre plus utile de d&eacute;finir une variable rfc1918 si

l'adresse IP distante est une adresse priv&eacute;e au sens de la RFC 1918

:</p>

<highlight language="config">

SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918

</highlight>

</usage>

<seealso><a href="/expr.html">Les expressions dans le serveur HTTP

Apache</a>, pour une r&eacute;f&eacute;rence compl&egrave;te et davantage d'exemples.</seealso>

<seealso>La directive <directive type="section">If</directive> peut &ecirc;tre

utilis&eacute;e pour obtenir des r&eacute;sultats similaires.</seealso>

<seealso><module>mod_filter</module></seealso>

</directivesynopsis>

<directivesynopsis>

<name>SetEnvIfNoCase</name>

<description>D&eacute;finit des variables d'environnement en fonction des

attributs de la requ&ecirc;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>

<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<override>FileInfo</override>

<usage>

<p>La directive <directive>SetEnvIfNoCase</directive> est identique

d'un point de vue s&eacute;mantique &agrave; 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&eacute;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&eacute;finir la variable d'environnement

<code>site</code> avec la valeur "<code>example</code>" si le champ

d'en-t&ecirc;te de requ&ecirc;te HTTP <code>Host:</code> est pr&eacute;sent et contient

<code>Example.Org</code>, <code>example.org</code>, ou une autre

combinaison des m&ecirc;mes caract&egrave;res, sans tenir compte de la casse.</p>

</usage>

</directivesynopsis>

</modulesynopsis>