Ajouter le support des Template CakePHP dans Eclipse

Aujourd'hui nous avons le choix dans le outils de développement intégrés pour faire du PHP. D'un côté nous avons des solutions payantes et d'un autre les alternatives gratuites (ou presque). Lorsqu'on utilise un Framework PHP comme Symfony ou CakePHP il est intéressent d'avoir un support dans l'EDI avec les fonctionnalités de bases (complétion, coloration du code, console, versionning...). Comme d’autres Framework, CakePHP utilise un format spécifique pour définir les pages formant la vue (le contenu) et ce type de fichier n'est généralement pas pris en compte dans votre EDI (cela dépend de l'EDI, du Framework et des plugins bien sur..). Je vais donc vous expliquer comment configurer Eclipse (PDT) pour que celui ci puisse prendre en charge les fichiers .ctp (les fichiers Template de CakePHP) et pour qu'il les exploitent comme des fichiers php standard.

Configuration d'Eclipse

C'est assez simple à mettre en place, pour l'instant lancez Eclipse (j'utilise la version 3.6 pour cet article) et allez dans le menu "Window" puis choisissez l'item "Preferences". Sur le menu de gauche allez dans "General" puis sur "Content Types", c'est ici que nous allons définir le format .ctp . Vous avez sur votre gauche quatre type de contenu : Binary File, Java Class File, Text et Word Document, déroulez les options du contenu "Text" et choisissez "PHP Content Type". Vous pouvez voir dans la fenêtre du bas (File associations) tous les types de fichiers associés à l'éditeur PHP. Il ne reste qu'à cliquer sur "Add" et ajouter le type de fichier désiré pour que celui ci soit prit en charge par l'éditeur PHP, dans notre cas nous rentrerons *.ctp .

Sur cette capture d’écran j’ajoute par exemple le format *.phtml utilisé dans le mini Framework Atomik. Une fois validé ce type de fichier sera pris en compte dans vos projets PHP, il faudra pour en ajouter un, faire un clic droit sur le dossier de destination et créer un nouveau fichier (New File) en lui donnant l'extension .ctp et c'est tout.

Comme vous pouvez le constater sur cette deuxième capture d’écran mon fichier index.ctp est reconnu comme un fichier PHP, j’ai donc tous les bénéfices de l’éditeur PHP (coloration syntaxique, complétion, etc…).

Installation de Pear sous EasyPHP et installation de Symfony

Voici un court article expliquant comment installer et utiliser Pear sous Windows avec EasyPHP et installer Symfony par la même occasion. J'ai été confronté au problème la semaine dernière et je vous propose une solution qui fonctionne. Le problème avec EasyPHP est que le fichier go-pear.phar n'est pas bon alors lorsque vous lancez go-pear.bat pour installer Pear la première fois et bien vous avez un message d'erreur.

1. Installation de Pear

1. Installez EasyPHP à moins que celui ci ne le soit pas déjà ;
2. Récupérez le fichier go-pear.phar (clique droit/enregistrer la cible sous) ;
3. Remplacer le fichier go-pear.phar qui est dans EasyPHP\php\PEAR par le nouveau ;
4. Revenez dans EasyPHP\php et lancer le fichier go-pear.bat ;
5. Suivez les instructions à l'écran (j'ai laissé les options par defaut [Entrer] ;
6. Le script vous indique alors que les chemins de Pear dans php.ini ont été mis à jour ;
7. C'est terminé.

2. Installation de Symfony

Ouvrez l'invite de commande (menu démarrer -> exécuter -> cmd), naviguez jusqu'à votre dossier d'installation de EasyPHP puis allez dans le dossier php. Tapez les commandes suivantes (suivant la version de Symfony que vous voulez) :

pear.bat channel-discover pear.symfony-project.com

pear.bat install symfony/symfony-1.4.8

Une fois que l'installation est terminée vous pouvez ajouter le dossier EasyPHP\php au PATH du système et comme ça vous pourrez utiliser Symfony (ou pear) d'où vous voulez. Donc faites un clique droit sur votre poste de travail et choisissez Propriétés, allez dans les paramètres avancés et enfin cliquez sur "Variables d'environnement". Dans les variables système (en bas), recherchez la variable Path et faites "modifier". A la fin de la chaine de caractère ajoutez un point virgule si il n'est pas présent et ajouter le chemin vers votre dossier php. Ma variable path ressemble à ça par exemple (extrait) :

[...];C:\Program Files\Common Files\GTK\2.0\bin;C:\Program Files\Windows Live\Shared;C:\dev\android-sdk\tools;C:\Program Files\QuickTime\QTSystem\;C:\dev\EasyPHP-5.3.3\php

Une fois que vous avez validé, ouvrez une invite de commande et tapez : 

symfony -V

Vous devriez avoir quelque chose comme ça en retour

symfony version 1.4.8 (c:\dev\EasyPHP-5.3-3\php\PEAR\symfony

3. Création du projet de test avec Symfony

Nous allons pour terminé cet article créer un projet de test, pour cela rendez vous dans le dossier www et créez y un nouveau dossier (j'ai appelé mon projet "Webme"). Ouvrez une invite de commande et rendez vous dans ce dossier, tapez ensuite les commandes de création du projet :

symfony generate:project webme

Une fois que le projet est créé vous n'avez plus qu'à lui ajouter une ou des applications et vous pouvez enfin travailler avec Symfony sur votre serveur local EasyPHP.

symfony generate:app --escaping-strategy=on --csrf-secret=MotSecret frontend

Votre nouvelle application est générée. A vous de passer à la suite.

4. Quelques liens sur Symfony

• La documentation officielle
• Un tutoriel en provenance de "La Ferme du Web" vraiment très bien fait de 13 chapitres ;
• Un tutoriel issu d'un blog pour créer un blog avec Symfony
• Les tutoriels Symfony sur le site developpez.com

N'hésitez pas à réagir avec des remarques et des liens PHP et Symfony.