如何为Rails的Clearance Gem添加额外注册字段？

嘿，作为Rails新手用Clearance做身份验证确实省了不少事儿！要给用户添加地址、电话号码这类额外字段其实很简单，我给你一步步拆解：

1. 给users表添加新字段 #

首先得在数据库里加上这些字段，用Rails迁移就搞定了：

rails generate migration AddExtraFieldsToUsers address:string phone:string

执行完生成命令后，跑迁移把字段同步到数据库：

rails db:migrate

2. 让Clearance允许接收新字段的参数 #

Clearance默认只允许email和password这两个参数通过，所以得把新字段加入参数白名单。最简便的方式是在ApplicationController里重写clearance_parameter_filter方法：

class ApplicationController < ActionController::Base
  private

  def clearance_parameter_filter
    # 继承默认的参数，再加上我们的新字段
    super.push(:address, :phone)
  end
end

如果你想更定制化，也可以生成Clearance的用户控制器来修改参数：

rails generate clearance:users_controller

然后在生成的UsersController里的user_params方法中添加新字段就行，不过上面的方法更轻量。

3. 更新注册表单 #

接下来要让用户在注册时能输入这些新字段。如果还没生成Clearance的视图文件，先执行：

rails generate clearance:views

然后打开app/views/clearance/users/new.html.erb，在表单里添加地址和电话号码的输入框：

<div class="field">
  <%= label_tag :address, "地址" %>
  <%= text_field_tag :address, params[:address] %>
</div>

<div class="field">
  <%= label_tag :phone, "电话号码" %>
  <%= text_field_tag :phone, params[:phone] %>
</div>

要是你用的是form_for（比如自定义了表单结构），就改成对应的f.text_field :address这种写法就行。

4. （可选）更新用户编辑页面 #

如果想让用户之后能修改这些字段，同样打开app/views/clearance/users/edit.html.erb，把新字段的输入框加进去，参数白名单已经覆盖了更新操作，所以不用额外改控制器。

额外提示 #

要是你需要对这些新字段做验证（比如电话号码必填），直接在User模型里加验证规则就行：

class User < ApplicationRecord
  include Clearance::User

  validates :address, presence: true
  validates :phone, presence: true, format: { with: /\A\d{11}\z/, message: "必须是11位数字" }
end

这样就搞定啦！有问题随时问～

内容的提问来源于stack exchange，提问作者user9409047