README

Библиотека событий

Localzet Events — это простая и эффективная система управления событиями для PHP приложений. Она позволяет легко регистрировать, вызывать и управлять событиями.

Установка

Вы можете установить библиотеку с помощью Composer. Просто выполните команду:

composer require localzet/events

Использование

Регистрация обработчиков событий

Вы можете регистрировать обработчики событий с помощью метода on. Метод on принимает имя события и callable или массив в качестве обработчика.

use localzet\Events;

// Регистрация простого callable обработчика
Events::on('user.created', function($data, $eventName) {
    echo "Пользователь создан с данными: " . json_encode($data);
});

// Регистрация метода класса в качестве обработчика
Events::on('user.deleted', [UserHandler::class, 'handleUserDeleted']);

Вызов событий

Чтобы вызвать событие, используйте метод emit. Метод emit принимает имя события, данные и необязательный флаг остановки. Флаг остановки прекращает выполнение после первого обработчика, вернувшего ненулевой ответ.

// Вызов события
$data = ['id' => 1, 'name' => 'John Doe'];
Events::emit('user.created', $data);

Удаление обработчиков событий

Вы можете удалить обработчики событий с помощью метода off. Метод off требует имя события и ID обработчика.

$listenerId = Events::on('user.updated', function($data, $eventName) {
    echo "Пользователь обновлен с данными: " . json_encode($data);
});

// Удаление обработчика
Events::off('user.updated', $listenerId);

Список всех обработчиков событий

Вы можете получить список всех зарегистрированных обработчиков событий с помощью метода list.

$listeners = Events::list();
print_r($listeners);

Проверка наличия обработчиков событий

Чтобы проверить, есть ли зарегистрированные обработчики для конкретного события, используйте метод has.

if (Events::has('user.created')) {
    echo "Есть обработчики для события user.created.";
}

Продвинутые функции

Обработчики событий с префиксами

Вы можете регистрировать обработчики для событий с общим префиксом, используя символ *.

// Регистрация обработчика для всех событий user.*
Events::on('user.*', function($data, $eventName) {
    echo "Событие $eventName вызвано с данными: " . json_encode($data);
});