Manuel PHP
Précédent |  | Suivant

# pg_last_notice

(PHP 4 >= 4.0.6, PHP 5)

pg_last_notice -- Retourne la dernière note du serveur PostgreSQL

## Description

string pg_last_notice ( resource 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.

Avertissement

Cette fonction est EXPERIMENTALE et elle n'est pas complètement implémentée. pg_last_notice() a été ajoutée en PHP 4.0.6. Cependant, PHP 4.0.6 avait un problème avec la gestion des notes. L'utilisation du module PostgreSQL avec PHP 4.0.6 n'est pas recommandé, même si vous n'utilisez pas pg_last_notice().

Cette fonction est totalement implémentée en PHP 4.3.0. Les versions plus anciennes de PHP ignorent les données de connexion au serveur.

Le suivi des notes peut être rendu optionnel en mettant à 1 la directive de configuration pgsql.ignore_notice du fichier `php.ini`, depuis PHP 4.3.0.

L'enregistrement des notes peut être rendu optionnel en mettant la directive de configuration pgsql.log_notice du `php.ini` à 0, à partir de PHP 4.3.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.

## Exemples

Exemple 1. Exemple avec pg_last_error()

`<?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()
pg_last_error()

Précédent | Sommaire | Suivant
pg_last_error | Niveau supérieur | pg_last_oid