Laravel 13.43 traz validação por JSON Schema e retry configurável em filas
A versão 13.43.0 do framework deriva regras de validação direto de um JSON Schema, adiciona o atributo #[RetryFor] para controlar quando uma fila desiste e corrige cinco falhas de segurança.
No fim deste texto você sabe usar os quatro recursos novos do Laravel 13.43.0 (lançado em 17 de novembro de 2026): derivar regras de validação de um JSON Schema, controlar o prazo de retry de uma fila com um atributo em vez de um método, evitar XSS em componentes Blade inline e manter leituras na réplica mesmo dentro de uma escrita pontual. Os exemplos abaixo foram escritos contra laravel/framework 13.43.0 rodando em PHP 8.3+.
Antes de qualquer coisa, suba a versão:
composer update laravel/framework
php artisan --versionSe o projeto usa laravel/horizon, preste atenção: o framework agora declara conflito com versões do Horizon abaixo de 5.47.0. Se o Composer travar pedindo resolução, é isso: rode composer require laravel/horizon:^5.47 antes de atualizar o framework.
Validação derivada de um JSON Schema
Quem expõe ferramentas pelo Laravel AI SDK ou pelo Laravel MCP já descreve o input de cada tool com um JSON Schema. Até a 13.42, era preciso repetir as mesmas restrições como regras de Validator, duplicando max, enum e required em dois lugares que podiam divergir com o tempo. JsonSchema::rules(), de Pushpak Chhajed, resolve isso convertendo o schema em regras prontas.
use Illuminate\JsonSchema\JsonSchema;
use Illuminate\Support\Facades\Validator;
$schema = JsonSchema::object(fn ($schema) => [
'name' => $schema->string()->max(50)->required(),
'age' => $schema->integer()->min(18),
'role' => $schema->string()->enum(['admin', 'user'])->required(),
]);
$validator = Validator::make($request->all(), JsonSchema::rules($schema));O método também aceita um array de schema bruto, então dá para reaproveitar algo que já vem de uma API externa ou de um arquivo .json versionado. O resultado funciona em qualquer lugar que o Laravel aceita regras: Validator::make(), form request, ou validação inline num controller. Propriedades aninhadas viram chaves com notação de ponto, como address.city e tags.*, o que mantém a mensagem de erro no formato que o Blade já sabe exibir.
A 13.43 também fechou uma brecha de segurança relacionada: o deserializador do JSON Schema agora limita a profundidade de cadeias $ref, prevenindo um DoS por referência circular (PR #62498). Se seu app monta schemas a partir de input externo, vale confirmar que está na 13.43 antes de expor esse caminho.
O atributo #[RetryFor] substitui o método retryUntil()
Antes, limitar por quanto tempo uma fila insiste exigia sobrescrever retryUntil():
class ImportProducts implements ShouldQueue
{
public function retryUntil(): DateTime
{
return now()->addHours(4);
}
}Francisco Madeira contribuiu o atributo #[RetryFor], que faz a mesma coisa declarativamente:
use Illuminate\Queue\Attributes\RetryFor;
#[RetryFor(hours: 4)]
class ImportProducts implements ShouldQueue
{
public function handle(): void
{
// ...
}
}O primeiro argumento posicional é em segundos, e dá para combinar minutes e hours nomeados, como em #[RetryFor(hours: 1, minutes: 30)]. O atributo funciona em jobs, mailables, notifications e listeners enfileirados, e classes filhas herdam o valor da classe pai. Se a classe ainda tiver um método retryUntil() ou uma propriedade $retryUntil, eles continuam tendo prioridade sobre o atributo, então a migração é incremental: dá para trocar job por job sem quebrar nada.
Na prática, isso limpa a assinatura da classe quando o prazo de retry é fixo e não depende de lógica de negócio. Se o prazo varia (por exemplo, conforme o plano do cliente), o método retryUntil() continua sendo a ferramenta certa.
releaseUsingBackoff() para jobs que se autoliberam
O worker só aplica o backoff configurado quando o job lança uma exceção. Um job que se libera sozinho (como um que fica consultando uma API externa até um resultado ficar pronto) tinha que calcular o atraso na mão. Francisco Madeira também resolveu isso com releaseUsingBackoff() no trait InteractsWithQueue:
use Illuminate\Queue\Attributes\Backoff;
use Illuminate\Queue\InteractsWithQueue;
#[Backoff(5, 15, 60, 300)]
class WaitForExport implements ShouldQueue
{
use InteractsWithQueue;
public function handle(): void
{
if (! $this->export->isReady()) {
$this->releaseUsingBackoff();
return;
}
$this->export->download();
}
}O atraso usado é o valor de backoff correspondente à tentativa atual; depois que as tentativas passam do fim da lista, toda liberação usa o último valor (300 segundos no exemplo). Um job sem #[Backoff] declarado é liberado sem atraso nenhum, então vale declarar a sequência mesmo em jobs de polling simples.
RawTemplate fecha uma porta de XSS em componentes inline
Quando o render() de um componente Blade inline devolve uma string que não é nome de view, o Blade compila essa string como template. Se a string incluir input do usuário, qualquer sintaxe Blade digitada por ele roda no servidor. RawTemplate, de @JurianArie, torna a intenção explícita:
use Illuminate\View\RawTemplate;
class Alert extends Component
{
public function render(): RawTemplate
{
return new RawTemplate(<<<'blade'
<div class="alert">{{ $message }}</div>
blade);
}
}O parâmetro do construtor é tipado como literal-string, então uma ferramenta de análise estática como o PHPStan sinaliza se alguém tentar montar o template a partir de uma variável concatenada. Para aproveitar esse check:
composer require --dev phpstan/phpstan
vendor/bin/phpstan analyse appO stub de make:component --inline já gera RawTemplate por padrão a partir da 13.43. Retornar uma string simples ainda funciona no Laravel 13 (não quebra nada existente), mas deixou de ser a forma recomendada: é o tipo de coisa que passa despercebida até alguém reportar um bug de segurança.
withoutAffectingStickiness() evita grudar leituras na conexão de escrita
Com a opção sticky ativada para réplicas de leitura, qualquer escrita manda o resto das leituras da requisição para a conexão de escrita. O problema aparece quando a escrita é só um efeito colateral, como um timestamp no início de um job, que acaba grudando leituras bem mais pesadas na réplica errada pelo resto do ciclo. Jack Bayliss resolveu isso com withoutAffectingStickiness():
use Illuminate\Support\Facades\DB;
DB::withoutAffectingStickiness(function () {
$this->task->update(['started_at' => now()]);
});
$this->task->run();Se a conexão já tinha uma escrita antes dessa chamada, as leituras seguintes continuam na conexão de escrita (o comportamento de sticky não é quebrado retroativamente). É um ajuste pequeno, mas útil em qualquer app que tenha réplica de leitura configurada e jobs que fazem um update() de bookkeeping antes do trabalho pesado.
Mais pequenos, mas úteis: isBlank() e isNotBlank()
Steve Bauman adicionou isBlank() e isNotBlank() às fluent strings, seguindo as mesmas regras do helper blank():
use function Illuminate\Support\str;
str(' ')->isBlank(); // true
str('0')->isBlank(); // false
str($bio)->stripTags()->isNotBlank();É pouco, mas elimina um blank(str($bio)->stripTags()) meio estranho de ler em código que já encadeia métodos de Stringable.
Os cinco fixes de segurança que vieram junto
A 13.43 traz de volta correções já publicadas na branch 12.x. Vale conferir se seu app usa algum desses pontos:
| Falha | O que mudava |
|---|---|
| URLs assinadas temporárias | Expiração podia ser burlada com parâmetro de query em array ou numérico |
| Atributos de componente e página de debug | XSS no botão "copy request URL" e em atributos de componente |
| Mass assignment | Guard podia ser contornado pelo nome do atributo mutator |
| Validação de arquivo | Bypass na checagem de tipo de arquivo enviado |
| JSON Schema deserializer | Cadeia de $ref sem limite permitia DoS |
Se seu app valida upload de arquivo, usa URLs assinadas (URL::temporarySignedRoute()) ou expõe JSON Schema vindo de terceiros, atualizar para a 13.43 fecha essas rotas sem exigir mudança de código da sua parte.
Próximo passo
Para o diff completo entre 13.42.0 e 13.43.0, inclusive os PRs que não renderam seção própria (como a correção de Arr::forget() e o cache de reflection do Model), vale olhar o changelog no GitHub do laravel/framework. Quem for adotar JsonSchema::rules() em tools do Laravel MCP deve acompanhar a documentação de JSON Schema do framework, que ainda está em expansão. Para dúvida pontual sobre #[RetryFor] ou releaseUsingBackoff(), o canal #help do Laravel Discord costuma responder rápido, e as issues do repositório laravel/framework no GitHub são o lugar certo para reportar comportamento inesperado nesses recursos novos.
Fonte: Laravel News
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.