PHP 8.5.0 Beta 2 available for testing

pg_send_query_params

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

pg_send_query_paramsSubmits a command and separate parameters to the server without waiting for the result(s)

Description

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

Submits a command and separate parameters to the server without waiting for the result(s).

This is equivalent to pg_send_query() except that query parameters can be specified separately from the query string. The function's parameters are handled identically to pg_query_params() . Like pg_query_params() , it will not work on pre-7.4 PostgreSQL connections, and it allows only one command in the query string.

Parameters

connection

An PgSql\Connection instance.

query

The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as 1,ドル 2,ドル etc.

params

An array of parameter values to substitute for the 1,ドル 2,ドル etc. placeholders in the original prepared query string. The number of elements in the array must match the number of placeholders.

Return Values

Returns true on success, false or 0 on failure. Use pg_get_result() to determine the query result.

Changelog

Version Description
8.1.0 The connection parameter expects an PgSql\Connection instance now; previously, a resource was expected.

Examples

Example #1 Using pg_send_query_params()

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

// Using parameters. Note that it is not necessary to quote or escape
// the parameter.
pg_send_query_params($dbconn, 'select count(*) from authors where city = 1ドル', array('Perth'));

// Compare against basic pg_send_query usage
$str = pg_escape_string('Perth');
pg_send_query($dbconn, "select count(*) from authors where city = '{$str}'");
?>

See Also

Found A Problem?

Learn How To Improve This PageSubmit a Pull RequestReport a Bug
+add a note

User Contributed Notes

There are no user contributed notes for this page.

AltStyle によって変換されたページ (->オリジナル) /