おつかれさまです。Railsで新規登録(会員登録)機能を作る方法を紹介します。
has_secure_password の記事でログイン処理は書いたのですが、そもそも登録する部分を書いていませんでした。
何を作るのか
こういうものを作ります。
- メールアドレスとパスワードを入力するフォーム
- 入力に問題があればエラーを表示して、入力内容は残す
- 問題なければ保存して、そのままログイン状態にする
最後の「そのままログイン状態にする」は地味に大事です。登録した直後にもう一度ログイン画面が出てきたら、使う側としては面倒なので。
登録が完了するまでに何が起きるか
ボタンを押してから完了するまでを、順に追ってみます。
1. GET /signup フォームの画面を表示する
2. POST /users 入力された内容が送られてくる
3. 受け取った内容でユーザーを作る
4. 保存できるかチェックする
├ OK → 保存する → ログイン状態にする → 完了画面へ
└ NG → エラーを付けてフォームに戻す
ポイントは4番で道が分かれることです。
登録フォームは「1回表示して終わり」ではありません。エラーのたびにフォームに戻ってくるので、入力済みの内容を保持したまま再表示する必要があります。ここを雑に作ると、エラーのたびに全部入力し直しになります。
この流れはMVCの記事で書いたリクエストの流れと同じです。ルーティングがURLを見て、コントローラが処理して、ビューが画面を作ります。
必要になるファイル
上の流れを作るのに、触るファイルはこれだけです。
db/migrate/xxxx_create_users.rb テーブルの定義
app/models/user.rb 保存してよいかのルール
config/routes.rb URLと処理の対応
app/controllers/users_controller.rb 登録処理
app/views/users/new.html.erb フォームの画面
前提にするもの
パスワードの扱いは has_secure_password を使います。bcrypt を入れて、password_digest カラムを用意して、モデルに1行書くというやつです。
この仕組み自体は別記事にまとめてあるので、このシリーズでは細かく触れません。まだ読んでいなければ先にどうぞ。
ログイン処理(SessionsController や current_user)も同じ記事に書いてあります
usersテーブルに何を持たせるか
ここからは設計の話です。まず、必要なカラムを決めます。
| カラム | 用途 |
|---|---|
email | ログインIDとして使う |
password_digest | ハッシュ化したパスワード |
最初はこの2つだけで十分です。名前やプロフィール画像は後から足せるので、動くところまでを最短で作ります。
emailのバリデーション設計
同じメールアドレスで2人登録されると困るので、こう書きます。
validates :email, uniqueness: true
これで弾かれます。ただし、これだけでは不十分です。
実際に流れるSQLを見ると、やっていることはこうです。
SELECT 1 AS one FROM "users" WHERE "users"."email" = ? LIMIT ?
INSERT INTO "users" ("email", "password_digest") VALUES (?, ?)
「まず探して、無ければ入れる」という2段構えになっています。
問題は、この2つの間に隙間があることです。同じメールアドレスでほぼ同時に2件リクエストが来ると、どちらも「まだ無い」と判定して、両方とも保存されてしまう可能性があります。
バリデーションを通らない経路もあります。
User.new(email: 'ota@example.com', password: 'pass1234').save(validate: false)
User.where(email: 'ota@example.com').count
# => 2 重複が入ってしまった
確実に防ぐには、データベース側にユニークインデックスを張ります。
add_index :users, :email, unique: true
こうしておくと、バリデーションをすり抜けてもDBが弾いてくれます。
ActiveRecord::RecordNotUnique
バリデーションは「親切なエラーメッセージを出すため」、インデックスは「本当に重複を防ぐため」と役割が分かれています。片方ではなく両方書きます。
大文字と小文字をどうするか
そのままだと、大文字小文字の違いは別物として扱われます。
# ota@example.com が登録済みでも…
User.new(email: 'OTA@example.com', password: 'pass1234').valid?
# => true 登録できてしまう
メールアドレスは大文字小文字を区別しないのが普通なので、保存する前に小文字へ揃えます。
before_save { self.email = email.downcase }
validates :email, uniqueness: { case_sensitive: false }
これで揃います。
User.create!(email: 'NEGI@Example.COM', password: 'pass1234')
User.last.email
# => "negi@example.com"
User.new(email: 'negi@example.com', password: 'pass1234').valid?
# => false ["Email has already been taken"]
空を許さない
email と password_digest は、どちらも無いと成立しません。モデル側のバリデーションに加えて、テーブル側でも NOT NULL にしておきます。
考え方は重複対策と同じで、アプリ側とDB側の二重で守る形です。
このシリーズの流れ
次回は、ここで決めた設計をそのままコードにします。
ps: 登録フォームは簡単そうに見えて、考えることが多い
3件のコメント