pg_get_notify
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_get_notify —
Lit le message SQL NOTIFY
Description
pg_get_notify(resource $connection
, int $result_type
= ?): array
Liste de paramètres
-
connection
-
Ressource de connexion PostgreSQL.
-
result_type
-
Un paramètre optionnel qui contrôle la façon dont le tableau sera indexé.
result_type
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.
Valeurs de retour
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é.
Exemples
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);
}
?>
Voir aussi
- pg_get_pid() - Lit l'identifiant de processus du serveur PostgreSQL