PHP: selecionar versão, módulos e configuração básica

Todos os nossos serviços dão flexibilidade na escolha da versão de PHP a utilizar, e pode fazê-lo a partir da área de cliente ou do cPanel.

A partir da área de cliente

Entre em Alojamento, abra o seu serviço e vá a PHP. Carregue em Alterar na linha de um site: a sua ficha tem quatro separadores.

• Versão: muda a versão desse site ou a versão predefinida, com estudo de compatibilidade, verificação e 24 horas para reverter. É explicado em Mudar a versão de PHP de um site.
• Extensões: ativa ou desativa os módulos da versão que o site utiliza.
• Limites: ajusta memory_limit, upload_max_filesize, post_max_size, max_execution_time e max_input_vars.
• Erros: mostra os erros desse site.

As extensões e os limites pertencem à versão de PHP em toda a conta, não ao site. Se ativar um módulo no PHP 8.3, fica ativo em tudo o que corre em 8.3. Antes de alterar seja o que for, a ficha indica que outros sites partilham essa versão.

Ao ativar um módulo que não pode coexistir com outro, como mysqli e nd_mysqli, desativamos primeiro o incompatível e informamo-lo disso. Depois de cada alteração, verificamos que ficou aplicada; se o servidor não a aceitar, indicamo-lo e deixamos tudo como estava.

A partir do cPanel

Mudar a versão de PHP

Aceda ao painel de controlo cPanel, secção Select PHP Version.

Selecione no menu pendente a versão pretendida e aplique a alteração com a ação que aparece junto ao seletor. Esta alteração afeta a versão predefinida do seu alojamento, a que utilizam os sites sem versão própria.

Anote primeiro a versão e os módulos ativos. Reset to default substitui a seleção pelo perfil predefinido: pode desativar módulos que adicionou para uma aplicação. Não é necessário utilizá-lo depois de cada alteração.

Selecionar os módulos

Nessa mesma secção dispõe de uma lista de módulos ativados e desativados. Ative apenas os de que a sua aplicação precisa e evite desativar um módulo partilhado por outros sites sem verificar a sua utilização.

Se utilizar Reset to default, verifique depois se falta alguma extensão específica do seu projeto. As extensões guardam-se por versão: ao mudar de PHP, verifique novamente os módulos necessários. Se diferentes sites utilizarem versões diferentes, reveja também o guia de PHP por diretório ou domínio.

Alteração de valores de configuração comuns

Em Options pode controlar os valores de configuração de PHP mais frequentes. Edite o valor ou a opção pretendida e a alteração será guardada automaticamente.

Não ative display_errors num site público: pode mostrar caminhos e rastreios aos visitantes. Mantenha o registo de erros ativado e consulte os erros no separador Erros da ficha do site.

Se uma opção não aparecer, verifique se pode ser modificada pelo seu utilizador e que método o servidor admite. Algumas podem ser personalizadas a partir do ficheiro .htaccess.

Rever o alcance e o resultado

A versão predefinida não altera os sites nem as pastas que têm uma versão própria. Em Alojamento > PHP vê a versão de cada um e de onde lhe vem.

Depois de uma alteração, teste a página inicial, a administração, os formulários e as tarefas agendadas. A alteração manual a partir do cPanel não inclui a verificação nem a reversão que a área de cliente faz.