WIP: Rails Action Mailer Document

创建: 2019/10/01

 

设定
 Action Mailer的设定参数

 

 delivery_method

 发送邮件的方法

 ● 默认: :smtp

 ● 可设定值

 

 :smtp  经smtp服务器发送
 :sendmail  用sendmail命令
 :file  把邮件作为文件保存
 :test

 测试模式

 (把邮件已数组形式返回)

 

 default_options  默认的邮件header
 interceptors  应用的interceptor
 perform_deliveries

 delivery方法是否实际发送邮件

 ● 默认: true

 raise_delivery_errors

 邮件发送失败时是否抛出error

 ● 默认: true

 show_previews

 mail preview功能是否有效

 ● 默认: development环境 true

           test/product环境  false

 smtp_settings

 smtp模式下的设定 

 address

 smtp服务器的主机名

 ● 默认 localhost

 port

 smtp服务器的port

 ● 默认: 25

 domain

 HELO domain

 ● 默认: localhost.localdomain

 user_name  用户名
 password  密码 
 authentication

 认证方法

 :plain, :login, :cram_md5

 

 sendmail_settings

 sendmail模式下的设定

 location

 命令的位置

 ● 默认: /usr/bin/sendmail

 arguments

 sendmail命令的选项

 ● 默认: -i -t

 

 file_settings

 file模式下的设定

 location

 信息的保存位置

 ● 默认: #{Rails.root}/tmp/mails

   

 

   

 

   
发送邮件
 生成mailer  
rails generate mailer name method [options]

 

 name  mailer名
 method  方法名
 options

 

 -f --force  已经存在的文件则覆盖
 -p --pretend  不生成文件,只是测试运行结果
 -q --quiet  不显示过程(进度)
 -s --skip  存在同名文件则跳过该文件

 

 例:

rails g mailer learning_mailer::sample t1 t2 t3 t4

 

 

 编辑mailer

 

 default

 设定此mailer的默认header

  default header: value [, ...] 

 to, cc, bcc  收件人,抄送,密送
 subject  邮件内容 
 from  发信人
 date  发送日期时间
 reply_to  回复时接收的邮箱

 x_priority/

 x_msmail_priority

 邮件的重要度

 (x_priority的1, x_msmail_priority的High为最高)

 content_type

 内容种类

 ● 默认: text/plain

 charset

 使用的字符码

 ● 默认: UTF-8

 parts_order

 复杂内容的插入顺序?

 ● 默认: ["text/plain", "text/enriched", "text/html"] 

 mime_version  MIME的version
   

 

 mail

 发送邮件
 (相当于render)

 

mail headers

 

  headers

 header信息

 参见default

   

 

 

 编辑view 

 

 和controller的view的不同:

 

 url_for

 mailer里没有绝对路径,故需指定host

url_for host: "www.xxx.com", controller: "a", action: "b"

 

   

 

   

 

   
   
多种格式发送邮件
 html邮件  html.erb
 附加文件

 

attachments['file.file'] = File.read(Rails.root.join(....))

 

 

 layout   TODO
   
   
preview邮件
   test/mailers/previews/里下测试代码
   
   
   
   
发送前进行处理
   类名随意, 推荐最后Interceptor
 条件

 实现self.delivering_email(mail)方法

 mail是Mail::Message类

   
   
   
mailer的unit test
   TODO
   
   
   
   

转载于:https://www.cnblogs.com/lancgg/p/11614799.html

你可能感兴趣的:(WIP: Rails Action Mailer Document)