PHPEclipse : Programmez librement pour le Web


précédentsommairesuivant

IV. PHPEclipse

PHPEclipse

IV-A. Installation

Help -> Software Updates -> Find and Install...

Démarrez Eclipse puis ouvrez le gestionnaire de mise à jour. [ Help -> Software Updates -> Find and Install... ]

Gestionnaire de mise à jour : Ajout d'un nouveau site distant

Sélectionnez "Search for new feature to install", puis ajouter un nouveau site distant (New remote site) : http://phpeclipse.sourceforge.net/update/releases/

Gestionnaire de mise à jour : Résultat de recherche de nouvelles fonctionnalités.

Cochez PHPeclipse, puis suivez les instructions.

IV-B. La Perspective PHP

Perspective PHP

La Perspective PHP, comme son nom l'indique, initialise l'environnement pour le développement PHP. Vous pouvez la customiser à partir du menu principal.
[ Window -> Customize Perspective... ].

IV-C. Création d'un projet

Assistant à la création d'un projet Eclipse

Vous pouvez créer un nouveau projet spécifique en selectionnant l'assistant à la création d'un projet. [ File -> New -> Project ]

IV-D. La vue Navigator

Vue Navigator

La vue Navigator fournit l'arborescence du Workspace courant et permet d'effectuer diverses actions sur les ressources. Cette vue varie selon les perspectives utilisées.

IV-E. L'éditeur

IV-E-1. Hovers

Lorsque vous placez votre curseur sur un élément du code source, l'éditeur fournit un certain nombre d'informations telles que son type, le ou les fichiers source dans lesquels il est déclaré et éventuellement les commentaires PHPDoc affiliés.

Le terme élément de code source englobe les variables, constantes, fonctions, attributs, méthodes et classes.

Commentez votre code avec PHPDoc, ceci améliorera la compréhension générale du programme, la productivité et la qualité de la documentation technique.

IV-E-2. Navigation

Lorsque votre curseur est placé sur un élément de code source, vous pouvez vous rendre à sa déclaration en utilisation le menu contextuel (Open Declaration/Include) ou en appuyant sur la touche [F3]

Déclarations multiples

Si l'élément dispose de plusieurs déclarations, une boîte de dialogue vous propose de choisir la ou les ressources à ouvrir.

La fonctionnalité hyperlink style[Preferences -> PHPeclipse Web Developement -> PHP -> Navigation ] vous permet également d'ouvrir une déclaration en maintenant la touche [Ctrl] et en cliquant sur l'élément de votre choix.

IV-E-3. Folding

Folding : Repliage du code

Le folding permet de replier des blocs de code source (commentaires, corps de fonctions, méthodes ou classes) pour améliorer la lisibilité globale.

IV-E-4. Code Assist

Code Assist : Aide à la saisie de code source

Le Code Assist est une fonctionnalité d'aide à la saisie de code source. Cette fonctionnalité vous propose une complétion et un descriptif pour toutes les fonctions et variables prédéfinies, toutes les variables, constantes, fonctions et méthodes déclarées dans le fichier et / ou le projet courant ainsi que l'intégralité des balises HTML et PHPDoc.

Vous pouvez activer manuellement le Code Assist avec la combinaison de touches [Ctrl] + [Espace].

IV-E-5. Code Templates

Code Templates : Gabarits de code

Les code templates ou gabarits de code vous permettent d'insérer une en-tête personnalisée dans vos fichiers PHP ou HTML.

Code Templates : Gabarit de code - Edition

L'option Insert Variable...vous propose une liste de variables d'environnement que vous pouvez utiliser dans votre en-tête.

IV-E-6. Aide PHP

PHPEclipse intègre le manuel PHP, lorsque vous placez votre curseur sur une fonction prédéfinie, vous pouvez accéder à sa documention depuis le menu contextuel. Notez qu'il est possible de remplacer le manuel PHP interne dans les préférences de PHPEclipse.

Vous pouvez également accèder à l'aide avec le raccourci [Ctrl] + [Shift] + [H].

IV-F. La vue PHP Browser

Vue PHP Browser

La vue PHP Browser fournit un navigateur Web interne. Liée à l'éditeur, elle permet d'obtenir un aperçu en temps réel des modifications.

