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
304
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_setenvif - 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" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.3</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="../">バージョン
2.3</a> > <a href="./">モジュール</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache モジュール mod_setenvif</h1>
<div class="toplang">
<p><span>言語: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_setenvif.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_setenvif.html" 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">説明:</a></th><td>リクエストの特徴に基づいた環境変数の設定を可能にする</td></tr>
<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>setenvif_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_setenvif.c</td></tr></table>
<h3>概要</h3>
<p><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>
モジュールは、リクエストのある側面が指定された正規表現
に合うかどうかによって環境変数を設定する機能を提供します。
これらの環境変数を使用して、サーバの他の部分がどのような動作をするかを
決定することができます。</p>
<p>このモジュールが提供するディレクティブは、
設定ファイルに現れる順番に適用されます。
それを使って、次の例のようにより複雑な設定をすることができます。
これは、ブラウザが mozilla ではあるけれど、MSIE ではないときに
<code>netscape</code> を設定します。</p>
<div class="example"><p><code>
BrowserMatch ^Mozilla netscape<br />
BrowserMatch MSIE !netscape<br />
</code></p></div>
</div>
<div id="quickview"><h3 class="directives">ディレクティブ</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#browsermatch">BrowserMatch</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#browsermatchnocase">BrowserMatchNoCase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenvif">SetEnvIf</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenvifnocase">SetEnvIfNoCase</a></li>
</ul>
<h3>参照</h3>
<ul class="seealso">
<li><a href="../env.html">Apache の環境変数</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a> <a name="browsermatch" id="browsermatch">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>HTTP User-Agent に基づいて環境変数を設定する
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>]
[[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_setenvif</td></tr>
</table>
<p><code class="directive">BrowserMatch</code> は
<code class="directive"><a href="#setenvif">SetEnvIf</a></code> ディレクティブの
特例で、<code>User-Agent</code> HTTP リクエストヘッダに基づいて
環境変数を設定します。以下の 2 行の効果は同じになります:</p>
<div class="example"><p><code>
BrowserMatchNoCase Robot is_a_robot<br />
SetEnvIfNoCase User-Agent Robot is_a_robot<br />
</code></p></div>
<p>その他の例:</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="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a> <a name="browsermatchnocase" id="browsermatchnocase">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>HTTP User-Agent に基づいて大文字小文字を区別せずに
環境変数を設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>value</em>]
[[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_setenvif</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 1.2 以降
(Apache 1.2 ではこのディレクティブはもう用いられていない
mod_browser モジュールにありました)</td></tr>
</table>
<p><code class="directive">BrowserMatchNoCase</code> ディレクティブは
意味的には <code class="directive"><a href="#browsermatch">BrowserMatch</a></code> ディレクティブと
同じです。ただし、このディレクティブは大文字小文字を区別しない
マッチングを行ないます。例えば:</p>
<div class="example"><p><code>
BrowserMatchNoCase mac platform=macintosh<br />
BrowserMatchNoCase win platform=windows<br />
</code></p></div>
<p><code class="directive">BrowserMatch</code> ディレクティブと
<code class="directive">BrowserMatchNoCase</code> ディレクティブは
<code class="directive"><a href="#setenvif">SetEnvIf</a></code> ディレクティブと
<code class="directive"><a href="#setenvifnocase">SetEnvIfNoCase</a></code> ディレクティブの
特例です。以下の 2 行の効果は同じです:</p>
<div class="example"><p><code>
BrowserMatchNoCase Robot is_a_robot<br />
SetEnvIfNoCase User-Agent Robot is_a_robot<br />
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a> <a name="setenvif" id="setenvif">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リクエストの属性に基づいて環境変数を設定する
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetEnvIf <em>attribute
regex [!]env-variable</em>[=<em>value</em>]
[[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_setenvif</td></tr>
</table>
<p><code class="directive">SetEnvIf</code>
ディレクティブは、リクエストの属性に基づいて環境変数を定義します。
最初の引数で指定できる <em>attribute</em> は以下の 4 つのどれかです:</p>
<ol>
<li>HTTP リクエストヘッダフィールド (詳しい情報は <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC 2616</a> を
参照してください)。例えば、<code>Host</code>,
<code>User-Agent</code>, <code>Referer</code>,
<code>Accept-Language</code> です。リクエストヘッダの集合を現すために
正規表現を使うこともできます。</li>
<li>以下のリクエストの一部分のどれか:
<ul>
<li><code>Remote_Host</code> -
リクエストを行なっているクライアントのホスト名 (もしあれば)</li>
<li><code>Remote_Addr</code> -
リクエストを行なっているクライアントの IP アドレス</li>
<li><code>Server_Addr</code> -
リクエストを受け取ったサーバの IP アドレス
(2.0.43 以降のみ)</li>
<li><code>Request_Method</code> -
使用されているメソッド名 (<code>GET</code>, <code>POST</code>
<em>など</em>)</li>
<li><code>Request_Protocol</code> -
リクエストが行なわれたプロトコルの名前とバージョン
(<em>例えば</em>、"HTTP/0.9", "HTTP/1.1" <em>など。</em>)</li>
<li><code>Request_URI</code> -
URL のスキームとホストの後の部分。
追加の情報として、クエリーストリングにマッチさせる場合については
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
ディレクティブを参照してください。</li>
</ul>
</li>
<li>リクエストと関連付けられる環境変数のリスト。これにより
<code class="directive">SetEnvIf</code> ディレクティブが以前のマッチの結果を
使うことができるようになります。この方法のテストでは前の部分にある
<code>SetEnvIf[NoCase]</code> の結果のみを使用可能です。「前」とは、
より広い範囲に対して定義されている (サーバ全体のように) か、現在のディレクティブの
範囲でより前の部分で定義されているか、ということです。
環境変数である可能性は、リクエストの特性に対するマッチが存在せず、
<em>attribute</em> に正規表現が使われなかったときにのみ考慮されます。</li>
<li>
SSL クライアント証明書拡張への参照で、<em>oid</em> オブジェクト ID
で指定されるもの。
SSL リクエストでない場合や <em>oid</em> が設定されていなかった場合は、
変数はセットされません。<em>oid</em> が複数見つかった場合は
それらの文字列はカンマ <code>','</code> 区切りで連結されます。
<em>oid</em> は文字列型拡張への参照でなければなりません。
</li>
</ol>
<p>二つ目の引数 (<em>regex</em>) は <a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>です。
これは POSIX.2 の egrep 形式の正規表現と似ています。<em>regex</em> が
<em>attribute</em> にマッチする場合は、残りの引数が評価されます。</p>
<p>残りの引数は設定する変数の名前で、設定される値を指定することもできます。
これは、</p>
<ol>
<li><code><em>varname</em></code></li>
<li><code>!<em>varname</em></code></li>
<li><code><em>varname</em>=<em>value</em></code></li>
</ol>
<p>のどれかの形式になります。</p>
<p>最初の形式では、値は "1" に設定されます。
二つ目はもし値が定義されていればそれを取り除きます。
三つ目は変数を <code><em>value</em></code> の与えられた値に設定します。
2.0.51 以降では、<var>value</var> 内に <code>$1</code>..<code>$9</code>
が存在すればそれを認識し、<var>regex</var> の対応する丸括弧で囲まれた部分で
置換します。</p>
<div class="example"><h3>例:</h3><p><code>
SetEnvIf Request_URI "\.gif$" object_is_image=gif<br />
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br />
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br />
:<br />
SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral<br />
:<br />
SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
:<br />
SetEnvIf OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$1<br />
:<br />
SetEnvIf ^TS* ^[a-z].* HAVE_TS<br />
</code></p></div>
<p>初めの三つはリクエストが画像であるときに環境変数
<code>object_is_image</code> を設定します。四つ目は
参照元のページがウェブサイト <code>www.mydomain.example.com</code> にあるときに
<code>intra_site_referral</code> を設定します。</p>
<p>6番目の例では環境変数 <code>NetscapeComment</code> を定義して、
その値が SSL クライアント証明書の対応するフィールドの文字列であるようにします。
ただし SSL クライアント証明書の対応するフィールドに文字列が存在する
ときにのみ、環境変数は設定されます。</p>
<p>最後の例は、リクエストに "TS" で始まり、値が集合 [a-z] のどれかで
始まるヘッダがあるときに <code>HAVE_TS</code> を設定します。</p>
<h3>参照</h3>
<ul>
<li>他の例は、<a href="../env.html">Apache の環境変数</a>
</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a> <a name="setenvifnocase" id="setenvifnocase">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リクエストの属性に基づいて大文字小文字を区別せずに環境変数を設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetEnvIfNoCase <em>attribute regex
[!]env-variable</em>[=<em>value</em>]
[[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_setenvif</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 1.3 以降</td></tr>
</table>
<p><code class="directive">SetEnvIfNoCase</code> は意味的には
<code class="directive"><a href="#setenvif">SetEnvIf</a></code> ディレクティブと
同じです。違いは、正規表現のマッチングが大文字小文字を区別しないで
行なわれることです。例えば:</p>
<div class="example"><p><code>
SetEnvIfNoCase Host Apache\.Org site=apache
</code></p></div>
<p>これは HTTP リクエストヘッダにフィールド <code>Host:</code> が
あり、その値が <code>Apache.Org</code> や <code>apache.org</code>、
その他の大文字小文字の組み合わせであったときに <code>site</code>
環境変数を "<code>apache</code>" に設定します。</p>
</div>
</div>
<div class="bottomlang">
<p><span>言語: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_setenvif.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_setenvif.html" 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 2010 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>
</body></html>
|
