PHP เชื่อมต่อฐานข้อมูลด้วย PDO



PDO (PHP Data Objects) เป็น API กลางสำหรับคุยกับฐานข้อมูล เขียนครั้งเดียวใช้ได้กับ MySQL, MariaDB, PostgreSQL, SQLite, SQL Server โดยเปลี่ยนแค่ DSN

ทำไม PDO ไม่ใช่ mysqli หรือ mysql_*

  • mysql_* — ถูกลบตั้งแต่ PHP 7 ห้ามใช้เด็ดขาด (บทความเก่าบนเน็ตเต็มไปหมด)
  • mysqli — ใช้ได้ แต่ผูกกับ MySQL อย่างเดียว, API งุ่มง่ามกว่า (bind param ด้วย bind_param('ssi', ...))
  • PDO — API สะอาดกว่า, named placeholder, เปลี่ยนฐานข้อมูลง่าย, เป็นสิ่งที่เฟรมเวิร์กทุกตัวใช้เบื้องหลัง

เชื่อมต่อ

<?php
declare(strict_types=1);

$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=shop;charset=utf8mb4';
$user = 'app';
$pass = 'secret';

$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,   // error -> โยน exception
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,         // ผลลัพธ์เป็นอาร์เรย์ key=ชื่อคอลัมน์
    PDO::ATTR_EMULATE_PREPARES   => false,                   // ใช้ prepared statement จริงของ DB
];

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
} catch (PDOException $e) {
    // อย่าโชว์ $e->getMessage() ให้ผู้ใช้ — มันมี host/user
    error_log('DB connection failed: ' . $e->getMessage());
    http_response_code(503);
    exit('ระบบไม่พร้อมใช้งานชั่วคราว');
}

3 options ที่ต้องตั้งเสมอ

optionค่าทำไม
ATTR_ERRMODEERRMODE_EXCEPTIONไม่งั้น error เงียบ ต้องเช็คค่าคืนทุกบรรทัด
ATTR_DEFAULT_FETCH_MODEFETCH_ASSOCไม่งั้นได้ทั้ง index ตัวเลขและชื่อคอลัมน์ (ข้อมูลเบิ้ล)
ATTR_EMULATE_PREPARESfalseให้ DB ทำ prepared statement จริง ปลอดภัยและ type ถูกกว่า

DSN ของแต่ละฐานข้อมูล

<?php
// MySQL / MariaDB
$dsn = 'mysql:host=127.0.0.1;dbname=shop;charset=utf8mb4';

// PostgreSQL
$dsn = 'pgsql:host=127.0.0.1;port=5432;dbname=shop';

// SQLite (ไฟล์)
$dsn = 'sqlite:' . __DIR__ . '/database/shop.db';

// SQLite (ในหน่วยความจำ — เหมาะกับเทสต์)
$dsn = 'sqlite::memory:';

SQLite ไม่ต้องมี user/pass และไม่ต้องติดตั้ง server — เหมาะกับการเรียนและงานเล็ก บทนี้จะยกตัวอย่างด้วย SQLite เพื่อให้รันตามได้ทันที

ตัวอย่างเต็มด้วย SQLite

<?php
declare(strict_types=1);

