email::send::smtp(3pm) [debian man page]

Email::Send::SMTP(3pm)					User Contributed Perl Documentation				    Email::Send::SMTP(3pm)

NAME

       Email::Send::SMTP - Send Messages using SMTP

SYNOPSIS

	 use Email::Send;

	 my $mailer = Email::Send->new({mailer => 'SMTP'});

	 $mailer->mailer_args([Host => 'smtp.example.com:465', ssl => 1])
	   if $USE_SSL;

	 $mailer->send($message);

DESCRIPTION

       This mailer for "Email::Send" uses "Net::SMTP" to send a message with an SMTP server. The first invocation of "send" requires an SMTP
       server arguments. Subsequent calls will remember the the first setting until it is reset.

       Any arguments passed to "send" will be passed to "Net::SMTP->new()", with some exceptions. "username" and "password", if passed, are used
       to invoke "Net::SMTP->auth()" for SASL authentication support.  "ssl", if set to true, turns on SSL support by using "Net::SMTP::SSL".

       SMTP can fail for a number of reasons. All return values from this package are true or false. If false, sending has failed. If true, send
       succeeded. The return values are "Return::Value" objects, however, and contain more information on just what went wrong.

       Here is an example of dealing with failure.

	 my $return = send SMTP => $message, 'localhost';

	 die "$return" if ! $return;

       The stringified version of the return value will have the text of the error. In a conditional, a failure will evaluate to false.

       Here's an example of dealing with success. It is the case that some email addresses may not succeed but others will. In this case, the
       return value's "bad" property is set to a list of bad addresses.

	 my $return = send SMTP => $message, 'localhost';

	 if ( $return ) {
	     my @bad = @{ $return->prop('bad') };
	     warn "Failed to send to: " . join ', ', @bad
	       if @bad;
	 }

       For more information on these return values, see Return::Value.

   ENVELOPE GENERATION
       The envelope sender and recipients are, by default, generated by looking at the From, To, Cc, and Bcc headers.  This behavior can be
       modified by replacing the "get_env_sender" and "get_env_recipients" methods, both of which receive the Email::Simple object and their only
       parameter, and return email addresses.

SEE ALSO

       Email::Send, Net::SMTP, Net::SMTP::SSL, Email::Address, Return::Value, perl.

AUTHOR

       Current maintainer: Ricardo SIGNES, <rjbs@cpan.org>.

       Original author: Casey West, <casey@geeknest.com>.

COPYRIGHT

	 Copyright (c) 2004 Casey West.  All rights reserved.
	 This module is free software; you can redistribute it and/or modify it
	 under the same terms as Perl itself.

perl v5.12.4							    2009-07-12						    Email::Send::SMTP(3pm)

Check Out this Related Man Page

Email::Sender::Transport::SMTP::TLS(3pm)		User Contributed Perl Documentation		  Email::Sender::Transport::SMTP::TLS(3pm)

NAME

       Email::Sender::Transport::SMTP::TLS - Email::Sender with Net::SMTP::TLS (Eg. Gmail)

VERSION

       version 0.10

SYNOPSIS

	   use Email::Sender::Simple qw(sendmail);
	   use Email::Sender::Transport::SMTP::TLS;
	   use Try::Tiny;

	   my $transport = Email::Sender::Transport::SMTP::TLS->new(
	       host => 'smtp.gmail.com',
	       port => 587,
	       username => 'username@gmail.com',
	       password => 'password',
	       helo => 'fayland.org',
	   );

	   # my $message = Mail::Message->read($rfc822)
	   #	     || Email::Simple->new($rfc822)
	   #	     || Mail::Internet->new([split /
/, $rfc822])
	   #	     || ...
	   #	     || $rfc822;
	   # read L<Email::Abstract> for more details

	   use Email::Simple::Creator; # or other Email::
	   my $message = Email::Simple->create(
	       header => [
		   From    => 'username@gmail.com',
		   To	   => 'to@mail.com',
		   Subject => 'Subject title',
	       ],
	       body => 'Content.',
	   );

	   try {
	       sendmail($message, { transport => $transport });
	   } catch {
	       die "Error sending email: $_";
	   };

DESCRIPTION

       Email::Sender replaces the old and sometimes problematic Email::Send library, while this module replaces the Email::Send::SMTP::TLS.

       It is still alpha, but it works. use it at your own risk!

   ATTRIBUTES
       The following attributes may be passed to the constructor:

       host - the name of the host to connect to; defaults to localhost
       port - port to connect to; defaults to 587
       username - the username to use for auth; required
       password - the password to use for auth; required
       helo - what to say when saying HELO; no default
       allow_partial_success - if true, will send data even if some recipients were rejected

   PARTIAL SUCCESS
       If "allow_partial_success" was set when creating the transport, the transport may return Email::Sender::Success::Partial objects.  Consult
       that module's documentation.

AUTHOR

       Fayland Lam <fayland@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Fayland Lam.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.14.2							    2012-06-25				  Email::Sender::Transport::SMTP::TLS(3pm)

Linux and UNIX Man Pages

email::send::smtp(3pm) [debian man page]

Check Out this Related Man Page