IV-G. Les vues annexes

IV-G-1. Outline

PHPEclipse : Vue Outline

La vue Outline permet d'obtenir un résumé structurel du fichier source. Il s'agit d'une vue native d'Eclipse, étendue en fonction des plug-ins installés.

IV-G-2. Tasks

Il est parfois nécessaire de placer des "post-it" à certains endroits du code, pour ne pas omettre une tâche ou pour la signaler à un collaborateur. Les tâches sont définies avec un niveau de priorité (haute, normale, basse) et peuvent être assignées via le menu principal [ Edit -> Add Task ], la marge de l'éditeur, ou en tappant un commentaire monoligne // TODO : Tâche à effectuer, notez que dans ce dernier cas, la tâche sera simplement listée, sans état et avec une priorité normale.

PHPEclipse : Vue Tasks

La vue Tasks répertorie toutes les tâches assignées (achevées ou non), avec un indicateur de priorité.

Indicateur Priorité
Image non disponible Haute priorité
Image non disponible Basse priorité

IV-G-3. Problems

PHPEclipse : Vue Problems

La vue Problems vous indique les erreurs de syntaxe et d'inclusion de fichiers en temps réel.

IV-H. Débogage

PHPEclipse : Débogage

PHPEclipse intégre nativement une interface cliente pour DBG Debugger.

IV-H-1. DBG : PHP Debugger

Si vous utilisez Windows, vérifiez sur le site officiel qu'il existe l'extension php_dbg.dll correspondant à votre version de PHP. Si ce n'est pas le cas, faites une recherche sur PHPEclipse.net (entre autres) ou compilez la DLL à partir des sources.

IV-H-1-a. Paramètrage

Ajoutez les lignes suivantes dans votre php.ini

 
Sélectionnez

[debugger]
extension=php_dbg.dll
debugger.enabled=on
debugger.profiler_enabled=on
debugger.hosts_allow=localhost
debugger.hosts_deny=ALL
debugger.ports=7869, 10000/16
							
Description des paramètres
  • extension : Chemin de l'extension.
  • debugger.enabled : Activation / Désactivation du débogueur.
  • debugger.profiler : Activation / Désactivation du profiler.
  • debugger.hosts_allow : Hôtes autorisées.
  • debugger.hosts_deny : Hôtes refusées.
  • debugger.ports : Ports d'écoute.

Redémarrez votre serveur pour que les changements soient pris en compte puis vérifiez que DBG est operationnel avec phpinfo().

IV-H-2. La Perspective Debug

La perspective Debug définit un contexte général pour le débogage, elle se compose notamment de trois vues :

  • Debug : Fournit l'état d'une session de déboguage.
  • Variables : Fournit la valeur instantanée d'une variable lorsque un point d'arrêt est placé.
  • Points d'arrêt : Liste les points d'arrêt. (N'est présentement pas pris en charge par PHPEclipse).

IV-H-2-a. Configurer une session

Débogage : Configuration d'un contexte

Créez un nouveau contexte d'exécution, puis sélectionnez le projet et le fichier PHP à déboguer.

Les points d'arrêt logiciel ne semblent pas être pris en charge par PHPEclipse, utilisez la fonction debugbreak() pour les placer.

Débogage : Configuration de l'environnement

Dans le premier onglet environnement, il vous faut notamment préciser le débogage distant.

Description des paramètres
  • Remote Debug : Indique qu'il s'agit d'un déboguage distant.
  • Cross Platform debugging : À cocher si l'extension est installée sur une plate-forme système différente du client.
  • Open with DBGSession URL in internal Browser : Initialise le déboguage à partir du navigateur interne (PHP Browser).
  • Remote Sourcepath : Répertoire racine distant.

Après avoir paramétré votre session, vous pouvez lancer le débogage immédiatement, via la boiîte de dialogue, la barre d'outils ou avec la touche [F11].

Vous pouvez parcourir le script pas-à-pas avec la touche [F5].


précédentsommairesuivant

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

Copyright © 2006 Jean-Pierre Grossglauser. Aucune reproduction, même partielle, ne peut être faite de ce site et 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.