mj-zana / configuration

v2.1.0 2026-10-25 20:32 UTC

Requires

• php: ^8.5
• mj-zana/container: ^2.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

MIT

• configuration
• config
• environment
• dotenv
• zana

Published on Packagist.org on 2026-10-25 20:42 UTC

README

Configuration from PHP files, .env files and environment variables, merged into one immutable tree, with typed accessors and #[Config] injection. Requires PHP 8.5 or later.

composer require mj-zana/configuration

Usage

use Zana\Configuration\{ConfigurationBuilder, DotEnv};

DotEnv::load(__DIR__ . '/.env');          // never overrides real environment variables

$config = (new ConfigurationBuilder())
    ->addDirectory(__DIR__ . '/config')   // config/database.php → database.*
    ->addEnvironment()                     // APP_DATABASE__HOST=db → database.host
    ->build();

$config->get('database.connections.main.host', 'localhost');
$config->int('database.port');            // typed; throws on a missing key or wrong type
$config->section('database')->all();

Later sources win. Associative arrays merge recursively; lists and scalars are replaced whole. Environment values true, false, null and numbers are converted to their types.

Injection

use Zana\Configuration\{Config, ConfigValueProvider};

final class Mailer
{
    public function __construct(#[Config('mail.host')] private string $host, #[Config('mail.port')] private int $port = 25) {}
}

$services->addParameterProvider(new ConfigValueProvider($config));

zana/core registers the provider automatically.

Caching

ConfigurationCache::write($path, $config);   // atomic
$config = ConfigurationCache::load($path) ?? $builder->build();

License

MIT — see LICENSE.