IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Découverte de la bibliothèque Php JpGraph


précédentsommairesuivant

I. Introduction

I-A. Remerciements

Je tiens à remercier Guillaume Rossolini alias yogui et Nicolas Fatrez alias UNi[FR] pour les corrections apportées à cet article.

Un grand merci également à Marie Pommereau pour l'important travail de relecture effectué. Ce document devrait en être plus agréable à lire.

I-B. Présentation de la bibliothèque JpGraph

I-B-1. La bibliothèque

JpGraph est une bibliothèque PHP dédiée à la représentation graphique de données.

JpGraph produit des images. C'est au programmeur de fournir l'ensemble des données nécessaires à la réalisation du graphique voulu.

Le lien le site de cette bibliothèque : Site officiel de la bibliothèque JpGraph

I-B-2. Mode de licence

Si JpGraph peut s'utiliser gratuitement dans le cadre d'un développement non commercial, il est toutefois nécessaire d'acquérir une licence dans le cadre d'un projet où des profits sont générés.

I-C. Objectifs de cet article

L'objectif principal est de vous faire découvrir différents types de graphiques proposés par cette bibliothèque.

Ensuite, j'ai trouvé intéressant de vous proposer des exemples pratiques de production des données. Les données produites proviennent de véritables données, contenues dans une table Mysql.

Enfin, vous apprendrez à personnaliser un graphique au cours des différentes études de cas.

I-D. Public visé

Pas besoin d'être un expert pour se servir de JpGraph.

Cette bibliothèque, orientée objet est bien conçue. Cela rend le code agréable à lire, la clarté du code permet de comprendre le rôle d'une méthode, ou de ce à quoi correspond une propriété.

Cependant, avoir des notions de notation objet aidera à la compréhension des sources. La maîtrise des tableaux en PHP sera également un plus, dans la mesure où les données attendues par JpGraph sont généralement contenues dans des tableaux (indexés).

I-E. Installation

I-E-1. Téléchargement

Vous pouvez télécharger les sources de JpGraph à l'adresse suivante : Téléchargement de la bibliothèque JpGraph

Deux versions de sources sont proposées, l'une pour PHP 4 et l'autre pour PHP 5 version >= 5.1.

À l'heure où j'écris ce tutoriel, l'archive à télécharger est une archive « .tar.gz ». Pour les utilisateurs de Windows, si vous ne disposez pas d'un programme pour ouvrir un fichier tar.gz, vous pouvez télécharger le logiciel de compression/décompression de données 7 zip.

Une fois les fichiers extraits de l'archive, la bibliothèque JpGraph se présente sous la forme d'un ensemble de fichiers PHP, d'un répertoire contenant de nombreux exemples ainsi qu'un répertoire de langues.

Arborescence de la librairie JpGraph
Arborescence de la bibliothèque JpGraph

I-E-2. Paramétrages

Pour fonctionner, JpGraph nécessite que PHP 4 (version min) ou PHP 5 (version min) soient installés.

Il est également requis que l'extension GD2 (bibliothèque graphique dédiée à la création et à la manipulation d'images) soit disponible (en général, il suffit de décommenter la bonne section dans le fichier 'php.ini' et de redémarrer le serveur web).

Activer l'extension GD2  dans le fichier php.ini
Activer l'extension GD2 dans le fichier php.ini

Afin d'installer les sources de JpGraph, déposez-les simplement dans l'arborescence de votre serveur web.

I-E-3. Tests

À ce stade, vous pouvez tester l'installation en parcourant les nombreux exemples proposés dans le répertoire « src/examples/ ».

Pour cela il faut visualiser le fichier « testsuit.php » du répertoire ci-dessus. Pour chaque exemple, il suffit de cliquer sur le graphique pour voir l'image et le code source PHP correspondant.

Page de test testsuit.php dans le repertoire « examples »
Page de test testsuit.php dans le repertoire « examples »

Vous constaterez que les exemples sont très nombreux et qu'ils constituent une bonne source d'inspiration. La plupart des graphiques créés dans cet article proviennent initialement de ces exemples.


précédentsommairesuivant

Copyright © 2007 eric190. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.