怎樣用PDOStatement::fetch() 函數高效獲取單條查詢結果？步驟與示例解析

M66 2025-07-04

在使用PHP 操作數據庫時，PDO（PHP Data Objects）是一個強大且安全的數據庫訪問抽象層。 PDOStatement::fetch()方法則是從執行的查詢結果中獲取單條記錄的常用手段。本文將詳細講解如何高效利用fetch()函數獲取單條查詢結果，包含步驟和示例代碼，幫助你快速上手並避免常見坑。

1. 什麼是PDOStatement::fetch()

PDOStatement::fetch()是PDO 預處理語句執行後用於獲取結果集中的下一條記錄的方法。它返回一條記錄的數組或對象，取決於傳入的參數類型。每調用一次fetch() ，結果集游標就向下移動一條記錄。

2. 使用步驟

步驟一：連接數據庫

首先需要通過PDO 創建數據庫連接實例。

 <?php
$dsn = 'mysql:host=m66.net;dbname=testdb;charset=utf8mb4';
$username = 'your_username';
$password = 'your_password';

try {
    $pdo = new PDO($dsn, $username, $password);
    // 設置錯誤模式為異常
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("數據庫連接失敗：" . $e->getMessage());
}
?>

步驟二：準備並執行查詢

使用預處理語句準備SQL 並執行。

 <?php
$sql = "SELECT id, name, email FROM users WHERE id = :id";
$stmt = $pdo->prepare($sql);
$stmt->execute(['id' => 1]);
?>

步驟三：調用fetch() 獲取單條結果

使用fetch()獲取單條數據。常用的返回類型有：

PDO::FETCH_ASSOC ：返回關聯數組
PDO::FETCH_OBJ ：返回對象

示例：

 <?php
// 獲取關聯數組
$row = $stmt->fetch(PDO::FETCH_ASSOC);

if ($row) {
    echo "用戶ID: " . $row['id'] . "\n";
    echo "用戶名: " . $row['name'] . "\n";
    echo "郵箱: " . $row['email'] . "\n";
} else {
    echo "未找到對應記錄。";
}
?>

3. 性能及高效使用建議

只獲取單條結果： fetch()只返回一條數據，適合主鍵查詢或只需一條結果的場景，避免使用fetchAll()造成資源浪費。
綁定參數：使用預處理語句並綁定參數防止SQL 注入，且可提升執行效率。
選擇合適的提取方式：一般推薦使用PDO::FETCH_ASSOC ，節省內存且便於訪問字段名。

4. 完整示例

<?php
$dsn = 'mysql:host=m66.net;dbname=testdb;charset=utf8mb4';
$username = 'your_username';
$password = 'your_password';

try {
    $pdo = new PDO($dsn, $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    $sql = "SELECT id, name, email FROM users WHERE id = :id";
    $stmt = $pdo->prepare($sql);
    $stmt->execute(['id' => 1]);

    $user = $stmt->fetch(PDO::FETCH_ASSOC);

    if ($user) {
        echo "用戶ID: " . $user['id'] . "\n";
        echo "用戶名: " . $user['name'] . "\n";
        echo "郵箱: " . $user['email'] . "\n";
    } else {
        echo "未找到对应用戶。";
    }
} catch (PDOException $e) {
    echo "錯誤: " . $e->getMessage();
}
?>

相關標籤:
PDOStatement