Pular para o conteúdo
Documentação

Associações e arquivo .env

Cadastre os dados de conexão de banco de dados, Redis e RabbitMQ, teste se o servidor alcança cada um e gere o arquivo .env da aplicação.

R Regis Manze 20/11/2026 5 min de leitura

A tela Associacoes guarda os dados de conexão dos recursos que sua aplicação usa (bancos de dados, Redis e RabbitMQ) e gera, a partir deles, um arquivo .env com as variáveis de ambiente.

As associações não criam bancos nem servidores Redis. Elas apenas registram dados de acesso que você já tem, normalmente enviados pelo administrador.

Adicionar um banco de dados

  1. Clique em Banco de Dados.
  2. Preencha:
Campo Exemplo
Nome principal (apelido para você reconhecer)
Engine MySQL / MariaDB, PostgreSQL, SQLite ou SQL Server
Host localhost ou o endereço do servidor de banco
Porta 3306 (MySQL), 5432 (PostgreSQL)
Database cliente_loja
Usuario cliente_loja
Senha a senha do banco
  1. Clique em Adicionar.

Adicionar Redis

  1. Clique em Redis.
  2. Preencha Nome, Host, Porta (padrão 6379), Senha (se houver) e Database (0-15).
  3. Clique em Adicionar.

Adicionar RabbitMQ

  1. Clique em RabbitMQ.
  2. Preencha Nome, Host, Porta (padrão 5672), Usuario, Senha e VHost (padrão /).
  3. Clique em Adicionar.

Nome e Host são obrigatórios em todos os tipos.

Testar a conexão

Clique em Testar Conexao na linha do recurso. A janela Teste de Conexao mostra:

  • "Conexao com host:porta OK!": o servidor de hospedagem alcança o recurso naquela porta;
  • "Nao foi possivel conectar em host:porta": o endereço, a porta ou um firewall está impedindo o acesso.

O teste só aceita host e porta que estejam cadastrados nas suas associações. Para outro endereço, aparece "Teste permitido so para as suas associacoes.": cadastre a associação antes de testar.

Atenção: o teste só verifica se a porta responde. Ele não confere usuário, senha nem nome do banco. Se o teste passar e a aplicação ainda não conectar, revise as credenciais.

Remover uma associação

Clique em Excluir na linha e confirme. Isso apaga só o registro no painel. O banco, o Redis ou o RabbitMQ continuam existindo.

O .env não vira variável do PHP

O quadro Arquivo .env da aplicação edita um arquivo que a própria aplicação lê (Laravel e outros frameworks com dotenv). O servidor web e o PHP não carregam esse arquivo: o que está nele não aparece em getenv('CHAVE') nem em $_SERVER['CHAVE'].

Se o seu código precisa ler a variável com getenv() ou $_SERVER (por exemplo, MAGE_RUN_CODE no Magento), cadastre-a no botão Variáveis da tela Meus Dominios (seção "Variáveis de ambiente do domínio"). O próprio quadro mostra esse aviso, com link para Meus Dominios.

Escolher a pasta do .env

O quadro Arquivo .env da aplicação mostra e edita o arquivo .env da pasta do projeto, com permissão 600 (só o seu usuário lê). O caminho completo aparece em Arquivo, no topo do quadro.

O painel lê e grava o .env como o seu próprio usuário. Por isso, se o arquivo (ou a pasta) pertencer a outro usuário ou estiver sem permissão de escrita para você, o salvamento falha: peça ao administrador para usar Corrigir permissões.

  1. Em Pasta do projeto (onde a aplicacao le o .env), digite a pasta relativa à sua pasta pessoal, por exemplo public_html.
  2. Clique em Usar esta pasta.

A partir daí, o .env é lido e gravado em /home/usuario/<pasta>/.env. A pasta precisa existir dentro da sua pasta pessoal e não pode ser um link.

Se o campo estiver vazio, o painel decide sozinho (detecção automática):

  • se existir um projeto Laravel em public_html (arquivo public_html/artisan) e ainda não existir ~/.env, usa public_html/.env;
  • nos outros casos, usa ~/.env, na raiz da sua pasta pessoal.

No modo automático, o campo aparece vazio, com a pasta detectada como sugestão (por exemplo, "automatico: public_html").

Para voltar ao automático depois de ter escolhido uma pasta, apague o conteúdo do campo e clique em Usar esta pasta.

Gerar o arquivo .env

  1. Cadastre as associações.
  2. Clique em Gerar das Associacoes e confirme. O conteúdo atual do quadro é substituído.
  3. Revise e complete o texto (ex.: APP_KEY, APP_URL).
  4. Clique em Salvar.

Variáveis geradas, no padrão do Laravel:

Recurso Variáveis
Primeiro banco DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD
Primeiro Redis REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_DB
Primeiro RabbitMQ RABBITMQ_HOST, RABBITMQ_PORT, RABBITMQ_USER, RABBITMQ_PASSWORD, RABBITMQ_VHOST

Do segundo item em diante, o nome ganha o apelido. Exemplo: um banco chamado relatorios gera DB_RELATORIOS_HOST, DB_RELATORIOS_PORT e assim por diante.

Usar o .env na sua aplicação

O Laravel e a maioria dos frameworks leem o .env da pasta do projeto. Por isso, em Pasta do projeto, escolha a pasta onde a aplicação está (no Laravel, a pasta que tem o arquivo artisan, normalmente public_html). Assim o que você salvar no quadro Arquivo .env da aplicação já vale para o projeto.

Dica: no Laravel, rode php artisan config:clear (ou config:cache) depois de cada mudança no .env.

Atenção: o .env contém senhas. Nunca deixe uma cópia dentro da pasta pública do domínio (por exemplo, public_html/public) nem envie para o repositório Git.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!