萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 封裝 PDO 資料庫類:從 mysqli 到現代最佳實踐

原文使用已棄用的 mysql_* 函數,現代 PHP 應改用 PDO(PHP Data Objects)實現資料庫抽象,支援預處理語句、事務、多驅動切換。

現代 PDO 包裝類範例

<?php
declare(strict_types=1);

class Database
{
    private PDO $pdo;

    public function __construct(array $config)
    {
        $dsn = "mysql:host={$config['host']};dbname={$config['dbname']};charset={$config['charset'] ?? 'utf8mb4'}";
        $this->pdo = new PDO($dsn, $config['user'], $config['pass'], [
            PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES   => false, // 使用真實預處理
        ]);
    }

    /** 執行 SELECT,返回陣列 */
    public function query(string $sql, array $params = []): array
    {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll();
    }

    /** 執行 INSERT/UPDATE/DELETE,返回影響行數 */
    public function execute(string $sql, array $params = []): int
    {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->rowCount();
    }

    /** 獲取最後插入 ID */
    public function lastInsertId(): string
    {
        return $this->pdo->lastInsertId();
    }

    /** 事務包裝 */
    public function transaction(callable $callback)
    {
        $this->pdo->beginTransaction();
        try {
            $result = $callback($this);
            $this->pdo->commit();
            return $result;
        } catch (\Throwable $e) {
            $this->pdo->rollBack();
            throw $e;
        }
    }

    /** 獲取底層 PDO 實例(進階用法) */
    public function getPdo(): PDO
    {
        return $this->pdo;
    }
}

// 使用示例
$db = new Database([
    'host'   => '127.0.0.1',
    'user'   => 'root',
    'pass'   => 'password',
    'dbname' => 'my_db',
]);

$users = $db->query('SELECT * FROM users WHERE status = ? AND created_at > ?', [1, '2024-01-01']);
$db->execute('INSERT INTO logs (msg) VALUES (?)', ['User login']);

關鍵優勢

  • SQL 注入防護:預處理語句徹底分離代碼與數據。
  • 驅動無關:僅改 DSN 即可切換 MySQL/PostgreSQL/SQLite/SQL Server。
  • 異常機制:ERRMODE_EXCEPTION 讓錯誤可被 try-catch 捕獲,避免靜默失敗。
  • 事務安全:transaction() 保證原子性,自動回滾。

避坑指南

  1. 字符集請用 utf8mb4(支援 Emoji),而非舊版 utf8。
  2. 關閉 ATTR_EMULATE_PREPARES 使用原生預處理,防止邊緣案例注入。
  3. 長連接慎用:PHP-FPM 池化模式下易導致「MySQL server has gone away」,建議短連接或配置 wait_timeout。
copyright © 萬盛學電腦網 all rights reserved