萬盛學電腦網

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

PHP PDO 寫入 MySQL 完整範例:連線、預處理、交易、錯誤處理(棄用 mysql_* 函式)

PHP 官方自 5.5 棄用、7.0 移除 mysql_* 系列函式,**現代專案必須使用 PDO 或 MySQLi**。本文以 PDO 為主,示範連線配置、預處理語句防注入、交易控制、異常處理、批次寫入最佳實踐。

1. 連線配置(單例/依賴注入友善)

<?php
// config/database.php
return [
    'dsn'      => 'mysql:host=127.0.0.1;dbname=mythroad;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, // 使用真實預處理
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci",
    ],
];

// bootstrap/app.php
$cfg = require __DIR__ . '/config/database.php';
$pdo = new PDO($cfg['dsn'], $cfg['user'], $cfg['pass'], $cfg['options']);
// 交給容器或全域變數(簡易專案)

2. 單筆插入(預處理 + 參數綁定)

<?php
// post.php
require 'bootstrap/app.php';

$uname = $_POST['username'] ?? '';
$pwd   = $_POST['password'] ?? '';

if (!$uname || !$pwd) {
    http_response_code(400);
    exit('欄位不得為空');
}

$hash = password_hash($pwd, PASSWORD_DEFAULT); // 現代密碼雜湊

try {
    $stmt = $pdo->prepare('INSERT INTO users (username, password) VALUES (?, ?)');
    $stmt->execute([$uname, $hash]);
    echo "成功錄入,ID: {$pdo->lastInsertId()}";
} catch (PDOException $e) {
    if ($e->getCode() === '23000') { // 唯一鍵衝突
        echo '帳號已存在';
    } else {
        error_log($e->getMessage());
        echo '系統錯誤,請稍後再試';
    }
}

3. 更新資料

<?php
$email = 'xiaoming@163.com';
$username = '小明';

$stmt = $pdo->prepare('UPDATE users SET email = ? WHERE username = ?');
if ($stmt->execute([$email, $username])) {
    echo "更新成功,影響行數: {$stmt->rowCount()}";
} else {
    echo "更新失敗";
}

4. 交易控制(轉帳/訂單建立等多表操作)

<?php
try {
    $pdo->beginTransaction();

    $pdo->prepare('INSERT INTO orders (user_id, total) VALUES (?, ?)')->execute([1, 99.9]);
    $orderId = $pdo->lastInsertId();

    $pdo->prepare('INSERT INTO order_items (order_id, product_id, qty) VALUES (?, ?, ?)')
        ->execute([$orderId, 101, 2]);

    $pdo->prepare('UPDATE products SET stock = stock - 2 WHERE id = 101')->execute();

    $pdo->commit();
    echo '訂單建立成功';
} catch (Throwable $e) {
    $pdo->rollBack();
    error_log('Order failed: ' . $e->getMessage());
    echo '訂單建立失敗,已回滾';
}

5. 批次插入(大量資料高效寫入)

<?php
$rows = [
    ['user1', password_hash('p1', PASSWORD_DEFAULT)],
    ['user2', password_hash('p2', PASSWORD_DEFAULT)],
    // ... 10000 筆
];

$pdo->beginTransaction();
$stmt = $pdo->prepare('INSERT INTO users (username, password) VALUES (?, ?)');
foreach ($rows as $row) {
    $stmt->execute($row);
    // 每 1000 筆 commit 一次,避免長交易鎖表
    if (($stmt->rowCount() % 1000) === 0) {
        $pdo->commit();
        $pdo->beginTransaction();
    }
}
$pdo->commit();

PDO vs MySQLi 快速選型

特性PDOMySQLi
資料庫抽象層支援 12+ 驅動僅 MySQL
命名參數支援 :name僅 ? 位置參數
物件導向完整 OO程序 + OO 雙介面
效能略低(微乎其微)略高
推薦場景多資料庫、現代框架、可移植性純 MySQL 高併發、舊專案維護

安全清單

  1. **永不**拼接 SQL 字串,一律 prepare() + 參數綁定。
  2. 密碼使用 password_hash() / password_verify(),禁用 MD5/SHA1。
  3. 資料庫帳號最小權限:僅 SELECT/INSERT/UPDATE/DELETE,無 DROP/ALTER。
  4. 錯誤訊息**不回傳前端**,記錄至日誌,前端僅顯示通用提示。
  5. 啟用 PDO::ATTR_EMULATE_PREPARES = false 強制真實預處理,防止邊界注入。
copyright © 萬盛學電腦網 all rights reserved