Installer et configurer Symfony Eclipse Plugin pour Symfony2

La nouvelle version du célèbre framework PHP Symfony, Symfony2, apporte des changements pour le moins importants: changement de l'arborescence des fichiers, prise en charge des namespaces introduits par PHP5.3, moteur de template Twig etc.

Dans ce tutoriel, nous verrons comment l'utilisation d'Eclipse et du plugin Symfony2 Eclipse nous permettra d'accélérer nos développements avec le framework.

• 

  • Plan du chapitre:

  • Installer et configurer Eclipse
  • Installation d'un éditeur de YAML
  • Installer le Symfony2 Eclipse Plugin
  • Configurer son projet pour utiliser le plugin

Installer et configurer Eclipse

On commence par récupérer la dernière version Classic d'Eclipse sur le site http://www.eclipse.org/downloads/: actuellement la version 3.7 Indigo.

Une fois, son installation terminée, rendez-vous dans le menu Help > Check for Update pour être sur d'avoir une installation à jour.

Pour fonctionner avec Eclipse, le plugin Symfony2 Eclipse nécessite une version récente du PHP Development Tools (PDT). Pour cela, récupérez la dernière night build de PDT, directement depuis le site d'intégration continue d'Eclipse à cette adresse.

Après avoir cliqué sur le dossier de la dernière build, vous devrez récupérer le fichier pdt-Update-N[TIMESTAMP]>.zip, comme sur l'exemple ci-dessous :



Une fois dézippé, il faut l'importer dans Eclipse. Pour se faire, rendez-vous dans le menu Help > Install New Software,

Il convient par la suite d'ajouter une nouvelle source. Pour cela, cliquez-sur Add. Puis sélectionnez votre dossier via le bouton Local.



Le plugin PDT devrait alors apparaître. Sélectionnez le, puis confirmez et validez les différentes étapes pour terminer son installation.

Installation d'un éditeur de YAML

Par défaut, Eclipse ne dispose pas d'éditeur pour traiter les fichiers YAML, très utilisés par Symfony. Nous allons donc installer le plugin Yedit.

Pour l'installer, retournez dans l'ajout de plugins (Help > Install New Software) et ajoutez un nouveau site Repository (en cliquant sur Add) et renseignez dans le champ Location :

Code:

http://dadacoalition.org/yedit/

Puis laissez-vous guider pour installer YEdit.

Installer le Symfony2 Eclipse Plugin

Nous pouvons à présent installer le Symfony2 Eclipse Plugin.

En suivant le même processus que pour l'éditeur YEdit, ajoutez le repository suivant:

Code:

http://pulse00.github.com/updatesite/

Sélectionnez et installez les 2 fonctionnalités de Symfony:

• Symfony (Symfony Core Feature et Symfony Twig Support)
• Twig (Twig Editor Feature)

Acceptez les différentes fenêtres affichées puis redémarrez votre IDE pour terminer l'installation.

Votre environnement de développement est désormais prêt pour Symfony2 !

Configurer son projet pour utiliser le plugin

Il convient de commencer par vérifier que le support du PHP est actif pour votre projet. Pour cela, faîtes un clic-droit sur ce dernier (le dossier bleu dans l'explorateur), puis Configure > Add PHP Support : si celui-ci est grisé, c'est que votre projet l'a déjà prise en compte.

Activez ensuite les fonctionnalités Symfony et Twig : clic-droit sur votre projet Twig > Add/Remove Twig Nature. Faire de même avec Symfony > Add/Remove Symfony Nature.

[msg=attention]Il semblerait que leurs activations ne fonctionnent pas du premier coup. Recommencez la manipulation tant que vous ne voyez pas une icône sf à coté du nom de votre projet[/msg]



Pour vérifier, ouvrez les propriétés de votre projet (clic droit > properties), et regardez que Symfony Builder apparaisse bien dans la liste des builders.

Toujours dans les propriétés, aller dans le menu PHP Build path, puis double-cliquez sur Excluded.



Nous allons ajouter les dossiers à exclure : choisissez Add Multiple... au niveau de la partie Exclusion patterns et sélectionnez les dossiers suivants :

• app/cache
• app/logs
• vendor/bundles/Sensio/Bundle/GeneratorBundle/Resources/skeleton/

Activez l'auto-fermeture des balises Twig

Si vous souhaitez activer l'auto-complétion des balises de Twig dans vos templates, rendez-vous dans les préférences d'Eclipse, puis activez les dans le menu Twig > Editor > Codeassist.