Astra Pro PHP 8.3: corrigir erro de compatibilidade

Tipo Erro de PHP

Nome do erro Incompatibilidade do Astra Pro com PHP 8.3 EN: Astra Pro PHP 8.3 compatibility error

Severidade Grave

Descrição O erro de compatibilidade do Astra Pro com o PHP 8.3 acontece quando uma versão antiga do addon roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o front-end ou o Personalizar. A correção é alinhar tema, plugin Astra Pro e licença na versão mais recente.

O que é o erro do Astra Pro com PHP 8.3?

A incompatibilidade do Astra Pro com PHP 8.3 ocorre quando o addon Astra Pro está numa versão lançada antes do suporte oficial ao PHP 8.3 e o servidor já está nessa versão do PHP. O PHP 8.3 endureceu várias regras que antes só geravam aviso (criação de propriedade dinâmica, passar null para parâmetros internos não anuláveis, funções removidas), então código antigo do Astra Pro passa a emitir mensagens de deprecated ou, em casos graves, um fatal error. O sintoma varia: pode ser só um aviso no debug.log, uma faixa de avisos no topo do site ou a tela do Personalizar e o front-end quebrados.

Como identificar

Mensagem “Deprecated: Creation of dynamic property …” apontando um arquivo dentro de wp-content/plugins/astra-addon no debug.log ou no topo da página.
Mensagem “Fatal error: Uncaught TypeError” ou “Deprecated” referenciando um arquivo do astra-addon ao abrir o Personalizar (Aparência -> Personalizar).
Faixa de avisos de PHP no cabeçalho do site logo após o host atualizar o PHP para a versão 8.3.
Tela branca ou erro crítico só nas telas que usam recursos do Astra Pro (cabeçalho transparente, mega menu, blog layout), enquanto o tema Astra grátis continua carregando.
Em Ferramentas -> Saúde do site, aviso de que a versão do tema ou do plugin Astra está desatualizada.

Antes de começar: Faça backup do site (arquivos e banco) antes de atualizar o tema e o plugin. Se você usa um tema-filho do Astra com personalizações, teste em um ambiente de homologação primeiro: uma atualização maior do Astra Pro pode mudar hooks usados no functions.php do tema-filho.

Como prevenir

Mantenha o tema Astra e o plugin Astra Pro sempre na última versão e sempre atualizados juntos.
Renove a licença do Astra Pro antes de vencer, para nunca perder o acesso às correções de compatibilidade.
Antes de o host subir uma versão maior do PHP, teste o site numa cópia de homologação com a nova versão do PHP.
Em produção, mantenha WP_DEBUG_DISPLAY desligado para que avisos de deprecated nunca apareçam para o visitante.

Causa

Plugin Astra Pro (astra-addon) numa versão anterior à 4.4, lançada antes do suporte oficial ao PHP 8.3, rodando num servidor já migrado para o PHP 8.3.
Versão do tema Astra e do plugin Astra Pro fora de sincronia (um atualizado e o outro não), combinação que o próprio addon bloqueia ou quebra.
Licença do Astra Pro expirada ou não ativada, o que impede o WordPress de oferecer a atualização do plugin que traz a correção do PHP 8.3.
WP_DEBUG_DISPLAY ligado em produção, fazendo o aviso de deprecated (que seria silencioso) aparecer impresso na tela e assustar o visitante.
Plugin de cache servindo HTML antigo com a faixa de erro mesmo depois da atualização, dando a impressão de que o problema persiste.

Como resolver

Confirme a versão do PHP e do Astra Pro: veja em Ferramentas -> Saúde do site -> Informações -> Servidor a versão do PHP, e em Aparência -> Temas e em Plugins a versão do Astra e do Astra Pro. Se o PHP está em 8.3 e o Astra Pro está abaixo da 4.4, a incompatibilidade está confirmada.
Ative a licença do Astra Pro: sem a licença ativa o WordPress não mostra a atualização que corrige o PHP 8.3. Ative em:
```
Painel WP -> Astra -> Configurações -> Licença
```

Atualize o tema e o plugin para a versão mais recente: atualize sempre os dois juntos para manter a sincronia entre tema e addon:

Painel WP -> Painel -> Atualizações
Painel WP -> Plugins -> Astra Pro -> Atualizar agora
Painel WP -> Aparência -> Temas -> Astra -> Atualizar agora

Esconda os avisos em produção: se ainda houver algum deprecated isolado, mantenha o log mas pare de imprimir na tela. No wp-config.php deixe o debug em arquivo, não na tela:
```
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```
Limpe o cache e reteste: limpe o cache do plugin de cache e do host (e do Cloudflare, se houver) para não ver HTML antigo com a faixa de erro. Recarregue o front-end e o Personalizar e confira o debug.log:
```
wp-content/debug.log
```

PHP

// wp-config.php — registra os avisos do PHP 8.3 no log sem imprimir na tela
// Cole antes da linha: /* That's all, stop editing! Happy publishing. */
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );    // grava em wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // nao mostra o aviso ao visitante
@ini_set( 'display_errors', 0 );

Perguntas frequentes

