blob: 8062e4729d275d0b1cc0940c8fabff20f4eafb0b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>カスタムエラーレスポンス - Apache HTTP サーバ</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Apache HTTP サーバ バージョン 2.0</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<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.0</a></div><div id="page-content"><div id="preamble"><h1>カスタムエラーレスポンス</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>ウェブマスターが何らかのエラーや問題に対する
Apache の反応を設定できるようにする追加機能を提供します。</p>
<p>サーバがエラーや問題を発見した場合の反応を、
カスタマイズして定義することができます。</p>
<p>スクリプトの実行が失敗して "500 Server Error"
を発生させたとします。この場合の反応を、より好ましいテキストや、別の
URL (内部及び外部) へのリダイレクションに置き換えることができます。
</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">動作</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">設定</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">カスタムエラーレスポンスとリダイレクト</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="behavior" id="behavior">動作</a></h2>
<h3>古い動作</h3>
<p>NCSA httpd 1.3 は、古くて退屈なエラー/問題メッセージを
返していました。それはしばしばユーザには無意味であり、
またそれを発生させた原因を記録する方法も提供していませんでした。</p>
<h3>新しい動作</h3>
<ol>
<li>NCSA のハードコードされたメッセージの代わりに
他のテキストを表示</li>
<li>ローカルの URL にリダイレクト</li>
<li>外部の URL にリダイレクト</li>
</ol>
<p>するようにサーバを設定できます。</p>
<p>別の URL にリダイレクトすることは役に立ちますが、
それは説明をしたり、より明確に誤り/問題を記録したりするために
何か情報を伝えられるときに限ります。</p>
<p>これを実現するために、 Apache は新しく CGI のような環境変数を
定義します:</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif,
image/x-xbitmap, image/jpeg<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX
A.09.05 9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p>頭に付く <code>REDIRECT_</code> に注目してください。</p>
<p>少なくとも <code>REDIRECT_URL</code> と
<code>REDIRECT_QUERY_STRING</code> は新しい URL (CGI スクリプトか
CGI インクルードであると仮定されます) に渡されます。
他の変数は、エラーや問題が起きる前に存在した場合にだけ存在します。
もしあなたの設定した <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> が <em>外部</em>リダイレクト
(<em>すなわち</em>、<code>http:</code>
のような体系名から始まるすべてのもの。たとえ同じホストを指していても)
ならば、これらは<strong>まったく</strong>設定されません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">設定</a></h2>
<p><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> が適切に設定されていれば、
.htaccess ファイルで <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
を使用することができます。</p>
<p>ここに、いくつかの例を挙げます。</p>
<div class="example"><p><code>
ErrorDocument 500 /cgi-bin/crash-recover <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 404 /Lame_excuses/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>構文</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p>action (動作) は、</p>
<ol>
<li>表示されるべきテキスト。テキストには引用符 (") をつけます。
引用符の後に続くものが何でも表示されます。
<em>注意 : (") は表示されません</em></li>
<li>リダイレクト先の外部 URL </li>
<li>リダイレクト先のローカル URL </li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">カスタムエラーレスポンスとリダイレクト</a></h2>
<p>スクリプト/SSI に追加の環境変数が利用可能になるように、
リダイレクトされた URL に対する Apache の動作が変更されました。</p>
<h3>古い動作</h3>
<p>リダイレクトされたスクリプトは標準の CGI
環境変数を利用可能でした。しかし、どこからリダイレクト
されたかの情報は提供されていませんでした。</p>
<h3>新しい動作</h3>
<p>リダイレクトされた先のスクリプトが使用可能なように、
新しいたくさんの環境変数が初期化されます。新しい変数は、それぞれ
<code>REDIRECT_</code> で始まります。
<code>REDIRECT_</code> で始まる環境変数はリダイレクトされる前に存在していた
CGI 環境変数の頭に <code>REDIRECT_</code> を付けて作成されます。
<em>すなわち</em>、<code>HTTP_USER_AGENT</code> は
<code>REDIRECT_HTTP_USER_AGENT</code> になります。
これらの新しい変数に加えて、Apache は、
スクリプトがリダイレクト元のトレースを助けるために
<code>REDIRECT_URL</code> と <code>REDIRECT_STATUS</code>
を定義します。アクセスログには元の URL とリダイレクトされた URL
の両方が記録されます。</p>
<p>ErrorDocument が CGI スクリプトへのローカルリダイレクトを
指定している場合は、それを起動することになったエラーの状態を
クライアントまで確実に伝えるために <code>"Status:" </code>
ヘッダを含むべきです。例えば、ErrorDocument 用の Perl
スクリプトは以下のようなものを含むかもしれません。
</p>
<div class="example"><p><code>
... <br />
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p>スクリプトが <code>404 Not Found</code> のような
特定のエラーコンディションを扱うためだけに使われる場合は、
代わりに特定のコードとエラーテキストを使用することができます。</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<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>
<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>
</body></html>
|
