cognesy/instructor-events

Configuration functionality for Instructor PHP library

v2.3.1 2026-03-30 09:17 UTC

Requires

• php: ^8.3
• cognesy/instructor-utils: ^2.3
• psr/event-dispatcher: ^1.0

Requires (Dev)

• icanhazstring/composer-unused: ^0.9.0
• jetbrains/phpstorm-attributes: ^1.2
• maglnet/composer-require-checker: ^4.16
• pestphp/pest: ^2.34
• phpstan/phpstan: ^1.11
• roave/security-advisories: dev-latest
• vimeo/psalm: ^6.0

MIT

• Dariusz Debowczyk

README

Small PSR-14 compatible event layer for InstructorPHP.

Use it to dispatch domain events, register typed listeners, and add global wiretaps for observability.

Example

<?php

use Cognesy\Events\Dispatchers\EventDispatcher;
use Cognesy\Events\Event;

final class UserLoggedIn extends Event {}

$events = new EventDispatcher();

$events->addListener(UserLoggedIn::class, function (UserLoggedIn $event): void {
    // handle typed event
});

$events->wiretap(function (object $event): void {
    // observe every event
});

$events->dispatch(new UserLoggedIn(['userId' => 123]));

Documentation

• packages/events/CHEATSHEET.md
• packages/events/MIGRATION-2.0.md
• packages/events/tests/