GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PLACK::MIDDLEWARE::ERRORDOCUMENT (3)

.ds Aq ’

NAME

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

CONTENTS

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PLACK::MIDDLEWARE::ERRORDOCUMENT (3) 2015-06-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.