# SPARQL Protocol and RDF Query Language/Travail pratique/Initiation à Eclipse
## À savoir avant de commencer
### Les débogueurs PHP

Il n’y a que deux débogueurs pour PHP :
* Zend, qui est intégré à la suite de développement payante Zend (à condition de disposer des serveurs de production également avec Zend sinon... bugs d’incompatibilités à prévoir)
* Xdebug, qui est gratuit, mais qui est moins simple à installer
Nous installerons donc XDebug, car les étudiants ont un budget relativement limité pour ce genre de dépenses.

## Exercice avec Docker

* A l’image de votre Docker précédent, rajouter XDebug pour pouvoir insérer des points d'arrêt dans votre code durant le débogage au travers de votre IDE.
* Tester: écrire une boucle en PHP, poser un point d'arrêt et essayer de l’exécuter "pas à pas".

## Ancienne version du cours en 2012
### Pourquoi utiliser Eclipse ?

Dans ce TP, nous allons installer Eclipse, ainsi que certains composants de débuggage. Eclipse est l'un des logiciels les plus utilisés pour faire du développement Web et il est gratuit. Malheureusement, sa puissance est inversement proportionnelle à son ergonomie. Il faut un certain temps pour arriver à l’utiliser correctement.
Ce TP a pour objectif de vous en montrer les avantages, mais aussi de vous faire gagner du temps sur l'installation du débuggeur, qui est indispensable à tout vrai développeur professionnel.

#### Documentations

Ce TP a été fabriqué avec les documents suivants :
* Eclipse 3.7 installation
* Eclipse installation avec Ubuntu
* Configurer PDT
* Tutoriel Phing et Eclipse

### Installation
#### Débogueur : XDebug

Il y a autant de manières d'installer XDebug qu’il y a de version de Linux.
Pour identifier si l'installation suivante peut fonctionner avec votre version de Linux, vous devez d’abord connaître la version que vous utilisez, avec la commande suivante.
L'installation suivante sera faite avec la version Ubuntu 10.04.3. Si ce n’est pas votre version, n'hésitez pas à comparer cette installation avec les résultats fournis par un moteur de recherche quand vous recherchez le nom de votre distribution Linux avec sa version et XDebug.

##### Ubuntu 10.04.3

Installez le composant php5-xdebug.
Ouvrez le fichier : /etc/php5/conf.d/xdebug.ini
Ajoutez à la fin de ce fichier les lignes suivantes :
Mettez à jour votre configuration.
Vérifiez que XDebug est bien activé dans votre configuration PHP.
Si vous avez un souci, il y a de fortes chances que quelqu’un d’autre ait déjà rencontré le même problème.
N'hésitez pas à chercher la solution via un moteur de recherche ou à demander de l'aide sur les forums de développeurs PHP.

#### Java Runtime Environment

Il n’est pas conseillé d'installer Eclipse via apt-get, il faut installer le JRE (Java Runtime Environment) séparément.
Installer le JRE (Java Runtime Environment) dont Eclipse a besoin :
Vérifiez si votre version de JRE est 32 ou 64 bits :
ou
Il est possible que votre PC ait un processeur 64 bits, mais que votre version de JRE soit 32 bits. Cela n’empêchera pas Eclipse 32 bits de fonctionner.
Si vous voulez cependant installer un JRE 64 bits, vous devrez probablement l'installer manuellement.

#### Eclipse

En fonction de la version de votre JRE, 32 ou 64 bits, vous choisirez la dernière version de "Eclipse Classic" x86 ou x86_64 : http://www.eclipse.org/downloads/
Nous installerons Eclipse dans votre répertoire personnel :
On passe dans le répertoire où votre navigateur a enregistré le package Eclipse, on le décompresse et on le déplace dans le répertoire ~/opt.
On fabrique le répertoire bin dans notre répertoire home, qui sera utilisé pour lancer Eclipse :
On crée le fichier qui sera le script d'exécution d'Eclipse :
Copiez ce texte dans ce fichier :
On autorise le script à être exécuté :
Pour finir, on va créer un raccourci pour le mettre sur notre bureau :
* clic droit sur votre bureau
* créer un raccourci (ou create launcher)
* indiquer le nom : Eclipse
* indiquer le chemin du script (command) : /home/<your username>/opt/eclipse/eclipse
* cliquer sur l'icône pour indiquer le chemin du script de l'icône d'Eclipse : /home/<your username>/opt/eclipse/eclipse/icon.xpm
* cliquer sur OK
Vous pouvez maintenant double cliquer sur l’icône Eclipse sur votre bureau.
Eclipse s'ouvre et vous demande de préciser votre espace de travail, indiquer un autre répertoire que ~/projets. Cela évite un certain nombre de problèmes de configuration.

#### Configurer la source des mises à jour et des plug-ins d'Eclipse

Dans Eclipse :
* aller dans le menu : Help > Install New Software.
* cliquer que le bouton "Add...".
* renseigner les champs avec le nom Indigo et l'adresse http://download.eclipse.org/releases/indigo.
Vous pouvez maintenant installer les plug-ins PHP et Web.

