array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pg-last-notice.php', 1 => 'pg_last_notice', 2 => 'Retourne la dernière note du serveur PostgreSQL', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'pg_cancel_query', ), 'prev' => array ( 0 => 'function.pg-last-error.php', 1 => 'pg_last_error', ), 'next' => array ( 0 => 'function.pg-last-oid.php', 1 => 'pg_last_oid', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/pgsql/functions/pg-last-notice.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_last_notice

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

pg_last_notice — Retourne la dernière note du serveur PostgreSQL

Description

pg_last_notice(PgSql\Connection $connection, int $mode = PGSQL_NOTICE_LAST): array|string|bool

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(), il est possible d'éviter des requêtes inutiles en vérifiant si des notes sont liées ou pas à la 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

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), ou PGSQL_NOTICE_CLEAR (pour effacer les notes).

Valeurs de retour

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.

Historique

Version Description
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.
7.1.0 Le paramètre mode a été ajouté.

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