9.03 Como instalar um pacote PEAR

A função de instalação do PHP PEAR Packages serve para adicionar um pacote PEAR à sua conta de hospedagem, tornando aquele componente disponível para uso em scripts ou aplicações PHP compatíveis.
Na prática, esse recurso permite instalar bibliotecas PEAR diretamente pelo cPanel, seja digitando o nome do módulo ou pesquisando e clicando na ação de instalação.

Como acessar o cPanel

Antes de instalar um pacote PEAR, entre no cPanel usando um dos acessos abaixo:

  • https://seudominio.com.br/cpanel
  • https://seudominio.com.br:2083
  • área do cliente MyWay, pelo atalho do serviço
Certifique-se de que você está usando a conta correta da hospedagem, principalmente se administra mais de um domínio ou mais de uma conta.

Como instalar um pacote PEAR

Antes de instalar

Antes de iniciar, confirme alguns pontos importantes:

  • qual é o nome correto do pacote
  • se a sua aplicação realmente usa PEAR
  • se o recurso PHP PEAR Packages está habilitado na conta
  • se o módulo é compatível com o que você precisa
Instalar um pacote apenas “para testar” pode gerar confusão depois. O ideal é instalar somente aquilo que a aplicação ou o desenvolvedor realmente exigem.

Passo 1 – Abrir PHP PEAR Packages

No cPanel, vá até Software e clique em PHP PEAR Packages.

Ao abrir a interface, você normalmente verá um campo específico para instalar um pacote diretamente pelo nome.

Tradução útil:

  • Install a PHP Extensions and Applications Package = Instalar um pacote de extensões e aplicações PHP
  • Install Now = Instalar agora
Essa instalação direta é útil quando você já sabe exatamente o nome do pacote que deseja adicionar.

Passo 2 – Escolher o método de instalação

O cPanel normalmente permite instalar um pacote PEAR de duas formas principais:

  • digitando o nome do módulo no campo de instalação direta
  • pesquisando ou listando módulos disponíveis e depois clicando em Install

Na prática, a primeira opção é melhor quando você já tem o nome exato do pacote. A segunda é melhor quando precisa localizar o módulo primeiro.

Ambos os caminhos levam ao mesmo resultado: a instalação do pacote na conta, desde que o módulo exista e esteja disponível.

Passo 3 – Informar o pacote

Se você já souber o nome do módulo, digite-o no campo apropriado.

Exemplo prático:

  • digitar o nome exato informado pela documentação da aplicação
  • evitar nomes aproximados ou inventados
  • revisar letras maiúsculas, sublinhados e partes do nome, quando aplicável
Um nome digitado incorretamente pode fazer a instalação falhar ou impedir que o sistema encontre o pacote certo.

Passo 4 – Clicar em Install Now ou Install

Depois de informar ou localizar o pacote, clique em:

  • Install Now quando estiver usando o campo de instalação direta
  • Install quando estiver instalando a partir da lista de resultados ou da lista de módulos disponíveis

Tradução útil:

  • Install = Instalar
  • Install Now = Instalar agora
Após clicar, o cPanel tenta baixar e instalar o módulo para a conta.

O que acontece durante a instalação

Quando a instalação é executada, o sistema realiza o processo de obtenção e preparação do pacote no ambiente da conta.

Dependendo do servidor e do pacote, isso pode incluir:

  • validação do nome do módulo
  • consulta ao repositório disponível
  • download do componente
  • registro do módulo como instalado
Em muitos casos, depois da instalação, o próprio cPanel passa a exibir o pacote em listas de módulos instalados ou já indica que ele está presente.

Como confirmar se deu certo

Depois da instalação, normalmente você deve verificar:

  • se o pacote aparece como instalado
  • se surgiram opções de update ou uninstall
  • se a aplicação que dependia do pacote passa a reconhecê-lo
  • se o módulo aparece na listagem de instalados
O melhor cenário é quando o pacote aparece claramente como instalado e a aplicação passa a funcionar sem o erro anterior de dependência ausente.

Module Include Path e uso na aplicação

Depois de instalar, observe se a tela mostra a seção Module Include Path.

Tradução útil:

  • Module Include Path = Caminho de inclusão do módulo

Esse caminho ajuda o desenvolvedor a entender onde os módulos podem ser referenciados pela aplicação ou por outros scripts.

Em alguns casos, além da instalação, pode ser necessário ajustar o código da aplicação para usar corretamente o pacote instalado.

Cuidados importantes

  • não instale pacotes desnecessários
  • não confunda PEAR com Composer ou com extensões nativas do PHP
  • sempre confirme o nome correto do módulo
  • se o site estiver em produção, evite mudanças sem necessidade
Instalar o pacote errado não resolve o problema da aplicação e ainda pode dificultar o diagnóstico posterior.

Resultado esperado

Ao final do processo, o pacote PEAR desejado deverá estar instalado na sua conta, aparecendo como disponível para uso no ambiente da aplicação PHP.

O resultado esperado é ter o módulo corretamente adicionado ao ambiente, pronto para ser utilizado pelo sistema que depende dele.

Resumo

Para instalar um pacote PEAR no cPanel:

1. Acesse o cPanel
2. Entre em PHP PEAR Packages
3. Digite o nome do módulo ou pesquise por ele
4. Clique em Install Now ou Install
5. Aguarde a conclusão
6. Confirme se o pacote aparece como instalado

Na prática, isso adiciona à sua conta a biblioteca PEAR necessária para a aplicação.
Se a instalação falhar, verifique se o nome do pacote está correto, se o recurso está ativo no plano e se o ambiente realmente permite esse tipo de módulo na conta.

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

  • 0 Usuários acharam útil
Esta resposta lhe foi útil?

Artigos Relacionados

9.01 Como acessar o gerenciador PEAR no cPanel

A opção PHP PEAR Packages do cPanel serve para pesquisar, instalar, atualizar, remover e...

9.02 Como pesquisar pacotes PEAR

A opção de pesquisa do gerenciador PHP PEAR Packages serve para localizar pacotes PEAR...

9.04 Como atualizar um pacote PEAR

A atualização de um pacote no PHP PEAR Packages serve para aplicar uma versão mais recente do...

9.05 Como remover um pacote PEAR

A remoção de um pacote no PHP PEAR Packages serve para desinstalar um módulo PEAR da conta de...

9.06 Como verificar pacotes PEAR instalados

Verificar pacotes PEAR instalados serve para confirmar quais módulos já estão presentes na...