gacela-project / gacela-env-config-reader

0.4.0 2026-08-17 19:46 UTC

Requires

• php: >=8.3
• gacela-project/gacela: ^2.4
• symfony/dotenv: ^6.4 || ^7.0 || ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.5 || ^12.0
• psalm/plugin-phpunit: ^0.19.7
• symfony/var-dumper: ^6.4 || ^7.0 || ^8.0
• vimeo/psalm: ^6.16

MIT

• Jose Maria Valera Reales
• Jesus Valera Reales

• php
• modular
• kernel

Published on Packagist.org on 2026-08-17 20:48 UTC

README

Load .env configuration files for your Gacela projects.

composer require gacela-project/gacela-env-config-reader

Requirements

PHP	>=8.3
gacela-project/gacela	^2.4
symfony/dotenv	^6.4 || ^7.0 || ^8.0

Gacela 2.0 raised its own PHP floor to 8.3, so this package cannot be used on an older runtime. If your application is still on Gacela 1.x or PHP 8.0–8.2, stay on version 0.3 of this package — see Gacela's upgrade guide for what moving to 2.x involves.

Setup

You can define the reader configuration either in the Gacela::bootstrap() or in a gacela.php file.

Option A)

Define the configuration in a gacela.php file in the root of your project (recommended way):

<?php # gacela.php

use Gacela\Framework\Bootstrap\GacelaConfig;
use Gacela\Framework\Config\ConfigReader\EnvConfigReader;

return static function (GacelaConfig $config): void {
    $config->addAppConfig('config/.env*', 'config/.env.local.dist', EnvConfigReader::class);
};

Option B)

Define all configuration on the fly in the bootstrap itself.

<?php  # public/index.php

use Gacela\Framework\Bootstrap\GacelaConfig;
use Gacela\Framework\Config\ConfigReader\EnvConfigReader;
use Gacela\Framework\Gacela;

$config = static function (GacelaConfig $config): void {
    $config->addAppConfig('config/.env*', 'config/.env.local.dist', EnvConfigReader::class);
};

Gacela::bootstrap($appRootDir, $config);

You can define more than one ConfigReader at once.

$config = static function (GacelaConfig $config): void {
    $config->addAppConfig('config/.env*', 'config/.env.local.dist', EnvConfigReader::class);
    $config->addAppConfig('config/*.php', 'config/local.php');
    $config->addAppConfig('config/*.custom', '', CustomConfigReader::class);
}