Todos os clientes da Kinsta podem facilmente escolher a versão do PHP para um site WordPress no painel MyKinsta. Recomendamos usar a versão mais recente do PHP compatível com sua instalação do WordPress.

Como você deve ter ouvido, o PHP agora segue um cronograma de lançamento previsível. Cada nova versão recebe manutenção ativa por dois anos e mais um ano de atualizações críticas de segurança. Para garantir que seus sites WordPress sejam o mais rápidos e seguros possível, adotamos o mesmo cronograma, o que significa que removeremos as versões de PHP não suportadas quando atingirem o fim de vida útil (EOL).

Por que atualizar a versão do PHP do seu site WordPress?

As duas principais razões para atualizar a versão do PHP em seu site são segurança e desempenho.

Assim como você atualiza o próprio WordPress para se certificar de que está protegido contra vulnerabilidades de segurança, você deve fazer o mesmo com o PHP. Além disso, a atualização do PHP geralmente resulta em um aumento significativo da velocidade, como mostram nossos relatórios de benchmark do PHP.

Para obter mais detalhes, consulte nosso artigo sobre as versões suportadas do PHP.

Não tem certeza de qual versão do PHP você está executando? Você pode verificar no menu Ferramentas do painel MyKinsta. Ou, você pode ver a versão do PHP usando a ferramenta Site Health do WordPress:

Captura de tela exibindo a versão do PHP na ferramenta Site Health do WordPress.
Verificando a versão do PHP na ferramenta Site Health do WordPress.

E se meu site parar de funcionar?

Os problemas causados pela atualização das versões do PHP ocorrem quando o código executado em seu site usa funções antigas que não são mais suportadas pelas versões mais recentes do PHP. É provável que o culpado seja um plugin ou um tema ativo. Nosso guia abaixo contém instruções passo a passo sobre como solucionar esse problema.

Como atualizar as versões do PHP no WordPress

Vamos examinar as etapas sobre a melhor forma de testar a compatibilidade do seu site WordPress antes de atualizar as versões do PHP. Muitos de vocês não devem passar por nenhum tempo de inatividade, e será necessário pouco trabalho.

Para outros, talvez sejam necessários testes adicionais, solução de problemas e até mesmo a contratação de um desenvolvedor do WordPress para tornar as coisas compatíveis.

Se você quiser simplesmente atualizar a versão do PHP em seu ambiente WordPress ativo imediatamente, poderá pular para a Etapa 5. No entanto, é altamente recomendável que você siga todas as etapas abaixo para garantir que tudo funcione corretamente.

Especialmente se você estiver executando uma versão mais antiga, como o PHP 7.4.

  1. Criar um site de teste
  2. Alterar a versão do PHP
  3. Testar o site, os plugins e o tema
  4. Mover o site de teste para o site de produção
  5. Atualizar o PHP no site ativo

Etapa 1 – Criar um site de teste

A primeira coisa que você deve fazer é criar um site de teste. Ele é separado do seu ambiente de produção e permitirá que você teste versões mais recentes do PHP sem quebrar o seu site ativo.

No painel MyKinsta clique em Sites WordPress na navegação à esquerda. Você verá uma lista de seus sites. Clique naquele para o qual você deseja alterar a versão do PHP. Em seguida, clique na barra de pesquisa ou pressione CMD + / ou CTL + / no teclado, e selecione a opção Criar novo ambiente.

Captura de tela mostrando a criação de um novo ambiente de site no MyKinsta.
Criando um novo ambiente no MyKinsta.

A partir daqui, siga as etapas em nossa documentação para criar um ambiente de teste do WordPress.

Certifique-se de verificar também as notas importantes sobre ambientes de teste. Por exemplo, se você estiver usando um CDN de terceiros, talvez seja necessário desativá-lo para que seu site seja renderizado corretamente.

Isso ocorre porque seu site de teste usa uma URL diferente. O armazenamento em cache também é desativado nos ambientes de teste padrão, portanto, lembre-se disso se você estiver tentando testar o desempenho.

Etapa 2 – Alterar a versão do PHP

Para atualizar a versão do PHP do seu site WordPress, navegue até Sites WordPress > nome do ambiente > Ferramentas e, em seguida, clique no botão Alterar no cartão de configurações do PHP:

Captura de tela mostrando a página de ferramentas do site WordPress no painel MyKinsta.
Iniciando uma atualização do PHP para um único ambiente do WordPress.

Como alternativa, você pode executar uma atualização do PHP em massa para vários ambientes na página Sites WordPress. No exemplo abaixo, marcamos as caixas de seleção ao lado dos nomes de vários ambientes de teste e escolhemos Alterar configurações de PHP no menu suspenso Ações:

