array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ibase-set-event-handler.php', 1 => 'ibase_set_event_handler', 2 => 'Registriert eine Rückruffunktion, die aufgerufen werden soll, wenn Ereignisse auftreten', ), 'up' => array ( 0 => 'ref.ibase.php', 1 => 'Firebird/InterBase Funktionen', ), 'prev' => array ( 0 => 'function.ibase-service-detach.php', 1 => 'ibase_service_detach', ), 'next' => array ( 0 => 'function.ibase-trans.php', 1 => 'ibase_trans', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ibase/functions/ibase-set-event-handler.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

ibase_set_event_handler(callable $event_handler, string $event_name, string ...$even_names): resource
ibase_set_event_handler(
    resource $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