Ruby SMTP發送Email

簡單郵件傳輸協議（SMTP）發送電子郵件及路由的e-mail郵件服務器之間的協議處理。

Ruby 提供 Net::SMTP 類的簡單郵件傳輸協議（SMTP）客戶端的連接，並提供了兩個新的方法：new 和 start.

new 帶兩個參數:
- server name 默認為 localhost
- port number 默認為熟知的 25
start 方法帶有以下這些參數:
- server - IP SMTP服務器名稱，默認為localhost
- port - 端口號，默認為25
- domain - 郵件發件人的域名，默認為 ENV["HOSTNAME"]
- account - 用戶名，默認為 nil
- password - 用戶密碼，默認為 nil
- authtype - 授權類型，默認為 cram_md5

SMTP對象有一個實例方法調用sendmail，後者通常會被用來做郵寄消息的工作。它有三個參數：

source - 字符串或數組或任何同每個迭代一次返回一個字符串。
sender - 一個字符串，它將會出現在電子郵件字段中。
recipients - 代表收件人的地址的字符串的字符串或數組

例子:

下麵是一個簡單使用Ruby腳本的方法來發送一個電子郵件。試一次看看吧：

require 'net/smtp'

message = <<MESSAGE_END
From: Private Person <me@fromdomain.com>
To: A Test User <test@todomain.com>
Subject: SMTP e-mail test

This is a test e-mail message.
MESSAGE_END

Net::SMTP.start('localhost') do |smtp|
  smtp.send_message message, 'me@fromdomain.com', 
                             'test@todomain.com'
end

在這裡已經放置了一個基本的電子郵件消息，使用文件，在這裡同時注意正確格式化標題。一封郵件需要發件人，收件人，主題頭，從電子郵件的主體有一個空白行分隔。

隨著消息要發送郵件使用Net::SMTP連接到本地機器上的SMTP服務器，然後使用 send_message 方法，從地址，目的地址作為參數（即使地址電子郵件本身範圍內，這些並非總是用來將郵件路由）。

如果還冇有在機器上運行一個SMTP服務器，可以使用的Net::SMTP遠程SMTP服務器進行通信。除非使用一個webmail服務（如Hotmail或雅虎郵件），電子郵件提供商將提供外發郵件服務器的細節，可以提Net::SMTP，具體如下：

Net::SMTP.start('mail.your-domain.com')

這行代碼連接到SMTP服務器mail.your-domain.com 端口25。，而無需使用任何用戶名或密碼。不過，如果需要的話可以指定端口號或其他參數等。例如：

Net::SMTP.start('mail.your-domain.com', 
                25, 
                'localhost', 
                'username', 'password' :plain)

這個例子連接mail.your-domain.com到SMTP服務器使用的用戶名和密碼以純文本格式。它標識為localhost客戶端的主機名。

使用Ruby發送HTML電子郵件：

當想要發送文本消息，Ruby所有內容將被視為簡單的文本。即使會在短信中包含HTML標記，它會顯示簡單的文本和HTML標記將不會格式化HTML語法。但是Ruby的 Net::SMTP 提供了實際的HTML郵件發送HTML消息的選項。

在發送電子郵件消息時，可以指定一個MIME版本，內容類型和字符集發送HTML電子郵件。

例如：

下麵的例子作為電子郵件發送HTML內容。試一次看看吧：

require 'net/smtp'

message = <<MESSAGE_END
From: Private Person <me@fromdomain.com>
To: A Test User <test@todomain.com>
MIME-Version: 1.0
Content-type: text/html
Subject: SMTP e-mail test

This is an e-mail message to be sent in HTML format

<b>This is HTML message.</b>
<h1>This is headline.</h1>
MESSAGE_END

Net::SMTP.start('localhost') do |smtp|
  smtp.send_message message, 'me@fromdomain.com', 
                             'test@todomain.com'
end

作為電子郵件的附件發送：

混合內容發送一封電子郵件，要求設置Content-type頭為 multipart/mixed。然後，文本和附件部分可以指定 boundaries 範圍內。

兩個連字符後跟一個唯一的編號，不能出現在電子郵件的消息部分的邊界開始。最後一個邊界表示電子郵件的最後一節的結尾也必須有兩個連字符。

附加文件使用 pack("m") 函數來base64編碼傳輸之前進行編碼。

例子:

下麵的例子將文件 /tmp/test.txt 作為附件發送。試一次看看吧：

require 'net/smtp'

filename = "/tmp/test.txt"
# Read a file and encode it into base64 format
filecontent = File.read(filename)
encodedcontent = [filecontent].pack("m")   # base64

marker = "AUNIQUEMARKER"

body =<<EOF
This is a test email to send an attachement.
EOF

# Define the main headers.
part1 =<<EOF
From: Private Person <me@fromdomain.net>
To: A Test User <test@todmain.com>
Subject: Sending Attachement
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary=#{marker}
--#{marker}
EOF

# Define the message action
part2 =<<EOF
Content-Type: text/plain
Content-Transfer-Encoding:8bit

#{body}
--#{marker}
EOF

# Define the attachment section
part3 =<<EOF
Content-Type: multipart/mixed; name="#{filename}"
Content-Transfer-Encoding:base64
Content-Disposition: attachment; filename="#{filename}"

#{encodedcontent}
--#{marker}--
EOF

mailtext = part1 + part2 + part3

# Let's put our code in safe area
begin 
  Net::SMTP.start('localhost') do |smtp|
     smtp.sendmail(mailtext, 'me@fromdomain.net',
                          ['test@todmain.com'])
  end
rescue Exception => e  
  print "Exception occured: " + e  
end

注意：可以指定多個目的地內部數組，但他們需要用逗號分隔。