ibase_set_event_handler
(PHP 5, PHP 7 < 7.4.0)
ibase_set_event_handler — Registriert eine Rückruffunktion, die aufgerufen werden soll, wenn Ereignisse auftreten
Beschreibung
$event_handler
, string $event_name
, string ...$even_names
): resourceresource
$connection
,callable
$event_handler
,string
$event_name
,string
...$event_names
): resource
Diese Funktion registriert eine PHP-Benutzerfunktion als Ereignishandler für die angegebenen Ereignisse.
Parameter-Liste
-
event_handler
-
Der Rückruf wird mit dem Ereignisnamen und der Verknüpfungsressource als Argument aufgerufen, wenn eines der angegebenen Ereignisse von der Datenbank gesendet wird.
Der Rückruf muss
false
zurückgeben, wenn der Eventhandler abgebrochen werden soll. Jeder andere Rückgabewert wird ignoriert. Diese Funktion akzeptiert bis zu 15 Ereignisargumente. -
event_name
-
Ein Ereignisname.
-
event_names
-
Maximal 15 Ereignisse erlaubt.
Rückgabewerte
Der Rückgabewert ist eine Ereignisressource. Diese Ressource kann verwendet werden, um den Ereignishandler mithilfe von ibase_free_event_handler() freizugeben.
Beispiele
Beispiel #1 ibase_set_event_handler()-Beispiel
<?php
function event_handler($event_name, $link)
{
if ($event_name == "NEW ORDER") {
// process new order
ibase_query($link, "UPDATE orders SET status='handled'");
} else if ($event_name == "DB_SHUTDOWN") {
// free event handler
return false;
}
}
ibase_set_event_handler($link, "event_handler", "NEW_ORDER", "DB_SHUTDOWN");
?>
Siehe auch
- ibase_free_event_handler() - Bricht einen registrierten Ereignishandler ab
- ibase_wait_event() - Wartet, bis ein Ereignis von der Datenbank veröffentlicht wurde