pg_get_notify

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

pg_get_notifyOttiene il messaggio SQL NOTIFY

Descrizione

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

pg_get_notify() riceve notifiche generate da un comando SQL NOTIFY. Per ricevere le notifiche, è necessario eseguire il comando SQL LISTEN.

Elenco dei parametri

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.

Valori restituiti

Un array contenente il nome del messaggio NOTIFY e il PID di backend. Se supportato dal server, l'array contiene anche la versione del server e il payload. Altrimenti se non è in attesa alcuna NOTIFY, allora viene restituito false.

Log delle modifiche

Versione Descrizione
8.1.0 The connection parameter expects an PgSql\Connection instance now; previously, a resource was expected.

Esempi

Example #1 Messaggio NOTIFY di PostgreSQL

<?php
$conn
= pg_pconnect("dbname=publisher");
if (!
$conn) {
echo
"Si è verificato un errore.\n";
exit;
}

// Ascolta il messaggio 'author_updated' da altri processi
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!
$notify) {
echo
"Nessun messaggio\n";
} else {
print_r($notify);
}
?>

Vedere anche: