(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_get_notify — Gets SQL NOTIFY message
pg_get_notify ( resource $connection [, int $result_type ] ) : array
pg_get_notify() gets notifications generated by a NOTIFY
SQL command. To receive notifications, the LISTEN
SQL command must be issued.
connection
PostgreSQL database connection resource.
result_type
An optional parameter that controls how the returned array is indexed. result_type
is a constant and can take the following values: PGSQL_ASSOC
, PGSQL_NUM
and PGSQL_BOTH
. Using PGSQL_NUM
, pg_get_notify() will return an array with numerical indices, using PGSQL_ASSOC
it will return only associative indices while PGSQL_BOTH
, the default, will return both numerical and associative indices.
An array containing the NOTIFY
message name and backend PID. As of PHP 5.4.0 and 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.
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); } ?>
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.pg-get-notify.php