pg_send_query_params

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_send_query_params向服务器提交命令和单独的参数,而不等待结果

描述

pg_send_query_params(PgSql\Connection $connection, string $query, array $params): int|bool

向服务器提交命令和单独的参数,而不等待结果。

这等同于 pg_send_query(),只是查询参数可以与 query 字符串分开指定。函数的参数处理方式与 pg_query_params() 相同。像 pg_query_params() 一样,它在 7.4 之前的 PostgreSQL 连接上不起作用,并且只允许查询字符串中有一个命令。

参数

connection

一个 PgSql\Connection 实例。

query

参数化的 SQL 语句。必须只包含一个语句。(不允许用分号分隔的多个语句。)如果使用任何参数,则将它们引用为 $1、$2 等。

params

一个参数值数组,用于替换原始准备好的查询字符串中的 $1、$2 等占位符。数组中的元素数量必须与占位符的数量匹配。

返回值

成功时返回 true,失败时返回 false0。使用 pg_get_result() 确定查询结果。

变更日志

版本 描述
8.1.0 connection 参数现在期望一个 PgSql\Connection 实例;以前,期望一个 资源

示例

示例 #1 使用 pg_send_query_params()

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

// 使用参数。请注意,不需要引用或转义
// 参数。
pg_send_query_params($dbconn, 'select count(*) from authors where city = $1', array('Perth'));

// 与基本 pg_send_query 用法进行比较
$str = pg_escape_string('Perth');
pg_send_query($dbconn, "select count(*) from authors where city = '{$str}'");
?>

参见

添加说明

用户贡献的说明

此页面没有用户贡献的说明。
To Top