Definindo novas variáveis de ambiente no Laravel

Um dos aspectos mais importantes de qualquer projecto em Laravel, ou se calhar em PHP no geral, são as variáveis de ambiente. É  a partir destas variáveis é que é possivel atribuir diferentes configurações para diferentes ambientes em que o sistema será executado(desenvolvimento, testes, produção, etc). E no Laravel, existem passos específicos para definir uma nova variável de ambiente, que são:

1 – Inserir a chave da variável em .env.example

O ficheiro .env.example serve apenas para que seja possivel compartilhar as chaves existentes no seu ficheiro .env com os restantes colaboradores do seu projecto, uma vez que o ficheiro .env nunca deve ser inserido no seu sistema de controle de versão(git, github,etc), por conter dados sensiveis e específicos para o seu ambiente de execução do sistema. Assim, para cada nova variável criada, é necessário inserir a chave no ficheiro .env.example para que futuros colaboradores tenham ideia de quais variáveis são necessárias para executar o seu sistema.

2 – Inserir a chave e o valor no seu ficheiro .env

Após inserir a chave no ficheiro .env.example é necessário que insira a chave e o valor no ficheiro .env, para que o Laravel saiba qual o valor da sua variável. Por exemplo, se quisermos defnir o idioma padrão do nosso sistema, basta inserir no ficheiro .env:

IDIOMA_PADRAO=Portugues

3 – Inserir a nova variável em algum ficheiro de configuração

O Laravel possui vários ficheiros de configuração, que ficam localizados no directório “config”. Em qualquer um destes ficheiros, ou  então num novo ficheiro no mesmo directorio, podemos definir a nova variável para que possa ser lida pelo Laravel. Por exemplo, se usarmos o ficheiro config/app.php, poderiamos definir a nova variavel como sendo:

‘idioma’=>env(‘IDIOMA_PADRAO’,’Portugues’);

Ai estamos a dizer que para a variável de configuração “idioma”, o Laravel deve ler o valor de “IDIOMA_PADRAO” do ficheiro .env ou então, caso “IDIOMA_PADRAO” não esteja definido no ficheiro .env, o Laravel assume Portugues como idioma padrão.

4 – Usar a nova variável no sistema

A partir dai, sempre que quisermos usar a variavel idioma padrão, iremos usar a funcção config(‘app.idioma’); e nunca usar a função env() dentro do projecto, para além dos ficheiros de configuração.