blog
Painéis

PHP 8 vai quebrar seu site? Teste em 7 passos

Um teste em subpasta, feito só com cliques no cPanel, transforma o medo de atualizar em uma decisão com nome de arquivo, número de linha e orçamento.

JR · · 14 min de leitura · 1 tabela · 6 blocos de código

Resposta curta: atualizar para o PHP 8 não quebra o site necessariamente, e dá para descobrir antes de arriscar: copie o site para uma subpasta pelo cPanel, proteja com senha, aponte um subdomínio de teste para ela, rode só esse endereço em PHP 8 e leia o erro, que traz arquivo e linha.

Neste artigo
  1. O que "quebrar" quer dizer: tela branca, erro fatal ou função que para
  2. A ideia do teste: uma cópia do site rodando sozinha no PHP 8
  3. O que separar antes do primeiro clique
  4. Montando a cópia, passo a passo
  5. Lendo o erro: tipo, caminho do arquivo e número da linha
  6. Os quatro erros que o próprio teste cria
  7. Corrigir agora ou segurar a versão antiga com data no calendário
  8. Frases prontas para o chamado ao suporte e ao desenvolvedor

O que "quebrar" quer dizer: tela branca, erro fatal ou função que para

Seu site roda em cima de um programa chamado PHP. É ele que monta a página quando alguém acessa. O PHP tem versões, como qualquer programa, e as antigas param de receber correção de segurança em algum momento. Aí a hospedagem avisa que é hora de subir para a versão 8.

Quando alguém diz que "o site pode quebrar", quase sempre é uma destas três coisas:

O que quase nunca acontece é o site sumir do servidor. Os arquivos continuam lá. Trocar a versão do PHP é uma configuração, e ela pode ser desfeita em minutos. Mesmo assim, ninguém quer descobrir o problema com a loja no ar.

A saída é testar antes, numa cópia. E testar sem depender de ninguém.

A ideia do teste: uma cópia do site rodando sozinha no PHP 8

O plano tem cinco partes, todas feitas por cliques no cPanel:

  1. Copiar os arquivos do site para uma pasta separada.
  2. Proteger essa pasta com senha, antes de qualquer outra coisa.
  3. Criar um endereço de teste (um subdomínio, algo como teste.seusite.com.br) que aponte para essa pasta.
  4. Colocar só esse endereço de teste em uma versão 8 do PHP. O site de verdade continua na versão antiga, intacto.
  5. Abrir a cópia, clicar em tudo e ver o que aparece.

Um aviso que vale desde já: "PHP 8" não é uma opção única. No painel você vai encontrar 8.0, 8.1, 8.2, 8.3 e, dependendo da hospedagem, versões mais novas. Escolha sempre a mais recente que a sua hospedagem oferecer, porque as primeiras da linha 8 também já saíram (ou estão saindo) do suporte de segurança, e testar a 8.0 hoje é fazer o trabalho duas vezes. A lista de versões com suporte está na página oficial de versões suportadas do PHP.

O cPanel permite escolher a versão do PHP por domínio e por subdomínio. As versões da linha 8 estão disponíveis como pacotes do EasyApache 4, o sistema que monta o servidor por trás do cPanel, conforme a documentação oficial do cPanel sobre PHP 8. Se o seletor de versões do seu cPanel não mostra nenhuma versão 8, isso é assunto para o suporte da hospedagem, não para o seu desenvolvedor: significa que o pacote não está instalado no servidor.

Teste sem risco: da cópia ao clique finalCopiar arquivosPasta teste-php8 dentro do siteProteger com senhaNinguém acha a cópiaCriar subdomínioEndereço só para testeTrocar a versãoPHP 8 só no testeClicar em tudoAnotar o que falhou
As cinco etapas do teste, todas por cliques no cPanel. O site de verdade continua na versão antiga em todas elas.

O que separar antes do primeiro clique

Separe isto. Leva cinco minutos e evita o pior tipo de dor de cabeça.

