mod_setenvif.html.fr revision 61d0f219eba8ce646ffd6f2738a60e36e66cf654
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_setenvif - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_setenvif</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="/ko/mod/mod_setenvif.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="/tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet de d�finir des variables d'environnement en fonction
de caract�ristiques de la requ�te</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>setenvif_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_setenvif.c</td></tr></table>
<h3>Sommaire</h3>
<p>Le module <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> vous permet de d�finir
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
MSIE.</p>
<div class="example"><p><code>
BrowserMatch ^Mozilla netscape<br />
BrowserMatch MSIE !netscape<br />
</code></p></div>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
</ul>
<h3>Voir aussi</h3>
<ul class="seealso">
serveur HTTP Apache</a></li>
</ul></div>
<div class="directive-section"><h2><a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a> <a name="browsermatch" id="browsermatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction du
contenu de l'en-t�te HTTP User-Agent</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatch <em>regex [!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">BrowserMatch</code> est un cas
particulier de la directive <code class="directive"><a href="#setenvif">SetEnvIf</a></code>, qui d�finit des variables
d'environnement en fonction du contenu de l'en-t�te de requ�te HTTP
<code>User-Agent</code>. Les deux lignes suivantes produisent le m�me
effet :</p>
<div class="example"><p><code>
BrowserMatchNoCase Robot est_un_robot<br />
SetEnvIfNoCase User-Agent Robot est_un_robot<br />
</code></p></div>
<p>Quelques exemples suppl�mentaires :</p>
<div class="example"><p><code>
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
BrowserMatch MSIE !javascript<br />
</code></p></div>
</div>
<div class="directive-section"><h2><a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a> <a name="browsermatchnocase" id="browsermatchnocase">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction du
contenu de l'en-t�te HTTP User-Agent sans tenir compte de la
casse</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">BrowserMatchNoCase</code> est
identique sur le plan s�mantique � la directive <code class="directive"><a href="#browsermatch">BrowserMatch</a></code>. Elle permet
cependant une comparaison insensible � la casse. Par exemple :</p>
<div class="example"><p><code>
BrowserMatchNoCase mac platform=macintosh<br />
BrowserMatchNoCase win platform=windows<br />
</code></p></div>
<p>Les directives <code class="directive">BrowserMatch</code> et
<code class="directive">BrowserMatchNoCase</code> sont des cas particuliers
des directives <code class="directive"><a href="#setenvif">SetEnvIf</a></code>
et <code class="directive"><a href="#setenvifnocase">SetEnvIfNoCase</a></code>.
Ainsi, les deux lignes suivantes produisent le m�me effet :</p>
<div class="example"><p><code>
BrowserMatchNoCase Robot est_un_robot<br />
SetEnvIfNoCase User-Agent Robot est_un_robot<br />
</code></p></div>
</div>
<div class="directive-section"><h2><a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a> <a name="setenvif" id="setenvif">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction des
attributs de la requ�te</td></tr>
regex [!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">SetEnvIf</code> permet de d�finir
des variables d'environnement en fonction des attributs de la
requ�te. L'<em>attribut</em> sp�cifi� comme premier argument peut
se pr�senter sous l'une des quatre formes suivantes :</p>
<ol>
<li>Un champ d'en-t�te de requ�te HTTP (voir la <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a> pour
plus d'information � leur propos) ; par exemple : <code>Host</code>,
<code>User-Agent</code>, <code>Referer</code>, ou
<code>Accept-Language</code>. Il est possible d'utiliser une
expression rationnelle pour sp�cifier un jeu d'en-t�tes de
requ�te.</li>
<li>Une des caract�ristiques de la requ�te suivantes :
<ul>
<li><code>Remote_Host</code> - le nom d'h�te (s'il est disponible)
du client qui effectue la requ�te</li>
<li><code>Remote_Addr</code> - l'adresse IP du client qui effectue
la requ�te</li>
<li><code>Server_Addr</code> - l'adresse IP du serveur qui a re�u
la requ�te (uniquement � partir des versions sup�rieures �
2.0.43)</li>
<li><code>Request_Method</code> - Le nom de la m�thode HTTP
utilis�e (<code>GET</code>, <code>POST</code>, <em>et
cetera...</em>)</li>
<li><code>Request_Protocol</code> - le nom et la version du
<li><code>Request_URI</code> - la ressource demand�e dans la ligne
de requ�te HTTP -- en g�n�ral la partie de l'URL suivant le
protocole et le nom du serveur, sans la cha�ne d'arguments. Voir
la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> du module
<code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> pour plus d'informations sur la
mani�re de mettre en correspondance votre cha�ne d'arguments.</li>
</ul>
</li>
<li>Le nom d'une variable d'environnement parmi la liste de celles qui
sont associ�es � la requ�te. Ceci permet � la directive
<code class="directive">SetEnvIf</code> d'effectuer des tests en fonction du
r�sultat de comparaisons pr�c�dentes. Seules les variables
d'environnement d�finies par des directives
<code>SetEnvIf[NoCase]</code> pr�c�dentes sont disponibles pour
effectuer des tests de cette mani�re. 'Pr�c�dentes' signifie qu'elles se
trouvent � un niveau plus global de la configuration (par exemple au
niveau du serveur principal), ou plus haut chronologiquement dans le
contexte de la directive. Les variables d'environnement ne seront prises
en compte que si aucune correspondance n'a �t� trouv�e parmi les
caract�ristiques de la requ�te, et si <em>attribut</em> n'a pas �t�
sp�cifi� sous la forme d'une expression rationnelle.</li>
<li>La r�f�rence � une extension d'un certificat client SSL, localis�
par son identifiant objet <em>oid</em>. Dans le cas d'une requ�te non
SSL, ou en l'absence d'<em>oid</em> configur�, aucune variable ne sera
d�finie. Si l'<em>oid</em> est trouv� plusieurs fois, les cha�nes
individuelles seront concat�n�es, en les s�parant par des virgules
<code>','</code>. L'<em>oid</em> doit faire r�f�rence � une extension
sous forme de cha�ne.
</li>
</ol>
<p>Le second argument (<em>regex</em>) est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Si <em>regex</em>
correspond � l'<em>attribut</em>, les arguments suivants sont �valu�s.</p>
<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>
<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�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>
<div class="example"><h3>Example:</h3><p><code>
SetEnvIf Request_URI "\.gif$" objet_est_une_image=gif<br />
SetEnvIf Request_URI "\.jpg$" objet_est_une_image=jpg<br />
SetEnvIf Request_URI "\.xbm$" objet_est_une_image=xbm<br />
:<br />
SetEnvIf Referer www\.mon-domaine\.example\.com r�f�rant_intra_site<br />
:<br />
SetEnvIf objet_est_une_image xbm XBIT_PROCESSING=1<br />
:<br />
SetEnvIf OID("2.16.840.1.113730.1.13") "(.*)" commentaire-netscape=$1<br />
:<br />
SetEnvIf ^TS ^[a-z] HAVE_TS<br />
</code></p></div>
<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
quelque part dans le site web
<p>La sixi�me ligne d�finit la variable d'environnement
<code>commentaire-netscape</code> avec la cha�ne trouv�e dans le
champ du certificat client SSL correspondant.</p>
<p>La derni�re ligne d�finit la variable d'environnement
<code>HAVE_TS</code> si la requ�te contient un en-t�te dont le nom
commence par "TS" et dont la valeur commence par tout caract�re du
jeu [a-z].</p>
<h3>Voir aussi</h3>
<ul>
serveur HTTP Apache</a> pour des exemples suppl�mentaires.
</li>
</ul>
</div>
<div class="directive-section"><h2><a name="SetEnvIfExpr" id="SetEnvIfExpr">SetEnvIfExpr</a> <a name="setenvifexpr" id="setenvifexpr">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction d'une expression ap_expr</td></tr>
[!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">SetEnvIfExpr</code> permet de
d�finir des variables d'environnement en fonction d'une expression
<code class="directive"><If></code> <code>ap_expr</code>. Cette
expression est �valu�e � l'ex�cution, et utilise les variables
d'environnement <em>env-variable</em> de la m�me mani�re que la
directive <code class="directive">SetEnvIf</code>.</p>
<div class="example"><p><code>
SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered
</code></p></div>
<p>Dans cet exemple, la variable d'environnement
<code>iso_delivered</code> est d�finie chaque fois que notre
application tente de l'envoyer via <code>X-Sendfile</code>.</p>
<p>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>
<div class="example"><p><code>
</code></p></div>
<h3>Voir aussi</h3>
<ul>
Apache</a>, pour une r�f�rence compl�te et davantage d'exemples.</li>
<li>La directive <code class="directive"><If></code> peut �tre
utilis�e pour obtenir des r�sultats similaires.</li>
</ul>
</div>
<div class="directive-section"><h2><a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a> <a name="setenvifnocase" id="setenvifnocase">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction des
attributs de la requ�te sans tenir compte de la casse</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnvIfNoCase <em>attribut regex
[!]env-variable</em>[=<em>valeur</em>]
[[!]<em>env-variable</em>[=<em>valeur</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">SetEnvIfNoCase</code> est identique
d'un point de vue s�mantique � la directive <code class="directive"><a href="#setenvif">SetEnvIf</a></code>, et ne s'en distingue que
par le fait que la comparaison des expressions rationnelles est
effectu�e sans tenir compte de la casse. Par exemple :</p>
<div class="example"><p><code>
SetEnvIfNoCase Host Example\.Org site=apache
</code></p></div>
<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
combinaison des m�mes caract�res, sans tenir compte de la casse.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="/ko/mod/mod_setenvif.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="/tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>