哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

PDO::query

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDO::query 执行 SQL 语句,以 PDOStatement 对象形式返回结果集

说明

public PDO::query(string $statement): PDOStatement
public PDO::query(string $statement, int $PDO::FETCH_COLUMN, int $colno): PDOStatement
public PDO::query(
    string $statement,
    int $PDO::FETCH_CLASS,
    string $classname,
    array $ctorargs
): PDOStatement
public PDO::query(string $statement, int $PDO::FETCH_INTO, object $object): PDOStatement

PDO::query() 在单次函数调用内执行 SQL 语句,以 PDOStatement 对象形式返回结果集(如果有数据的话)。

如果反复调用同一个查询,用 PDO::prepare() 准备 PDOStatement 对象,并用 PDOStatement::execute() 执行语句,将具有更好的性能。

如果没有完整获取结果集内的数据,就调用下一个 PDO::query(),将可能调用失败。 应当在执行下一个 PDO::query() 前,先用 PDOStatement::closeCursor() 释放数据库PDOStatement 关联的资源。

注意:

如果传入函数的参数数量超过一个,多余的参数将相当于调用结果对象 PDOStatement::setFetchMode() 方法。

参数

statement

需要准备、执行的 SQL 语句。

查询里的数据应该用恰当的形式转义

返回值

PDO::query() 返回 PDOStatement 对象,或在失败时返回 false

范例

示例 #1 展示 PDO::query 的使用

PDO::query() 一个不错的功能是:执行 SELECT 语句,并能够循环遍历结果集。

<?php
function getFruit($conn) {
    
$sql 'SELECT name, color, calories FROM fruit ORDER BY name';
    foreach (
$conn->query($sql) as $row) {
        print 
$row['name'] . "\t";
        print 
$row['color'] . "\t";
        print 
$row['calories'] . "\n";
    }
}
?>

以上例程会输出:

apple   red     150
banana  yellow  250
kiwi    brown   75
lemon   yellow  25
orange  orange  300
pear    green   150
watermelon      pink    90

参见

打开 哈希空间 微信小程序中查看更佳