Charles Guillemot

Quand on veut utiliser symfony, la première chose à faire est de l’installer. Cet article n’a pas pour but de vous présenter quelque chose de nouveau ni de transcendant car beaucoup de sites indiquent déjà très clairement la marche à suivre pour installer le framework. Cet article est plus comme un pense bête pour ma petite personne et me servira de référence lorsque je devrais refaire cette manipulation dans l’avenir. C’est des choses toutes simples, mais qui peuvent vite demander du temps si on fait mal une étape, ou plus radicalement, si on l’omet.

Prérequis

Pour les prérequis, je reprend les étapes décrites dans la doc de symfony que j’adapte à mon environnement windows.

Logiciels tiers

Donc ici, il nous faut un serveur web (apache…), un moteur de base de données (mysql…) et PHP 5.2.4 ou ultérieur. En claire, j’installe easyPHP.

Interface de ligne de commande

Symfony réalise beaucoup de travail à notre place (c’est pas se pourquoi on l’utilise? ^^) grâce à son outil de ligne de commandes. Étant utilisateur de windows, pas de problèmes, nous utiliserons la fenêtre de commandes MS-DOS.

Configuration de PHP

Il faut que PHP 5.2.4 ou ultérieur soit installé sur votre machine. Tapez le code suivant dans la fenêtre de commande pour connaitre la version de PHP présent sur votre machine.

php -v

Installation

Répertoire du projet

Pour commencer notre projet, il faut bien évidement lui créer un répertoire. Dans notre cas ici présent, nous allons débuter notre aventure symfony par la création d’un blog simple, regroupant l’ensemble des fonctionnalités de bases offertes par les plateformes de blogging. Nous créons donc un répertoire nommé Symfoblog à l’endroit de notre choix. A cette étape, pour les utilisateurs de easyPHP comme moi, nous ne sommes pas obligé de créer notre répertoire sous le répertoire www. Nous verrons par la suite comment établir le lien afin d’avoir accès à notre projet via notre navigateur favori.

Choix de l’emplacement d’installation

Pour savoir où installer symfony, rien de bien original, nous allons suivre une des bonnes pratiques adoptée par un grand nombre de développeurs. Nous allons installer symfony localement et pour se faire, nous créons un répertoire lib/vendor dans notre répertoire Symfoblog.

Choix de la version

Pour ma part, j’utilise subversion pour installer symfony, mais libre à vous, si vous le désirez, de télécharger une archive et de la décompresser dans le répertoire créé précédemment. Ici, après nous être placé dans le répertoire vendor, nous allons donc taper cette commande qui va nous permettre de travailler avec la dernière version de symfony :

svn checkout http://svn.symfony-project.com/branches/1.4/

Vérification de l’installation

Maintenant qu’on a tout installé, on va vérifier que tout a bien marché. Tapons ceci dans la fenêtre de commandes :

php lib\vendor\symfony\data\bin\symfony -V

Installation du projet

Nous regroupons dans symfony au sein d’un projet toutes les applications qui partagent le même modèle de données. Souvent, chaque projet ne possède que deux application, à savoir le frontend qui la partie visible par l’utilisateur, et le backend qui est la partie administrateur.

Création du projet

Depuis notre répertoire Symfoblog, nous allons taper la commande suivante pour créer notre projet :

php lib\vendor\symfony\data\bin\symfony generate:project Symfoblog

Cette commande va permettre de générer la structure par défaut des répertoires et fichiers nécessaire à un projet symfony.

Création de l’application

Maintenant, créons l’application frontend :

php symfony generate:app frontend

Cette commande va permettre de créer la structure par défaut du répertoire de l’application au sein du répertoire apps/frontend.

En copiant le fichier symfony.bat qui se trouve dans le répertoire bin de symfony dans le répertoire de notre projet, nous pourrons dans l’avenir utiliser « symfony » à la place de « php symfony« . Donc :

copy lib\vendor\symfony\data\bin\symfony.bat

Configuration du serveur web

C’est ici qu’on va rendre notre projet accessible à notre navigateur. Pour se faire, on va modifier notre fichier httpd.conf que l’on peut facilement trouver dans le répertoire conf_file directement sous le répertoire d’installation d’easyPHP.

<VirtualHost 127.0.0.1:80>
     ServerName www.symfoblog.fr
     DocumentRoot "I:\sites_internet\SymfoBlog\web"
     DirectoryIndex index.php

     <Directory "I:\sites_internet\SymfoBlog\web">
          AllowOverride All
          Allow from All
     </Directory>

     Alias /sf I:\sites_internet\SymfoBlog\lib\vendor\symfony\data\web\sf

     <Directory "I:\sites_internet\SymfoBlog\lib\vendor\symfony\data\web\sf">
          AllowOverride All
          Allow from All
     </Directory>
</VirtualHost>

Pour compléter cette manipulation, n’oubliez pas d’activer le mode rewriting en dé-commentant la ligne suivante toujours dans le fichier httpd.conf :

LoadModule rewrite_module modules/mod_rewrite.so

Pour finaliser notre configuration, ajoutez au fichier C:\Windows\System32\drivers\etc\host la ligne suivante :

127.0.0.1       www.symfoblog.fr

Maintenant, tapez http://www.symfoblog.fr dans votre navigateur et vous devriez voir la page suivante s’afficher!

Installation réussi d'un projet

Si c’est bien le cas, oh miracle, tout est en place. La prochaine fois, nous approfondirons notre projet Symfblog pour lister l’ensemble des fonctionnalités que nous devrons coder.