Plack::Middleware::ErrorDocument(3pm)			User Contributed Perl Documentation		     Plack::Middleware::ErrorDocument(3pm)

NAME

       Plack::Middleware::ErrorDocument - Set Error Document based on HTTP status code

SYNOPSIS

	 # in app.psgi
	 use Plack::Builder;

	 builder {
	     enable "Plack::Middleware::ErrorDocument",
		 500 => '/uri/errors/500.html', 404 => '/uri/errors/404.html',
		 subrequest => 1;
	     $app;
	 };

DESCRIPTION

       Plack::Middleware::ErrorDocument allows you to customize error screen by setting paths (file system path or URI path) of error pages per
       status code.

CONFIGURATIONS

       subrequest
	   A boolean flag to serve error pages using a new GET sub request.  Defaults to false, which means it serves error pages using file
	   system path.

	     builder {
		 enable "Plack::Middleware::ErrorDocument",
		     502 => '/home/www/htdocs/errors/maint.html';
		 enable "Plack::Middleware::ErrorDocument",
		     404 => '/static/404.html', 403 => '/static/403.html', subrequest => 1;
		 $app;
	     };

	   This configuration serves 502 error pages from file system directly assuming that's when you probably maintain database etc. but serves
	   404 and 403 pages using a sub request so your application can do some logic there like logging or doing suggestions.

	   When using a subrequest, the subrequest should return a regular '200' response.

AUTHOR

       Tatsuhiko Miyagawa

SEE ALSO

perl v5.14.2							    2012-03-15				     Plack::Middleware::ErrorDocument(3pm)