fetchColumn()

1. 定义

该方法从结果集的下一行获取指定列值。 如果结果集不存在或者没有更多值或者传入的列号不存在，将返回 FALSE。

2. 语法

PDOStatement::fetchColumn ([ int $column_number = 0 ] ) : string

3. 参数说明

4. 示例

<?php

// PDOStatement::fetchColumn()
// 从结果集的下一行获取指定列值

try {
    $config = ['driver' => 'mysql', 'host' => 'localhost', 'dbname' => 'test', 'charset' => 'utf8', 'user' => 'root', 'pwd' => 'mysql'];
    $dsn = sprintf('%s:host=%s;dbname=%s;charset=%s', $config['driver'], $config['host'], $config['dbname'], $config['charset']);
    $conn = new PDO($dsn, $config['user'], $config['pwd']);
} catch (PDOException $e) {
    error_log($e->getMessage());
    echo $e->getMessage();
}

try {
    $sql = 'SELECT `name`,`rate`,`cover`,`url` FROM `movie` WHERE `id` > 15 ORDER BY `id`';
    $stmt = $conn->prepare($sql);

    $stmt->execute();
    $res = $stmt->fetchColumn();// 获取下一行的第一列的列值：这里是 name
    var_dump($res);// 输出：string(12) "头号玩家"

    $res = $stmt->fetchColumn(0);// 获取下一行的第一列的列值：这里是 name
    var_dump($res);// 输出：string(12) "无名之辈"

    $res = $stmt->fetchColumn(2);// 获取下一行的第三列的列值：这里是 url
    var_dump($res);// 输出：string(73) "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p513344864.jpg"

    $stmt->fetchAll();// 此时结果集为空

    $res = $stmt->fetchColumn(20);// 获取下一行的第二十列的列值：这里不存在，Warning: PDOStatement::fetchColumn(): SQLSTATE[HY000]: General error: Invalid column index
    var_dump($res);// 输出：bool(false)
} catch (Exception $e) {
    echo "发生了错误：", $e->getMessage();
}

5. 延展阅读

• PDO::query()：执行一条 SQL 语句，并返回一个PDOStatement对象形式的结果集
• PDOStatement::fetch()：从PDOStatement结果集中获取下一行
• PDOStatement::fetchAll()：返回结果集中剩余的所有行
• PDO::prepare()：对待执行的 SQL 语句进行预处理，并返回该 SQL 语句的语句对象PDOStatement
• PDOStatement::setFetchMode()：为 PDO 语句设置默认的获取结果集模式