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脚本来发送邮件:

  1. require 'net/smtp'
  2.  
  3. message = <<MESSAGE_END
  4. From: Private Person <me@fromdomain.com>
  5. To: A Test User <test@todomain.com>
  6. Subject: SMTP e-mail test
  7.  
  8. This is a test e-mail message.
  9. MESSAGE_END
  10.  
  11. Net::SMTP.start('localhost') do |smtp|
  12. smtp.send_message message, 'me@fromdomain.com',
  13. 'test@todomain.com'
  14. end
在以上实例中,你已经设置了一个基本的电子邮件消息,注意正确的标题格式。一个电子邮件要要From,To和Subject,文本内容与头部信息间需要一个空行。

使用Net::SMTP连接到本地机器上的SMTP服务器,使用send_message方法来发送邮件,方法参数为发送者邮件与接收者邮件。

如果你没有运行在本机上的SMTP服务器,您可以使用Net::SMTP与远程SMTP服务器进行通信。如果使用网络邮件服务(如Hotmail或雅虎邮件),您的电子邮件提供者会为您提供发送邮件服务器的详细信息:

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

以上代码将连接主机为 mail.your-domain.com,端口号为 25的邮件服务器,如果需要填写用户名密码,则代码如下:

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

以上实例使用了指定的用户名密码连接到主机为 mail.your-domain.com,端口号为 25的邮件服务器。

使用 Ruby 发送 HTML 邮件

Net::SMTP同样提供了支持发送 HTML 格式的邮件。

发送电子邮件时你可以设置MIME版本,文档类型,字符集来发送HTML格式的邮件。

实例

以下实例用于发送 HTML 格式的邮件:

  1. require 'net/smtp'
  2.  
  3. message = <<MESSAGE_END
  4. From: Private Person <me@fromdomain.com>
  5. To: A Test User <test@todomain.com>
  6. MIME-Version: 1.0
  7. Content-type: text/html
  8. Subject: SMTP e-mail test
  9.  
  10. This is an e-mail message to be sent in HTML format
  11.  
  12. <b>This is HTML message.</b>
  13. <h1>This is headline.</h1>
  14. MESSAGE_END
  15.  
  16. Net::SMTP.start('localhost') do |smtp|
  17. smtp.send_message message, 'me@fromdomain.com',
  18. 'test@todomain.com'
  19. end

发送带附件的邮件

如果需要发送混合内容的电子邮件,需要设置Content-type为multipart/mixed。 这样就可以在邮件中添加附件内容。

附件在传输前需要使用 pack("m") 函数将其内容转为 base64 格式。

实例

以下实例将发送附件为 /tmp/test.txt 的邮件:

  1. require 'net/smtp'
  2.  
  3. filename = "/tmp/test.txt"
  4. # 读取文件并编码为base64格式
  5. filecontent = File.read(filename)
  6. encodedcontent = [filecontent].pack("m") # base64
  7.  
  8. marker = "AUNIQUEMARKER"
  9.  
  10. body =<<EOF
  11. This is a test email to send an attachement.
  12. EOF
  13.  
  14. # 定义主要的头部信息
  15. part1 =<<EOF
  16. From: Private Person <me@fromdomain.net>
  17. To: A Test User <test@todmain.com>
  18. Subject: Sending Attachement
  19. MIME-Version: 1.0
  20. Content-Type: multipart/mixed; boundary=#{marker}
  21. --#{marker}
  22. EOF
  23.  
  24. # 定义消息动作
  25. part2 =<<EOF
  26. Content-Type: text/plain
  27. Content-Transfer-Encoding:8bit
  28.  
  29. #{body}
  30. --#{marker}
  31. EOF
  32.  
  33. # 定义附件部分
  34. part3 =<<EOF
  35. Content-Type: multipart/mixed; name=\"#{filename}\"
  36. Content-Transfer-Encoding:base64
  37. Content-Disposition: attachment; filename="#{filename}"
  38.  
  39. #{encodedcontent}
  40. --#{marker}--
  41. EOF
  42.  
  43. mailtext = part1 + part2 + part3
  44.  
  45. # 发送邮件
  46. begin
  47. Net::SMTP.start('localhost') do |smtp|
  48. smtp.sendmail(mailtext, 'me@fromdomain.net',
  49. ['test@todmain.com'])
  50. end
  51. rescue Exception => e
  52. print "Exception occured: " + e
  53. end

注意:你可以指定多个发送的地址,但需要使用逗号隔开。