pg_last_notice
(PHP 4 >= 4.0.6, PHP 5)
pg_last_notice — Retourne la dernière note du serveur PostgreSQL
Description
$connection
)
pg_last_notice() retourne la dernière note du
serveur PostgreSQL sur la connexion connection
spécifiée. Le serveur PostgreSQL envoie des notes dans plusieurs cas,
par exemple lors de création d'une colonne SERIAL dans
une table.
Avec pg_last_notice(), vous pouvez éviter des requêtes inutiles en vérifiant si des notes sont liées ou pas à votre transaction.
Le suivi des notes peut être rendu optionnel en mettant à 1 la directive de configuration pgsql.ignore_notice du fichier php.ini.
L'enregistrement des notes peut être rendu optionnel en mettant la directive de configuration pgsql.log_notice du php.ini à 0. À moins que pgsql.ignore_notice ne soit à 0, les notes ne seront pas enregistrées.
Liste de paramètres
-
connection
-
Ressource de connexion de base de données PostgreSQL.
Valeurs de retour
Une chaîne de caractères contenant la dernière note sur la connexion
connection
ou FALSE
en cas d'erreur.
Historique
Version | Description |
---|---|
4.3.0 | Cette fonction est maintenant pleinement implémentée. Les anciennes versions ignoraient les paramètres de connexion à la base de données. |
4.3.0 | Les directives pgsql.ignore_notice et pgsql.log_notice du php.ini ont été ajoutées. |
4.0.6 | PHP 4.0.6 a un problème avec la gestion des messages d'avertissement. Utiliser le module PostgreSQL avec PHP 4.0.6 n'est pas recommandé, même si vous n'utilisez pas la fonction pg_last_notice(). |
Exemples
Exemple #1 Exemple avec pg_last_notice()
<?php $pgsql_conn = pg_connect("dbname=mark host=localhost"); $res = pg_query("CREATE TABLE test (id SERIAL)"); $notice = pg_last_notice($pgsql_conn); echo $notice; ?>
L'exemple ci-dessus va afficher :
CREATE TABLE will create implicit sequence "test_id_seq" for "serial" column "test.id"
Voir aussi
- pg_query() - Exécute une requête PostgreSQL
- pg_last_error() - Lit le dernier message d'erreur sur la connexion