Funciones de Firebird/InterBase
PHP Manual

ibase_set_event_handler

(PHP 5)

ibase_set_event_handlerRegistra una función manejadora de un determinado evento

Descripción

resource ibase_set_event_handler ( callable $event_handler , string $event_name1 [, string $event_name2 [, string $... ]] )
resource ibase_set_event_handler ( resource $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á FALSE si 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


Funciones de Firebird/InterBase
PHP Manual