Регистрирует callback-функцию, которая будет вызываться при публикации событий

# ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

ibase_set_event_handler — Регистрирует callback-функцию, которая будет вызываться при публикации событий

### Описание

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

Функция регистрирует пользовательскую функцию PHP в качестве обработчика событий для указанных событий.

### Список параметров

`event_handler`
  Callback-функция вызывается с именем события и ресурсом ссылки в качестве аргументов всякий раз, когда одно из указанных событий публикуется базой данных. Callback-функция должна возвращать `false`, если обработчик события должен быть отменён. Любое другое возвращаемое значение игнорируется. Функция принимает до 15 аргументов события.
`event_name`
  Наименование события.
`event_names`
  Разрешено максимум 15 событий.

### Возвращаемые значения

Возвращаемое значение является ресурсом события. Этот ресурс можно использовать для освобождения обработчика событий с помощью ibase_free_event_handler().

### Примеры

Пример #1 Пример использования ibase_set_event_handler()

    <?php

    function event_handler($event_name, $link)
    {
        if ($event_name == "NEW ORDER") {
            // обрабатываем новый заказ
            ibase_query($link, "UPDATE orders SET status='handled'");
        } else if ($event_name == "DB_SHUTDOWN") {
            // отменяем обработчик событий
            return false;
        }
    }

    ibase_set_event_handler($link, "event_handler", "NEW_ORDER", "DB_SHUTDOWN");
    ?>

### Смотрите также

- ibase_free_event_handler() - Отменяет зарегистрированный обработчик события
- ibase_wait_event() - Ждём, пока событие будет опубликовано в базе данных

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