README

FastForward Config is a flexible and modern PHP configuration library built for performance, extendability, and lazy-loading behavior. It supports dot-notation keys, recursive directory loading, Laminas-compliant configuration providers, and optional PSR-16 caching.

✨ Features

• 🔑 Dot notation access: $config->get('app.env')
• 📁 Load from arrays, PHP files, directories, or providers
• 💾 Optional persistence for single PHP files and PSR-16 cache
• ♻️ Lazy-loading with __invoke()
• 🧩 Aggregation of multiple sources
• 🗂 Recursive directory support
• 🔌 Compatible with Laminas ConfigProviders

📦 Installation

composer require fast-forward/config

🚀 Quick Start

Load configuration from multiple sources

use function FastForward\Config\config;

$config = config(
    ['app' => ['env' => 'production']],
    __DIR__ . '/config',
    \Vendor\Package\ConfigProvider::class
);

echo $config->get('app.env'); // "production"

Cache configuration using PSR-16

use function FastForward\Config\configCache;

/** @var \Psr\SimpleCache\CacheInterface $cache */
$config = configCache($cache, ['foo' => 'bar']);

echo $config->get('foo'); // "bar"

Load from a single PHP file (with optional persistence)

use function FastForward\Config\configFile;

$config = configFile(__DIR__ . '/config.php', persistent: true);

$config->set('app.env', 'staging'); // Persists changes back to config.php

Load from a recursive directory

use function FastForward\Config\configDir;

$config = configDir(__DIR__ . '/config', recursive: true);

Use Laminas-style providers

use function FastForward\Config\configProvider;

$config = configProvider([
    new Vendor\Package\Provider1(),
    new Vendor\Package\Provider2(),
]);

🧪 Access & Mutation

$config->set('db.host', 'localhost');
echo $config->get('db.host'); // "localhost"

$config->has('app.debug'); // true/false

print_r($config->toArray());

📁 Directory Structure Example

config/
├── app.php
├── db.php
└── services/
    └── mail.php

🧰 API Summary

• config(...$configs): ConfigInterface
• configFile(string $file, bool $persistent = false, array|ConfigInterface|null $defaultConfig = null): ConfigInterface
• configCache(CacheInterface $cache, ...$configs): ConfigInterface
• configDir(string $rootDirectory, bool $recursive = false, ?string $cachedConfigFile = null): ConfigInterface
• configProvider(iterable $providers, ?string $cachedConfigFile = null): ConfigInterface

🛡 License

MIT © 2025 Felipe Sayão Lobato Abreu