Découverte de la bibliothèque Php JpGraph
Découverte de la librairie Php JpGraph
Date de publication : 22/09/2007 , Date de mise à jour : 24/10/2007
I. Introduction
I-A. Remerciements
I-B. Présentation de la librairie Jpgraph
I-B-1. La librairie
I-B-2. Mode de licence
I-C. Objectifs de cet article
I-D. Public visé
I-E. Installation
I-E-1. Téléchargement
I-E-2. Paramétrages
I-E-3. Tests
I. Introduction
I-A. Remerciements
Je tiens à remercier ...
I-B. Présentation de la librairie Jpgraph
I-B-1. La librairie
Jpgraph est une librairie Php dédiée à la représentation graphique de données.
Le travail effectué par Jpgraph est la production d'image. C'est au programmeur de fournir l'ensemble des données nécessaires à la réalisation du graphique voulu.
Le lien pour aller sur ce site est Site officiel de la librairie Jpgraph
I-B-2. Mode de licence
Jpgraph peut s'utiliser gratuitement dans le cadre d'un développement personnel, il est nécessaire d'acquérir une licence dans le cadre d'un projet professionnel.
I-C. Objectifs de cet article
L'objectif principal est de vous faire découvrir différents types de graphiques proposés par cette librairie.
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 librairie, 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é.
Ceci dit, 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 librairie Jpgraph
Deux versions de sources sont proposées, l'une pour Php 4 et l'autre pour Php 5 version >= 5.1.
|
A 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 librairie 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
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 (librairie 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
Afin d'installer les sources de Jpgraph, déposez-les simplement dans l'arborescence de votre serveur web.
I-E-3. Tests
A 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 »
Vous constaterez que les exemples sont très nombreux et qu'ils constituent une très bonne source d'inspiration. La plupart des graphiques créés dans cet article proviennent initialement de ces exemples.