b3d2e587a32b409eca3ab23d1d1884d5199a8241kess<?xml version="1.0" encoding="UTF-8" ?>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess<manualpage metafile="env.xml.meta">

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>Apache の環境変数</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <summary>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p>Apache HTTP サーバは<em>環境変数</em>と呼ばれる、名前のついた

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 変数に情報を記憶する仕組みを提供しています。この情報はログ収集や

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess アクセス制御などのいろいろな操作を制御するために使うことができます。

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess これらの変数は CGI スクリプトなどの外部プログラムと通信するためにも

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 使われます。この文書はそれらの変数の操作方法と使用方法をいくつか

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 紹介します。</p>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <p>これらの変数は<em>環境変数</em>と呼ばれていますが、オペレーティング

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess システムによって制御されている環境変数と同じではありません。

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 実際は、これらの変数は Apache の内部構造の中に記憶され、操作されています。

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess それらは、CGI や SSI スクリプトに渡されたときだけ、実際の

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess オペレーティングシステムの環境変数になります。サーバ自身が

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 実行されているオペレーティングシステムの環境を操作したい場合は、

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess オペレーティングシステムのシェルが提供している標準の環境変数の

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 操作方法を使わなければなりません。</p>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess </summary>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <section id="setting">

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <title>環境変数の設定</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <related>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <modulelist>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <module>mod_env</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_rewrite</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_setenvif</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_unique_id</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </modulelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directivelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">BrowserMatch</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">BrowserMatchNoCase</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_env">PassEnv</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_rewrite">RewriteRule</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_env">SetEnv</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_setenvif">SetEnvIf</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">SetEnvIfNoCase</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_env">UnsetEnv</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </directivelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </related>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="basic-manipulation">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>基本的な環境の操作</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p>Apache において環境変数を設定する一番基本的な方法は、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 無条件に環境変数を設定する <directive module="mod_env"

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd >SetEnv</directive> ディレクティブを使用することです。

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_env">PassEnv</directive>

4b5b56aec9f41dcf656de6534178fd353efbd43bkess ディレクティブにより、Apache が起動されたシェルの

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 環境変数を渡すこともできます。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess </section>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <section id="conditional">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>リクエスト毎に条件に基づいて設定する</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p>より柔軟性を高めるために、mod_setenvif

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd で提供されているディレクティブを使用することで、リクエストの

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 特性に基づいて環境変数を設定することができます。例えば、特定のブラウザ

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess (User-Agent) のリクエストや特定の Referer [意図的な綴りです]

4b5b56aec9f41dcf656de6534178fd353efbd43bkess <transnote>正しい綴りは referrer ですが、HTTP の仕様では Referer

4b5b56aec9f41dcf656de6534178fd353efbd43bkess となっています</transnote>ヘッダが見つかったときのみ変数を設定することができます。

4b5b56aec9f41dcf656de6534178fd353efbd43bkess mod_rewrite の <directive module="mod_rewrite">RewriteRule</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess ディレクティブにおいて環境変数を設定する <code>[E=...]</code>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess オプションを使用することで、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd より柔軟な設定を行なうことができます。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="unique-identifiers">

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <title>一意な識別子</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <p>mod_unique_id は、非常に限られた条件の下で

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess 「すべて」のリクエストについて、一意であることが保証されている値を環境変数

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <code>UNIQUE_ID</code> に設定します。</p>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

cf02129aebf73dd0bdf369b172eb481ff76ac5f6colm <section id="standard-cgi">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>標準 CGI 変数</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p>Apache の設定ファイルで設定された環境変数とシェルから渡される

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 環境変数に加えて、CGI スクリプトと SSI ページには <a

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd href="http://cgi-spec.golux.com">CGI の仕様</a>で要求されている、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd リクエストのメタ情報を持った環境変数の組が提供されます。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="caveats">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>いくつかの注意</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <ul>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <li>環境を操作するディレクティブを使って標準 CGI

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 変数を上書きしたり変更したりすることはできません。</li>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <li>CGI スクリプトを起動するために <program>suexec</program>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess が使用されている場合、CGI スクリプトが起動するために、環境変数は<em

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess >安全</em>な環境変数の組に整理されます。

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess この安全な環境変数の集合は、コンパイル時に <code>suexec.c</code>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess で定義されます。</li>

