主机托管与 cPanel 339 visualizações

Como habilitar extensões PHP necessárias para um plugin ou sistema específico

Ver no WHMCS

Como habilitar as extensões PHP que seu plugin ou sistema precisa

Oi! Aqui é a Sensei da GeHost 🧡 Se você instalou um plugin, tema ou sistema (WordPress, loja virtual, script PHP) e ele reclamou de uma "extensão PHP faltando" (tipo curl, gd, imagick, zip, mbstring...), relaxa: isso é super comum e dá pra resolver em poucos minutos, direto no seu painel. Vem comigo que eu te mostro passo a passo. 😊

Dica da Sensei: extensão PHP é tipo um "acessório" que liga funções extras à linguagem PHP do seu site. Alguns plugins precisam de acessórios específicos pra funcionar — e às vezes eles vêm desligados por padrão até você ativar.

Passo 1 — Descubra qual extensão está faltando

Normalmente a mensagem de erro já entrega o nome da extensão, algo como:

  • "Call to undefined function curl_init()" → falta a extensão cURL
  • "The Zip PHP extension is not installed" → falta a extensão Zip
  • "gd extension is missing" → falta a extensão GD (usada pra imagens)

Se a mensagem não for clara, dá uma olhada na documentação do plugin/sistema — geralmente ela lista os "requisitos do servidor", e é ali que aparece o nome certinho da extensão que você vai precisar ligar.

Passo 2 — Acesse o cPanel

Entre no seu cPanel com o usuário e senha da hospedagem (você recebeu esses dados por e-mail na contratação; se não achar, dá pra pedir de novo pelo painel.gehost.com.br ou chamando o suporte).

Tela de login do cPanel

Passo 3 — Encontre a ferramenta "MultiPHP INI Editor" ou "Select PHP Version"

Já dentro do cPanel, procure na área de Software (geralmente próxima ao topo ou meio da tela) por uma dessas duas ferramentas:

  • Select PHP Version — mostra a lista de extensões com caixinhas de marcar (checkbox) pra ligar/desligar
  • MultiPHP INI Editor — deixa editar configurações do PHP de forma mais avançada

Pra maioria dos casos, o Select PHP Version já resolve, porque ele lista as extensões disponíveis com um clique de distância.

Painel inicial do cPanel com os grupos de ferramentas

Passo 4 — Selecione o domínio certo

Se você tem mais de um site na sua hospedagem, confirme que está mexendo na versão do PHP do domínio correto antes de continuar — cada site pode ter sua própria configuração.

Passo 5 — Marque a extensão e salve

  1. Dentro do Select PHP Version, procure na lista o nome da extensão que o plugin pediu (ex.: curl, gd, zip, mbstring, imagick, intl...).
  2. Marque a caixinha ao lado dela.
  3. Clique em Save (ou "Salvar", dependendo do idioma do painel).

Pronto! A extensão já entra em funcionamento na hora, sem precisar reiniciar nada.

Dica da Sensei: se você não tem certeza de qual versão do PHP o seu site está usando, essa mesma tela mostra e permite trocar também. Mas cuidado: trocar a versão do PHP pode afetar plugins mais antigos — se não tiver certeza, é melhor confirmar com quem desenvolveu o site antes de mudar a versão (mudar só a extensão específica é bem mais seguro).

Passo 6 — Teste seu site/plugin de novo

Volte no seu site ou no painel do plugin e tente repetir a ação que deu erro. Se a mensagem sumiu, sucesso! 🎉 Se persistir, pode ser que:

  • A extensão marcada não seja exatamente a que o sistema pede (revise o nome com atenção);
  • O erro seja de outra causa (permissão de arquivo, versão do PHP incompatível, etc.).

Não achou a extensão na lista ou não tem certeza do que marcar?

Sem problemas — chama a gente! Manda o print do erro e o nome do plugin/sistema pra equipe da GeHost pelo painel.gehost.com.br que a gente confirma certinho qual extensão habilitar pra você. Lembrando que todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega — e mesmo depois disso, estamos por aqui pra ajudar. 💛

Dica da Sensei: antes de instalar um plugin novo, dá uma olhadinha nos "requisitos" dele — assim você já sabe se vai precisar ativar alguma extensão antes de sair instalando.
Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.