#### Installer le plug-in PHP

Dans Eclipse :
* Aller dans le menu : Help > Install New Software.
* Choisir le site (Work with) : "Indigo -- http://download.eclipse.org/releases/".
* Attendre que la liste soit mise à jour (attendez que le mot pending disparaisse).
* Aller ensuite dans langages de programmation.
* Cocher la liste PHP Development Tools (PDT).
* Cliquer sur Suivant deux fois.
* Cocher Accepter les licences.
* Cliquer sur Terminer.
Après l'installation, Eclipse vous demande de redémarrer :
* cliquer sur "redémarrer maintenant"

#### Installer le plug-in Web

* aller dans le menu : Help > Install New Software .
* Choisir le site (Work with) : "Indigo -- http://download.eclipse.org/releases/" .
* Attendre que la liste soit mise à jour (attendez que le mot pending disparaisse).
* Aller ensuite dans "Web, XML, JavaEE...".
* Cocher "Eclipse Web Developer Tools".
* Cliquer sur Suivant deux fois.
* Cocher Accepter les licences.
* Cliquer sur Terminer.
Après l'installation, Eclipse vous demande de redémarrer :
* Cliquer sur "Redémarrer maintenant".

### Ouvrir votre projet PHP dans Eclipse

Nous avons, dans le projet précédent, utilisé PHPUnit et créé l'arborescence de fichier du projet nommé MonCV. Nous allons ouvrir ce projet et le configurer.
* Ouvrir Eclipse.
* Menu Fichier > Nouveau projet.
* Ouvrer PHP > projet PHP.
La boîte de dialogue "Nouveau projet" s'ouvre.
* Donner un nom au projet : MonCv.
* Cocher : Créer un projet de sources existantes.
* Rechercher la racine du répertoire créé dans le TP précédent : ~/projets/moncv .
* cliquer sur Terminer (Finish).

### Configurer la construction du projet

Nous allons utiliser Phing pour construire le projet automatiquement afin de permettre de le débugger.
À chaque modification d'un fichier dans le projet, le script build.xml sera exécuté pour les tests unitaires et déployé sur le serveur Web (/var/www/moncv) que nous avons configuré dans un précédent TP.
Pour ce faire :
* Faire un clic droit sur ​​le projet
* sélectionner Propriétés
* sélectionner Constructeurs (builder)
* cliquer sur Nouveau pour afficher la boîte de dialogue "Choisir le type de configuration"
* sélectionner Programme
* Cliquer sur OK
La boîte de dialogue pour créer une configuration s'est affichée :
* Donner un nom, par exemple : Phing build.xml
* Indiquer l'emplacement de l'exécutable (Location) : /usr/bin/phing
* Indiquer l'emplacement d’exécution (Working directory) :
** Cliquer sur le bouton Browse WorkSpace
** Sélectionner la racine où se trouve le fichier build.xml, ici MonCV
** Cliquer sur OK
L'emplacement d’exécution (Working directory) doit contenir quelque chose qui ressemble à :
Maintenant, on indique les moments d’exécution :
* Aller dans l'onglet Rafraîchir (Refresh).
* Cocher la case "Rafraîchir les ressources" (Refresh resources upon each completion).
* Cocher "Espace de travail en entier" (The entire Workspace).
* Aller dans l'onglet Options (Build Options).
* Cocher l'auto-construction (During auto-build).
Cliquer finalement sur le bouton OK pour refermer la boîte de dialogue.

### Configurer le débogueur
#### Indiquer le serveur utilisé pour débugger

Nous utiliserons le serveur Web que nous avons installé dans un précédent TP pour déboguer notre projet.
* Via le menu : Window > Preferences
* Ouvrir le nœud : PHP > PHP Servers
* Créer un nouveau serveur : MonCV
* Donner son domaine (base url) : « http://moncv » . Consulté le 2014-09-20
* Donner la racine sur le disque du service Web (local Web root): /var/www/moncv
* Aller dans l'onglet Mapping
* Cliquer sur Nouveau
** Dans Chemin sur le serveur, indiquer : /var/www/moncv
** Cocher Chemin dans l'espace de travail
** Trouver la racine des sources, c'est-à-dire le répertoire src. Vous devez avoir comme résultat : MonCV/src
* Cliquer sur OK jusqu'à ce que toutes les boîtes de dialogues soient fermées

#### Indiquer le débogueur

* Via le menu : Window > Preferences
* Cliquer sur le nœud : PHP > Debug
* Dans la liste "PHP Debugger", choisir "XDebug"
* Cliquer sur Appliquer (Apply)
* Cliquer sur OK pour fermer la fenêtre

### Débugguer une page Web
#### Créer une page Web

