1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>URL からファイルシステム上の位置へのマップ - Apache HTTP サーバ</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
12 <script src="./style/scripts/prettify.js" type="text/javascript">
15 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
16 <body id="manual-page"><div id="page-header">
17 <p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
18 <p class="apache">Apache HTTP サーバ バージョン 2.5</p>
19 <img alt="" src="./images/feather.gif" /></div>
20 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
22 <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.5</a></div><div id="page-content"><div id="preamble"><h1>URL からファイルシステム上の位置へのマップ</h1>
24 <p><span>翻訳済み言語: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
25 <a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
26 <a href="./ja/urlmapping.html" title="Japanese"> ja </a> |
27 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
28 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
30 <div class="outofdate">この日本語訳はすでに古くなっている
32 最近更新された内容を見るには英語版をご覧下さい。
35 <p>この文書は Apache がリクエストの URL から送信するファイルの
36 ファイルシステム上の位置を決定する方法を説明します。</p>
38 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">関連するモジュールとディレクティブ</a></li>
39 <li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
40 <li><img alt="" src="./images/down.gif" /> <a href="#outside">DocumentRoot 外のファイル</a></li>
41 <li><img alt="" src="./images/down.gif" /> <a href="#user">ユーザディレクトリ</a></li>
42 <li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL リダイレクション</a></li>
43 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">リバースプロキシ</a></li>
44 <li><img alt="" src="./images/down.gif" /> <a href="#rewrite">リライトエンジン</a></li>
45 <li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
46 </ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div>
47 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
49 <h2><a name="related" id="related">関連するモジュールとディレクティブ</a></h2>
51 <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</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_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</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#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
52 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
54 <h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
56 <p>リクエストに対してどのファイルを送信するかを決定するときの
57 Apache のデフォルトの動作は、リクエストの URL-Path (URL のホスト名と
58 ポート番号の後に続く部分) を取り出して設定ファイルで指定されている
59 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
60 の最後に追加する、というものです。ですから、
61 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
62 の下のディレクトリやファイルがウェブから見える基本のドキュメントの木構造を
65 <p>Apache にはサーバが複数のホストへのリクエストを受け取る
66 <a href="vhosts/">バーチャルホスト</a> の機能もあります。
67 この場合、それぞれのバーチャルホストに対して違う
68 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
69 を指定することができます。また、<code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
70 モジュールにより提供されるディレクティブを使って、
71 送信するためのコンテンツの場所をリクエストされた IP
72 アドレスやホスト名から動的に決めることもできます。</p>
73 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
75 <h2><a name="outside" id="outside">DocumentRoot 外のファイル</a></h2>
78 厳密には <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
79 の下にはない部分へのウェブアクセスを許可する必要がある
80 場合がよくあります。Apache はこのために複数の方法を用意しています。
81 Unix システムでは、ファイルシステムの他の部分をシンボリックリンクを
82 使って <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
83 の下に持ってくることができます。セキュリティ上の理由により、
85 <code class="directive"><a href="./mod/core.html#options">Options</a></code> の設定に
86 <code>FollowSymLinks</code> か <code>SymLinksIfOwnerMatch</code> が
87 ある場合にのみシンボリックリンクをたどります。</p>
89 <p>代わりの方法として、<code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code>
90 ディレクティブを使ってファイルシステムの任意の部分をウェブの空間に
93 <div class="example"><p><code>Alias /docs /var/web</code></p></div>
96 <code>http://www.example.com/docs/dir/file.html</code> には
97 <code>/var/web/dir/file.html</code> が送信されます。
98 <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> も、
99 対象となっているパスが CGI スクリプトとして扱われるという追加の
103 <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ディレクティブや
104 <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code> ディレクティブ
105 を使って強力な正規表現に基づいたマッチと置換を行なうことができます。
108 <div class="example"><p><code>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
109 /home/$1/cgi-bin/$2</code></p></div>
111 <p>は <code>http://example.com/~user/cgi-bin/script.cgi</code> への
112 リクエストを <code>/home/user/cgi-bin/script.cgi</code> というパスへ
113 マップし、このマップの結果としてのファイルを CGI スクリプトとして
115 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
116 <div class="section">
117 <h2><a name="user" id="user">ユーザディレクトリ</a></h2>
119 <p>伝統的に Unix システムではユーザ <em>user</em> のホームディレクトリを
120 <code>~user/</code> として参照できます。<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
122 それぞれのユーザのホームディレクトリのファイルを
123 以下のような URL を使ってアクセスできるようにします。</p>
125 <div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
127 <p>セキュリティの観点から、ウェブからユーザのホームディレクトリへ
128 直接アクセスできるようにすることは適切ではありません。ですから、
129 <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブには
130 ユーザのホームディレクトリの下の、ウェブファイルの
131 置かれているディレクトリを指定します。デフォルトの設定の
132 <code>Userdir public_html</code> を使うと、上の URL は
133 <code>/home/user/public_html/file.html</code> というようなファイルに
134 マップされます。ここで、<code>/home/user/</code> は
135 <code>/etc/passwd</code> で指定されているユーザのホームディレクトリです。</p>
137 <p><code class="directive"><a href="./mod/mod_userdir.html#userdir">Userdir</a></code> には、
138 <code>/etc/passwd</code> にホームディレクトリの位置が書かれていない
139 システムでも使うことのできる他の形式もあります。</p>
141 <p>中にはシンボル "~" (<code>%7e</code> のように符号化されることが多い)
142 を格好が悪いと思って、ユーザのディレクトリを表すために別の文字列の
143 使用を好む人がいます。mod_userdir はこの機能をサポートしていません。
144 しかし、ユーザのホームディレクトリが規則的な構成のときは、
145 <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> を使って望みの
147 <code>http://www.example.com/upages/user/file.html</code> が
148 <code>/home/user/public_html/file.html</code> にマップされるようにするには、
149 以下のように <code>AliasMatch</code> ディレクティブを使います:</p>
151 <div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
152 /home/$1/public_html/$2</code></p></div>
153 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
154 <div class="section">
155 <h2><a name="redirect" id="redirect">URL リダイレクション</a></h2>
157 <p>上の節で説明した設定用のディレクティブは Apache に
158 ファイルシステムの特定の場所からコンテンツを取ってきて
159 クライアントに送り返すようにします。ときには、その代わりに
160 クライアントにリクエストされたコンテンツは別の URL にあることを
161 知らせて、クライアントが新しい URL へ新しいリクエストを行なうように
162 する方が望ましいことがあります。これは<em>リダイレクション</em>と
163 呼ばれていて、<code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code>
164 ディレクティブにより実装されています。たとえば、
165 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> の下のディレクトリ
166 <code>/foo/</code> が新しいディレクトリ <code>/bar/</code> に移動したときは、
167 以下のようにしてクライアントが新しい場所のコンテンツをリクエストするように
170 <div class="example"><p><code>Redirect permanent /foo/
171 http://www.example.com/bar/</code></p></div>
173 <p>これは、<code>/foo/</code> で始まるすべての URL-Path を、
174 <code>www.example.com</code> サーバの <code>/bar/</code> が
175 <code>/foo/</code> に置換されたものにリダイレクトします。
176 サーバは自分自身のサーバだけでなく、どのサーバにでもクライアントを
179 <p>Apache はより複雑な書き換えの問題のために、
180 <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> ディレクティブを
181 提供しています。たとえば、サイトのホームページを違うサイトにリダイレクト
182 するけれど、他のリクエストはそのまま扱う、というときは以下の設定を
185 <div class="example"><p><code>RedirectMatch permanent ^/$
186 http://www.example.com/startpage.html</code></p></div>
188 <p>あるいは、一時的にサイトのすべてのページを他のサイトの特定の
189 ページへリダイレクトするときは、以下を使います:</p>
191 <div class="example"><p><code>RedirectMatch temp .*
192 http://othersite.example.com/startpage.html</code></p></div>
193 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
194 <div class="section">
195 <h2><a name="proxy" id="proxy">リバースプロキシ</a></h2>
197 <p>Apache は遠隔地にあるドキュメントをローカルのサーバの URL 空間に
198 持ってくることもできます。この手法は<em>リバースプロキシ</em>と呼ばれています。
199 ウェブサーバが遠隔地のドキュメントを取得してクライアントに送り返すのが
200 プロキシサーバの動作のように見えるからです。クライアントにはドキュメントが
201 リバースプロキシサーバから送られてきているように見える点が通常の
204 <p>次の例では、クライアントが <code>/foo/</code> ディレクトリの下にある
205 ドキュメントをリクエストすると、サーバが <code>internal.example.com</code> の
206 <code>/bar/</code> ディレクトリから取得して、さもローカルサーバからの
207 ドキュメントのようにしてクライアントに返します。</p>
209 <div class="example"><p><code>
210 ProxyPass /foo/ http://internal.example.com/bar/<br />
211 ProxyPassReverse /foo/ http://internal.example.com/bar/<br />
212 ProxyPassReverseCookieDomain internal.example.com public.example.com<br />
213 ProxyPassReverseCookiePath /foo/ /bar/
216 <p><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> ディレクティブは
217 サーバが適切なドキュメントを取得するように設定し、
218 <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> ディレクティブは
219 <code>internal.example.com</code> からのリダイレクトがローカルサーバの
220 適切なディレクトリを指すように書き換えます。
221 同様に <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
222 と <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
223 でバックエンド側サーバの発行した Cookie を書き換えることができます。</p>
224 <p>ただし、ドキュメントの中のリンクは書き換えられない、
226 ですから、<code>internal.example.com</code> への絶対パスによるリンクでは、
227 クライアントがプロキシサーバを抜け出して <code>internal.example.com</code> に
228 直接リクエストを送る、ということになります。
229 サードパーティ製モジュールの <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
230 は、HTML と XHTML 中のリンクを書き換えることができます。</p>
231 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
232 <div class="section">
233 <h2><a name="rewrite" id="rewrite">リライトエンジン</a></h2>
235 <p>より一層強力な置換が必要なときは、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
236 が提供するリライトエンジンが役に立つでしょう。
237 このモジュールにより提供されるディレクティブは
238 ブラウザの種類、リクエスト元の IP アドレスなどのリクエストの特徴を
239 使って送り返すコンテンツの場所を決めます。さらに、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
240 は外部のデータベースファイルやプログラムを使ってリクエストの扱い方を
241 決めることもできます。リライトエンジンは上で挙げられている三つのマッピング
242 すべてを行なうことができます: 内部のリダイレクト (エイリアス)、
243 外部のリダイレクト、プロキシです。mod_rewrite を使う多くの実用的な例は
244 <a href="misc/rewriteguide.html">URL リライトガイド</a>
246 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
247 <div class="section">
248 <h2><a name="notfound" id="notfound">File Not Found</a></h2>
250 <p>必ず、リクエストされた URL に対応するファイルがファイルシステムに
251 無いという場合が発生します。これが起こるのにはいくつかの理由があります。
252 場合によっては、ドキュメントを別の場所に移動した結果であることがあります。
253 この場合は、クライアントにリソースの新しい位置を知らせるために
254 <a href="#redirect">URL リダイレクション</a>を使うのが最善の方法です。
255 そうすることによって、リソースは新しい位置に移動しているけれども、
256 古いブックマークやリンクが動作し続けるようにすることができます。</p>
258 <p>"File Not Found" エラーのもう一つのよくある理由は、
259 ブラウザへの直接入力や HTML リンクからの偶発的な URL の入力間違いです。
260 Apache はこの問題を改善するために、<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code>
262 (訳注: 正しくは spelling) を提供しています。このモジュールが
263 使用されているときは、"File Not Found" エラーを横取りして、
264 似たファイル名のリソースを探します。もし一つだけ見つかった場合は
265 mod_speling はクライアントに正しい位置を知らせるために HTTP リダイレクトを
266 送ります。もし複数の「近い」ファイルが見つかった場合は、それら
267 代替となりえるもののリストがクライアントに表示されます。</p>
269 <p>mod_speling の非常に有用な機能は、大文字小文字を区別せずに
270 ファイル名を比較するものです。これは URL と unix の
271 ファイルシステムが両方とも大文字小文字を区別するものである、
272 ということをユーザが知らないシステムで役に立ちます。ただし、
273 時折の URL 訂正程度で済まず、mod_speling をより多く使用すると、サーバに
274 さらなる負荷がかかります。すべての「正しくない」リクエストの後に
275 URL のリダイレクトとクライアントからの新しいリクエストがくることに
278 <p>コンテンツの位置を決めようとするすべての試みが失敗すると、
279 Apache は、HTTP ステータスコード 404 (file not found) と共に
280 エラーページを返します。このエラーページの外観は
281 <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
283 <a href="custom-error.html">カスタムエラーレスポンス</a> で
284 説明されているように、柔軟な設定を行なうことができます。</p>
286 <div class="bottomlang">
287 <p><span>翻訳済み言語: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
288 <a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
289 <a href="./ja/urlmapping.html" title="Japanese"> ja </a> |
290 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
291 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
292 </div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
293 <script type="text/javascript"><!--//--><![CDATA[//><!--
294 var comments_shortname = 'httpd';
295 var comments_identifier = 'http://httpd.apache.org/docs/trunk/urlmapping.html';
297 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
298 d.write('<div id="comments_thread"><\/div>');
299 var s = d.createElement('script');
300 s.type = 'text/javascript';
302 s.src = 'https://c.apaste.info/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
303 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
306 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
308 })(window, document);
309 //--><!]]></script></div><div id="footer">
310 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
311 <p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
312 if (typeof(prettyPrint) !== 'undefined') {