title	Environment Variables
description	Loading environment variables from a .env file

Environment Variables

Introduction
Installation
Retrieving Environment Variables
Environment Variables in a Build

Introduction

It is often helpful to have different configuration values based on the environment in which your application is running, or to keep credentials out of your source control. To make this a cinch, Laravel Zero uses the DotEnv PHP library, which loads environment variables from a .env file at the root of your project.

Installation

You may scaffold the required files using the app:install Artisan command:

php application app:install dotenv

The installer creates a .env file and a matching .env.example file at the root of your project, and adds .env to your .gitignore file.

Note: Your .env file should not be committed to source control. Each developer using your application may require a different environment configuration, and committing the file would be a security risk if it contains sensitive credentials. The .env.example file, on the other hand, should be committed, so your team can see which variables your application expects.

Retrieving Environment Variables

Assuming your .env file contains the following:

TMDB_KEY=234567

You may retrieve the value using the env helper. The second argument passed to the env function is the "default value", which will be returned if no environment variable exists for the given key:

$key = env('TMDB_KEY');

$key = env('TMDB_KEY', 'default-key');

Note: As in Laravel, you should only call the env helper from within your configuration files. Elsewhere in your application, read the value through the config helper instead.