En premier lieu, il faut vous identifier en tant qu'utilisateur root. Cela peut se faire avec la commande :

su -

Installation des paquets nécessaires

Nous installons les dépendances de Symfony :

/usr/bin/apt-get install php-pear php5-mysql php5-cli php5-xsl php5-xmlrpc

Pour installer et utiliser Symfony, il faut augmenter la limite d'utilisation mémoire de PHP, ainsi qu'activer les "magic quotes". Pour ce faire, exécutez la commande :

echo ";PHP settings for Symfony
memory_limit = 128M
magic_quotes_gpc = Off" > /etc/php5/conf.d/symfony.ini

Vous devez maintenant choisir votre serveur HTTP. Personnellement, j'utilise de plus en plus souvent LigHTTPd car il est très léger et suffisamment puissant pour la plupart des utilisation. Pour l'installer, suivez :

guide d'installation de LigHTTPd et PHP 5 sur Debian 4.0 Etch.

test -x /usr/sbin/a2enmod && /usr/sbin/a2enmod rewrite

N'oubliez pas de redémarrer votre serveur Web pour prendre en compte les nouvelles configurations :

test -x /etc/init.d/apache2 && /etc/init.d/apache2 force-reload
test -x /etc/init.d/lighttpd && /etc/init.d/lighttpd force-reload

Installation de Symfony

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

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

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

pear channel-discover pear.symfony-project.com

Puis on installe le framework lui-même :

pear install symfony/symfony

Ensuite, on installe phing au besoin (je ne sais pas si c'est toujours nécessaire) :

pear channel-discover pear.phing.info
pear install --alldeps phing/phing

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

pear install PhpDocumentor XML_Beautifier

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

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 :

mkdir /home/sfprojects
chgrp users /home/sfprojects
chmod ugo+w /home/sfprojects

Création d'un projet Symfony

Nous allons maintenant créer notre projet Symfony. Vous pouvez le faire en utilisant votre utilisateur habituel. 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

Nous pouvons maintenant passer à la configuration du serveur HTTP.

LigHTTPd

Créez le fichier de configuration de LigHTTPd pour ce projet :

/usr/bin/wget --quiet http://howto.landure.fr/gnu-linux/debian-4-0-etch/symfony-sur-debian-4-0-etch/lighttpd-symfony-configuration-template -O- \
    | /bin/sed -e "s/SYMFONY_PROJECT/$SYMFONY_PROJECT/g" \
    > /etc/lighttpd/conf-available/11-$SYMFONY_PROJECT-vhost.conf

Activez la nouvelle configuration de LigHTTPd :

/usr/sbin/lighty-enable-mod $SYMFONY_PROJECT-vhost

Et enfin, rechargez la configuration de LigHTTPd :

/etc/init.d/lighttpd force-reload

Apache 2

Nous configurons le serveur Apache 2 :

su -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"

Et ensuite, activez le :

su -c "a2ensite $SYMFONY_PROJECT"

Vérifiez votre nouvelle configuration d'Apache :

su -c "apache2ctl -t"

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

su -c "/etc/init.d/apache2 reload"

Accéder au site (à suivre quelque soit le serveur HTTP choisi)

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

su -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 en tant que super administrateur :

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

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

pear update-channels
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

Résolution des problèmes

Impossible de mettre à jour Symfony

Si la commande pear upgrade symfony/symfony vous affiche l'erreur suivante:

ERROR: pear.symfony-project.com/symfony not installed

Et si pear install symfony/symfony ne fonctionne pas non plus, cela peut être du au fait que le registre de PEAR est corrompu. Pour régler ce problème, réinitialisez le registre de PEAR à l'aide de la commande:

rm /usr/share/php/.registry/.channel.pear.symfony-project.com/symfony.reg

Il ne vous reste plus qu'a relancer la procédure de mise à jour:

pear channel-update pear.symfony-project.com
pear upgrade symfony/symfony

Source: Merci à Sunhwan pour son article When Symfony upgrade fails using PEAR. (et merci à Sébastien Delarche pour m'avoir donné la solution à ce problème lorsqu'il l'a rencontré et que je n'ai pas su l'aider).

Remerciements

• Merci à Niko pour son article Installer le framework PHP Symfony sur Ubuntu Dapper Drake.
• Merci à Glooze pour son article Symfony sur lighttpd.