URL からファイルシステム上の位置へのマップ

翻訳済み言語: en | fr | ja | ko | tr

この日本語訳はすでに古くなっている可能性があります。最近更新された内容を見るには英語版をご覧下さい。

この文書は Apache がリクエストの URL から送信するファイルのファイルシステム上の位置を決定する方法を説明します。

関連するモジュールとディレクティブ
DocumentRoot
DocumentRoot 外のファイル
ユーザディレクトリ
URL リダイレクション
リバースプロキシ
リライトエンジン
File Not Found

参照

関連モジュール	関連ディレクティブ
`mod_alias` `mod_proxy` `mod_rewrite` `mod_userdir` `mod_speling` `mod_vhost_alias`	`Alias` `AliasMatch` `CheckSpelling` `DocumentRoot` `ErrorDocument` `Options` `ProxyPass` `ProxyPassReverse` `ProxyPassReverseCookieDomain` `ProxyPassReverseCookiePath` `Redirect` `RedirectMatch` `RewriteCond` `RewriteMatch` `ScriptAlias` `ScriptAliasMatch` `UserDir`

DocumentRoot

リクエストに対してどのファイルを送信するかを決定するときの Apache のデフォルトの動作は、リクエストの URL-Path (URL のホスト名とポート番号の後に続く部分) を取り出して設定ファイルで指定されている DocumentRoot の最後に追加する、というものです。ですから、 DocumentRoot の下のディレクトリやファイルがウェブから見える基本のドキュメントの木構造をなします。

Apache にはサーバが複数のホストへのリクエストを受け取るバーチャルホストの機能もあります。この場合、それぞれのバーチャルホストに対して違う DocumentRoot を指定することができます。また、mod_vhost_alias モジュールにより提供されるディレクティブを使って、送信するためのコンテンツの場所をリクエストされた IP アドレスやホスト名から動的に決めることもできます。

DocumentRoot 外のファイル

ファイルシステム上の、厳密には DocumentRoot の下にはない部分へのウェブアクセスを許可する必要がある場合がよくあります。Apache はこのために複数の方法を用意しています。 Unix システムでは、ファイルシステムの他の部分をシンボリックリンクを使って DocumentRoot の下に持ってくることができます。セキュリティ上の理由により、 Apache は該当するディレクトリの Options の設定に FollowSymLinks か SymLinksIfOwnerMatch がある場合にのみシンボリックリンクをたどります。

代わりの方法として、Alias ディレクティブを使ってファイルシステムの任意の部分をウェブの空間にマップできます。たとえば、

Alias /docs /var/web

という設定のときは、URL https://www.example.com/docs/dir/file.html には /var/web/dir/file.html が送信されます。 ScriptAlias も、対象となっているパスが CGI スクリプトとして扱われるという追加の効果以外は同じように動作します。

もっと柔軟な設定が必要な状況では、 AliasMatch ディレクティブや ScriptAliasMatch ディレクティブを使って強力な正規表現に基づいたマッチと置換を行なうことができます。たとえば、

ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+) /home/$1/cgi-bin/$2

は https://example.com/~user/cgi-bin/script.cgi へのリクエストを /home/user/cgi-bin/script.cgi というパスへマップし、このマップの結果としてのファイルを CGI スクリプトとして扱います。

ユーザディレクトリ

伝統的に Unix システムではユーザ user のホームディレクトリを ~user/ として参照できます。mod_userdir モジュールはこの概念をウェブに拡張して、それぞれのユーザのホームディレクトリのファイルを以下のような URL を使ってアクセスできるようにします。

https://www.example.com/~user/file.html

セキュリティの観点から、ウェブからユーザのホームディレクトリへ直接アクセスできるようにすることは適切ではありません。ですから、 UserDir ディレクティブにはユーザのホームディレクトリの下の、ウェブファイルの置かれているディレクトリを指定します。デフォルトの設定の Userdir public_html を使うと、上の URL は /home/user/public_html/file.html というようなファイルにマップされます。ここで、/home/user/ は /etc/passwd で指定されているユーザのホームディレクトリです。

Userdir には、 /etc/passwd にホームディレクトリの位置が書かれていないシステムでも使うことのできる他の形式もあります。

中にはシンボル "~" (%7e のように符号化されることが多い) を格好が悪いと思って、ユーザのディレクトリを表すために別の文字列の使用を好む人がいます。mod_userdir はこの機能をサポートしていません。しかし、ユーザのホームディレクトリが規則的な構成のときは、 AliasMatch を使って望みの効果を達成することができます。たとえば、 https://www.example.com/upages/user/file.html が /home/user/public_html/file.html にマップされるようにするには、以下のように AliasMatch ディレクティブを使います:

AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*) /home/$1/public_html/$2

URL リダイレクション

上の節で説明した設定用のディレクティブは Apache にファイルシステムの特定の場所からコンテンツを取ってきてクライアントに送り返すようにします。ときには、その代わりにクライアントにリクエストされたコンテンツは別の URL にあることを知らせて、クライアントが新しい URL へ新しいリクエストを行なうようにする方が望ましいことがあります。これはリダイレクションと呼ばれていて、Redirect ディレクティブにより実装されています。たとえば、 DocumentRoot の下のディレクトリ /foo/ が新しいディレクトリ /bar/ に移動したときは、以下のようにしてクライアントが新しい場所のコンテンツをリクエストするように指示することができます:

Redirect permanent /foo/ https://www.example.com/bar/

これは、/foo/ で始まるすべての URL-Path を、 www.example.com サーバの /bar/ が /foo/ に置換されたものにリダイレクトします。サーバは自分自身のサーバだけでなく、どのサーバにでもクライアントをリダイレクトすることができます。

Apache はより複雑な書き換えの問題のために、 RedirectMatch ディレクティブを提供しています。たとえば、サイトのホームページを違うサイトにリダイレクトするけれど、他のリクエストはそのまま扱う、というときは以下の設定を使います:

RedirectMatch permanent ^/$ https://www.example.com/startpage.html

あるいは、一時的にサイトのすべてのページを他のサイトの特定のページへリダイレクトするときは、以下を使います:

RedirectMatch temp .* https://othersite.example.com/startpage.html

リバースプロキシ

Apache は遠隔地にあるドキュメントをローカルのサーバの URL 空間に持ってくることもできます。この手法はリバースプロキシと呼ばれています。ウェブサーバが遠隔地のドキュメントを取得してクライアントに送り返すのがプロキシサーバの動作のように見えるからです。クライアントにはドキュメントがリバースプロキシサーバから送られてきているように見える点が通常のプロキシとは異なります。

次の例では、クライアントが /foo/ ディレクトリの下にあるドキュメントをリクエストすると、サーバが internal.example.com の /bar/ ディレクトリから取得して、さもローカルサーバからのドキュメントのようにしてクライアントに返します。

ProxyPass /foo/ https://internal.example.com/bar/ ProxyPassReverse /foo/ https://internal.example.com/bar/ ProxyPassReverseCookieDomain internal.example.com public.example.com ProxyPassReverseCookiePath /foo/ /bar/

ProxyPass ディレクティブはサーバが適切なドキュメントを取得するように設定し、 ProxyPassReverse ディレクティブは internal.example.com からのリダイレクトがローカルサーバの適切なディレクトリを指すように書き換えます。同様に ProxyPassReverseCookieDomain と ProxyPassReverseCookiePath でバックエンド側サーバの発行した Cookie を書き換えることができます。

ただし、ドキュメントの中のリンクは書き換えられない、ということは知っておいてください。ですから、internal.example.com への絶対パスによるリンクでは、クライアントがプロキシサーバを抜け出して internal.example.com に直接リクエストを送る、ということになります。サードパーティ製モジュールの mod_proxy_html は、HTML と XHTML 中のリンクを書き換えることができます。

リライトエンジン

より一層強力な置換が必要なときは、mod_rewrite が提供するリライトエンジンが役に立つでしょう。このモジュールにより提供されるディレクティブはブラウザの種類、リクエスト元の IP アドレスなどのリクエストの特徴を使って送り返すコンテンツの場所を決めます。さらに、mod_rewrite は外部のデータベースファイルやプログラムを使ってリクエストの扱い方を決めることもできます。リライトエンジンは上で挙げられている三つのマッピングすべてを行なうことができます: 内部のリダイレクト (エイリアス)、外部のリダイレクト、プロキシです。mod_rewrite を使う多くの実用的な例は URL リライトガイドで説明されています。

File Not Found

必ず、リクエストされた URL に対応するファイルがファイルシステムに無いという場合が発生します。これが起こるのにはいくつかの理由があります。場合によっては、ドキュメントを別の場所に移動した結果であることがあります。この場合は、クライアントにリソースの新しい位置を知らせるために URL リダイレクションを使うのが最善の方法です。そうすることによって、リソースは新しい位置に移動しているけれども、古いブックマークやリンクが動作し続けるようにすることができます。

"File Not Found" エラーのもう一つのよくある理由は、ブラウザへの直接入力や HTML リンクからの偶発的な URL の入力間違いです。 Apache はこの問題を改善するために、mod_speling モジュール (意図的な綴り間違い) (訳注: 正しくは spelling) を提供しています。このモジュールが使用されているときは、"File Not Found" エラーを横取りして、似たファイル名のリソースを探します。もし一つだけ見つかった場合は mod_speling はクライアントに正しい位置を知らせるために HTTP リダイレクトを送ります。もし複数の「近い」ファイルが見つかった場合は、それら代替となりえるもののリストがクライアントに表示されます。

mod_speling の非常に有用な機能は、大文字小文字を区別せずにファイル名を比較するものです。これは URL と unix のファイルシステムが両方とも大文字小文字を区別するものである、ということをユーザが知らないシステムで役に立ちます。ただし、時折の URL 訂正程度で済まず、mod_speling をより多く使用すると、サーバにさらなる負荷がかかります。すべての「正しくない」リクエストの後に URL のリダイレクトとクライアントからの新しいリクエストがくることになりますから。

コンテンツの位置を決めようとするすべての試みが失敗すると、 Apache は、HTTP ステータスコード 404 (file not found) と共にエラーページを返します。このエラーページの外観は ErrorDocument ディレクティブで制御され、カスタムエラーレスポンスで説明されているように、柔軟な設定を行なうことができます。