pg_send_query_params
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
pg_send_query_params — Envia um comando e parâmetros separados para o servidor sem esperar pelo(s) resultado(s)
Descrição
Envia um comando e parâmetros separados ao servidor sem esperar pelo(s) resultado(s).
Isto é equivalente a pg_send_query() exceto que os parâmetros de
consulta podem ser especificados separadamente da string
query. Os parâmetros da função são
tratados de forma idêntica a pg_query_params(). Assim como
pg_query_params(), ele não funcionará em conexões PostgreSQL
anteriores à versão 7.4 e permite apenas um comando na string de consulta.
Parâmetros
connection-
Uma instância de PgSql\Connection.
query-
A instrução SQL parametrizada. Deve conter apenas uma única instrução. (múltiplas instruções separadas por ponto e vírgula não são permitidas.) Se algum parâmetro for usado, ele será chamado de $1, $2, etc.
params-
Um array de valores de parâmetros para substituir os espaços reservados $1, $2, etc. na string de consulta preparada original. O número de elementos no array deve corresponder ao número de espaços reservados.
Valor Retornado
Retorna true em caso de sucesso, false ou 0 em caso de falha. Use pg_get_result()
para determinar o resultado da consulta.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.1.0 |
O parâmetro connection agora espera uma instância de PgSql\Connection;
anteriormente, um resource era esperado.
|
Exemplos
Example #1 Usando pg_send_query_params()
<?php
$dbconn = pg_connect("dbname=publisher") or die("Não foi possível conectar");
// Usando parâmetros. Observe que não é necessário citar ou escapar
// o parâmetro.
pg_send_query_params($dbconn, 'select count(*) from authors where city = $1', array('Perth'));
// Compara com o uso básico de pg_send_query
$str = pg_escape_string('Perth');
pg_send_query($dbconn, "select count(*) from authors where city = '{$str}'");
?>