From 3aea64d80be1c59215bc3818ceb3c019ff8a4e6f Mon Sep 17 00:00:00 2001 From: Yoshiki Hayashi Date: Wed, 11 Sep 2002 09:17:34 +0000 Subject: [PATCH] New transformations. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96765 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_actions.html.ja.jis | 95 +++++++++ docs/manual/mod/mod_alias.html.ja.jis | 243 ++++++++++++++++++++++++ docs/manual/mod/mod_asis.html.ja.jis | 63 ++++++ 3 files changed, 401 insertions(+) create mode 100644 docs/manual/mod/mod_actions.html.ja.jis create mode 100644 docs/manual/mod/mod_alias.html.ja.jis create mode 100644 docs/manual/mod/mod_asis.html.ja.jis diff --git a/docs/manual/mod/mod_actions.html.ja.jis b/docs/manual/mod/mod_actions.html.ja.jis new file mode 100644 index 0000000000..89f7f30097 --- /dev/null +++ b/docs/manual/mod/mod_actions.html.ja.jis @@ -0,0 +1,95 @@ + + +mod_actions - Apache HTTP サーバ

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Apache HTTP サーバ バージョン 2.0

<-
Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.0 > モジュール

Apache モジュール mod_actions

説明: + メディアタイプやリクエストメソッドに応じて +CGI スクリプトを実行する機能を提供
ステータス: + Base
モジュール識別子: + actions_module
ソースファイル: + mod_actions.c

概要

+

このモジュールには二つのディレクティブがあります。Action + ディレクティブは特定のタイプのファイルをリクエストされた場合に + CGI スクリプトが実行されるようにします。Script + ディレクティブはリクエストで特定のメソッドが使用されたときに CGI + スクリプトが実行されるようにします。 + これはファイルを処理するスクリプトの実行をずっと簡単にします。

+

ディレクティブ

top

Action ディレクティブ

説明: + 特定のハンドラやコンテントタイプに対して CGI を実行するように +設定
構文: + Action action-type cgi-script
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き: + FileInfo
ステータス: + Base
モジュール: + mod_actions
+

このディレクティブは action-type + がリクエストされたときに cgi-script + が実行されるという動作を追加します。cgi-script は + ScriptAlias や + AddHandler によって + CGI スクリプトに設定されたリソースへの URL-path です。 + Action-type には + handler か MIME + コンテントタイプを指定できます。リクエストされたドキュメントの URL + とファイルのパスは標準 CGI 環境変数 PATH_INFO と PATH_TRANSLATED + を使って伝えられます。

+ +

例

+ + + # Requests for files of a particular type:
+ Action image/gif /cgi-bin/images.cgi
+
+ # Files of a particular file extension
+ AddHandler my-file-type .xyz
+ Action my-file-type /cgi-bin/program.cgi
+

+ +

最初の例では、MIME コンテントタイプが image/gif + のファイルへのリクエストは、そのファイルの代わりに指定されたスクリプト + /cgi-bin/images.cgi が呼ばれます。

+ +

2 番目の例では、拡張子が .xyz のファイルへのリクエストは、 + そのファイルの代わりに指定されたスクリプト + /cgi-bin/program.cgi が呼ばれます。

+

参照

top

Script ディレクティブ

説明: + 特定のリクエストメソッドに対して CGI スクリプトを +実行するように設定
構文: + Script method cgi-script
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ
ステータス: + Base
モジュール: + mod_actions
+

このディレクティブは method + というメソッドを使ってリクエストが行なわれたときに + cgi-script を実行するという動作を追加します。 + cgi-script は + ScriptAlias や + AddHandler によって + CGI スクリプトに設定されたリソースへの URL-path です。 + リクエストされたドキュメントの URL とファイルのパスは標準 CGI + 環境変数 PATH_INFO と PATH_TRANSLATED を使って伝えられます。

+ +
+ 任意のメソッド名を使用することができます。 + メソッド名は大文字小文字を区別します。ですから、 + Script PUT と Script put + はまったく違った効果になります。 +
+ +

