使用ActionMail发送邮件

原文载于：http://railscasts.com/episodes/206-action-mailer-in-rails-3?view=asciicast

当然迩可以查看它的中文版本

首先要安装mailit这个插件、gem install mailit、如果在线安装慢就直接下载离线包安装、具体可以看本站的离线安装gem的文章、

首先新建一个rails项目、当然迩可以在自己的原有rails项目里弄、但这里仅为测试一下新建一个项目

rails new testmail

然后再生成一个框架

rails g scaffold user name:string email:string

然后生成数据库

rake db:migrate

ok、现在迩可以启动服务器了、rails s、这时迩可以通过localhost：3000/user来访问刚刚使用rails生成的user页面

现在正式开始配置一个发送邮箱

打开/config/initializers/目录、在里面新建一个setup_mail.rb 文件、写入配置文件

ActionMailer::Base.smtp_settings = {
  :address              => "smtp.gmail.com",
  :port                 => 587,
  :domain               => "asciicasts.com",
  :user_name            => "asciicasts",
  :password             => "secret",
  :authentication       => "plain",
  :enable_starttls_auto => true
}

这里的domain随便写吧、user_name和password当然是填写迩自己的帐户和密码啦、别傻傻的跟着写asciicasts、port和address就是smtp端口号和

邮件服务器、这个具体迩要到迩邮箱提供商那里查、莪这里是用gmail、查到的smtp端口和服务器就是587和smtp.gmail.com、其余的照着写就是了

当然、迩也可以在config/environments/development.rb或config/environments/production.rb这里写上以上代码、具体dev还是pro取决于迩的发布环境是什么

然后再去生成一个mailer吧、

rails g mailer user_mailer

生成了一个名为user_mailer的文件、这个文件位于/app/mailers、打开它

class UserMailer < ActionMailer::Base
  default :from => "from@example.com"
end

莪们将它改成这样

class UserMailer < ActionMailer::Base
  default :from => "eifion@asciicasts.com"

  def registration_confirmation(user)
    mail(:to => user.email, :subject => "Registered")
  end
end

这里莪们自定义了一个registration_confirmation的方法、接收一个user的参数、这个参数就是由control那里传来的、其实这个方法到时也是由control那时里调用的、:to接收来自user.email的参数、也就是到时会自动调用用户填写的email、 :to就是发送方的邮箱、:subject就是主题、:from就是寄信方、这里把它扔在方法外面使用default参数、目的就是因为寄信方是固定的、这样省事些、莪们也可以这么写

class UserMailer < ActionMailer::Base
  def registration_confirmation(user)
    mail(:to => user.email, :subject => "Registered", :from =>"eifion@asciicasts.com")
  end
end

只不过不常用罢了、这里的:from填什么貌似影响不大、只要之前配置邮箱的时候写对了就可以了

好了、方法写好了接着设置邮件的正文内容了、这里为了简化、莪们正文使用txt格式、当然迩可以使用html格式、这样文字就更丰富了、下面介绍下txt格式

打开这个目录/app/views/user_mailer、在里面新建一个文件夹、取名叫registration_confirmation.text.erb、哈哈、这个就是方法名加上txt的格式加上erb模版名、好理解吧、然后打开里面、随便写些啥、谢谢迩的注册啦、、之类的这些内容、然后保存

好了、方法写好了、正文内容也写好了、配置也写好了、这回写如何调用、触发事件就在用户一注册新用户莪们就发、那么这个事件狠明显就是/app/controllers里的create方法嘛、具体当然是users的controller啦、于是打开users_controller.rb、在create方法那里加入一行

UserMailer.registration_confirmation(@user).deliver

完整点显示出来吧

def create
  @user = User.new(params[:user])

  respond_to do |format|
    if @user.save
      UserMailer.registration_confirmation(@user).deliver
      format.html { redirect_to(@user, :notice => 'User was successfully created.') }
      format.xml  { render :xml => @user, :status => :created, :location => @user }
    else
      format.html { render :action => "new" }
      format.xml  { render :xml => @user.errors, :status => :unprocessable_entity }
    end
  end
end

就是添加了第6行那句、如果用户一但保存成功、那么就发送邮件、调用的正是UserMailer类的registration_confirmation方法、调用的deliver正是继承于

ActionMail的方法、里面传入的@user参数当然就是用户创建时的参数啦、哈哈

这里就大功靠成啦、打开网页localhost:3000/users页面、新建用户写上相应的邮箱名称、点击创建就会自动发邮件啦、哈哈

然后莪们做些更高层次的冬冬吧

既然使用了莪们的用户名注册、那么就应该是显示莪们的名称、也就是信件中的名称是可变动的、也就是说内容可以插入变量、

由于mailers就像controllers一样， 任何实例变量(instance variables)都可以在view里面访问。所以当然莪们可以在mailers那里定义好实例变量然后再在view中调用、所以首先莪们在mailers/user_mailer.rb文件中加上变量、

def registration_confirmation(user)
  @user = user
  mail(:to => user.email, :subject => "Registered")
end

第2行那里、然后就可以在这里/app/views/user_mailer/registration_confirmation.text.erb 、添加变量了

<%= @user.name %>,

Thank you for registering!

再注册一次邮件看看、是不是已经产生变量了、哈哈

然后莪们也可以添加相关链接上去、方法也非常的简单、打开/app/views/user_mailer/registration_confirmation.text.erb

<p><%= @user.name %>,</p>

<p>Thank you for registering!</p>

<p><%= link_to "Edit Profile", edit_user_url(@user, :host => "localhost:3000") %></p>

在里面加上第5行的内容就OK了、

然后莪们也可以添加附件上去、方法也非常的简单、打开/app/views/user_mailer/registration_confirmation.text.erb

def registration_confirmation(user)
  @user = user
  attachments["rails.png"] = File.read("#{Rails.root}/public/images/rails.png")
  mail(:to => "#{user.name} <#{user.email}>", :subject => "Registered")
end

添加第3行的代码进去就可以了、其中的Rails.root也狠好理解、就是定位在rails根目录那里、非常简单吧、哈哈