萬盛學電腦網

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

PHP 防止 MySQL 重複寫入:查詢先行再插入模式

PHP 防止 MySQL 重複寫入:查詢先行再插入模式

在處理使用者註冊、搜尋關鍵字記錄等場景時,常需避免相同資料重複寫入資料庫。本文示範經典的「先查詢再決定是否插入」模式,並指出其潛在競態條件與現代最佳實踐。

基本實作範例 (mysqli 版)

<?php
// 1. 建立連線 (建議使用 mysqli 或 PDO)
$mysqli = new mysqli('localhost', 'root', '1234', 'mydb');
if ($mysqli->connect_errno) {
    die('連線失敗: ' . $mysqli->connect_error);
}
$mysqli->set_charset('utf8mb4'); // 設定字元集,防止中文亂碼

// 2. 取得並過濾輸入
$username = $_GET['name'] ?? '';
$username = $mysqli->real_escape_string($username); // 簡易防注入,參數化查詢更佳

// 3. 查詢是否已存在
$sql = "SELECT 1 FROM usertable WHERE user_name = '$username' LIMIT 1";
$result = $mysqli->query($sql);

if ($result && $result->num_rows === 0) {
    // 4. 不存在 → 插入
    $insertSql = "INSERT INTO student (user_name) VALUES ('$username')";
    if ($mysqli->query($insertSql)) {
        echo '用戶註冊成功!';
    } else {
        echo '寫入失敗:' . $mysqli->error;
    }
} else {
    // 5. 已存在
    echo '該用戶名已存在,請重新選擇!';
}

$mysqli->close();
?>

關鍵步驟解析

  1. 連線與字元集:set_charset('utf8mb4') 解決中文亂碼,涵蓋 Emoji。
  2. 輸入過濾:real_escape_string() 針對字串逸出特殊字元;更推薦使用預處理語句。
  3. SELECT 1 ... LIMIT 1:只檢查存在性,不拉取完整資料,效能最佳。
  4. num_rows 判斷:0 表示不存在,可安全插入。

⚠️ 潛在問題:競態條件

在高併發下,兩個請求可能同時通過「查詢不存在」檢查,導致仍寫入重複資料。

現代最佳解決方案

方案一:資料庫層級唯一索引 (最根本、效能最好)

ALTER TABLE `student` ADD UNIQUE INDEX `uk_user_name` (`user_name`);

然後直接嘗試插入,捕捉重複鍵錯誤:

<?php
$stmt = $mysqli->prepare("INSERT INTO student (user_name) VALUES (?)");
$stmt->bind_param('s', $username);
if ($stmt->execute()) {
    echo '註冊成功';
} elseif ($mysqli->errno === 1062) { // 1062 = Duplicate entry
    echo '用戶名已存在';
} else {
    echo '錯誤:' . $mysqli->error;
}
?>

方案二:INSERT IGNORE / ON DUPLICATE KEY UPDATE

-- 忽略重複,不報錯也不更新
INSERT IGNORE INTO student (user_name) VALUES ('john');

-- 重複時更新某欄位 (如最後登入時間)
INSERT INTO student (user_name, last_login) VALUES ('john', NOW())
ON DUPLICATE KEY UPDATE last_login = NOW();

方案三:交易鎖定 (SELECT ... FOR UPDATE)

在交易中鎖定該記錄,但並發效能較差,通常不推薦用於單純防重複。

總結建議

  • 小型/低併發專案:查詢先行模式簡單易懂,可接受。
  • 生產環境/高併發:務必加唯一索引,改用 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE,或捕捉 1062 錯誤碼。
  • 棄用 mysql_* 函數:已於 PHP 7.0 移除,請改用 mysqli 或 PDO。
  • 永遠使用預處理語句:徹底防止 SQL 注入。
copyright © 萬盛學電腦網 all rights reserved