原文使用已棄用的 mysql_* 函數,現代 PHP 應改用 PDO(PHP Data Objects)實現資料庫抽象,支援預處理語句、事務、多驅動切換。
<?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']);
ERRMODE_EXCEPTION 讓錯誤可被 try-catch 捕獲,避免靜默失敗。transaction() 保證原子性,自動回滾。utf8mb4(支援 Emoji),而非舊版 utf8。ATTR_EMULATE_PREPARES 使用原生預處理,防止邊緣案例注入。wait_timeout。