Ruby 發(fā)送郵件 - SMATP

SMTP（Simple Mail Transfer Protocol）即簡(jiǎn)單郵件傳輸協(xié)議,它是一組用于由源地址到目的地址傳送郵件的規(guī)則，由它來(lái)控制信件的中轉(zhuǎn)方式。

Ruby提供了 Net::SMTP 來(lái)發(fā)送郵件，并提供了兩個(gè)方法 new 和 start:

• new 方法有兩個(gè)參數(shù)：
  • server name 默認(rèn)為 localhost
  • port number 默認(rèn)為 25
• start 方法有以下參數(shù)：
  • server - SMTP 服務(wù)器 IP, 默認(rèn)為 localhost
  • port - 端口號(hào)，默認(rèn)為 25
  • domain - 郵件發(fā)送者域名，默認(rèn)為 ENV["HOSTNAME"]
  • account - 用戶(hù)名，默認(rèn)為 nil
  • password - 用戶(hù)密碼，默認(rèn)為nil
  • authtype - 驗(yàn)證類(lèi)型，默認(rèn)為 cram_md5

SMTP 對(duì)象實(shí)例化方法調(diào)用了 sendmail, 參數(shù)如下：

• source - 一個(gè)字符串或數(shù)組或每個(gè)迭代器在任一時(shí)間中返回的任何東西。
• sender -一個(gè)字符串，出現(xiàn)在 email 的表單字段。
• recipients - 一個(gè)字符串或字符串?dāng)?shù)組，表示收件人的地址。

實(shí)例

以下提供了簡(jiǎn)單的Ruby腳本來(lái)發(fā)送郵件:

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

在以上實(shí)例中，你已經(jīng)設(shè)置了一個(gè)基本的電子郵件消息，注意正確的標(biāo)題格式。一個(gè)電子郵件要要From，To和Subject，文本內(nèi)容與頭部信息間需要一個(gè)空行。

使用Net::SMTP連接到本地機(jī)器上的SMTP服務(wù)器，使用send_message方法來(lái)發(fā)送郵件，方法參數(shù)為發(fā)送者郵件與接收者郵件。

如果你沒(méi)有運(yùn)行在本機(jī)上的SMTP服務(wù)器，您可以使用Net::SMTP與遠(yuǎn)程SMTP服務(wù)器進(jìn)行通信。如果使用網(wǎng)絡(luò)郵件服務(wù)（如Hotmail或雅虎郵件），您的電子郵件提供者會(huì)為您提供發(fā)送郵件服務(wù)器的詳細(xì)信息:

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

以上代碼將連接主機(jī)為 mail.your-domain.com，端口號(hào)為 25的郵件服務(wù)器，如果需要填寫(xiě)用戶(hù)名密碼，則代碼如下：

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

以上實(shí)例使用了指定的用戶(hù)名密碼連接到主機(jī)為 mail.your-domain.com，端口號(hào)為 25的郵件服務(wù)器。

使用 Ruby 發(fā)送 HTML 郵件

Net::SMTP同樣提供了支持發(fā)送 HTML 格式的郵件。

發(fā)送電子郵件時(shí)你可以設(shè)置MIME版本，文檔類(lèi)型，字符集來(lái)發(fā)送HTML格式的郵件。

實(shí)例

以下實(shí)例用于發(fā)送 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

發(fā)送帶附件的郵件

如果需要發(fā)送混合內(nèi)容的電子郵件，需要設(shè)置Content-type為multipart/mixed。 這樣就可以在郵件中添加附件內(nèi)容。

附件在傳輸前需要使用 pack("m") 函數(shù)將其內(nèi)容轉(zhuǎn)為 base64 格式。

實(shí)例

以下實(shí)例將發(fā)送附件為 /tmp/test.txt 的郵件：

require 'net/smtp'

filename = "/tmp/test.txt"
# 讀取文件并編碼為base64格式
filecontent = File.read(filename)
encodedcontent = [filecontent].pack("m")   # base64

marker = "AUNIQUEMARKER"

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

# 定義主要的頭部信息
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

# 定義消息動(dòng)作
part2 =<<EOF
Content-Type: text/plain
Content-Transfer-Encoding:8bit

#{body}
--#{marker}
EOF

# 定義附件部分
part3 =<<EOF
Content-Type: multipart/mixed; name=\"#{filename}\"
Content-Transfer-Encoding:base64
Content-Disposition: attachment; filename="#{filename}"

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

mailtext = part1 + part2 + part3

# 發(fā)送郵件
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  

注意：你可以指定多個(gè)發(fā)送的地址，但需要使用逗號(hào)隔開(kāi)。