~ O Blog de 1999 ~

Uma versão major que arruma sobretudo

O Symfony 8.0 chegou em novembro de 2025 e é uma das majors menos dramáticas. Exige PHP 8.4 ou superior, que é o verdadeiro filtro. Fora isso, a maior parte das alterações serve para tornar o framework mais previsível e não para acrescentar funcionalidades que vais usar no primeiro dia.

A configuração passa a ser array shapes de PHP

É a alteração que notas primeiro. Os ficheiros de configuração XML e o builder fluente de PHP desapareceram; agora é um array simples.

// config/packages/framework.php
return [
    'secret' => '%env(APP_SECRET)%',
    'session' => [
        'handler_id' => null,
        'cookie_secure' => 'auto',
    ],
];

A razão não é moda. Um array shape é algo que o teu IDE e as ferramentas de análise estática conseguem ler, por isso ganhas autocompletar e verificação de tipos dentro dos ficheiros de configuração. Ao fim de uma semana, custa defender o formato antigo.

Os tipos de retorno são impostos

Em todos os componentes, os tipos de retorno deixam de ser sugestões. Se uma classe promete um tipo de retorno, tem de o devolver. Na prática isto afeta sobretudo código que já era descuidado, e faz aparecer o problema em desenvolvimento em vez de em produção.

Desempenho

As camadas de container e de cache beneficiam dos lazy objects do PHP 8.4, e os números que se veem para desempenho com cache quente são claramente melhores do que a linha 7.x. Se tens uma aplicação em que cada milissegundo de arranque é pago em cada pedido, este é o argumento que mais pesa.

Em que versão deves estar

Aqui está o resumo honesto.

• Se estás em Symfony 6.4 LTS: estás na última LTS que não exige PHP 8.4. Planeia a mudança, mas não estás em perigo ainda.
• Se estás em 7.4: estás na LTS atual. Ficar é uma decisão defensável por um ano, e passar para 8.x é sobretudo trabalho de configuração.
• Se vais começar um projeto novo: começa em 8.x. Não há razão para arrancar numa versão que vai precisar de migração.

O upgrade na prática

O Rector e a ferramenta de upgrade do Symfony fazem a maior parte do trabalho mecânico, incluindo a conversão da configuração. A parte que eles não fazem é o teu próprio código que depende de deprecations removidas. Conta gastar o teu tempo aí, não no framework.

Uma dica prática: corre o log de deprecations na tua versão atual antes de atualizar. Cada deprecation que arranjas com antecedência é uma surpresa menos depois, e o log diz-te exatamente onde olhar.

Vale a pena?

Se já estás em PHP 8.4, o upgrade é sobretudo um exercício de configuração com um retorno real em desempenho. Se estás em PHP 8.2 ou 8.3, o upgrade do PHP é a tarefa maior e o Symfony é a parte fácil depois. De qualquer forma, a direção é clara, e a configuração em array shapes é a peça que te vai poupar tempo todas as semanas quando estiver feita.