ibase_service_detach
ibase_timefmt
Funções para Firebird/InterBase
PHP Manual

# 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.

### Parâmetros

`event_handler`

  O callback é chamado com o nome do evento e o link do resource como argumento sempre que um dos eventos especificados é postado pelo banco de dados.

  O callback precisa retornar `FALSE` se o manipulador do evento deve ser cancelado. Qualquer outro valor retornado é ignorado. Esta função aceita 15 argumentos de eventos.

`event_name1`

  Um nome do evento.

`event_name2`

`...`

### Valor Retornado

O valor do retorno é um resource de evento. Este resource pode ser liberado usando a função ibase_free_event_handler().

### Exemplos

Exemplo #1 Exemplo da ibase_set_event_handler()

`<?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");
?>`

### Veja Também

- ibase_free_event_handler() - Cancela um manipulador de eventos registrado
- ibase_wait_event() - Espera por um evento ser postado no banco de dados

ibase_service_detach
ibase_timefmt
Funções para Firebird/InterBase
PHP Manual