« SPARQL Protocol and RDF Query Language/Travail pratique/Initiation à Eclipse » : différence entre les versions

Une page de Wikiversité, la communauté pédagogique libre.
Contenu supprimé Contenu ajouté
Aucun résumé des modifications
m Robot : Changement de type cosmétique
Ligne 294 : Ligne 294 :
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.
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 encore pour commencer à faire de l'exécution pas à pas dans le code.<br/>
C'est très pratique pour voir à cet endroit la valeur des variables ou encore pour commencer à faire de l'exécution pas à pas dans le code.<br />
Le pas à pas permet d'avancer dans le code "commande par commande". Le pas à pas permet de voir exactement ce qui exécuter par le programme.
Le pas à pas permet d'avancer dans le code "commande par commande". Le pas à pas permet de voir exactement ce qui exécuter par le programme.


Ligne 324 : Ligne 324 :
Si ce n'est pas le cas, indiquez XDebug et le serveur moncv}}
Si ce n'est pas le cas, indiquez XDebug et le serveur moncv}}


=== Débugger===
=== 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.
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.

Version du 29 novembre 2011 à 17:48

Logo de la faculté
Cette page est une ébauche concernant l’informatique. Avant de recréer une ressource du même type, essayez d'abord de compléter celle-ci ; si c'est impossible, remplacez son contenu par le vôtre. Si vous êtes l'auteur(e) de cette page et que vous souhaitez la continuer, retirez ce bandeau.
Début de la boite de navigation du travail pratique
Initiation à Eclipse
Image logo représentative de la faculté
T.P. no 6
Leçon : SPARQL Protocol and RDF Query Language

TP de niveau ?.

Précédent :Initiation à PHPUnit
Suivant :Faire un serveur SPARQL
En raison de limitations techniques, la typographie souhaitable du titre, « Travail pratique : Initiation à Eclipse
SPARQL Protocol and RDF Query Language/Travail pratique/Initiation à Eclipse
 », n'a pu être restituée correctement ci-dessus.


Introduction

Pourquoi utiliser Eclipse ?

