pg_get_notify
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_get_notify — Liefert eine SQL-NOTIFY-Nachricht
Beschreibung
pg_get_notify
( resource $connection
, int $result_type
= ?
) : array
Parameter-Liste
-
connection
-
Die PostgreSQL-Verbindungskennung.
-
result_type
-
Ein optionaler Parameter bestimmt, wie das zurückgegebene
array indiziert werden soll.
result_type
ist eine Konstante, die einen der
folgenden Werte annehmen kann: PGSQL_ASSOC
,
PGSQL_NUM
oder PGSQL_BOTH
.
Wenn pg_get_notify() mit
PGSQL_NUM
aufgerufen wird, wird ein numerisches
Array zurückgegeben, mit PGSQL_ASSOC
wird ein
assoziatives Array zurückgegeben, während der Standardwert
PGSQL_BOTH
ein Array mit beiden Indizes
zurückgibt.
Rückgabewerte
Ein array, das die NOTIFY
-Nachricht und die
PID des Datenbankprozesses enthält. Von PHP 5.4.0 an, falls vom Server
unterstützt, enthält das Array ebenfalls die Serverversion und die
Nutzdaten. Existiert kein NOTIFY
, wird false
zurückgegeben.
Beispiele
Beispiel #1 PostgreSQL-NOTIFY-Nachricht
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Konnte keine Verbindung aufbauen.\n";
exit;
}
// Listen-Kommando 'author_updated', um Benachrichtigungen
// von anderen Prozessen zu erhalten
pg_query($conn, 'LISTEN author_updated;');
$notify = pg_get_notify($conn);
if (!$notify) {
echo "Keine Nachrichten\n";
} else {
print_r($notify);
}
?>