ibase_set_event_handler
(PHP 5, PHP 7 < 7.4.0)
ibase_set_event_handler — Регистрирует callback-функцию, которая будет вызываться при публикации событий
Описание
$event_handler
, string $event_name
, string ...$even_names
) : 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() - Ждем, пока событие будет опубликовано в базе данных