Php/docs/function.pg-last-notice

• PHP Manual
• PostgreSQL 函数
• 返回 PostgreSQL 服务器最新一条公告信息

pg_last_notice

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

pg_last_notice — 返回 PostgreSQL 服务器最新一条公告信息

说明

pg_last_notice ( resource $connection ) : string

pg_last_notice() 返回由 connection 指定的 PostgreSQL 服务器最新的一条公告信息。PostgreSQL 服务器在某些情况下会发送公告信息，例如在表里创建 SERIAL 列。

有了 pg_last_notice()，只要检查公告是否和该事务有关，就可以避免提交无用的查询。

可以通过在 php.ini 中把 pgsql.ignore_notice 置为 1 来使公告信息追踪成为可选项。

可以通过在 php.ini 中把 pgsql.log_notice 置为 0 来使公告信息日志成为可选项。 除非 pgsql.ignore_notice 为 0，否则公告信息不能被日志记录。

参数

connection

PostgreSQL database connection resource.

返回值

A string containing the last notice on the given connection, or false on error.

更新日志

版本	说明
4.3.0	本函数在 PHP 4.3.0 中完全实现。低于 PHP 4.3.0 的版本中都忽略了数据库连接参数。
4.3.0	The pgsql.ignore_notice and pgsql.log_notice php.ini directives were added.
4.0.6	PHP 4.0.6 本身在公告信息处理上有问题。即使不使用 pg_last_notice() 函数，也不推荐在 PHP 4.0.6 中使用 PostgreSQL 模块。

范例

Example #1 pg_last_notice() example

<?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() - 得到某连接的最后一条错误信息