如何使用PDOStatement::rowCount 檢查查詢影響的行數

gitbox 2025-05-28

在PHP 中，使用PDO (PHP Data Objects) 執行數據庫操作時，經常需要檢查一個查詢語句影響的行數，特別是在執行更新、刪除或者插入操作時。 PDO 提供了一個非常有用的函數PDOStatement::rowCount() ，它可以幫助開發者獲取最近一條SQL 語句操作影響的行數。本文將詳細講解如何使用PDOStatement::rowCount()來檢查數據庫查詢操作影響的行數。

1. PDOStatement::rowCount 的作用

PDOStatement::rowCount()函數返回最近一次數據庫操作影響的行數。它通常用於如下操作：

執行INSERT 、 UPDATE或DELETE語句時，檢查操作影響的記錄數。
用於確定某個數據庫操作是否成功，比如更新了多少行數據或刪除了多少記錄。

2. 使用rowCount進行查詢操作

PDOStatement::rowCount()主要用於查詢執行後影響的行數。我們通過以下示例代碼來演示如何使用它。

3. 示例代碼

假設我們有一個簡單的數據庫操作，使用PDO來執行一個UPDATE語句並獲取更新的行數。

 <?php
// 連接到數據庫
$dsn = 'mysql:host=localhost;dbname=testdb';
$username = 'root';
$password = '';
$options = array(
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
);

try {
    $pdo = new PDO($dsn, $username, $password, $options);
    echo "連接成功！<br>";

    // 更新語句
    $sql = "UPDATE users SET status = 'active' WHERE age > 30";
    $stmt = $pdo->prepare($sql);

    // 執行更新操作
    $stmt->execute();

    // 獲取影響的行數
    $rowCount = $stmt->rowCount();
    echo "影響的行數: " . $rowCount;
} catch (PDOException $e) {
    echo "數據庫連接失敗: " . $e->getMessage();
}
?>

在這個示例中：

我們首先連接到數據庫。
使用UPDATE語句更新users表中age > 30的記錄。
執行更新語句後，調用rowCount()來獲取實際被更新的行數。
最後輸出影響的行數。

如果執行成功， rowCount()會返回更新操作影響的記錄數。

4. 需要注意的事項

對於SELECT查詢， rowCount()返回的是數據庫受影響的行數。然而，MySQL 數據庫對於SELECT語句並不一定支持此功能，它通常返回0 或者NULL。因此，只有在執行INSERT 、 UPDATE 、 DELETE等操作時， rowCount()才能準確返回影響的行數。
對於一些數據庫管理系統，如PostgreSQL， rowCount()在執行SELECT查詢時會返回實際檢索到的行數。

5. 使用rowCount()進行刪除操作

同樣地，你可以使用rowCount()來檢查刪除操作的影響行數。例如：

 <?php
// 刪除用戶狀態為 'inactive' 的記錄
$sql = "DELETE FROM users WHERE status = 'inactive'";
$stmt = $pdo->prepare($sql);

// 執行刪除操作
$stmt->execute();

// 獲取刪除的行數
$rowCount = $stmt->rowCount();
echo "刪除的行數: " . $rowCount;
?>

在這個例子中， rowCount()會返回被刪除的記錄數量。如果沒有記錄符合條件，則返回0 。

6. 結語

PDOStatement::rowCount()是一個非常有用的函數，可以幫助開發者在執行SQL 語句後輕鬆獲取影響的行數。這對於執行更新、刪除等操作後，了解操作效果、處理業務邏輯非常重要。通過合理利用這個函數，可以更有效地進行數據庫操作並增強代碼的可讀性與可靠性。

如果你希望深入了解PDO 的其他功能，可以訪問相關文檔或教程，參考更多實際的案例和最佳實踐。