mod_setenvif - Apache HTTP サーババージョン 2.2

Apache Server 2.2

previous page next page

Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.2 > モジュール

Apache モジュール mod_setenvif

この日本語訳はすでに古くなっている可能性があります。最近更新された内容を見るには英語版をご覧下さい。

説明:	リクエストの特徴に基づいた環境変数の設定を可能にする
ステータス:	Base
モジュール識別子:	setenvif_module
ソースファイル:	mod_setenvif.c

概要

mod_setenvif モジュールは、リクエストのある側面が指定された正規表現に合うかどうかによって環境変数を設定する機能を提供します。これらの環境変数を使用して、サーバの他の部分がどのような動作をするかを決定することができます。

このモジュールが提供するディレクティブは、設定ファイルに現れる順番に適用されます。それを使って、次の例のようにより複雑な設定をすることができます。これは、ブラウザが mozilla ではあるけれど、MSIE ではないときに netscape を設定します。

BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape

参照

Apache の環境変数

BrowserMatch ディレクティブ

説明:	HTTP User-Agent に基づいて環境変数を設定する
構文:	`BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ...`
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	FileInfo
ステータス:	Base
モジュール:	mod_setenvif

BrowserMatch は SetEnvIf ディレクティブの特例で、User-Agent HTTP リクエストヘッダに基づいて環境変数を設定します。以下の 2 行の効果は同じになります:

BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot

その他の例:

BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript

BrowserMatchNoCase ディレクティブ

説明:	HTTP User-Agent に基づいて大文字小文字を区別せずに環境変数を設定する
構文:	`BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ...`
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	FileInfo
ステータス:	Base
モジュール:	mod_setenvif

BrowserMatchNoCase ディレクティブは意味的には BrowserMatch ディレクティブと同じです。ただし、このディレクティブは大文字小文字を区別しないマッチングを行ないます。例えば:

BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows

BrowserMatch ディレクティブと BrowserMatchNoCase ディレクティブは SetEnvIf ディレクティブと SetEnvIfNoCase ディレクティブの特例です。以下の 2 行の効果は同じです:

BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot

SetEnvIf ディレクティブ

説明:	リクエストの属性に基づいて環境変数を設定する
構文:	`SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ...`
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	FileInfo
ステータス:	Base
モジュール:	mod_setenvif

SetEnvIf ディレクティブは、リクエストの属性に基づいて環境変数を定義します。最初の引数で指定できる attribute は以下の三つのどれかです:

HTTP リクエストヘッダフィールド (詳しい情報は RFC 2616 を参照してください)。例えば、Host, User-Agent, Referer, Accept-Language です。リクエストヘッダの集合を表すために正規表現を使うこともできます。
以下のリクエストの一部分のどれか:
- Remote_Host - リクエストを行なっているクライアントのホスト名 (もしあれば)
- Remote_Addr - リクエストを行なっているクライアントの IP アドレス
- Server_Addr - リクエストを受け取ったサーバの IP アドレス (2.0.43 以降のみ)
- Request_Method - 使用されているメソッド名 (GET, POST など)
- Request_Protocol - リクエストが行なわれたプロトコルの名前とバージョン (例えば、"HTTP/0.9", "HTTP/1.1" など。)
- Request_URI - URL のスキームとホストの後の部分
リクエストと関連付けられる環境変数のリスト。これにより SetEnvIf ディレクティブが以前のマッチの結果を使うことができるようになります。この方法のテストでは前の部分にある SetEnvIf[NoCase] の結果のみを使用可能です。「前」とは、より広い範囲に対して定義されている (サーバ全体のように) か、現在のディレクティブの範囲でより前の部分で定義されているか、ということです。環境変数である可能性は、リクエストの特性に対するマッチが存在せず、 attribute に正規表現が使われなかったときにのみ考慮されます。

二つ目の引数 (regex) は正規表現です。 regex が attribute にマッチする場合は、残りの引数が評価されます。

残りの引数は設定する変数の名前で、設定される値を指定することもできます。これは、

varname
!varname
varname=value

のどれかの形式になります。

最初の形式では、値は "1" に設定されます。二つ目はもし値が定義されていればそれを取り除きます。三つ目は変数を value の与えられた値に設定します。 2.0.51 以降では、value 内に $1..$9 が存在すればそれを認識し、regex の対応する丸括弧で囲まれた部分で置換します。

例:

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\.com intra_site_referral : SetEnvIf object_is_image xbm XBIT_PROCESSING=1 : SetEnvIf ^TS* ^[a-z].* HAVE_TS

初めの三つはリクエストが画像であるときに環境変数 object_is_image を設定します。四つ目は参照元のページがウェブサイト www.mydomain.com にあるときに intra_site_referral を設定します。

最後の例は、リクエストに "TS" で始まり、値が集合 [a-z] のどれかで始まるヘッダがあるときに HAVE_TS を設定します。

参照

他の例は、Apache の環境変数

SetEnvIfNoCase ディレクティブ

説明:	リクエストの属性に基づいて大文字小文字を区別せずに環境変数を設定する
構文:	`SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ...`
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	FileInfo
ステータス:	Base
モジュール:	mod_setenvif

SetEnvIfNoCase は意味的には SetEnvIf ディレクティブと同じです。違いは、正規表現のマッチングが大文字小文字を区別しないで行なわれることです。例えば:

SetEnvIfNoCase Host Apache\.Org site=apache

これは HTTP リクエストヘッダにフィールド Host: があり、その値が Apache.Org や apache.org、その他の大文字小文字の組み合わせであったときに site 環境変数を "apache" に設定します。

previous page start next page

mod_setenvif - Apache HTTP サーバ バージョン 2.2