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@my.site.com',
            to      => 'mail1@my.domain.com, mail2@his.domain.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)

to

To-address(es) for email (default webmaster@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@debian.org>
 Copyright (C) 2012 by Roman V. Nikolaev <rshadow@rambler.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.