Veja como trocar a versão do PHP, ligar extensões e mudar limites como memory_limit e upload_max_filesize no cPanel, pelo Select PHP Version.
Na hospedagem cPanel com CloudLinux, cada conta escolhe a própria versão do PHP, liga e desliga extensões e ajusta opções do php.ini sem pedir nada ao suporte. Tudo isso fica numa tela só: o Select PHP Version (o PHP Selector do CloudLinux).
Antes de começar
- Confira a compatibilidade do site. WordPress recomenda PHP 8.3 ou mais novo. Sistemas antigos podem quebrar no PHP 8: veja a versão mínima e máxima que o desenvolvedor do seu sistema ou dos seus plugins suporta.
- Saiba qual versão está em uso hoje. No WordPress, vá em Ferramentas » Saúde do site » Informações » Servidor. Em outros sites, crie um
info.phpcom<?php phpinfo();, abra no navegador e apague o arquivo logo depois, porque ele expõe detalhes do servidor. - Faça um backup antes de trocar de versão, para poder voltar rápido se algo quebrar.
Como alterar a versão do PHP no cPanel
- Entre no cPanel e abra Select PHP Version, na seção Software. Se não achar, digite "PHP" na busca do topo.
- Escolha a versão. No topo da tela aparece a versão atual. Clique nela, escolha a nova na lista e confirme (em algumas telas o botão é Set as current ou Apply).
- Teste o site numa janela anônima: página inicial, login, formulário e área administrativa. Se algo quebrar, volte para a versão anterior na mesma tela; a troca vale na hora.
A opção native significa "usar a versão padrão do servidor". Ela não deixa mexer em extensões nem em opções: para personalizar, escolha uma versão numerada.
Como ativar ou desativar extensões do PHP
- Na mesma tela, abra a aba Extensions. Aparece a lista de módulos disponíveis para a versão escolhida.
- Marque ou desmarque o que precisa. As mais pedidas:
intl,gdouimagick(imagens),zip,mbstring,pdo_mysqlemysqli(banco),soapebcmath. Dependendo da versão da tela, a mudança é salva automaticamente ou com um botão Save. - Para desfazer tudo, use Reset to default, que volta à lista padrão daquela versão.
Como mudar memory_limit, upload_max_filesize e outras opções
- Abra a aba Options (em telas antigas, o link Switch to PHP Options).
- Altere o valor desejado escolhendo na lista ao lado de cada diretiva. Os valores oferecidos são os que o servidor permite.
- Confira o resultado no
phpinfo()ou em Saúde do site, no WordPress.
As opções mais usadas:
| Diretiva | Para que serve |
|---|---|
memory_limit | Memória máxima de cada execução do PHP. Erros "Allowed memory size exhausted" pedem um valor maior. |
upload_max_filesize | Tamanho máximo de um arquivo enviado por formulário ou pelo WordPress. |
post_max_size | Tamanho total do envio. Deve ser igual ou maior que o upload_max_filesize. |
max_execution_time | Tempo máximo, em segundos, que um script pode rodar. |
max_input_vars | Quantidade de campos aceitos num formulário. Menus grandes no WordPress costumam precisar de mais. |
display_errors | Mostra erros na tela. Ligue só para testar e desligue depois. |
Select PHP Version, MultiPHP Manager e arquivo htaccess: qual usar
O cPanel tem duas ferramentas de versão de PHP, e é fácil se confundir:
- Select PHP Version (CloudLinux): o caminho principal descrito acima, com versão, extensões e opções na mesma tela.
- MultiPHP Manager e MultiPHP INI Editor (cPanel): definem a versão por domínio. Quando um domínio está com uma versão fixa aqui, o Select PHP Version não vale para ele. Para usar o Select PHP Version, deixe o domínio como inherit no MultiPHP Manager.
Para mudar uma opção só numa pasta do site, use php_value ou php_flag no arquivo .htaccess daquela pasta. No servidor LiteSpeed isso funciona, e o bloco abaixo não causa erro se o site um dia mudar de servidor:
<IfModule lsapi_module>
php_value memory_limit 512M
php_value max_input_vars 5000
php_flag display_errors Off
</IfModule>.user.ini colocados na pasta do site, comuns em tutoriais, são ignorados no nosso ambiente LiteSpeed. E nem toda diretiva pode ir no .htaccess: as do tipo "sistema", como allow_url_fopen, só mudam pelo Select PHP Version.Problemas comuns
Mudei a versão e o site continua mostrando a antiga
O domínio está com versão fixa no MultiPHP Manager, ou há uma linha AddHandler ou SetHandler antiga no .htaccess forçando outra versão. Deixe o domínio como inherit e apague essas linhas (guarde uma cópia antes).
Erro 500 depois de trocar a versão
O código ou um plugin não é compatível com a versão nova, ou falta uma extensão. Volte para a versão anterior, veja o arquivo error_log da pasta do site e atualize o que estiver desatualizado.
Não aparece a extensão de que preciso
Algumas extensões, como o ionCube Loader, não estão disponíveis em todas as versões. Abra um chamado informando a extensão e a versão do PHP.
