pg_query
(PHP 4 >= 4.2.0, PHP 5)
pg_query — Ex�cute une requ�te PostgreSQL
Description
pg_query() ex�cute la requ�te query sur la base de donn�es sp�cifi�e connection .
Si une erreur se produit et FALSE est retourn�, les d�tails de l'erreur peuvent �tre r�cup�r�s en utilisant la fonction pg_last_error() si la connexion est valide.
Note: Bien que connection puisse �tre omis, il n'est pas recommand� de le faire, car il peut se r�v�ler difficile de retrouver les bogues dans les scripts.
Note: Auparavant, cette fonction s'appelait pg_exec(). pg_exec() est toujours disponible pour des raisons de compatibilit�, mais les utilisateurs sont encourag�s � utiliser le nouveau nom.
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 ou les requ�tes SQL � �tre ex�cut�es. Lorsque plusieurs requ�tes sont pass�es � la fonction, elles sont automatiquement ex�cut�es comme �tant une transaction, � moins qu'il y aille les commandes BEGIN/COMMIT incluses dans la requ�te. Cependant, l'utilisation de transactions multiples dans un seul appel de fonction n'est pas recommand�e.
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()
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Une erreur s'est produite.\n";
exit;
}
$result = pg_query($conn, "SELECT auteur, email FROM auteurs");
if (!$result) {
echo "Une erreur s'est produite.\n";
exit;
}
while ($row = pg_fetch_row($result)) {
echo "Auteur: $row[0] E-mail: $row[1]";
echo "<br />\n";
}
?>
Exemple #2 Utilisation de pg_query() avec plusieurs requ�tes
<?php
$conn = pg_pconnect("dbname=publisher");
// ces requ�tes seront ex�cut�es en tant qu'une seule transaction
$query = "UPDATE authors SET author=UPPER(author) WHERE id=1;";
$query .= "UPDATE authors SET author=LOWER(author) WHERE id=2;";
$query .= "UPDATE authors SET author=NULL WHERE id=3;";
pg_query($conn, $query);
?>
Voir aussi
- pg_connect() - �tablit une connexion PostgreSQL
- pg_pconnect() - �tablit une connexion PostgreSQL persistante
- pg_fetch_array() - Lit une ligne de r�sultat PostgreSQL dans un tableau
- pg_fetch_object() - Lit une ligne de r�sultat PostgreSQL dans un objet
- pg_num_rows() - Retourne le nombre de lignes PostgreSQL
- pg_affected_rows() - Retourne le nombre de lignes affect�es