Возвращает последнее уведомление от сервера PostgreSQL

Описание

string pg_last_notice ( resource $connection )

pg_last_notice() возвращает последнее уведомление сгенерированное сервером PostgreSQL на заданном соединении connection. В некоторых случаях сервер посылает уведомления, например при создании в таблице колонки типа SERIAL.

Благодаря pg_last_notice() не требуется делать лишних запросов, чтобы узнать посылала ваша транзакция уведомления или нет.

Можно отключить отслеживание уведомлений установкой в 1 параметра pgsql.ignore_notice в файле php.ini.

Можно отключить журналирование уведомлений установкой в 0 параметра pgsql.log_notice в файле php.ini. Пока этот параметр установлен в 0, уведомления невозможно записать в журнал выполнения.

Список параметров

connection: Ресурс соединения с базой данных PostgreSQL.

Возвращаемые значения

Строка, содержащая последнее уведомление на заданном соединении, либо FALSE в случае ошибки.

Список изменений

Версия	Описание
4.3.0	Функция реализована полностью. Ранние версии не использовали параметр соединения.
4.3.0	В `php.ini` добавлены директивы pgsql.ignore_notice и pgsql.log_notice.
4.0.6	В PHP 4.0.6 были проблемы с обработкой уведомлений. Использование модуля PostgreSQL с PHP 4.0.6 не рекомендуется даже если вы не используете функцию pg_last_notice().

Примеры

Пример #1 Пример использования 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;
?>

Результат выполнения данного примера:

CREATE TABLE will create implicit sequence "test_id_seq" for "serial" column "test.id"

Смотрите также

pg_query() - Выполняет запрос
pg_last_error() - Получает сообщение о последней произошедшей ошибке на соединении с базой данных