rubbos/app/httpd-2.0.64/docs/manual/urlmapping.html.ja.utf8

   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
   7       -->
   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" />
  12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <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>
  15 <p class="apache">Apache HTTP サーバ バージョン 2.0</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="./">バージョン 2.0</a></div><div id="page-content"><div id="preamble"><h1>URL からファイルシステム上の位置へのマップ</h1>
  20 <div class="toplang">
  21 <p><span>Available Languages: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./ja/urlmapping.html" title="Japanese">&nbsp;ja&nbsp;</a> |
  23 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  24 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  25 </div>
  26
  27     <p>この文書は Apache がリクエストの URL から送信するファイルの
  28     ファイルシステム上の位置を決定する方法を説明します。</p>
  29   </div>
  30 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">関連するモジュールとディレクティブ</a></li>
  31 <li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
  32 <li><img alt="" src="./images/down.gif" /> <a href="#outside">DocumentRoot 外のファイル</a></li>
  33 <li><img alt="" src="./images/down.gif" /> <a href="#user">ユーザディレクトリ</a></li>
  34 <li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL リダイレクション</a></li>
  35 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">リバースプロキシ</a></li>
  36 <li><img alt="" src="./images/down.gif" /> <a href="#rewrite">リライトエンジン</a></li>
  37 <li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
  38 </ul></div>
  39 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  40 <div class="section">
  41 <h2><a name="related" id="related">関連するモジュールとディレクティブ</a></h2>
  42
  43 <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_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>
  44 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  45 <div class="section">
  46 <h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
  47
  48     <p>リクエストに対してどのファイルを送信するかを決定するときの
  49     Apache のデフォルトの動作は、リクエストの URL-Path (URL のホスト名と
  50     ポート番号の後に続く部分) を取り出して設定ファイルで指定されている
  51     <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
  52     の最後に追加する、というものです。ですから、
  53     <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
  54     の下のディレクトリやファイルがウェブから見える基本のドキュメントの木構造を
  55     なします。</p>
  56
  57     <p>Apache にはサーバが複数のホストへのリクエストを受け取る
  58     <a href="vhosts/">バーチャルホスト</a> の機能もあります。
  59     この場合、それぞれのバーチャルホストに対して違う
  60     <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
  61     を指定することができます。また、<code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
  62     モジュールにより提供されるディレクティブを使って、
  63     送信するためのコンテンツの場所をリクエストされた IP
  64     アドレスやホスト名から動的に決めることもできます。</p>
  65 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  66 <div class="section">
  67 <h2><a name="outside" id="outside">DocumentRoot 外のファイル</a></h2>
  68
  69     <p>ファイルシステム上の、
  70     厳密には <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
  71     の下にはない部分へのウェブアクセスを許可する必要がある
  72     場合がよくあります。Apache はこのために複数の方法を用意しています。
  73     Unix システムでは、ファイルシステムの他の部分をシンボリックリンクを
  74     使って <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
  75     の下に持ってくることができます。セキュリティ上の理由により、
  76     Apache は該当するディレクトリの
  77     <code class="directive"><a href="./mod/core.html#options">Options</a></code> の設定に
  78     <code>FollowSymLinks</code> か <code>SymLinksIfOwnerMatch</code> が
  79     ある場合にのみシンボリックリンクをたどります。</p>
  80
  81     <p>代わりの方法として、<code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code>
  82     ディレクティブを使ってファイルシステムの任意の部分をウェブの空間に
  83     マップできます。たとえば、</p>
  84
  85 <div class="example"><p><code>Alias /docs /var/web</code></p></div>
  86
  87     <p>という設定のときは、URL
  88     <code>http://www.example.com/docs/dir/file.html</code> には
  89     <code>/var/web/dir/file.html</code> が送信されます。
  90     <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> も、
  91     対象となっているパスが CGI スクリプトとして扱われるという追加の
  92     効果以外は同じように動作します。</p>
  93
  94     <p>もっと柔軟な設定が必要な状況では、
  95     <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ディレクティブや
  96     <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code> ディレクティブ
  97     を使って強力な正規表現に基づいたマッチと置換を行なうことができます。
  98     たとえば、</p>
  99
 100 <div class="example"><p><code>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
 101       /home/$1/cgi-bin/$2</code></p></div>
 102
 103     <p>は <code>http://example.com/~user/cgi-bin/script.cgi</code> への
 104     リクエストを <code>/home/user/cgi-bin/script.cgi</code> というパスへ
 105     マップし、このマップの結果としてのファイルを CGI スクリプトとして
 106     扱います。</p>
 107 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 108 <div class="section">
 109 <h2><a name="user" id="user">ユーザディレクトリ</a></h2>
 110
 111     <p>伝統的に Unix システムではユーザ <em>user</em> のホームディレクトリを
 112     <code>~user/</code> として参照できます。<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
 113     モジュールはこの概念をウェブに拡張して、
 114     それぞれのユーザのホームディレクトリのファイルを
 115     以下のような URL を使ってアクセスできるようにします。</p>
 116
 117 <div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
 118
 119     <p>セキュリティの観点から、ウェブからユーザのホームディレクトリへ
 120     直接アクセスできるようにすることは適切ではありません。ですから、
 121     <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブには
 122     ユーザのホームディレクトリの下の、ウェブファイルの
 123     置かれているディレクトリを指定します。デフォルトの設定の
 124     <code>Userdir public_html</code> を使うと、上の URL は
 125     <code>/home/user/public_html/file.html</code> というようなファイルに
 126     マップされます。ここで、<code>/home/user/</code> は
 127     <code>/etc/passwd</code> で指定されているユーザのホームディレクトリです。</p>
 128
 129     <p><code class="directive"><a href="./mod/mod_userdir.html#userdir">Userdir</a></code> には、
 130     <code>/etc/passwd</code> にホームディレクトリの位置が書かれていない
 131     システムでも使うことのできる他の形式もあります。</p>
 132
 133     <p>中にはシンボル "~" (<code>%7e</code> のように符号化されることが多い)
 134     を格好が悪いと思って、ユーザのディレクトリを表すために別の文字列の
 135     使用を好む人がいます。mod_userdir はこの機能をサポートしていません。
 136     しかし、ユーザのホームディレクトリが規則的な構成のときは、
 137     <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> を使って望みの
 138     効果を達成することができます。たとえば、
 139     <code>http://www.example.com/upages/user/file.html</code> が
 140     <code>/home/user/public_html/file.html</code> にマップされるようにするには、
 141     以下のように <code>AliasMatch</code> ディレクティブを使います:</p>
 142
 143 <div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
 144       /home/$1/public_html/$2</code></p></div>
 145 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 146 <div class="section">
 147 <h2><a name="redirect" id="redirect">URL リダイレクション</a></h2>
 148
 149     <p>上の節で説明した設定用のディレクティブは Apache に
 150     ファイルシステムの特定の場所からコンテンツを取ってきて
 151     クライアントに送り返すようにします。ときには、その代わりに
 152     クライアントにリクエストされたコンテンツは別の URL にあることを
 153     知らせて、クライアントが新しい URL へ新しいリクエストを行なうように
 154     する方が望ましいことがあります。これは<em>リダイレクション</em>と
 155     呼ばれていて、<code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code>
 156     ディレクティブにより実装されています。たとえば、
 157     <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> の下のディレクトリ
 158     <code>/foo/</code> が新しいディレクトリ <code>/bar/</code> に移動したときは、
 159     以下のようにしてクライアントが新しい場所のコンテンツをリクエストするように
 160     指示することができます:</p>
 161
 162 <div class="example"><p><code>Redirect permanent /foo/
 163       http://www.example.com/bar/</code></p></div>
 164
 165     <p>これは、<code>/foo/</code> で始まるすべての URL-Path を、
 166     <code>www.example.com</code> サーバの <code>/bar/</code> が
 167     <code>/foo/</code> に置換されたものにリダイレクトします。
 168     サーバは自分自身のサーバだけでなく、どのサーバにでもクライアントを
 169     リダイレクトすることができます。</p>
 170
 171     <p>Apache はより複雑な書き換えの問題のために、
 172     <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> ディレクティブを
 173     提供しています。たとえば、サイトのホームページを違うサイトにリダイレクト
 174     するけれど、他のリクエストはそのまま扱う、というときは以下の設定を
 175     使います:</p>
 176
 177 <div class="example"><p><code>RedirectMatch permanent ^/$
 178       http://www.example.com/startpage.html</code></p></div>
 179
 180     <p>あるいは、一時的にサイトのすべてのページを他のサイトの特定の
 181     ページへリダイレクトするときは、以下を使います:</p>
 182
 183 <div class="example"><p><code>RedirectMatch temp .*
 184       http://othersite.example.com/startpage.html</code></p></div>
 185 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 186 <div class="section">
 187 <h2><a name="proxy" id="proxy">リバースプロキシ</a></h2>
 188
 189 <p>Apache は遠隔地にあるドキュメントをローカルのサーバの URL 空間に
 190 持ってくることもできます。この手法は<em>リバースプロキシ</em>と呼ばれています。
 191 ウェブサーバが遠隔地のドキュメントを取得してクライアントに送り返すのが
 192 プロキシサーバの動作のように見えるからです。クライアントにはドキュメントが
 193 リバースプロキシサーバから送られてきているように見える点が通常の
 194 プロキシとは異なります。</p>
 195
 196 <p>次の例では、クライアントが <code>/foo/</code> ディレクトリの下にある
 197 ドキュメントをリクエストすると、サーバが <code>internal.example.com</code> の
 198 <code>/bar/</code> ディレクトリから取得して、さもローカルサーバからの
 199 ドキュメントのようにしてクライアントに返します。</p>
 200
 201 <div class="example"><p><code>
 202 ProxyPass /foo/ http://internal.example.com/bar/<br />
 203 ProxyPassReverse /foo/ http://internal.example.com/bar/
 204 </code></p></div>
 205
 206 <p><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> ディレクティブは
 207 サーバが適切なドキュメントを取得するように設定し、
 208 <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> ディレクティブは
 209 <code>internal.example.com</code> からのリダイレクトがローカルサーバの
 210 適切なディレクトリを指すように書き換えます。ただし、ドキュメントの中の
 211 リンクは書き換えられない、ということは知っておいてください。
 212 ですから、<code>internal.example.com</code> への絶対パスによるリンクでは、
 213 クライアントがプロキシサーバを抜け出して <code>internal.example.com</code> に
 214 直接リクエストを送る、ということになります。</p>
 215 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 216 <div class="section">
 217 <h2><a name="rewrite" id="rewrite">リライトエンジン</a></h2>
 218
 219     <p>より一層強力な置換が必要なときは、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
 220     が提供するリライトエンジンが役に立つでしょう。
 221     このモジュールにより提供されるディレクティブは
 222     ブラウザの種類、リクエスト元の IP アドレスなどのリクエストの特徴を
 223     使って送り返すコンテンツの場所を決めます。さらに、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
 224     は外部のデータベースファイルやプログラムを使ってリクエストの扱い方を
 225     決めることもできます。リライトエンジンは上で挙げられている三つのマッピング
 226     すべてを行なうことができます: 内部のリダイレクト (エイリアス)、
 227     外部のリダイレクト、プロキシです。mod_rewrite を使う多くの実用的な例は
 228     <a href="misc/rewriteguide.html">URL リライトガイド</a>
 229     で説明されています。</p>
 230 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 231 <div class="section">
 232 <h2><a name="notfound" id="notfound">File Not Found</a></h2>
 233
 234     <p>必ず、リクエストされた URL に対応するファイルがファイルシステムに
 235     無いという場合が発生します。これが起こるのにはいくつかの理由があります。
 236     場合によっては、ドキュメントを別の場所に移動した結果であることがあります。
 237     この場合は、クライアントにリソースの新しい位置を知らせるために
 238     <a href="#redirect">URL リダイレクション</a>を使うのが最善の方法です。
 239     そうすることによって、リソースは新しい位置に移動しているけれども、
 240     古いブックマークやリンクが動作し続けるようにすることができます。</p>
 241
 242     <p>"File Not Found" エラーのもう一つのよくある理由は、
 243     ブラウザへの直接入力や HTML リンクからの偶発的な URL の入力間違いです。
 244     Apache はこの問題を改善するために、<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code>
 245     モジュール (意図的な綴り間違い)
 246     (訳注: 正しくは spelling) を提供しています。このモジュールが
 247     使用されているときは、"File Not Found" エラーを横取りして、
 248     似たファイル名のリソースを探します。もし一つだけ見つかった場合は
 249     mod_speling はクライアントに正しい位置を知らせるために HTTP リダイレクトを
 250     送ります。もし複数の「近い」ファイルが見つかった場合は、それら
 251     代替となりえるもののリストがクライアントに表示されます。</p>
 252
 253     <p>mod_speling の非常に有用な機能は、大文字小文字を区別せずに
 254     ファイル名を比較するものです。これは URL と unix の
 255     ファイルシステムが両方とも大文字小文字を区別するものである、
 256     ということをユーザが知らないシステムで役に立ちます。ただし、
 257     時折の URL 訂正程度で済まず、mod_speling をより多く使用すると、サーバに
 258     さらなる負荷がかかります。すべての「正しくない」リクエストの後に
 259     URL のリダイレクトとクライアントからの新しいリクエストがくることに
 260     なりますから。</p>
 261
 262     <p>コンテンツの位置を決めようとするすべての試みが失敗すると、
 263     Apache は、HTTP ステータスコード 404 (file not found) と共に
 264     エラーページを返します。このエラーページの外観は
 265     <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
 266     ディレクティブで制御され、
 267     <a href="custom-error.html">カスタムエラーレスポンス</a> と
 268     <a href="misc/custom_errordocs.html">国際化サーバエラーレスポンス</a> で
 269     説明されているように、柔軟な設定を行なうことができます。</p>
 270 </div></div>
 271 <div class="bottomlang">
 272 <p><span>Available Languages: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 273 <a href="./ja/urlmapping.html" title="Japanese">&nbsp;ja&nbsp;</a> |
 274 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 275 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 276 </div><div id="footer">
 277 <p class="apache">Copyright 2009 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>
 278 <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>
 279 </body></html>