pg_get_notify
Gets SQL NOTIFY message
Description
arrayfalse pg_get_notify(PgSql\Connection $connection
, int $mode
= PGSQL_ASSOC
)
Parameters
-
connection
-
An PgSql\Connection instance.
-
mode
-
An optional parameter that controls how the returned array is indexed.
mode
is a constant and can take the following values:
PGSQL_ASSOC
, PGSQL_NUM
and PGSQL_BOTH
.
Using PGSQL_NUM
, the function will return an array with numerical indices,
using PGSQL_ASSOC
it will return only associative indices
while PGSQL_BOTH
will return both numerical and associative indices.
Return Values
An array containing the NOTIFY
message name and backend PID.
If supported by the server, the array also contains the server version and the payload.
Otherwise if no NOTIFY
is waiting, then false
is returned.
Examples
Example #1 PostgreSQL NOTIFY message
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occurred.\n";
exit;
}
// Listen 'author_updated' message from other processes
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!$notify) {
echo "No messages\n";
} else {
print_r($notify);
}
?>