sinatra 文档
注:本文档仅仅是英文版的翻译,会出现内容没有及时更新的情况发生。 如有不一致的地方,请以英文版为准。
Sinatra是一个基于Ruby语言,以最小精力为代价快速创建web应用为目的的DSL( 领域专属语言):
安装gem然后运行:
在该地址查看: localhost:4567
推荐同时运行gem install thin
,Sinatra会优先选择thin作为服务器。
路由
在Sinatra中,一个路由是一个HTTP方法与URL匹配范式的配对。 每个路由都与一个代码块关联:
路由按照它们被定义的顺序进行匹配。 第一个与请求匹配的路由会被调用。
路由范式可以包括具名参数,可通过params
哈希表获得:
你同样可以通过代码块参数获得具名参数:
路由范式也可以包含通配符参数, 可以通过params[:splat]
数组获得。
通过正则表达式匹配的路由:
或者使用代码块参数:
条件
路由也可以包含多样的匹配条件,比如user agent:
其他可选的条件是 host_name
和 provides
:
你也可以很轻松地定义自己的条件:
返回值
路由代码块的返回值至少决定了返回给HTTP客户端的响应体, 或者至少决定了在Rack堆栈中的下一个中间件。 大多数情况下,将是一个字符串,就像上面的例子中的一样。 但是其他值也是可以接受的。
你可以返回任何对象,或者是一个合理的Rack响应, Rack body对象或者HTTP状态码:
那样,我们可以轻松的实现例如流式传输的例子:
自定义路由匹配器
如上显示,Sinatra内置了对于使用字符串和正则表达式作为路由匹配的支持。 但是,它并没有只限于此。 你可以非常容易地定义你自己的匹配器:
请注意上面的例子可能超工程了, 因为它也可以用更简单的方式表述:
或者,使用消极向前查找:
静态文件
静态文件是从 ./public_folder
目录提供服务。你可以通过设置:public
选项设定一个不同的位置:
请注意public目录名并没有被包含在URL之中。文件 ./public/css/style.css
是通过http://example.com/css/style.css
地址访问的。
视图 / 模板
模板被假定直接位于./views
目录。 要使用不同的视图目录:
请记住一件非常重要的事情,你只可以通过符号引用模板, 即使它们在子目录下 (在这种情况下,使用:'subdir/template'
)。 你必须使用一个符号, 因为渲染方法会直接地渲染任何传入的字符串。
Haml模板
需要引入 haml
gem/library以渲染 HAML 模板:
渲染 ./views/index.haml
。
Haml的选项 可以通过Sinatra的配置全局设定, 参见 选项和配置, 也可以个别的被覆盖。
Erb模板
渲染 ./views/index.erb
Erubis
需要引入 erubis
gem/library以渲染 erubis 模板:
渲染 ./views/index.erubis
使用Erubis代替Erb也是可能的:
使用Erubis来渲染 ./views/index.erb
。
Builder 模板
需要引入 builder
gem/library 以渲染 builder templates:
渲染 ./views/index.builder
。
Nokogiri 模板
需要引入 nokogiri
gem/library 以渲染 nokogiri 模板:
渲染 ./views/index.nokogiri
。
Sass 模板
需要引入 haml
或者 sass
gem/library 以渲染 Sass 模板:
渲染 ./views/stylesheet.sass
。
Sass 的选项 可以通过Sinatra选项全局设定, 参考 选项和配置(英文), 也可以在个体的基础上覆盖。
Scss 模板
需要引入 haml
或者 sass
gem/library 来渲染 Scss templates:
渲染 ./views/stylesheet.scss
。
Scss的选项 可以通过Sinatra选项全局设定, 参考 选项和配置(英文), 也可以在个体的基础上覆盖。
Less 模板
需要引入 less
gem/library 以渲染 Less 模板:
渲染 ./views/stylesheet.less
。
Liquid 模板
需要引入 liquid
gem/library 来渲染 Liquid 模板:
渲染 ./views/index.liquid
。
因为你不能在Liquid 模板中调用 Ruby 方法 (除了 yield
) , 你几乎总是需要传递locals给它:
Markdown 模板
需要引入 rdiscount
gem/library 以渲染 Markdown 模板:
渲染 ./views/index.markdown
(md
和 mkd
也是合理的文件扩展名)。
在markdown中是不可以调用方法的,也不可以传递 locals给它。 你因此一般会结合其他的渲染引擎来使用它:
请注意你也可以从其他模板中调用 markdown 方法:
既然你不能在Markdown中调用Ruby,你不能使用Markdown编写的布局。 不过,使用其他渲染引擎作为模版的布局是可能的, 通过传递:layout_engine
选项:
这将会渲染 ./views/index.md
并使用 ./views/layout.erb
作为布局。
请记住你可以全局设定这个选项:
这将会渲染 ./views/index.markdown
(和任何其他的 Markdown 模版) 并使用 ./views/post.haml
作为布局.
也可能使用BlueCloth而不是RDiscount来解析Markdown文件:
使用BlueCloth来渲染 ./views/index.md
。
Textile 模板
需要引入 RedCloth
gem/library 以渲染 Textile 模板:
渲染 ./views/index.textile
。
在textile中是不可以调用方法的,也不可以传递 locals给它。 你因此一般会结合其他的渲染引擎来使用它:
请注意你也可以从其他模板中调用textile
方法:
既然你不能在Textile中调用Ruby,你不能使用Textile编写的布局。 不过,使用其他渲染引擎作为模版的布局是可能的, 通过传递:layout_engine
选项:
这将会渲染 ./views/index.textile
并使用 ./views/layout.erb
作为布局。
请记住你可以全局设定这个选项:
这将会渲染 ./views/index.textile
(和任何其他的 Textile 模版) 并使用 ./views/post.haml
作为布局.
RDoc 模板
需要引入 RDoc
gem/library 以渲染RDoc模板:
渲染 ./views/index.rdoc
。
在rdoc中是不可以调用方法的,也不可以传递locals给它。 你因此一般会结合其他的渲染引擎来使用它:
请注意你也可以从其他模板中调用rdoc
方法:
既然你不能在RDoc中调用Ruby,你不能使用RDoc编写的布局。 不过,使用其他渲染引擎作为模版的布局是可能的, 通过传递:layout_engine
选项:
这将会渲染 ./views/index.rdoc
并使用 ./views/layout.erb
作为布局。
请记住你可以全局设定这个选项:
这将会渲染 ./views/index.rdoc
(和任何其他的 RDoc 模版) 并使用 ./views/post.haml
作为布局.
Radius 模板
需要引入 radius
gem/library 以渲染 Radius 模板:
渲染 ./views/index.radius
。
因为你不能在Radius 模板中调用 Ruby 方法 (除了 yield
) , 你几乎总是需要传递locals给它:
Markaby 模板
需要引入markaby
gem/library以渲染Markaby模板:
渲染 ./views/index.mab
。
你也可以使用嵌入的 Markaby:
Slim 模板
需要引入 slim
gem/library 来渲染 Slim 模板:
渲染 ./views/index.slim
。
Creole 模板
需要引入 creole
gem/library 来渲染 Creole 模板:
渲染 ./views/index.creole
。
CoffeeScript 模板
需要引入 coffee-script
gem/library 并至少满足下面条件一项 以执行Javascript:
node
(来自 Node.js) 在你的路径中你正在运行 OSX
therubyracer
gem/library
请察看 github.com/josh/ruby-coffee-script 获取更新的选项。
现在你可以渲染 CoffeeScript 模版了:
渲染 ./views/application.coffee
。
嵌入模板字符串
渲染嵌入模板字符串。
在模板中访问变量
模板和路由执行器在同样的上下文求值。 在路由执行器中赋值的实例变量可以直接被模板访问。
或者,显式地指定一个本地变量的哈希:
典型的使用情况是在别的模板中按照局部模板的方式来渲染。
内联模板
模板可以在源文件的末尾定义:
注意:引入sinatra的源文件中定义的内联模板才能被自动载入。 如果你在其他源文件中有内联模板, 需要显式执行调用enable :inline_templates
。
具名模板
模板可以通过使用顶层 template
方法定义:
如果存在名为“layout”的模板,该模板会在每个模板渲染的时候被使用。 你可以单独地通过传送 :layout => false
来禁用, 或者通过set :haml, :layout => false
来禁用他们。
关联文件扩展名
为了关联一个文件扩展名到一个模版引擎,使用 Tilt.register
。比如,如果你喜欢使用 tt
作为Textile模版的扩展名,你可以这样做:
添加你自己的模版引擎
首先,通过Tilt注册你自己的引擎,然后创建一个渲染方法:
渲染 ./views/index.myat
。察看 github.com/rtomayko/tilt 来更多了解Tilt.
过滤器
前置过滤器在每个请求前,在请求的上下文环境中被执行, 而且可以修改请求和响应。 在过滤器中设定的实例变量可以被路由和模板访问:
后置过滤器在每个请求之后,在请求的上下文环境中执行, 而且可以修改请求和响应。 在前置过滤器和路由中设定的实例变量可以被后置过滤器访问:
请注意:除非你显式使用 body
方法,而不是在路由中直接返回字符串, 消息体在后置过滤器是不可用的, 因为它在之后才会生成。
过滤器可以可选地带有范式, 只有请求路径满足该范式时才会执行:
和路由一样,过滤器也可以带有条件:
辅助方法
使用顶层的 helpers
方法来定义辅助方法, 以便在路由处理器和模板中使用:
使用 Sessions
Session被用来在请求之间保持状态。如果被激活,每一个用户会话 对应有一个session哈希:
请注意 enable :sessions
实际上保存所有的数据在一个cookie之中。 这可能不会总是做你想要的(比如,保存大量的数据会增加你的流量)。 你可以使用任何的Rack session中间件,为了这么做, *不要*调用 enable :sessions
,而是 按照自己的需要引入你的中间件:
挂起
要想直接地停止请求,在过滤器或者路由中使用:
你也可以指定挂起时的状态码:
或者消息体:
或者两者;
也可以带消息头:
让路
一个路由可以放弃处理,将处理让给下一个匹配的路由,使用 pass
:
路由代码块被直接退出,控制流继续前进到下一个匹配的路由。 如果没有匹配的路由,将返回404。
触发另一个路由
有些时候,pass
并不是你想要的,你希望得到的是另一个路由的结果 。简单的使用 call
可以做到这一点:
请注意在以上例子中,你可以更加简化测试并增加性能,只要简单的移动
和 /bar
同时使用的helper。
如果你希望请求被发送到同一个应用,而不是副本, 使用 call!
而不是 call
.
察看 Rack specification 如果你想更多了解 call
.
设定 消息体,状态码和消息头
通过路由代码块的返回值来设定状态码和消息体不仅是可能的,而且是推荐的。 但是,在某些场景中你可能想在作业流程中的特定点上设置消息体。 你可以通过 body
辅助方法这么做。 如果你这样做了, 你可以在那以后使用该方法获得消息体:
也可以传一个代码块给 body
,它将会被Rack处理器执行( 这将可以被用来实现streaming,参见“返回值”)。
和消息体类似,你也可以设定状态码和消息头:
如同 body
, 不带参数的 headers
和 status
可以用来访问 他们你的当前值.
媒体类型
当使用 send_file
或者静态文件的场合,你的媒体类型可能 Sinatra并不理解。使用 mime_type
通过文件扩展名来注册它们:
你也可以通过 content_type
辅助方法使用:
生成 URL
为了生成URL,你需要使用 url
辅助方法, 例如,在Haml中:
它会根据反向代理和Rack路由,如果有的话,来计算生成的URL。
这个方法还有一个别名 to
(见下面的例子).
浏览器重定向
你可以通过 redirect
辅助方法触发浏览器重定向:
任何额外的参数都会被以 halt
相同的方式来处理:
你可以方便的通过 redirect back
把用户重定向到来自的页面:
为了传递参数给redirect,或者加入query:
或者使用session:
缓存控制
正确地设定消息头是恰当的HTTP缓存的基础。
你可以方便的设定 Cache-Control 消息头,像这样:
核心提示: 在前置过滤器中设定缓存.
如果你正在用 expires
辅助方法设定对应的消息头 Cache-Control
会自动设定:
为了合适地使用缓存,你应该考虑使用 etag
和 last_modified
方法。. 推荐在执行繁重任务*之前*使用这些helpers, 他们会立刻发送响应,如果客户端在缓存中已经有了当前版本。
使用 weak ETag 也是有可能的:
这些辅助方法并不会为你做任何缓存,而是将必要的信息传送给你的缓存 如果你在寻找缓存的快速解决方案,试试rack-cache:
发送文件
为了发送文件,你可以使用 send_file
辅助方法:
也可以带一些选项:
可用的选项有:
- filename
- 响应中的文件名,默认是真实文件的名字。
- last_modified
- Last-Modified 消息头的值,默认是文件的mtime(修改时间)。
- type
- 使用的内容类型,如果没有会从文件扩展名猜测。
- disposition
- 用于 Content-Disposition,可能的包括: nil (默认), :attachment 和 :inline
- length
- Content-Length 的值,默认是文件的大小。
如果Rack处理器支持,Ruby进程除streaming以外的方式会被使用。 如果你使用这个辅助方法, Sinatra会自动处理range请求。
访问请求对象
传入的请求对象可以在请求层(过滤器,路由,错误处理) 通过 request
方法被访问:
一些选项,例如 script_name
或者 path_info
也是可写的:
request.body
是一个IO或者StringIO对象:
附件
你可以使用 attachment
辅助方法来告诉浏览器响应 应当被写入磁盘而不是在浏览器中显示。
你也可以传递一个文件名:
查找模板文件
find_template
辅助方法被用于在渲染时查找模板文件:
这并不是很有用。但是在你需要重载这个方法 来实现你自己的查找机制的时候有用。 比如,如果你想支持多于一个视图目录:
另一个例子是为不同的引擎使用不同的目录:
你可以很容易地包装成一个扩展然后与他人分享!
请注意 find_template
并不会检查文件真的存在, 而是对任何可能的路径调用给入的代码块。这并不会带来性能问题, 因为 render
会在找到文件的时候马上使用 break
。 同样的,模板的路径(和内容)会在除development mode以外的场合 被缓存。你应该时刻提醒自己这一点, 如果你真的想写一个非常疯狂的方法。
配置
运行一次,在启动的时候,在任何环境下:
只当环境 (RACK_ENV environment 变量) 被设定为 :production
的时候运行:
当环境被设定为 :production
或者 :test
的时候运行:
你可以使用 settings
获得这些配置:
可选的设置
- absolute_redirects
如果被禁用,Sinatra会允许使用相对路径重定向, 但是,Sinatra就不再遵守 RFC 2616标准 (HTTP 1.1), 该标准只允许绝对路径重定向。
如果你的应用运行在一个未恰当设置的反向代理之后, 你需要启用这个选项。注意 url 辅助方法 仍然会生成绝对 URL,除非你传入 false 作为第二参数。
默认禁用。
- add_charsets
设定 content_type 辅助方法会 自动加上字符集信息的多媒体类型。
你应该添加而不是覆盖这个选项: settings.add_charsets << "application/foobar"
- app_file
- 主应用文件,用来检测项目的根路径, views和public文件夹和内联模板。
- bind
- 绑定的IP 地址 (默认: 0.0.0.0)。 仅对于内置的服务器有用。
- default_encoding
- 默认编码 (默认为 "utf-8")。
- dump_errors
- 在log中显示错误。
- environment
- 当前环境,默认是 ENV['RACK_ENV'], 或者 "development" 如果不可用。
- logging
- 使用logger
- lock
对每一个请求放置一个锁, 只使用进程并发处理请求。
如果你的应用不是线程安全则需启动。 默认禁用。
- method_override
- 使用 _method 魔法以允许在旧的浏览器中在 表单中使用 put/delete 方法
- port
- 监听的端口号。只对内置服务器有用。
- prefixed_redirects
- 是否添加 request.script_name 到 重定向请求,如果没有设定绝对路径。那样的话 redirect '/foo' 会和redirect to('/foo')起相同作用。默认禁用。
- public_folder
- public文件夹的位置。
- reload_templates
- 是否每个请求都重新载入模板。 在development mode和 Ruby 1.8.6 中被企业(用来 消除一个Ruby内存泄漏的bug)。
- root
- 项目的根目录。
- raise_errors
- 抛出异常(应用会停下)。
- run
- 如果启用,Sinatra会开启web服务器。 如果使用rackup或其他方式则不要启用。
- running
- 内置的服务器在运行吗? 不要修改这个设置!
- server
- 服务器,或用于内置服务器的列表。 默认是 [‘thin’, ‘mongrel’, ‘webrick’], 顺序表明了 优先级。
- sessions
- 开启基于cookie的sesson。
- show_exceptions
- 在浏览器中显示一个stack trace。
- static
- Sinatra是否处理静态文件。 当服务器能够处理则禁用。 禁用会增强性能。 默认开启。
- views
- views 文件夹。
错误处理
错误处理在与路由和前置过滤器相同的上下文中运行, 这意味着你可以使用许多好东西,比如 haml
, erb
, halt
,等等。
未找到
当一个 Sinatra::NotFound
错误被抛出的时候, 或者响应状态码是404,not_found
处理器会被调用:
错误
error
处理器,在任何路由代码块或者过滤器抛出异常的时候会被调用。 异常对象可以通过sinatra.error
Rack 变量获得:
自定义错误:
那么,当这个发生的时候:
你会得到:
另一种替代方法是,为一个状态码安装错误处理器:
或者一个范围:
在运行在development环境下时,Sinatra会安装特殊的 not_found
和 error
处理器。
Rack 中间件
Sinatra 依靠 Rack, 一个面向Ruby web框架的最小标准接口。 Rack的一个最有趣的面向应用开发者的能力是支持“中间件”——坐落在服务器和你的应用之间, 监视 并/或 操作HTTP请求/响应以 提供多样类型的常用功能。
Sinatra 让建立Rack中间件管道异常简单, 通过顶层的 use
方法:
use
的语义和在 Rack::Builder DSL(在rack文件中最频繁使用)中定义的完全一样。例如,use
方法接受 多个/可变 参数,包括代码块:
Rack中分布有多样的标准中间件,针对日志, 调试,URL路由,认证和session处理。 Sinatra会自动使用这里面的大部分组件, 所以你一般不需要显示地 use
他们。
测试
Sinatra的测试可以使用任何基于Rack的测试程序库或者框架来编写。 Rack::Test 是推荐候选:
请注意: 内置的 Sinatra::Test 模块和 Sinatra::TestHarness 类 在 0.9.2 版本已废弃。
Sinatra::Base - 中间件,程序库和模块化应用
把你的应用定义在顶层,对于微型应用这会工作得很好, 但是在构建可复用的组件时候会带来客观的不利, 比如构建Rack中间件,Rails metal,带有服务器组件的简单程序库, 或者甚至是Sinatra扩展。顶层的DSL污染了Object命名空间, 并假定了一个微型应用风格的配置 (例如, 单一的应用文件, ./public 和 ./views 目录,日志,异常细节页面,等等)。 这时应该让 Sinatra::Base 走到台前了:
Sinatra::Base子类可用的方法实际上就是通过顶层 DSL 可用的方法。 大部分顶层应用可以通过两个改变转换成Sinatra::Base组件:
你的文件应当引入
sinatra/base
而不是sinatra
; 否则,所有的Sinatra的 DSL 方法将会被引进到 主命名空间。把你的应用的路由,错误处理,过滤器和选项放在 一个Sinatra::Base的子类中。
+Sinatra::Base+
是一张白纸。大部分的选项默认是禁用的, 包含内置的服务器。参见 选项和配置 查看可用选项的具体细节和他们的行为。
模块化 vs. 传统的方式
与通常的认识相反,传统的方式没有任何错误。 如果它适合你的应用,你不需要转换到模块化的应用。
和模块化方式相比只有两个缺点:
你对每个Ruby进程只能定义一个Sinatra应用,如果你需要更多, 切换到模块化方式。
传统方式使用代理方法污染了 Object 。如果你打算 把你的应用封装进一个 library/gem,转换到模块化方式。
没有任何原因阻止你混合模块化和传统方式。
如果从一种转换到另一种,你需要注意settings中的 一些微小的不同:
运行一个模块化应用
有两种方式运行一个模块化应用,使用 run!
来运行:
运行:
或者使用一个 config.ru
,允许你使用任何Rack处理器:
运行:
使用config.ru运行传统方式的应用
编写你的应用:
加入相应的 config.ru
:
什么时候用 config.ru?
以下情况你可能需要使用 config.ru
:
你要使用不同的 Rack 处理器部署 (Passenger, Unicorn, Heroku, …).
你想使用一个或者多个
Sinatra::Base
的子类.你只想把Sinatra当作中间件使用,而不是端点。
你并不需要切换到config.ru
仅仅因为你切换到模块化方式, 你同样不需要切换到模块化方式, 仅仅因为要运行 config.ru
.
把Sinatra当成中间件来使用
不仅Sinatra有能力使用其他的Rack中间件,任何Sinatra 应用程序都可以反过来自身被当作中间件,被加在任何Rack端点前面。 这个端点可以是任何Sinatra应用,或者任何基于Rack的应用程序 (Rails/Ramaze/Camping/…)。
变量域和绑定
当前所在的变量域决定了哪些方法和变量是可用的。
应用/类 变量域
每个Sinatra应用相当与Sinatra::Base的一个子类。 如果你在使用顶层DSL(require 'sinatra'
),那么这个类就是 Sinatra::Application,或者这个类就是你显式创建的子类。 在类层面,你具有的方法类似于 `get` 或者 `before`,但是你不能访问 `request` 对象或者 `session`, 因为对于所有的请求, 只有单一的应用类。
通过 `set` 创建的选项是类层面的方法:
在下列情况下你将拥有应用变量域的绑定:
在应用类中
在扩展中定义的方法
传递给 `helpers` 的代码块
用作`set`值的过程/代码块
你可以访问变量域对象(就是应用类)就像这样:
通过传递给代码块的对象 (
configure { |c| ... }
)在请求变量域中使用`settings`
请求/实例 变量域
对于每个进入的请求,一个新的应用类的实例会被创建 所有的处理器代码块在该变量域被运行。在这个变量域中, 你可以访问 `request` 和 `session` 对象,或者调用渲染方法比如 `erb` 或者 `haml`。你可以在请求变量域当中通过`settings`辅助方法 访问应用变量域:
在以下情况将获得请求变量域:
get/head/post/put/delete 代码块
前置/后置 过滤器
辅助方法
模板/视图
代理变量域
代理变量域只是把方法转送到类变量域。可是, 他并非表现得100%类似于类变量域, 因为你并不能获得类的绑定: 只有显式地标记为供代理使用的方法才是可用的, 而且你不能和类变量域共享变量/状态。(解释:你有了一个不同的 `self`)。 你可以显式地增加方法代理,通过调用 Sinatra::Delegator.delegate :method_name
。
在以下情况将获得代理变量域:
顶层的绑定,如果你做过
require "sinatra"
在扩展了 `Sinatra::Delegator` mixin的对象
自己在这里看一下代码: Sinatra::Delegator mixin 已经 被包含进了主命名空间。
命令行
Sinatra 应用可以被直接运行:
选项是:
必要条件
推荐在 Ruby 1.8.7, 1.9.2, JRuby 或者 Rubinius 上安装Sinatra。
下面的Ruby版本是官方支持的:
- Ruby 1.8.6
- 不推荐在1.8.6上安装Sinatra, 但是直到Sinatra 1.3.0发布才会放弃对它的支持。 RDoc 和 CoffeScript模板不被这个Ruby版本支持。 1.8.6在它的Hash实现中包含一个内存泄漏问题, 该问题会被1.1.1版本之前的Sinatra引发。 当前版本使用性能下降的代价排除了这个问题。你需要把Rack降级到1.1.x, 因为Rack \>= 1.2不再支持1.8.6。
- Ruby 1.8.7
- 1.8.7 被完全支持,但是,如果没有特别原因, 我们推荐你升级到 1.9.2 或者切换到 JRuby 或者 Rubinius.
- Ruby 1.9.2
- 1.9.2 被支持而且推荐。注意 Radius 和 Markaby 模板并不和1.9兼容。不要使用 1.9.2p0, 它被已知会产生 segmentation faults.
- Rubinius
- Rubinius 被官方支持 (Rubinius \>= 1.2.2), 除了Textile模板。
- JRuby
- JRuby 被官方支持 (JRuby \>= 1.5.6)。 目前未知和第三方模板库有关的问题, 但是,如果你选择了JRuby,请查看一下JRuby rack 处理器, 因为 Thin web 服务器还没有在JRuby上获得支持。
我们也会时刻关注新的Ruby版本。
下面的 Ruby 实现没有被官方支持, 但是已知可以运行 Sinatra:
JRuby 和 Rubinius 老版本
MacRuby
Maglev
IronRuby
Ruby 1.9.0 and 1.9.1
不被官方支持的意思是,如果在不被支持的平台上有运行错误, 我们假定不是我们的问题,而是平台的问题。
Sinatra应该会运行在任何支持上述Ruby实现的操作系统。
紧追前沿
如果你喜欢使用 Sinatra 的最新鲜的代码,请放心的使用 master 分支来运行你的程序,它会非常的稳定。
我们也会不定期的发布预发布gems,所以你也可以运行
来获得最新的特性。
通过Bundler
如果你想使用最新的Sinatra运行你的应用,通过 Bundler 是推荐的方式。
首先,安装bundler,如果你还没有安装:
然后,在你的项目目录下,创建一个 Gemfile
:
请注意在这里你需要列出你的应用的所有依赖关系。 Sinatra的直接依赖关系 (Rack and Tilt) 将会, 自动被Bundler获取和添加。
现在你可以像这样运行你的应用:
使用自己的
创建一个本地克隆并通过 sinatra/lib
目录运行你的应用, 通过 $LOAD_PATH
:
为了在未来更新 Sinatra 源代码:
全局安装
你可以自行编译 gem :
如果你以root身份安装 gems,最后一步应该是