Skip to content

ServiceProvider

Registers the framework configuration service.

The provider reads the active bootstrap config, creates a default Bootstrap\Config when none exists, and applies app config values to PhalconKit\Support\Php::set(). This keeps PHP runtime flags synchronized with application configuration during service bootstrap.


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.


config

Optional provider-local config reference for custom subclasses.

protected \PhalconKit\Config\ConfigInterface $config

Methods

register

Register the shared config service.

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

Parameters:

Parameter Type Description
$di \PhalconKit\Di\DiInterface

Throws:

When the bootstrap service is missing or does not implement the PhalconKit bootstrap contract. - ServiceException


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:

Parameter Type Description
$di \PhalconKit\Di\DiInterface

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().