Ruby on Rails 3.0 发布说明

安装 Rails 3：

# 如果你的设置需要，使用 sudo
$ gem install rails

1 升级到 Rails 3

如果你正在升级现有的应用程序，在进行升级之前最好有良好的测试覆盖率。你还应该先升级到 Rails 2.3.5，并确保你的应用程序仍然按预期运行，然后再尝试更新到 Rails 3。然后注意以下更改：

1.1 Rails 3 需要至少 Ruby 1.8.7

Rails 3.0 需要 Ruby 1.8.7 或更高版本。官方已经正式停止对所有之前的 Ruby 版本的支持，你应该尽早升级。Rails 3.0 也与 Ruby 1.9.2 兼容。

提示：请注意，Ruby 1.8.7 p248 和 p249 存在序列化错误，会导致 Rails 3.0 崩溃。Ruby Enterprise Edition 自 1.8.7-2010.02 版本以来已经修复了这些问题。在 1.9 方面，Ruby 1.9.1 无法使用，因为它在 Rails 3.0 上直接崩溃，所以如果你想在 1.9.x 上使用 Rails 3，请使用 1.9.2 以获得顺利的体验。

1.2 Rails 应用程序对象

作为支持在同一进程中运行多个 Rails 应用程序的基础工作的一部分，Rails 3 引入了应用程序对象的概念。应用程序对象保存所有应用程序特定的配置，与之前版本的 Rails 中的 config/environment.rb 非常相似。

现在每个 Rails 应用程序都必须有一个对应的应用程序对象。应用程序对象在 config/application.rb 中定义。如果你正在将现有应用程序升级到 Rails 3，你必须添加这个文件，并将适当的配置从 config/environment.rb 移动到 config/application.rb。

