pg_get_notify

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

pg_get_notify — 获取 SQL NOTIFY 消息

描述

pg_get_notify(PgSql\Connection $connection, int $mode = PGSQL_ASSOC): array|false

pg_get_notify() 获取由 NOTIFY SQL 命令生成的通知。要接收通知，必须发出 LISTEN SQL 命令。

参数

connection: 一个 PgSql\Connection 实例。
mode: 一个可选参数，控制返回的 array 的索引方式。 mode 是一个常量，可以取以下值：PGSQL_ASSOC、PGSQL_NUM 和 PGSQL_BOTH。使用 PGSQL_NUM，函数将返回具有数字索引的数组，使用 PGSQL_ASSOC 它将只返回关联索引，而 PGSQL_BOTH 将返回数字索引和关联索引。

返回值

一个 array，包含 NOTIFY 消息名称和后端 PID。如果服务器支持，该数组还包含服务器版本和有效负载。否则，如果没有任何 NOTIFY 在等待，则返回 false。

变更日志

版本	描述
8.1.0	现在 `connection` 参数期望一个 PgSql\Connection 实例；以前，期望的是一个资源。

范例

示例 #1 PostgreSQL NOTIFY 消息

<?php 
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
 echo "An error occurred.\n";
 exit;
}

// 监听来自其他进程的 'author_updated' 消息
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!$notify) {
 echo "No messages\n";
} else {
 print_r($notify);
}
?>

参见

pg_get_pid() - 获取后端的进程 ID

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的备注 2 个备注

向上

向下

glococo at gmail dot com ¶

7 年前

使用 HTML5 服务器发送事件的即时简单 PHP 通知

sse.php
<?php
$dbconn = new PDO("pgsql:host=localhost;dbname=mydb", "pduser", "userpass");
$dbconn->exec('LISTEN "channel_name"'); // 这些双引号非常重要

header("X-Accel-Buffering: no"); // 禁用 ngnix webServer 缓冲
header("Content-Type: text/event-stream");
header("Cache-Control: no-cache");
ob_end_flush(); // 关闭 PHP 输出缓冲
$inc=0;

while (1) {
 $result = "";
 // 等待一个 Notify 10 秒，而不是使用 sleep(10)
 $result = $dbconn->pgsqlGetNotify(PDO::FETCH_ASSOC, 10000); 

 if ( $result ) { 
 echo "id: $inc\ndata: ".stripslashes(json_encode($result))."\n\n";
 $inc++;
 }

 flush();
}
?>

在 Mozilla 网站（ssedemo.php）上测试了 HTML+JS 示例文件

向上

向下

david at frankieandshadow dot com ¶

3 年前

看来 pg_get_notify 无法区分没有消息等待和检查失败 - 两者似乎都返回 FALSE。

我必须在 pg_get_notify 之前添加一个 pg_check_connection(...) 来检查连接是否还活着（因为你将一直在轮询等待事件发生，所以很有可能 pg_get_notify 会是一个长期存在的连接）。在我的情况下，远程数据库服务器出现故障，如果没有 pg_check_connection，监听器就无法注意到，因此永远无法看到之后的通知。