Se configurer un environnement de développement PHP sur Eclipse

Eclipse est reconnu pour être une solution de développement pour du Java mais des versions spécialisées ont été créées il y a quelques années afin d'étendre son utilisation à d'autres langages, comme le C++, Python, PHP, Javascript... Avec Eclipse PHP, vous disposez d'un outil performant et complet pour développer sur des projets web back et front en CSS, HTML, Javascript et PHP et ce quel que soit votre environnement puisque le logiciel est multi-plateformes (Linux, Windows, MacOS, Raspberry PI...).

Télécharger Eclipse PHP

Il faut se rendre sur www.eclipse.org et télécharger la version de "Eclipse IDE for PHP Developers" correspondant à votre système, puis l'installer.

Importer dans Eclipse un projet PHP déjà existant

En utilisant un projet avec des ressources liées, cela évite de polluer les fichiers source avec ceux d'Eclipse : le code source peut être stocké à un endroit et le paramétrage d'Eclipse dans un autre. Ça peut être pratique en cas de changement de logiciel, si plusieurs types d'éditeurs sont utilisés, pour faire de la sauvegarde précise du code, si différents systèmes d'exploitation sont utilisés...

• Faites File > New > PHP Project
• Cochez "Create new project in workspace" et vérifiez que "Use project as source folder" est coché.
• Cliquez sur Next.
• Sur l'écran "PHP Include Path", vous pouvez cliquer directement sur Next.
• Sur l'écran "PHP Build Path", cliquez sur Link Sources
  
  
• Ajoutez vos répertoires et fichiers sources, cochez à chaque fois "Update exclusion filters in other source folders to solve nesting".
  
  
• Cliquez sur Finish quand vous avez ajouté toutes vos sources de la racine.
• Un nouveau projet a été créé, affichant vos répertoires et fichiers sources.
  
  

Ainsi vous conservez vos codes sources séparés du paramétrage d'Eclipse. Vous pouvez aussi éditer le même projet sur des versions Windows et Linux d'Eclipse en synchronisant en temps réel et de façon transparente le code source entre ces systèmes.

Si besoin, les ressources liées sont indiquées au niveau du projet : clic droit, Properties > Resources > Linked Resources et onglet Linked Resources :

Personnaliser ses touches de raccourcis

Dans le menu Window > Préférences > General > Keys, vous pouvez changer les touches de raccourcis par défaut.

J'ai par exemple mis F3 pour passer au résultat de recherche suivant (comme sur Visual Studio, Notepad++), Control+D pour dupliquer une ligne (Notepad++), F12 pour aller sur la définition d'une fonction (Visual Studio), Control+G pour aller une ligne particulière (Notepad++) :

Actualiser automatiquement un fichier modifié en dehors d'Eclipse

Si un fichier déjà ouvert sur Eclipse est par la suite modifié en dehors (par un éditeur tiers par exemple), pour le recharger automatiquement, il faut aller dans les options, puis General > Workspace et cocher Refresh using native hooks or polling.

Le fichier modifié sera alors actualisé à l'écran (sans aucun avertissement).

Erreur "<class> cannot be resolved to a type"

Dans le cas de classes PHP par défaut (DateTime, PDO, ZipArchive, FilesystemIterator, Exception...), créez un fichier .buildpath à la racine de votre projet, contenant le code suivant :

Redémarrez Eclipse (ou fermez/réouvrez le projet) puis Project / Clean.

Cette opération permet également à Eclipse de parcourir les require du code afin d'y recenser vos classes.

Disposer du style d'indentation Whitesmiths sur Eclipse

Le style d'identation Whitesmiths n'est plus autant utilisé qu'auparavant mais présente un avantage certain en lisibilité, par l'alignement des accolades sur le code, formant ainsi des blocs. A son utilisation est reprochée une trop grande utilisation de l'espace disponible à l'écran.

Pour l'utiliser, aller sur Windows / Preferences / PHP / Code Style / Formatter et importez le fichier suivant : whitesmiths.xml(29 Ko)

Eviter d'analyser les librairies externes dans un projet Eclipse

Par défaut, Eclipse analyse tous les fichiers du projet, y compris ceux faisant partie des librairies extérieures, non maintenues sur le projet actuel.

Pour les exclure de l'analyse, faite un clic droit sur leur répertoire parent puis Use à source folder.

Contourner les "<var> is undefined", "<var> is never used"

Eclipse n'analysant pas les include, require, require_once pour analyser les fichiers, vous pouvez avoir l'erreur "<var> is undefined" ou "<var> is never used" quand bien même la variable et déclarée et utilisée.

Pour contourner cela, vous pouvez créer une annotation au-dessus de l'utilisation de la variable : @var type variable