$pdo = new PDO('sqlite:' . __DIR__ . '/demo.db', null, null, [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

// สร้างตาราง
$pdo->exec('
    CREATE TABLE IF NOT EXISTS notes (
        id         INTEGER PRIMARY KEY AUTOINCREMENT,
        title      TEXT NOT NULL,
        body       TEXT NOT NULL DEFAULT "",
        created_at TEXT NOT NULL DEFAULT (datetime("now"))
    )
');

// เพิ่มข้อมูล (รายละเอียด prepared statement บทหน้า)
$stmt = $pdo->prepare('INSERT INTO notes (title, body) VALUES (?, ?)');
$stmt->execute(['บันทึกแรก', 'เนื้อหา...']);
$stmt->execute(['บันทึกสอง', 'อีกอัน']);

echo 'เพิ่มแล้ว id ล่าสุด: ', $pdo->lastInsertId(), "\n";

// อ่านข้อมูล
$rows = $pdo->query('SELECT * FROM notes ORDER BY id')->fetchAll();
foreach ($rows as $row) {
    echo "#{$row['id']} {$row['title']} ({$row['created_at']})\n";
}
เพิ่มแล้ว id ล่าสุด: 2
#1 บันทึกแรก (2026-09-07 07:30:00)
#2 บันทึกสอง (2026-09-07 07:30:00)

query() เทียบ exec() เทียบ prepare()

เมธอดใช้กับคืน
exec($sql)คำสั่งที่ไม่คืนแถว (CREATE, และ INSERT/UPDATE/DELETE ที่ไม่มีตัวแปร)จำนวนแถวที่กระทบ
query($sql)SELECT ที่ไม่มีตัวแปร (เช่น query คงที่)PDOStatement (วน/fetchAll ได้)
prepare($sql)->execute($params)ทุกคำสั่งที่มีค่าจากตัวแปรPDOStatement

กฎ: มีค่าจากตัวแปร/ผู้ใช้เมื่อไร ใช้ prepare() + execute() เสมอ — ไม่ต่อสตริงเข้า SQL (บทหน้าอธิบายว่าทำไม)

fetch modes

<?php
$stmt = $pdo->query('SELECT id, title FROM notes');

$stmt->fetch();                          // แถวถัดไป (อาร์เรย์) หรือ false เมื่อหมด
$stmt->fetchAll();                       // ทุกแถวเป็นอาร์เรย์ของอาร์เรย์
$stmt->fetchColumn();                    // คอลัมน์แรกของแถวถัดไป (เช่น COUNT(*))
$stmt->fetchAll(PDO::FETCH_COLUMN);      // อาร์เรย์ของค่าคอลัมน์แรก
$stmt->fetchAll(PDO::FETCH_KEY_PAIR);    // [col1 => col2] (ต้อง SELECT 2 คอลัมน์)
$stmt->fetchObject();                    // แถวเป็น stdClass
$stmt->fetchAll(PDO::FETCH_CLASS, Note::class);  // แต่ละแถวเป็นอ็อบเจกต์ Note

ห่อ PDO ไว้ในที่เดียว

อย่า new PDO(...) กระจายทั่วโปรเจกต์ — สร้างที่เดียวแล้วส่งต่อ (dependency injection):

<?php
// config/database.php
return function (): PDO {
    static $pdo = null;
    if ($pdo === null) {
        $pdo = new PDO(
            $_ENV['DB_DSN'],
            $_ENV['DB_USER'] ?? null,
            $_ENV['DB_PASS'] ?? null,
            [
                PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES   => false,
            ],
        );
    }
    return $pdo;
};
<?php
class NoteRepository
{
    public function __construct(private PDO $pdo) {}

    public function all(): array
    {
        return $this->pdo->query('SELECT * FROM notes ORDER BY id DESC')->fetchAll();
    }
}

คลาสที่ใช้ DB รับ PDO เข้ามาทาง constructor — ทดสอบได้ด้วย SQLite :memory:

การเชื่อมต่อและ PHP lifecycle

จำจากบทที่ 29: PHP เริ่มใหม่ทุก request — การเชื่อมต่อ DB ก็สร้างใหม่ทุก request และปิดเองเมื่อจบสคริปต์ ไม่ต้อง close เอง (ตั้ง $pdo = null; ได้ถ้าอยากปิดก่อนจบ) สำหรับ traffic สูงใช้ persistent connection หรือ connection pooler (เช่น ProxySQL / PgBouncer) แต่เริ่มต้นไม่ต้องกังวล

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

  • ไม่ตั้ง ERRMODE_EXCEPTION — query พังแล้วเงียบ fetchAll() คืน false งงว่าทำไมไม่มีข้อมูล
  • charset=utf8 ใน DSN ของ MySQL — utf8 ของ MySQL เก็บได้แค่ 3 ไบต์ (emoji, อักษรบางตัวหาย) ใช้ utf8mb4
  • โชว์ PDOException::getMessage() ให้ผู้ใช้ — มี host, user, ชื่อ DB, บางทีมีค่าใน query — error_log แล้วแสดงข้อความกลาง ๆ
  • new PDO ในทุกไฟล์/ทุกฟังก์ชัน — เชื่อมต่อซ้ำหลายครั้งต่อ request สร้างที่เดียวส่งต่อ
  • ATTR_EMULATE_PREPARES => true (ค่าเริ่มต้นของ MySQL driver) — placeholder เป็นการแทนสตริงฝั่ง PHP, type เพี้ยน (ทุกอย่างเป็น string), และเปิดช่องบางกรณี ตั้ง false
  • ใช้ query() กับ SQL ที่มีค่าจากผู้ใช้ โดยต่อสตริง — SQL injection (บทหน้า)
  • ลืมว่า SQLite ต้องมีสิทธิ์เขียนทั้งไฟล์ .db และโฟลเดอร์ที่มันอยู่ — error “unable to open database file”

สรุป

  • PDO = API กลาง ใช้ได้หลาย DB — เลิกใช้ mysql_* (ถูกลบ) และ mysqli (ผูก MySQL)
  • เชื่อมต่อ: new PDO($dsn, $user, $pass, $options) ครอบด้วย try/catch (PDOException)
  • ตั้ง 3 options เสมอ: ERRMODE_EXCEPTION, FETCH_ASSOC, EMULATE_PREPARES => false
  • MySQL DSN ใช้ charset=utf8mb4 เท่านั้น
  • exec() คำสั่งคงที่ไม่คืนแถว, query() SELECT คงที่, prepare()->execute() เมื่อมีตัวแปร (เสมอ)
  • สร้าง PDO ที่เดียว ส่งเข้าคลาสทาง constructor — ทดสอบด้วย sqlite::memory:

บทถัดไปว่าด้วย prepared statement และ SQL injection — เหตุผลที่ห้ามต่อสตริงเข้า SQL และวิธี bind ค่าที่ถูกต้อง