Pular para o conteúdo principal

Solução de problemas

Domínios .test não resolvem​

O LaraEnv precisa de privilégios de Administrador para editar o arquivo hosts em C:\Windows\System32\drivers\etc\hosts. Se seus domínios .test não resolverem, reinicie o LaraEnv como Administrador para que ele possa modificar o arquivo hosts. Veja Caminhos e Portas.

Porta já em uso​

Um serviço não consegue se vincular porque outro processo está usando a porta. Abra a ferramenta Portas para localizar e encerrar o processo. As portas comuns são 80, 443, 3306, 5432, 6379, 1025 e 8025.

Erros 504 ou timeouts em requisições longas / uploads grandes​

Aumente os limites relevantes em Configurações → Serviços (Ajuste de serviços):

  • fastcgi_read_timeout
  • client_max_body_size
  • PHP upload_max_filesize, post_max_size e max_execution_time

Aviso de SSL no navegador em .test​

Confira a identidade e a confiança da CA local nas configurações. O LaraEnv assina certificados locais com sua própria CA; a edição instalada tenta confiar nela automaticamente, enquanto cópias portáteis exigem confiança explícita. Investigue falhas de verificação da confiança ou outros problemas de certificado antes de tentar novamente. Veja Virtual hosts.

Um projeto precisa de atenção no Site Doctor​

Leia a verificação individual e sua orientação, depois execute novamente o diagnóstico após resolver o problema. Um MySQL local parado pode gerar aviso de banco mesmo que nenhuma página tenha consultado o banco recentemente. Sugestões opcionais de storage não prejudicam a saúde do projeto. Verificações inconclusivas ficam como não verificadas, em vez de falhas confirmadas. Veja Site Doctor.

Um serviço não inicia​

  • Verifique os logs do serviço no Dashboard.
  • Certifique-se de que o Visual C++ Redistributable está instalado.
  • Certifique-se de que apenas um servidor web está usando a porta 80/443.

Dois servidores web em conflito​

Execute Nginx ou Apache, não os dois — eles não podem ocupar as portas 80 e 443 ao mesmo tempo.

Senha de sincronização da nuvem esquecida​

A senha de sincronização não é recuperável. Se você a esquecer, os dados criptografados não poderão ser descriptografados e não há forma de recuperá-los. Veja Sincronização na nuvem.

Migrando do Laragon, XAMPP ou Herd​

Aponte seus projetos para C:\laraenv\www\, escolha a versão do PHP por projeto e deixe o LaraEnv gerar os vhosts para você.