PHP Academy · Aula

Variáveis de ambiente e arquivos .env

Gerencie configurações sensíveis com arquivos .env e bibliotecas dotenv em PHP.

Variáveis de ambiente e arquivos .env é uma aula grátis de PHP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de PHP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de PHP Academy inclui 4 aulas no total.

Por que usar variáveis de ambiente?

Incluir credenciais ou configurações específicas do ambiente diretamente no código-fonte é inseguro e torna as implantações frágeis. As variáveis de ambiente separam a configuração do código.

O arquivo .env

Um arquivo .env contém pares de chave e valor carregados no ambiente durante a inicialização. Adicione-o ao .gitignore: NEVER o envie para o controle de versão.

# .env
APP_ENV=production
APP_KEY=base64:...
DB_HOST=127.0.0.1
DB_NAME=myapp
DB_USER=myapp_user
DB_PASS=supersecret

REDIS_HOST=127.0.0.1
MAIL_HOST=smtp.mailtrap.io

Integração do .env com Laravel

O Laravel usa o vlucas/phpdotenv para carregar .env automaticamente. Acesse os valores com o auxiliar env().

<?php
$host = env("DB_HOST", "127.0.0.1"); // "127.0.0.1" is the default

config() ou env()

Use env() somente nos arquivos config/*.php. Em qualquer outro lugar, use config("database.host"), que funciona corretamente com o armazenamento da configuração em cache.

<?php
// In config/database.php:
"host" => env("DB_HOST", "127.0.0.1")

// In your service classes:
$host = config("database.connections.mysql.host");

Armazenamento da configuração em cache

Armazene a configuração em cache em produção para evitar analisar .env a cada requisição.

$ php artisan config:cache
# After changing .env:
$ php artisan config:clear

PHP puro com phpdotenv

Use o vlucas/phpdotenv fora do Laravel.

$ composer require vlucas/phpdotenv

<?php
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
$host = $_ENV["DB_HOST"];

Variáveis obrigatórias

Exija as variáveis de ambiente obrigatórias durante a inicialização para detectar antecipadamente configurações ausentes.

<?php
$dotenv->required(["DB_HOST", "DB_NAME", "DB_USER", "DB_PASS"]);
$dotenv->required(["DB_PORT"])->isInteger();

Arquivo .env.example

Envie um arquivo .env.example com todos os nomes de variáveis, mas sem valores. Os desenvolvedores copiam-no para .env e preenchem seus próprios valores.

Variáveis de ambiente no nível do servidor

Em produção, defina as variáveis de ambiente no nível do servidor, por meio de arquivos de serviço do systemd, opções --env do Docker ou segredos do Kubernetes, em vez de usar um arquivo .env.

# systemd service:
[Service]
Environment="APP_ENV=production"
Environment="DB_HOST=db.internal"

Gerenciamento de segredos

Para credenciais sensíveis, como chaves de API e certificados, considere usar um gerenciador de segredos: HashiCorp Vault, AWS Secrets Manager ou segredos do GitHub Actions para integração contínua.

Resumo

Armazene toda configuração específica do ambiente em .env. Nunca o envie para o controle de versão. Use config() no código da aplicação e env() somente nos arquivos de configuração. Armazene a configuração em cache em produção com php artisan config:cache.

Verificação rápida

Onde você deve chamar env() em uma aplicação Laravel?

Perguntas Frequentes

A aula “Variáveis de ambiente e arquivos .env” é grátis?

Sim — o texto completo de “Variáveis de ambiente e arquivos .env” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de PHP Academy, atualize para CoddyKit PRO. O curso de PHP Academy inclui 4 aulas no total.

O que vou aprender em “Variáveis de ambiente e arquivos .env”?

Gerencie configurações sensíveis com arquivos .env e bibliotecas dotenv em PHP. Você pratica PHP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar PHP Academy?

Nenhuma experiência prévia é necessária. PHP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Variáveis de ambiente e arquivos .env”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de PHP Academy?

Sim. Cada aula de PHP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para PHP Academy