ログイン認証を実装する②|MariaDBとパスワード認証をつなぐ

PHPからMariaDBへ接続し、usersテーブルのユーザーを検索します。さらにpassword_verify()とセッションを使って、実際のログイン認証を動かします。

🎯 目的

前回はログイン画面を作り、usersテーブルに管理者ユーザーを用意しました。

今回はPHPとMariaDBを実際につなぎ、 入力されたユーザー名とパスワードを確認できるようにします。

最後にセッションへログイン情報を保存し、 認証成功時に管理画面へ移動できるところまで実装します。

今回やること

  1. PHP専用のDBユーザーを作る
  2. DBへの権限を設定する
  3. db.phpを作る
  4. PHPからMariaDBへ接続する
  5. login.phpからユーザーを検索する
  6. password_verify()でパスワードを確認する
  7. セッションにログイン情報を保存する
  8. ログイン成功・失敗を確認する
login.php
↓
db.php
↓
MariaDB
↓
usersテーブル
↓
password_verify()
↓
セッション
↓
admin.php

STEP 1|PHP専用のDBユーザーを作る

最初はPHPからMariaDBへrootユーザーで接続しようとしました。

しかし、この環境ではMariaDBのrootユーザーをそのままPHPから利用する構成にはしませんでした。

そこで、Webアプリ専用のDBユーザーを作成します。

CREATE USER 'it_textbook_app'@'localhost'
IDENTIFIED BY '新しいパスワード';
📘 SQLを読む
CREATE USER = MariaDBに新しいDBユーザーを作ります。
'it_textbook_app' = DBユーザー名です。
@'localhost' = localhostから接続するユーザーとして定義します。
IDENTIFIED BY = このDBユーザーが認証に使うパスワードを設定します。

→ WebアプリからMariaDBへ接続するための専用アカウントを作っています。
📘 rootとアプリ用ユーザーを分ける
rootはDB全体を管理できる強い権限を持つ管理用ユーザーです。

Webアプリには、必要な範囲だけ操作できる専用ユーザーを使います。

→ 「必要なものに、必要な権限だけ与える」という考え方につながります。

STEP 2|データベースへの権限を設定する

作成したユーザーには、 it_textbook_testデータベースに必要な権限だけを与えます。

GRANT SELECT, INSERT, UPDATE, DELETE
ON it_textbook_test.*
TO 'it_textbook_app'@'localhost';
📘 SQLを読む
GRANT = ユーザーへ権限を与えます。
SELECT = データを読む権限です。
INSERT = データを追加する権限です。
UPDATE = データを更新する権限です。
DELETE = データを削除する権限です。
ON = どこに対する権限かを指定します。
it_textbook_test.* = it_textbook_testデータベース内の全テーブルを表します。
TO = 誰に権限を与えるかを指定します。
📘 * の意味
このSQLの*は、 it_textbook_testデータベース内のすべてのテーブルを対象にする指定です。

→ STEP 2の*はSQLの権限指定で使われています。
コマンドによって同じ記号でも意味や使われ方が変わることがあります。

その後、権限を確認します。

SHOW GRANTS FOR 'it_textbook_app'@'localhost';
📘 SHOW GRANTS
SHOW = 情報を表示します。
GRANTS = 与えられている権限です。
FOR = 確認するユーザーを指定します。

→ it_textbook_appに、どんな権限が設定されているか確認しています。

STEP 3|db.phpを作る

MariaDBへの接続処理をlogin.phpから分離し、 db.phpにまとめます。

$host = 'localhost';
$dbname = 'it_textbook_test';
$username = 'it_textbook_app';

$dsn = "mysql:host=$host;dbname=$dbname;charset=utf8mb4";

$pdo = new PDO($dsn, $username, $password, $options);
📘 PHPを読む
$host = DBサーバーの場所です。今回はlocalhostです。
$dbname = 接続するデータベース名です。
$username = MariaDBへ接続するDBユーザー名です。
$password = DBユーザーのパスワードです。
$options = PDOの動作設定です。
$pdo = 作成したPDOオブジェクトを保存する変数です。
📘 DSNとは
DSN = Data Source Name。
DBへ「どの方式で、どこへ、どのDBへ接続するか」を表す接続情報です。

mysql: = MySQL互換のPDOドライバを使います。MariaDBへの接続でも利用できます。
host=$host = 接続先を指定します。
dbname=$dbname = データベース名を指定します。
charset=utf8mb4 = 接続時の文字セットを指定します。
📘 PDOとは
PDO = PHP Data Objects。
PHPからデータベースを操作するためのインターフェースです。

→ PHPとMariaDBの間をつなぐ役割をしています。

これで、他のPHPファイルからも同じDB接続処理を利用できます。

STEP 4|PHPからMariaDBへ接続する

作成したdb.phpを読み込み、実際にDBへ接続できるか確認します。

php -r 'require "/var/www/it-textbook/db.php"; echo "DB接続OK\n";'
📘 コマンドを読む
php = PHPをコマンドラインから実行します。
-r = ファイルではなく、後ろに書いたPHPコードを直接実行します。
require = 指定したPHPファイルを読み込みます。読み込みに失敗すると処理を停止します。
echo = 文字列を出力します。
\n = 改行を表します。

→ db.phpを読み込み、エラーなく接続処理が終わったあと「DB接続OK」と表示するテストです。

実行結果:

DB接続OK
確認できたこと
PHP → PDO → MariaDB の接続が成功しました。

STEP 5|login.phpからユーザーを検索する

login.phpからdb.phpを読み込み、 入力されたユーザー名をusersテーブルから検索します。

require_once __DIR__ . '/db.php';

$stmt = $pdo->prepare(
    'SELECT id, username, password_hash, role
     FROM users
     WHERE username = :username
     LIMIT 1'
);

$stmt->execute([
    ':username' => $username
]);

$user = $stmt->fetch();
📘 require_onceを読む
require_once = PHPファイルを読み込みます。同じファイルがすでに読み込まれていれば、重複して読み込みません。
__DIR__ = 現在のPHPファイルが置かれているディレクトリを表すPHPのマジック定数です。
. = PHPでは文字列を連結する演算子です。
'/db.php' = 読み込むファイル名です。

→ 現在のファイルと同じディレクトリにあるdb.phpを読み込んでいます。
📘 SQLを読む
SELECT = usersテーブルから必要なデータを取得します。
WHERE username = :username = 入力されたユーザー名に一致する行を探します。
:username = 名前付きプレースホルダーです。
LIMIT 1 = 取得する行を最大1件に制限します。
📘 prepare → execute → fetch
prepare() = 値をあとから渡せる形でSQLを準備します。
execute() = プレースホルダーへ値を渡してSQLを実行します。
':username' => $username = :usernameに入力されたユーザー名を対応させます。
fetch() = SQLの結果から1行を取得します。
$user = 取得したユーザー情報を保存します。

→ SQLの構造と入力値を分けて扱うことで、ユーザー入力をSQL文字列へ直接つなげる方法を避けています。

STEP 6|password_verify()で確認する

ユーザーが見つかったら、 入力されたパスワードとDBに保存されているハッシュを確認します。

password_verify(
    $password,
    $user['password_hash']
);
📘 PHPを読む
password_verify() = 入力されたパスワードが、保存されたハッシュに対応するか確認します。
$password = ログインフォームから入力されたパスワードです。
$user['password_hash'] = DBから取得したパスワードハッシュです。

一致する → true
一致しない → false
📘 科目Bにつなげる:条件分岐
ユーザーが存在するか?
↓
YES → パスワードを確認
NO → ログイン失敗

パスワードは正しいか?
↓
YES → ログイン成功
NO → ログイン失敗

→ 認証では複数の条件を順番に判定しています。

パスワードそのものをDBから取り出して比較するのではなく、 PHPのpassword_verify()を利用します。

ポイント
DBには平文のパスワードを保存していません。

STEP 7|セッションにログイン情報を保存する

認証に成功したら、セッションにユーザー情報を保存します。

$_SESSION['user_id'] = $user['id'];
$_SESSION['username'] = $user['username'];
$_SESSION['role'] = $user['role'];
📘 $_SESSIONを読む
$_SESSION = PHPでセッションデータを扱うスーパーグローバル変数です。
['user_id'] = ログインしたユーザーのIDを保存します。
['username'] = ユーザー名を保存します。
['role'] = adminやwriterなどの役割を保存します。

→ 認証後のページでも「誰がログインしているか」「どんな役割か」を参照できるようにします。
📘 セッションを使う前に
PHPで$_SESSIONを利用する処理では、 セッションを開始・再開するためのsession_start()が必要です。

→ session_start()でセッションを利用できる状態にしてから、 $_SESSIONへ値を保存します。

これによって、ログイン後のページでも 「誰がログインしているか」を確認できるようになります。

STEP 8|ログインをテストする

実際にブラウザからログインを確認します。

https://it-textbook.duckdns.org/login.php

正しいユーザー名とパスワードを入力すると、 認証に成功してadmin.phpへ移動します。

間違ったパスワードを入力した場合は、 エラーメッセージが表示されます。

今回の確認結果
正しいパスワード → ログイン成功
間違ったパスワード → ログイン失敗

今回の仕組み

ブラウザ
↓ HTTPS
login.php
↓
db.php
↓
PDO
↓
MariaDB
↓
users
↓
password_verify()
↓
$_SESSION
↓
admin.php

📘 014と015のつながり

014
usersテーブル・adminユーザー・login.php・HTTPSという ログイン機能の土台を作りました。

015
login.phpとMariaDBを接続し、 実際にユーザー名とパスワードを確認して、 認証成功後の情報をセッションへ保存しました。

→ 今回、画面・DB・認証・セッションが一本につながりました。

📘 処理の流れを読む

入力:ユーザー名・パスワード
↓
DB接続:db.php → PDO → MariaDB
↓
検索:usernameを条件にusersテーブルをSELECT
↓
条件①:ユーザーが存在するか?
↓
条件②:password_verify()がtrueか?
↓
YES:$_SESSIONへuser_id・username・roleを保存
↓
出力:admin.phpへ移動

条件に失敗した場合
→ ログイン失敗としてエラーを表示

→ 「入力 → 検索 → 照合 → 条件分岐 → 状態保存 → 画面遷移」 という処理になっています。

📘 ここまでで登場した役割

login.php = ログイン入力と認証処理
db.php = DB接続処理
PDO = PHPからDBを操作するインターフェース
MariaDB = usersなどのデータを保存するDBMS
password_verify() = パスワードを確認する
$_SESSION = 認証後のログイン情報をページ間で扱う
admin.php = 認証後に利用する管理画面

📝 今回の忘備録

PHPからMariaDBへ接続する場合、 DB管理用のrootをWebアプリで使うのではなく、 アプリ専用のDBユーザーを作成しました。

アプリ用ユーザーには、 SELECT・INSERT・UPDATE・DELETEの権限を設定しました。

login.phpでは、 入力されたユーザー名をusersテーブルから検索し、 password_verify()でパスワードを確認。

認証成功後は$_SESSIONにユーザー情報を保存し、 admin.phpへ移動できるようになりました。

この先やること

タグ: PHP / MariaDB / SQL / PDO / DSN / Authentication / Session / password_verify / require_once / Prepared Statement