萬盛學電腦網

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

PHP 獲取自增 ID 完全指南:mysql_insert_id、LAST_INSERT_ID 與 PDO lastInsertId 實戰

自增 ID 獲取:寫入後立即知曉主鍵值

資料庫插入自增主鍵記錄後,立即獲取生成的 ID 是關聯寫入(如訂單-明細、用戶-資料)的關鍵步驟。本文對比三種主流方案的適用場景、陷阱與最佳實踐。

方案一:mysqli_insert_id() / $mysqli->insert_id

過程式風格

<?php
$mysqli = new mysqli("localhost", "user", "pass", "db");
$mysqli->query("INSERT INTO users (name) VALUES ('John')");
$id = $mysqli->insert_id;  // 或 mysqli_insert_id($mysqli)
echo "新用戶 ID: $id";
?>

面向對象風格

<?php
$mysqli = new mysqli("localhost", "user", "pass", "db");
$stmt = $mysqli->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->bind_param("ss", $name, $email);
$stmt->execute();
$id = $stmt->insert_id;  // 也可用 $mysqli->insert_id
?>

方案二:PDO::lastInsertId()

標準用法

<?php
$pdo = new PDO("mysql:host=localhost;dbname=app", "user", "pass");
$pdo->exec("INSERT INTO users (name) VALUES ('Jane')");
$id = $pdo->lastInsertId();  // 返回字串型別
echo "ID: $id";
?>

指定序列名(PostgreSQL、Oracle)

<?php
// PostgreSQL 需指定 sequence 名稱
$id = $pdo->lastInsertId('users_id_seq');

// MySQL 通常無需參數
$id = $pdo->lastInsertId();
?>

方案三:SQL 函數 LAST_INSERT_ID()

直接 SQL 查詢

<?php
$mysqli->query("INSERT INTO users (name) VALUES ('Bob')");
$result = $mysqli->query("SELECT LAST_INSERT_ID()");
$row = $result->fetch_row();
$id = $row[0];
?>

關鍵特性:連線級隔離

  • 會話隔離:LAST_INSERT_ID() 僅返回當前連線最後一次成功 INSERT 生成的 ID
  • 併發安全:其他連線的插入不影響本連線返回值
  • 不受事務影響:即使事務回滾,ID 值也不會回退(自增計數器單調遞增)

三大方案深度對比

維度mysqli_insert_idPDO::lastInsertIdLAST_INSERT_ID()
API 風格函數/屬性方法SQL 函數
返回型別intstring (大數字安全)string/int
BigInt 支援⚠️ 32位系統可能溢出✅ 字串無溢出✅
多重插入返回第一筆 ID返回第一筆 ID返回第一筆 ID
事務回滾後返回插入時 ID返回插入時 ID返回插入時 ID
無 INSERT 時000
推薦場景mysqli 原生項目現代 PHP、跨資料庫存儲過程、複雜 SQL

關鍵陷阱與避坑指南

1. 多行插入只返回第一個 ID

<?php
$pdo->exec("INSERT INTO logs (msg) VALUES ('a'), ('b'), ('c')");
$id = $pdo->lastInsertId();  // 返回 'a' 的 ID
// 'b' 和 'c' 的 ID 需自行計算:$id+1, $id+2 (假設連續)
?>

2. ON DUPLICATE KEY UPDATE 行為差異

<?php
// MySQL: INSERT ... ON DUPLICATE KEY UPDATE
// 若觸發 UPDATE,LAST_INSERT_ID() 返回 0 (除非指定 LAST_INSERT_ID(id))
$pdo->exec("INSERT INTO users (id, name) VALUES (1, 'A') ON DUPLICATE KEY UPDATE name='B'");
$id = $pdo->lastInsertId();  // 0!

// 正確做法:指定返回 ID
$pdo->exec("INSERT INTO users (id, name) VALUES (1, 'A') ON DUPLICATE KEY UPDATE name='B', id=LAST_INSERT_ID(id)");
$id = $pdo->lastInsertId();  // 返回 1
?>

3. BIGINT 主鍵在 32 位 PHP 環境溢出

<?php
// 32位 PHP 整數最大 2147483647
// BIGINT UNSIGNED 最大 18446744073709551615

// 解決:PDO 返回字串,直接使用
$idStr = $pdo->lastInsertId();  // "1234567890123456789"
// 轉換為 GMP/BCMath 大數運算
$gmpId = gmp_init($idStr);
?>

4. 沒有自增主鍵的表

<?php
// UUID、雪花算法、業務鍵等無自增場景
// lastInsertId() 返回 0 或不可預測值
// 解決:插入前生成 ID,插入時显式指定
$id = Uuid::v4()->toString();
$pdo->prepare("INSERT INTO users (id, name) VALUES (?, ?)")->execute([$id, $name]);
// 直接使用 $id,無需查詢
?>

事務中獲取 ID 的正確姿勢

<?php
$pdo->beginTransaction();
try {
    $pdo->exec("INSERT INTO orders (user_id, total) VALUES (1, 100)");
    $orderId = $pdo->lastInsertId();  // 事務內也能獲取
    
    // 寫入明細
    $stmt = $pdo->prepare("INSERT INTO order_items (order_id, product_id, qty) VALUES (?, ?, ?)");
    foreach ($items as $item) {
        $stmt->execute([$orderId, $item['product_id'], $item['qty']]);
    }
    
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    throw $e;
}
?>

現代最佳實踐封裝

<?php
trait HasAutoIncrementId {
    protected ?int $id = null;
    
    public function getId(): ?int {
        return $this->id;
    }
    
    protected function setIdFromPdo(PDO $pdo): void {
        $this->id = (int)$pdo->lastInsertId();
    }
    
    protected function setIdFromMysqli(mysqli $mysqli): void {
        $this->id = $mysqli->insert_id;
    }
}

class UserRepository {
    private PDO $pdo;
    
    public function create(User $user): User {
        $this->pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)")
            ->execute([$user->name, $user->email]);
        $user->setIdFromPdo($this->pdo);
        return $user;
    }
}
?>

總結

  • mysqli:用 $mysqli->insert_id 或 mysqli_insert_id($conn)
  • PDO:用 $pdo->lastInsertId(),**返回字串安全處理 BIGINT**
  • SQL:SELECT LAST_INSERT_ID() 適用存儲過程、複雜邏輯
  • 核心原則:同一連線、緊跟 INSERT、事務中也有效、併發隔離
  • 避坑:多行插入只取第一個、ON DUPLICATE KEY 需显式指定、無自增主鍵不可用
copyright © 萬盛學電腦網 all rights reserved