ログイン・認証を作る

自作CMSにログイン機能を追加し、管理画面を認証されたユーザーだけが操作できるようにします。

🎯 目的

これまでの管理画面は、URLを知っていれば誰でもアクセスできる状態でした。

ここにログイン機能を追加し、管理画面を保護します。

今回やること

  1. 認証用のusersテーブルを作る
  2. ユーザー名とパスワードを保存する
  3. パスワードをハッシュ化する
  4. ログイン画面を作る
  5. ログイン処理を作る
  6. セッションを開始する
  7. admin.phpを保護する
  8. ログアウトを作る
ユーザー
↓
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テーブルは、まだ存在していません。

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を読む
$password = 元のパスワードが入った変数です。
password_hash() = パスワードから保存用のハッシュを作るPHP関数です。
PASSWORD_DEFAULT = PHPが推奨するデフォルトのパスワードハッシュ方式を使用します。
$hash = 作られたハッシュを受け取る変数です。

→ DBには$passwordではなく、$hashを保存します。
📘 ハッシュとは
入力されたデータから、一定の方法で別の値を作る処理です。

パスワード認証では、元のパスワードを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 → ログイン失敗の処理

→ 真偽値true / falseによって次の処理を変える、基本的な条件分岐です。

STEP 5|セッションを使う

ログイン成功後はセッションを使って、 ログイン状態を維持します。

session_start();
📘 session_start()とは
session_start() = PHPでセッションを開始、または既存のセッションを再開する関数です。

HTTPの通信は、基本的には1回ごとのリクエストが独立しています。
そこでセッションを使い、複数のページにまたがってログイン状態などを扱えるようにします。
📘 セッションのイメージ
login.phpで認証成功
↓
セッションに「ログイン済み」という情報を持たせる
↓
admin.phpを開く
↓
セッションを確認
↓
ログイン済みなら管理画面を表示

管理画面ではセッションを確認し、 ログインしていないユーザーをログイン画面へ戻します。

今回の仕組み

ユーザー名・パスワードを入力
↓
login.php
↓
usersテーブルからユーザーを取得
↓
password_verify()
↓
認証成功?
↓
YES → セッションにログイン状態を保存
↓
admin.php

📘 認証とは何か

Authentication(認証)は、 「アクセスしてきた人が誰なのか」を確認する仕組みです。

今回は、ユーザー名とパスワードを使って本人を確認します。

認証成功
→ ログイン状態をセッションで維持する

認証していない
→ 管理画面を使わせない

という構造を作ります。

📘 認証とセッションは別の役割

認証
ユーザー名やパスワードを確認する

セッション
認証したあとの状態を、ページをまたいで扱う

→ 「パスワードが正しいか確認すること」と 「ログイン済みの状態を維持すること」は別の役割です。

📘 処理の流れを読む

入力:ユーザー名・パスワード
↓
処理①:usersテーブルからユーザー情報を取得する
↓
処理②:password_verify()でパスワードを確認する
↓
条件判定:認証に成功したか?
↓
YES:セッションにログイン状態を持たせる
NO:管理画面へ進ませない
↓
出力:認証済みならadmin.phpを利用できる

→ 「入力 → DB検索 → 照合 → 条件分岐 → 状態保存 → 出力」という流れです。

📝 今回の忘備録

管理画面を誰でも操作できる状態から、 ログインしたユーザーだけが操作できる状態へ変更します。

パスワードは平文で保存せず、 password_hash()でハッシュ化してDBに保存します。

ログイン時はpassword_verify()で確認します。

認証成功後はセッションを使って、 ページをまたいでログイン状態を扱います。

この先やること

タグ: PHP / MariaDB / SQL / PDO / Authentication / Session / password_hash / password_verify