2.3.4. Instalación de PEAR

2.3.4. Instalación de PEAR
PEAR es una librería que agrega muchas funcionalidades a PHP. En la aplicación se utiliza para habilitar
el formato Excel en el plugin de Exportar. Para instalar el modulo básico de PEAR descargamos de la
pagina web:
http://pear.php.net/package/PEAR/download
En este caso se descargará la versión estable más reciente de PEAR, la 1.9.0.
Es necesario tener un programa que soporte la extensión .tgz para descomprimir el archivo.
Se navega en la carpeta descomprimida hasta encontrar el directorio PEAR.
Se mueven los archivos PEAR.php, Pear5.php y System.php a la carpeta PEAR:
Se abre el directorio php dentro del servidor Apache (en el ms4w se encuentra en C:\ms4w\Apache\php)
y se copia la carpeta PEAR. Este directorio contiene todas las clases base para que el paquete funcione
correctamente.
Para poder aprovechar las clases establecidas por la biblioteca PEAR, es necesario establecer una ruta
de inclusión desde la cual pueda ser llamada y reconocida por PHP. Para ello se abre el archivo php.ini
(en el ms4w se ubica en la ruta C:\ms4w\Apache\cgi-bin).
Una vez abierto el archivo php.ini, se busca la línea en donde se encuentra definida la variable
include_path. En ms4w por defecto se encuentra definida como include_path = ".;\ms4w\Apache\php". En
esta variable se incluye la ruta en donde se encuentra el paquete PEAR.
Se guarda el archivo con los cambios. En este punto ya se encuentra instalado el paquete básico PEAR
Como lo que se busca es habilitar el plugin de p.mapper Exportar a formato xls, se requiere
adicionalmente la instalación del paquete Console_Getopt que en otras versiones viene por defecto en la
librería base de PEAR. Este paquete se puede instalar desde la página web
http://pear.php.net/package/Console_Getopt/download
Se descarga y descomprime el archivo. Después de este proceso se tendrá un archivo xml y una carpeta
con el nombre del paquete.
Navegamos en la carpeta del paquete hasta encontrar el directorio Console y se copia dentro del
directorio PEAR que definimos anteriormente (C:\ms4w\Apache\php\PEAR).
Para que el servidor Apache tome los cambios que se han efectuado es necesario reiniciarlo ejecutando
el archivo apache_restart.bat.
Módulos OLE y Spreadsheet
Para poder usar el formato Excel (xls) en el plugin Export es necesario instalar las librerías OLE y
SpreadSheet.
Dichas librerías se pueden descargar de las páginas web:
http://pear.php.net/package/OLE/download
http://pear.php.net/package/Spreadsheet_Excel_Writer/download
Se descarga la versión mas reciente de los paquetes: 1.0.0 RC1 para OLE y 0.9.2 para SpreadSheet.
Los archivos se descargan en formato .tgz, una vez descargados se descomprimen en cualquier ruta.
Al descomprimir el archivo se mostrará una carpeta con el nombre del paquete en donde se encuentran
las librerías PHP del componente y el archivo package.xml en donde se especifican las características y
versiones del paquete.
Para instalar el paquete OLE se cambia el nombre que viene por defecto (OLE-1.0.0RC1) a OLE.
Se copia la carpeta OLE en el directorio en donde se encuentra PEAR.
Para instalar el paquete SpreadSheet entramos a la carpeta Spreadsheet_Excel_Writer-0.9.2.
Se copia la carpeta SpreadSheet en el directorio en donde se encuentra PEAR.
Es necesario reiniciar el servidor web apache ejecutando el archivo apache-restart.bat.