ibase_set_event_handler
(PHP 5)
ibase_set_event_handler — Registra uma função de callback para ser chamada quando eventos são postados
Descrição
resource ibase_set_event_handler
( callback $event_handler
, string $event_name1
[, string $event_name2
[, string $...
]] )
resource ibase_set_event_handler
( resource $connection
, callback $event_handler
, string $event_name1
[, string $event_name2
[, string $...
]] )
Esta função registra uma função do usuário como gerenciador de eventos para os eventos especificados. O callback é chamado com o nome do evento e a conexão como argumento quando qualquer um dos eventos especificados e postado pelo banco de dados. O callback deve retornar FALSE se o gerenciador de eventos deve ser cancelado. Qualquer outro valor retornado é ignorado.
<?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");
?>
O valor de retorno é um recurso event. Este recurso pode ser utilizado para liberar o gerenciador de evento usando ibase_free_event_handler().
Veja também ibase_free_event_handler() e ibase_wait_event().