Dans ce TP, nous allons installer Eclipse ainsi que certains composants de [[w:Débogueur|débuggage]. Eclipse est l'un des logiciels les plus utilisés pour faire du développement Web et il est gratuit. Malheureusement, ça puissance est inversement proportionnel à son ergonomie d'utilisation. Il faut un certain temps d'utilisation pour savoir correctement l'utiliser.

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 à tous vrais développeurs professionnels pour gagner beaucoup de temps.

Durée du TP

2 heures

Matériel du TP

Il vous faut avoir fait au moins le TP PHP.

A savoir avant de commencer

Il n’y a que 2 débogueurs pour PHP :

  • Zend qui est intégré dans la suite de développement payante Zend (à condition d’avoir les serveurs de productions é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épense.

Documentations

Ce TP a été fabriqué avec les documents suivants :

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.

lsb_release -a

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 dans Google quand vous recherchez :le nom de votre distribution Linux avec sa version et XDebug .

Ubuntu 10.04.3

Installer le composant php5-xdebug.

sudo apt-get install php5-xdebug

Ouvrez le fichier : /etc/php5/conf.d/xdebug.ini

sudo vim /etc/php5/conf.d/xdebug.ini

Ajouter à la fin de ce fichier les lignes suivantes:

; configuration for php xdebug module
xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000

Mettre à jour votre configuration :

sudo service apache2 reload

Vérifier que XDebug est bien activé dans votre configuration PHP.

php -r 'phpinfo();' | grep -e "xdebug support => enabled"


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 :

sudo apt-get install default-jre

Verifier si votre version de JRE est 32 ou 34 bits :

java -d64 -version

ou

java -d32 -version


Eclipse

En fonction de la version de votre JRE 32 ou 64bits, vous choisirez la dernière version de "Eclipse platformRuntime" x86 ou x86_64 : (ce lien est celui donné par la documention Eclipse de août 2011)


Nous installerons Eclipse dans votre répertoire personnel :

mkdir ~/opt

On passe dans le répertoire où votre navigateur à enregistrer le package Eclipse, on le décompresse et on le déplace dans le répertoire ~/opt.

cd {directory where your browser downloaded the package to}
tar -zxvf eclipse-SDK-3.4.1-linux-gtk.tar.gz 
mv eclipse ~/opt

On fabrique le répertoire bin dans notre répertoire home qui sera utilisé pour lancer Eclipse :

mkdir ~/bin

On crée le fichier qui sera le script d'exécution d'Eclipse :

vim ~/bin/eclipse

Copier ce texte dans ce fichier :

export MOZILLA_FIVE_HOME="/usr/lib/mozilla/"
export ECLIPSE_HOME="$HOME/opt/eclipse"

$ECLIPSE_HOME/eclipse $*

On autorise le script à être exécuté :

chmod +x ~/bin/eclipse

Pour finir, on va créer un raccourcie pour le mettre sur notre bureau :

  1. cliquer bouton droit sur votre bureau
  2. créer raccourcie (ou create launcher)
  3. indiquer le nom : Eclipse
  4. indiquer le chemin du script (command) : /home/<your username>/opt/eclipse/eclipse
  5. 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
  6. 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 plugins d'Eclipse

Dans Eclipse :

  1. Aller dans le menu : Help > Install New Software.
  2. cliquer que le bouton "Add...".
  3. renseigner les champs avec le nom : Indigo et l'adresse http://download.eclipse.org/releases/indigo.

Vous pouvez maintenant installer les plugins PHP et Web.

Installer le plugin PHP

Dans Eclipse :

  1. Aller dans le menu : Help > Install New Software.
  2. Choisir le site (Work with) : "Indigo -- http://download.eclipse.org/releases/.
  3. Attendre que la liste soit mise à jour (attendez que le mot pending disparaisse...).
  4. Aller ensuite dans langages de programmation.
  5. Cocher la liste PHP Development Tools (PDT).
  6. Cliquer sur suivant deux fois.
  7. Cocher Accepter les licences.
  8. Cliquer sur terminer.

Après l'installation, Eclipse vous demande de redémarrer :

  • cliquer sur "redémarrer maintenant"

Installer le plugin Web

  1. Aller dans le menu : Help > Install New Software .
  2. Choisir le site (Work with) : "Indigo -- http://download.eclipse.org/releases/ .
  3. Attendre que la liste soit mise à jour (attendez que le mot pending disparaisse...).
  4. Aller ensuite dans "Web,XML,JavaEE...".
  5. Cocher "Eclipse Web Developer Tools".
  6. Cliquer sur suivant deux fois.
  7. Cocher Accepter les licences.
  8. 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.

  1. Ouvrir Eclipse.
  2. Menu Fichier > Nouveau projet.
  3. Ouvrer PHP > projet PHP.

La boite de dialogue nouveau projet s'ouvre.

  1. Donner un nom au projet : MonCv.
  2. Cocher : créer un projet de sources existantes.
  3. Rechercher la racine du répertoire créer dans le TP précédent : ~/projets/moncv .
  4. cliquer sur Terminer (Finish).

Configurer la construction du projet

Nous allons utiliser phing pour construire le projet automatiquement pour permettre de le débugger.

A chaque modification d'un fichier dans le projet, le script build.xml sera exécute pour les tests unitaires et déployer sur le serveur Web (/var/www/moncv) que nous avons configuré dans un précédent TP.

Pour ce faire :

  1. Faire un clic droit sur ​​le projet
  2. sélectionner Propriétés
  3. sélectionner "Constructeurs"(builder)
  4. cliquer sur Nouveau pour afficher la boîte de dialogue "Choisir le type de configuration"
  5. sélectionner Programme
  6. Cliquer sur OK

La boîte de dialogue pour créer une configuration s'est affichée :

  1. Donner un nom par exemple : Phing build.xml
  2. Donner l'emplacement de l'exécutable (Location) : /usr/bin/phing
  3. Donner l'emplacement d’exécution (Working directory) :
    1. Cliquer sur le bouton Browse WorkSpace
    2. Sélectionner la racine où se trouve le fichier build.xml, ici MonCV
    3. Cliquer sur OK

L'emplacement d’exécution (Working directory) doit contenir quelque chose qui ressemble à :

${workspace_loc:/MonCv}

Maintenant, on indique les moments d’exécution :

  1. Aller dans l'onglet Rafraîchir (Refresh)
  2. Cocher la case rafraîchir les ressources (Refresh ressouces upon each completion)
  3. Cocher : Espace de travail en entier (The entire Workspace)
  4. Aller maintenant dans l'onglet Options (Build Options)
  5. Cocher l'auto-construction (During auto-build)

Cliquer finalement sur le bouton OK pour refermer la boite de dialogue.

Configurer le débogueur

Indiquer le serveur utiliser pour débugger

Nous utiliserons le serveur Web que nous avons installé dans un précédent TP pour déboguer notre projet.

  1. Via le Menu : Window > Preferences
  2. Ouvrir le noeud : PHP > PHP Servers
  3. Créer un nouveau serveur : MonCV
  4. Donner son domaine (base url): http://moncv
  5. Donner la racine sur le disque du service Web (local Web root): /var/www/moncv
  6. Aller dans l'onglet Mapping
  7. Faire nouveau
    1. Dans chemin sur le serveur mettre : /var/www/moncv
    2. Cocher chemin dans l'espace de travail
    3. Trouver la racine des sources, c'est-à-dire le répertoire src. Vous devez avoir comme résultat : MonCV/src
  8. Cliquer sur OK jusqu'à ce que toutes les boites de dialogues soient fermées

Indiquer le débogueur

  1. Via le Menu : Window > Preferences
  2. Aller dans le Menu : Window > Preferences
  3. Cliquer sur le noeud : PHP > Debug
  4. Dans la liste "PHP Debugger" choisir "XDebug“
  5. Cliquer sur appliquer (Apply)
  6. 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 :

  1. Cliquer bouton droit sur le répertoire src dans Eclipse
  2. Nouveau > PHP File
  3. Indiquer comme nom de fichier : index.php

Insérer le texte suivant dans le fichier :

<?php
phpinfo();

Sauvegarder en faisant 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 encore pour commencer à faire de l'exécution pas à pas dans le code.
Le pas à pas permet d'avancer dans le code "commande par commande". Le pas à pas permet de voir exactement ce qui exécuter 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ù la fonction phpinfo se trouve. 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 point 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. A 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.

  1. Via le Menu : Run > Debug configurations
  2. Cliquer bouton droit sur PHP Web Page
  3. Dans le menu contextuel choisir Nouveau
  4. Donner un nom : index.php
  5. Indiquer le fichier PHP à executer en cliquant sur le bouton chemin et trouver le fichier index.php (ce qui doit donner  : /MonCv/src/index.php)
  6. Décocher : Break at first line (sinon le débuggeur s'arrêtera dès la première ligne)
  7. Décocher Auto-generate pour indiquer manuellement l'url index.php sur le serveur
  8. Modifier l'URL /MonCv/src/index.php en laissant juste index.php
  9. Cliquer sur appliquer (Apply) pour sauver
  10. Cliquer sur fermer (close)


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 menu : Window > Open Perspective > PHP ou Debug.

Un bug en anglais signifie insecte ou encore une erreur dans du code informatique. 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ébugage

  1. En haut de l'écran (dans la toolbar), il y a un insecte avec un triangle, cliquer sur le triangle
  2. choisir index.php qui est le profil que nous avons créé.
  3. Eclipse vous propose de passer en mode Debug : accepter

Vous pouvez voir maintenant (si tout c'est bien passé) :

  • Zone Debug (en haut à gauche) un carré rouge qui vous permet d'arrêter le débugage
  • Zone Debug (en haut à gauche) un triangle vert qui vous permet de poursuivre l’exécution
  • Zone Debug (en haut à gauche) des flèches jaune 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 bleu
  • 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 éclipse les milles et une fonction disponible.

Vous avez maintenant l'environnement de développement qui va nous permettre de développer un service Web mais surtout de suivre la leçon sur SPARQL.