pg_get_notify

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_get_notify Lee el mensaje SQL NOTIFY

Descripción

pg_get_notify(PgSql\Connection $connection, int $mode = PGSQL_ASSOC): array|false

pg_get_notify() recibe el mensaje de NOTIFY enviado por un comando SQL NOTIFY. Para leer el mensaje asociado, se debe utilizar el comando LISTEN.

Parámetros

connection

An PgSql\Connection instance.

mode

An optional parameter that controls how the returned array is indexed. mode is a constant and can take the following values: PGSQL_ASSOC, PGSQL_NUM and PGSQL_BOTH. Using PGSQL_NUM, the function will return an array with numerical indices, using PGSQL_ASSOC it will return only associative indices while PGSQL_BOTH will return both numerical and associative indices.

Valores devueltos

Un array que contiene el nombre del mensaje NOTIFY. Si el servidor lo soporta, el array contiene también la versión del servidor y la carga útil (payload). De lo contrario, si no hay ningún NOTIFY pendiente, se devolverá false.

Historial de cambios

Versión Descripción
8.1.0 The connection parameter expects an PgSql\Connection instance now; previously, a recurso was expected.

Ejemplos

Ejemplo #1 Ejemplo con pg_get_notify()

<?php
$conn
= pg_pconnect("dbname=publisher");
if (!
$conn) {
echo
"Se ha producido un error.\n";
exit;
}

// escucha el mensaje 'author_updated' de otros procesos
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!
$notify) {
echo
"Ningún mensaje\n";
} else {
print_r($notify);
}
?>

Ver también