0bc589dfa2c9a4dcf25245b47361bf6ff2fd6931nd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <li>移植性のために、環境変数の名前はアルファベット、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 数字とアンダースコア <transnote>'_'</transnote> だけから成ります。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd さらに、最初の文字は数字であってはいけません。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd この制限に合わない文字は CGI スクリプトと SSI

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ページに渡されるときにアンダースコアに置換されます。</li>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <li><directive module="mod_env">SetEnv</directive> はリクエスト処理の

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 段階の中でも遅くに実行されます。つまり

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">SetEnvIf</directive> や

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_rewrite">RewriteCond</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd などからは、変数がそこで設定されていることがわかりません。</li>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </ul>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="using">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>環境変数の使用</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <related>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <modulelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_authz_host</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_cgi</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_ext_filter</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_headers</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_include</module>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <module>mod_log_config</module>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <module>mod_rewrite</module>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess </modulelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directivelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_authz_host">Allow</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_log_config">CustomLog</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_authz_host">Deny</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_ext_filter">ExtFilterDefine</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_headers">Header</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_log_config">LogFormat</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_rewrite">RewriteCond</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <directive module="mod_rewrite">RewriteRule</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess </directivelist>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </related>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="cgi-scripts">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>CGI スクリプト</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <p>環境変数の主な利用法の一つは、CGI スクリプトに情報を伝えることです。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 上で説明されているように、CGI スクリプトに渡される環境変数は Apache

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd の設定により設定される変数に加えて、リクエストの標準のメタ情報を含んでいます。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 詳細は <a href="howto/cgi.html">CGI チュートリアル</a>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd を参照してください。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="ssi-pages">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>SSI ページ</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p>mod_include の <code>INCLUDES</code> フィルタで処理される

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd server-parsed (SSI) ドキュメントでは、<code>echo</code>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 要素を使用すると環境変数が出力されます。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd また、ページのある部分がリクエストの性質に応じて変更されるように、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 環境変数をフロー制御要素で使うことができます。詳細は

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <a href="howto/ssi.html">SSI チュートリアル</a> を参照してください。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="access-control">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>アクセス制御</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p><code>allow from env=</code> ディレクティブと <code>deny from env=</code>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ディレクティブを使用して、サーバへのアクセスを環境変数の値で制御することができます。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">SetEnvIf</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ディレクティブと組み合わせることで、クライアントの特性に基づいて

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd サーバへのアクセス制御を柔軟に行なうことができるようになります。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd たとえば、これらのディレクティブを使用して、特定のブラウザ (User-Agent)

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd からのアクセスを拒否することができます。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <section id="logging">

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <title>条件付きログ記録</title>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess <p><directive module="mod_log_config">LogFormat</directive>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess ディレクティブのオプション <code>%e</code>

4b5b56aec9f41dcf656de6534178fd353efbd43bkess を使用することで、環境変数をアクセスログに記録することができます。さらに、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_log_config">CustomLog</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ディレクティブの条件分岐式を使用することで、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 環境変数の値によってリクエストをログに記録するかどうかを決めることができます。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <directive module="mod_setenvif">SetEnvIf</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ディレクティブと組み合わせることで、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd どのリクエストをログに記録するかを柔軟に制御することが可能になります。たとえば、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <code>gif</code> で終わるファイル名へのリクエストはログに記録しない、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd 違うサブネットのクライアントからのリクエストだけをログに記録する、

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd という選択が可能です。</p>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd </section>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <section id="response-headers">

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <title>条件付き応答ヘッダ</title>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd <p><directive module="mod_headers">Header</directive>

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd ディレクティブは環境変数の存在や不在によってクライアントへの応答に特定の

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd HTTP ヘッダを付けるかどうかを決めることができます。

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd これにより、たとえば、クライアントからのリクエスト

8f7d6fc3a6ad107d66934d0d75ba4a5a095e1a3fnd にあるヘッダがある場合にのみ特定の応答ヘッダを送る、というようなことが

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess できます。</p>

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess

b3d2e587a32b409eca3ab23d1d1884d5199a8241kess </section>

<section id="external-filter">

<title>外部フィルタの適用</title>

<p><directive module="mod_ext_filter">ExtFilterDefine</directive>

ディレクティブを使用して

<module>mod_ext_filter</module> で設定される外部フィルタは、

<code>disableenv=</code> と <code>enableenv=</code>

オプションを使って、環境変数による条件付き適用ができます。</p>

</section>

<section id="url-rewriting">

<title>URL の書き換え</title>

<p><directive module="mod_rewrite">RewriteCond</directive>

ディレクティブで<em>評価文字列</em>として

<code>%{ENV:...}</code> 式を指定することで、mod_rewrite

の書き換えエンジンが環境変数に基いて条件分岐を行なうことができます。

mod_rewrite が使用可能な変数で <code>ENV:</code> が前についていない変数は、

実際は環境変数ではないということに注意してください。

それらは他のモジュールからは使用できない mod_rewrite 用の特別な変数です。

</p>

</section>

</section>

<section id="special">

<title>特別な目的の環境変数</title>

<p>互換性の問題を解決するために、特定のクライアントと通信しているときは

Apache の動作を変更できる機構が導入されました。できるだけ柔軟にするために、

これらの機構は環境変数を定義することで呼び出されます。普通は、

<directive module="mod_setenvif">BrowserMatch</directive>

ディレクティブを使いますが、たとえば <directive module="mod_env"

>SetEnv</directive> ディレクティブや <directive module="mod_env"

>PassEnv</directive> ディレクティブも使用することができます。</p>

<section id="downgrade">

<title>downgrade-1.0</title>

<p>これを指定することで、リクエストが HTTP/1.0

より新しいプロトコルの場合でも、HTTP/1.0 として扱われます。</p>

</section>

<section id="force-gzip">

<title>force-gzip</title>

<p><code>DEFLATE</code> フィルタが使用するように設定されているときに、

この環境変数はブラウザの accept-encoding の設定を無視して常に

圧縮された出力を送るようにします。</p>

</section>

<section id="force-no-vary">

<title>force-no-vary</title>

<p>応答ヘッダがクライアントに送られる前に <code>Vary</code>

フィールドを取り除きます。

クライアントの中にはこのフィールドを正しく解釈しないものがあります。

この変数を設定することでその問題を回避することができます。

この変数を設定すると、<strong>force-response-1.0</strong>

が設定されたことになります。</p>

</section>

<section id="force-response">

<title>force-response-1.0</title>

<p>これが設定されていると、HTTP/1.0 リクエストを発行するクライアントに対しては

常に HTTP/1.0 で応答するようになります。この機能は、

元々は AOL のプロキシの問題のために実装されました。HTTP/1.0 クライアントの中には、

HTTP/1.1 の応答を返されると正しく動作しないものがあるかもしれません。

この機能を使用することで、そのようなクライアントとの間の互換性問題を解決できます。</p>

</section>

<section id="gzip-only-text-html">

<title>gzip-only-text/html</title>

<p>これが 1 に設定されると、この変数は <code>text/html</code>

以外のコンテントタイプに対する、<module>mod_deflate</module>

提供の <code>DEFLATE</code> 出力フィルタを無効にします。

また、静的に、既に圧縮されたファイルを使用したい場合、

(gzip だけでなく、"identity" と異なる全てのエンコードに対して)

<module>mod_negotiation</module> も変数を評価します。</p>

</section>

<section id="no-gzip"><title>no-gzip</title>

<p>セットされると、<module>mod_deflate</module> の

<code>DEFLATE</code> フィルタがオフになります。

そして <module>mod_negotiation</module>

はエンコードされたリソースを送らないようにします。</p>

</section>

<section id="nokeepalive">

<title>nokeepalive</title>

<p>これが設定されている場合は、<directive module="core"

>KeepAlive</directive> を使用しないようにします。</p>

<section id="prefer-language"><title>prefer-language</title>

<p><module>mod_negotiation</module> の挙動に影響を与えます。

(<code>en</code>, <code>ja</code>, <code>x-klingon</code>といった)

言語タグが格納されていれば、その言語の variant を送信しようとします。

そのような variant がない場合は、

通常の<a href="content-negotiation.html">ネゴシエーション</a>処理が

適用されます。</p>

</section>

</section>

<section id="redirect-carefully">

<title>redirect-carefully</title>

<p>これはクライアントへのリダイレクトの送信をサーバがより注意深く

行なうようにします。

これは通常、リダイレクトに際してクライアントに

問題があることが分かっている場合に使われます。この機能は元々は

マイクロソフトのウェブフォルダのソフトが DAV

メソッドによるディレクトリのリソースへのリダイレクトの扱いに

問題がり、それを回避するために実装されました。</p>

</section>

<section id="suppress-error-charset">

<title>suppress-error-charset</title>

<p><em>Apache 2.2 以降で利用可能</em></p>

<p>クライアントのリクエストに対する応答としてリダイレクトを送信する際、

レスポンスにはリダイレクトが自動的に行なえない (行なわれない)

場合に表示するテキストが含まれます。

