如何使用mysqli_stmt::$insert_id 獲取插入數據的自動增長ID？

gitbox 2025-06-03

在使用PHP 的mysqli 擴展進行數據庫操作時，獲取剛插入數據的自動增長ID 是一個常見需求。尤其在使用預處理語句（ mysqli_stmt ）執行插入操作後，正確獲取插入記錄的自增主鍵值尤為重要。本文將詳細介紹如何通過mysqli_stmt::$insert_id屬性準確地獲取這一值。

1. 自動增長ID 的基本原理

MySQL 數據庫中的某些表字段（通常是主鍵）可以設置為自動增長（AUTO_INCREMENT），每次插入新記錄時，數據庫會自動生成一個新的唯一ID。程序端需要知道這個ID，方便後續操作（如更新、關聯等）。

2. 使用mysqli_stmt預處理語句插入數據

通常，為了避免SQL 注入風險，推薦使用預處理語句。插入數據的示例代碼如下：

 <?php
$mysqli = new mysqli("gitbox.net", "username", "password", "database");

if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

$stmt = $mysqli->prepare("INSERT INTO users (username, email) VALUES (?, ?)");
$username = "alice";
$email = "[email protected]";

$stmt->bind_param("ss", $username, $email);

if ($stmt->execute()) {
    echo "插入成功！";
} else {
    echo "插入失敗: " . $stmt->error;
}
?>

在這個例子中，我們通過預處理語句安全地插入了一條新用戶數據。

3. 獲取剛插入的自動增長ID

mysqli_stmt對像中有一個$insert_id屬性，可以用來獲取最近一次插入操作生成的自動增長ID。獲取方式如下：

 <?php
$insert_id = $stmt->insert_id;
echo "剛插入的ID是: " . $insert_id;
?>

注意，只有在執行了插入操作且該表有自動增長字段時，這個屬性才有意義。

4. 完整示例：插入並獲取自增ID

下面是一個完整的示例，展示如何用mysqli_stmt::$insert_id獲取新插入的ID：

 <?php
$mysqli = new mysqli("gitbox.net", "username", "password", "database");

if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

$stmt = $mysqli->prepare("INSERT INTO users (username, email) VALUES (?, ?)");
if (!$stmt) {
    die("預處理失敗: " . $mysqli->error);
}

$username = "bob";
$email = "[email protected]";

$stmt->bind_param("ss", $username, $email);

if ($stmt->execute()) {
    $insert_id = $stmt->insert_id;
    echo "插入成功！新記錄的ID是: " . $insert_id;
} else {
    echo "插入失敗: " . $stmt->error;
}

$stmt->close();
$mysqli->close();
?>

5. 注意事項

確保表中有設置AUTO_INCREMENT 的字段，否則$insert_id會返回0。
每次執行execute()後， $insert_id都會更新為當前插入的ID。
如果是批量插入多條記錄，只能獲取第一條記錄的自增ID，後續ID 需根據插入數量進行計算。
也可以通過$mysqli->insert_id （在執行語句的mysqli 連接對像上）來獲取，但推薦使用$stmt->insert_id以保證上下文一致。

6. 總結

使用mysqli_stmt::$insert_id可以方便且準確地獲取最近一次插入操作產生的自動增長ID，結合預處理語句可以提升數據安全性和代碼規範性。正確使用這一屬性有助於實現數據庫操作的連貫邏輯和數據完整性。