|
PEAR (PHP Extension and Aplication Repository) é um framework e um sistema de distribuição para a codificação de componentes em PHP. O projeto foi fundado em 1999 por Stig S. Bakken para promover a reutilização de código.
A biblioteca PEAR pode ser utilizada, mas não por meio de acesso à biblioteca global do servidor.
Para que seja possível sua utilização, é necessário copiar a biblioteca para sua área, de preferência em um diretório chamado PEAR.
Após a cópia, proceder conforme a plataforma de sua hospedagem:
Download do PEAR
O PEAR pode ser baixado em http://pear.php.net/, mais especificamente aqui, e seus módulos (pacotes, ou packages) aqui.
  Configurações Básicas
Após armazenar os arquivos do PEAR na sua hospedagem após efetuar o download dele no link acima, o arquivo PEAR.php e os demais arquivos e diretórios desse pacote deverão estar no diretório a ser especificado no incluide_path, não no sub-diretório cujo nome refere-se à sua versão. Os arquivos dos pacote adicionais deverão estar no mesmo diretório do PEAR.php, e não no subdiretório cujo nome corresponde à sua versão.
Alguns exemplos:
Se seu PEAR estiver em /home/MEU_LOGIN/public_html/PEAR, configure no include_path:
.:/home/MEU_LOGIN/public_html/PEAR
Se seu PEAR estiver em e:\home\MEU_LOGIN\web\PEAR, configure no include_path:
.;e:\\home\\MEU_LOGIN\\web\\PEAR
- Veja aqui como configurar o include_path da sua hospedagem para fazer o PEAR funcionar.
- Para saber como instalar módulos adicionais do PEAR na sua hospedagem clique aqui.
Instalando o PEAR via linha de comando
Instalação Padrão
Obs: Caso você tenha problemas com os passos a seguir, clique aqui para consultar a alternativa descrita no Fórum da Locaweb.
Na Locaweb o PEAR já está instalados em todas Hospedagens Compartilhadas Linux com os módulos básicos, mas você pode fazer a instalação em sua área de qualquer módulo sem a necessidade de abrir um chamado. Dando total autonomia em sua área.
Acessando a sua conta por SSH, criaremos o arquivo de configuração do PEAR.
pear config-create $HOME .pearrc
Obs: Importante que o arquivo .pearrc seja criado no diretório $HOME, $HOME é onde se encontra a raiz de sua hospedagem, por exemplo: seu login é "tuxz", o $HOME é /home/tuxz
Vamos configurar o seu ambiente para se adequar a estrutura da Locaweb:
Configurando o caminho do seu php.ini
pear config-set php_ini $HOME/php.ini
Depois rodar o comando abaixo para que a estrutura básica do PEAR seja instalado em seu ambiente:
pear install -o PEAR
Será criado a estrutura em $HOME/pear, no caso deste exemplo em /home/tuxz/pear
Visualizando as configurações:
pear config-show
CONFIGURATION (CHANNEL PEAR.PHP.NET):
=====================================
Auto-discover new Channels auto_discover <not set>
Default Channel default_channel pear.php.net
HTTP Proxy Server Address http_proxy <not set>
PEAR server [DEPRECATED] master_server pear.php.net
Default Channel Mirror preferred_mirror pear.php.net
Remote Configuration File remote_config <not set>
PEAR executables directory bin_dir /home/tuxz/pear
PEAR documentation directory doc_dir /home/tuxz/pear/docs
PHP extension directory ext_dir /home/tuxz/pear/ext
PEAR directory php_dir /home/tuxz/pear/php
PEAR Installer cache directory cache_dir /home/tuxz/pear/cache
PEAR configuration file cfg_dir /home/tuxz/pear/cfg
directory
PEAR data directory data_dir /home/tuxz/pear/data
PEAR Installer download download_dir /home/tuxz/pear/download
directory
PHP CLI/CGI binary php_bin /usr/bin/php
php.ini location php_ini /home/tuxz/php.ini
PEAR Installer temp directory temp_dir /home/tuxz/pear/temp
PEAR test directory test_dir /home/tuxz/pear/tests
PEAR www files directory www_dir /home/tuxz/pear/www
Cache TimeToLive cache_ttl 3600
Preferred Package State preferred_state stable
Unix file mask umask 22
Debug Log Level verbose 1
PEAR password (for password <not set>
maintainers)
Signature Handling Program sig_bin /usr/bin/gpg
Signature Key Directory sig_keydir /etc/pearkeys
Signature Key Id sig_keyid <not set>
Package Signature Type sig_type gpg
PEAR username (for username <not set>
maintainers)
User Configuration File Filename /home/tuxz/.pearrc
System Configuration File Filename /etc/pear.conf
Para maiores informações sobre os comandos:
pear help
Para verificar a versão do PEAR
pear -V
Instalando Pacotes
Caso queira saber a lista dos pacotes http://pear.php.net. use o comando abaixo para a instalação dos pacotes:
pear install pear/NomeDoPacote
Onde NomeDoPacote é o nome do pacote PEAR, exemplo: XML_RPC, Mail, Mail_Mime, MDB2, etc...
Alguns pacotes possuem funcionalidades a mais que também podem ser instaladas, como o pacote MDB2 existe banco de dados específico. Para adicionar esta funcionalidade a um pacote já instalado, use o comando:
pear install pear/NomeDoPacote#funcionalidade
No caso do MDB2 por exemplo:
pear install pear/MDB2#mysql
Incluindo os módulo PEAR em seus scripts
Para usar os módulos locais do PEAR , você precisa alterar o include_path do php.ini de sua área.
Edite usando por exemplo o "vi"
vi $HOME/php.ini
Procure a linha:
include_path = ".:/usr/share/pear"
E inclua o caminho dos módulos da sua área, no caso do exemplo:
include_path = ".:/usr/share/pear:/home/tuxz/pear/php"
Substitua "tuxz" pelo seu login.
Referência externa
Veja também
Links
|