Script コマンドはデフォルトの動作を追加するだけであることに + 注意してください。もし CGI スクリプトが呼ばれたり、リクエストされた + メソッドを内部で扱うことのできる他のリソースがあれば、それが行なわれます。 + GET メソッドの Script は問合せ引数がある場合にのみ + (たとえば、foo.html?hi) 呼ばれるということにも注意してください。 + そうでない場合は、リクエストは通常通り処理されます。

+ +

例

+ + # For <ISINDEX>-style searching
+ Script GET /cgi-bin/search
+ # A CGI PUT handler
+ Script PUT /~bob/put.cgi
+

+
\ No newline at end of file diff --git a/docs/manual/mod/mod_alias.html.ja.jis b/docs/manual/mod/mod_alias.html.ja.jis new file mode 100644 index 0000000000..bc7795ca45 --- /dev/null +++ b/docs/manual/mod/mod_alias.html.ja.jis @@ -0,0 +1,243 @@ + + +mod_alias - Apache HTTP サーバ

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Apache HTTP サーバ バージョン 2.0

<-
Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.0 > モジュール

Apache モジュール mod_alias

説明: + ホストファイルシステム上のいろいろな違う場所を + ドキュメントツリーにマップする機能と、 + URL のリダイレクトを行なう機能を提供する
ステータス: + Base
モジュール識別子: + alias_module
ソースファイル: + mod_alias.c

概要

+

このモジュールのディレクティブはサーバにリクエストが到着したときに + URL の操作や制御をすることを可能にします。Alias + ディレクティブと ScriptAlias + ディレクティブは + URL とファイルシステムのパスをマップするために使用されます。これは + DocumentRoot + の下にないドキュメントをウェブのドキュメントツリーの一部として + 送られるようにします。ScriptAlias + ディレクティブにはマップ先のディレクトリが CGI + スクリプトのみであることを示すという追加の効果があります。 +

+ +

Redirect ディレクティブは + クライアントに違った + URL に新しいリクエストを送るように指示します。これは、 + リソースが新しい場所に移動したときによく使用されます。

+
top

Alias ディレクティブ

説明: + URL をファイルシステムの位置にマップする
構文: + Alias URL-path + file-path|directory-path
コンテキスト: + サーバ設定ファイル, バーチャルホスト
ステータス: + Base
モジュール: + mod_alias
+

Alias ディレクティブはドキュメントを + ローカルファイルシステムの + DocumentRoot + 以外の場所に保管することを可能にします。 + URL の (% が復号された) パスが url-path で始まるものは + directory-filename + で始まるローカルファイルにマップされます。

+ +

例:

+ +

Alias /image /ftp/pub/image

+ +

http://myserver/image/foo.gif へのリクエストに対して、サーバは + ファイル /ftp/pub/image/foo.gif を返します。

+ +

もし url-path の最後に / + を書いたなら、サーバはエイリアスを展開するために最後の / + を要求するということに注意してください。すなわち、Alias /icons/ + /usr/local/apache/icons/ というものを使用していると、 + /icons という url はエイリアスされません。

+ +

エイリアスの行き先を含んでいる <Directory> + セクションを追加する必要があるかもしれないことに注意してください。 + エイリアスの展開は <Directory> + セクションを調べる前に行なわれますので、 + エイリアスの行き先の <Directory> セクションのみ + 効果があります。 + (しかし、<Location> + セクションはエイリアスが処理される前に実行されますので、 + こちらは適用されます。)

+ +
top

AliasMatch ディレクティブ

説明: + 正規表現を使って URL をファイルシステムの位置にマップする
構文: + AliasMatch regex + file-path|directory-path
コンテキスト: + サーバ設定ファイル, バーチャルホスト
ステータス: + Base
モジュール: + mod_alias
+

このディレクティブは Alias + とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、 + 標準正規表現を利用します。ここで指定された正規表現と URL のパス + が合うかどうかを調べ、合う場合は括弧で括られたマッチを + 与えられた文字列で置き換え、それをファイル名として使用します。たとえば、 + /icons ディレクトリを使う + ためには以下のようなものが使用できます:

+

+ AliasMatch ^/icons(.*) /usr/local/apache/icons$1 +

+
top

Redirect ディレクティブ

説明: + クライアントが違う URL を取得するように外部へのリダイレクトを +送る
構文: + Redirect [status] URL-path URL
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き: + FileInfo
ステータス: + Base
モジュール: + mod_alias
+

