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. 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:
| Aspeto | Situação a 19 de novembro de 2026 | Fonte |
|---|---|---|
| Versão mínima do PHP | 7.4 | wordpress.org |
| Versão recomendada do PHP | 8.3 ou mais recente | wordpress.org |
| Testes do núcleo no PHP 8.6 | têm de passar desde 10 de novembro de 2026 | WordPress Developer Blog |
| Tabela de compatibilidade de versões | WordPress 7.0 e 7.1 assinalados para PHP 7.4 até 8.5; o PHP 8.6 ainda não consta | manual 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ão | Suporte completo até | Correções de segurança até |
|---|---|---|
| 8.2 | 31 de dezembro de 2024 | 31 de dezembro de 2026 |
| 8.3 | 31 de dezembro de 2025 | 31 de dezembro de 2027 |
| 8.4 | 31 de dezembro de 2026 | 31 de dezembro de 2028 |
| 8.5 | 31 de dezembro de 2027 | 31 de dezembro de 2029 |
| 8.6 | 31 de dezembro de 2028 | 31 de dezembro de 2030 |
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:
| Obsoleto | Substituto | Onde o vai encontrar |
|---|---|---|
mb_ereg(), mb_eregi(), mb_ereg_replace(), mb_eregi_replace(), mb_split(), mb_regex_encoding() | funções preg_*() com o modificador u | plugins 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 argumento | plugins muito antigos |
strcoll() e SORT_LOCALE_STRING | classe Collator da extensão intl | ordenação de listas por idioma |
return dentro de um bloco finally | mover o return para fora do finally | código de tratamento de exceções |
metaphone() | sem substituto direto | pesquisa 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).
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_samesitepassa a serLax(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_httponlypassa a ser1. O JavaScript deixa de conseguir ler o cookie de sessão através dedocument.cookie.session.use_strict_modepassa a ser1. 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()ertrim()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
ValueErrorem 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 emnumber_format(). Uma exceção não tratada termina o pedido com erro 500. preg_grep()devolvefalseem caso de erro do PCRE.- A página do lançamento acrescenta que
fclose(),file_put_contents()ecopy()devolvemfalsequando 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:
| Onde | Chamadas |
|---|---|
| Código próprio dos plugins | 0 |
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-phpunit | 54 |
myclabs/deep-copy | 9 |
outros pacotes na pasta vendor | 7 |
phpseclib/phpseclib | 3 |
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:
- 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.
- Registo de erros em ficheiro. No
wp-config.phpda cópia, definaWP_DEBUGeWP_DEBUG_LOGcomotrue, eWP_DEBUG_DISPLAYcomofalse. Os avisos vão parawp-content/debug.log, e não para o ecrã. - 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. - Ler o log. Agrupe as entradas pelo caminho do ficheiro.
E_DEPRECATEDé a lista de melhorias;Fatal erroreUncaught ValueErrorbloqueiam a mudança de versão. - 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"- 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 regrasphp86que troca os aliasesis_integer()eis_long()poris_int(), eis_double()poris_float()(GitHub). - 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 -rnDeste resumo percebe-se logo de quem é cada coisa. Depois, a decisão depende do tipo de entrada:
| Entrada no log | O que significa | O que fazer |
|---|---|---|
PHP Deprecated na pasta do seu tema ou de um plugin próprio | O seu código chama uma função obsoleta no PHP 8.6 | corrigir 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 comercial | função obsoleta numa biblioteca incluída no plugin | reportar 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 anterior | alteração de comportamento de uma função | verificar o caminho no código antes de mudar a produção |
PHP Fatal error ou Uncaught ValueError | o código deixou de funcionar | bloqueia 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 pagamento | provavelmente o cookie de sessão não regressa do gateway | verificar 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\Durationdescreve 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 umset_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 comarray_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.






