ibase_set_event_handler

(PHP 5, PHP 7)

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

Описание

ibase_set_event_handler ( callable $event_handler , string $event_name1 [, string $... ] ) : resource
ibase_set_event_handler ( resource $connection , callable $event_handler , string $event_name1 [, string $... ] ) : resource

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

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

event_handler

Callback-фукнция вызывается с именем события и ресурсом ссылки в качестве аргументов всякий раз, когда одно из указанных событий публикуется базой данных.

Callback-фукнция должна возвращать FALSE, если обработчик события должен быть отменен. Любое другое возвращаемое значение игнорируется. Функция принимает до 15 аргументов события.

event_name1

Наименование события.

...

Разрешено максимум 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() - Ждем, пока событие будет опубликовано в базе данных