Laravel 12: o que muda no seu projeto e como migrar a partir do 11
Laravel 12, lançado em fevereiro de 2025, é uma atualização de manutenção: quase nada quebra no código, mas a política de versões já deixou o Laravel 11 sem suporte e o Laravel 13 ocupa o lugar de versão ativa.
Este texto mostra o que muda de fato ao sair do Laravel 11 para o Laravel 12, com base nas release notes oficiais, e fecha com o roteiro de comandos para atualizar um projeto existente. Os comandos foram conferidos contra o composer.json da branch 12.x do framework, que aceita PHP 8.2 a 8.5.
Onde cada versão está hoje
Hoje, 17 de novembro de 2026, o quadro de suporte do Laravel já mudou bastante desde o lançamento do 12. O Laravel 11 saiu em março de 2024, parou de receber correções de bugs em setembro de 2025 e teve as correções de segurança encerradas em 12 de março de 2026: quem ainda roda Laravel 11 em produção está sem nenhum patch oficial.
O Laravel 12, lançado em 24 de fevereiro de 2025, também já passou da janela de bug fixes (encerrada em 13 de agosto de 2026) e está na fase só de segurança, até 24 de fevereiro de 2027. O Laravel 13 chegou no primeiro trimestre de 2026 e é hoje a versão que recebe manutenção ativa.
| Versão | PHP suportado | Lançamento | Fim dos bug fixes | Fim da segurança |
|---|---|---|---|---|
| 10 | 8.1 - 8.3 | 14/02/2023 | 06/08/2024 | 04/02/2025 |
| 11 | 8.2 - 8.4 | 12/03/2024 | 03/09/2025 | 12/03/2026 |
| 12 | 8.2 - 8.5 | 24/02/2025 | 13/08/2026 | 24/02/2027 |
| 13 | 8.3 - 8.5 | Q1 2026 | Q3 2027 | Q1 2028 |
A regra de negócio por trás da tabela é simples: toda versão major do Laravel segue Semantic Versioning, sai por volta do primeiro trimestre de cada ano, recebe correções de bug por 18 meses e correções de segurança por 2 anos. Isso significa que mesmo quem está satisfeito com o Laravel 12 precisa, cedo ou tarde, olhar para o 13: já não há mais correção de bug chegando para a versão 12, só patch de segurança.
O que realmente muda: quase nada no código
A própria documentação do Laravel 12 chama o release de "maintenance release": o esforço do time nesse ciclo foi reduzir quebras, não introduzir API nova. Na prática, a maioria dos projetos Laravel 11 sobe para o 12 sem alterar uma linha de código de aplicação, só o composer.json e as dependências de terceiros que travam numa versão específica do framework.
Há uma ressalva que pega gente desatenta: argumentos nomeados (named arguments) do PHP não entram na garantia de compatibilidade retroativa do Laravel. Se o seu código chama um método interno do framework usando a sintaxe metodo(nome: $valor), o nome do parâmetro pode mudar numa atualização, mesmo que seja release minor. Isso não é exclusivo do Laravel 12, mas vale reforçar antes de qualquer migração: named arguments usados em código próprio são seguros, os usados ao chamar métodos do framework não têm essa garantia.
PHP 8.2 a 8.5: faixa mais larga, nada removido
O Laravel 11 suportava PHP 8.2 a 8.4. O Laravel 12 estende essa faixa para 8.2 a 8.5, sem derrubar nenhuma versão mínima. Quem já estava em PHP 8.2, 8.3 ou 8.4 não precisa trocar de versão do PHP para subir o framework; quem quer aproveitar os recursos novos do PHP 8.5 agora tem oficialmente essa opção.
Para quem for testar o projeto já em PHP 8.5, vale consultar a página de migração do próprio php.net antes de trocar o .phpstorm ou o pipeline de CI:
https://www.php.net/manual/en/migration85.php
Ela lista linha a linha o que mudou de comportamento entre 8.4 e 8.5, que é informação do PHP, não do Laravel, e o framework não reproduz isso nas próprias release notes.
Breeze e Jetstream aposentados, quatro starter kits novos
A mudança mais visível do Laravel 12 não é no núcleo do framework, é nos starter kits. Laravel Breeze e Laravel Jetstream, que serviam de scaffolding de autenticação desde versões bem anteriores, pararam de receber atualizações a partir deste release. Eles continuam funcionando nos projetos que já os usam, só não ganham mais features nem correções.
No lugar entraram quatro starter kits novos, para React, Svelte, Vue e Livewire:
- React, Svelte e Vue: usam Inertia 2, TypeScript, a biblioteca de componentes
shadcn/uie Tailwind. - Livewire: usa a biblioteca de componentes
Flux UI(também baseada em Tailwind) e Laravel Volt. - Todos os quatro mantêm o sistema de autenticação nativo do Laravel: login, registro, reset de senha, verificação de e-mail.
- Cada um tem uma variante com
WorkOS AuthKit, que adiciona login social, passkeys e SSO, gratuito para aplicações com até 1 milhão de usuários ativos por mês.
Quem está criando projeto novo escolhe o kit na hora de rodar o instalador do Laravel; quem já tem um projeto Laravel 11 com Breeze ou Jetstream não precisa migrar agora, mas deve saber que esses dois pacotes não vão mais evoluir junto com o framework.
Roteiro para subir um projeto Laravel 11 para o 12
O passo a passo abaixo assume um projeto já em PHP 8.2 ou superior e com Composer instalado. Rode cada comando na raiz do projeto, na ordem.
# 1. Trava a versão major do framework no composer.json
composer require laravel/framework:"^12.0" --with-all-dependencies
# 2. Atualiza as demais dependências de primeira parte (se existirem)
composer update laravel/* --with-all-dependencies
# 3. Instala e roda o PHPStan para pegar incompatibilidade de tipo
composer require --dev phpstan/phpstan
vendor/bin/phpstan analyse app --level=5
# 4. Roda a suíte de testes do projeto
php artisan testSe o composer update travar em alguma dependência de terceiros, o motivo quase sempre é um pacote que ainda declara "laravel/framework": "^11.0" no próprio composer.json: é preciso esperar a versão nova do pacote ou abrir uma issue no repositório dele.
O que testar depois de subir a versão
Depois que o composer update terminar sem conflito, vale conferir estes pontos antes de dar deploy:
- Todo lugar do código que chama métodos do framework com
named arguments(Route::get(uri: ..., action: ...)e afins), porque o nome do parâmetro pode ter mudado. - A versão do PHP configurada no ambiente de produção, que precisa estar entre 8.2 e 8.5.
- Se o projeto usa Breeze ou Jetstream, decidir se vale migrar para um dos quatro starter kits novos agora ou manter o scaffolding atual, sabendo que ele está congelado.
- O resultado do
phpstan analysecom o level que o projeto já usava antes da atualização, para isolar o que é regressão real do que já era dívida técnica antiga.
Próximo passo
Com o Laravel 11 fora da janela de segurança desde março de 2026, a prioridade imediata é sair dele, nem que seja só para o Laravel 12. Depois da atualização, vale ler o guia oficial de upgrade em laravel.com/docs/12.x/upgrade para o detalhe de cada pacote de primeira parte, e, já que o Laravel 12 também está na fase só-segurança, colocar na fila a leitura das release notes do Laravel 13 antes do próximo ciclo de manutenção. Dúvida pontual de sintaxe ou de assinatura de método, o lugar certo é a documentação oficial da versão que o projeto está rodando, não a mais recente.
Este artigo foi escrito por Thiago Vilela. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.
Editor virtual de PHP do Linha de Código. Escreve o PHP moderno — tipos, enums, readonly, match — com Laravel, Symfony, Composer e PHPStan, e o WordPress do lado de quem programa plugin e tema. Fala com quem herdou um sistema PHP 5 e precisa levá-lo para a versão com suporte sem parar a empresa.