Um aviso antes do primeiro clique: se o seu site dispara e-mails automáticos (confirmação de pedido, recuperação de carrinho, resposta de formulário), a cópia também vai disparar. Trate disso na seção de erros comuns, mais abaixo, antes de sair clicando em "finalizar compra" na cópia.

Montando a cópia, passo a passo

Criar a pasta teste-php8 e copiar os arquivos do site

No cPanel, abra Arquivos > Gerenciador de Arquivos. Entre na pasta public_html, que é onde mora o site. Clique em + Pasta e crie uma pasta chamada teste-php8.

Agora selecione tudo o que está dentro de public_html, menos a pasta teste-php8 que você acabou de criar, clique em Copiar e informe o destino como /public_html/teste-php8.

Resultado esperado: a pasta teste-php8 com os mesmos arquivos do site. Se você selecionar a própria teste-php8 na hora de copiar, o cPanel copia a pasta dentro dela mesma e você termina com cópia da cópia, ocupando espaço em disco à toa. Se acontecer, apague a pasta de dentro e repita.

Se a cópia demorar ou der erro de tempo esgotado, o site é grande demais para copiar assim. Nesse caso, peça ao suporte (frase pronta no fim do artigo).

Proteger a pasta com senha antes de qualquer outra coisa

Não pule e não deixe para depois. Enquanto a pasta não tem senha, a cópia responde em seusite.com.br/teste-php8 para qualquer pessoa, inclusive para o Google, com o mesmo conteúdo do site oficial. Faça este passo na mesma sessão, logo após a cópia terminar.

No cPanel, abra Arquivos > Privacidade de Diretório, escolha a pasta teste-php8, marque a opção de proteger e crie um usuário e uma senha.

Resultado esperado: ao abrir seusite.com.br/teste-php8 no navegador, o navegador pede usuário e senha antes de mostrar qualquer coisa. Isso impede que o Google trate a cópia como conteúdo duplicado do seu site e impede que um cliente caia nela por acidente.

Se você quiser zero exposição, existe a ordem inversa: criar a pasta, protegê-la ainda vazia e só então copiar os arquivos. Funciona, com um detalhe: entre os arquivos copiados vem o .htaccess do site, que pode substituir o arquivo criado pela proteção. Depois da cópia, teste o endereço; se a senha não for mais pedida, refaça este passo.

Criar o subdomínio de teste apontando para a pasta

No cPanel, abra Domínios > Domínios (ou Subdomínios, dependendo da versão) e crie um subdomínio chamado teste. No campo da pasta, aponte para /public_html/teste-php8.

Resultado esperado: ao abrir teste.seusite.com.br no navegador, ele pede a senha que você criou no passo 2 e depois aparece o seu site. Pode aparecer torto, com imagens faltando ou links que voltam para o site original. Isso é normal e está tratado na seção de erros comuns. O que importa agora é que abriu.

Se der "site não encontrado", espere alguns minutos: subdomínio novo leva um tempo para começar a responder.

Duplicar o banco de dados, se o site tiver um

No cPanel, abra Bancos de Dados > Bancos de Dados MySQL e crie um banco novo, com nome tipo teste8. Crie também um usuário novo para ele e dê a esse usuário todos os privilégios sobre o banco novo. Anote nome do banco, nome do usuário e senha.

Depois abra Bancos de Dados > phpMyAdmin, selecione o banco original na coluna da esquerda, vá na aba Exportar e baixe o arquivo. Em seguida selecione o banco novo, vá na aba Importar e envie o arquivo baixado.

Resultado esperado: o banco teste8 aparece com a mesma lista de tabelas do banco original.

Apontar a cópia para o banco novo e prendê-la no endereço de teste

Este é o passo mais delicado e o único que mexe no conteúdo de um arquivo. No Gerenciador de Arquivos, dentro de teste-php8, localize o arquivo de configuração. No WordPress ele se chama wp-config.php. Clique com o botão direito, escolha Editar e troque o nome do banco, o usuário e a senha (as linhas DB_NAME, DB_USER e DB_PASSWORD) pelos que você acabou de criar.

