ruby china wiki：ruby-china.org/wiki
The Rails Doctrine: ruby-china.org/wiki/the-ra…
Guides:
- guides.rubyonrails.org/
- ruby-china.github.io/rails-guide…
ruby toolbox: www.ruby-toolbox.com/
0. 前言
最近国内互联网就业市场持续低迷，作为主要着力于前端技术的我，也开始探索后端、部署相关的技术。之前除了接触过 Node.js，还有一门我一直想学习和应用的语言就是 Ruby 了。
第一次听说 Ruby 是在 2020 年的夏天，当时还是土木 🐶 的我，从前辈口中听说了 Ruby 这个词，他说他要亲自教我，但是没有天赋的我还是去土木和设计行业卷了一阵子才正式返航计算机。虽迟但到，在 2023 年的夏天，我写下这一篇快速入门，也算是一种重逢吧！
Ruby 同样是一门面向对象的语言，抛开性能不谈，它的语法非常简单，行文甚至比 Python 还要简洁，而且足够语义化，这也是我选择它的重要原因。Rails 作为 Ruby 的开发框架，和大部分其他语言框架一样采用 MVC 架构（附录 A 中我添加了 MVC 的说明），它提供了一些工具和函数来快速开发 Web 应用程序。另一方面，它还支持主流的数据库，比如：MySQL、PostgreSQL 和 SQLite 等。
目前，我正在开发一个 H5 小应用，数据库使用的是 PostgreSQL，总体体验下来，还算 OK，如果要问我，什么是 Rails？
Rails = Routes + MVC
以下是正文。
1. 创建 Rails API
安装 ruby 的过程我就省略了，安装完成后执行 ruby --version 来查看版本。
1.1 生成 rails api 服务
在 docker 容器中执行以下命令生成一个 rails api 服务
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/ bundle config mirror.https://rubygems.org https://gems.ruby-china.com gem install rails -v 7.0.2.3 pacman -S postgresql-libs cd ~/repos rails new --api --database=postgresql --skip-test catdou-1 code catdou-1 bin/rails server
会报错，需要启动一个数据库，如下。
1.2 启动 postgres 数据库
在宿主机终端执行以下命令启动一个 postgres 数据库（版本为 14）
docker run -d --name db-for-catdou -e POSTGRES_USER=catdou -e POSTGRES_PASSWORD=123456 -e POSTGRES_DB=catdou_dev -e PGDATA=/var/lib/postgresql/data/pgdata -v catdou-data:/var/lib/postgresql/data --network=network1 postgres:14
1.3 连接数据库
配置开发环境变量，config/database.yml
development: <<: *default database: catdou_dev username: catdou password: 123456 host: db-for-catdou
重新运行 server
bin/rails server
1.4 model 定义
user 是表名，email 和 name 是字段
bin/rails g model user email:string name:string
生成数据库 migrate 文件以及 model 文件：
- db/migrate/20230607152514_create_users.rb
class CreateUsers < ActiveRecord::Migration[7.0] # 定义一个类，用于创建表 def change create_table :users do |t| # 方法名为 create_table，表名为 users t.string :email # 创建字段 email，类型为 string t.string :name # 创建字段 name，类型为 string t.timestamps # 创建时间字段：updated_at 更新时间，created_at 创建时间 end end end
app/models/user.rb
class User < ApplicationRecord end
1.5 数据库迁移同步
将创建的 user 模型迁移到 postgres 数据库（会生成一个 users 表）
bin/rails db:migrate bin/rails db:rollback step=1 # 如果需要的话，可以用它将数据库回退到上一步
1.6 controller 定义
生成 users 的 controller，包括 show 和 create 方法
bin/rails g controller users show create
生成 users 的控制器文件以及添加相应路由
- app/controllers/users_controller.rb（源文件已做修改）
class UsersController < ApplicationController def show user = User.find_by_id params[:id] # 在 users 表中找到对应 id 的那一行记录 if user render json: user # 如果存在，返回 user else head 404 # 如果不存在，返回一个 404 响应码 end end def create # 在 users 表中新建一条记录，email 是 'eric@x.com'，name 是 'eric' user = User.new email: 'eric@x.com', name: 'eric' if user.save # 如果保存成功了 render json: user # 返回给前端 json 数据（新建的 user） else # 否则 render json: user.errors # 返回给前端 json 数据（user 的报错） end end
config/routes.rb（路由文件中会自动添加以下两行内容）
get 'users/show' get 'users/create'
路由文件需要修改，上面自动生成的两句删除不用，添加以下两句代码到 routes.rb 中：
get "/users/:id", to: "users#show" # 当用户对 "/users/:id" 发起 get 请求时，对应 controller 动作为 show post "/users/", to: "users#create" # 当用户对 "/users/" 发起 post 请求时，对应 controller 动作为 create
1.7 model 数据校验
数据校验一般在 model 层进行。假设，需要对 users 表的 email 字段进行必填校验。
那么在 app/models/users.rb 中添加以下代码即可：
class User < ApplicationRecord validates :email, presence: true # email 是必填的 end
- validates :email 告诉它要校验的字段是 email
- presence: true 校验规则是 email 必须到场（presence）
2. RESTful API
restfulapi.cn/
medium.com/@haldar.mah…
3. API 开发
根据产品需求和 UI、UX 设计数据库与 API。
3.1 路由表生成
利用 namespace 构建以以 /api/v1 开头的 api 路由表：
config/routes.rb
Rails.application.routes.draw do namespace :api do namespace :v1 do # /api/v1 resources :validation_codes, only: [:create] resource :session, only: [:create, :destroy] resource :me, only: [:show] resources :items resources :tags # resources :taggings, only: [:create, :index, :destroy] end end end
生成路由表：bin/rails routes
$ bin/rails routes Prefix Verb URI Pattern Controller#Action # 验证码（申请或删除账号时） api_v1_validation_codes POST /api/v1/validation_codes(.:format) api/v1/validation_codes#create # 登录登出 api_v1_session DELETE /api/v1/session(.:format) api/v1/sessions#destroy POST /api/v1/session(.:format) api/v1/sessions#create # 个人信息（获取姓名、邮箱） api_v1_me GET /api/v1/me(.:format) api/v1/mes#show # 所有账单（获取、新增） api_v1_items GET /api/v1/items(.:format) api/v1/items#index POST /api/v1/items(.:format) api/v1/items#create # 单笔账单（获取、更新、删除） api_v1_item GET /api/v1/items/:id(.:format) api/v1/items#show PATCH /api/v1/items/:id(.:format) api/v1/items#update PUT /api/v1/items/:id(.:format) api/v1/items#update DELETE /api/v1/items/:id(.:format) api/v1/items#destroy # 所有标签（获取，新增） api_v1_tags GET /api/v1/tags(.:format) api/v1/tags#index POST /api/v1/tags(.:format) api/v1/tags#create api_v1_tag GET /api/v1/tags/:id(.:format) api/v1/tags#show PATCH /api/v1/tags/:id(.:format) api/v1/tags#update PUT /api/v1/tags/:id(.:format) api/v1/tags#update DELETE /api/v1/tags/:id(.:format) api/v1/tags#destroy # 其他
3.2 model > migrate > controller
按照附录 A 依次创建 model、迁移数据库，创建 controller
3.3 分页功能
- kaminari # 更加简单
- pagy # 性能更好
