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.

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
- O que "quebrar" quer dizer: tela branca, erro fatal ou função que para
- A ideia do teste: uma cópia do site rodando sozinha no PHP 8
- O que separar antes do primeiro clique
- Montando a cópia, passo a passo
- Lendo o erro: tipo, caminho do arquivo e número da linha
- Os quatro erros que o próprio teste cria
- Corrigir agora ou segurar a versão antiga com data no calendário
- 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:
- Tela branca: a página abre em branco, sem nada. Para o visitante, é um site fora do ar.
- Erro fatal: aparece um texto em inglês com o nome de um arquivo e um número de linha. Feio, mas é a melhor coisa que pode acontecer, porque diz exatamente onde está o problema.
- Funciona, mas alguma coisa some: o formulário de orçamento não envia, o carrinho não fecha, o painel de administração não entra. É o pior caso, porque ninguém percebe até o cliente reclamar.
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:
- Copiar os arquivos do site para uma pasta separada.
- Proteger essa pasta com senha, antes de qualquer outra coisa.
- Criar um endereço de teste (um subdomínio, algo como
teste.seusite.com.br) que aponte para essa pasta. - Colocar só esse endereço de teste em uma versão 8 do PHP. O site de verdade continua na versão antiga, intacto.
- 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.
O que separar antes do primeiro clique
Separe isto. Leva cinco minutos e evita o pior tipo de dor de cabeça.
- Acesso ao cPanel (endereço, usuário e senha). Normalmente veio no e-mail de boas-vindas da hospedagem.
- Um backup completo e recente, gerado por você agora, não o backup automático de ontem. No cPanel, em Arquivos > Backup, clique em "Baixar um backup completo da conta" ou baixe separadamente o backup dos arquivos e o do banco de dados.
- Saber se o site usa banco de dados. Se é WordPress, loja virtual, sistema de pedidos ou qualquer coisa com área de login, usa. Se é um site de cinco páginas feito só em HTML, provavelmente não usa, e o teste fica muito mais simples.
- Meia hora sem pressa, de preferência em horário de pouco movimento.
- O contato do desenvolvedor, porque o resultado do teste pode virar um pedido de correção.
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:
- O tipo:
Fatal errorderruba a página.WarningouDeprecatedsujam a tela mas o site continua funcionando. - O caminho do arquivo: em
wp-content/themes/meutema/é o tema. Emwp-content/plugins/nome-do-plugin/é um plugin. Emwp-includes/ouwp-admin/é o próprio WordPress, e aí a correção costuma ser só atualizar. Se o caminho aponta para uma pasta com o nome da agência ou do sistema interno, é código feito sob medida. - O número depois dos dois-pontos:
:214é a linha. O desenvolvedor vai direto nela.
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.
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.
Links da cópia que levam de volta ao site original
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
- Documentação oficial (cpanel) — PHP 8 (EasyApache 4). Consultado em 2026-09-28.