Function.pg-get-notify

Aus PHP-Wiki

pg_get_notify — Gibt eine SQL NOTIFY-Nachricht zurück

Beschreibung

array pg_get_notify ( resource $connection [, int $result_type ] )

pg_get_notify() gibt eine NOTIFY-Nachricht zurück, die vom SQL-Kommando NOTIFY gesendet wurde. Um diese Nachrichten zu erhalten, muss zuvor das SQL-Kommando LISTEN ausgeführt worden sein.

Parameter-Liste

connection

• 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. Existiert keine Nachricht, 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);
}
?>

Siehe auch

• pg_get_pid()