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.
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).
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.
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.