Manuel PHP
Précédent |  | Suivant

# pg_query

(PHP 4 >= 4.2.0, PHP 5)

pg_query -- Exécute une requête PostgreSQL

## Description

resource pg_query ( string query )
resource pg_query ( resource connection, string query )

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 auteurs SET auteur=UPPER(auteur) WHERE id=1;"; $query .= "UPDATE auteurs SET auteur=LOWER(auteur) WHERE id=2;"; $query .= "UPDATE auteurs SET auteur=NULL WHERE id=3;"; pg_query($conn, $query); ?>`

## Voir aussi

pg_connect()
pg_pconnect()
pg_fetch_array()
pg_fetch_object()
pg_num_rows()
pg_affected_rows()

Précédent | Sommaire | Suivant
pg_query_params | Niveau supérieur | pg_result_error_field