ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

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

Описание

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

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

event_handler

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

event_name

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

event_names

Разрешено максимум 15 событий.

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

Возвращаемое значение является ресурсом события. Этот ресурс можно использовать для освобождения обработчика событий с помощью ibase_free_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() - Ждём, пока событие будет опубликовано в базе данных