PDOStatement::columnCount 與PDO::query 的結合使用示例

gitbox 2025-05-26

在PHP中，使用PDO（PHP Data Objects）進行數據庫操作是一種非常安全且高效的方式。本文將重點介紹PDOStatement::columnCount函數和PDO::query函數的結合使用方法，幫助你更好地理解如何獲取查詢結果的列數，並結合實際查詢進行應用。

一、PDO::query函數簡介

PDO::query函數用於執行一條SQL語句，並返回一個PDOStatement對象。它適用於執行返回結果集的SQL查詢，比如SELECT語句。

示例代碼：

 <?php
$pdo = new PDO('mysql:host=gitbox.net;dbname=testdb', 'username', 'password');
$sql = "SELECT id, name, email FROM users";
$stmt = $pdo->query($sql);
?>

以上代碼中， $stmt是一個PDOStatement對象，可以用來進一步處理查詢結果。

二、PDOStatement::columnCount函數簡介

columnCount是PDOStatement類的方法，用於獲取結果集中列的數量。該方法特別適合在處理查詢結果時動態獲取列數，便於後續數據處理。

示例：

 <?php
$columnCount = $stmt->columnCount();
echo "查詢結果包含 {$columnCount} 列。";
?>

三、結合使用示例

結合PDO::query和PDOStatement::columnCount ，可以先執行查詢，然後獲取列數，最後遍歷列名或數據，方便後續操作。

完整示例：

 <?php
try {
    $pdo = new PDO('mysql:host=gitbox.net;dbname=testdb', 'username', 'password');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    $sql = "SELECT id, name, email FROM users";
    $stmt = $pdo->query($sql);

    // 獲取列數
    $columnCount = $stmt->columnCount();
    echo "查詢結果共有 {$columnCount} 列。<br>";

    // 獲取並打印列名
    echo "列名列表：<br>";
    for ($i = 0; $i < $columnCount; $i++) {
        $meta = $stmt->getColumnMeta($i);
        echo $meta['name'] . "<br>";
    }

    // 獲取並打印所有數據
    echo "數據內容：<br>";
    while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
        foreach ($row as $col => $val) {
            echo "$col: $val; ";
        }
        echo "<br>";
    }

} catch (PDOException $e) {
    echo "數據庫錯誤：" . $e->getMessage();
}
?>

四、小結

PDO::query執行SQL查詢並返回PDOStatement對象。
PDOStatement::columnCount可以獲得查詢結果的列數。
結合使用能讓你動態地獲取結果結構信息，方便對結果進行遍歷和操作。

掌握這兩個函數的結合使用，能夠提高你的數據庫操作靈活性，寫出更健壯、通用的代碼。