【Rails】新規登録機能を作る① 全体像とテーブル設計

【Rails】新規登録機能を作る① 全体像とテーブル設計

おつかれさまです。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側の二重で守る形です。

このシリーズの流れ

  1. 全体像とテーブル設計(この記事)
  2. モデルを作る — マイグレーションとバリデーション
  3. 登録処理を書く — ルーティングとコントローラ
  4. フォームを作る — ビューとエラー表示

次回は、ここで決めた設計をそのままコードにします。

ps: 登録フォームは簡単そうに見えて、考えることが多い

3件のコメント

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です