O Astra Pro é compatível com o PHP 8.3?

Sim, nas versões recentes. O suporte ao PHP 8.3 entrou nas versões mais novas do tema Astra e do plugin Astra Pro; o erro aparece quando o addon está numa versão antiga rodando num servidor já no PHP 8.3. Atualizar os dois para a última versão resolve.

Qual a diferença entre o aviso deprecated e o fatal error do Astra Pro?

O deprecated é só um aviso: o código antigo ainda roda, mas usa um recurso que o PHP 8.3 marcou para remoção. O fatal error interrompe a execução e derruba a página. Os dois vêm da mesma causa, uma versão antiga do addon, e somem com a atualização.

Atualizei o Astra Pro e o erro continua. O que faço?

Confirme que o tema Astra também foi atualizado, pois tema e addon precisam estar em sincronia. Depois limpe o cache do plugin de cache e do host, porque pode estar sendo servido um HTML antigo com a faixa de erro. Recarregue e confira o debug.log.

Posso voltar o PHP para a versão 8.1 em vez de atualizar o Astra Pro?

Funciona como paliativo, mas não é o ideal. Versões antigas do PHP deixam de receber correções de segurança, então o certo é manter o PHP atual e atualizar o Astra Pro para a versão compatível. Use o downgrade só para ganhar tempo até atualizar.

Preciso da licença ativa para corrigir esse erro?

Para a maioria dos casos, sim. O Astra Pro só oferece a atualização que corrige o PHP 8.3 com a licença ativa. Com a licença expirada, o painel não mostra a atualização do plugin e o erro permanece até você renovar.

O erro afeta o tema Astra grátis ou só o Astra Pro?

Costuma afetar o plugin Astra Pro (a pasta astra-addon), porque ele tem mais código e recursos. O tema Astra grátis também recebe ajustes de PHP 8.3, mas o fatal error geralmente aparece em recursos exclusivos do Pro, como cabeçalho transparente ou mega menu.

Como descobrir qual arquivo do Astra Pro está dando o erro?

Ligue o WP_DEBUG_LOG no wp-config.php e abra o arquivo wp-content/debug.log. A linha de deprecated ou de fatal error mostra o caminho exato do arquivo dentro de wp-content/plugins/astra-addon e o número da linha, o que confirma a origem no addon.

Mexer no wp-config.php para esconder os avisos é seguro?

Sim, desde que você faça backup do arquivo antes e cole as constantes exatamente antes da linha que pede para parar de editar. Deixar WP_DEBUG_DISPLAY como false só impede que o aviso apareça na tela; ele continua registrado no debug.log para você diagnosticar.

Grave

Como corrigir Out of memory no PHP do WordPress

O erro out of memory no PHP do WordPress acontece quando um processo tenta alocar mais memória do que o limite do PHP ou a RAM do servidor têm disponível, e a execução para na hora. Costuma ser disparado por loops, consultas gigantes ou processos concorrentes em um servidor pequeno.

Grave

Como atualizar a versão do PHP no WordPress com segurança

Atualizar a versão do PHP do WordPress deixa o site mais rápido e seguro, mas plugins ou temas antigos podem quebrar na versão nova. O caminho seguro é testar em uma cópia, conferir a compatibilidade e só então trocar a versão no painel da hospedagem, com como reverter à mão.

Informativo

Como corrigir erro de timezone no PHP do WordPress

O erro de timezone no PHP do WordPress acontece quando a diretiva date.timezone não está definida no servidor, gerando avisos e horários incorretos em posts e agendamentos. O ajuste de fuso do site é feito nas configurações do WordPress, não com funções de timezone no PHP.

Grave

Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3

A incompatibilidade do Tutor LMS com PHP 8.3 acontece quando uma versão do plugin escrita para PHP 7.4 roda num servidor já no PHP 8.3, gerando avisos de Deprecated e, em alguns casos, erro fatal ao salvar cursos ou abrir o construtor de quiz. A documentação oficial homologa o plugin a partir do PHP 7.4.

Grave

Como corrigir Cannot redeclare function

O erro Cannot redeclare function é um erro fatal de PHP que ocorre quando a mesma função é definida duas vezes na execução. No WordPress, costuma surgir ao colar um snippet repetido no functions.php ou ao ativar dois plugins que declaram uma função com o mesmo nome.

Grave

Como corrigir Headers already sent no WordPress

O headers already sent é um erro de PHP que aparece quando o WordPress tenta enviar um cabeçalho HTTP (um redirecionamento, um cookie de login) depois que algum conteúdo já foi enviado ao navegador. A causa quase sempre é um espaço em branco ou um echo antes ou depois das tags do PHP em um arquivo como o wp-config.php ou o functions.php.

Setores

Extensões

Integrações

Como corrigir a incompatibilidade do Astra Pro com PHP 8.3

O que é o erro do Astra Pro com PHP 8.3?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir Out of memory no PHP do WordPress

Como atualizar a versão do PHP no WordPress com segurança

Como corrigir erro de timezone no PHP do WordPress

Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3

Como corrigir Cannot redeclare function

Como corrigir Headers already sent no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos