ConFoo 2025

pg_send_query_params

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

pg_send_query_paramsEnvia um comando e parâmetros separados para o servidor sem esperar pelo(s) resultado(s)

Descrição

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

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

Exemplo #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}'");
?>

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top