Sail e Herd: o Laravel no seu computador
O Sail e o Herd são ambientes de desenvolvimento oficiais do Laravel, mantidos pela mesma empresa do framework. O Sail roda PHP, banco e Redis em containers Docker descritos num compose.yaml dentro do projeto, enquanto o Herd instala PHP e Nginx direto no macOS ou no Windows e serve cada aplicação num endereço .test.
Ficha e sumário da página
- Referência técnica
- Laravel 13.42.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O Sail: o ambiente dentro do projeto
O Sail é uma interface de linha de comando para o ambiente Docker padrão do Laravel. Ele mora dentro da sua aplicação. O compose.yaml na raiz descreve os containers, enquanto o script sail, instalado em vendor/bin/, traduz os comandos do dia a dia para o Docker. O ponto de partida documentado é um ambiente com PHP, MySQL e Redis, sem exigir experiência anterior com containers.
A instalação acontece pelo Composer, como dependência de desenvolvimento. O comando php artisan sail:install publica o compose.yaml e ajusta o .env com as variáveis de conexão aos serviços escolhidos. O arquivo fica versionado junto com o código, por isso todo desenvolvedor que clona o repositório sobe o mesmo PHP e o mesmo banco com ./vendor/bin/sail up:
minha-app/A aplicação Laravel, com o Sail em require-dev no composer.json.compose.yamlContainers da aplicação e dos serviços, como mysql e redis..envHost, porta e senha de cada serviço, ajustados pelo sail:install.vendor/bin/sailScript que repassa artisan, composer, npm e test ao container.sail upSobe todos os containers descritos no compose.yaml.sail artisanRoda um comando Artisan dentro do container do PHP.sail testExecuta a suíte de testes no mesmo PHP da aplicação.
Com o Sail, o PHP instalado no seu sistema fica de fora. O sail artisan migrate roda a migration com o PHP do container, na versão definida no compose.yaml. Do mesmo jeito, o sail composer require instala uma dependência com o Composer de dentro do container. A mesma lógica vale para o Node: o sail npm run dev compila o frontend sem Node instalado na máquina.
O comando php artisan sail:add acrescenta serviços ao ambiente conforme a aplicação precisa deles. Uma busca textual com o Meilisearch, por exemplo, roda em outro container e recebe as configurações de conexão pelo .env. Você testa a integração no mesmo ambiente Docker usado para executar o PHP, sem instalar o mecanismo de busca diretamente no sistema operacional.
Para trabalhar com arquivos, o RustFS oferece uma API compatível com o S3 no ambiente local, substituindo o acesso ao Amazon S3 durante o desenvolvimento. Cada banco guarda os registros num volume do Docker, que preserva as tabelas quando os containers param. O Sail roda no macOS, no Linux e no Windows pelo WSL2.
O Herd: PHP instalado no sistema
O Herd é um aplicativo nativo para macOS e Windows que instala o PHP e o Nginx no próprio sistema operacional, sem containers. O instalador baixa a versão mais recente do PHP e deixa o Nginx rodando em segundo plano. Junto, vêm as ferramentas de linha de comando php, composer, laravel, expose, node, npm e nvm.
O Herd trabalha com pastas estacionadas. Toda aplicação Laravel dentro de ~/Herd no macOS, ou de %USERPROFILE%\Herd no Windows, ganha um endereço com o nome da pasta e o domínio .test, como minha-app.test. No macOS, o dnsmasq responde a esse domínio local. A troca de versão do PHP e as demais configurações ficam na interface gráfica, aberta pelo ícone na bandeja do sistema.
A versão gratuita cobre PHP, Nginx e as ferramentas de linha de comando. O Herd Pro, pago, acrescenta bancos MySQL, PostgreSQL e Redis criados e administrados pelo próprio Herd, além da visualização dos e-mails enviados em desenvolvimento e do acompanhamento de logs. Sem o Herd Pro, o banco local vem de outra instalação, como o SQLite que acompanha o esqueleto do Laravel.
Sail
- Roda em containers Docker, descritos no
compose.yamldo projeto. - Funciona no macOS, no Linux e no Windows com WSL2.
- Banco, Redis e busca entram como containers, sem custo.
- O ambiente viaja no repositório para todo desenvolvedor do projeto.
Herd
- Instala PHP e Nginx no sistema, sem Docker.
- Funciona no macOS e no Windows.
- Bancos locais e visualização de e-mails ficam no Herd Pro, pago.
- O
herd.ymlpermite compartilhar a configuração do projeto.
Quando cada um faz sentido
O Sail descreve os serviços no compose.yaml versionado com o projeto. Uma aplicação com MySQL, Redis para a fila e Meilisearch para a busca textual sobe com um único comando, usando as imagens e as versões declaradas nesse arquivo. Você compartilha a configuração no repositório e executa os comandos de PHP e Node dentro dos containers, mesmo com outras versões dessas ferramentas instaladas no sistema.
O Herd dispensa a camada do Docker: o PHP roda direto no sistema. Ele combina com projetos que usam SQLite no desenvolvimento ou que já têm um banco instalado à parte. A troca entre versões do PHP acontece pela interface. Com o herd.yml, você também compartilha as configurações do projeto pelo repositório, como as versões de PHP e Node usadas na aplicação.
O Valet e o Homestead
O Herd inclui o Valet, que configura o Nginx para rodar em segundo plano e usa o DnsMasq para responder aos projetos pelo domínio .test, com cerca de 7 MB de RAM segundo a documentação. O Valet continua documentado no Laravel 13, só para macOS e só por linha de comando. O Homestead, uma máquina virtual do Vagrant com o ambiente completo, aparece como pacote legado sem manutenção ativa. A documentação indica o Sail no lugar dele.
O próximo assunto deixa o computador local e entra na aplicação em execução: os painéis oficiais de fila, desempenho e depuração, em Horizon, Pulse e Telescope.