SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。
Ruby提供了 Net::SMTP 来发送邮件,并提供了两个方法 new 和 start:
SMTP 对象实例化方法调用了 sendmail, 参数如下:
以下提供了简单的Ruby脚本来发送邮件:
在以上实例中,你已经设置了一个基本的电子邮件消息,注意正确的标题格式。一个电子邮件要要From,To和Subject,文本内容与头部信息间需要一个空行。
- 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
使用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的邮件服务器。
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
注意:你可以指定多个发送的地址,但需要使用逗号隔开。