Plack::Middleware::ErrUsercContributed PerlPlack::Middleware::ErrorDocument(3)NAMEPlack::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;
};
DESCRIPTIONPlack::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 ALSOperl v5.14.22012-03-1Plack::Middleware::ErrorDocument(3)
