使用Ruby编写发送邮件的程序的简单教程
SMTP(SimpleMailTransferProtocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。
Ruby提供了Net::SMTP来发送邮件,并提供了两个方法new和start:
new方法有两个参数:
- servername默认为localhost
- portnumber默认为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:PrivatePerson<me@fromdomain.com>
To:ATestUser<test@todomain.com>
Subject:SMTPe-mailtest
Thisisateste-mailmessage.
MESSAGE_END
Net::SMTP.start('localhost')do|smtp|
smtp.send_messagemessage,'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的邮件服务器,如果需要填写用户名密码,则代码如下:
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:PrivatePerson<me@fromdomain.com>
To:ATestUser<test@todomain.com>
MIME-Version:1.0
Content-type:text/html
Subject:SMTPe-mailtest
Thisisane-mailmessagetobesentinHTMLformat
<b>ThisisHTMLmessage.</b>
<h1>Thisisheadline.</h1>
MESSAGE_END
Net::SMTP.start('localhost')do|smtp|
smtp.send_messagemessage,'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
Thisisatestemailtosendanattachement.
EOF
#定义主要的头部信息
part1=<<EOF
From:PrivatePerson<me@fromdomain.net>
To:ATestUser<test@todmain.com>
Subject:SendingAttachement
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
rescueException=>e
print"Exceptionoccured:"+e
end
注意:你可以指定多个发送的地址,但需要使用逗号隔开。