• Introducción
• ¿Qué debemos saber?
• ¿Qué prometemos?
• Instalación y configuración de la librería PHPlot

Introducción

Todavía no hace mucho, en PHP faltaban soluciones sencillas que permitieran la creación de gráficas. El programador necesitaba valerse de varias funciones gráficas, además de realizar muchos cálculos complicados. Gracias a la librería PHPlot se pueden crear gráficas de apariencia profesional con la ayuda de algunas líneas de código.

La librería PHPlot no es una solución de gráficas revolucionaria: su código completo se basa en la librería GD ya conocida (de esta librería ya escribimos en el número 3/2004, en el artículo titulado Generar gráficos utilizando la librería GD), gracias a la cual se puede equipar a los programas en PHP con la creación de gráficos dinámicas. No obstante, quien quiera construir gráficas profesionales utilizando únicamente las funciones de la librería GD, está condenado a largas horas de pruebas y errores y, en definitiva, a escribir centenares de líneas de código. La cantidad de código necesario se incrementa en forma geométrica en caso de que la gráfica debiera tener caracter dinámico, esto es, que permite a los usuarios aplicarla según las necesidades personales del tipo de: colores de las series de datos, etiquetas del eje, leyendas, etc. PHPlot oculta toda la complejidad de la librería GD, ofreciendo a los usuarios únicamente algunas decenas de funciones entendibles y sencillas que permiten crear gráficas que no se alejan de la apariencia y posibilidades de éstas, tal como las que pueden ser construidas con las hojas de cálculos conocidas.

Gracias a ella, podemos generar diagramas o dibujar cuerpos geométricos tridimensionales sin dificultad. Si deseamos colocar dibujos generados dinámicamente en nuestras páginas, por ejemplo, miniaturas de figuras con posibilidad de seleccionar su tamaño de visualización o estadísticas de visitas, entonces, lo mejor y más sencillo es utilizar la librería GD.

Desafortunadamente es difícil encontrar en la red, y menos en libros, buenas descripciones que nos introduzcan a ese tema. Tengo la esperanza de que este artículo lo haga.

 ¿Qué debemos saber?

• cómo utilizar librerías externas orientadas a objetos, destinadas para usar en PHP.
• tener conocimientos de la librería GD facilita el entendimiento de los problemas que se mencionan, además de las diferencias de generar las gráficas desde el nivel de GD y de PHPlot.

 ¿Qué prometemos?

De este artículo el Lector aprenderá:

• cómo crear gráficas impresionantes y profesionales en las páginas web.
• cómo generar en una página varias imágenes y ligarlas con texto y gráficas dinámicas.

 Instalación y configuración de la librería PHPlot

Antes de continuar con la utilización de la librería PHPlot, debemos obtener su código. Éste se puede obtener de su página (la versión más nueva de la librería está señalada con el símbolo phplot-5.0-RC1). Conviene mencionar que la librería se distribuye bajo las condiciones de la licencia GNU GPL. En la página citada encontraremos la documentación de la librería (la lista de condiciones y una breve descripción de las funciones disponibles), algunos ejemplos sencillos, descripción de los errores descubiertos, grupo de usuarios, ayuda técnica y algunas otras utilidades. Los requerimientos de la librería no son excesivos. El único elemento indispensable es la instalación de la librería GD (PHPlot coopera con GD en las versiones 1.2 – 2.0.x). Ésta última se puede descargar de esta página y para utilizarla en PHP, se debe agregar en el archivo php.ini la línea extension = php_gd.dll (en Windows) o extension = php_gd.so (en sistemas UNIX). (La directiva extension_dir debe indicar el directorio en el que se encuentra el archivo php_gd.*). En el caso de utilizar la librería GD2 (requiere algunas funciones de PHPlot), se debe utilizar el archivo php_gd2.*. Los formatos gráficos de los que se sirve la librería PHPlot dependen, desde luego, de los que proporciona GD. En relación a esto, siempre podemos crear gráficas en los formatos PNG y JPEG, y en el caso de algunas versiones de la librería GD, también en formato GIF (este formato no está disponible en cada versión, por el motivo de la patente del método de compresión de la empresa UNISYS utilizado en los archivos GIF).

El código de la librería PHPlot se almacena en el archivo phplot.php. El programador que desee utilizar las funciones de la librería en sus scripts debe incluir el archivo mencionado con la ayuda de la instrucción include() o extender la directiva de configuración include_path de la ruta que dirige a dicho archivo. Después de descomprimir la librería bajada de Internet, junto con el archivo básico phplot.php encontraremos algunos ejemplos y documentación, además del archivo rgb.inc.php, que contiene la definición de los colores y el archivo phplot_data.php, cuyo código establece la extensión de las funciones de la librería (en concreto, aquí se encuentra el código de la clase descendiente de la clase PHPlot – la clase descendiente PHPlot_Data hace disponibles los métodos que permiten escalar las gráficas). Para poder aprovechar la funcionalidad de la librería, este último archivo debería ubicarse en el mismo directorio que el archivo phplot.php o especificar la ruta a éste con la directiva de configuración include_path.

Las versiones anteriores de PHP (inferior a 4.2.0) no trabajan con la versión más nueva de la librería PHPlot (debido a que les falta la función array_fill()). La versión anterior de la librería la podemos bajar aqui.

La versión comentada de la librería (phplot-5.0-RC1) no funciona correctamente con PHP5.