PHP 8.6 e WordPress: o que verificar antes da atualização

Última verificação: 19 de novembro de 2026
16 min de leitura
Guia
500+ projetos WP
Desenvolvedor full-stack

Resposta curta: O PHP 8.6.0 saiu a 19 de novembro de 2026. O núcleo do WordPress é testado nele, mas o tema e os plugins têm de ser verificados à parte. A maior parte das alterações são funções obsoletas que, hoje, só geram um aviso no log. O risco real para um site a funcionar vem das alterações incompatíveis com versões anteriores, sobretudo dos novos valores predefinidos dos cookies de sessão. Se o seu site corre em PHP 8.2, a data que pesa mais do que o PHP 8.6 é 31 de dezembro de 2026: a partir dela, esse ramo deixa de receber correções de segurança.

Página de lançamento do PHP 8.6 no php.net com a data de 19 de novembro de 2026 Página de lançamento do PHP 8.6 no php.net. Fonte: php.net, 19 de novembro de 2026.

Este texto é para o dono de um site ou de uma loja a quem o alojamento propôs mudar a versão do PHP, e para quem mantém esse site. Explico o que o PHP 8.6 muda, que alterações afetam o WordPress e o WooCommerce, como verificar o código próprio e o que apareceu quando testei dessa forma os plugins que eu próprio desenvolvo.

#Quando saiu o PHP 8.6 e o WordPress já o suporta?

O PHP 8.6.0 foi lançado a 19 de novembro de 2026 (php.net). A página do lançamento aponta como principais novidades a aplicação parcial de funções (partial function application), a classe Time\Duration, a nova API para várias streams, Io\Poll, e a função clamp().

Do lado do WordPress, a situação é esta:

AspetoSituação a 19 de novembro de 2026Fonte
Versão mínima do PHP7.4wordpress.org
Versão recomendada do PHP8.3 ou mais recentewordpress.org
Testes do núcleo no PHP 8.6têm de passar desde 10 de novembro de 2026WordPress Developer Blog
Tabela de compatibilidade de versõesWordPress 7.0 e 7.1 assinalados para PHP 7.4 até 8.5; o PHP 8.6 ainda não constamanual do núcleo

O blog de programadores do WordPress descreve que o PHP 8.6 entrou na matriz de testes do núcleo no ciclo da versão 7.2 e que, desde 10 de novembro, os testes nessa versão já não podem falhar. A publicação anuncia sobretudo avisos de funções obsoletas, e sobretudo nos testes. Para o núcleo é uma boa notícia. Mas se o seu site vai funcionar depende de todo o código que lá corre: tema, plugins e as respetivas bibliotecas.

#Que versões do PHP têm suporte hoje?

Cada ramo do PHP tem dois anos de suporte completo e mais dois anos apenas com correções de segurança (php.net):

VersãoSuporte completo atéCorreções de segurança até
8.231 de dezembro de 202431 de dezembro de 2026
8.331 de dezembro de 202531 de dezembro de 2027
8.431 de dezembro de 202631 de dezembro de 2028
8.531 de dezembro de 202731 de dezembro de 2029
8.631 de dezembro de 202831 de dezembro de 2030

Tabela das versões do PHP com suporte, na página do php.net Versões do PHP com suporte. Fonte: php.net, situação a 19 de novembro de 2026.

A versão 7.4 não tem suporte há anos, e o WordPress continua a aceitá-la. A API de estatísticas do WordPress.org mostra que, a 19 de novembro de 2026, 14,1% dos sites corriam nela. A maioria corria no PHP 8.3 (28,8%), depois no 8.2 (21,8%) e no 8.4 (11,1%). No PHP 8.6, no dia do lançamento, corria 0,03% (api.wordpress.org). O blog de programadores indica cerca de 17% para a 7.4 no fim de outubro, por isso a fatia está a diminuir.

Para planear, conta uma data. Daqui a seis semanas, a 31 de dezembro de 2026, o PHP 8.2 deixa de receber correções de segurança, e nessa versão corre um em cada cinco sites em WordPress. Isto é mais urgente do que passar para o 8.6.

#Que funções o PHP 8.6 marca como obsoletas?

A função obsoleta continua a funcionar. O PHP regista em cada chamada um aviso E_DEPRECATED, e a função desaparece na versão major seguinte. A lista para o PHP 8.6 é longa (php.net). Para o código de plugins e temas do WordPress, estas são as entradas mais relevantes:

ObsoletoSubstitutoOnde o vai encontrar
mb_ereg(), mb_eregi(), mb_ereg_replace(), mb_eregi_replace(), mb_split(), mb_regex_encoding()funções preg_*() com o modificador uplugins antigos de texto multilingue, slugs e pesquisa
spl_object_hash()spl_object_id()bibliotecas que registam objetos, contentores de dependências, ferramentas de teste
is_double(), is_integer(), is_long(), doubleval()is_float(), is_int(), floatval()código antigo de validação de números
terceiro argumento de define()remover o argumentoplugins muito antigos
strcoll() e SORT_LOCALE_STRINGclasse Collator da extensão intlordenação de listas por idioma
return dentro de um bloco finallymover o return para fora do finallycódigo de tratamento de exceções
metaphone()sem substituto diretopesquisa fonética

O blog de programadores do WordPress contou ocorrências de quatro destas funções no diretório de plugins do WordPress.org. is_long() aparece mais de 10 800 vezes em 2258 plugins, e spl_object_hash() mais de 8700 vezes em 2359 plugins. O núcleo do WordPress também troca as funções regex do mbstring por equivalentes mais recentes e corrige chamadas escritas com maiúsculas e minúsculas diferentes das da declaração, algo que o PHP 8.6 igualmente assinala.

As funções regex do mbstring e o spl_object_hash() deverão desaparecer por completo no PHP 9.0. Aí, o aviso passa a erro fatal. Código que as chama deve ser corrigido já, enquanto é apenas uma entrada no log.

#Que alterações do PHP 8.6 podem estragar um site a funcionar?

Estas alterações são mais perigosas do que as funções obsoletas, porque mudam o comportamento do código sem qualquer aviso (php.net).

Página das alterações incompatíveis com versões anteriores do PHP 8.6 na documentação do php.net Lista de alterações incompatíveis com versões anteriores no PHP 8.6. Fonte: documentação do php.net.

#Novos valores predefinidos da sessão

Três definições de sessão do PHP passam a ter novos valores predefinidos:

  • session.cookie_samesite passa a ser Lax (antes não tinha valor). O cookie de sessão não é enviado em pedidos vindos de outros domínios, exceto na simples navegação para a página com GET.
  • session.cookie_httponly passa a ser 1. O JavaScript deixa de conseguir ler o cookie de sessão através de document.cookie.
  • session.use_strict_mode passa a ser 1. O PHP rejeita identificadores de sessão que não tenha criado ele próprio.

O núcleo do WordPress não usa sessões PHP, e o WooCommerce guarda a sessão do carrinho numa tabela própria da base de dados. Mas alguns plugins usam sessões PHP: gateways de pagamento, início de sessão através de um fornecedor externo, formulários de vários passos e plugins de dropshipping. O cenário mais exposto é o regresso de um gateway de pagamento que devolve o cliente à loja com um pedido POST vindo de outro domínio. Se o plugin guarda o estado do pagamento em $_SESSION, depois da mudança para o PHP 8.6 o navegador não envia o cookie de sessão, e a encomenda pode não ficar marcada como paga. Por isso, um teste de encomenda com um gateway real numa cópia do site é obrigatório.

#Outras alterações incompatíveis com versões anteriores

  • trim(), ltrim() e rtrim() passam a remover, por defeito, também o carácter \f (form feed). Código que compara textos aparados com dados de importação ou de uma API pode obter um resultado diferente.
  • Muitas funções lançam agora ValueError em vez de emitirem um aviso ou de cortarem os dados em silêncio, por exemplo perante um byte NUL num nome de ficheiro, flags inválidas ou um número de casas decimais fora do intervalo em number_format(). Uma exceção não tratada termina o pedido com erro 500.
  • preg_grep() devolve false em caso de erro do PCRE.
  • A página do lançamento acrescenta que fclose(), file_put_contents() e copy() devolvem false quando não é possível escrever o buffer ou fechar o ficheiro. Código que não verifica o resultado destas funções não dá por falhas de escrita, por exemplo numa exportação CSV ou numa cache em disco.

