2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
a99c5d4cc3cab6a62b04d52000dbc22ce1fa2d94coar<!-- English Revision: 151408:1673945 (outdated) -->
031b91a62d25106ae69d4693475c79618dd5e884fielding Licensed to the Apache Software Foundation (ASF) under one or more
031b91a62d25106ae69d4693475c79618dd5e884fielding contributor license agreements. See the NOTICE file distributed with
031b91a62d25106ae69d4693475c79618dd5e884fielding this work for additional information regarding copyright ownership.
031b91a62d25106ae69d4693475c79618dd5e884fielding The ASF licenses this file to You under the Apache License, Version 2.0
031b91a62d25106ae69d4693475c79618dd5e884fielding (the "License"); you may not use this file except in compliance with
031b91a62d25106ae69d4693475c79618dd5e884fielding the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>ホストファイルシステム上のいろいろな違う場所を
208651a016b098f4fa1f6279559f104d70f1632dtakashi ドキュメントツリーにマップする機能と、
208651a016b098f4fa1f6279559f104d70f1632dtakashi URL のリダイレクトを行なう機能を提供する</description>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このモジュールのディレクティブはサーバにリクエストが到着したときに
208651a016b098f4fa1f6279559f104d70f1632dtakashi URL の操作や制御をすることを可能にします。<directive
208651a016b098f4fa1f6279559f104d70f1632dtakashi ディレクティブと <directive module="mod_alias">ScriptAlias</directive>
208651a016b098f4fa1f6279559f104d70f1632dtakashi URL とファイルシステムのパスをマップするために使用されます。これは
208651a016b098f4fa1f6279559f104d70f1632dtakashi の下にないドキュメントをウェブのドキュメントツリーの一部として
208651a016b098f4fa1f6279559f104d70f1632dtakashi 送られるようにします。<directive module="mod_alias">ScriptAlias</directive>
208651a016b098f4fa1f6279559f104d70f1632dtakashi ディレクティブにはマップ先のディレクトリが CGI
208651a016b098f4fa1f6279559f104d70f1632dtakashi スクリプトのみであることを示すという追加の効果があります。
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p><directive module="mod_alias">Redirect</directive> ディレクティブは
208651a016b098f4fa1f6279559f104d70f1632dtakashi URL に新しいリクエストを送るように指示します。これは、
208651a016b098f4fa1f6279559f104d70f1632dtakashi リソースが新しい場所に移動したときによく使用されます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p><module>mod_alias</module> は簡単な URL 操作向けに設計されています。
208651a016b098f4fa1f6279559f104d70f1632dtakashi で提供されるツールを使用してください。</p>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<seealso><module>mod_rewrite</module></seealso> <seealso><a
208651a016b098f4fa1f6279559f104d70f1632dtakashihref="/urlmapping.html">URL からファイルシステム上の位置へのマッピング</a></seealso>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<p>様々なコンテキスト中での Alias や Redirect は他のディレクティブと
208651a016b098f4fa1f6279559f104d70f1632dtakashi従って処理されます。ただし、(例えば <directive type="section" module="core"
208651a016b098f4fa1f6279559f104d70f1632dtakashi>VirtualHost</directive> セクションの中のように) 複数の Alias や Redirect が
208651a016b098f4fa1f6279559f104d70f1632dtakashi同じコンテキスト中に現れた場合は決まった順番で処理されます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashimodule="mod_alias">RedirectMatch</directive> にマッチするリクエストには
208651a016b098f4fa1f6279559f104d70f1632dtakashiAlias は決して適用されません。次に、Alias と Redirect が設定ファイル中の
208651a016b098f4fa1f6279559f104d70f1632dtakashi順番に適用され、最初にマッチしたものが優先されます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<p>ですから、二つ以上のディレクティブが同じパスに適用されるときは、
208651a016b098f4fa1f6279559f104d70f1632dtakashiすべてのディレクティブの効果を得るためにはより詳しいパスを先に書く
208651a016b098f4fa1f6279559f104d70f1632dtakashi必要があります。例えば、次の設定は期待通りの動作をします:</p>
c70d1c1ea5807b57db0a06ae4f01495bab2c630bkawaiAlias /foo /gaq
208651a016b098f4fa1f6279559f104d70f1632dtakashi<p>しかし、上記の二つのディレクティブの順番が逆になると、
208651a016b098f4fa1f6279559f104d70f1632dtakashi<code>/foo</code> <directive module="mod_alias">Alias</directive> が
208651a016b098f4fa1f6279559f104d70f1632dtakashimodule="mod_alias">Alias</directive> より先にマッチしますので、後者は
208651a016b098f4fa1f6279559f104d70f1632dtakashi決して適用されることはありません。</p>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<var>file-path</var>|<var>directory-path</var></syntax>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi ローカルファイルシステムの
208651a016b098f4fa1f6279559f104d70f1632dtakashi 以外の場所に保管することを可能にします。
208651a016b098f4fa1f6279559f104d70f1632dtakashi で始まるローカルファイルにマップされます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi を書いたなら、サーバがエイリアスを展開するためには、最後の /
208651a016b098f4fa1f6279559f104d70f1632dtakashi が必要になることに注意してください。すなわち、<code>Alias /icons/
208651a016b098f4fa1f6279559f104d70f1632dtakashi セクションを追加する必要があるかもしれないことに注意してください。
208651a016b098f4fa1f6279559f104d70f1632dtakashi エイリアスの展開は <directive
208651a016b098f4fa1f6279559f104d70f1632dtakashi セクションを調べる前に行なわれますので、
208651a016b098f4fa1f6279559f104d70f1632dtakashi エイリアスの行き先の <directive
208651a016b098f4fa1f6279559f104d70f1632dtakashi type="section" module="core">Directory</directive> セクションのみ
208651a016b098f4fa1f6279559f104d70f1632dtakashi (しかし、<directive
208651a016b098f4fa1f6279559f104d70f1632dtakashi セクションはエイリアスが処理される前に実行されますので、
208651a016b098f4fa1f6279559f104d70f1632dtakashi こちらは適用されます。)</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi ディレクトリの外側に配置した場合は、行き先のディレクトリに対する
208651a016b098f4fa1f6279559f104d70f1632dtakashi アクセス権限を明示的に制限しなければならないでしょう。</p>
07ab565873bfd241828a89261b1260c448a0799eyoshiki Order allow,deny<br />
07ab565873bfd241828a89261b1260c448a0799eyoshiki Allow from all<br />
07ab565873bfd241828a89261b1260c448a0799eyoshiki </Directory>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>正規表現を使って URL をファイルシステムの位置にマップする</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<var>file-path</var>|<var>directory-path</var></syntax>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このディレクティブは <directive module="mod_alias">Alias</directive>
208651a016b098f4fa1f6279559f104d70f1632dtakashi とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
208651a016b098f4fa1f6279559f104d70f1632dtakashi 標準正規表現を利用します。ここで指定された正規表現と URL のパス
208651a016b098f4fa1f6279559f104d70f1632dtakashi が合うかどうかを調べ、合う場合は括弧で括られたマッチを
208651a016b098f4fa1f6279559f104d70f1632dtakashi 与えられた文字列で置き換え、それをファイル名として使用します。たとえば、
208651a016b098f4fa1f6279559f104d70f1632dtakashi ためには以下のようなものが使用できます:</p>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>クライアントが違う URL を取得するように外部へのリダイレクトを
208651a016b098f4fa1f6279559f104d70f1632dtakashi送る</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<syntax>Redirect [<var>status</var>] <var>URL-path</var>
9dca5c120b818e1c51dbbb6c658d95a9f91b524cyoshiki<context>directory</context><context>.htaccess</context></contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>Redirect ディレクティブは古い URL を新しいものへマップします。
208651a016b098f4fa1f6279559f104d70f1632dtakashi 新しい URL がクライアントに返されます。そして、
208651a016b098f4fa1f6279559f104d70f1632dtakashi クライアントは新しいアドレスをもう一回取得しようとします。
208651a016b098f4fa1f6279559f104d70f1632dtakashi (% が符号化された) URL へのリダイレクトエラーが返されます。</p>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki Redirect /service http://foo2.bar.com/service
208651a016b098f4fa1f6279559f104d70f1632dtakashi へのリクエストを行なうと、代わりに http://foo2.bar.com/service/foo.txt
208651a016b098f4fa1f6279559f104d70f1632dtakashi をアクセスするように告げられます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashiRedirect 系のディレクティブは Alias
208651a016b098f4fa1f6279559f104d70f1632dtakashiディレクティブと ScriptAlias ディレクティブよりも優先されます。
208651a016b098f4fa1f6279559f104d70f1632dtakashiまた、.htaccess ファイルや <directive
208651a016b098f4fa1f6279559f104d70f1632dtakashi "temporary" (HTTP ステータス 302) になります。これはクライアントに
208651a016b098f4fa1f6279559f104d70f1632dtakashi 引数は 他の HTTP のステータスコードを返すために使用することができます:</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <dd>永久にリダイレクトをするステータス (301) を返します。
208651a016b098f4fa1f6279559f104d70f1632dtakashi これはリソースが永久に移動したということを意味します。</dd>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <dd>一時的なリダイレクトステータス (302)
208651a016b098f4fa1f6279559f104d70f1632dtakashi を返します。これがデフォルトです。</dd>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <dd>"See Other" ステータス (303) を返します。
208651a016b098f4fa1f6279559f104d70f1632dtakashi これはリソースが他のもので置き換えられたことを意味します。</dd>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <dd>"Gone" ステータス (410) を返します。これはリソースが永久に
208651a016b098f4fa1f6279559f104d70f1632dtakashi 削除されたことを意味します。このステータスが使用された場合、
208651a016b098f4fa1f6279559f104d70f1632dtakashi 他のステータスコードも返すことができます。ステータスが 300 と 399
208651a016b098f4fa1f6279559f104d70f1632dtakashi その他の場合は省略されていなければなりません。ただし、
208651a016b098f4fa1f6279559f104d70f1632dtakashi ステータスは Apache のコードが知っているものである必要があります
208651a016b098f4fa1f6279559f104d70f1632dtakashi (http_protocol.c の関数 <code>send_error_response</code>
208651a016b098f4fa1f6279559f104d70f1632dtakashi を見てください)。</p>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki Redirect permanent /one http://example.com/two<br />
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki Redirect 303 /three http://example.com/other
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>現在の URL への正規表現のマッチにより
208651a016b098f4fa1f6279559f104d70f1632dtakashi外部へのリダイレクトを送る</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<syntax>RedirectMatch [<var>status</var>] <var>regex</var>
9dca5c120b818e1c51dbbb6c658d95a9f91b524cyoshiki<context>directory</context><context>.htaccess</context></contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このディレクティブは <directive module="mod_alias">Redirect</directive>
208651a016b098f4fa1f6279559f104d70f1632dtakashi とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
208651a016b098f4fa1f6279559f104d70f1632dtakashi 標準正規表現を利用します。ここで指定された正規表現と URL-path
208651a016b098f4fa1f6279559f104d70f1632dtakashi が合うかどうかを調べ、合う場合は括弧で括られたマッチを
208651a016b098f4fa1f6279559f104d70f1632dtakashi 与えられた文字列で置き換え、それをファイル名として使用します。
208651a016b098f4fa1f6279559f104d70f1632dtakashi たとえば、すべての GIF ファイルを別サーバの同様な名前の JPEG
208651a016b098f4fa1f6279559f104d70f1632dtakashi ファイルにリダイレクトするには、以下のようなものを使います:
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>クライアントが違う URL を取得するように外部への一時的な
208651a016b098f4fa1f6279559f104d70f1632dtakashiリダイレクトを送る</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<syntax>RedirectTemp <var>URL-path</var> <var>URL</var></syntax>
9dca5c120b818e1c51dbbb6c658d95a9f91b524cyoshiki<context>directory</context><context>.htaccess</context></contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このディレクティブはクライアントに Redirect
208651a016b098f4fa1f6279559f104d70f1632dtakashi が一時的なものである (ステータス 302) ことを知らせます。
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>クライアントが違う URL を取得するように外部への永久的な
208651a016b098f4fa1f6279559f104d70f1632dtakashiリダイレクトを送る</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<syntax>RedirectPermanent <var>URL-path</var> <var>URL</var></syntax>
9dca5c120b818e1c51dbbb6c658d95a9f91b524cyoshiki<context>directory</context><context>.htaccess</context></contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このディレクティブはクライアントに Redirect が永久的なもの
208651a016b098f4fa1f6279559f104d70f1632dtakashi (ステータス 301) であることを知らせます。
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>URL をファイルシステムの位置へマップし、マップ先を
208651a016b098f4fa1f6279559f104d70f1632dtakashiCGI スクリプトに指定</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<var>file-path</var>|<var>directory-path</var></syntax>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p><directive>ScriptAlias</directive> ディレクティブは、対象ディレクトリに
208651a016b098f4fa1f6279559f104d70f1632dtakashi ハンドラで処理される CGI
208651a016b098f4fa1f6279559f104d70f1632dtakashi スクリプトがあることを示す以外は
208651a016b098f4fa1f6279559f104d70f1632dtakashi ディレクティブと同じ振る舞いをします。
208651a016b098f4fa1f6279559f104d70f1632dtakashi ローカルのファイルシステムの
208651a016b098f4fa1f6279559f104d70f1632dtakashi フルパスである二番目の引数にマップされます。</p>
208651a016b098f4fa1f6279559f104d70f1632dtakashi へのリクエストに対してサーバはスクリプト
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki<directivesynopsis>
208651a016b098f4fa1f6279559f104d70f1632dtakashi<description>URL を正規表現を使ってファイルシステムの位置へマップし、マップ先を
208651a016b098f4fa1f6279559f104d70f1632dtakashiCGI スクリプトに指定</description>
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki<var>file-path</var>|<var>directory-path</var></syntax>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</contextlist>
208651a016b098f4fa1f6279559f104d70f1632dtakashi <p>このディレクティブは <directive module="mod_alias">ScriptAlias</directive>
208651a016b098f4fa1f6279559f104d70f1632dtakashi とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
208651a016b098f4fa1f6279559f104d70f1632dtakashi 標準正規表現を利用します。ここで指定された正規表現と URL-path
208651a016b098f4fa1f6279559f104d70f1632dtakashi が合うかどうかを調べ、合う場合は括弧で括られたマッチを
208651a016b098f4fa1f6279559f104d70f1632dtakashi 与えられた文字列で置き換え、それをファイル名として使用します。
208651a016b098f4fa1f6279559f104d70f1632dtakashi を使用するようにするためには、以下のようなものを使います:
4968dbef150b4e1c59621e1e181ece60c4df550cyoshiki ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</directivesynopsis>
2495a079ef0be260bc66490fe9e9ff7e2e6497f1yoshiki</modulesynopsis>