ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

ibase_set_event_handler — Registra una función manejadora de un determinado evento

Descripción

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 $... ]] ) : resource

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