Le nouveau framework est en développement, mais si comme moi vous voulez explorer les fonctionnalités de ce trésor, voici comment bien démarrer sous Windows.

Le pack d'installation fournit un fichier check.php permettant de vérifier la compatibilité de votre environnement PHP avec les pré-requis du nouveau framework.

La distribution WAMP correspond quasiment à la configuration suggérée pour Symfony 2.0 (dans la version dev du 10/03/2010 en tout cas).

Symfony 2.0 requière PHP 5.3.1 alors que WAMP propose par défaut la 5.3.0

Contrairement à ce qui avait été annoncé, c'est PHP 5.3.1 qui est recommandé au lieu de la 5.3.0 (voir changelog).

Pour installer PHP 5.3.1 sous WAMP, téléchargez simplement l'add-on éponyme.

Lorsque l'installation est terminée, il vous faut sélectionner cette version de PHP dans le menu contextuel de WAMP (icône en bas à droite) :
> PHP > Version > 5.3.1

Si vous utilisez Propel, il vous faut aussi activer l'extension XSL (optionnel) :
>PHP > PHP extensions > php_xsl

Même pour le développement il est intéressant d'améliorer les performances d'exécution de PHP. Pour cela on peut installer l'accélérateur APC.

Téléchargez la dll de APC : php_apc-5.3-svn20100226-vc9-x86.zip

Extraire le contenu de l'archive dans C:\wamp\bin\php\php5.3.1\ext

Modifiez le fichier php.ini : > PHP > php.ini

extension=php_xsl.dll
;extension=php_zip.dll
extension=php_apc.dll

Si vous souhaitez déposer votre code en dehors du répertoire www de WAMP, il vous faut créer un Alias :
> Apache > Alias directories > Add an alias

Dans l'invite de commande, saisissez le nom de votre alias (par exmple : symfony2) puis l'emplacement du répertoire web de votre installation. Pensez à utiliser des slash (/) comme séparateur et à mettre un slash à la fin (par exemple : C:/Programmation/Symfony2/web/).

Il est aussi conseillé d'activer le module rewrite de Apache :
> Apache > Apache modules > rewrire_module

Accédez maintenant à la page http://localhost/symfony2/. Une page indiquant que Symfony est correctement installé doit s'afficher. Si vous avez une erreur du type "fichier *index.php non trouvé", modifiez le fichier .htaccess :

 <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /symfony2
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php [QSA,L]
 </IfModule>

1. Depuis la console (communément appelé CLI)
2. Depuis une adresse locale (localhost)
3. Depuis une requête AJAX (ou XMLHttpRequest JavaScript)
4. En mode debug
5. Contexte d'exécution

La fonction php_sapi_name retourne le type d'interface utilisée, par exemple "cli" ou "cgi". En analysant la valeur retournée par cette fonction vous pouvez donc facilement détecter une exécution dans la console PHP. Dans Symfony, ce sont les tâches qui sont généralement exécutées par cette interface.

if(php_sapi_name() == 'cli')
{
  // Code exécuté uniquement lorsque le script est appelé en ligne de commande (cli).
}

Symfony fait déjà cette détection par défaut dans le fichier app_dev.php pour empêcher l'exécution de l'application en mode debug depuis d'extérieur. Les adresses 127.0.0.1 et ::1 sont les adresses IP v4 et v6 normalisées de rebouclage sur la machine locale, la condition ci-dessous vérifie que la requête est transmise depuis l'une de ces deux adresses.

if (in_array($this->getRequest()->getRemoteAddress(), array('127.0.0.1', '::1')))
{
  // Code exécuté uniquement lorsque l'application est exécutée depuis une adresse locale.
}

Parmi les fonctionnalités magiques de Symfony, vous pouvez appelé la fonction sfWebRequest::isXmlHttpRequest() depuis vos sfAction(s). Vous saurez alors si la page a été appelée depuis JavaScript.

if($this->getRequest()->isXmlHttpRequest())
{
  // Code exécuté uniquement lorsque l'action est appelée depuis JavaScript
}

Lorsque votre application est exécutée en mode debug, la constante sf_debug prend la valeur true. Il vous est donc facile de n'afficher certaines informations que pour le développement et le débogage de votre application.

if(sfConfig::get('sf_debug'))
{
  // Code exécuté uniquement lorsque l'application est exécutée en mode debug
}

(Ajouté le 04/02/2010)

Pour éviter l'erreur « The "default" context does not exist. » lorsqu'on utilise i18n ou doctrine dans les models/widgets par exemple.

if(sfContext::hasInstance())
{
  $contexte = sfContext::getInstance();
  // Code exécuté uniquement lorsque l'application est exécutée avec un contexte (depuis une application).
}