The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

 / 
Catalyst-Action-RenderView-ErrorHandler-Action-Email-0.04
River stage zero No dependents
/ Catalyst::Action::RenderView::ErrorHandler::Action::Email

NAME

Catalyst::Action::RenderView::ErrorHandler::Action::Email - Catalyst ErrorHandler Action for Email

SYNOPSIS


            

              
              
#In a configuration somewhere:
error_handler => {
        'actions' => [
                {
                        type => 'Log',
                        id => 'log-server',
                        level => 'error'
                },
                {
                        #Use this action
                        type => 'Email',
                        id => 'log-email',
                        #Regex to ignore all request paths with PhpMyAdmin or SqlDump init. Regex is case insensitive used.
                        ignorePath => '(PhpMyAdmin|SqlDump)',
                        #This should be a Catalyst::View::Email::Template or Catalyst::View::Email view.
                        view => 'ErrorMail',
                        #This options are copied into $c->stash->{email} for accesing from the view selected above
                        #For additional information look into the documentation of Catalyst::View::Email::Template
                        options => {
                        (
                                #becomes $c->stash->{email}->{from} = ...
                                from => 'MyApp - Homepage <homepage@domain.com>',
                                to => 'you@domain.com',
                                subject => 'Homepage - ErrorMail',
                                #Template isn't needed, if you use the simple Catalyst::View::Email
                                templates => [
                                        {
                                                template        => 'ErrorMail.tt2',
                                                content_type    => 'text/html',
                                                charset         => 'utf-8',
                                                encoding        => 'quoted-printable',
                                                #View to render the Template
                                                view            => 'HTMLEmail', 
                                        },
                                ]
                        )}
                }
        ],
        'handlers' => {
        (
                '5xx' => {
                        template => 'error_internal.tt2',
                        actions => ['log-server','log-email']
                },
                '404' => {
                        template => 'error.tt2'
                },
                'fallback' =>  {
                        static => 'root/src/error.html', 
                        actions => ['log-email','log-email']
                }
        )}
} 
#The template may look like:
[% USE Dumper %]
<!DOCTYPE html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Error Report</title>
</head>
<body>
<p>There was a error in yor App:</p>
<h4>Requested path:</h4>
<p>[% base %][% c.request.path %]</p>
<h4>Arguments:</h4>
[% FOREACH a IN c.request.args %]
   <p>[% a | html %]</p>
[% END %]
<h4>Parameters:</h4>
[% Dumper.dump(c.request.parameters) %]
<h4>User Agent:</h4>
<p>[% c.request.user_agent | html %]</p>
<h4>Referer:</h4>
<p>[% c.request.referer | html %]</p>
<h4>Error messages:</h4>
[% FOREACH e IN c.error %]
   <p>[% e | html %]</p>
[% END %]
[% IF c.response.code %]
<h4>Error code:</h4>
<p>[% c.response.code %]</p>
[% END %]
</body>
</html>

DESCRIPTION

Used by Catalyst::Action::RenderView::ErrorHandler to send an Email if there is an error in your Catalyst application.

SEE ALSO

Catalyst::Action::RenderView::ErrorHandler Catalyst::Action::RenderView::ErrorHandler::Action::Log Catalyst::View::Email Catalyst::View::Email::Template

AUTHOR

Stefan Profanter, <profanter@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by Stefan Profanter

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 92:

Non-ASCII character seen before =encoding in '[%'. Assuming UTF-8