PHP 連接 MySQL 核心擴展函數速查：mysql/mysqli/PDO 三代 API 對比

前言

PHP 連接 MySQL 歷經三代 API：mysql_* (已移除)、mysqli (增強)、PDO (抽象層)。本文速查核心函數、預處理、事務、錯誤處理對比。

一、三代 API 狀態

二、核心流程對比

1. 連接

set_charset('utf8mb4');

// PDO (推薦)
$pdo = new PDO('mysql:host=localhost;dbname=db;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_EMULATE_PREPARES => false,
]);

2. 查詢 (有結果集)

query('SELECT * FROM users');
while ($row = $res->fetch_assoc()) { ... }
$res->free();

// PDO
$stmt = $pdo->query('SELECT * FROM users');
while ($row = $stmt->fetch()) { ... }
// 無需顯式釋放，變量銷毀自動釋放

3. 執行 (無結果集: INSERT/UPDATE/DELETE)

query("INSERT INTO users (name) VALUES ('test')");
$id = $mysqli->insert_id;
$affected = $mysqli->affected_rows;

// PDO
$pdo->exec("INSERT INTO users (name) VALUES ('test')");
$id = $pdo->lastInsertId();
$affected = $stmt->rowCount(); // 需用 exec 或 prepare+execute

4. 預處理語句 (核心防注入)

prepare('SELECT * FROM users WHERE id = ? AND status = ?');
$stmt->bind_param('ii', $id, $status); // 類型: i/d/s/b
$stmt->execute();
$res = $stmt->get_result();
while ($row = $res->fetch_assoc()) { ... }
$stmt->close();

// PDO
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = :id AND status = :status');
$stmt->execute([':id' => $id, ':status' => $status]);
while ($row = $stmt->fetch()) { ... }

5. 事務處理

begin_transaction();
try {
    $mysqli->query("INSERT ...");
    $mysqli->query("UPDATE ...");
    $mysqli->commit();
} catch (Exception $e) {
    $mysqli->rollback();
    throw $e;
}

// PDO
$pdo->beginTransaction();
try {
    $pdo->exec("INSERT ...");
    $pdo->exec("UPDATE ...");
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    throw $e;
}

6. 錯誤處理

query("...") or throw new Exception($mysqli->error);

// PDO (異常模式 - 推薦)
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
try {
    $pdo->query("...");
} catch (PDOException $e) {
    error_log($e->getMessage());
    // 用戶友好提示
}

三、結果集處理函數對比

四、mysqli 面向過程 vs 面向對象

函數名對應規律：mysqli_function($link, ...) ↔ $mysqli->function(...)。建議統一使用面向對象風格，代碼更清晰、IDE 提示更好。

五、PDO 進階技巧

1. 調試 SQL：$stmt->debugDumpParams() 查看綁定參數
2. 異步查詢：PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false (需 mysqlnd)
3. 多語句：PDO::MYSQL_ATTR_MULTI_STATEMENTS => true (慎用)
4. 獲取元數據：$stmt->getColumnMeta($i)

六、遷移建議

1. 舊專案 mysql_* → mysqli：語法相近，機械替換 + 加預處理
2. 新專案直接用 PDO：統一介面、支援 SQLite/PostgreSQL/Oracle 遷移
3. 封裝 Database 類：隱藏底層 API，業務代碼調用 db->query()/db->execute()
4. 啟用嚴格錯誤模式：開發期拋出異常，生產期記錄日誌

總結

mysql_* 歷史使命結束，mysqli 適合純 MySQL 高性能場景，PDO 以統一介面、真實預處理、跨數據庫、異常處理成為現代 PHP 專案首選。核心原則：永遠使用預處理語句，永不拼接 SQL。