ibase_set_event_handler
(PHP 5)
ibase_set_event_handler — Registra una función manejadora de un determinado evento
Descripción
$event_handler
, string $event_name1
[, string $event_name2
[, string $...
]] )$connection
, callable $event_handler
, string $event_name1
[, string $event_name2
[, string $...
]] )Esta función registra una función PHP como manejadora para los eventos especificados.
Parámetros
-
event_handler -
A esta función se la invoca, proporcionándola como argumentos el nombre del evento y el enlace al recurso, cada vez que la base de datos emita el evento especificado.
La función devolverá
FALSEsi se tiene que cancelar el evento. Cualquier otro valor se ignorará. Esta función puede vincularse hasta a 15 eventos. -
event_name1 -
Nombre del evento.
-
event_name2 -
Se permiten hasta 15 eventos.
Valores devueltos
El valor devuelto es un recurso de evento. Este recurso se puede usar para liberar un manejador de eventos mediante ibase_free_event_handler().
Ejemplos
Ejemplo #1 Ejemplo de ibase_set_event_handler()
<?php
function event_handler($event_name, $link)
{
if ($event_name == "NEW ORDER") {
// procesar nueva petición
ibase_query($link, "UPDATE orders SET status='handled'");
} else if ($event_name == "DB_SHUTDOWN") {
// liberar manejador de evento
return false;
}
}
ibase_set_event_handler($link, "event_handler", "NEW_ORDER", "DB_SHUTDOWN");
?>
Ver también
- ibase_free_event_handler() - Cancela un manejador de eventos ya registrado
- ibase_wait_event() - Espera a que la base de datos emita un determinado evento
