1Plack::Middleware::StacUksTerracCeo(n3t)ributed Perl DocPulmaecnkt:a:tMiiodndleware::StackTrace(3)
2
3
4

NAME

6       Plack::Middleware::StackTrace - Displays stack trace when your app dies
7

SYNOPSIS

9         enable "StackTrace";
10

DESCRIPTION

12       This middleware catches exceptions (run-time errors) happening in your
13       application and displays nice stack trace screen. The stack trace is
14       also stored in the environment as a plaintext and HTML under the key
15       "plack.stacktrace.text" and "plack.stacktrace.html" respectively, so
16       that middleware futher up the stack can reference it.
17
18       This middleware is enabled by default when you run plackup in the
19       default development mode.
20
21       You're recommended to use this middleware during the development and
22       use Plack::Middleware::HTTPExceptions in the deployment mode as a
23       replacement, so that all the exceptions thrown from your application
24       still get caught and rendered as a 500 error response, rather than
25       crashing the web server.
26
27       Catching errors in streaming response is not supported.
28

CONFIGURATION

30       force
31             enable "StackTrace", force => 1;
32
33           Force display the stack trace when an error occurs within your
34           application and the response code from your application is 500.
35           Defaults to off.
36
37           The use case of this option is that when your framework catches all
38           the exceptions in the main handler and returns all failures in your
39           code as a normal 500 PSGI error response. In such cases, this
40           middleware would never have a chance to display errors because it
41           can't tell if it's an application error or just random "eval" in
42           your code. This option enforces the middleware to display stack
43           trace even if it's not the direct error thrown by the application.
44
45       no_print_errors
46             enable "StackTrace", no_print_errors => 1;
47
48           Skips printing the text stacktrace to console ("psgi.errors").
49           Defaults to 0, which means the text version of the stack trace
50           error is printed to the errors handle, which usually is a standard
51           error.
52

AUTHOR

54       Tokuhiro Matsuno
55
56       Tatsuhiko Miyagawa
57

SEE ALSO

59       Devel::StackTrace::AsHTML Plack::Middleware
60       Plack::Middleware::HTTPExceptions
61
62
63
64perl v5.12.3                      2011-07-08  Plack::Middleware::StackTrace(3)
Impressum