Ruby 發送郵件 - SMATP


SMTP（Simple Mail Transfer Protocol）即簡單郵件傳輸協定,它是一組用於由來源位址到目的位址傳送郵件的規則，由它來控制信件的中轉方式。

Ruby提供了Net::SMTP 來傳送郵件，並提供了兩個方法new  和start:

new 方法有兩個參數：

  • server name 預設為localhost

  • #port number 預設為 25

#start 方法有以下參數：

  • server  - SMTP 伺服器IP, 預設為localhost

  • #port  - 埠號，預設為25

  • domain - 郵件發送者域名，預設為ENV["HOSTNAME "]

  • account - 使用者名，預設為nil

  • password - 使用者密碼，預設為nil

  • authtype - 驗證類型，預設為cram_md5

SMTP 對象實例化方法呼叫了sendmail, 參數如下：

  • source  - 一個字串或陣列或每個迭代器在任一時間中傳回的任何東西。

  • sender -一個字串，出現在 email 的表單欄位。

  • 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


在上述實例中，你已經設定了一個基本的電子郵件訊息，注意正確的標題格式。一個電子郵件要要From，To和Subject，文字內容與頭部訊息間需要一個空白行。


使用Net::SMTP連接到本機上的SMTP伺服器，使用send_message方法來傳送郵件，方法參數為發送者郵件與接收者郵件。

如果你沒有運行在本機上的SMTP伺服器，您可以使用Net::SMTP與遠端SMTP伺服器進行通訊。如果使用網頁郵件服務（如Hotmail或雅虎郵件），您的電子郵件提供者會為您提供發送郵件伺服器的詳細資訊:

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

以上程式碼將連接主機為mail.your-domain.com ，連接埠號碼為25的郵件伺服器，如果需要填寫使用者名稱密碼，則代碼如下：


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

以上實例使用了指定的使用者名稱密碼連接到主機為mail .your-domain.com，連接埠號碼為25的郵件伺服器。

使用 Ruby 傳送 HTML 郵件

Net::SMTP同樣提供了支援傳送 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。 這樣就可以在郵件中加入附件內容。

附件在傳輸前需要使用 pack("m") 函數將其內容轉換​​為 base64 格式。

實例

以下實例將發送附件為/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

# 定义消息动作
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

# 发送邮件
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

注意：你可以指定多個發送的地址，但需要使用逗號隔開。