Ruby 發送郵件– SMTP
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 <[email protected]> To: A Test User <[email protected]> Subject: SMTP e-mail test This is a test e-mail message. MESSAGE_END Net::SMTP.start('localhost') do |smtp| smtp.send_message message, '[email protected]', '[email protected]' 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 <[email protected]> To: A Test User <[email protected]> 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, '[email protected]', '[email protected]' 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 <[email protected]> To: A Test User <[email protected]> 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, '[email protected]', ['[email protected]']) end rescue Exception => e print "Exception occured: " + e end
注意:你可以指定多個發送的地址,但需要使用逗號隔開。