update page now

    Pdo\Pgsql::getNotify

    (PHP 8 >= 8.4.0)

    Pdo\Pgsql::getNotify — Renvoie une notification asynchrone

    Description

    public Pdo\Pgsql::getNotify(int $fetchMode = PDO::FETCH_DEFAULT, int $timeoutMilliseconds = 0): array|false

    Renvoie un jeu de résultats représentant une notification asynchrone en attente.

    Liste de paramètres

    fetchMode

    Le format sous lequel le jeu de résultats doit être, une des constantes suivantes:

    timeoutMilliseconds
    Le temps d'attente pour une réponse, en millisecondes.

    Valeurs de retour

    Si une ou plusieurs notifications sont en attente, retourne une seule ligne, avec les champs message et pid, sinon retourne false.

    Erreurs / Exceptions

    Une ValueError est lancée si fetchMode n'est pas une des constantes PDO::FETCH_* valides.

    Une ValueError est lancée si timeoutMilliseconds est inférieur à 0.

    Une Warning est lancée si timeoutMilliseconds est supérieur à la valeur qui peut être contenue dans un entier signé 32 bits, auquel cas ce sera la valeur maximale d'un entier signé 32 bits.

    Voir aussi

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    sage at sage dot sk
    21 hours ago
    This page needs an example to understand that you **need** to explicitly call LISTEN before using getNotify, like shown in https://www.php.net/manual/en/function.pg-get-notify.php

<?php

$db = new PDO($dsn, $user, $password, $options);
$db->query('LISTEN test');
$notification = $db->pgsqlGetNotify(PDO::FETCH_ASSOC, 10000);

// or

$db = new Pdo\Pgsql($dsn, $user, $password, $options);
$db->query('LISTEN test');
$notification = $db->getNotify(PDO::FETCH_ASSOC, 10000);

// now you can call NOTIFY elsewhere
// PG> NOTIFY test, 'payload string';
var_dump($notification);

?>

array(3) {
  ["message"]=>
  string(4) "test"
  ["pid"]=>
  int(123565)
  ["payload"]=>
  string(14) "payload string"
}

If you called NOTIFY before calling LISTEN, nothing will be returned!

You receive the first notification only, and you have to call getNotify again. And call LISTEN again if DB connection drops.
    ＋add a note
    To Top