ServiceProvider

Registers the direct flash messaging service.

The default service uses Phalcon's direct flash adapter, enables auto-escape, and applies Bootstrap-compatible CSS classes. Applications that need session flash behavior should register their own provider intentionally because that changes message lifetime and session requirements.

• Full name: \PhalconKit\Provider\Flash\ServiceProvider
• Parent class: \PhalconKit\Provider\AbstractServiceProvider

Properties

serviceName

Stable DI service name managed by this provider.

protected string $serviceName

This value is part of the provider contract because controllers, tasks, other injectables, and replacement providers resolve services by name. Concrete providers must set it to a non-empty value.

cssStyle

Default CSS classes used for direct flash message types.

protected array<string,string> $cssStyle

Methods

register

Register the shared flash service.

public register(\PhalconKit\Di\DiInterface $di): void

The flash adapter receives DI and auto-escaping before being returned, so controller output can use the service without repeating those safety settings.

Parameters:

Inherited methods

__construct

Stores the DI container and prepares the provider for registration.

public __construct(\PhalconKit\Di\DiInterface $di): mixed

The constructor intentionally requires PhalconKit\Di\DiInterface so providers can rely on typed service helpers during configuration and registration.

Parameters:

Throws:

When a concrete provider does not define a non-empty service name. - LogicException

getName

Returns the DI service name managed by this provider.

public getName(): string

boot

Optional post-registration hook.

public boot(): void

The base implementation is intentionally empty. Custom bootstraps or application code may call this method for provider-specific startup work after all services have been registered.

configure

Optional provider-local configuration hook.

public configure(): void

This runs during construction after DI has been stored and before register() is called. Use it to normalize provider options or prepare lightweight state; service creation belongs in register().