pg_query_params
(PHP 5 >= 5.1.0)
pg_query_params — Envoie une commande au serveur et attend le r�sultat, avec les capacit�s de passer des param�tres s�par�ment de la commande texte SQL
Description
Envoie une commande au serveur et attend le r�sultat, avec les capacit�s de passer des param�tres s�par�ment de la commande texte SQL.
pg_query_params() est comme pg_query(), mais offre des fonctionnalit�s additionnelles : les valeurs des param�tres peuvent �tre sp�cifi�es s�par�ment de la ligne de commande propre. pg_query_params() est support�e seulement avec les versions PostgreSQL 7.4 ou plus r�centes; la commande �chouera si vous l'utilisez avec des versions ant�rieures.
Si des param�tres sont utilis�s, ils sont r�f�r�s � $1, $2, etc. dans query . params sp�cifie les valeurs actuelles des param�tres. Une valeur NULL dans ce tableau signifie que le param�tre correspondant est SQL NULL.
Le principal avantage de pg_query_params() sur pg_query() est que les valeurs des param�tres peuvent �tre s�par�es de la requ�te query , par cons�quent, on invite les �chappements de caract�res ennuyeux et source d'erreurs. Contrairement � pg_query(), pg_query_params() permet seulement une seule commande SQL dans la cha�ne donn�e. (Il peut y avoir des points-virgules � l'int�rieur mais pas plus d'une seule commande.)
Liste de param�tres
- connection
-
La ressource de connexion de la base de donn�es PostgreSQL. Lorsque connection n'est pas pr�sent, la connexion par d�faut est utilis�e. La connexion par d�faut est la derni�re connexion faite par pg_connect() ou pg_pconnect().
- 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
Une ressource de r�sultats en cas de succ�s ou FALSE en cas d'�chec.
Exemples
Exemple #1 Exemple avec pg_query_params()
<?php
// Connexion � une base de donn�es nomm�e "marie"
$dbconn = pg_connect("dbname=marie");
// Cherche tous les magasins nomm�s Joe's Widgets. Notez qu'il n'est pas
// n�cessaire d'�chapper la cha�ne "Joe's Widgets"
$result = pg_query_params($dbconn, 'SELECT * FROM magasins WHERE nom = $1', array("Joe's Widgets"));
// Compare en utilisant pg_query
$str = pg_escape_string("Joe's Widgets");
$result = pg_query($dbconn, "SELECT * FROM magasins WHERE nom = '{$str}'");
?>
Suivez l'auteur
