資料庫插入自增主鍵記錄後,立即獲取生成的 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
?>
<?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";
?>
<?php
// PostgreSQL 需指定 sequence 名稱
$id = $pdo->lastInsertId('users_id_seq');
// MySQL 通常無需參數
$id = $pdo->lastInsertId();
?>
<?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| 維度 | mysqli_insert_id | PDO::lastInsertId | LAST_INSERT_ID() |
|---|---|---|---|
| API 風格 | 函數/屬性 | 方法 | SQL 函數 |
| 返回型別 | int | string (大數字安全) | string/int |
| BigInt 支援 | ⚠️ 32位系統可能溢出 | ✅ 字串無溢出 | ✅ |
| 多重插入 | 返回第一筆 ID | 返回第一筆 ID | 返回第一筆 ID |
| 事務回滾後 | 返回插入時 ID | 返回插入時 ID | 返回插入時 ID |
| 無 INSERT 時 | 0 | 0 | 0 |
| 推薦場景 | mysqli 原生項目 | 現代 PHP、跨資料庫 | 存儲過程、複雜 SQL |
<?php
$pdo->exec("INSERT INTO logs (msg) VALUES ('a'), ('b'), ('c')");
$id = $pdo->lastInsertId(); // 返回 'a' 的 ID
// 'b' 和 'c' 的 ID 需自行計算:$id+1, $id+2 (假設連續)
?>
<?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
?>
<?php
// 32位 PHP 整數最大 2147483647
// BIGINT UNSIGNED 最大 18446744073709551615
// 解決:PDO 返回字串,直接使用
$idStr = $pdo->lastInsertId(); // "1234567890123456789"
// 轉換為 GMP/BCMath 大數運算
$gmpId = gmp_init($idStr);
?>
<?php
// UUID、雪花算法、業務鍵等無自增場景
// lastInsertId() 返回 0 或不可預測值
// 解決:插入前生成 ID,插入時显式指定
$id = Uuid::v4()->toString();
$pdo->prepare("INSERT INTO users (id, name) VALUES (?, ?)")->execute([$id, $name]);
// 直接使用 $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->insert_id 或 mysqli_insert_id($conn)$pdo->lastInsertId(),**返回字串安全處理 BIGINT**SELECT LAST_INSERT_ID() 適用存儲過程、複雜邏輯