pg_get_notify

Gets SQL NOTIFY message

&reftitle.description; ``array``false```pg_get_notify` `PgSql\Connection` `connection` `int` `mode` `PGSQL_ASSOC`

`pg_get_notify` gets notifications generated by a `NOTIFY` SQL command. To receive notifications, the `LISTEN` SQL command must be issued.

&reftitle.parameters;

`connection`

- &pgsql.parameter.connection;

`mode`

- &pgsql.parameter.mode;
&reftitle.returnvalues;

An `array` containing the `NOTIFY` message name and backend PID. If supported by the server, the array also contains the server version and the payload. Otherwise if no `NOTIFY` is waiting, then &false; is returned.

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.connection-object;

&reftitle.examples;

### PostgreSQL NOTIFY message

    <?php
    $conn = pg_pconnect("dbname=publisher");
    if (!$conn) {
      echo "An error occurred.\n";
      exit;
    }

    // Listen 'author_updated' message from other processes
    pg_query($conn, 'LISTEN author_updated;');
    $notify = pg_get_notify($conn);
    if (!$notify) {
      echo "No messages\n";
    } else {
      print_r($notify);
    }
    ?>

&reftitle.seealso;

- `pg_get_pid`