mod_setenvif.html.fr revision 1f1b6bf13313fdd14a45e52e553d3ff28689b717
<?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 Version 2.5</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
</script>
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</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.5</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>
<pre class="prettyprint lang-config">BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape</pre>
<p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="/glossary.html#subrequest" title="voir glossaire">sous-requ�te</a> interne (par exemple la
recherche d'un <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il g�n�re un
listing du contenu d'un r�pertoire via le module
<code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requ�te n'h�rite pas des
variables d'environnement sp�cifiques � la requ�te. En outre, � cause
des phases de l'API auxquelles <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> prend
part, les directives <code class="directive"><a href="#setenvif">SetEnvIf</a></code> ne sont pas �valu�es
s�par�ment dans la sous-requ�te.</p>
</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><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="directive-section"><h2><a name="browsermatch" id="browsermatch">Directive</a> <a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction du
contenu de l'en-t�te HTTP User-Agent</td></tr>
<tr><th><a href="directive-dict.html#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>
<pre class="prettyprint lang-config">BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot</pre>
<p>Quelques exemples suppl�mentaires :</p>
<pre class="prettyprint lang-config">BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript</pre>
</div>
<div class="directive-section"><h2><a name="browsermatchnocase" id="browsermatchnocase">Directive</a> <a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction du
contenu de l'en-t�te HTTP User-Agent sans tenir compte de la
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>
<pre class="prettyprint lang-config">BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows</pre>
<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>
<pre class="prettyprint lang-config">BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot</pre>
</div>
<div class="directive-section"><h2><a name="setenvif" id="setenvif">Directive</a> <a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction des
attributs de la requ�te</td></tr>
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>
</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>
<pre class="prettyprint lang-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</pre>
<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 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">Directive</a> <a name="SetEnvIfExpr" id="SetEnvIfExpr">SetEnvIfExpr</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction d'une expression ap_expr</td></tr>
[!]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"><a href="/mod/core.html#if"><If></a></code> <code>ap_expr</code>. Cette
expression est �valu�e � l'ex�cution, et utilise les variables
d'environnement <em>env-variable</em> de la m�me mani�re que la
directive <code class="directive">SetEnvIf</code>.</p>
<pre class="prettyprint lang-config">SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered</pre>
<p>Dans cet exemple, la variable d'environnement
<code>iso_delivered</code> est d�finie chaque fois que notre
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>
<pre class="prettyprint lang-config">SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918</pre>
<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"><a href="/mod/core.html#if"><If></a></code> permet d'obtenir des r�sultats
similaires.</li>
</ul>
</div>
<div class="directive-section"><h2><a name="setenvifnocase" id="setenvifnocase">Directive</a> <a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit des variables d'environnement en fonction des
attributs de la requ�te sans tenir compte de la casse</td></tr>
<tr><th><a href="directive-dict.html#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>
<pre class="prettyprint lang-config">SetEnvIfNoCase Host Example\.Org site=apache</pre>
<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 class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_setenvif.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>