(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
pg_last_notice — Retourne la dernière note du serveur PostgreSQL
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.
connection
Une instance PgSql\Connection.
mode
L'un de PGSQL_NOTICE_LAST
(pour retourner la dernière note),
PGSQL_NOTICE_ALL
(pour retourner toutes les notes),
or PGSQL_NOTICE_CLEAR
(pour effacer les notes).
Une chaîne de caractères contenant la dernière note sur la connexion
connection
avec
PGSQL_NOTICE_LAST
,
un tableau avec PGSQL_NOTICE_ALL
,
un booléen avec PGSQL_NOTICE_CLEAR
.
Version | Description |
---|---|
8.1.0 |
Le paramètre connection attend désormais une instance de
PgSql\Connection ; auparavant, une ressource était attendu.
|
7.1.0 |
Le paramètre mode a été ajouté.
|
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"