PHP PDOStatement::fetchColumn 怎样读取单列结果

读取下一行的单个字段，用 $stmt->fetchColumn(0)；参数是从零开始的列位置，省略即取第一列。无更多行时返回 false，判断时应使用严格比较，不能让合法的零值、空串或 NULL 被误当成结束。如果列本身可能返回布尔 false，应改用整行读取来区分“有行”和“字段值”。

官方手册：https://www.php.net/manual/en/pdostatement.fetchcolumn.php。

先把基线定为一行一个值

假设结果有四行，目标字段依次为文本零、空字符串、NULL 和普通文本。任务的正确性指标是完整读到四个值，而不是只显示最后一个非空值。这里的四行是本文构造的输入，不是生产数据，也不是性能实测。

一次 fetchColumn 只取下一行中的一个字段；要得到全部单列结果，需要继续读取。同一个 statement 连续调用两次，并不是从第一行先读列零再读列一。若需要同一行多个字段，就应一次取得整行。

列位置与查询字段顺序必须对应

列索引对应 SELECT 结果列顺序，不对应数据库表定义中的字段位置。查询只有一列时使用零；查询 SELECT id, label ... 时，label 位于索引一。不要把数据库主键值作为索引传进去，也不要把字段名称字符串当作参数。

为减少这类隐性依赖，单列任务尽量明确 SELECT 目标字段，避免 SELECT *。这首先是输入输出契约的收紧，不表示仅替换 PHP 取值方法就必然降低数据库扫描成本。

用严格比较写一个可复现示例

下面代码面向装有 PDO_SQLITE 的 PHP 环境，使用独立内存数据库，不需要账户密码。它构造四个文本或空值，读取时保留值本身，再关闭游标。本文不执行该示例；后面的结果说明均为代码预期。

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$db->exec('CREATE TABLE samples (id INTEGER PRIMARY KEY, label TEXT)');
$insert = $db->prepare('INSERT INTO samples (id, label) VALUES (?, ?)');
foreach ([[1, '0'], [2, ''], [3, null], [4, 'ready']] as $item) {
    $insert->execute($item);
}

$stmt = $db->query('SELECT label FROM samples ORDER BY id');
$values = [];
try {
    // 只用严格 false 判断耗尽，保留空串、NULL 和文本零
    while (($value = $stmt->fetchColumn(0)) !== false) {
        $values[] = $value;
    }
} finally {
    // 即使消费代码抛错，也结束当前结果集的使用
    $stmt->closeCursor();
}
var_export($values);

预期数组包含四项，顺序为 '0'、''、NULL、'ready'。SQL 错误不是“没匹配到记录”，示例采用异常模式，将错误处理与正常耗尽分开。跨驱动使用时还应明确业务字段的 PHP 类型契约，不要根据一次输出假定所有驱动都返回相同数值类型。

如何比较写法，而不是猜测更快

若要比较 fetchColumn 与 fetch(PDO::FETCH_NUM) 后取索引零，应使用相同 SQL、数据量、驱动、连接配置和消费动作，每轮重新执行查询。两种方法不能先后消耗同一个尚未重置的游标，否则读到的数据已经不同。

建议分别记录：成功消费的值数、总耗时、单次耗时分布和进程峰值内存。计时范围要明确是否包含 execute；峰值内存适合放在独立进程比较，避免前一轮分配影响后一轮。先用上述小样本确认四项都保留，再在隔离测试环境扩大数据量。本文没有执行压测，因此不给出毫秒数、吞吐量或提速百分比。

fetchColumn 的直接收益是调用方只接收单值，不必自己从行数组取字段；能否带来可观性能差异，仍取决于查询、网络、驱动缓冲和消费逻辑，不能由 API 名字推出。

返回值对照：零不是未命中

布尔列、多列和未命中的边界

当业务必须区分字段 false 和无行时，改为 fetch(PDO::FETCH_ASSOC)：行数组本身表示有记录，数组里的值再按业务解释。官方整行读取参考：https://www.php.net/manual/en/pdostatement.fetch.php。

prepare('SELECT enabled FROM accounts WHERE id = :id');
$stmt->execute(['id' => 42]);
try {
    $row = $stmt->fetch(PDO::FETCH_ASSOC);
    if ($row === false) {
        echo '没有匹配记录';
    } else {
        // 原样保留字段；是否转换类型由具体驱动和业务约定决定
        $enabled = $row['enabled'];
    }
} finally {
    $stmt->closeCursor();
}

为什么空表上的 COUNT(*) 可能得到零而不是 false？无 GROUP BY 的聚合计数与普通筛选查询的结果形状不同，零是计数值，不是没有下一行的标志。为什么第二次 fetchColumn 没有取到第一行的另一个字段？因为它读取下一行。参数越界该怎么办？先修正查询列契约，不把错误当作未命中，也不要依赖某一驱动的偶然表现。

实用选择很简单：下一行只要一个非布尔值时用 fetchColumn；同一行需要多个字段，或需要把行存在性与布尔值分开时，用 fetch。正确性先由返回值契约保证，性能结论再由同条件测量支持。