Ainda no mesmo arquivo, logo abaixo dessas linhas, cole estas duas, trocando o endereço pelo seu subdomínio:

define('WP_HOME','https://teste.seusite.com.br');
define('WP_SITEURL','https://teste.seusite.com.br');

Salve.

Essas duas linhas existem por um motivo sério: sem elas, entrar no painel administrativo da cópia pode jogar você direto no painel do site de verdade, com a mesma cara e o mesmo login. A partir daí, você edita o site no ar achando que está mexendo na cópia. Não abra o painel da cópia antes de salvar as duas linhas.

Como conferir que a cópia está usando o banco novo, sem tocar no site oficial: abra Bancos de Dados > phpMyAdmin, selecione o banco teste8 na coluna da esquerda, abra a tabela wp_options, procure a linha cujo nome é blogname e troque o valor para COPIA DE TESTE. Salve. Agora abra teste.seusite.com.br: o nome do site deve aparecer como "COPIA DE TESTE". Abra o site oficial em outra aba: o nome dele continua o original, e na tabela wp_options do banco antigo o valor de blogname está intacto.

Resultado esperado: o nome mudou só na cópia. Se o site oficial também mudou, pare tudo: a cópia está ligada ao banco original. Volte ao phpMyAdmin, desfaça o valor de blogname e revise o arquivo de configuração.

Se o site não é WordPress, o arquivo de configuração tem outro nome e outra estrutura. Se você não se sentir seguro para editá-lo, pare aqui e peça ao desenvolvedor. É um pedido de cinco minutos para quem faz isso todo dia.

Escolher a versão 8 mais recente só para o subdomínio de teste

No cPanel, abra Software > MultiPHP Manager. Você vai ver a lista de domínios e subdomínios da conta, cada um com a versão de PHP que usa hoje. Marque apenas teste.seusite.com.br e abra a lista de versões.

A lista não traz "PHP 8". Ela traz opções como PHP 8.0, PHP 8.1, PHP 8.2, PHP 8.3 e, em servidores mais novos, versões seguintes. Escolha a mais recente que aparecer. Marcar a 8.0 só porque "é PHP 8" resolve pouco: ela também já saiu do suporte de segurança, e em um ano você repete o teste inteiro. Aplique.

Resultado esperado: na tabela, o subdomínio de teste passa a mostrar a versão que você escolheu, e o domínio principal continua na versão antiga. Se nenhuma versão 8 aparece na lista, o pacote não está instalado no servidor; abra chamado no suporte.

Ligar o display_errors para o erro aparecer na tela

Por padrão, um servidor bem configurado esconde as mensagens de erro do visitante e as guarda em um arquivo. Para o teste, você quer o contrário: quer ver a mensagem.

No cPanel, abra Software > MultiPHP INI Editor, selecione o subdomínio de teste no alto da página e ligue a opção display_errors. Salve.

Resultado esperado: se houver algum problema, em vez de tela branca aparece um texto em inglês na página. Lembre de desligar isso ao terminar o teste, e nunca ligue no site de verdade.

Lendo o erro: tipo, caminho do arquivo e número da linha

Agora abra a cópia e use o site como um cliente usaria: home, páginas internas, busca, formulário de contato, login, carrinho, painel administrativo. Anote tudo que se comportar diferente.

Se aparecer uma mensagem de erro, ela quase sempre tem esta forma (exemplo fictício, criado para ilustrar o formato, não retirado do seu site):

Fatal error: Uncaught Error: Call to undefined function nome_da_funcao()
in /home/usuario/public_html/teste-php8/wp-content/themes/meutema/functions.php:214

Só importam três pedaços:

Se a tela ficou branca mesmo com display_errors ligado, a mensagem está no arquivo de log. No Gerenciador de Arquivos, dentro de teste-php8, procure um arquivo chamado error_log, clique com o botão direito e escolha Ver. As últimas linhas do arquivo são as mais recentes.

