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或yahoo邮件),您的电子邮件供给者会为您供给发送邮件服务器的详细信息:

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  

留意:你能够指定多个发送的地址,但需求运用逗号离隔。