(PHP 5 >= 5.1.0RC1)pg_query_params -- Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text.
Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text.
pg_query_params() is like pg_query(), but offers additional functionality: parameter values can be specified separately from the command string proper. pg_query_params() is supported only against PostgreSQL 7.4 or higher connections; it will fail when using earlier versions.
If parameters are used, they are referred to in the
string as $1, $2, etc.
params specifies the actual values of the
parameters. A NULL value in this array means the corresponding parameter is SQL
The primary advantage of pg_query_params() over pg_query()
is that parameter values
may be separated from the
query string, thus avoiding the need for tedious
and error-prone quoting and escaping. Unlike pg_query(),
pg_query_params() allows at
most one SQL command in the given string. (There can be semicolons in it,
but not more than one nonempty command.)
The parameterised 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.
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.
Example 1. Using pg_query_params()