1.3 script/* 替换为 script/rails

新的 script/rails 替换了以前在 script 目录中的所有脚本。但你不直接运行 script/rails，rails 命令会检测到它在 Rails 应用程序的根目录中被调用，并为你运行脚本。使用方法如下：

$ rails console                      # 替代 script/console
$ rails g scaffold post title:string # 替代 script/generate scaffold post title:string

运行 rails --help 查看所有选项的列表。

1.4 依赖和 config.gem

config.gem 方法已经被移除，取而代之的是使用 bundler 和 Gemfile，请参阅下面的管理 Gems。

1.5 升级过程

为了帮助升级过程，创建了一个名为 Rails Upgrade 的插件来自动化部分过程。

只需安装插件，然后运行 rake rails:upgrade:check 来检查你的应用程序是否需要更新的部分（并提供链接以获取有关如何更新的信息）。它还提供了一个任务，根据当前的 config.gem 调用生成一个 Gemfile，以及根据当前的路由文件生成一个新的路由文件的任务。要获取插件，只需运行以下命令： bash $ ruby script/plugin install git://github.com/rails/rails_upgrade.git

您可以在Rails Upgrade is now an Official Plugin中看到它的工作示例。

除了Rails Upgrade工具之外，如果您需要更多帮助，IRC和rubyonrails-talk上的人可能正在做同样的事情，可能会遇到相同的问题。请务必在升级时记录您自己的经验，以便其他人可以从您的知识中受益！

2 创建Rails 3.0应用程序

# 您应该已经安装了'rails' RubyGem
$ rails new myapp
$ cd myapp

2.1 供应商化的Gems

Rails现在在应用程序根目录中使用Gemfile来确定您的应用程序启动所需的gems。这个Gemfile由Bundler处理，然后安装所有依赖项。它甚至可以将所有依赖项本地安装到您的应用程序中，以便它不依赖于系统gems。

更多信息：- bundler主页

2.2 生活在边缘

Bundler和Gemfile使得通过新的专用bundle命令冻结您的Rails应用程序变得非常容易，因此rake freeze不再相关并已被删除。

如果您想直接从Git存储库进行捆绑，可以使用--edge标志：

$ rails new myapp --edge

如果您有一个Rails存储库的本地检出，并希望使用它生成一个应用程序，可以使用--dev标志：

$ ruby /path/to/rails/bin/rails new myapp --dev

3 Rails架构变化

Rails的架构发生了六个重大变化。

3.1 Railties重新构建

Railties已更新，为整个Rails框架提供了一致的插件API，以及生成器和Rails绑定的完全重写，结果是开发人员现在可以以一种一致、定义明确的方式钩入生成器和应用程序框架的任何重要阶段。

3.2 所有Rails核心组件解耦

在合并Merb和Rails时，一个重要的任务是消除Rails核心组件之间的紧密耦合。现在已经实现了这一点，所有Rails核心组件现在都使用您可以用于开发插件的相同API。这意味着您制作的任何插件，或者任何核心组件替换（如DataMapper或Sequel）都可以访问Rails核心组件具有的所有功能，并随意扩展和增强。

更多信息：- The Great Decoupling

3.3 Active Model抽象

解耦核心组件的一部分是从Action Pack中提取出所有与Active Record的关联。这一工作现在已经完成。所有新的ORM插件现在只需要实现Active Model接口，就可以与Action Pack无缝配合使用。

3.4 控制器抽象

解耦核心组件的另一个重要部分是创建一个与HTTP概念分离的基类，以处理视图的渲染等。创建AbstractController允许大大简化ActionController和ActionMailer，从所有这些库中删除公共代码，并将其放入Abstract Controller中。

更多信息：- Rails Edge Architecture

3.5 Arel集成

Arel（或Active Relation）已成为Active Record的基础，现在在Rails中是必需的。Arel提供了一个简化Active Record的SQL抽象，并为Active Record中的关系功能提供了基础。

更多信息：- Why I wrote Arel

3.6 邮件提取

Action Mailer自从诞生以来就有猴子补丁、预解析器，甚至是交付和接收代理，所有这些都是在源代码树中供应商化的TMail。版本3通过将所有与电子邮件消息相关的功能抽象出来到Mail gem中来改变这一点。这再次减少了代码重复，并帮助创建Action Mailer和电子邮件解析器之间的可定义边界。

更多信息：- New Action Mailer API in Rails 3

4 文档

Rails树中的文档正在更新以反映所有API更改，此外，Rails Edge Guides正在逐一更新以反映Rails 3.0中的更改。然而，guides.rubyonrails.org上的指南将继续只包含稳定版本的Rails（目前为2.3.5版本，直到发布3.0版本）。

更多信息：- Rails Documentation Projects

5 国际化

在Rails 3中，已经完成了大量的I18n支持工作，包括最新的I18n gem提供了许多速度改进。

任何对象都可以添加I18n行为 - 只需包含ActiveModel::Translation和ActiveModel::Validations即可将I18n行为添加到任何对象中。还有一个errors.messages的回退选项用于翻译。
属性可以有默认的翻译。
表单提交标签会根据对象状态自动获取正确的状态（创建或更新），并获取正确的翻译。
使用I18n的标签现在只需传递属性名称即可。

更多信息：- Rails 3 I18n变更

6 Railties

随着主要的Rails框架的解耦，Railties经历了巨大的改进，以使框架、引擎或插件的链接变得更加简单和可扩展：

每个应用程序现在都有自己的命名空间，例如使用YourAppName.boot启动应用程序，这样与其他应用程序的交互变得更加容易。
现在将Rails.root/app下的所有内容都添加到加载路径中，因此您可以创建app/observers/user_observer.rb，Rails将在不进行任何修改的情况下加载它。
Rails 3.0现在提供了一个Rails.config对象，它提供了所有种类的Rails全局配置选项的中央存储库。

应用程序生成增加了额外的标志，允许您跳过安装test-unit、Active Record、Prototype和Git。还添加了一个新的--dev标志，它将应用程序设置为使用Gemfile指向您的Rails检出（由rails二进制文件的路径确定）。有关更多信息，请参阅rails --help。

在Rails 3.0中，Railties生成器得到了大量的关注，基本上：

生成器已经完全重写，不再向后兼容。
Rails模板API和生成器API合并为一个（与前者相同）。
生成器不再从特殊路径加载，它们只是在Ruby加载路径中找到，因此调用rails generate foo将查找generators/foo_generator。
新的生成器提供了钩子，因此任何模板引擎、ORM、测试框架都可以轻松地插入其中。
新的生成器允许您通过将副本放置在Rails.root/lib/templates中来覆盖模板。
还提供了Rails::Generators::TestCase，因此您可以创建自己的生成器并对其进行测试。

此外，Railties生成的视图也进行了一些改进：

视图现在使用div标签而不是p标签。
生成的脚手架现在使用_form局部视图，而不是在编辑和新建视图中重复的代码。
脚手架表单现在使用f.submit，根据传入的对象的状态返回"Create ModelName"或"Update ModelName"。

最后，rake任务也进行了一些增强：

添加了rake db:forward，允许您逐个或按组向前滚动迁移。
添加了rake routes CONTROLLER=x，允许您只查看一个控制器的路由。

Railties现在弃用了：

RAILS_ROOT，使用Rails.root代替，
RAILS_ENV，使用Rails.env代替，以及
RAILS_DEFAULT_LOGGER，使用Rails.logger代替。

不再加载PLUGIN/rails/tasks和PLUGIN/tasks，现在所有任务都必须在PLUGIN/lib/tasks中。

更多信息：

7 Action Pack

在Action Pack中发生了重大的内部和外部变化。

7.1 抽象控制器

抽象控制器将Action Controller的通用部分提取出来，形成一个可重用的模块，任何库都可以使用该模块来渲染模板、渲染局部视图、辅助方法、翻译、日志记录以及请求响应周期的任何部分。这种抽象使得ActionMailer::Base现在只需继承自AbstractController，并将Rails DSL包装到Mail gem中。

它还提供了一个机会来清理Action Controller的代码，将可以简化的部分抽象出来。

但请注意，抽象控制器不是面向用户的API，在日常使用Rails时不会遇到它。

更多信息：- Rails Edge架构

7.2 Action Controller

application_controller.rb现在默认启用了protect_from_forgery。
cookie_verifier_secret已被弃用，现在通过Rails.application.config.cookie_secret分配，并移动到自己的文件中：config/initializers/cookie_verification_secret.rb。
session_store在ActionController::Base.session中配置，现在移动到Rails.application.config.session_store。默认设置在config/initializers/session_store.rb中。
cookies.secure允许您在cookie中设置加密值，例如cookie.secure[:key] => value。
cookies.permanent允许您在cookie哈希中设置永久值，例如cookie.permanent[:key] => value，如果验证失败，则对签名值引发异常。
现在可以在respond_to块内的format调用中传递:notice => 'This is a flash message'或:alert => 'Something went wrong'。flash[]哈希仍然像以前一样工作。
现在在控制器中添加了respond_with方法，简化了古老的format块。
添加了ActionController::Responder，允许您灵活地生成响应。弃用：
filter_parameter_logging 已弃用，推荐使用 config.filter_parameters << :password。

更多信息：

7.3 Action Dispatch

Action Dispatch 是 Rails 3.0 中的新功能，提供了一个更清晰的路由实现。

对路由器进行了大规模的清理和重写，Rails 路由器现在是 rack_mount，在其上面有一个 Rails DSL，它是一个独立的软件。

每个应用程序定义的路由现在都在你的 Application 模块中进行命名空间划分，例如：

# 之前是：

ActionController::Routing::Routes.draw do |map|
  map.resources :posts
end

# 现在是：

AppName::Application.routes do
  resources :posts
end

在路由器中添加了 match 方法，你还可以将任何 Rack 应用程序传递给匹配的路由。
在路由器中添加了 constraints 方法，允许你使用定义的约束条件保护路由器。

在路由器中添加了 scope 方法，允许你为不同的语言或不同的操作命名空间划分路由，例如：

scope 'es' do
  resources :projects, :path_names => { :edit => 'cambiar' }, :path => 'proyecto'
end

# 这样可以得到编辑操作的路径为 /es/proyecto/1/cambiar

在路由器中添加了 root 方法，作为 match '/', :to => path 的快捷方式。
你可以将可选的片段传递给匹配方法，例如 match "/:controller(/:action(/:id))(.:format)"，每个括号中的片段都是可选的。
路由可以通过块来表示，例如你可以调用 controller :home { match '/:action' }。

注意：旧的 map 命令仍然像以前一样工作，有一个向后兼容层，但这将在 3.1 版本中被移除。

弃用：

非 REST 应用程序的 catch all 路由 (/:controller/:action/:id) 现在已被注释掉。
路由中的 :path_prefix 不再存在，:name_prefix 现在会自动在给定的值后面添加 "_"。

7.4 Action View

7.4.1 非侵入式 JavaScript

在 Action View 辅助方法中进行了重大改写，实现了非侵入式 JavaScript (UJS) 钩子，并删除了旧的内联 AJAX 命令。这使得 Rails 可以使用任何符合 UJS 驱动程序的 UJS 钩子来实现辅助方法中的 UJS 钩子。

这意味着所有以前的 remote_<method> 辅助方法已从 Rails 核心中删除，并放入了 Prototype Legacy Helper 中。要在 HTML 中使用 UJS 钩子，现在可以传递 :remote => true。例如：

form_for @post, :remote => true

生成的 HTML 为：

<form action="http://host.com" id="create-post" method="post" data-remote="true">

7.4.2 带有块的辅助方法

像 form_for 或 div_for 这样从块中插入内容的辅助方法现在使用 <%=：

<%= form_for @post do |f| %>
  ...
<% end %>

你自己的这类辅助方法应该返回一个字符串，而不是手动追加到输出缓冲区。

像 cache 或 content_for 这样做其他操作的辅助方法不受此更改的影响，它们仍然需要使用 <%。

7.4.3 其他更改

你不再需要调用 h(string) 来转义 HTML 输出，它在所有视图模板中默认开启。如果你想要未转义的字符串，可以调用 raw(string)。
辅助方法现在默认输出 HTML5。
表单标签辅助方法现在使用单个值从 I18n 中获取值，所以 f.label :name 将获取 :name 的翻译。
I18n 中的选择标签现在应该是 :en.helpers.select，而不是 :en.support.select。
你不再需要在 ERB 模板中的 Ruby 插值的末尾加上减号来删除 HTML 输出中的尾随换行符。
在 Action View 中添加了 grouped_collection_select 辅助方法。
添加了 content_for?，允许你在渲染之前检查视图中是否存在内容。
将 :value => nil 传递给表单辅助方法将会将字段的 value 属性设置为 nil，而不是使用默认值。
将 :id => nil 传递给表单辅助方法将会导致这些字段不带有 id 属性进行渲染。
将 :alt => nil 传递给 image_tag 将会导致 img 标签不带有 alt 属性进行渲染。

8 Active Model

Active Model 是 Rails 3.0 中的新功能。它提供了一个抽象层，供任何 ORM 库使用以与 Rails 交互，通过实现 Active Model 接口。

8.1 ORM抽象和Action Pack接口

将核心组件解耦的一部分是从Action Pack中提取出与Active Record的所有关联。这一步已经完成。现在，所有新的ORM插件只需要实现Active Model接口，就可以与Action Pack无缝配合使用。

更多信息：- 使任何Ruby对象感觉像ActiveRecord

8.2 验证

验证已从Active Record移动到Active Model，为在Rails 3中跨ORM库工作的验证提供了一个接口。

现在有一个validates :attribute, options_hash的快捷方法，允许您为所有验证类方法传递选项，您可以向验证方法传递多个选项。
validates方法有以下选项：
- :acceptance => Boolean。
- :confirmation => Boolean。
- :exclusion => { :in => Enumerable }。
- :inclusion => { :in => Enumerable }。
- :format => { :with => Regexp, :on => :create }。
- :length => { :maximum => Fixnum }。
- :numericality => Boolean。
- :presence => Boolean。
- :uniqueness => Boolean。

注意：Rails版本2.3样式的验证方法在Rails 3.0中仍然受支持，新的validates方法被设计为在模型验证中提供额外的帮助，而不是替代现有的API。

您还可以传递一个验证器对象，然后可以在使用Active Model的对象之间重用它：

class TitleValidator < ActiveModel::EachValidator
  Titles = ['Mr.', 'Mrs.', 'Dr.']
  def validate_each(record, attribute, value)
    unless Titles.include?(value)
      record.errors[attribute] << '必须是有效的头衔'
    end
  end
end

class Person
  include ActiveModel::Validations
  attr_accessor :title
  validates :title, :presence => true, :title => true
end

# 或者对于Active Record

class Person < ActiveRecord::Base
  validates :title, :presence => true, :title => true
end

还支持自省：

User.validators
User.validators_on(:login)

更多信息：

9 Active Record

Active Record在Rails 3.0中受到了很多关注，包括抽象为Active Model，使用Arel进行查询接口的完全更新，验证更新以及许多增强和修复。所有的Rails 2.x API都可以通过兼容层来使用，该兼容层将在3.1版本之前得到支持。

9.1 查询接口

Active Record现在通过使用Arel，在其核心方法上返回关系。Rails 2.3.x中的现有API仍然受支持，并且在Rails 3.1之前不会被弃用，在Rails 3.2之前不会被删除，但是新的API提供了以下新方法，它们都返回关系，可以将它们链接在一起：

where - 在关系上提供条件，返回什么。
select - 选择要从数据库中返回的模型的属性。
group - 将关系分组在提供的属性上。
having - 提供限制组关系的表达式（GROUP BY约束）。
joins - 将关系与另一个表连接。
clause - 提供限制连接关系的表达式（JOIN约束）。
includes - 包含其他预加载的关系。
order - 根据提供的表达式对关系进行排序。
limit - 将关系限制为指定的记录数。
lock - 锁定从表返回的记录。
readonly - 返回数据的只读副本。
from - 提供一种从多个表中选择关系的方法。
scope - （以前是named_scope）返回关系，并可以与其他关系方法链接在一起。
with_scope - 和with_exclusive_scope现在也返回关系，因此可以链接在一起。
default_scope - 也适用于关系。

更多信息：

9.2 增强功能

在Active Record对象中添加了:destroyed?。
在Active Record关联中添加了:inverse_of，允许您在不访问数据库的情况下获取已加载关联的实例。

9.3 补丁和弃用

此外，Active Record分支中进行了许多修复：

放弃了对SQLite 2的支持，转而支持SQLite 3。
MySQL支持列顺序。
修复了PostgreSQL适配器的TIME ZONE支持，因此不再插入不正确的值。
为PostgreSQL的表名支持多个模式。
PostgreSQL支持XML数据类型列。
table_name现在已缓存。
对Oracle适配器也进行了大量工作，修复了许多错误。以及以下的弃用：
在Active Record类中，named_scope已被弃用并更名为scope。
在scope方法中，应该使用关系方法而不是:conditions => {}查找方法，例如scope :since, lambda {|time| where("created_at > ?", time) }。
save(false)已被弃用，推荐使用save(:validate => false)。
Active Record的I18n错误消息应从:en.activerecord.errors.template更改为:en.errors.template。
model.errors.on已被弃用，推荐使用model.errors[]。
validates_presence_of => validates... :presence => true
ActiveRecord::Base.colorize_logging和config.active_record.colorize_logging已被弃用，推荐使用Rails::LogSubscriber.colorize_logging或config.colorize_logging

注意：尽管在Active Record的最新版本中已经实现了状态机，但它已从Rails 3.0版本中移除。

10 Active Resource

Active Resource也被提取到Active Model中，使您可以无缝地在Action Pack中使用Active Resource对象。

通过Active Model添加了验证功能。
添加了观察钩子。
支持HTTP代理。
添加了对摘要认证的支持。
将模型命名移到Active Model中。
将Active Resource属性更改为具有无差别访问的哈希。
为等效的查找范围添加了first，last和all别名。
如果没有返回任何内容，find_every现在不会返回ResourceNotFound错误。
添加了save!，除非对象是valid?，否则会引发ResourceInvalid。
在Active Resource模型中添加了update_attribute和update_attributes。
添加了exists?。
将SchemaDefinition重命名为Schema，将define_schema重命名为schema。
使用Active Resources的format而不是远程错误的content-type加载错误。
在模式块中使用instance_eval。
修复了当@response不响应#code或#message时，ActiveResource::ConnectionError#to_s的错误，处理了Ruby 1.9的兼容性。
添加了对JSON格式错误的支持。
确保load与数字数组一起工作。
将来自远程资源的410响应识别为资源已被删除。
在Active Resource连接上添加了设置SSL选项的能力。
设置连接超时也会影响Net::HTTP的open_timeout。

弃用：

save(false)已被弃用，推荐使用save(:validate => false)。
Ruby 1.9.2：URI.parse和.decode已被弃用，并且不再在库中使用。

11 Active Support

在Active Support中进行了大量努力，使其可以进行选择性挑选，也就是说，您不再需要引入整个Active Support库来获取其中的一部分。这使得Rails的各个核心组件可以更加精简运行。

以下是Active Support的主要变化：

对库进行了大量清理，删除了未使用的方法。
Active Support不再提供TZInfo、Memcache Client和Builder的版本。这些都作为依赖项包含在内，并通过bundle install命令安装。
在ActiveSupport::SafeBuffer中实现了安全缓冲区。
添加了Array.uniq_by和Array.uniq_by!。
删除了Array#rand，并从Ruby 1.9中回溯了Array#sample。
修复了TimeZone.seconds_to_utc_offset返回错误值的错误。
添加了ActiveSupport::Notifications中间件。
ActiveSupport.use_standard_json_time_format现在默认为true。
ActiveSupport.escape_html_entities_in_json现在默认为false。
Integer#multiple_of?接受零作为参数，除非接收者为零，否则返回false。
string.chars已更名为string.mb_chars。
ActiveSupport::OrderedHash现在可以通过YAML进行反序列化。
使用LibXML和Nokogiri为XmlMini添加了基于SAX的解析器。
添加了Object#presence，如果对象是#present?，则返回对象，否则返回nil。
添加了String#exclude?核心扩展，返回#include?的相反结果。
在ActiveSupport中为DateTime添加了to_i，以便在具有DateTime属性的模型上正确使用to_yaml。
添加了Enumerable#exclude?，以实现与Enumerable#include?的一致性，并避免使用!x.include?。
切换到默认启用的XSS转义。
在ActiveSupport::HashWithIndifferentAccess中支持深度合并。
Enumerable#sum现在适用于所有可枚举对象，即使它们不响应:size。
长度为零的持续时间的inspect返回'0 seconds'而不是空字符串。
在ModelName中添加了element和collection。
String#to_time和String#to_datetime处理小数秒。
为响应：before和：after的around过滤器对象添加了对新回调的支持，用于before和after回调。
ActiveSupport::OrderedHash#to_a方法返回一组有序的数组。与Ruby 1.9的Hash#to_a匹配。
MissingSourceFile存在作为一个常量，但现在只等于LoadError。
添加了Class#class_attribute，以便能够声明一个类级别的属性，其值是可继承的，并且可以被子类覆盖。
最终删除了ActiveRecord::Associations中的DeprecatedCallbacks。
Object#metaclass现在是Kernel#singleton_class，以与Ruby匹配。以下方法已被移除，因为它们现在在Ruby 1.8.7和1.9中可用。
Integer#even? 和 Integer#odd?
String#each_char
String#start_with? 和 String#end_with?（第三人称别名仍保留）
String#bytesize
Object#tap
Symbol#to_proc
Object#instance_variable_defined?
Enumerable#none?

REXML的安全补丁仍然保留在Active Support中，因为早期的Ruby 1.8.7补丁级别仍然需要它。Active Support知道是否需要应用该补丁。

以下方法已被移除，因为它们在框架中不再使用：

Kernel#daemonize
Object#remove_subclasses_of Object#extend_with_included_modules_from, Object#extended_by
Class#remove_class
Regexp#number_of_captures, Regexp.unoptionalize, Regexp.optionalize, Regexp#number_of_captures

12 Action Mailer

Action Mailer使用新的API，将TMail替换为新的Mail作为邮件库。Action Mailer本身经历了几乎完全的重写，几乎每一行代码都有所改动。结果是，Action Mailer现在只是继承自Abstract Controller，并在Rails DSL中包装Mail gem。这大大减少了Action Mailer中的代码量和其他库的重复。

所有邮件现在默认放在app/mailers中。
现在可以使用三个方法attachments、headers和mail使用新的API发送电子邮件。
Action Mailer现在原生支持使用attachments.inline方法进行内联附件。
Action Mailer的发送方法现在返回Mail::Message对象，可以通过发送deliver消息来发送邮件。
所有的传递方法现在都抽象到Mail gem中。
邮件传递方法可以接受一个包含所有有效邮件头字段及其值对的哈希。
mail传递方法的行为类似于Action Controller的respond_to，可以显式或隐式地渲染模板。Action Mailer会根据需要将电子邮件转换为多部分电子邮件。
可以将proc传递给邮件块中的format.mime_type调用，显式地渲染特定类型的文本，或添加布局或不同的模板。proc中的render调用来自Abstract Controller，并支持相同的选项。
原来的邮件单元测试已移动到功能测试中。
Action Mailer现在将所有标题字段和正文的自动编码委托给Mail Gem。
Action Mailer将自动为您编码电子邮件正文和标题。

弃用：

:charset、:content_type、:mime_version、:implicit_parts_order都已弃用，推荐使用ActionMailer.default :key => value样式的声明。
邮件动态create_method_name和deliver_method_name已弃用，只需调用method_name，它现在返回一个Mail::Message对象。
弃用ActionMailer.deliver(message)，只需调用message.deliver。
弃用template_root，将选项传递给mail生成块内的format.mime_type方法中的渲染调用。
弃用使用body方法定义实例变量（body {:ivar => value}），只需直接在方法中声明实例变量，它们将在视图中可用。
弃用将邮件放在app/models中，改用app/mailers。

更多信息：

13 贡献者

请参阅Rails的完整贡献者列表，感谢那些花费了很多时间制作Rails 3的人。向他们致敬。

Rails 3.0发布说明由Mikel Lindsaar编写。

反馈

欢迎您帮助改进本指南的质量。

如果您发现任何拼写错误或事实错误，请贡献您的意见。要开始，请阅读我们的文档贡献部分。

您还可能会发现不完整的内容或过时的内容。请为主要内容添加任何缺失的文档。请先检查 Edge 指南，以验证问题是否已经修复或尚未修复。请参阅 Ruby on Rails 指南准则以了解样式和规范。

如果您发现需要修复但无法自行修复的问题，请提交问题。

最后但同样重要的是，欢迎您在官方 Ruby on Rails 论坛上讨论有关 Ruby on Rails 文档的任何问题。

Chapters

反馈