Premier tutorial sur ce blog, avec la création d’un nouveau projet Symfony. Rien de bien compliqué en théorie puisque la documentation est déjà bien fournie, mais nous souhaitons ici avoir une installation permettant le travail collaboratif. Nous allons donc utiliser le système de versionnage Subversion. Rentrons dans le vif du sujet.
1/ Création du repository
Un repository SVN est l’endroit où va être stocké l’ensemble des modifications apportées au projet.
mkdir /home/projects/sfProject svnadmin create /home/projects/sfProject
2/ Création de la structure de notre projet.
Un projet SVN se doit de comporter trois répertoires principaux: tags, branches et trunk. Le tronc étant la version actuelle, et les branches/tags des versions de développement ou des versions passées qui continuent néanmoins à être maintenues.
Je créé donc cette structure dans un répertoire temporaire, pour l’intégrer au repository
mkdir /tmp/project /tmp/project/trunk /tmp/project/tags /tmp/project/branches svn import /tmp/project/ file:///home/projects/sfProject -m "Import de la structure"
Voila. Si tout se passe bien on devrait désormais avoir une structure classique dans notre repository. On peut vérifier cela avec la fonction svn list.
root@localhost# svn list file:///home/projects/sfProject branches/ tags/ trunk/
La structure est bien installée. On va pouvoir créer la copie de travail.
3/ Création de la copie de travail
La copie de travail, c’est une copie de votre projet que vous allez pouvoir modifier, enrichir, recréer, tout en étant certain que chacune des modification sera bien enregistrée dans le repository. Il doit donc exister autant de copies de travail que de personnes qui interviennent sur votre projet.
Si vous travaillez sur Linux, que vous avez configuré un sous domaine sur /home/domains/sfProject, voici comment extraire une copie de travail:
# cd /home/domains/sfProject # svn co file:///home/projects/sfProject ./
On se retrouve avec un répertoire contenant nos trois fameux dossiers: branches, tags et trunk.
Nous allons rajouter un nouveau répertoire: vendor.
# mkdir vendor
Ce répertoire n’existe pas encore dans le repository, puisque nous l’avons créé dans une copie de travail. Pour l’intégrer au repository, nous effectuons la commande suivante (dans le répertoire /home/domaines/sfProject):
# svn add vendor
Puis nous allons connecter ce répertoire à une copie distante de Symfony. Cette opération permettra de récupérer automatiquement les nouvelles mises à jour du packages.
# svn propedit svn:externals ./vendor
Dans la fenetre qui s’ouvre on rentre simplement le nom du package, puis l’adresse SVN correspondant à la version que l’on souhaite récupérer. Ici, la version 1.0
symfony http://svn.symfony-project.com/branches/1.0/
Nous allons soumettre nos changements aux repository (une fenetre s’ouvre, fermer là puis validez):
# svn commit
Une fois les changements propagés, effectuez un simple update de votre copie de travail.
# svn up
Et là, miracle! Le système est en train de récupérer tout seul l’ensemble de l’arbre de Symfony. L’avantage, c’est qu’à chaque correction de bug sur la branche que vous avez choisie, votre version locale sera immédiatement patchée, à chaque fois que vous ferez un update.
4/ Création du projet Symfony
Dans Symfony, beaucoup de choses se font en ligne de commande. Pour l’instant, l’executable symfony se trouve dans le répetoire vendor/data/bin/. Pour créer un projet, on va donc simplement se rendre dans le répertoire cible (trunk/ dans notre cas), puis ajouter un nouveau projet à partir de l’executable.
# cd /home/domaines/sfProject/trunk // toujours notre copie de travail # php5 /home/domaines/sfProject/vendor/symfony/data/bin/symfony init-project sfProject
Les fichiers se copient, voila, vous avez votre premier projet en bon état de marche.
5/ Réglages
Si l’on effectue un test coté web, il y a de fortes chances que cela ne marche pas. Ceci parce qu’il faut faire pointer Apache vers le bon répertoire, à savoir /home/domaines/sfProject/trunk/web. Par ailleurs, les feuilles de style par défaut du package se trouvent dans notre copie synchronisée. Nous allons donc créer un Alias. Ce qui vous donne:
# nano /usr/local/apache/conf/httpd.conf // dépend de votre configurationDocumentRoot /home/domaines/sfProject/trunk/web Alias /sf /home/domaines/sfProject/vendor/symfony/data/web/sf ServerName sfProject.mondomaine.com AddHandler x-httpd-php5 .php
Un petit test sur sfProject.mondomaine.com devrait également vous fournir une erreur. Il faut pour obtenir une réponse créer une application. C’est ce que nous faisons avec la ligne de commande suivante:
# cd /home/domaines/sfProject/trunk/ # php5 ./symfony init-app frontend # chown -fR vous:votregroupe ./
La dernière commande sert à donner les bons droits à votre projet, attribué a l’utilisateur root par défaut.
Cette fois, un test sur sfProject.mondomaine.com fonctionne bien, avec la bonne feuille de style grâce à nos directives Apache.
6/ Finalisation
Il nous reste à finaliser le projet. Nous avons effectué pas mal de changements, mais aucun n’est encore dans le repository. Une commande simple permet d’ajouter tous les nouveaux fichiers d’un coup (sur la racine de votre copie de travail):
# svn add * --force
Puis on commit ces changements pour les intégrer au repository.
# svn commit
Enfin, certains répertoires de Symfony n’ont pas vocation à être inclus dans les updates. C’est le cas pour les fichiers de cache et de logs. Nous corrigeons ce problème comme suit (dans le répertoire trunk de votre copie de travail):
# cd /home/domaines/sfProject/trunk # svn propedit svn:ignore ./cache
Un éditeur de texte s’ouvre, tapez simplement une étoile * puis sauvegardez. Puis refaite la meme chose avec la commande
# svn propedt svn:ignore ./log
Envoyez les changements au repository:
# svn commit
Et voilà, vous avez un environnement de travail puissant et propre, vous pouvez commencer à développer sur le framework puissant qu’est Symfony. D’autres articles sur ce framework vous seront bientôt proposés ici-même.