ConfiguredEventListeners

Attaches config-declared listeners to a Phalcon events manager.

This helper keeps the bootstrap-level event attachment contract small and explicit. Applications configure listeners by event type, then each listener definition resolves to a class or DI service. Listener priorities use Phalcon's native priority support; the helper enables priorities before attaching so configured ordering works consistently across MVC, CLI, WebSocket, and test bootstraps that share the same events manager.

Supported listener definition forms:

• ListenerClass::class
• 'listenerServiceName'
• ['class' => ListenerClass::class, 'priority' => 200]
• ['service' => 'listenerServiceName', 'priority' => 200]

Array definitions may set enabled => false to disable one entry without removing it from merged configuration.

• Full name: \PhalconKit\Events\ConfiguredEventListeners
• This class is marked as final and can't be subclassed
• This class is a Final class

Methods

__construct

private __construct(): mixed

attach

Attach configured listeners to the provided manager.

public static attach(\PhalconKit\Di\DiInterface $di, \Phalcon\Contracts\Events\Manager $eventsManager, array<array-key,mixed> $listeners): void

The expected config shape is an event-type map. Each value may be a single listener definition or a list of listener definitions:

[
    'dispatch' => [
        ['class' => App\Listener\Security::class, 'priority' => 200],
        ['service' => 'auditDispatchListener', 'priority' => 100],
    ],
]

• This method is static. Parameters:

Throws:

When an event type, listener definition, listener class, listener service, or priority is invalid. - ConfigurationException

normalizeDefinitions

Normalize one event-type value to a list of listener definitions.

private static normalizeDefinitions(mixed $definitions): array<int|string,mixed>

• This method is static. Parameters:

isAssociativeListenerDefinition

Detect whether an array is a single listener definition.

private static isAssociativeListenerDefinition(array<array-key,mixed> $definition): bool

• This method is static. Parameters:

resolveDefinition

Resolve one listener definition and expose its priority by reference.

private static resolveDefinition(\PhalconKit\Di\DiInterface $di, mixed $definition, string $eventType, int|string $index, int& $priority): object|callable|null

• This method is static. Parameters:

Return Value:

Resolved listener, or null when disabled.

resolvePriority

Resolve and validate a listener priority.

private static resolvePriority(mixed $priority, string $eventType, int|string $index): int

• This method is static. Parameters:

listenerFromString

Resolve a shorthand string as a class name or DI service name.

private static listenerFromString(\PhalconKit\Di\DiInterface $di, string $definition, string $eventType, int|string $index): object|callable

• This method is static. Parameters:

listenerFromService

Resolve a listener from a configured DI service.

private static listenerFromService(\PhalconKit\Di\DiInterface $di, mixed $service, string $eventType, int|string $index): object|callable

• This method is static. Parameters:

listenerFromClass

Instantiate a configured listener class.

private static listenerFromClass(\PhalconKit\Di\DiInterface $di, mixed $class, string $eventType, int|string $index, array<array-key,mixed> $arguments = []): object|callable

• This method is static. Parameters:

finalizeListener

Validate the listener and inject the DI container when supported.

private static finalizeListener(\PhalconKit\Di\DiInterface $di, mixed $listener, string $eventType, int|string $index): object|callable

• This method is static. Parameters: