/usr/share/perl5/Plack/Middleware/ErrorDocument.pm is in libplack-perl 0.9985-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 | package Plack::Middleware::ErrorDocument;
use strict;
use warnings;
use parent qw(Plack::Middleware);
use Plack::MIME;
use Plack::Util;
use Plack::Util::Accessor qw( subrequest );
use HTTP::Status qw(is_error);
sub call {
my $self = shift;
my $env = shift;
my $r = $self->app->($env);
$self->response_cb($r, sub {
my $r = shift;
unless (is_error($r->[0]) && exists $self->{$r->[0]}) {
return;
}
my $path = $self->{$r->[0]};
if ($self->subrequest) {
for my $key (keys %$env) {
unless ($key =~ /^psgi/) {
$env->{'psgix.errordocument.' . $key} = $env->{$key};
}
}
# TODO: What if SCRIPT_NAME is not empty?
$env->{REQUEST_METHOD} = 'GET';
$env->{REQUEST_URI} = $path;
$env->{PATH_INFO} = $path;
$env->{QUERY_STRING} = '';
delete $env->{CONTENT_LENGTH};
my $sub_r = $self->app->($env);
if ($sub_r->[0] == 200) {
$r->[1] = $sub_r->[1];
$r->[2] = $sub_r->[2];
}
# TODO: allow 302 here?
} else {
open my $fh, "<", $path or die "$path: $!";
$r->[2] = $fh;
my $h = Plack::Util::headers($r->[1]);
$h->remove('Content-Length');
$h->set('Content-Type', Plack::MIME->mime_type($path));
}
});
}
1;
__END__
=head1 NAME
Plack::Middleware::ErrorDocument - Set Error Document based on HTTP status code
=head1 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;
};
=head1 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.
=head1 CONFIGURATIONS
=over 4
=item 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.
=back
=head1 AUTHOR
Tatsuhiko Miyagawa
=head1 SEE ALSO
=cut
|