Guides.rubyonrails.org

Chapters

1. Rack 简介
2. Rails on Rack
   • Rails 应用的 Rack 对象
   • rails server
   • rackup
   • 开发和自动重新加载
3. Action Dispatcher 中间件栈
   • 审查中间件栈
   • 配置中间件栈
   • 内部中间件栈
4. 资源
   • 学习 Rack
   • 理解中间件

1 Rack 简介

Rack 为使用 Ruby 开发的 Web 应用提供最简单的模块化接口，而且适应性强。Rack 使用最简单的方式包装 HTTP 请求和响应，从而抽象了 Web 服务器、Web 框架，以及二者之间的软件（称为中间件）的 API，统一成一个方法调用。

• Rack API 文档

本文不详尽说明 Rack。如果你不了解 Rack 的基本概念，请参阅 资源。

2 Rails on Rack

2.1 Rails 应用的 Rack 对象

Rails.application 是 Rails 应用的主 Rack 应用对象。任何兼容 Rack 的 Web 服务器都应该使用 Rails.application 对象伺服 Rails 应用。

2.2 rails server

rails server 负责创建 Rack::Server 对象和启动 Web 服务器。

rails server 创建 Rack::Server 实例的方式如下：

Rails::Server.new.tap do |server|
  require APP_PATH
  Dir.chdir(Rails.application.root)
  server.start
end

Rails::Server 继承自 Rack::Server，像下面这样调用 Rack::Server#start 方法：

class Server < ::Rack::Server
  def start
    ...
    super
  end
end

2.3 rackup

如果不想使用 Rails 提供的 rails server 命令，而是使用 rackup，可以把下述代码写入 Rails 应用根目录中的 config.ru 文件里：

# Rails.root/config.ru
require ::File.expand_path('../config/environment', __FILE__)
run Rails.application

然后使用下述命令启动服务器：

$ rackup config.ru

rackup 命令的各个选项可以通过下述命令查看：

$ rackup --help

2.4 开发和自动重新加载

中间件只加载一次，不会监视变化。若想让改动生效，必须重启服务器。

3 Action Dispatcher 中间件栈

Action Dispatcher 的内部组件很多都实现为 Rack 中间件。Rails::Application 使用 ActionDispatch::MiddlewareStack 把不同的内部和外部中间件组合在一起，构成完整的 Rails Rack 中间件。

3.1 审查中间件栈

Rails 提供了一个方便的任务，用于查看在用的中间件栈：

$ bin/rails middleware

在新生成的 Rails 应用中，上述命令可能会输出下述内容：

use Rack::Sendfile
use ActionDispatch::Static
use ActionDispatch::Executor
use #<ActiveSupport::Cache::Strategy::LocalCache::Middleware:0x000000029a0838>
use Rack::Runtime
use Rack::MethodOverride
use ActionDispatch::RequestId
use Rails::Rack::Logger
use ActionDispatch::ShowExceptions
use ActionDispatch::DebugExceptions
use ActionDispatch::RemoteIp
use ActionDispatch::Reloader
use ActionDispatch::Callbacks
use ActiveRecord::Migration::CheckPending
use ActiveRecord::ConnectionAdapters::ConnectionManagement
use ActiveRecord::QueryCache
use ActionDispatch::Cookies
use ActionDispatch::Session::CookieStore
use ActionDispatch::Flash
use Rack::Head
use Rack::ConditionalGet
use Rack::ETag
run Rails.application.routes

这里列出的默认中间件（以及其他一些）在 内部中间件栈概述。

3.2 配置中间件栈

Rails 提供了一个简单的配置接口，config.middleware，用于在 application.rb 或针对环境的配置文件 environments/<environment>.rb 中添加、删除和修改中间件栈。

3.2.1 添加中间件

可以通过下述任意一种方法向中间件栈里添加中间件：

• config.middleware.use(new_middleware, args)：在中间件栈的末尾添加一个中间件。

• config.middleware.insert_before(existing_middleware, new_middleware, args)：在中间件栈里指定现有中间件的前面添加一个中间件。

• config.middleware.insert_after(existing_middleware, new_middleware, args)：在中间件栈里指定现有中间件的后面添加一个中间件。

# config/application.rb

# 把 Rack::BounceFavicon 放在默认
config.middleware.use Rack::BounceFavicon

# 在 ActiveRecord::QueryCache 后面添加 Lifo::Cache
# 把 { page_cache: false } 参数传给 Lifo::Cache.
config.middleware.insert_after ActiveRecord::QueryCache, Lifo::Cache, page_cache: false

3.2.2 替换中间件

