pg_get_notify

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

pg_get_notifyGets SQL NOTIFY message

Опис

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

pg_get_notify() gets notifications generated by a NOTIFY SQL command. To receive notifications, the LISTEN SQL command must be issued.

Параметри

connection

Примірник PgSql\Connection.

mode

Необов'язковий параметр, яким вказується спосіб індексування масиву (array). mode може мати значення однієї з констант: PGSQL_ASSOC, PGSQL_NUM або PGSQL_BOTH. Якщо задано PGSQL_NUM, то функція поверне масив з числовими індексами; якщо PGSQL_ASSOC, то з асоціативними індексами; якщо PGSQL_BOTH, то і з числовими, і з асоціативними індексами.

Значення, що повертаються

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.

Журнал змін

Версія Опис
8.1.0 Тепер параметр connection має бути примірником PgSql\Connection. Раніше очікувався resource.

Приклади

Приклад #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);
}
?>

Прогляньте також