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
2
3
4
5
6
7
8
9
10
11
12
13
14
|
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的邮件服务器,如果需要填写用户名密码,则代码如下:
1
2
3
4
|
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 格式的邮件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
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 的邮件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
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 |
注意:你可以指定多个发送的地址,但需要使用逗号隔开。