Registra uma função de retorno a ser chamada quando eventos são postados

# ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

ibase_set_event_handler — Registra uma função de retorno a ser chamada quando eventos são postados

### Descrição

function ibase_set_event_handler(callable `$event_handler`, string `$event_name`, string `...$even_names`): resource
function ibase_set_event_handler(
resource `$connection`,
callable `$event_handler`,
string `$event_name`,
string `...$event_names`
): resource

Esta função registra uma função de usuário PHP como manipulador de eventos para os eventos especificados.

### Parâmetros

`event_handler`
  A função de retorno é chamada com o nome do evento e o recurso de conexão como argumentos sempre que um dos eventos especificados é publicado pelo banco de dados. A função de retorno deve retornar `false` se o manipulador de eventos deve ser cancelado. Qualquer outro valor de retorno é ignorado. Esta função aceita até 15 argumentos de eventos.
`event_name`
  Um nome de evento.
`event_names`
  No máximo 15 eventos permitidos.

### Valor Retornado

O valor de retorno é um recurso de evento. Este recurso pode ser usado para liberar o manipulador de eventos usando ibase_free_event_handler().

### Exemplos

Exemplo #1 Exemplo de ibase_set_event_handler()

    <?php

    function event_handler($event_name, $link)
    {
        if ($event_name == "NEW ORDER") {
            // processa novo pedido
            ibase_query($link, "UPDATE orders SET status='handled'");
        } else if ($event_name == "DB_SHUTDOWN") {
            // libera manipulador de eventos
            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 pelo banco de dados

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open