Manager

Default in-memory option manager.

The manager is a thin adapter around the Options trait. It exists for code that wants a concrete service/object implementing both the full option lifecycle and the shorter get/set/remove/reset/clear manager contract.

Full name: \PhalconKit\Support\Options\Manager
This class implements: \PhalconKit\Support\Options\ManagerInterface, \PhalconKit\Support\Options\OptionsInterface

Methods

get

Return an option value or the provided default when it is not set.

public get(string $key, mixed $default = null): mixed

Parameters:

Parameter	Type	Description
`$key`	string
`$default`	mixed

has

Return true when an option is present and not null.

public has(string $key): bool

Parameters:

Parameter	Type	Description
`$key`	string

set

Store or replace an option value.

public set(string $key, mixed $value = null): void

Parameters:

Parameter	Type	Description
`$key`	string
`$value`	mixed

remove

Remove one option value when it exists.

public remove(string $key): void

Parameters:

Parameter	Type	Description
`$key`	string

reset

Restore the manager to its default option set.

public reset(): void

clear

Remove all current option values.

public clear(): void

Inherited methods

__construct

Construct the object and initialize its options.

public __construct(array<string,mixed>|null $options = null): mixed

Parameters:

Parameter	Type	Description
`$options`	array\|null	Defaults to capture and apply.

initializeOptions

Capture defaults, apply the current options, and run initialize().

public initializeOptions(array<string,mixed>|null $options = null): void

Parameters:

Parameter	Type	Description
`$options`	array\|null	Defaults to capture and apply.

initialize

Optional hook called after options are initialized.

public initialize(): void

Override this in classes that need to derive internal state from options during construction.

setOptions

Replace or merge the current option set.

public setOptions(array<string,mixed> $options, bool $merge = false): void

Options intentionally use PHP's null-coalescing read semantics: a key stored with a null value remains present in the raw option array, but

See: \PhalconKit\Support\Options\getOption() returns the caller default and
See: \PhalconKit\Support\Options\hasOption() reports false for that key.

Parameters:

Parameter	Type	Description
`$options`	array	Options to apply.
`$merge`	bool	Whether to merge into existing options instead of
replacing them.

getOptions

Return the current option set.

public getOptions(): array<string,mixed>

setOption

Store or replace one option value.

public setOption(string $key, mixed $value = null, bool $merge = false): void

Passing null stores the key in the raw option array, but the key still reads as missing through

See: \PhalconKit\Support\Options\getOption() and
See: \PhalconKit\Support\Options\hasOption(). This preserves the historical contract where null means "fall back to the caller default" while still allowing callers to inspect raw options.

Parameters:

Parameter	Type	Description
`$key`	string
`$value`	mixed
`$merge`	bool	Whether to merge the key/value pair into the existing
option array.

getOption

Return one option value or a default when it is missing or null.

public getOption(string $key, mixed $default = null): mixed

Parameters:

Parameter	Type	Description
`$key`	string
`$default`	mixed	Default returned when the option is not set.

hasOption

Return true when an option is present and not null.

public hasOption(string $key): bool

This intentionally mirrors

See: \PhalconKit\Support\Options\getOption() rather than array_key_exists(): null-valued options are stored in the raw option array but are treated as absent by the public lookup helpers.

Parameters:

Parameter	Type	Description
`$key`	string

removeOption

Remove one option key when it exists in the raw option array.

public removeOption(string $key): void

Removal uses array_key_exists() instead of isset() so callers can delete a key even when it currently stores null.

Parameters:

Parameter	Type	Description
`$key`	string

resetOptions

Restore current options to the initialized defaults.

public resetOptions(): void

clearOptions

Remove all current option values.

public clearOptions(): void