通常、このテキストに合致したキャラクタセット、ISO-8859-1

でラベル付けをします。</p>

<p>しかし、リダイレクト先が別の文字セットを使っている場合、

ある問題のあるブラウザのバージョンでは、

リダイレクト先の実際の文字セットの代わりに、

リダイレクト元の文字セットを使ってしまうことがあります。

その結果、例えば変な描画が行なわれたりして、読めなくなったりします。</p>

<p>この環境変数を設定することで、リダイレクションテキストに対する

キャラクタセットの指定を除去しますので、それら問題のあるブラウザでも

リダイレクト先の文字セットを正しく使うようにできます。</p>

<note type="warning">

<title>セキュリティ</title>

<p>文字セットを指定せずにエラーページを送信すると、

クロスサイトスクリプティング <transnote>XSS</transnote>

攻撃の危険性がでてきます。

HTTP/1.1 仕様に準拠していなくて、コンテンツの中身から文字セットを

"推測" しようとするブラウザ (MSIE) が実際にあるからです。

そのようなブラウザは UTF-7 文字セットを使って簡単に騙すことができます。

クロスサイトスクリプティング攻撃を防ぐために実装されている

通常のエスケープ機構が、入力データ中にある UTF-7 で

エンコードされたコンテンツ (リクエスト URI など) には

うまく動作しないからです。</p>

</note>

</section>

<section id="proxy"><title>force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</title>

<p>これらの指示子は <module>mod_proxy</module> の挙動を変更します。

詳細は <module>mod_proxy</module> のドキュメントをご参照ください。</p>

</section>

</section>

<section id="examples">

<title>例</title>

<section id="misbehaving">

<title>おかしな挙動をするクライアントに対してプロトコルの動作を変更する</title>

<p>クライアントに関する既知の問題に対処するために、以下の行を

httpd.conf に入れることを推奨しています。</p>

<p>古いバージョンの Apache では、クライアントの問題に対応するために

httpd.conf に次の行を加えるよう推奨されていましたが、

今となっては、問題としていたクライアントは実際には見かけることは

なくなってきたので、この設定はもはや必要ないかもしれません。</p>

<example><pre>

#

# The following directives modify normal HTTP response behavior.

# The first directive disables keepalive for Netscape 2.x and browsers that

# spoof it. There are known problems with these browser implementations.

# The second directive is for Microsoft Internet Explorer 4.0b2

# which has a broken HTTP/1.1 implementation and does not properly

# support keepalive when it is used on 301 or 302 (redirect) responses.

#

BrowserMatch "Mozilla/2" nokeepalive

BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0

#

# The following directive disables HTTP/1.1 responses to browsers which

# are in violation of the HTTP/1.0 spec by not being able to grok a

# basic 1.1 response.

#

BrowserMatch "RealPlayer 4\.0" force-response-1.0

BrowserMatch "Java/1\.0" force-response-1.0

BrowserMatch "JDK/1\.0" force-response-1.0</pre></example>

</section>

<section id="no-img-log">

<title>画像へのリクエストをアクセスログに記録しない</title>

<p>この例では、画像へのリクエストがアクセスログに現れないようにします。

これを変更することで、特定のディレクトリのログ収集をやめたり、

特定のホストからのリクエストのログ収集をやめたりすることが簡単にできます。

</p>

<example><pre>

SetEnvIf Request_URI \.gif image-request

SetEnvIf Request_URI \.jpg image-request

SetEnvIf Request_URI \.png image-request

CustomLog logs/access_log common env=!image-request</pre></example>

</section>

<section id="image-theft">

<title>「画像の盗用」を防ぐ</title>

<p>この例は、別のサーバにいる人が、あなたのサーバにある画像を

inline 画像として使用することを防ぎます。

これは推奨されている設定ではありませんが、ある限定された状況では有効です。

ここでは、すべての画像は <code>/web/images</code>

というディレクトリにあると仮定します。</p>

<example><pre>

SetEnvIf Referer "^http://www\.example\.com/" local_referal

# Allow browsers that do not send Referer info

SetEnvIf Referer "^$" local_referal

&lt;Directory /web/images&gt;

Order Deny,Allow

Deny from all

Allow from env=local_referal

&lt;/Directory&gt;</pre></example>

<p>この手法に関する詳しい情報は ServerWatch にあるチュートリアル

「<a href="http://www.serverwatch.com/tutorials/article.php/1132731"

>Keeping Your Images from Adorning Other Sites</a>

」を参照してください。</p>

</section>

</section>

</manualpage>