array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.pg-last-notice.php', 1 => 'pg_last_notice', 2 => 'Возвращает последнее уведомление от сервера PostgreSQL', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Функции PostgreSQL', ), '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' => 'ru', '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 — Возвращает последнее уведомление от сервера PostgreSQL

Описание

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

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

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

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

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

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

connection

Экземпляр класса PgSql\Connection.

mode

Одна из констант PGSQL_NOTICE_LAST (для возврата последнего уведомления), PGSQL_NOTICE_ALL (для возврата всех уведомлений) или PGSQL_NOTICE_CLEAR (для очистки уведомлений).

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

Строка, содержащая последнее уведомление на заданном соединении, если задана опция PGSQL_NOTICE_LAST, массив (array), если опция PGSQL_NOTICE_ALL и значение типа bool в случае опции PGSQL_NOTICE_CLEAR.

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

Версия Описание
8.1.0 Параметр connection теперь принимает объект PgSql\Connection; раньше параметр принимал тип resource.
7.1.0 Добавлен параметр mode.

Примеры

Пример #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"

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