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.