NAME

Email::Sender::Transport::SMTP - send email over SMTP

VERSION

version 1.300022

DESCRIPTION

This transport is used to send email over SMTP, either with or without secure sockets (SSL/TLS). It is one of the most complex transports available, capable of partial success.

For a potentially more efficient version of this transport, see Email::Sender::Transport::SMTP::Persistent.

ATTRIBUTES

The following attributes may be passed to the constructor:

host: the name of the host to connect to; defaults to localhost

ssl: 'ssl' / 'starttls' / undef, if true, passed to Net::SMTPS doSSL.

port: port to connect to; defaults to 25 for non-SSL, 465 for 'ssl' and 587 for 'starttls'

timeout: maximum time in secs to wait for server; default is 120

sasl_username: the username to use for auth; optional

sasl_password: the password to use for auth; required if username is provided

allow_partial_success: if true, will send data even if some recipients were rejected; defaults to false

helo: what to say when saying HELO; no default

localaddr: local address from which to connect

localport: local port from which to connect

debug: if true, put the Net::SMTP object in debug mode

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.

EXAMPLES

send email with Gmail

my $smtp  = Email::Sender::Transport::SMTP->new({
  host => 'smtp.gmail.com',
  ssl  => 'starttls',
  sasl_username => 'myaccount@gmail.com',
  sasl_password => 'mypassword',
});

AUTHOR

Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Ricardo Signes.

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