php 8.6监听postgresql事件时,可为listen建立独立连接,等待数据库socket可读后消耗输入,再循环取出pg_get_notify返回的通知。listen/notify适合提醒应用“有变化需要查询”,并不提供离线期间的持久消息队列;通知内容应作为查询线索,而非唯一的数据副本。需要pgsql扩展。

PHP手册中的pg_get_notify定义
订阅后按Socket事件读取
连接串由环境变量配置,示例不输出凭据。频道名称固定,不把用户文本直接拼进LISTEN;连接保持自动提交状态,不在长事务中等待通知。
<?php
$dsn = getenv('PG_DSN');
if (!is_string($dsn) || $dsn === '') throw new RuntimeException('PG_DSN未配置');
$db = pg_connect($dsn, PGSQL_CONNECT_FORCE_NEW);
if ($db === false) throw new RuntimeException('数据库连接失败');
try {
if (pg_query($db, 'LISTEN app_events') === false) throw new RuntimeException('订阅失败');
$socket = pg_socket($db);
if ($socket === false) throw new RuntimeException('无法取得数据库Socket');
for ($poll = 0; $poll < 6; ++$poll) {
$read = [$socket]; $write = null; $except = null;
$n = stream_select($read, $write, $except, 10);
if ($n === false) throw new RuntimeException('等待Socket失败');
if ($n === 0) continue;
if (!pg_consume_input($db)) throw new RuntimeException('数据库输入读取失败');
while (($notice = pg_get_notify($db, PGSQL_ASSOC)) !== false) {
echo json_encode($notice, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
}
}
} finally { pg_close($db); }
PHP手册中的pg_consume_input定义
在另一条连接发送通知
已完成订阅后,可从另一个数据库会话执行下列语句。正式代码用参数查询调用pg_notify,payload只放记录标识等少量信息,监听者收到后按权限重新查询数据库。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
SELECT pg_notify('app_events', '{"record_id":"42"}');处理事务和断线边界
事务内发出的通知在事务提交后才会交付。服务重连后要重新LISTEN,并通过数据库中可持久查询的变更位置补偿,而不是假定断线期间的通知会重新送达。示例只作有限轮询;长期运行还需要进程管理、重连和退出信号处理。


















