1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
|
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 658546 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<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>
<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
des variables d'environnement 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.</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>
<example>
BrowserMatch ^Mozilla netscape<br />
BrowserMatch MSIE !netscape<br />
</example>
</summary>
<seealso><a href="../env.html">Les variables d'environnement dans
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>
<syntax>BrowserMatch <em>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>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
effet :</p>
<example>
BrowserMatchNoCase Robot est_un_robot<br />
SetEnvIfNoCase User-Agent Robot est_un_robot<br />
</example>
<p>Quelques exemples supplémentaires :</p>
<example>
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
BrowserMatch MSIE !javascript<br />
</example>
</usage>
</directivesynopsis>
<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
casse</description>
<syntax>BrowserMatchNoCase <em>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>
<compatibility>Versions 1.2 d'Apache et supérieures (dans Apache 1.2,
cette directive se trouvait dans le module mod_browser devenu depuis
obsolète)</compatibility>
<usage>
<p>La directive <directive>BrowserMatchNoCase</directive> est
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>
<example>
BrowserMatchNoCase mac platform=macintosh<br />
BrowserMatchNoCase win platform=windows<br />
</example>
<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ême effet :</p>
<example>
BrowserMatchNoCase Robot est_un_robot<br />
SetEnvIfNoCase User-Agent Robot est_un_robot<br />
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>SetEnvIf</name>
<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>
<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é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
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
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>
</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
<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
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 <glossary
ref="regex">expression rationnelle</glossary>. 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 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>
<example>
<title>Example:</title>
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\.exemple\.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 />
</example>
<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
<code>www.mon-domaine.example.com</code>.</p>
<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>
</usage>
<seealso><a href="../env.html">Les variables d'environnement dans
Apache</a> pour des exemples supplémentaires.
</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>
<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>
<compatibility>Versions 1.3 d'Apache et supérieures</compatibility>
<usage>
<p>La directive <directive>SetEnvIfNoCase</directive> est identique
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>
<example>
SetEnvIfNoCase Host Apache\.Org site=apache
</example>
<p>Cette ligne va définir la variable d'environnement
<code>site</code> avec la valeur "<code>apache</code>" si le champ
d'en-tête de requête HTTP <code>Host:</code> est présent et contient
<code>Apache.Org</code>, <code>apache.org</code>, ou une autre
combinaison des mêmes caractères, sans tenir compte de la casse.</p>
</usage>
</directivesynopsis>
</modulesynopsis>
|
