PHP 連接 MySQL 與執行 SQL：從 mysql_* 遷移至 PDO 的現代化實作

歷史程式碼回顧（已棄用）

早期教學常見 mysql_connect、mysql_query 等函數，但 PHP 5.5 棄用、PHP 7.0 移除，現代專案嚴禁使用。

<?php
// ❌ 已移除的舊 API
$conn = mysql_connect("localhost", "root", "") or die("wrong!");
mysql_select_db("mydb", $conn);
$sql = "INSERT INTO `mydb`.`test` (`id`, `uid`, `regdate`, `remark`) VALUES ('', 'php200', now(), 'dddd')";
$que = mysql_query($sql, $conn);
echo $que ? "true" : "wrong";
?>

現代標準：PDO (PHP Data Objects)

PDO 提供資料庫抽象層，支援預處理語句防止 SQL 注入，且可輕鬆切換資料庫驅動。

基礎連線與錯誤處理

<?php
$dsn = 'mysql:host=localhost;dbname=mydb;charset=utf8mb4';
$user = 'root';
$pass = '';
$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // 拋出例外
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // 關聯陣列
    PDO::ATTR_EMULATE_PREPARES   => false,                  // 使用原生預處理
];

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
} catch (PDOException $e) {
    error_log("資料庫連線失敗: " . $e->getMessage());
    die("系統暫時無法使用，請稍後再試");
}
?>

新增資料：預處理語句

<?php
$sql = "INSERT INTO `test` (`uid`, `regdate`, `remark`) VALUES (?, NOW(), ?)";
$stmt = $pdo->prepare($sql);
$stmt->execute(['php200', 'dddd']);

echo "新增成功，ID: " . $pdo->lastInsertId();
?>

查詢資料

<?php
// 單筆
$stmt = $pdo->prepare("SELECT * FROM `test` WHERE `uid` = ?");
$stmt->execute(['php200']);
$row = $stmt->fetch();
var_dump($row);

// 多筆
$stmt = $pdo->query("SELECT * FROM `test` ORDER BY `regdate` DESC LIMIT 10");
$rows = $stmt->fetchAll();
foreach ($rows as $row) {
    echo "{$row['uid']} - {$row['remark']}<br>";
}
?>

交易控制

<?php
try {
    $pdo->beginTransaction();
    
    $pdo->prepare("INSERT INTO `logs` (`msg`) VALUES (?)")->execute(['操作 A']);
    $pdo->prepare("UPDATE `accounts` SET `balance` = `balance` - 100 WHERE `id` = 1")->execute();
    $pdo->prepare("INSERT INTO `transactions` (`type`, `amount`) VALUES (?, ?)")->execute(['withdraw', 100]);
    
    $pdo->commit();
    echo "交易完成";
} catch (Exception $e) {
    $pdo->rollBack();
    error_log("交易失敗回滾: " . $e->getMessage());
    throw $e;
}
?>

遷移檢查清單

⚡ 效能提示：大量寫入時，單次交易包裹多條 execute() 並最後 commit()，可大幅提升吞吐量。