PHPCon Poland 2024

ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

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

Описание

ibase_set_event_handler(callable $event_handler, string $event_name, string ...$even_names): resource
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() - Ждём, пока событие будет опубликовано в базе данных

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top