Captura de tela mostrando ações em massa sendo realizadas em vários ambientes WordPress no painel do MyKinsta.
Iniciando uma atualização do PHP para vários ambientes do WordPress.

Seja qual for o caminho escolhido, a próxima etapa é escolher a versão do PHP que você deseja adotar e clicar no botão Alterar configurações do PHP:

Uma captura de tela mostrando a seleção do PHP 8.4 durante a atualização das configurações de PHP no painel do MyKinsta.
Selecionando uma atualização de versão do PHP para a versão 8.4.

Nota: Ao atualizar em massa vários ambientes WordPress, a versão do PHP escolhida será aplicada a todos eles.

Seja qual for o método que você escolher no MyKinsta, o processo de atualização pode levar até três minutos. Quando concluído, o mecanismo PHP será reiniciado, o que pode resultar em alguns segundos de inatividade somente para o backend do WordPress. Os visitantes do seu site não sofrerão nenhum tempo de inatividade.

Enquanto a versão do PHP estiver sendo alterada, você poderá navegar em outras partes do MyKinsta, mas algumas ações – como o gerenciamento de cache – ficarão indisponíveis até que o novo mecanismo seja ativado. Você receberá uma notificação no painel de controle assim que a alteração for feita.

Etapa 3 – Testar o site, os plugins e o tema

Agora, você deve ter um site de teste em funcionamento com a versão mais recente do PHP (ou a versão para a qual deseja mudar). A primeira coisa que você deve fazer é simplesmente navegar e clicar no seu site WordPress para ver se há algo quebrado.

Se algo for incompatível, como um plugin ou seu tema, você poderá ver um erro 500 (501, 502, 503, 504, etc.) ou uma tela branca da morte no frontend do seu site. Nesse caso, a maneira mais fácil e rápida de determinar o que pode estar causando isso é desativar todos os plugins de terceiros e reativá-los um a um. Lembre-se de que você está em um site de teste, então não precisa se preocupar em causar danos.

No painel do WordPress, na tela Plugins, selecione todos os seus plugins. Em seguida, selecione Desativar no menu suspenso Ações em massa e clique em Aplicar.

Captura de tela da página de plugins do WordPress e do menu suspenso de Ações em Massa.
Como desativar plugins do WordPress em massa a partir do painel.

Depois, você pode reativá-los um por um, visitando seu site WordPress a cada vez. Isso ajudará a identificar o que pode estar causando o problema. Não tem acesso ao painel do WordPress por causa de um erro? Sem problemas, confira como desativar plugins via FTP.

Os mesmos testes podem ser aplicados ao seu tema WordPress. Você pode alternar temporariamente para o tema padrão do WordPress, como o tema Twenty Nineteen.

Visualizando arquivos de registro no MyKinsta

Talvez você tenha determinado qual plugin ou tema está causando o problema, mas não tem certeza do motivo? É aqui que os registros de erros do WordPress podem ser úteis. Basta clicar em um de seus sites WordPress e, no lado direito, clicar em Registros de Erros.

Você pode visualizar os arquivos error.log, kinsta-cache-perf.log e access.log. Por padrão, ele mostrará as últimas 1.000 linhas. Você pode usar o menu suspenso de contagem de linhas para selecionar uma quantidade maior (até 20.000 linhas).

Captura de tela do visualizador de logs do MyKinsta.
O arquivo error.log no visualizador de registros do MyKinsta.

Importante: A ferramenta de registros do MyKinsta não mostra informações de depuração. Se precisar visualizar informações de depuração, você pode habilitar WP_DEBUG, como mostraremos a seguir.

Visualizar arquivos de registro brutos via SFTP

Você pode ver os registros completamente não modificados em /logs/ via SFTP.

Pasta de registros de erros do WordPress via SFTP
Pasta de registros de erros do WordPress via SFTP

Acompanhe seus arquivos de registro via SSH

Você pode acompanhar os registros enquanto faz experiências em seu site usando SSH. Isso basicamente significa que você pode assistir à atualização do registro em tempo real durante o teste. Todos os planos de hospedagem da Kinsta incluem acesso SSH.

Mostrar as últimas 500 linhas

tail -n 500 /www/sitename/logs/error.log

Ver o arquivo em tempo real

Veja a atualização do arquivo de registro de erros em tempo real.

tail -f /www/sitename/logs/error.log

Para você que tem acesso SSH, o WP-CLI também pode ser uma ferramenta valiosa.

Habilitar o modo de depuração no MyKinsta

Para os usuários da Kinsta, o modo de depuração do WordPress pode ser habilitado diretamente no painel MyKinsta. Basta navegar até o site e o ambiente do WordPress para o qual você deseja habilitar a depuração. Clique em Ferramentas no menu à esquerda e, em seguida, clique no botão Habilitar na ferramenta Depuração do WordPress. Isso permitirá que você veja os erros e avisos do PHP sem precisar ativar o modo de depuração via SSH ou SFTP.

