【Ruby学习笔记】21.Ruby CGI Session及发送邮件 - SMTP
前言
本章介绍Ruby的CGI Session和发送邮件 - SMTP。
Ruby CGI Session
CGI::Session 可以为用户和CGI环境保存持久的会话状态，会话使用后需要关闭，这样可以保证数据写入到存储当中，当会话完成后，你需要删除该数据。
实例
#!/usr/bin/ruby
require 'cgi'
require 'cgi/session'
cgi = CGI.new("html4")
sess = CGI::Session.new( cgi, "session_key" => "a_test",
"prefix" => "rubysess.")
lastaccess = sess["lastaccess"].to_s
sess["lastaccess"] = Time.now
if cgi['bgcolor'][0] =~ /[a-z]/
sess["bgcolor"] = cgi['bgcolor']
end
cgi.out{
cgi.html {
cgi.body ("bgcolor" => sess["bgcolor"]){
"The background of this page" +
"changes based on the 'bgcolor'" +
"each user has in session." +
"Last access time: #{lastaccess}"
}
}
}
访问 “/cgi-bin/test.cgi?bgcolor=red” 将跳转到指定背景颜色的页面。
会话数据存在在服务器的临时文件目录中，prefix 参数指定了会话的前缀，将作为临时文件的前缀。这样你在服务器上可以轻松的识别不同的会话临时文件。
CGI::Session 类
CGI::Session 保持了用户与 CGI 环境的持久状态。 会话可以在内存中，也可以在硬盘上。
类方法
Ruby 类 Class CGI::Session 提供了简单的方法来创建 session:
CGI::Session::new( cgi[, option])
启用一个新的 CGI 会话并返回相应的 CGI::Session 对象。选项可以是可选的哈希，可以是以下值：
- session_key: 键名保存会话 默认为 _session_id。
- session_id: 唯一的会话 ID。自动生成
- new_session: 如果为true，为当前会话创建一个新的Session id。 如果为 false, 通过session_id使用已存在的 session 标识。 如果省略该参数，如果可用则使用现有的会话，否则创建一个新的。
- database_manager: 用于保存 sessions 的类，可以是 CGI::Session::FileStore or CGI::Session::MemoryStore。默认为 FileStore。
- tmpdir: 对于 FileStore, 为 session 的错存储目录。
- prefix: 对于 FileStore, 为 session 文件的前缀。
实例化方法
| 序号 | 方法描述 |
|---|---|
| 1 | [ ] 返回给定 key 的值。查看实例。 |
| 2 | [ ]= 设置给定 key 的值。 查看实例。 |
| 3 | delete 调用底层数据库管理的删除方法。对于 FileStore, 删除包含 session 的物理文件。 对于 MemoryStore, 从内存中移除 session 数据。 |
| 4 | update 调用底层数据库管理的更新方法。 对于 FileStore, 将 session 写入到磁盘中。 对于 MemoryStore则无效果。 |
Ruby 发送邮件 - SMTP
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 = <
To: A Test User
Subject: SMTP e-mail test
This is a test e-mail message.
MESSAGE_END
Net::SMTP.start('localhost') do |smtp|
smtp.send_message message, '[email protected]',
'[email protected]'
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 = <
To: A Test User
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
This is HTML message.
This is headline.
MESSAGE_END
Net::SMTP.start('localhost') do |smtp|
smtp.send_message message, '[email protected]',
'[email protected]'
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 =<
To: A Test User
Subject: Sending Attachement
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary=#{marker}
--#{marker}
EOF
# 定义消息动作
part2 =< e
print "Exception occured: " + e
end
注意：你可以指定多个发送的地址，但需要使用逗号隔开。