可以使用 config.middleware.swap 替换中间件栈里的现有中间件：

# config/application.rb

# 把 ActionDispatch::ShowExceptions 换成 Lifo::ShowExceptions
config.middleware.swap ActionDispatch::ShowExceptions, Lifo::ShowExceptions

3.2.3 删除中间件

在应用的配置文件中添加下面这行代码：

# config/application.rb
config.middleware.delete Rack::Runtime

然后审查中间件栈，你会发现没有 Rack::Runtime 了：

$ bin/rails middleware
(in /Users/lifo/Rails/blog)
use ActionDispatch::Static
use #<ActiveSupport::Cache::Strategy::LocalCache::Middleware:0x00000001c304c8>
use Rack::Runtime
...
run Rails.application.routes

若想删除会话相关的中间件，这么做：

# config/application.rb
config.middleware.delete ActionDispatch::Cookies
config.middleware.delete ActionDispatch::Session::CookieStore
config.middleware.delete ActionDispatch::Flash

若想删除浏览器相关的中间件，这么做：

# config/application.rb
config.middleware.delete Rack::MethodOverride

3.3 内部中间件栈

Action Controller 的大部分功能都实现成中间件。下面概述它们的作用。

Rack::Sendfile
在服务器端设定 X-Sendfile 首部。通过 config.action_dispatch.x_sendfile_header 选项配置。

ActionDispatch::Static
用于伺服 public 目录中的静态文件。如果把 config.public_file_server.enabled 设为 false，禁用这个中间件。

Rack::Lock
把 env["rack.multithread"] 设为 false，把应用包装到 Mutex 中。

ActionDispatch::Executor
用于在开发环境中以线程安全方式重新加载代码。

ActiveSupport::Cache::Strategy::LocalCache::Middleware
用于缓存内存。这个缓存对线程不安全。

Rack::Runtime
设定 X-Runtime 首部，包含执行请求的用时（单位为秒）。

Rack::MethodOverride
如果设定了 params[:_method]，允许覆盖请求方法。PUT 和 DELETE 两个 HTTP 方法就是通过这个中间件提供支持的。

ActionDispatch::RequestId
在响应中设定唯一的 X-Request-Id 首部，并启用 ActionDispatch::Request#request_id 方法。

Rails::Rack::Logger
通知日志，请求开始了。请求完毕后，清空所有相关日志。

ActionDispatch::ShowExceptions
拯救应用返回的所有异常，调用处理异常的应用，把异常包装成对终端用户友好的格式。

ActionDispatch::DebugExceptions
如果是本地请求，负责在日志中记录异常，并显示调试页面。

ActionDispatch::RemoteIp
检查 IP 欺骗攻击。

ActionDispatch::Reloader
提供准备和清理回调，目的是在开发环境中协助重新加载代码。

ActionDispatch::Callbacks
提供回调，在分派请求前后执行。

ActiveRecord::Migration::CheckPending
检查有没有待运行的迁移，如果有，抛出 ActiveRecord::PendingMigrationError。

ActiveRecord::ConnectionAdapters::ConnectionManagement
如果没在请求环境中把 rack.test 键设为 true，每次请求后清理活跃连接。

ActiveRecord::QueryCache
启用 Active Record 查询缓存。

ActionDispatch::Cookies
为请求设定 cookie。

ActionDispatch::Session::CookieStore
负责把会话存储在 cookie 中。

ActionDispatch::Flash
设置闪现消息的键。仅当为 config.action_controller.session_store 设定值时才启用。

Rack::Head
把 HEAD 请求转换成 GET 请求，然后伺服 GET 请求。

Rack::ConditionalGet
支持“条件 GET 请求”，如果页面没变，服务器不做响应。

Rack::ETag
为所有字符串主体添加 ETag 首部。ETag 用于验证缓存。

4 资源

4.1 学习 Rack

• Rack 官方网站

• Introducing Rack

4.2 理解中间件

• Railscast 中讲解 Rack 中间件的视频

反馈

我们鼓励您帮助提高本指南的质量。

如果看到如何错字或错误，请反馈给我们。 您可以阅读我们的文档贡献指南。

您还可能会发现内容不完整或不是最新版本。 请添加缺失文档到 master 分支。请先确认 Edge Guides 是否已经修复。 关于用语约定，请查看Ruby on Rails 指南指导。

无论什么原因，如果你发现了问题但无法修补它，请创建 issue。

最后，欢迎到 rubyonrails-docs 邮件列表参与任何有关 Ruby on Rails 文档的讨论。

中文翻译反馈

贡献：https://github.com/ruby-china/guides。