# 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.

> 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.

João Rizzon · 2026-09-29 · Painéis

---

## 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](https://www.php.net/supported-versions.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](https://docs.cpanel.net/ea4/php/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 error` derruba a página. `Warning` ou `Deprecated` sujam a tela mas o site continua funcionando.
- **O caminho do arquivo**: em `wp-content/themes/meutema/` é o tema. Em `wp-content/plugins/nome-do-plugin/` é um plugin. Em `wp-includes/` ou `wp-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.