Segundo a documentação do PHP, o PHP 8.6 não remove nenhuma extensão. Vale a pena confirmar, porque algumas análises falam em duas extensões removidas. As páginas de lançamento e de migração no php.net não as referem.

#Onde estão, na prática, as funções obsoletas: medição em 102 plugins

Antes de escrever este texto, verifiquei desta forma o código pelo qual sou responsável. Desenvolvo plugins para WordPress e WooCommerce sob a marca plogins. Os repositórios locais têm 102 diretórios de plugins, versões gratuitas e Pro. Procurei neles 92 782 ficheiros PHP por 18 funções que o PHP 8.6 marca como obsoletas: todas as funções regex do mbstring, spl_object_hash(), os aliases is_double(), is_integer(), is_long() e doubleval(), metaphone(), strcoll(), mysqli_get_charset() e spl_classes(). Excluí as pastas node_modules, os testes e as cópias de plugins de terceiros guardadas para comparação.

Resultado:

OndeChamadas
Código próprio dos plugins0
Stubs do WordPress para análise estática (php-stubs/wordpress-stubs)83
Ferramentas de teste: sebastian/recursion-context, phpunit/phpunit, mockery/mockery, sebastian/exporter, wp-phpunit/wp-phpunit54
myclabs/deep-copy9
outros pacotes na pasta vendor7
phpseclib/phpseclib3

Todas as 156 ocorrências de spl_object_hash() estão em dependências do Composer, e nenhuma no código que escrevi. A maioria vem de ferramentas de desenvolvimento que não chegam ao pacote instalado no site do cliente. As três chamadas no phpseclib estão numa biblioteca para ligações cifradas que vem incluída no plugin e corre em produção.

A conclusão para qualquer site é a mesma: pesquisar só o tema e os plugins próprios não chega. Os avisos do PHP 8.6 vêm em grande parte de bibliotecas incluídas nos plugins. Não os corrige sozinho. Tem de esperar por uma nova versão da biblioteca ou do plugin e instalá-la. Por isso, no log depois de um teste, convém olhar para o caminho do ficheiro e não só para o nome da função: um caminho com vendor/ significa reportar ao autor do plugin, e um caminho na pasta do tema significa correção do seu lado.

#Como verificar o site WordPress antes de mudar a versão do PHP?

Procedimento que aplico quando mudo a versão do PHP em sites de clientes:

  1. Cópia do site com PHP 8.6. O mais simples é um ambiente de staging no mesmo alojamento, se permitir escolher a versão do PHP para a cópia. Localmente, basta uma imagem Docker com PHP 8.6, quando estiver disponível na sua ferramenta.
  2. Registo de erros em ficheiro. No wp-config.php da cópia, defina WP_DEBUG e WP_DEBUG_LOG como true, e WP_DEBUG_DISPLAY como false. Os avisos vão para wp-content/debug.log, e não para o ecrã.
  3. Percorrer os caminhos mais importantes. Página inicial, artigo, pesquisa, formulário de contacto, início de sessão e, numa loja, adicionar ao carrinho, encomenda com cada método de pagamento, regresso do gateway de pagamento, email de confirmação e reembolso no painel. Execute as tarefas cron manualmente, por exemplo com o WP-CLI: wp cron event run --due-now.
  4. Ler o log. Agrupe as entradas pelo caminho do ficheiro. E_DEPRECATED é a lista de melhorias; Fatal error e Uncaught ValueError bloqueiam a mudança de versão.
  5. Pesquisar funções obsoletas no código, também nos caminhos que o teste não percorreu:
grep -rnE "(mb_ereg|mb_eregi|mb_split|mb_regex_encoding|spl_object_hash|is_double|is_integer|is_long|doubleval)[[:space:]]*\(" \
  wp-content/themes wp-content/plugins wp-content/mu-plugins --include="*.php"
  1. Análise estática, se tiver código próprio. O PHPCompatibility tem suporte ao PHP 8.6 na versão de teste 10.0.0-alpha3, de 17 de novembro de 2026, e o conjunto para WordPress, PHPCompatibilityWP, na versão 3.0.0-alpha3 (GitHub). As versões estáveis destas ferramentas ainda não conhecem o PHP 8.6. O PHPStan, a partir da versão 2.3.7, aceita phpVersion: 80600, e o Rector 2.8.5 tem um conjunto de regras php86 que troca os aliases is_integer() e is_long() por is_int(), e is_double() por is_float() (GitHub).
  2. Decisão e troca. Quando o log não tiver erros críticos e as funções obsoletas estiverem reportadas aos autores dos plugins, mude a versão em produção em horas de pouco tráfego e volte a fazer uma encomenda de teste.

#Como ler o log depois de um teste ao PHP 8.6?

Depois de uma hora a clicar numa cópia de uma loja, o debug.log pode ter vários milhares de linhas, porque o mesmo aviso é gravado em cada chamada. Antes de começar a ler, conte as entradas por tipo e por plugin. Cada entrada PHP termina num caminho de ficheiro a seguir a in, por isso basta extrair o nome da pasta:

# número de entradas de cada tipo
grep -oE "PHP (Deprecated|Warning|Fatal error|Notice)" wp-content/debug.log | sort | uniq -c

# que plugins e temas reportam funções obsoletas
grep "PHP Deprecated" wp-content/debug.log \
  | grep -oE "wp-content/(plugins|themes|mu-plugins)/[^/]+" | sort | uniq -c | sort -rn

Deste resumo percebe-se logo de quem é cada coisa. Depois, a decisão depende do tipo de entrada:

Entrada no logO que significaO que fazer
PHP Deprecated na pasta do seu tema ou de um plugin próprioO seu código chama uma função obsoleta no PHP 8.6corrigir antes do PHP 9.0; não bloqueia a mudança de versão
PHP Deprecated em vendor/ de um plugin do WordPress.org ou comercialfunção obsoleta numa biblioteca incluída no pluginreportar ao autor com a versão do PHP e o caminho do ficheiro; não bloqueia a mudança de versão
PHP Warning depois da mudança de versão, que não existia na anterioralteração de comportamento de uma funçãoverificar o caminho no código antes de mudar a produção
PHP Fatal error ou Uncaught ValueErroro código deixou de funcionarbloqueia a mudança de versão até haver correção ou substituição do plugin
sem entradas, e a encomenda não muda de estado depois do pagamentoprovavelmente o cookie de sessão não regressa do gatewayverificar se o plugin de pagamento usa $_SESSION e reportar ao autor

A última linha é a menos óbvia, porque o problema do cookie de sessão não deixa rasto no log. Só se vê no comportamento da loja. Por isso, a encomenda de teste com cada gateway de pagamento faz parte do procedimento.

No fim, desative o WP_DEBUG na cópia ou apague o debug.log. Um ficheiro dentro de wp-content pode ficar acessível pelo navegador e revelar caminhos do servidor.

Se trabalha com um tema filho próprio ou um plugin feito à medida, a troca de funções obsoletas costuma ser uma correção pequena e mecânica.

#O que o PHP 8.6 oferece aos programadores de WordPress?

No dia a dia, pouco, e pela razão simples de que o núcleo do WordPress tem de correr em PHP 7.4 e, por isso, não pode usar sintaxe do PHP 8.x. O blog de programadores do WordPress enumera o que o núcleo não usa por esse motivo: argumentos nomeados e tipos união do PHP 8.0, enumerações do 8.1, classes só de leitura do 8.2, property hooks do 8.4 e o operador pipe do 8.5.

Algumas novidades, no entanto, funcionam sem alterar código ou são úteis em projetos próprios:

  • Otimizações de closures. O PHP 8.6 acrescenta uma cache para closures sem estado, e array_map() com uma chamada na nova sintaxe compila para um ciclo normal, sem criar objetos intermédios (php.net). O site recebe isto apenas por mudar a versão.
  • clamp() limita um valor a um intervalo. O WordPress tem uma função com este nome desde a versão 7.1, por isso os plugins podem usá-la independentemente da versão do PHP.
  • Time\Duration descreve uma duração com precisão de nanossegundos. No WordPress as durações estão em todo o lado: expiração de transientes, intervalos do cron, limites de tempo de pedidos HTTP. O blog de programadores mostra como poderia ser um set_transient() que aceite esse objeto, mas por agora é apenas uma ideia.
  • A aplicação parcial de funções permite escrever $addOne = add(1, ?); e obter um closure que aceita o resto dos argumentos. Num plugin próprio que exija o PHP 8.6, isto encurta o código com array_map() e o operador pipe. Em código que tem de correr no PHP 8.2, não se pode usar.

