くるみ
- 難しいカスタマイズとかはいいから、deviseの基本的な導入方法を知りたい
- Railsでログイン認証機能を簡単に実装したい
という方に向けて「deviseを使ってログイン認証を秒で実装する方法」をまとめました。
自分のための備忘録でもありますが参考になれば幸いです⸝⸝- ̫ -⸝⸝
お品書き
そもそもdeviseって?
deviseはログイン認証機能を簡単に実装できるようにしてくれるgemの一つです。
加えてメール認証機能やTwitter連携などもお手軽に実装できる優れもの。
くるみ
ログイン認証を実装するまでの手順
多いように感じますが、やることはとてもシンプルかつ簡単です。秒で終わります。
ブログ主
Railsでdeviseを使ってログイン認証を実装する方法
プロジェクトを作成する
$ rails new line --skip-coffee
まずアプリケーションを作成します。
gemをインストール
gem 'devise'
Gemfileに上のように追記しgemをインストールしてあげます。
bundle install
deviseの設定
rails g devise:install
上のようにコマンドを叩いてあげると、以下のような長ったらしい説明が表示されます
Running via Spring preloader in process 27916
create config/initializers/devise.rb
create config/locales/devise.en.yml
===============================================================================
Depending on your application's configuration some manual setup may be required:
1. Ensure you have defined default url options in your environments files. Here
is an example of default_url_options appropriate for a development environment
in config/environments/development.rb:
config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }
In production, :host should be set to the actual host of your application.
* Required for all applications. *
2. Ensure you have defined root_url to *something* in your config/routes.rb.
For example:
root to: "home#index"
* Not required for API-only Applications *
3. Ensure you have flash messages in app/views/layouts/application.html.erb.
For example:
<p class="notice"><%= notice %></p>
<p class="alert"><%= alert %></p>
* Not required for API-only Applications *
4. You can copy Devise views (for customization) to your app by running:
rails g devise:views
* Not required *
===============================================================================
これがどういうことか噛み砕いて解説すると、以下のような意味になります。
- メールで必要になる認証リンクのURLを設定してね
- トップページのルーティングを設定してね
- アラートを設置してね
- 見た目を変えたかったらビューを作ってね
くるみ
認証リンクのURLの設定
config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }
config/environments/development.rbに上のように追記してあげます。
次にログインメッセージなどを表示するためにアラート達を設定していきます。
アラートの設置
<%if flash.notice%>
<p class="notice"><%= notice %></p>
<%end%>
<%if flash.alert%>
<p class="alert"><%= alert %></p>
<%end%>
以上をapplication.html.erbのbodyの直下辺りに設置してあげます。
くるみ
認証モデルを作る
$ rails g devise user
ログインやらなんやらをするモデルを生成します。
この場合userモデルでパスワードやメールアドレスなどを扱うわけですね。
ルーティングをいじる
Rails.application.routes.draw do
devise_for :users
devise_scope :user do#トップページをログイン画面に
root "users/sessions#new"
end
end
次に、トップ画面をログイン画面にしたいので上のようにroutes.rbに記述してあげます。
classApplicationController < ActionController::Base
def after_sign_in_path_for(resource)
"(ログイン後に遷移させたいページ)"
end
end
そしてapplication_controller.rbに上のようにメソッドを追加してあげます。
ブログ主
$ rails db:migrate
そしてマイグレーションを実行してあげればOK。
localhost:3000がログイン画面になってるはずです⸝⸝- ̫ -⸝⸝
ひとまずこれで終わりっ。
deviseを日本語化したい場合
「英語だと見辛い…」という場合があるかもしれませんが、このdeviseは簡単に日本語化することができます。gem 'devise-i18n'
gem 'devise-i18n-views'
$ bundle install
まず上のgemをインストールしてあげます。
require_relative 'boot'
require 'rails/all'
# Require the gems listed in Gemfile, including any gems
# you've limited to :test, :development, or :production.
Bundler.require(*Rails.groups)
module Line
class Application < Rails::Application
# Initialize configuration defaults for originally generated Rails version.
config.load_defaults 5.2
config.i18n.default_locale = :ja #追記
(省略)
そしたらconfig/apprication.rbに「config.i18n.default_locale = :ja」を追記します
rails g devise:views:locale ja
最後にこのコマンドを叩いてあげれば完了です。
くるみ
ビューやコントローラーをカスタマイズしたい時の方法
「見た目が気にくわない…マジもう無理…」という方向けに。
それぞれ以下のコマンドを叩いてあげれば専用のビューが生成されカスタマイズすることができます。コントローラーも。
ビューをカスタマイズしたい場合
rails g devise:views
コントローラーをカスタマイズしたい場合
rails g devise:controllers users
まとめ
参考になれば幸いです!では⸝⸝- ̫ -⸝⸝