ユーザー登録・ログイン機能（Deviseの導入と設定）

Ruby on Railsにおける「ユーザー登録・ログイン機能」の実装には、認証ライブラリである Devise を導入するのが一般的です。以下では、Deviseの導入から基本設定、機能追加までを段階的に詳しく説明します。

1. Deviseとは

Devise は、ユーザー認証のための強力なRailsエンジンであり、以下のような機能を簡単に実装できます。

  • ユーザー登録（サインアップ）

  • ログイン／ログアウト

  • パスワードのハッシュ化・保存

  • セッション管理

  • パスワードリセット

  • メールによる認証確認（オプション）

2. Deviseの導入手順

2-1. Gemの追加

Gemfileに以下を追加します。

ruby
gem 'devise'

その後、以下のコマンドでインストールします。

sh
bundle install

2-2. Deviseのインストール

sh
rails generate devise:install

このコマンドにより、初期設定ファイル（config/initializers/devise.rb）が作成されます。

3. 初期設定の確認

config/environments/development.rb に以下を追加して、Deviseからのメール通知が正しく機能するようにします。

ruby
config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }

application.html.erb にフラッシュメッセージを表示するコードを追加することも推奨されます。

erb
<p class="notice"><%= notice %></p>
<p class="alert"><%= alert %></p>

4. ユーザーモデルの作成

以下のコマンドで、Devise対応のユーザーモデルを生成します。

sh
rails generate devise User

このコマンドにより、User モデルおよび認証情報を保持するためのマイグレーションファイルが作成されます。

sh
rails db:migrate

5. ルーティングの確認

config/routes.rb に次のようなルーティングが自動で追加されます。

ruby
devise_for :users

これにより、以下のようなルートが有効になります。

  • GET /users/sign_up（新規登録フォーム）

  • POST /users（登録処理）

  • GET /users/sign_in（ログインフォーム）

  • DELETE /users/sign_out（ログアウト処理）

6. ログイン状態の制御

コントローラ側で認証を要求する

特定のアクションをログインユーザーのみに制限したい場合は、コントローラで次のようにします。

ruby
before_action :authenticate_user!

この記述により、未ログイン状態では自動的にログイン画面へリダイレクトされます。

7. ログインユーザーの情報取得

ビューやコントローラ内で、ログイン中のユーザー情報を取得するには次のヘルパーメソッドを使用します。

ruby
current_user # 現在ログインしているユーザー
user_signed_in? # ログインしているかの判定（true/false）

8. ビューのカスタマイズ（オプション）

以下のコマンドで、Deviseが生成するビューをカスタマイズ可能にします。

sh
rails generate devise:views

app/views/devise/ ディレクトリ以下に各種フォーム（sign_in, sign_upなど）のテンプレートが出力されるため、必要に応じてHTMLやCSSを調整できます。

9. 追加機能の導入（オプション）

Deviseには多くのモジュールが存在します。例：

  • :confirmable：メールによるアカウント確認

  • :lockable：一定回数のログイン失敗によるロック

  • :timeoutable：一定時間非操作時に自動ログアウト

利用したい機能はモデルにオプションとして追加し、必要に応じてマイグレーションファイルを作成・実行します。

まとめ

Deviseを導入することで、ユーザー登録・ログイン機能を迅速かつ安全に実装できます。基本的な流れは以下のとおりです。

  1. Gem追加・インストール

  2. 初期設定

  3. Deviseモデルの作成とマイグレーション

  4. 認証の制御（authenticate_user!）

  5. ビューとルーティングの活用

  6. 必要に応じてカスタマイズや追加機能を導入

ChatGPT4o 生成日：2025/06/21