Plack::Middleware::ErrorDocument.3pm

Langue: en

Version: 2010-05-04 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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.

AUTHOR

Tatsuhiko Miyagawa

SEE ALSO