env.html.ja.utf8 revision c7ed811e89712261aaa4432198e331389044e1f8
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
4c1132f34493327abc632196f5876a89aa573687Bob Halley XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4c1132f34493327abc632196f5876a89aa573687Bob Halley This file is generated from xml source: DO NOT EDIT
4c1132f34493327abc632196f5876a89aa573687Bob Halley XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/images/favicon.ico" rel="shortcut icon" /></head>
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<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>
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley<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="./">バージョン
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache の環境変数</h1>
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<p><span>言語: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/ja/env.html" title="Japanese"> ja </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley<a href="/tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
c2bc56dc65b4b103a5600565680eb5f33fa4c90bMark Andrews 変数に情報を記憶する仕組みを提供しています。この情報はログ収集や
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley アクセス制御などのいろいろな操作を制御するために使うことができます。
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley これらの変数は CGI スクリプトなどの外部プログラムと通信するためにも
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley 使われます。この文書はそれらの変数の操作方法と使用方法をいくつか
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews システムによって制御されている環境変数と同じではありません。
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews 実際は、これらの変数は Apache の内部構造の中に記憶され、操作されています。
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews それらは、CGI や SSI スクリプトに渡されたときだけ、実際の
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews オペレーティングシステムの環境変数になります。サーバ自身が
c45abd11bb68005d8a5c56c14b16f4184c3e057dMichael Graff 実行されているオペレーティングシステムの環境を操作したい場合は、
c45abd11bb68005d8a5c56c14b16f4184c3e057dMichael Graff オペレーティングシステムのシェルが提供している標準の環境変数の
a685d9c3b608eb768d237f20e8e8b1c5d3902146David Lawrence 操作方法を使わなければなりません。</p>
81aea2f2d3eac0515eb29449977ad50752f42a39Mark Andrews<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#setting">環境変数の設定</a></li>
81aea2f2d3eac0515eb29449977ad50752f42a39Mark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#using">環境変数の使用</a></li>
81aea2f2d3eac0515eb29449977ad50752f42a39Mark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#special">特別な目的の環境変数</a></li>
81aea2f2d3eac0515eb29449977ad50752f42a39Mark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#examples">例</a></li>
81aea2f2d3eac0515eb29449977ad50752f42a39Mark Andrews<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington<h2><a name="setting" id="setting">環境変数の設定</a></h2>
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="/mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="/mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="/mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="/mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington <h3><a name="basic-manipulation" id="basic-manipulation">基本的な環境の操作</a></h3>
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington <p>Apache において環境変数を設定する一番基本的な方法は、
93d6dfaf66258337985427c86181f01fc51f0bb4Mark Andrews 無条件に環境変数を設定する <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブを使用することです。
28b863e609ff2d97b78663b46894494cfa2ea411Mark Andrews <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code>
28b863e609ff2d97b78663b46894494cfa2ea411Mark Andrews ディレクティブにより、Apache が起動されたシェルの
3cd88f71b01833d5c2474638854dfa5c4244a22aBrian Wellington 環境変数を渡すこともできます。</p>
850d70818503ca1b0f98c9c70b16b51e789fd705Andreas Gustafsson <h3><a name="conditional" id="conditional">リクエスト毎に条件に基づいて設定する</a></h3>
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews <p>より柔軟性を高めるために、mod_setenvif
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley で提供されているディレクティブを使用することで、リクエストの
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence 特性に基づいて環境変数を設定することができます。例えば、特定のブラウザ
49a940dc68b30d9e4f9e1bd3c0503d8b90bb1726Mark Andrews (User-Agent) のリクエストや特定の Referer [意図的な綴りです]
6017f424ee3c02d7f22132c77576ea38542fa949Andreas Gustafsson <span class="transnote">(<em>訳注:</em> 正しい綴りは referrer ですが、HTTP の仕様では Referer
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington となっています)</span>ヘッダが見つかったときのみ変数を設定することができます。
0b09763c354ec91fb352b6b4cea383bd0195b2d8Mark Andrews mod_rewrite の <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington オプションを使用することで、
93d6dfaf66258337985427c86181f01fc51f0bb4Mark Andrews より柔軟な設定を行なうことができます。</p>
3cd88f71b01833d5c2474638854dfa5c4244a22aBrian Wellington <h3><a name="unique-identifiers" id="unique-identifiers">一意な識別子</a></h3>
850d70818503ca1b0f98c9c70b16b51e789fd705Andreas Gustafsson <p>mod_unique_id は、非常に限られた条件の下で
18d110413cf6416eb339c169b99159d09f690da1Brian Wellington 「すべて」のリクエストについて、一意であることが保証されている値を環境変数
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews <h3><a name="standard-cgi" id="standard-cgi">標準 CGI 変数</a></h3>
d2b5fe92a4755ce67f2dd6050955782b4fd6b3f3Mark Andrews <p>Apache の設定ファイルで設定された環境変数とシェルから渡される
d2b5fe92a4755ce67f2dd6050955782b4fd6b3f3Mark Andrews 環境変数に加えて、CGI スクリプトと SSI ページには <a href="http://cgi-spec.golux.com">CGI の仕様</a>で要求されている、
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley リクエストのメタ情報を持った環境変数の組が提供されます。</p>
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews <h3><a name="caveats" id="caveats">いくつかの注意</a></h3>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley <li>環境を操作するディレクティブを使って標準 CGI
139154bd9894495042f4e748f554e9c8b98b7598Bob Halley 変数を上書きしたり変更したりすることはできません。</li>
193738b819e3c699f9edd18864a6810fcfcec855Andreas Gustafsson <li>CGI スクリプトを起動するために <code class="program"><a href="/programs/suexec.html">suexec</a></code>
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence が使用されている場合、CGI スクリプトが起動するために、環境変数は<em>安全</em>な環境変数の組に整理されます。
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley で定義されます。</li>
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews <li>移植性のために、環境変数の名前はアルファベット、
9f7d51ee3290e2a064d71016a6bd555b47134a7cMark Andrews 数字とアンダースコア <span class="transnote">(<em>訳注:</em> '_')</span> だけから成ります。
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley さらに、最初の文字は数字であってはいけません。
881702c9c0079cd48a45054fd90d043f3a8b7e11Mark Andrews この制限に合わない文字は CGI スクリプトと SSI
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley ページに渡されるときにアンダースコアに置換されます。</li>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <li><code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> はリクエスト処理の
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley 段階の中でも遅くに実行されます。つまり
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> や
922e6a3c2ac4ef900dd9dc99f0cc137f18372583Andreas Gustafsson <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley などからは、変数がそこで設定されていることがわかりません。</li>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence<h2><a name="using" id="using">環境変数の使用</a></h2>
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="/mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="/mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="/mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="/mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="/mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="/mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="/mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews <h3><a name="cgi-scripts" id="cgi-scripts">CGI スクリプト</a></h3>
6d831cd0baf7dd2c133f7f9cbf295f3d80cf63a7David Lawrence <p>環境変数の主な利用法の一つは、CGI スクリプトに情報を伝えることです。
6d831cd0baf7dd2c133f7f9cbf295f3d80cf63a7David Lawrence 上で説明されているように、CGI スクリプトに渡される環境変数は Apache
dac2799ea19735503a4d27f517d821aea210e594Andreas Gustafsson の設定により設定される変数に加えて、リクエストの標準のメタ情報を含んでいます。
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews を参照してください。</p>
6d7585b3e948dd31bf78321d83ac0e024f44a71bMark Andrews <h3><a name="ssi-pages" id="ssi-pages">SSI ページ</a></h3>
6d7585b3e948dd31bf78321d83ac0e024f44a71bMark Andrews <p>mod_include の <code>INCLUDES</code> フィルタで処理される
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley 要素を使用すると環境変数が出力されます。
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley また、ページのある部分がリクエストの性質に応じて変更されるように、
94a3bcd132e515b4baa0884ba9dd0f361d2e17bcMark Andrews 環境変数をフロー制御要素で使うことができます。詳細は
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley <a href="howto/ssi.html">SSI チュートリアル</a> を参照してください。</p>
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews <h3><a name="access-control" id="access-control">アクセス制御</a></h3>
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews <p><code>allow from env=</code> ディレクティブと <code>deny from env=</code>
9f7d51ee3290e2a064d71016a6bd555b47134a7cMark Andrews ディレクティブを使用して、サーバへのアクセスを環境変数の値で制御することができます。
bb556a9bf3a15c7160fa4f1b71773ce12b1bedf6Bob Halley <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley ディレクティブと組み合わせることで、クライアントの特性に基づいて
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley サーバへのアクセス制御を柔軟に行なうことができるようになります。
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley たとえば、これらのディレクティブを使用して、特定のブラウザ (User-Agent)
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley からのアクセスを拒否することができます。</p>
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews <h3><a name="logging" id="logging">条件付きログ記録</a></h3>
<p><code class="directive"><a href="/mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code>
ディレクティブを使いますが、たとえば <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブや <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code> ディレクティブも使用することができます。</p>
<p>これが設定されている場合は、<code class="directive"><a href="/mod/core.html#keepalive">KeepAlive</a></code> を使用しないようにします。</p>
<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</a></h3>
httpd.conf に次の行を加えるよう推奨されていましたが、
# The first directive disables keepalive for Netscape 2.x and browsers that
SetEnvIf Referer "^http://www\.example\.com/" local_referal
「<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Keeping Your Images from Adorning Other Sites</a>
<p><span>言語: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<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>