pg_send_query_params
(PHP 5 >= 5.1.0)
pg_send_query_params — Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s)
Description
$connection
, string $query
, array $params
)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 fonctions 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 -
Ressource de connexion de base de données PostgreSQL.
-
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
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Utilisez pg_get_result() pour déterminer le résultat de la requête.
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}'");
?>