2.3.46 ErrorDocument
エラーが発生したときに、Webブラウザーへ表示するメッセージをカスタマイズする場合に指定します。
説明
エラーが発生したときに、Webブラウザーへ表示するメッセージをカスタマイズする場合に指定します。
- テキスト
-
文字列を""で囲み指定します。
- ローカルURL
-
先頭に/を記述して、自サイト内のコンテンツを指定します。
- フルURL
-
「http://」または「https://」で始まるURLを記述し、他サイトのコンテンツを指定します。
このディレクティブに指定できるエラーステータス番号と、テキスト、ローカルURL、フルURLの指定可否について、次に示します。
エラーステータス番号(意味) |
テキスト |
ローカルURL |
フルURL |
---|---|---|---|
400 (Bad Request) |
○ |
× |
× |
401 (Authorization Required) |
○ |
○ |
× |
403 (Forbidden) |
○ |
○ |
○ |
404 (Not Found) |
○ |
○ |
○ |
405 (Method Not Allowed) |
○ |
○ |
○ |
406 (Not Acceptable) |
○ |
○ |
○ |
408 (Request Time-out) |
× |
× |
× |
410 (Gone) |
○ |
○ |
○ |
411 (Length Required) |
○ |
× |
× |
412 (Precondition Failed) |
○ |
○ |
○ |
413 (Request Entity Too Large) |
○ |
○ |
○ |
414 (Request-URI Too Large) |
○ |
× |
× |
416 (Requested Range Not Satisfiable) |
○ |
○ |
○ |
417 (Expectation Failed) |
○ |
× |
× |
500 (Internal Server Error) |
○ |
○ |
○ |
501 (Method Not Implemented) |
○ |
○ |
○ |
502 (Bad Gateway) |
○ |
○ |
× |
503 (Service Temporarily Unavailable) |
○※ |
○※ |
○※ |
506 (Variant Also Negotiates) |
○ |
○ |
○ |
- (凡例)
-
○:指定できる。
×:指定できない。
- 注※
-
流量制限機能が返すメッセージをカスタマイズする場合は、QOSResponseディレクティブまたはQOSRedirectディレクティブを使用してください。
このディレクティブ指定時には、次の点に留意してください。
-
このディレクティブを複数指定する場合、同じエラー番号に異なる指定はできません。
-
CGIプログラム内で設定されたエラーステータスに対しては、メッセージをカスタマイズできません。
-
ローカルURL、フルURLの指定先でエラーとなる場合は、カスタマイズできません。
-
ローカルURLの指定先でコンテントネゴシエーションが発生する場合は、エラーとなりカスタマイズできないことがあります。
-
LoadModuleディレクティブによって動的に接続したモジュール内で設定されたエラーステータスに対しても、そのモジュールの実装方法によってメッセージをカスタマイズできない場合があります。
-
フルURLの指定時には、ステータスコード302 FoundおよびLocationヘッダーに新パスを設定した応答を返します。通常、ステータスコード302を受けたWebブラウザーは、Locationヘッダーに指定されたアドレスに対して自動的にリダイレクトします。
-
フルURLの指定時には、IPv6アドレスまたはIPv6アドレスに対応したホスト名も指定できます。IPv6アドレスを指定する場合は、IPv6アドレスを[ ]で囲んでください。
書式
ErrorDocument エラーステータス番号 {テキスト|ローカルURL|フルURL}
記述できる場所
httpsd.conf、<VirtualHost>、<Directory>、.htaccess
上書き許可
FileInfoレベル
記述例
ErrorDocument 500 "Server Error." ErrorDocument 404 /missing.html ErrorDocument 403 http://some.other_server.com/subscription_info.html ErrorDocument 404 http://[2001::123:4567:89ab:cdef]/missing.html