thesnackalicious/multidotenv

Simple per-environment .env files for Laravel 5.

dev-master 2015-06-01 00:29 UTC

Requires

• php: >=5.4.0
• laravel/framework: 5.0.*
• vlucas/phpdotenv: ~1.0

MIT

• James Brauman

• laravel
• environment
• .env

README

Simple per-environment .env files for Laravel 5.

multidotenv is a package for Laravel 5 that provides functionality to load an additional environment-specific .env file.

How it works

Laravel 5 uses the dotenv package to load the .env file in the root directory. multidotenv extends Laravel 5 so that an additional .env file is loaded depending on the environment name.

For example, given a .env file containing:

DB_HOST=localhost
DB_DATABASE=my_project
DB_USERNAME=root
DB_PASSWORD=root

and a .env.testing file containing:

DB_DATABASE=my_project_testing

when running the command php artisan migrate --env=testing the loaded enviroment variables would be:

DB_HOST=localhost
DB_DATABASE=my_project_testing
DB_USERNAME=root
DB_PASSWORD=root

Note that this package will always load '.env.' . $app->environment() if it exists. This is normally what APP_ENV is set to but can be overridden when using artisan by passing the --env flag. If neither of these are true Laravel 5 will use production by default.

What about HTTP requests?

You can leverage the 'always loading' functionality mentioned above to load a per-environment .env file for HTTP requests too.

For example in your .env file set your APP_ENV variable to foo. Now even over HTTP requests the .env.foo file will be loaded if it exists.

Installation

Add thesnackalicious/multidotenv to your composer.json file:

"require": {
  "thesnackalicious/multidotenv": "dev-master"
}

Use composer to install this package.

$ composer update

Update Web Kernel and Console Kernal

Add a bootrappers() function to the app/Http/Kernel.php file and the app/Console/Kernel.php file:

/**
 * Get the bootstrap classes for the application.
 *
 * @return array
 */
protected function bootstrappers()
{
    $search = 'Illuminate\Foundation\Bootstrap\DetectEnvironment';
    $replacement = 'TheSnackalicious\MultiDotEnv\DetectEnvironment';

    return array_map(function($v) use ($search, $replacement) {
        return $v == $search ? $replacement : $v;
    }, $this->bootstrappers);
}