Mail::SendVarious - send mail via STMP and sendmail
use Mail::SendVarious; sendmail( from => 'user@host', From => 'First Last', to => 'user@host, user@host', cc => 'user@host, user@host', xheader => 'Some header stuff', body => 'Some body stuff here' ); sendmail( envelope_to => 'user@host, user@host', message => 'Complete header and body stuff', ); sendmail( envelope_to => 'user@host, user@host', header => 'Complete header stuff', body => 'Complete body stuff', ); use Mail::SendVarious qw(make_message); ($from, $message, @envelope_to) = make_message(%args);
Mail::SendVarious will try to send mail multiple ways. First it tries via SMTP. If that doesn't work then it tries using /usr/sbin/sendmail.
/usr/sbin/sendmail
The sendmail() function can put together a message header or you can hand it one. Here are the options it can take:
sendmail()
Sets the sender email address. If creating a header, also sets the email address in the From: header if there is no from option.
From:
from
Sets the envelope sender email address if envelope_from isn't set. If creating a header, also sets the email address in the From: header.
envelope_from
Set the name over the sender in the From: header.
Sets who the message is sent to.
Sets the To: header. Also sets who the message is sent to if envelope_to isn't set.
To:
envelope_to
Sets the Cc: header. Also adds who the message is sent to if envelope_to isn't set.
Cc:
Adds to who the message is sent to.
Specifies the Subject: header.
Subject:
Specifies extra header lines to be added if a header is generated.
Specifies the complete message header. xheader will be ignored. No To:, From:, Cc: or Subject: header will be generated.
xheader
Specifies the complete message body.
Specifies the complete message. header and body arguments will be ignored. No To:, From:, Cc: or Subject: header will be generated.
header
body
Specifies if a header should be generated with To:, From:, Cc: and Subject:. This overrides what what otherwise might happen.
Specifies a function to call for debug output. If not set, no debug output is generated.
Specifies a function to call for error output. If not set, errors are reported on STDERR.
STDERR
Specifies a list of hosts to try to send to via SMTP. This should be an array refrence. If not set, @Mail::SendVarious::mail_hostlist is used. The default for @Mail::SendVarious::mail_hostlist is 127.0.0.1.
@Mail::SendVarious::mail_hostlist
127.0.0.1
Specifies a command to use if sending via SMTP fails. This should be an array refrence. If not set, @Mail::SendVarious::mail_command is used. The default for @Mail::SendVarious::mail_command is /usr/sbin/sendmail -oeml -i.
@Mail::SendVarious::mail_command
/usr/sbin/sendmail -oeml -i
Normally when sending via SMTP, Mail::SendVarious will skip over any recipients that are rejected. Sent no_rejects and the SMTP server will be skipped instead. If no_rejects is not set, then any rejected recipients will end up in @Mail::SendVarious::to_rejected.
no_rejects
@Mail::SendVarious::to_rejected
The return value from sendmail() is true if the message was sent and false otherwise. If the message was not sent, then the variable Mail::SendVarious::mail_error will be set to a description of the problem.
Mail::SendVarious::mail_error
In addition to the standard export item of the sendmail() function, the following are available explicitly:
The last error.
An additional function make_message() is provided. It takes the same arguemtns as sendmail() but does not send mail. It just generates the message.
make_message()
The following two snippets do the same thing:
{ my ($from, $message, @envelope_to) = make_message(%args); sendmail( envelope_from => $from, envelope_to => \@envelope_to, message => $message, ); }
and
sendmail(%args);
Any recipients that were rejected by the SMTP server. (Only if no_rejects isn't set).
(qw(127.0.0.1))
(qw(/usr/sbin/sendmail -oeml -i))
Send mail via SMTP: Mail::SMI, Mail::Transport::SMTP, Mail::SendEasy, Mail::Sender, Mail::Send, Mail::Sendmail.
Send mail via /usr/sbin/sendmail: Mail::Transport::Sendmail.
Send via various methods (but only one at a time): Mail::Mailer.
Manage an outgoing mail spool: Mail::Spool.
Copyright (C) 2002-2006, David Muir Sharnoff <muir@idiom.com> Copyright (C) 2011-2012, Google Inc. This module may be used and copied on the same terms as Perl itself.
To install Mail::SendVarious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mail::SendVarious
CPAN shell
perl -MCPAN -e shell install Mail::SendVarious
For more information on module installation, please visit the detailed CPAN module installation guide.