Como instalar e configurar no PATH o Laravel Installer

O Laravel Installer continua sendo a forma mais rápida de criar projetos com laravel new. Porém, basta esquecer de atualizar o PATH para que o comando pareça inexistente. Abaixo está o passo a passo que sempre usei em workshops e nos ambientes da agência.

1. Requisitos

• PHP 8.1+ com extensões openssl, mbstring, tokenizer e xml.
• Composer atualizado (composer self-update).
• Acesso de escrita ao diretório ~/.config/composer (Linux/macOS) ou %APPDATA%\Composer (Windows).

Dica: execute composer diagnose antes de continuar. O comando já sinaliza problemas de SSL, proxies e permissões.

2. Instalação pelo Composer Global

composer global require laravel/installer

O Composer instala o binário em ~/.config/composer/vendor/bin/laravel no Linux/macOS e em %APPDATA%\Composer\vendor\bin\laravel.bat no Windows.

3. Ajustando o PATH no macOS e Linux

1. Identifique o shell padrão com echo $SHELL.
2. Abra o arquivo de configuração correspondente:
   • ~/.zshrc ou ~/.zprofile para zsh;
   • ~/.bash_profile ou ~/.bashrc para bash.
3. Acrescente a linha:

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

4. Recarregue o shell: source ~/.zshrc (ou equivalente).
5. Teste com laravel --version.

Se utilizar ferramentas como asdf, lembre-se de exportar o caminho dentro do arquivo .tool-versions ou do hook de inicialização da ferramenta.

4. Ajustando o PATH no Windows

1. Abra Configurações → Sistema → Sobre → Configurações avançadas do sistema.
2. Clique em Variáveis de Ambiente e edite Path na seção do usuário.
3. Acrescente %APPDATA%\Composer\vendor\bin (sem remover valores existentes).
4. Abra um novo terminal PowerShell e rode laravel --version.

Quem utiliza o Windows Terminal pode criar um profile com o comando refreshenv do Chocolatey para garantir que o PATH seja recarregado ao abrir uma nova aba.

5. Validando o comando laravel

Depois de ajustar o PATH, rode:

laravel new blog
cd blog
php artisan --version

Você deverá visualizar a versão instalada e os arquivos iniciais do framework. Exclua a pasta se o diretório foi criado apenas para teste.

6. Solução de problemas frequentes

Sintoma	Correção
laravel: command not found mesmo após editar o PATH	Confirme se o shell atual lê o arquivo editado e se o terminal foi reiniciado.
Permission denied ao instalar o pacote global	Remova instalações antigas usando sudo rm -rf ~/.config/composer e repita o processo sem sudo.
Proxy corporativo bloqueando o Composer	Configure composer config -g http-basic.repo.packagist.com usuario senha ou defina HTTP_PROXY.

Com o instalador funcionando, você pode criar esqueletos Laravel com cache de configuração e testes já habilitados, ganhando minutos em cada projeto novo.