Redirect ディレクティブは古い URL を新しいものへマップします。 + 新しい URL がクライアントに返されます。そして、 + クライアントは新しいアドレスをもう一回取得しようとします。 + URL-path (% が復号された) パスで始まるドキュメントへの + すべてのリクエストは URL で始まる新しい + (% が符号化された) URL へのリダイレクトエラーが返されます。

+ +

例:

+ +

Redirect /service http://foo2.bar.com/service

+ +

クライアントは http://myserver/service/foo.txt + へのリクエストを行なうと、代わりに http://foo2.bar.com/service/foo.txt + をアクセスするように告げられます。

+ +

注意:

設定ファイル中の順番に関わらず、 +Redirect 系のディレクティブは Alias +ディレクティブと ScriptAlias ディレクティブよりも優先されます。 +また、.htaccess ファイルや <Directory> +セクションの中で使われていたとしても、URL-path +は相対パスではなく、絶対パスでなければなりません。

+ +

もし status 引数が与えられていなければ、リダイレクトは + "temporary" (HTTP ステータス 302) になります。これはクライアントに + リソースが一時的に移動したということを示します。Status + 引数は 他の HTTP のステータスコードを返すために使用することができます:

+ +
+
permanent
+ +
永久にリダイレクトをするステータス (301) を返します。 + これはリソースが永久に移動したということを意味します。
+ +
temp
+ +
一時的なリダイレクトステータス (302) + を返します。これがデフォルトです。
+ +
seeother
+ +
"See Other" ステータス (303) を返します。 + これはリソースが他のもので置き換えられたことを意味します。
+ +
gone
+ +
"Gone" ステータス (410) を返します。これはリソースが永久に + 削除されたことを意味します。このステータスが使用された場合、 + url 引数は省略されなければなりません。
+
+ +

Status の値にステータスコードを数値で与えることで + 他のステータスコードも返すことができます。ステータスが 300 と 399 + の間にある場合、url 引数は存在していなければいけません。 + その他の場合は省略されていなければなりません。ただし、 + ステータスは Apache のコードが知っているものである必要があります + (http_protocol.c の関数 send_error_response + を見てください)。

+

例:

+ +

+ Redirect permanent /one http://example.com/two
+ Redirect 303 /three http://example.com/other +

+ +
top

RedirectMatch ディレクティブ

説明: + 現在の URL への正規表現のマッチにより +クライアントが違う URL を取得するように外部へのリダイレクトを +送る
構文: + RedirectMatch [status] regex URL
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き: + FileInfo
ステータス: + Base
モジュール: + mod_alias
+

このディレクティブは Redirect + とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、 + 標準正規表現を利用します。ここで指定された正規表現と URL-path + が合うかどうかを調べ、合う場合は括弧で括られたマッチを + 与えられた文字列で置き換え、それをファイル名として使用します。 + たとえば、すべての GIF ファイルを別サーバの同様な名前の JPEG + ファイルにリダイレクトするには、以下のようなものを使います: +

+

+ RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg +

+
top

RedirectPermanent ディレクティブ

説明: + クライアントが違う URL を取得するように外部への永久的な +リダイレクトを送る
構文: + RedirectPermanent URL-path URL
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き: + FileInfo
ステータス: + Base
モジュール: + mod_alias
+

このディレクティブはクライアントに Redirect が永久的なもの + (ステータス 301) であることを知らせます。 + Redirect premanent とまったく同じです。

+
top

RedirectTemp ディレクティブ

説明: + クライアントが違う URL を取得するように外部への一時的な +リダイレクトを送る
構文: + RedirectTemp URL-path URL
コンテキスト: + サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き: + FileInfo
ステータス: + Base
モジュール: + mod_alias
+

このディレクティブはクライアントに Redirect + が一時的なものである (ステータス 302) ことを知らせます。 + Redirect temp とまったく同じです。

+
top

ScriptAlias ディレクティブ

説明: + URL をファイルシステムの位置へマップし、マップ先を +CGI スクリプトに指定
構文: + ScriptAlias +URL-path file-path|directory-path
コンテキスト: + サーバ設定ファイル, バーチャルホスト
ステータス: + Base
モジュール: + mod_alias
+

