ログイン・認証を作る
自作CMSにログイン機能を追加し、管理画面を認証されたユーザーだけが操作できるようにします。
🎯 目的
これまでの管理画面は、URLを知っていれば誰でもアクセスできる状態でした。
ここにログイン機能を追加し、管理画面を保護します。
今回やること
- 認証用のusersテーブルを作る
- ユーザー名とパスワードを保存する
- パスワードをハッシュ化する
- ログイン画面を作る
- ログイン処理を作る
- セッションを開始する
- admin.phpを保護する
- ログアウトを作る
ユーザー
↓
login.php
↓
パスワード確認
↓
セッション
↓
admin.php
↓
login.php
↓
パスワード確認
↓
セッション
↓
admin.php
STEP 1|現在のDBを確認する
まず、現在のデータベースにどのようなテーブルがあるか確認します。
sudo mysql -u root -p it_textbook_test -e "SHOW TABLES;"
📘 コマンドを読む
sudo = 権限を切り替えてコマンドを実行します。mysql = DBへ接続するクライアントを起動します。MariaDBにも接続できます。-u root = DBユーザーをrootに指定します。-p = パスワード入力を求めます。it_textbook_test = 接続するデータベース名です。-e = 後ろに書いたSQLを実行します。SHOW TABLES; = DBに存在するテーブルの一覧を表示するSQLです。
現在はarticlesテーブルだけがあります。
ポイント
認証用のusersテーブルは、まだ存在していません。
認証用のusersテーブルは、まだ存在していません。
STEP 2|usersテーブルを作る
ログインに必要なユーザー情報を保存するテーブルを作ります。
users
├─ id
├─ username
├─ password_hash
└─ created_at
📘 各データの役割
id = ユーザーを識別するIDです。username = ログイン時に使うユーザー名です。password_hash = パスワードそのものではなく、ハッシュ化した値を保存します。created_at = ユーザーを作成した日時です。
パスワードそのものではなく、 ハッシュ化した値を保存する方針です。
STEP 3|パスワードをハッシュ化する
PHPにはパスワードを安全にハッシュ化するための
password_hash()があります。
$hash = password_hash(
$password,
PASSWORD_DEFAULT
);
📘 PHPを読む
→ DBには
$password = 元のパスワードが入った変数です。password_hash() = パスワードから保存用のハッシュを作るPHP関数です。PASSWORD_DEFAULT = PHPが推奨するデフォルトのパスワードハッシュ方式を使用します。$hash = 作られたハッシュを受け取る変数です。→ DBには
$passwordではなく、$hashを保存します。
📘 ハッシュとは
入力されたデータから、一定の方法で別の値を作る処理です。
パスワード認証では、元のパスワードをDBへそのまま保存するのではなく、 パスワード用のハッシュ関数を使って作った値を保存します。
→ ログイン時も、DBから元のパスワードを取り出して比較するわけではありません。
入力されたデータから、一定の方法で別の値を作る処理です。
パスワード認証では、元のパスワードをDBへそのまま保存するのではなく、 パスワード用のハッシュ関数を使って作った値を保存します。
→ ログイン時も、DBから元のパスワードを取り出して比較するわけではありません。
重要
DBにログインパスワードそのものを保存しません。
DBにログインパスワードそのものを保存しません。
STEP 4|ログイン時に確認する
ログイン時には、入力されたパスワードと DBに保存されたハッシュを確認します。
password_verify(
$password,
$user['password_hash']
);
📘 password_verify()を読む
一致する →
一致しない →
→ この結果を条件分岐に使えば、ログイン成功・失敗を分けられます。
password_verify() = 入力されたパスワードが、保存済みのハッシュに対応するか確認するPHP関数です。$password = ログイン画面で入力されたパスワードです。$user['password_hash'] = DBから取得したユーザーのパスワードハッシュです。一致する →
true一致しない →
false→ この結果を条件分岐に使えば、ログイン成功・失敗を分けられます。
📘 科目Bにつなげる:条件分岐
パスワードは正しいか?
↓
YES → ログイン成功の処理
NO → ログイン失敗の処理
→ 真偽値
パスワードは正しいか?
↓
YES → ログイン成功の処理
NO → ログイン失敗の処理
→ 真偽値
true / falseによって次の処理を変える、基本的な条件分岐です。
STEP 5|セッションを使う
ログイン成功後はセッションを使って、 ログイン状態を維持します。
session_start();
📘 session_start()とは
HTTPの通信は、基本的には1回ごとのリクエストが独立しています。
そこでセッションを使い、複数のページにまたがってログイン状態などを扱えるようにします。
session_start() = PHPでセッションを開始、または既存のセッションを再開する関数です。HTTPの通信は、基本的には1回ごとのリクエストが独立しています。
そこでセッションを使い、複数のページにまたがってログイン状態などを扱えるようにします。
📘 セッションのイメージ
login.phpで認証成功
↓
セッションに「ログイン済み」という情報を持たせる
↓
admin.phpを開く
↓
セッションを確認
↓
ログイン済みなら管理画面を表示
login.phpで認証成功
↓
セッションに「ログイン済み」という情報を持たせる
↓
admin.phpを開く
↓
セッションを確認
↓
ログイン済みなら管理画面を表示
管理画面ではセッションを確認し、 ログインしていないユーザーをログイン画面へ戻します。
今回の仕組み
ユーザー名・パスワードを入力
↓
login.php
↓
usersテーブルからユーザーを取得
↓
password_verify()
↓
認証成功?
↓
YES → セッションにログイン状態を保存
↓
admin.php
↓
login.php
↓
usersテーブルからユーザーを取得
↓
password_verify()
↓
認証成功?
↓
YES → セッションにログイン状態を保存
↓
admin.php
📘 認証とは何か
Authentication(認証)は、
「アクセスしてきた人が誰なのか」を確認する仕組みです。
今回は、ユーザー名とパスワードを使って本人を確認します。
認証成功
→ ログイン状態をセッションで維持する
認証していない
→ 管理画面を使わせない
という構造を作ります。
今回は、ユーザー名とパスワードを使って本人を確認します。
認証成功
→ ログイン状態をセッションで維持する
認証していない
→ 管理画面を使わせない
という構造を作ります。
📘 認証とセッションは別の役割
認証
ユーザー名やパスワードを確認する
セッション
認証したあとの状態を、ページをまたいで扱う
→ 「パスワードが正しいか確認すること」と 「ログイン済みの状態を維持すること」は別の役割です。
ユーザー名やパスワードを確認する
セッション
認証したあとの状態を、ページをまたいで扱う
→ 「パスワードが正しいか確認すること」と 「ログイン済みの状態を維持すること」は別の役割です。
📘 処理の流れを読む
入力:ユーザー名・パスワード
↓
処理①:usersテーブルからユーザー情報を取得する
↓
処理②:password_verify()でパスワードを確認する
↓
条件判定:認証に成功したか?
↓
YES:セッションにログイン状態を持たせる
NO:管理画面へ進ませない
↓
出力:認証済みならadmin.phpを利用できる
→ 「入力 → DB検索 → 照合 → 条件分岐 → 状態保存 → 出力」という流れです。
↓
処理①:usersテーブルからユーザー情報を取得する
↓
処理②:password_verify()でパスワードを確認する
↓
条件判定:認証に成功したか?
↓
YES:セッションにログイン状態を持たせる
NO:管理画面へ進ませない
↓
出力:認証済みならadmin.phpを利用できる
→ 「入力 → DB検索 → 照合 → 条件分岐 → 状態保存 → 出力」という流れです。
📝 今回の忘備録
管理画面を誰でも操作できる状態から、
ログインしたユーザーだけが操作できる状態へ変更します。
パスワードは平文で保存せず、
ログイン時は
認証成功後はセッションを使って、 ページをまたいでログイン状態を扱います。
パスワードは平文で保存せず、
password_hash()でハッシュ化してDBに保存します。ログイン時は
password_verify()で確認します。認証成功後はセッションを使って、 ページをまたいでログイン状態を扱います。
この先やること
- usersテーブルを実際に作る
- ログインユーザーを登録する
- login.phpを作る
- admin.phpを認証で保護する
- logout.phpを作る