Installation des paquets nécessaires

La première étape consiste à installer un environnement GLUAP (GNU / Linux Ubuntu - Apache 2 - PHP). Pour ce faire, exécutez simplement la commande suivante :

sudo apt-get install libapache2-mod-php5 php-pear php5-mysql php5-cli php5-xsl

Pensez à activer le mod_rewrite de votre Apache 2 :

sudo a2enmod rewrite

Pour installer Symfony, il faut augmenter la limite d'utilisation mémoire de la ligne de commande PHP. Pour ce faire, exécutez la commande :

sudo sed -i -e 's/memory_limit = 8M/memory_limit = 16M/' /etc/php5/cli/php.ini

De même pour l'utiliser sans soucis, il faut augmenter la limite d'utilisation mémoire pour Apache 2 :

sudo sed -i -e 's/memory_limit = 8M/memory_limit = 128M/' /etc/php5/apache2/php.ini

Enfin, il vous faut désactiver les magic_quotes de PHP :

sudo sed -i -e 's/magic_quotes_gpc = On/magic_quotes_gpc = Off/' /etc/php5/apache2/php.ini

Installation de Symfony

Avant d'installer Symfony, il faut mettre à jour PEAR. Pour ce faire, exécutez la commande suivante :

sudo pear channel-update pear.php.net
sudo pear upgrade --alldeps PEAR

Vous pouvez maintenant passer à l'installation de Symfony. Pour ce faire, on commence par inscrire le canal de Symfony à la configuration de PEAR :

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

Puis on installe le framework lui-même :

sudo pear install symfony/symfony

Ensuite, on installe phing au besoin :

sudo pear install --alldeps http://phing.info/pear/phing-current.tgz

Remarque: Si vous souhaitez disposer de la création automatisée de la documentation, installez PhpDocumentor :

sudo pear install PhpDocumentor XML_Beautifier

Enfin, vérifiez que Symfony est bien installé :

sudo symfony -V

Si cette commande fonctionne, vous disposez d'une version fonctionnelle du framework Symfony. La dernière manipulation à effectuer consiste à créer un endroit où réaliser vos projets :

sudo mkdir /home/sfprojects
sudo chown $USER /home/sfprojects

Création d'un projet Symfony

Nous allons maintenant créer notre projet Symfony. En premier lieu, choisissez un nom pour votre projet :

SYMFONY_PROJECT=askeet

Et nous créons ensuite le projet :

mkdir /home/sfprojects/$SYMFONY_PROJECT
cd /home/sfprojects/$SYMFONY_PROJECT
symfony init-project $SYMFONY_PROJECT

Une fois le projet créé, nous pouvons y créer nos applications. Pour cela, choisissez le nom de votre application :

SYMFONY_APP=frontend

Et nous créons cette application :

cd /home/sfprojects/$SYMFONY_PROJECT
symfony init-app $SYMFONY_APP

Enfin, nous configurons le serveur Apache 2 :

sudo sh -c "echo '<VirtualHost *>
  ServerName $SYMFONY_PROJECT
  DocumentRoot \"/home/sfprojects/$SYMFONY_PROJECT/web\"

  Alias /sf /usr/share/php/data/symfony/web/sf

  <Directory \"/home/sfprojects/$SYMFONY_PROJECT/web\">
    AllowOverride All
  </Directory>
</VirtualHost>' \
      > /etc/apache2/sites-available/$SYMFONY_PROJECT"
sudo a2ensite $SYMFONY_PROJECT

Vérifiez votre nouvelle configuration d'Apache :

sudo apache2ctl -t

et si tout est correct, rechargez la configuration d'Apache :

sudo /etc/init.d/apache2 reload

Enfin, nous ajoutons une ligne à notre fichier hosts pour pouvoir accéder simplement à notre projet.

sudo sh -c "echo '127.0.0.1 $SYMFONY_PROJECT' >> /etc/hosts"

Vous pouvez maintenant commencer à travailler sur votre projet Symfony, utilisez la commande suivante pour y accéder avec votre navigateur :

firefox http://$SYMFONY_PROJECT

Par la suite

Maintenant que vous l'avez installé, je vous conseille de suivre ces 24 tutoriaux pour apprendre à utiliser Symfony.

Mise à jour de Symfony

Si par la suite, vous souhaitez mettre à jour Symfony, utilisez simplement les commandes suivantes :

sudo pear channel-update pear.php.net
sudo pear upgrade --alldeps PEAR
sudo pear channel-update pear.symfony-project.com
sudo pear upgrade symfony/symfony

Vous pouvez aussi choisir de mettre à jour toutes les applications PEAR:

sudo pear update-channels
sudo pear upgrade-all

Enfin, pour chaque projet Symfony présent sur votre machine, exécutez (si nécessaire) :

symfony upgrade version.de.symfony

Générer la documentation

Si vous avez installé PhpDocumentor, vous pouvez générer la documentation de votre projet avec la ligne de commande :

phpdoc -d /home/sfprojects/$SYMFONY_PROJECT -t /home/sfprojects/$SYMFONY_PROJECT/doc

Remerciements

• Merci à Niko pour son article Installer le framework PHP Symfony sur Ubuntu Dapper Drake. (Contrairement aux apparences, cet article n'est pas un copier / coller... j'ai découvert l'article de Niko après la rédaction de cette page :D)