#Vale a pena mudar já o site para o PHP 8.6?

A minha recomendação para novembro de 2026:

  • Site em PHP 7.4, 8.0, 8.1 ou 8.2: passe-o para o PHP 8.3 ou 8.4 antes de 31 de dezembro de 2026. É urgente, porque depois dessa data o PHP 8.2 deixa de receber correções de segurança. O WooCommerce anunciou que, a partir da versão 11.6, prevista para fevereiro de 2027, vai exigir o PHP 8.1 e recomenda o 8.3 ou mais recente (WooCommerce Developer Blog).
  • Site em PHP 8.3 ou 8.4: não há razão para pressa. Teste o PHP 8.6 numa cópia nas próximas semanas e reporte aos autores dos plugins os avisos do log.
  • Projeto novo ou reconstrução grande: comece com o PHP 8.4 ou 8.5 em produção e teste no 8.6 desde o início.

Verifique também as definições do alojamento. Alguns fornecedores sobem a versão do PHP automaticamente quando a antiga perde suporte. No painel verá a versão que o seu site usa e se a mudança automática está ativa.

#Quando encomendar esta verificação a alguém?

Os passos 1 a 4 consegue fazê-los sozinho se tiver um ambiente de staging e acesso aos logs. Vale a pena encomendar a verificação quando a loja tem gateways de pagamento, integrações com um ERP ou um sistema de faturação, tema próprio ou plugins feitos à medida, ou quando o alojamento já anunciou a mudança de versão.

A mudança de versão do PHP, com teste numa cópia, faz parte das atualizações do WordPress. Na manutenção de sites em WordPress acompanho por si as datas de fim de suporte. Diga-me em que versão do PHP o seu site corre hoje e que plugins de pagamento tem. Envio-lhe uma lista do que verificar.

Próximo passo

Transforme o artigo numa implementação real

Este bloco reforça a ligação interna e conduz o leitor para o passo seguinte mais útil dentro da arquitetura do site.

Explorar outros serviços WordPress e base de conhecimento

Perguntas frequentes

Respostas práticas para aplicar o tema na execução real.

O WordPress funciona no PHP 8.6?#
O núcleo do WordPress é testado no PHP 8.6 e, desde 10 de novembro de 2026, esses testes têm de passar. A página de compatibilidade de versões do manual do núcleo ainda não menciona o PHP 8.6, e o funcionamento do seu site depende também do tema e dos plugins. Verifique-os numa cópia antes de mudar a versão em produção.
Uma função obsoleta estraga o site depois de mudar para o PHP 8.6?#
Não. A função obsoleta continua a funcionar, e o PHP regista apenas um aviso E_DEPRECATED. Estas funções vão desaparecer no PHP 9.0, por isso convém substituí-las já. O que pode estragar o site são as alterações incompatíveis com versões anteriores, por exemplo os novos valores predefinidos dos cookies de sessão.
Para que versão do PHP devo mudar o site do WordPress agora?#
O WordPress recomenda o PHP 8.3 ou mais recente. Se o site corre no PHP 8.2 ou numa versão anterior, mude-o antes de 31 de dezembro de 2026, data em que terminam as correções de segurança do 8.2. Teste o PHP 8.6 primeiro numa cópia.
Como verificar se os plugins estão prontos para o PHP 8.6?#
Ative o registo de erros numa cópia do site com PHP 8.6, percorra os caminhos mais importantes, incluindo uma encomenda com pagamento, e leia o log. Complemente com a pesquisa de funções obsoletas no código e com a análise do PHPCompatibilityWP 3.0.0-alpha3 ou do PHPStan com phpVersion 80600.

Artigos Relacionados