Sinatra入门教程轻量级Ruby Web框架
在Web开发的世界里，有时候我们需要的不是功能齐全的大型框架，而是一把精巧的小刀——简单、锋利、易用。Sinatra就是这样一把小刀！
作为一个轻量级的Ruby Web框架，Sinatra让构建Web应用变得前所未有的简单。它不强加MVC架构，不要求复杂的目录结构，却能让你快速构建出高效的Web应用。
什么是Sinatra？
Sinatra是一个基于Ruby语言的DSL（领域特定语言），用于快速创建Web应用。它由Blake Mizerany于2007年创建，取名自著名歌手Frank Sinatra（多酷啊！）。
与Rails这种大而全的框架不同，Sinatra专注于最小化，只提供必要的工具来处理HTTP请求和响应。它的座右铭是"用最少的努力从想法到实现"——这正是许多开发者所追求的！
为什么选择Sinatra？
- 轻量级 - 核心代码仅几千行，学习曲线平缓
- 灵活性 - 不强制任何特定架构或目录结构
- 快速启动 - 几分钟内就能创建一个功能性Web应用
- Ruby优雅性 - 继承了Ruby语言的简洁和表现力
- 适合小型项目 - API、微服务、原型设计的理想选择
我曾经需要快速搭建一个简单的API服务，Rails感觉太重了（像用大炮打蚊子），而Sinatra则完美契合——短短30行代码就解决了问题！
安装Sinatra
开始使用Sinatra超级简单！确保你已安装Ruby（推荐2.6.0或更高版本），然后只需运行：
gem install sinatra
就这样！不需要生成器，不需要初始化项目，一行命令搞定安装。（比起某些需要复杂配置的框架，是不是超级轻松？）
你的第一个Sinatra应用
让我们创建一个经典的"Hello World"应用，体验Sinatra的简洁之美：
# app.rb
require 'sinatra'
get '/' do
'Hello, Sinatra世界!'
end
将上面的代码保存为app.rb，然后在终端中运行：
ruby app.rb
现在打开浏览器，访问http://localhost:4567，你会看到"Hello, Sinatra世界!"。就是这么简单！
这段代码做了什么？它定义了一个HTTP GET路由"/"，当有请求访问这个路由时，返回字符串'Hello, Sinatra世界!'。没有模板，没有控制器，没有复杂的配置——纯粹而直接！
路由与HTTP方法
Sinatra的核心概念是路由。路由将HTTP请求方法与URL匹配模式关联起来。
# 基本路由示例
get '/hello' do
'Hello from GET'
end
post '/hello' do
'Hello from POST'
end
put '/hello' do
'Hello from PUT'
end
delete '/hello' do
'Hello from DELETE'
end
Sinatra支持所有标准HTTP方法：GET、POST、PUT、DELETE、OPTIONS、PATCH和HEAD。
动态路由
想要创建动态路由？超级容易！
get '/hello/:name' do
"你好, #{params[:name]}!"
end
访问/hello/小明，页面会显示"你好, 小明!"。路由参数通过params哈希自动可用。
我第一次使用这个功能时简直惊呆了——如此简洁的语法却能完成这么强大的功能！
模板与视图
虽然直接返回字符串很酷，但实际应用中我们需要更复杂的HTML输出。Sinatra支持多种模板引擎，默认使用ERB：
get '/template' do
erb :index
end
这会渲染views/index.erb文件。默认情况下，Sinatra在./views目录中查找模板文件。
ERB模板示例 (views/index.erb)：
<!DOCTYPE html>
<html>
<head>
<title>我的Sinatra应用</title>
</head>
<body>
<h1>欢迎来到Sinatra世界!</h1>
<p>当前时间是: <%= Time.now %></p>
</body>
</html>
除了ERB，Sinatra还支持多种模板引擎：Haml、Slim、Liquid、Markdown等等。你可以根据自己的喜好选择！
处理表单数据
Web应用少不了表单处理。用Sinatra处理表单数据同样直观：
get '/form' do
erb :form
end
post '/submit' do
"你提交的名字是: #{params[:name]}"
end
表单模板 (views/form.erb)：
<form action="/submit" method="post">
<label for="name">你的名字:</label>
<input type="text" id="name" name="name">
<input type="submit" value="提交">
</form>
通过params哈希，我们可以轻松访问所有提交的表单数据。简单吧！
会话与Cookie
需要在请求之间保持状态？Sinatra提供了简单的会话支持：
enable :sessions
get '/count' do
session[:count] ||= 0
session[:count] += 1
"你已访问此页面 #{session[:count]} 次"
end
默认情况下，Sinatra使用基于cookie的会话。对于简单应用来说这已经足够，但如果需要存储更多数据，可以考虑使用Redis或数据库来存储会话。
静态文件
对于CSS、JavaScript和图片等静态文件，Sinatra默认从./public目录提供服务：
project/
|- app.rb
|- public/
|- css/
|- style.css
|- js/
|- script.js
|- images/
|- logo.png
然后在你的ERB模板中：
<link rel="stylesheet" href="/css/style.css">
<script src="/js/script.js"></script>
<img src="/images/logo.png">
不需要任何额外配置，Sinatra自动处理这些静态资源！（真是贴心啊！）
中间件与Rack
Sinatra建立在Rack之上，这意味着你可以使用任何Rack中间件。例如，添加日志记录中间件：
require 'sinatra'
require 'rack/logger'
use Rack::Logger
get '/' do
logger.info "收到请求!"
'Hello World!'
end
这种模块化设计让Sinatra既保持轻量，又能根据需要扩展功能。
数据库集成
Sinatra本身不包含ORM（对象关系映射），但它可以轻松集成任何Ruby数据库库。使用ActiveRecord（Rails的ORM）是最常见的选择：
require 'sinatra'
require 'sinatra/activerecord'
set :database, {adapter: 'sqlite3', database: 'development.sqlite3'}
class User < ActiveRecord::Base
end
get '/users' do
@users = User.all
erb :users
end
配合sinatra-activerecordgem，你可以获得几乎与Rails相同的数据库功能，但不需要整个Rails框架的负担。
实用技巧
1. 重定向
get '/old-path' do
redirect '/new-path'
end
2. 设置HTTP状态码
get '/not-found' do
status 404
'页面不存在'
end
3. 内容类型设置
get '/api/data' do
content_type :json
{ name: '张三', age: 30 }.to_json
end
4. 错误处理
not_found do
'404 - 找不到页面'
end
error do
'发生错误 - ' + env['sinatra.error'].message
end
结构化你的Sinatra应用
对于较大的应用，可以采用模块化结构：
# config.ru
require './app'
run App
# app.rb
class App < Sinatra::Base
get '/' do
'Hello from modular app!'
end
# 其他路由和配置...
end
这种结构让你可以像组织其他Ruby代码一样组织Sinatra应用，使其更易于维护。
部署Sinatra应用
Sinatra应用可以部署到任何支持Rack的服务器。最常见的选择是：
- Heroku - 只需添加
Gemfile和config.ru - AWS - 使用Elastic Beanstalk或EC2
- 自托管服务器 - 使用Passenger、Puma或Unicorn
部署通常比预期的简单得多，尤其是与Heroku这样的平台服务结合使用时。
真实案例：一个简单的任务管理器
让我们构建一个简单但实用的任务管理器，集合前面讲到的概念：
require 'sinatra'
require 'sinatra/activerecord'
require 'sqlite3'
set :database, {adapter: 'sqlite3', database: 'tasks.sqlite3'}
class Task < ActiveRecord::Base
end
# 创建表（实际应用中使用迁移）
unless Task.table_exists?
ActiveRecord::Base.connection.create_table :tasks do |t|
t.string :title
t.boolean :completed, default: false
t.timestamps
end
end
# 显示任务列表
get '/' do
@tasks = Task.order(created_at: :desc)
erb :index
end
# 添加新任务
post '/tasks' do
Task.create(title: params[:title], completed: false)
redirect '/'
end
# 标记任务为完成
put '/tasks/:id' do
task = Task.find(params[:id])
task.update(completed: !task.completed)
redirect '/'
end
# 删除任务
delete '/tasks/:id' do
Task.find(params[:id]).destroy
redirect '/'
end
视图文件 (views/index.erb):
<!DOCTYPE html>
<html>
<head>
<title>任务管理器</title>
<style>
.completed { text-decoration: line-through; color: gray; }
</style>
</head>
<body>
<h1>我的任务</h1>
<form action="/tasks" method="post">
<input type="text" name="title" placeholder="添加新任务..." required>
<button type="submit">添加</button>
</form>
<ul>
<% @tasks.each do |task| %>
<li class="<%= 'completed' if task.completed %>">
<%= task.title %>
<form action="/tasks/<%= task.id %>" method="post" style="display: inline">
<input type="hidden" name="_method" value="put">
<button type="submit"><%= task.completed ? '恢复' : '完成' %></button>
</form>
<form action="/tasks/<%= task.id %>" method="post" style="display: inline">
<input type="hidden" name="_method" value="delete">
<button type="submit">删除</button>
</form>
</li>
<% end %>
</ul>
</body>
</html>
还需要在应用中启用方法重写（因为HTML表单只支持GET和POST）：
use Rack::MethodOverride
这个简单的应用已经具备了完整的CRUD功能，而代码量却出奇地少！
结语
Sinatra是一个美丽的悖论——通过提供更少的功能，它反而给了你更多的自由。它不会告诉你应该如何构建应用，而是提供必要的工具，让你自己决定。
对于API、微服务、小型Web应用或原型设计，Sinatra是绝佳选择。甚至对于初学者来说，它也是学习Web开发的理想起点——没有复杂概念的干扰，直接了解HTTP和Web的核心原理。
记住，Web开发并不总是需要重型框架。有时候，一把精巧的小刀比一把瑞士军刀更适合任务。
Sinatra就是这样一把小刀——简单、优雅、高效。
所以下次当你需要构建一个Web应用时，问问自己：我真的需要一个庞大的框架吗？也许，Sinatra已经足够。
现在，去创建你自己的Sinatra应用吧！我保证，这会是一段愉快的开发体验！
浙公网安备 33010602011771号