phpsoftbox/config

Config component for the PhpSoftBox framework

dev-master 2026-08-03 19:39 UTC

Requires

• php: ^8.4
• phpsoftbox/collection: dev-master
• phpsoftbox/storage: dev-master
• psr/simple-cache: ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• phpsoftbox/cache: dev-master
• phpsoftbox/cli-app: dev-master
• phpsoftbox/cs-fixer: ^1.1.0
• phpsoftbox/encryptor: dev-master
• phpunit/phpunit: ^11.2

MIT

• Anton K.

Published on Packagist.org on 2026-08-03 19:39 UTC

README

Компонент для чтения и объединения конфигурации с поддержкой вложенных ключей и слоёв окружений.

Установка

composer require phpsoftbox/config

Быстрый старт

<?php

declare(strict_types=1);

use PhpSoftBox\Config\Config;
$config = new Config(sources: [
    ['app' => ['name' => 'demo'], 'debug' => false],
    fn () => ['debug' => true],
]);

$name = $config->get('app.name'); // demo
$debug = $config->get('debug');   // true

Config хранит только конфигурационные данные. Окружение приложения, его сравнение и effective debug предоставляет компонент phpsoftbox/application через ApplicationEnvironment.

ConfigFactory принимает строковый идентификатор окружения только для выбора конфигурационного слоя и формирования cache key:

$config = new ConfigFactory(environment: 'dev')->create();

Произвольные ключи app.env и app.debug не имеют специальной семантики.

Документация

• docs/01-usage.md — доступ к значениям, read-only, ArrayAccess
• docs/02-merge-options.md — слияние источников и merge options
• docs/03-config-factory.md — ConfigFactory и переменные окружения
• docs/04-encrypted-value.md — интеграция с EncryptedValue

Настройки в БД вынесены в отдельный компонент:

• phpsoftbox/db-config

CLI

php psb config:encrypt "secret" --cipherKey="your-key"
php psb config:decrypt "ciphertext" --cipherKey="your-key"

Если --cipherKey не указан, используется APP_KEY из окружения.