ScriptAlias ディレクティブは、対象ディレクトリに + mod_cgi の cgi-script + ハンドラで処理される CGI + スクリプトがあることを示す以外は + Alias + ディレクティブと同じ振る舞いをします。 + URL の (% が復号された) パスが URL-path で始まるものは + ローカルのファイルシステムの + フルパスである二番目の引数にマップされます。

+ +

例:

+ +

ScriptAlias /cgi-bin/ /web/cgi-bin/

+ +

http://myserver/cgi-bin/foo + へのリクエストに対してサーバはスクリプト + /web/cgi-bin/foo を実行します。

+
top

ScriptAliasMatch ディレクティブ

説明: + URL を正規表現を使ってファイルシステムの位置へマップし、マップ先を +CGI スクリプトに指定
構文: + ScriptAliasMatch +regex file-path|directory-path
コンテキスト: + サーバ設定ファイル, バーチャルホスト
ステータス: + Base
モジュール: + mod_alias
+

このディレクティブは ScriptAlias + とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、 + 標準正規表現を利用します。ここで指定された正規表現と URL-path + が合うかどうかを調べ、合う場合は括弧で括られたマッチを + 与えられた文字列で置き換え、それをファイル名として使用します。 + たとえば、標準の /cgi-bin + を使用するようにするためには、以下のようなものを使います: +

+

+ ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 +

+
\ No newline at end of file diff --git a/docs/manual/mod/mod_asis.html.ja.jis b/docs/manual/mod/mod_asis.html.ja.jis new file mode 100644 index 0000000000..487052110f --- /dev/null +++ b/docs/manual/mod/mod_asis.html.ja.jis @@ -0,0 +1,63 @@ + + +mod_asis - Apache HTTP サーバ

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Apache HTTP サーバ バージョン 2.0

<-
Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.0 > モジュール

Apache モジュール mod_asis

説明: + 自分用の HTTP ヘッダの書かれているファイルを送信する
ステータス: + Base
モジュール識別子: + asis_module
ソースファイル: + mod_asis.c

概要

+

このモジュールはハンドラ send-as-is + を提供します。このハンドラは通常の HTTP + ヘッダをほとんど追加することなくドキュメントを送信します。

+ +

これはサーバからどんな種類のデータを送るときにも使用できます。 + Cgi スクリプトや nph スクリプトが無くてもリダイレクトや他の特別な + HTTP 応答を送ることができます。

+ +

歴史的な理由により、このモジュールは mime タイプ + httpd/send-as-is のファイルも処理します。

+

ディレクティブ

このモジュールにディレクティブはありません。

トピック

  • 使用法

参照

top

使用法

+ +

サーバ設定ファイルで、ファイルと send-as-is + ハンドラを例えば以下のように関連付けてください。

+ +

AddHandler send-as-is asis

+ +

拡張子が .asis のすべてのファイルの内容は Apache + からクライアントへほとんど変更無く送られます。クライアントには + HTTP ヘッダが必要ですので、ファイルに書くことを忘れないでください。 + Status: ヘッダも必要です。データは 3 桁の HTTP + 応答コードと、その後にテキストメッセージが続いたものでなければなりません。

+ +

これはクライアントにファイルが移動したことを知らせるために + as is (そのまま) で送られるファイルの内容の例です。 +

+ +

Status: 301 Now where did I leave that URL
+ Location: http://xyz.abc.com/foo/bar.html
+ Content-type: text/html
+
+ <HTML>
+ <HEAD>
+ <TITLE>Lame excuses'R'us</TITLE>
+ </HEAD>
+ <BODY>
+ <H1>Fred's exceptionally wonderful page has moved + to
+ <A + HREF="http://xyz.abc.com/foo/bar.html">Joe's</A> + site.
+ </H1>
+ </BODY>
+ </HTML> +

+ +

注意: サーバはクライアントに返されるデータに常に Date: と Server: + ヘッダを追加しますので、それらがファイルに書かれていてはいけません。 + サーバは Last-Modified ヘッダを追加しません。 + おそらくはそうすべきでしょうけれど。 +

+
\ No newline at end of file -- 2.40.0