PHP โปรเจกต์: ระบบสมาชิก สมัคร–เข้าสู่ระบบ



โปรเจกต์นี้ทำ authentication ที่ปลอดภัยด้วย PHP ล้วน — เป็นสิ่งที่แทบทุกเว็บต้องมี

หน้าที่มี

GET/POST  /register    สมัครสมาชิก
GET/POST  /login       เข้าสู่ระบบ
POST      /logout      ออกจากระบบ
GET       /dashboard   หน้าสมาชิก (ต้องล็อกอิน)

โครงสร้าง

auth-app/
├── public/index.php
├── src/
│   ├── Database.php
│   ├── UserRepository.php
│   ├── Auth.php
│   ├── Csrf.php
│   └── helpers.php
├── templates/
│   ├── layout.php
│   ├── register.php
│   ├── login.php
│   └── dashboard.php
├── schema.sql
└── storage/

schema.sql

CREATE TABLE IF NOT EXISTS users (
    id            INTEGER PRIMARY KEY AUTOINCREMENT,
    name          TEXT NOT NULL,
    email         TEXT NOT NULL UNIQUE,
    password_hash TEXT NOT NULL,
    created_at    TEXT NOT NULL DEFAULT (datetime('now'))
);

src/helpers.php

<?php
declare(strict_types=1);

