pg_send_query

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_send_query — 发送异步查询

    说明

    pg_send_query(PgSql\Connection$connection, string$query): int|bool

    pg_send_query() 向 connection 发送异步查询。跟 pg_query() 不同，它可以一次性向 PostgreSQL 发送多个查询并用 pg_get_result() 依次得到结果。

    当执行查询时不会阻塞脚本执行。用 pg_connection_busy() 来检查连接是否繁忙（即查询正在执行中）。可以使用 pg_cancel_query() 取消查询。

    尽管用户可以同时发送多个查询，但连接繁忙的情况下无法发送多个查询。如果连接繁忙时发送了查询，则会等待上一个查询结束，并且丢弃上个查询的所有结果。

    参数

    connection

    PgSql\Connection 实例。

    query

    要执行的 SQL 语句或者语句集合。

    应该正确转义查询中的数据。

    返回值

    成功时返回 true，失败时返回 false 或 0。使用 pg_get_result() 来确定查询结果。

    更新日志

    版本说明
    8.1.0 现在 connection 参数接受 PgSql\Connection 实例，之前接受 resource。

    示例

    示例 #1 pg_send_query() 示例

    <?php
    $dbconn     = pg_connect("dbname=publisher") or die("Could not connect");

    if (!    pg_connection_busy($dbconn)) {
    pg_send_query($dbconn, "select * from authors; select count(*) from authors;");
    }

    $res1 = pg_get_result($dbconn);
    echo     "First call to pg_get_result(): $res1\n";
    $rows1 = pg_num_rows($res1);
    echo     "$res1 has $rows1 records\n\n";

    $res2 = pg_get_result($dbconn);
    echo     "Second call to pg_get_result(): $res2\n";
    $rows2 = pg_num_rows($res2);
    echo     "$res2 has $rows2 records\n";
    ?>

    以上示例会输出：

    First call to pg_get_result(): Resource id #3 Resource id #3 has 3 records Second call to pg_get_result(): Resource id #4 Resource id #4 has 1 records

    参见

    To Top