Nous allons créer une page PHP dans le répertoire src :
* Clic droit sur le répertoire src dans Eclipse
* Nouveau > PHP File
* Indiquer comme nom de fichier : index.php
Insérer le texte suivant dans le fichier :
Sauvegarder, dans le menu : File > Save (ou Ctrl + s )

#### Insérer un point d'arrêt

Un point d'arrêt est un point placé à un endroit spécifique d'un programme qui permet d'indiquer à un débogueur d'arrêter l'exécution lorsqu’il atteindra cet endroit.
C'est très pratique pour voir à cet endroit la valeur des variables ou pour commencer à faire de l'exécution pas à pas dans le code. Le pas-à-pas permet d'avancer dans le code "commande par commande". Il permet de voir exactement ce qui est exécuté par le programme.
Pour insérer un point d'arrêt, il suffit de double-cliquer sur le numéro de ligne où vous souhaitez que le programme s'arrête. Un point bleu doit apparaître dans la marge, ce qui indique le point d'arrêt.
Exercice : double-cliquer sur le numéro de ligne où se trouve la fonction phpinfo.
Ce point d'arrêt nous sera utile dans l'exercice suivant.

#### Créer un profil de débogage

Un site Web est composé de plusieurs fichiers PHP qui peuvent être autant de points d'entrée dans votre site. Si vous débuggez une page php particulière, il vous faudra créer un profil de débuggage pour cette page. À chaque fois que vous voudrez débugger une page, vous pourrez réutiliser le profil de cette page que vous avez créé.
Nous allons créer un profil de débuggage pour la page index.php.
* Via le menu : Run > Debug configurations
* Clic droit sur PHP Web Page
* Dans le menu contextuel, choisir Nouveau
* Donner un nom : index.php
* Indiquer le fichier PHP à exécuter en cliquant sur le bouton Chemin et trouver le fichier index.php (ce qui doit donner : /MonCv/src/index.php)
* Décocher : Break at first line (sinon le débuggeur s'arrêtera dès la première ligne)
* Décocher Auto-generate pour indiquer manuellement l'url index.php sur le serveur
* Modifier l'url /MonCv/src/index.php en laissant juste index.php
* Cliquer sur Appliquer (Apply) pour sauver
* Cliquer sur Fermer (Close)
Si la configuration de XDebug s'est bien passée, vous devez lire devant server Debugger : Xdebug, et devant PHP server : moncv. Si ce n’est pas le cas, indiquez XDebug et le serveur moncv

#### Débugger

Eclipse a plusieurs modes d'affichage. Il y en a un pour PHP et un pour débugger. Eclipse vous demandera souvent de passer d'un mode à un autre automatiquement.
Pour revenir manuellement à un de ces modes, vous pouvez faire, dans le menu : Window > Open Perspective > PHP ou Debug.
Un bug, en anglais, signifie erreur dans du code informatique. Le même mot signifie aussi insecte. C'est la raison pour laquelle, dans Eclipse, tout ce qui touche au mode Debug est représenté par un insecte.
Nous allons lancer le débuggage :
* En haut de l'écran (dans la toolbar), il y a un insecte avec un triangle, cliquer sur le triangle.
* Choisir index.php, qui est le profil que nous avons créé.
* Eclipse vous propose de passer en mode Debug : accepter.
Vous pouvez voir maintenant (si tout s'est bien passé) :
* Zone Debug (en haut à gauche) : un carré rouge qui vous permet d'arrêter le débuggage
* Zone Debug (en haut à gauche) : un triangle vert qui vous permet de poursuivre l’exécution
* Zone Debug (en haut à gauche) : des flèches jaunes qui vous permettent de faire du pas-à-pas de différents types
* Zone Fichier (au milieu à gauche) : vous voyez le fichier avec une flèche bleue
* Zone navigateur (en bas) : c’est le navigateur par défaut (qu'on peut modifier dans les préférences) où vous pouvez voir le résultat de l'exécution, c'est-à-dire une page Web.
Vous découvrirez en jouant avec Eclipse les mille et une fonctions disponibles.
Vous disposez maintenant de l'environnement de développement qui va nous permettre de développer un service Web, mais surtout de suivre la leçon sur SPARQL.
Débugger sans environnement de développement
La Loi de Murphy s'applique aussi en informatique et il vous faut savoir débugger ou analyser un problème même sans Eclipse.
    1) Vous pouvez afficher des erreurs survenant dans une page directement dans le résultat HTML de cette page en rajoutant le code suivant dans les premières lignes du programme (à retirer du programme ensuite) :
    2) Vous pouvez aussi modifier ce paramètre d'affichage directement dans le fichier php.ini (rarement possible chez des hébergeurs PHP)
Modifier le fichier php.ini :
Rappel: on trouve le fichier php.ini via la commande php --ini
    3) Pour finir, la méthode la plus simple durant un débuggage à l'aveugle avec un serveur est d'ouvrir une console pour voir les logs d'erreurs d'Apache.
Utiliser la commande suivante pour faire défiler les logs en temps réel :
| Initiation à PHPUnit | Faire un serveur SPARQL |