(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_get_notify — Lit le message SQL NOTIFY
pg_get_notify() reçoit le message de NOTIFY envoyé
par une commande SQL NOTIFY. Pour lire le message
associé, utilisez la commande LISTEN.
connectionUne instance PgSql\Connection.
mode
Un paramètre optionnel qui contrôle la façon dont le tableau sera indexé.
mode est une constante et peut prendre
les valeurs suivantes : PGSQL_ASSOC,
PGSQL_NUM et PGSQL_BOTH.
L'utilisation de PGSQL_NUM, pg_get_notify()
retournera un tableau avec des indices numériques, l'utilisation de
PGSQL_ASSOC retournera un tableau associatif tandis que
PGSQL_BOTH, la valeur par défaut, retournera
des indices numériques et associatifs.
Un tableau contenant le nom du message NOTIFY.
Si le serveur supporte, le tableau contient aussi la version du serveur et la charge utile (payload).
Sinon, si aucun NOTIFY n'est en attente, alors false sera retourné.
| Version | Description |
|---|---|
| 8.1.0 |
Le paramètre connection attend désormais une instance de
PgSql\Connection ; auparavant, une ressource était attendu.
|
Exemple #1 Exemple avec pg_get_notify()
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Une erreur est survenue.\n";
exit;
}
// ecoute le message 'author_updated' des autres processus
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!$notify) {
echo "Aucun message\n";
} else {
print_r($notify);
}
?>