Mojolicious::Plugin::MailException

NAME

Mojolicious::Plugin::MailException − Mojolicious plugin to send crash information by email

SYNOPSIS

    package MyServer;
    use Mojo::Base 'Mojolicious';
    sub startup {
        my ($self) = @_;
        $self−>plugin(MailException => {
            from    => 'robot AT my DOT site DOT com',
            to      => 'mail1 AT my DOT domain DOT com, mail2 AT his DOT domain DOT com',
            subject => 'My site crashed!',
            headers => {
                'X−MySite' => 'crashed'
            }
        });
    }

DESCRIPTION

The plugin catches all exceptions, packs them into email and sends them to email.

There are some plugin options:
from

From-address for email (default root@localhost)

subject

Subject for crash email

headers

Hash with headers that have to be added to mail

send

Subroutine that can be used to send the mail, example:

    sub startup {
        my ($self) = @_;
        $self−>plugin(MailException => {
            send => sub {
                my ($mail, $exception) = @_;
                $mail−>send;    # prepared MIME::Lite object
            }
        });
    }

In the function You can send email by yourself and (or) prepare and send Your own mail (sms, etc) message using $exception object. See Mojo::Exception.

The plugin provides additional method (helper) mail_exception.

    $cx−>mail_exception('my_error', { 'X−Add−Header' => 'value' });

You can use the helper to raise exception with additional mail headers.

VCS

The plugin is placed on github <https://github.com/dr-co/libmojolicious-plugin-mail_exception>.

COPYRIGHT AND LICENCE

 Copyright (C) 2012 by Dmitry E. Oboukhov <unera AT debian DOT org>
 Copyright (C) 2012 by Roman V. Nikolaev <rshadow AT rambler DOT ru>

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