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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

44f575c8cb19a7a5cd61664a7848be6bc197df02fuankg

16b55a35cff91315d261d1baa776138af465c4e4fuankg<manualpage metafile="env.xml.meta">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>Apache の環境変数</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <summary>

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes 紹介します。</p>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </summary>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="setting">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <related>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <modulelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_env</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_rewrite</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_setenvif</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_unique_id</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </modulelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directivelist>

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_setenvif">BrowserMatchNoCase</directive>

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_setenvif">SetEnvIfNoCase</directive>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_env">UnsetEnv</directive>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </directivelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </related>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="basic-manipulation">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="conditional">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes mod_rewrite の <directive module="mod_rewrite">RewriteRule</directive>

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="unique-identifiers">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="standard-cgi">

0a39e7683f6611d66c55712f50bb240428d832a1bnicholes <title>標準 CGI 変数</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="caveats">

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg <title>いくつかの注意</title>

0662ed52e814f8f08ef0e09956413a792584eddffuankg

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <ul>

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_setenvif">SetEnvIf</directive> や

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </ul>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="using">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>環境変数の使用</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

0662ed52e814f8f08ef0e09956413a792584eddffuankg <related>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <modulelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_authz_host</module>

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg <module>mod_cgi</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_ext_filter</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_headers</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_include</module>

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg <module>mod_log_config</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <module>mod_rewrite</module>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </modulelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directivelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_authz_host">Allow</directive>

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_headers">Header</directive>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <directive module="mod_log_config">LogFormat</directive>

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </directivelist>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </related>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="cgi-scripts">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>CGI スクリプト</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="ssi-pages">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>SSI ページ</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="access-control">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>アクセス制御</title>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

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

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="logging">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

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

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

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

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

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

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

0cb770e9049c8e85ede0bbe3d47904785b15f868fuankg

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="response-headers">

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

609ef720afd62ca63391c9fdb415cd2faf29aa46bnicholes

609ef720afd62ca63391c9fdb415cd2faf29aa46bnicholes <p><directive module="mod_headers">Header</directive>

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

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

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

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

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg できます。</p>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="external-filter">

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

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg

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

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

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

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

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

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="url-rewriting">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

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

0662ed52e814f8f08ef0e09956413a792584eddffuankg </p>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes </section>

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <section id="special">

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

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

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

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

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

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

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

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

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes

0662ed52e814f8f08ef0e09956413a792584eddffuankg <section id="downgrade">

cb2846ded4de1abbb5934b92132baf826f1babfebnicholes <title>downgrade-1.0</title>

ac7985784d08a3655291f24f711812b4d8b1cbcffuankg

<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>