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可以获得查询结果的列数。
结合使用能让你动态地获取结果结构信息，方便对结果进行遍历和操作。

掌握这两个函数的结合使用，能够提高你的数据库操作灵活性，写出更健壮、通用的代码。