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