Habilitando a depuração do WordPress no MyKinsta.
Habilitando a depuração do WordPress no MyKinsta.

Nosso recurso de autocorreção do PHP reinicia automaticamente o PHP se você perceber algum problema. Se precisar reiniciar manualmente o PHP por qualquer motivo, você pode fazer isso acessando a página Ferramentas do seu site e clicando em Reiniciar PHP.

Reiniciando o PHP no MyKinsta.
Reiniciando o PHP no MyKinsta.

Habilitar o registro de depuração no WordPress

Se não tiver acesso SSH ou MyKinsta, você sempre pode habilitar o registro de depuração no WordPress. Primeiro, você precisará se conectar ao seu site via SFTP. Em seguida, baixe seu wp-config.php para que você possa editá-lo.

Baixar o arquivo wp-config.php
Baixar o arquivo wp-config.php.

Encontre a linha que diz /* That's all, stop editing! Happy blogging. */ e, logo antes dela, adicione o seguinte (conforme mostrado abaixo):

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); - define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Habilitando o registro de depuração no WordPress
Habilitando o registro de depuração no WordPress.

Se o código acima já existir em seu arquivo wp-config.php, mas estiver definido como “false”, basta alterá-lo para “true” Isso ativará o modo de depuração e mostrará tudo no arquivo /wp-content/debug.log. Você também verá avisos e erros no administrador do WordPress, se existirem.

Importante: Não se esqueça de desativá-lo quando você terminar, pois esses arquivos podem ficar muito grandes rapidamente.

Confuso sobre o que procurar?

Há milhares de plugins e temas no mercado, portanto, infelizmente, é impossível listar todos os erros que você pode encontrar. Normalmente, eles ocorrem devido à incompatibilidade do código (funções, sintaxe, etc.) com a versão do PHP que você está usando. Entretanto, aqui está um exemplo de algo que você pode ver.

500: Erro fatal: Uncaught Error: Um ponto e vírgula (';') é esperado aqui. in /www/sitename/public/wp-content/plugins/bbpress-shortcodes/bbpress-shortcodes.php:177

Como você pode ver no exemplo acima, é fácil identificar rapidamente que o problema está no plugin bbPress Shortcodes.

Se você encontrar problemas de compatibilidade com um ou dois plugins, aqui está o que aconselhamos:

  1. Atualize seus plugins e temas para a versão mais recente, se ainda não tiver feito isso.
  2. Entre em contato com o desenvolvedor do plugin ou do tema e peça que ele adicione/corrija o suporte ao PHP 7.4 (ou à versão atual que você está usando). Esse é um dos motivos pelos quais estamos avisando você antes das datas de desativação!
  3. Encontre um plugin alternativo que possa oferecer a mesma funcionalidade e seja compatível com a versão do PHP.
  4. Contrate um desenvolvedor do WordPress para corrigir o problema.
  5. Altere seu mecanismo PHP para uma versão inferior e veja se o plugin ou tema funciona. Se isso acontecer, você poderá executar uma versão inferior do PHP até que o desenvolvedor atualize seu código. Não recomendamos que você faça isso, pois o PHP 8.0 é mais rápido e continuará sendo suportado por um período mais longo. Mas se houver algo que você precisa absolutamente executar e só funciona no PHP 7.4, talvez seja necessário recorrer a isso.

Etapa 4 – Mover o site de teste para o site de produção

Depois de terminar os testes do seu site com o PHP, se você precisou fazer alterações em seus plugins ou temas, pode optar por mover o site de teste para o site de produção ou replicar manualmente as mesmas alterações no site de produção.

Caso tenha feito ajustes significativos no ambiente de teste para garantir a compatibilidade do site com a nova versão do PHP, usar o recurso de mover para produção permitirá aplicar essas alterações de forma rápida e eficiente, economizando tempo e esforço.

Para fazer isso, certifique-se de que você tenha selecionado o ambiente de teste. Em seguida, clique no botão Mover ambiente para.

Captura de tela mostrando o recurso de Mover Ambiente no MyKinsta em uso.
Mover o site de teste para o site de produção no MyKinsta com a ferramenta Mover Seletivamente.

Sinta-se à vontade para entrar em contato com nossa equipe de suporte 24/7 caso tenha dúvidas ou problemas ao atualizar a versão do PHP no seu site WordPress.

Etapa 5 – Atualizar o PHP em seu site ativo

Agora que o PHP está pronto para ser atualizado, você pode alterar a versão do PHP em seu site ativo da mesma forma que fez usando os métodos descritos na Etapa 2 acima.