Manuel PHP
Précédent |  | Suivant

# pg_send_query_params

(PHP 5 >= 5.1.0RC1)

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

## Description

bool pg_send_query_params ( resource 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 paramétrisée. 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, `FALSE` en cas d'échec.

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

## Voir aussi

pg_send_query()

Précédent | Sommaire | Suivant
pg_send_prepare | Niveau supérieur | pg_send_query