ddrv/env

Read variables from environment or .env file

Maintainers

Details

github.com/ddrv/php-env

Source

Issues

Fund package maintenance!
Other

v2.0.0 2022-08-24 01:41 UTC

This package is auto-updated.

Last update: 2024-10-24 06:58:31 UTC


README

Read variables from environment or .env file

Install

composer require ddrv/env:^2.0

Usage

# /path/to/project/.env

APP_VAR_3=value3
<?php

use Ddrv\Env\Env;
use Ddrv\Env\VariableProvider\EnvVariableProvider;
use Ddrv\Env\VariableProvider\FileVariableProvider;

/*
 * $_ENV = [
 *     'APP_VAR_1' => 'value1',
 *     'APP_VAR_2' => 'value2',
 * ];
 */


$env = new Env(
    new EnvVariableProvider(),
    new FileVariableProvider('/path/to/project/.env'),
);

$env->get('APP_VAR_1'); // returns 'value1'
$env->get('APP_VAR_2'); // returns 'value2'
$env->get('APP_VAR_3'); // returns 'value3'
$env->get('APP_VAR_4'); // returns null
$env->get('APP_VAR_5', 'defaultValue'); // returns 'defaultValue'

Prefixes

<?php

use Ddrv\Env\Env;
use Ddrv\Env\VariableProvider\EnvVariableProvider;
use Ddrv\Env\VariableProvider\FileVariableProvider;
use Ddrv\Env\VariableProvider\PrefixedVariableProvider;

/*
 * $_ENV = [
 *     'APP_VAR_1' => 'value1',
 *     'APP_VAR_2' => 'value2',
 * ];
 */


$env = new Env(
    new PrefixedVariableProvider(new EnvVariableProvider(), 'APP_'),
    new PrefixedVariableProvider(new FileVariableProvider('/path/to/project/.env'), 'APP_'),
);

$env->get('VAR_1'); // returns 'value1'
$env->get('VAR_2'); // returns 'value2'
$env->get('VAR_3'); // returns 'value3'
$env->get('VAR_4'); // returns null
$env->get('VAR_5', 'defaultValue'); // returns 'defaultValue'