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
.
À partir de PHP 5.4.0 et 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