PEAR es un entorno de desarrollo y sistema de distribución de componentes de código PHP. Esta gran biblioteca se estructura en paquetes, abarcando cada uno un ámbito específico. Por ejemplo, el paquete
Net_ldap2 proporciona los objetos para la manipulación de entradas LDAP.
El gestor de paquetes de PEAR ya viene integrado en la versión 5 de PHP. Dicho gestor de paquetes se puede invocar desde la línea de comandos
$ pear
Dispone de múltiples opciones que nos permitirán instalar y actualizar paquetes, consultar configuraciones, etc...
Para utilizar PEAR los scrips se invocan mediante
require_once(). Para ello debemos asegurarnos que la directiva
include_path de PHP incluya el
php_dir de PEAR. ¿Cómo nos aseguramos de eso? Pues con las siguientes comprobaciones:
1.
¿Dónde están instalados los archivos php de PEAR?
$ pear config-get php_dir
El directorio resultante debe contener el fichero
System.php2.
¿Cual es el archivo de configuración que utiliza PHP?
$ php --ini
Configuration File (php.ini) Path: /etc/php5/cli
Loaded Configuration File: /etc/php5/cli/php.ini
Scan for additional .ini files in: /etc/php5/cli/conf.d
Additional .ini files parsed: /etc/php5/cli/conf.d/ldap.ini,
/etc/php5/cli/conf.d/pdo.ini,
/etc/php5/cli/conf.d/xdebug.ini
Una buena práctica es crear un fichero
phpinfo.php que llame a la función phpinfo(). Dicho fichero lo guardamos en la carpeta de publicación web y lo invocamos mediante un navegador con
http://localhost/phpinfo.php, con lo cual nos mostrará la configuración completa del php instalado. La ubicación de el fichero de configuración
php.ini vendrá indicado como
Loaded Configuration File.
3. Podemos crear otro fichero php, alojado en el mismo lugar que
phpinfo.php que nos sirva para comprobar la instalación de PEAR. Este fichero php debe tener las siguientes instrucciones:
require_once 'System.php';
var_dump(class_exists('System'));
Si el resultado al invocarlo desde un navegador web es
bool(true)
significará que todo está correcto. Sin embargo, si aparece algo parecido a
Warning: require_once(System.php): failed to open stream:
No such file or directory in /path/to/check_pear.php on line 2
es que hay algún problema y será necesario revisar la ruta del fichero incluido.
Si en cambio, lo que nos muestra el navegador es una página en blanco, es posible que el servidor web esté configurado para no mostrar los warnings y mensajes de error.