O que cada resultado significa e o que fazer com ele

O que apareceu na cópia Leitura provável O que fazer
Tudo funcionou, nada de diferente O site está compatível com a versão testada Agendar a troca no site de verdade, na mesma versão testada, em horário de baixo movimento
Deprecated ou Warning em algumas telas Código velho, ainda funciona Pode trocar, mas peça a correção; na próxima versão isso vira erro
Fatal error apontando para wp-includes ou wp-admin Núcleo do WordPress desatualizado Atualizar o WordPress na cópia e testar de novo
Fatal error apontando para um plugin Plugin abandonado ou desatualizado Verificar se há atualização; se não houver, procurar substituto
Fatal error apontando para o tema Tema comprado sem atualização Contatar quem vendeu o tema, ou orçar a correção
Fatal error em pasta de sistema sob medida Código da agência Orçamento de adequação com o desenvolvedor
Site abre, mas formulário ou pagamento não conclui Integração com serviço externo Testar cada integração separadamente e listar as que falharam

Um detalhe que confunde muita gente: da versão 7 para a 8, uma parte dos avisos que antes apenas apareciam no log passou a interromper a execução da página. Não é que o seu site ficou pior. É que um problema que já existia deixou de ser ignorado.

O que fazer com cada resultado do testeNada de diferenteAgende a troca no site realAviso na telaPode trocar, peça correçãoErro no núcleoAtualize o sistema e repitaErro em pluginAtualizar ou trocar de pluginErro no temaFalar com quem vendeu o temaErro em código sob medidaOrçamento com o desenvolvedor
O caminho do arquivo no erro diz de quem é a tarefa. É isso que transforma um pedido aberto em orçamento fechado.

Os quatro erros que o próprio teste cria

Quatro coisas vão dar errado na cópia sem que exista qualquer problema com o PHP 8. Saber disso evita você mandar um chamado alarmado por nada.

Você clica em uma página interna da cópia e o navegador vai para www.seusite.com.br. Acontece porque o endereço do site está gravado dentro do banco de dados. Não é sinal de incompatibilidade. É exatamente para isso que servem as duas linhas do passo 5: com elas salvas, a cópia se prende ao endereço de teste, inclusive no painel administrativo. Se você ainda não as colocou, navegue sempre digitando teste.seusite.com.br na barra e não entre em painel nenhum.

Imagens e formatação sumidas na cópia

A cópia aparece sem estilo, com texto empilhado. Mesma causa do item anterior: os endereços de imagens e arquivos de estilo apontam para o domínio original. Feio, mas o que interessa no teste é se a página abre e se as funções respondem, não se ela está bonita.

Confundir o banco de teste com o banco oficial

O risco real deste método é editar o site de verdade achando que é a cópia, ou a cópia continuar ligada ao banco oficial e você apagar um pedido durante o teste. Por isso o passo 5 existe inteiro: banco novo no arquivo de configuração, endereço preso ao subdomínio e a conferência feita pelo phpMyAdmin, mexendo no banco de teste e vendo o banco antigo intacto. Faça essa conferência antes de clicar em qualquer coisa que grave dados.

E-mails reais disparados pela cópia

Se você testar o formulário de contato ou finalizar um pedido de mentira, o sistema pode enviar e-mail de verdade para clientes de verdade, além de mexer em estoque e em numeração de pedido. Antes de testar compra ou envio de formulário, avise o desenvolvedor e peça para desativar o envio de e-mails e a integração de pagamento na cópia. Se não der, limite o teste a abrir as páginas e entrar no painel administrativo. Já resolve a maior parte da dúvida.

Corrigir agora ou segurar a versão antiga com data no calendário

O teste serve para transformar uma dúvida em uma de duas decisões, com custo conhecido.

