array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pg-send-query-params.php', 1 => 'pg_send_query_params', 2 => 'Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s)', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'pg_cancel_query', ), 'prev' => array ( 0 => 'function.pg-send-query.php', 1 => 'pg_send_query', ), 'next' => array ( 0 => 'function.pg-set-chunked-rows-size.php', 1 => 'pg_set_chunked_rows_size', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/pgsql/functions/pg-send-query-params.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_send_query_params

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

pg_send_query_params — Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s)

Description

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

Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s).

Cette fonction est équivalente à pg_send_query() à l'exception que les paramètres de la requête peuvent être spécifiés séparément de la chaîne de requête query. Les paramètres de la fonction sont gérés de la même manière que pg_execute(). Comme pg_execute(), la fonction ne fonctionnera pas sur les versions antérieures à PostgreSQL 7.4 et elle n'autorise qu'une seule commande par requête.

Liste de paramètres

connection

Une instance PgSql\Connection.

query

La requête SQL avec ses paramètres. Elle doit contenir seulement une seule requête. Plusieurs requêtes séparées par des points-virgules ne sont pas autorisées. Si des paramètres sont utilisés, ils sont référés à $1, $2, etc.

params

Un tableau de valeurs de paramètres pour substituer les variables $1, $2, etc. dans la requête préparée originale. Le nombre d'éléments présents dans le tableau doit concorder avec le nombre de variables à remplacer.

Valeurs de retour

Retourne true en cas de succès, false ou 0 en cas d'échec. Utiliser pg_get_result() pour déterminer le résultat de la requête.

Historique

Version Description
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

Exemples

Exemple #1 Exemple avec pg_send_query_params()

<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");

// Avec les paramètres. Notez qu'il n'est pas nécessaire d'échapper la
// chaîne du paramètre.
pg_send_query_params($dbconn, 'select count(*) from auteurs where ville = $1', array('Perth'));

// Compare avec l'utilisation basique de pg_send_query
$str = pg_escape_string('Perth');
pg_send_query($dbconn, "select count(*) from auteurs where ville = '{$str}'");
?>

Voir aussi