Class Mail::SMTP
In: lib/mail/network/delivery_methods/smtp.rb
Parent: Object

Sending Email with SMTP

Mail allows you to send emails using SMTP. This is done by wrapping Net::SMTP in an easy to use manner.

Sending via SMTP server on Localhost

Sending locally (to a postfix or sendmail server running on localhost) requires no special setup. Just to Mail.deliver &block or message.deliver! and it will be sent in this method.

Sending via MobileMe

  Mail.defaults do
    delivery_method :smtp, { :address              => "smtp.me.com",
                             :port                 => 587,
                             :domain               => 'your.host.name',
                             :user_name            => '<username>',
                             :password             => '<password>',
                             :authentication       => 'plain',
                             :enable_starttls_auto => true  }
  end

Sending via GMail

  Mail.defaults do
    delivery_method :smtp, { :address              => "smtp.gmail.com",
                             :port                 => 587,
                             :domain               => 'your.host.name',
                             :user_name            => '<username>',
                             :password             => '<password>',
                             :authentication       => 'plain',
                             :enable_starttls_auto => true  }
  end

Certificate verification

When using TLS, some mail servers provide certificates that are self-signed or whose names do not exactly match the hostname given in the address. OpenSSL will reject these by default. The best remedy is to use the correct hostname or update the certificate authorities trusted by your ruby. If that isn‘t possible, you can control this behavior with an :openssl_verify_mode setting. Its value may be either an OpenSSL verify mode constant (OpenSSL::SSL::VERIFY_NONE), or a string containing the name of an OpenSSL verify mode (none, peer, client_once, fail_if_no_peer_cert).

Others

Feel free to send me other examples that were tricky

Delivering the email

Once you have the settings right, sending the email is done by:

  Mail.deliver do
    to 'mikel@test.lindsaar.net'
    from 'ada@test.lindsaar.net'
    subject 'testing sendmail'
    body 'testing sendmail'
  end

Or by calling deliver on a Mail message

  mail = Mail.new do
    to 'mikel@test.lindsaar.net'
    from 'ada@test.lindsaar.net'
    subject 'testing sendmail'
    body 'testing sendmail'
  end

  mail.deliver!

Methods

deliver!   new  

Attributes

settings  [RW] 

Public Class methods

Public Instance methods

Send the message via SMTP. The from and to attributes are optional. If not set, they are retrieve from the Message.

[Validate]