Se a cópia funcionou, agende a troca no domínio principal pelo mesmo MultiPHP Manager, escolhendo a mesma versão 8.x que você testou, fora do horário de pico, com o backup na mão. Se algo aparecer depois, voltar a versão antiga é o mesmo caminho de cliques, em sentido contrário.

Se apareceu erro fatal, você agora sabe de quem é a culpa: do tema, de um plugin, do núcleo do sistema ou do código feito sob medida. Essa informação muda completamente o orçamento. "Meu site não funciona no PHP 8" é um pedido aberto. "O arquivo functions.php do tema dá erro fatal na linha 214 quando o subdomínio roda em PHP 8.3" é uma tarefa fechada.

Segurar na versão antiga é uma decisão legítima, mas com prazo. Rodar em uma versão de PHP que não recebe mais correção de segurança é assumir um risco que cresce com o tempo, e o custo da adequação também cresce: quanto mais versões o site fica para trás, maior o salto. Se você decidir adiar, coloque uma data no calendário e um orçamento na planilha. Adiar sem data é como não decidir.

Quando terminar, faça a limpeza: desligue o display_errors no MultiPHP INI Editor, apague o subdomínio de teste, apague a pasta teste-php8 e apague o banco de dados de teste. Cópia esquecida no servidor é código velho exposto, e uma porta a mais para quem procura porta.

Frases prontas para o chamado ao suporte e ao desenvolvedor

Copie, troque o que estiver entre colchetes e envie.

Para o suporte da hospedagem, quando nenhuma versão 8 aparece na lista:

Olá. No MultiPHP Manager da minha conta, a lista de versões não
mostra nenhuma versão da linha 8 para o subdomínio
teste.[seusite].com.br. Quais versões do PHP estão instaladas no
servidor via EasyApache 4? A versão 8 mais recente que vocês
oferecem está disponível? Quero testar a compatibilidade do site
em um subdomínio antes de trocar a versão do domínio principal.

Para o suporte, quando a cópia dos arquivos falha por ser muito grande:

Olá. Preciso duplicar o conteúdo de public_html para a pasta
public_html/teste-php8, para testar o site em PHP 8 sem mexer
no domínio principal. A cópia pelo Gerenciador de Arquivos não
conclui. Vocês conseguem fazer essa cópia no servidor? O site
oficial deve continuar inalterado.

Para o desenvolvedor, com o resultado do teste em mãos:

Olá. Montei uma cópia do site no subdomínio teste.[seusite].com.br,
rodando em PHP [versão exata que você marcou, por exemplo 8.3],
com banco de dados separado. O site oficial continua na versão atual.

Na cópia aparece este erro:
[cole aqui o texto completo, com o caminho do arquivo e o número
da linha]

Acontece ao [descrever o que você estava fazendo: abrir a home,
entrar no painel, enviar o formulário].

Preciso de: (1) sua avaliação do que causa isso, (2) estimativa
de horas para corrigir e (3) se há risco de o problema se repetir
em outras partes do site. Acesso ao cPanel eu forneço.

Para o desenvolvedor, quando você não quer editar o arquivo de configuração:

Olá. Copiei o site para a pasta public_html/teste-php8, protegi a
pasta com senha e criei o subdomínio teste.[seusite].com.br
apontando para ela. Também criei um banco de dados novo e importei
o dump do banco atual.

Falta (1) apontar a cópia para esse banco novo e (2) fixar o
endereço da cópia no próprio subdomínio, para o painel da cópia
não redirecionar para o site oficial. Você consegue ajustar o
arquivo de configuração apenas dentro da pasta teste-php8, sem
tocar no site oficial? Envio nome do banco, usuário e senha por
canal seguro.

Se o desenvolvedor responder que "é melhor não mexer" sem apresentar o erro específico, peça o texto do erro. Se ele não conseguir mostrar um erro, é porque não testou.

Referências

  1. Documentação oficial (cpanel) — PHP 8 (EasyApache 4). Consultado em 2026-09-28.
Leia também