function e(?string $s): string
{
    return htmlspecialchars((string) $s, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}

function redirect(string $path): never
{
    header("Location: $path");
    exit;
}

function view(string $name, array $data = []): string
{
    extract($data, EXTR_SKIP);
    ob_start();
    require __DIR__ . "/../templates/$name.php";
    return ob_get_clean();
}

function flash(?string $msg = null): ?string
{
    if ($msg !== null) {
        $_SESSION['_flash'] = $msg;
        return null;
    }
    $m = $_SESSION['_flash'] ?? null;
    unset($_SESSION['_flash']);
    return $m;
}

function old(string $key): string
{
    return e($_SESSION['_old'][$key] ?? '');
}

src/Csrf.php

<?php
declare(strict_types=1);

namespace App;

final class Csrf
{
    public static function token(): string
    {
        return $_SESSION['_csrf'] ??= bin2hex(random_bytes(32));
    }

    public static function field(): string
    {
        return '<input type="hidden" name="_csrf" value="' . self::token() . '">';
    }

    public static function check(): void
    {
        $sent = $_POST['_csrf'] ?? '';
        if (!is_string($sent) || !hash_equals(self::token(), $sent)) {
            http_response_code(419);
            exit('เซสชันหมดอายุ กรุณาโหลดหน้าใหม่');
        }
    }
}

src/UserRepository.php

<?php
declare(strict_types=1);

namespace App;

use PDO;

final class UserRepository
{
    public function __construct(private PDO $pdo) {}

    public function findByEmail(string $email): ?array
    {
        $stmt = $this->pdo->prepare('SELECT * FROM users WHERE email = ?');
        $stmt->execute([mb_strtolower($email)]);
        return $stmt->fetch() ?: null;
    }

    public function find(int $id): ?array
    {
        $stmt = $this->pdo->prepare('SELECT * FROM users WHERE id = ?');
        $stmt->execute([$id]);
        return $stmt->fetch() ?: null;
    }

    public function create(string $name, string $email, string $passwordHash): int
    {
        $stmt = $this->pdo->prepare(
            'INSERT INTO users (name, email, password_hash) VALUES (?, ?, ?)'
        );
        $stmt->execute([$name, mb_strtolower($email), $passwordHash]);
        return (int) $this->pdo->lastInsertId();
    }
}

src/Auth.php

<?php
declare(strict_types=1);

namespace App;

final class Auth
{
    private const DUMMY_HASH =
        '$2y$12$usesomesillystringforsalt.OM8dV0f1234567890abcdefghijklmn';

    public function __construct(private UserRepository $users) {}

    public function attempt(string $email, string $password): bool
    {
        $user = $this->users->findByEmail($email);
        $hash = $user['password_hash'] ?? self::DUMMY_HASH;

        if (!password_verify($password, $hash) || $user === null) {
            return false;
        }

        session_regenerate_id(true);
        $_SESSION['user_id'] = (int) $user['id'];

        if (password_needs_rehash($hash, PASSWORD_DEFAULT)) {
            // อัปเดต hash ... (ปล่อยเป็นการบ้าน)
        }
        return true;
    }

    public function user(): ?array
    {
        if (!isset($_SESSION['user_id'])) {
            return null;
        }
        return $this->users->find($_SESSION['user_id']);
    }

    public function requireLogin(): array
    {
        $user = $this->user();
        if ($user === null) {
            \flash('กรุณาเข้าสู่ระบบก่อน');
            \redirect('/login');
        }
        return $user;
    }

    public function logout(): void
    {
        $_SESSION = [];
        session_destroy();
    }
}

public/index.php

<?php
declare(strict_types=1);

require __DIR__ . '/../vendor/autoload.php';
require __DIR__ . '/../src/helpers.php';

use App\{Database, UserRepository, Auth, Csrf};

session_set_cookie_params([
    'httponly' => true,
    'samesite' => 'Lax',
    'secure'   => ($_SERVER['HTTPS'] ?? '') === 'on',
]);
session_start();

$pdo  = Database::connect(__DIR__ . '/../storage/auth.db');
$auth = new Auth(new UserRepository($pdo));

$path   = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$method = $_SERVER['REQUEST_METHOD'];

// ---------- register ----------
if ($path === '/register' && $method === 'GET') {
    echo view('register', ['csrf' => Csrf::field(), 'flash' => flash()]);
    exit;
}

if ($path === '/register' && $method === 'POST') {
    Csrf::check();

    $name  = trim($_POST['name'] ?? '');
    $email = trim($_POST['email'] ?? '');
    $pass  = (string) ($_POST['password'] ?? '');
    $confirm = (string) ($_POST['password_confirm'] ?? '');

    $errors = [];
    if ($name === '')                                    $errors['name'] = 'กรุณากรอกชื่อ';
    if (!filter_var($email, FILTER_VALIDATE_EMAIL))      $errors['email'] = 'อีเมลไม่ถูกต้อง';
    if (strlen($pass) < 8 || strlen($pass) > 72)         $errors['password'] = 'รหัสผ่าน 8–72 ตัวอักษร';
    if ($pass !== $confirm)                              $errors['password_confirm'] = 'รหัสผ่านไม่ตรงกัน';

    $users = new UserRepository($pdo);
    if (!isset($errors['email']) && $users->findByEmail($email)) {
        $errors['email'] = 'อีเมลนี้ถูกใช้แล้ว';
    }

    if ($errors) {
        $_SESSION['_old'] = ['name' => $name, 'email' => $email];
        echo view('register', ['csrf' => Csrf::field(), 'errors' => $errors, 'flash' => null]);
        exit;
    }

    $id = $users->create($name, $email, password_hash($pass, PASSWORD_DEFAULT));
    unset($_SESSION['_old']);

    session_regenerate_id(true);
    $_SESSION['user_id'] = $id;
    flash('สมัครสมาชิกสำเร็จ ยินดีต้อนรับ!');
    redirect('/dashboard');
}

// ---------- login ----------
if ($path === '/login' && $method === 'GET') {
    echo view('login', ['csrf' => Csrf::field(), 'flash' => flash()]);
    exit;
}

if ($path === '/login' && $method === 'POST') {
    Csrf::check();

    if ($auth->attempt($_POST['email'] ?? '', $_POST['password'] ?? '')) {
        flash('เข้าสู่ระบบสำเร็จ');
        redirect('/dashboard');
    }

    $_SESSION['_old'] = ['email' => trim($_POST['email'] ?? '')];
    echo view('login', [
        'csrf' => Csrf::field(),
        'error' => 'อีเมลหรือรหัสผ่านไม่ถูกต้อง',
        'flash' => null,
    ]);
    exit;
}

// ---------- logout ----------
if ($path === '/logout' && $method === 'POST') {
    Csrf::check();
    $auth->logout();
    redirect('/login');
}

// ---------- dashboard (ต้องล็อกอิน) ----------
if ($path === '/dashboard') {
    $user = $auth->requireLogin();
    echo view('dashboard', [
        'user'  => $user,
        'csrf'  => Csrf::field(),
        'flash' => flash(),
    ]);
    exit;
}

http_response_code(404);
echo 'ไม่พบหน้านี้';

templates/layout.php + register.php

<?php /* templates/layout.php */ ?>
<!DOCTYPE html>
<html lang="th">
<head><meta charset="utf-8"><title><?= e($title ?? 'App') ?></title></head>
<body>
<?php if (!empty($flash)): ?>
    <p style="color:green"><?= e($flash) ?></p>
<?php endif; ?>
<?= $content ?>
</body>
</html>
<?php /* templates/register.php */
$errors ??= [];
ob_start(); ?>
<h1>สมัครสมาชิก</h1>
<form method="post" action="/register">
    <?= $csrf ?>
    <p><input name="name" placeholder="ชื่อ" value="<?= old('name') ?>">
       <?= isset($errors['name']) ? '<span style="color:red">'.e($errors['name']).'</span>' : '' ?></p>
    <p><input name="email" type="email" placeholder="อีเมล" value="<?= old('email') ?>">
       <?= isset($errors['email']) ? '<span style="color:red">'.e($errors['email']).'</span>' : '' ?></p>
    <p><input name="password" type="password" placeholder="รหัสผ่าน">
       <?= isset($errors['password']) ? '<span style="color:red">'.e($errors['password']).'</span>' : '' ?></p>
    <p><input name="password_confirm" type="password" placeholder="ยืนยันรหัสผ่าน">
       <?= isset($errors['password_confirm']) ? '<span style="color:red">'.e($errors['password_confirm']).'</span>' : '' ?></p>
    <button>สมัคร</button>
</form>
<p><a href="/login">มีบัญชีแล้ว เข้าสู่ระบบ</a></p>
<?php $content = ob_get_clean();
$title = 'สมัครสมาชิก';
require __DIR__ . '/layout.php';

dashboard.php มีปุ่ม logout เป็นฟอร์ม POST (ไม่ใช่ลิงก์ — GET ห้ามเปลี่ยนสถานะ):

<h1>สวัสดี <?= e($user['name']) ?></h1>
<p>อีเมล: <?= e($user['email']) ?></p>
<form method="post" action="/logout"><?= $csrf ?><button>ออกจากระบบ</button></form>

รันและทดสอบ

php -S localhost:8000 -t public

เปิด /register → กรอกฟอร์ม → ถูกพาไป /dashboard → refresh ได้ (PRG) → ปิดเบราว์เซอร์เปิดใหม่ → /dashboard เด้งไป /login → ล็อกอิน → กลับเข้าได้

ทดสอบความปลอดภัย:

  • กรอก email ที่ซ้ำ → “อีเมลนี้ถูกใช้แล้ว”
  • ล็อกอินรหัสผิด → “อีเมลหรือรหัสผ่านไม่ถูกต้อง” (ข้อความเดียวกันไม่ว่า email มีหรือไม่)
  • ส่ง POST ไป /login โดยไม่มี _csrf → 419
  • เปิด SQLite ดู: คอลัมน์ password_hash เป็น $2y$12$... ไม่ใช่รหัสจริง

เรื่องที่คนมักพลาด

  • ลืม session_regenerate_id(true) ตอนสมัคร/ล็อกอิน — session fixation
  • logout เป็นลิงก์ GET — CSRF ผ่าน <img src="/logout"> ทำให้คนถูกเตะออกได้ (และ prefetch ของ browser)
  • แสดง error แยก “ไม่มี email” กับ “รหัสผิด” — user enumeration
  • ไม่ hash_equals ตอนเช็ค CSRF — timing
  • เก็บ $user ทั้งก้อนใน session — ข้อมูลค้าง (เปลี่ยนชื่อในที่อื่นแล้วไม่อัปเดต) เก็บแค่ user_id ดึงสด
  • requireLogin() แค่ซ่อนเนื้อหา แต่ไม่ exit/redirect — โค้ดข้างล่างยังรัน
  • secure => true บน localhost http — cookie ไม่ติด ล็อกอินไม่ได้ (โค้ดข้างบนเช็ค $_SERVER['HTTPS'])

สรุป

  • สมัคร: validate → เช็ค email ซ้ำ → password_hash($pw, PASSWORD_DEFAULT) → บันทึก → session_regenerate_id(true) → PRG
  • ล็อกอิน: password_verify กับ dummy hash เสมอ → session_regenerate_id(true) → เก็บแค่ user_id
  • requireLogin() ที่ redirect('/login') + exit ต้นทุกหน้าที่ป้องกัน
  • CSRF token (hash_equals) ในทุกฟอร์ม POST รวม logout, logout เป็น POST
  • e() ทุกค่าที่แสดง, flash message ผ่าน session + PRG
  • เก็บ user_id ใน session ดึงข้อมูล user สดจาก DB

บทถัดไป โปรเจกต์บล็อก MVC เขียนมือ — แยก Controller / Model / View, routing, และ template ที่ปลอดภัย