(PHP 5, PHP 7 < 7.4.0)
ibase_set_event_handler — Registriert eine Rückruffunktion, die aufgerufen werden soll, wenn Ereignisse auftreten
$event_handler
, string $event_name
, string ...$even_names
): resource$connection
,$event_handler
,$event_name
,...$event_names
Diese Funktion registriert eine PHP-Benutzerfunktion als Ereignishandler für die angegebenen Ereignisse.
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.
Der Rückgabewert ist eine Ereignisressource. Diese Ressource kann verwendet werden, um den Ereignishandler mithilfe von ibase_free_event_handler() freizugeben.
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");
?>