A.52 ErrorDocument

名前

ErrorDocument

形式

ErrorDocument ステータスコードエラードキュメント

機能概要

エラーが発生した場合に出力されるエラーメッセージをカスタマイズし、独自のメッセージをクライアントに返します。

指定可能なエラードキュメント、およびそのエラードキュメントに対してクライアントに通知可能なステータスコードを以下に示します。
なお、ステータスコードの意味については、「メッセージ集」の「Webサーバから通知されるステータスコード」を参照してください。

エラードキュメント	ステータスコード
テキストメッセージ出力するテキストメッセージを指定する場合は、ダブルクォーテーション（"）で囲んで指定します。なお、テキストメッセージに日本語を使用することはできません。	300、301、302、303、400、401、403、404、405、406、407、410、413、414、416、417、500、501、502、503
内部URL 内部URLにリダイレクトする場合は、先頭にスラッシュ（/）を付加してリダイレクト先をDocumentRootディレクティブからの相対パスで指定します。	204、300、301、302、303、304、401、403、404、405、406、410、413（注）、416、500、501、502、503
外部URL 外部URLにリダイレクトする場合は、完全修飾URLでリダイレクト先を指定します。	204、300、301、302、303、304、403、404、405、406、410、413、416、500、501、502、503

注）静的コンテンツへの内部リダイレクトは指定できますが、CGIを利用した内部リダイレクトは指定できません。

指定位置

グローバルコンテキスト、バーチャルホスト、ディレクトリ

省略値

なし

注意事項

エラードキュメントとして指定した内部URLに対してユーザ認証を設定し、このユーザ認証の対象外のURLにアクセスした場合、本ディレクティブの設定は無効となります。
Servletサービスのアプリケーションにアクセスした場合、本ディレクティブの設定は無効となります。
Servletサービスのアプリケーションにアクセスした場合に使用されるエラーページの設定については、「J2EE ユーザーズガイド(旧版互換)」の「Webアプリケーションの開発」－「Webアプリケーションの開発上の注意事項」－「HTTPエラーステータスコードに対するエラーページの指定について」を参照してください。

使用例

テキストメッセージを指定する場合

ErrorDocument 500 "The server made a boo boo."

内部URLにリダイレクトする場合

ErrorDocument 404 /missing.html

外部URLにリダイレクトする場合

ErrorDocument 403 http://some.other_server.com/subscription_info.html