Utilizar pacotes PEAR em aplicações PHP existentes

O PEAR distribui bibliotecas PHP que algumas aplicações ainda utilizam. Se um projeto depender de um desses pacotes, pode geri-lo a partir de PHP PEAR Packages no cPanel, quando essa função estiver disponível. Para novas dependências, verifique se o projeto utiliza o Composer.

Procurar e instalar um pacote

1. Abra PHP PEAR Packages no cPanel.
2. Procure o nome exato indicado na documentação da aplicação.
3. Verifique a versão, a sua manutenção e a compatibilidade com o PHP que o projeto utiliza.
4. Instale-o e reveja o resultado e as dependências que tenham sido adicionadas.

A presença de um pacote no catálogo não garante que continue a ser mantido nem que funcione com qualquer versão de PHP. Não atualize um componente partilhado por várias aplicações sem as testar antes.

Adicionar o caminho de pesquisa

O cPanel mostra onde instala os componentes da sua conta, normalmente /home/usuario_cpanel/php. Utilize o caminho indicado pela sua instalação.

Se precisar de o adicionar apenas a um script, mantenha também os caminhos existentes:

<?php
ini_set('include_path', '/home/usuario_cpanel/php'
    . PATH_SEPARATOR . get_include_path());

Substitua o utilizador e carregue depois o ficheiro concreto que o pacote exige, de acordo com a sua documentação. Se o configurar a partir do seletor de PHP, verifique se a opção está disponível e tenha em conta o seu efeito sobre outras aplicações que utilizem essa versão.

Verificar ou retirar um pacote

Teste a função da aplicação que o utiliza e consulte o registo se o PHP não encontrar um ficheiro ou uma dependência. Verifique o caminho e o PHP efetivo do site, que podem ser diferentes dos do terminal.

Antes de desinstalar, identifique que projetos o carregam. Migrar para o Composer exige adaptar a instalação e o autoload do projeto; instalar o Composer não substitui automaticamente os require ou include de uma aplicação herdada.