Pular para o conteúdo principal

Instalação

O LaraEnv roda no Windows 10 e no Windows 11, x64. Escolha a edição instalada ou portátil e baixe pelo app os runtimes e serviços necessários aos seus projetos.

Versões do código e do binário

O código desktop Apache-2.0 atual permite o uso local sem conta ou plano LaraEnv. O binário 0.5.7 existente pode anteceder essa mudança. Leia as notas da versão escolhida; esta atualização do site não substitui os artefatos publicados. Para usar o código atual, siga o guia de desenvolvimento.

Requisitos​

  • Windows 10 ou Windows 11, x64
  • Runtime WebView2 — incluído no Windows 11 e disponível para o Windows 10.

Download​

Você pode obter o LaraEnv em dois lugares:

Cada release inclui três artefatos do aplicativo e os respectivos arquivos de checksum .sha256:

  • LaraEnv-<versão>.msi — o instalador recomendado para Windows.
  • LaraEnv-<versão>-portable-win64.zip — a edição portátil. Extraia o ZIP e mantenha o marcador .laraenv-portable ao lado de LaraEnv.exe.
  • LaraEnv.exe — o executável usado pelo atualizador. Esse arquivo sozinho não constitui a edição portátil.
dica

A maioria dos usuários deve escolher o instalador MSI. Ele registra o aplicativo no Windows e cria atalhos no Menu Iniciar e na Área de Trabalho.

Instalação​

  1. Execute o LaraEnv-<versão>.msi. O instalador coloca o aplicativo em Arquivos de Programas.
  2. Projetos, configuração e runtimes baixados usam C:\laraenv\ por padrão. Instale as versões necessárias em Downloads no app.
  3. Atalhos no Menu Iniciar e na Área de Trabalho são criados para facilitar a abertura do LaraEnv.

Edição portátil​

Extraia o ZIP portátil em uma pasta própria e execute LaraEnv.exe ali. O ambiente permanece nessa pasta enquanto o marcador .laraenv-portable estiver presente. Escolha um caminho separado de C:\laraenv: o Windows considera C:\LaraEnv o mesmo caminho.

A cópia portátil pede autorização antes de confiar na sua autoridade HTTPS local no Windows. Confira Configurações → Serviços → HTTPS local quando quiser que o navegador confie naquela cópia. Copiar a pasta não transfere a confiança de certificados do Windows para outra máquina.

Primeira execução e privilégios de Administrador​

Na primeira vez que você abrir o LaraEnv, o Windows exibe um aviso de UAC pedindo privilégios de Administrador. Aprove-o.

aviso

Os privilégios de Administrador são necessários porque o LaraEnv edita o arquivo hosts do Windows em C:\Windows\System32\drivers\etc\hosts para direcionar os domínios dos seus projetos locais para 127.0.0.1.

Atualizações​

O LaraEnv tem um atualizador integrado (detalhado mais adiante). Ele:

  1. Verifica nos releases do GitHub se há uma versão mais nova.
  2. Confere o download com uma soma de verificação SHA-256.
  3. Usa o fluxo de instalação ou de atualização portátil conforme sua edição. Feche o app quando o instalador solicitar.

Desinstalação​

Para remover o LaraEnv, use o caminho padrão do Windows: Configurações → Aplicativos → Aplicativos e recursos (ou Painel de Controle → Programas e Recursos), localize o LaraEnv e clique em Desinstalar.

A desinstalação do aplicativo preserva o ambiente em C:\laraenv. Mantenha projetos e bancos ao substituir uma versão de teste ou reinstalar. Na edição portátil, preserve a pasta extraída se precisar dos dados dela.

Próximos passos​

Com o LaraEnv instalado, continue para a Configuração inicial.