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 ที่ปลอดภัย