README

Lightweight PHP array config file loader

• Dot-notation value access
• Multiple config files
• Default fallback values
• Safe key existence checks
• Filename-based config namespaces

Installation

composer require oasys/config

Quick start

config/app.php

<?php declare(strict_types=1);

return [
    'name'     => 'myApp',
    'origin'   => 'http://localhost/',
    'dev_mode' => true
];

index.php

<?php declare(strict_types=1);

use Oasys\Config\ArrayConfig;

$config = new ArrayConfig(
    __DIR__ . '/config/app.php'
);

$value = $config->get('app.name');

"myApp"

Config files

Each config file must return an array

The filename without extension becomes the top-level config key

You can group values by indenting an array

config/db.php

<?php declare(strict_types=1);

return [
    'driver'   => 'mysql',
    'host'     => 'localhost',
    'database' => 'myapp_dev',
    'username' => 'johndoe',
    'password' => 'secret',
    'encoding' => [
        'charset'   => 'utf8mb4',
        'collation' => 'utf8mb4_general_ci'
    ]
];

Usage

You can supply multiple config files

<?php declare(strict_types=1);

use Oasys\Config\ArrayConfig;

$config = new ArrayConfig(
    __DIR__ . '/config/app.php',
    __DIR__ . '/config/db.php'
);

Dot notation

$config->get('db.driver');

"mysql"

$config->get('db.encoding.charset');

"utf8mb4"

Default value

$config->get('db.port', 3306);

3306

Existence check

$config->has('db.password');

true

$config->has('db.port');

false

Full export

$config->all();

[
    'app' => [
        'name'     => 'myApp',
        'origin'   => 'http://localhost/',
        'dev_mode' => true
    ],

    'db' => [
        'driver'   => 'mysql',
        'host'     => 'localhost',
        'database' => 'myapp_dev',
        'username' => 'johndoe',
        'password' => 'secret',
        'encoding' => [
            'charset'   => 'utf8mb4',
            'collation' => 'utf8mb4_general_ci'
        ]
    ]
]

Design notes

• Config files are loaded in the provided order
• Same filename overwrites the previous mapping
• Empty get('') key returns the full config array
• Missing key without default value returns null
• Missing files, unreadable files, and files that do not return arrays throw exceptions