RecordConfig
Default permission fragment for generic record resources.
The fragment grants regular users read access and administrators management access. Administrative behavior skips identity and soft-delete filters so metadata/record maintenance views can inspect the full dataset.
- Full name:
\PhalconKit\Bootstrap\Permissions\RecordConfig - Parent class:
\PhalconKit\Config\Config
Methods
__construct
Merge the record permission fragment with caller-provided config.
public __construct(array<string,mixed> $data = [], bool $insensitive = true): mixed
Parameters:
| Parameter | Type | Description |
|---|---|---|
$data | array | Permission overrides or extensions. |
$insensitive | bool | Whether config keys should be case-insensitive. |
Inherited methods
pathToArray
Resolve a config path and normalize the result to an array.
public pathToArray(string $path, array|null $defaultValue = null, string|null $delimiter = null): array|null
null is preserved so callers can distinguish a missing optional path from a configured scalar value. Native Phalcon config objects are converted through toArray(), and any other non-null value is cast to an array.
Parameters:
| Parameter | Type | Description |
|---|---|---|
$path | string | Path understood by Phalcon's native path() method. |
$defaultValue | array|null | Default returned when the path is |
| missing. | ||
$delimiter | string|null | Optional path delimiter. |
Return Value:
Normalized array value, or null when the path resolves to null.
merge
Merge data into this config instance.
public merge(array|\Phalcon\Config\ConfigInterface $toMerge, bool $append = false): \Phalcon\Config\ConfigInterface
When $append is false, native Phalcon merge behavior is used. When $append is true, numeric-keyed values are appended while associative values are replaced recursively. This is useful for framework config fragments such as provider lists, permission features, and default seed data where applications need to extend list values instead of replacing the whole list.
Parameters:
| Parameter | Type | Description |
|---|---|---|
$toMerge | array|\Phalcon\Config\ConfigInterface | Data to merge into this |
| config. | ||
$append | bool | Use PhalconKit append-aware merge semantics. |
Return Value:
The current mutated config instance.
Throws:
When append mode receives a value that cannot be converted to an array. - InvalidArgumentException
internalMergeAppend
Append-merge two arrays recursively.
final protected internalMergeAppend(array $source, array $target): array
Integer keys are appended to preserve list-style config fragments. String keys replace existing values unless both sides contain arrays, in which case the merge recurses.
- This method is final. Parameters:
| Parameter | Type | Description |
|---|---|---|
$source | array | Base config data. |
$target | array | Incoming config data. |
Return Value:
Merged config data.
getDateTime
Return a modified immutable date.
public getDateTime(string $modifier, \DateTimeImmutable|null $dateTime = null): \DateTimeImmutable
This helper keeps date-modifier config strongly typed in lifecycle and retention code. When no base date is provided, the current time is used.
Parameters:
| Parameter | Type | Description |
|---|---|---|
$modifier | string | Date/time modifier accepted by |
DateTimeImmutable::modify(), such as -1 month or +7 days. | ||
$dateTime | \DateTimeImmutable|null | Optional base date. |
Return Value:
Modified date.
Throws:
If the modifier cannot be parsed. - DateMalformedStringException