kennisnet / symfony-env-loader

2.0.0 2026-10-06 12:04 UTC

Requires

• php: ^8.1

Requires (Dev)

• symfony/dotenv: ^5.1
• symfony/property-access: ^5.1
• symfony/serializer: ^5.1
• symfony/validator: ^5.4

MIT

Published on Packagist.org on 2026-10-06 12:05 UTC

README

This package let's you load env files on a tier based setup. You can have the following files depending on you environments:

.env .env.dist .env.dev .env.test .env.staging .env.production .env.local

The .env.local should have at least a APP_ENV=dev file in order for the package to fetch the correct dev env file for you local development environment.

Furthermore you have to create a bootstrap.php file in your config folder in order to call the EnvironmentVars class. And put this in your bootstrap.php:

require dirname(__DIR__).'/vendor/autoload.php';

use Kennisnet\DTO\AppEnv;
use Kennisnet\Env\EnvironmentVars;

$basePath = dirname(__DIR__);
EnvironmentVars::setAppEnvClassName(AppEnv::class);
EnvironmentVars::loadEnv($basePath);

Lastly replace the autoload.php line with bootstrap.php in your public/index.php file Here is a example:

public/index.php require dirname(__DIR__).'/config/bootstrap.php';

Upgrading to 2.0

2.0 drops the doctrine/annotations dependency: SecretValue is now a PHP attribute (PHP 8.1+). In your AppEnv DTO replace the docblock annotation with the attribute; the import stays the same:

use Kennisnet\Env\Annotation\SecretValue;

#[SecretValue]
public $DATABASE_URL;

SecretValue::hasAnnotation() is replaced by SecretValue::isSetOn().

Validate your AppEnv with a validator that reads constraints from attributes. Inside a Symfony application the framework's validator already does. A standalone ValidatorBuilder needs:

• Symfony 6.4+: $builder->enableAttributeMapping();
• Symfony 5.4: $builder->enableAnnotationMapping(true); (true skips the Doctrine annotation reader, attributes are still read)