drago-ex / bootstrap

v2.0.3 2026-10-17 13:16 UTC

Requires

• php: >=8.3 <9
• nette/bootstrap: ^3.2
• nette/caching: ^3.2
• nette/utils: ^4.0
• tracy/tracy: ^2.10

Requires (Dev)

• nette/tester: ^2.5
• phpstan/phpstan-nette: ^2.0

MIT

• Zdeněk Papučík

Published on Packagist.org on 2026-10-17 13:27 UTC

README

ExtraConfigurator is a class built on top of Nette Framework's Configurator to simplify loading and caching of configuration files in .neon format. It automatically handles caching in development and production environments.

Requirements

• PHP >= 8.3, < 9
• Nette Framework
• Composer

Installation

Make sure you have Nette Framework installed in your project.

composer require drago-ex/bootstrap

Examples

Adding Configuration Files

To load configuration files from a specified directory:

use Drago\Bootstrap\ExtraConfigurator;

$configurator = new ExtraConfigurator();

// Add configuration files from the 'config' directory
$configurator->addFindConfig(__DIR__ . '/config');

// Access the application (you can configure services, routing, etc.)
$app = $configurator->app();

Adding Multiple Directories

You can also provide multiple directories for configuration files:

$configurator->addFindConfig([
    __DIR__ . '/config/first',
    __DIR__ . '/config/second'
]);

Excluding Files or Directories

You can exclude certain files or directories from being loaded. Each mask is matched against the whole file or directory name, so a file is excluded by its full name and a directory by its name:

// Skips the file exclude.neon
$configurator->addFindConfig(__DIR__ . '/config', 'exclude.neon');

// Skips every file inside the Install directory
$configurator->addFindConfig(__DIR__ . '/config', 'Install');

Loading Order

Found files are added in the order of their file names compared numerically, then by their paths. Later files override earlier ones, so a numeric prefix such as 8.conf.neon or 9.conf.neon controls which configuration wins.

Cache Management

The mode is taken from the configurator, so set it before calling addFindConfig():

$configurator->setDebugMode(false);
$configurator->addFindConfig(__DIR__ . '/config');

• In debug mode, the directories are searched on every call, so new files are found immediately.
• Otherwise, the list of found files is cached in the temp directory. Each combination of paths and exclusions has its own cache entry, so several calls in one application, or separate configurators sharing the temp directory, do not affect each other.
• The cached list does not expire. After adding or removing a .neon file in production, clear temp/cache so the files are searched again.