Installation du Projet

Dans symfony, les applications partageant le même modèle de données sont regroupés dans des projets. Pour la plupart des projets, vous avez deux applications différentes : un frontend et un backend.

Création du projet

Depuis le répertoire sfproject/, exécuter la tâche symfony generate:project pour créer le projet symfony:

$ php lib/vendor/symfony/data/bin/symfony generate:project PROJECT_NAME

Sur Windows:

c:\> php lib\vendor\symfony\data\bin\symfony generate:project PROJECT_NAME

La tâche generate:project génére la structure par défaut des répertoires et les fichiers nécessaires pour un projet symfony :

La tâche generate:project a également créé un raccourci symfony dans le répertoire racine du projet pour diminuer le nombre de caractères que vous allez écrire lors de l'exécution d'une tâche.

Ainsi, à partir de maintenant, au lieu d'utiliser le chemin complet pour le programme symfony, vous pouvez utiliser le raccourci symfony.

Création de l'application

Maintenant, créez l'application frontend en exécutant la tâche generate:app :

$ php symfony generate:app --escaping-strategy=on --csrf-secret=UniqueSecret frontend

c:\> copy lib\vendor\symfony\data\bin\symfony.bat .

Basé sur le nom de l'application donné en argument, la tâche generate:app crée par défaut la structure du répertoire nécessaire à l'application sous le répertoire apps/frontend/ :

Droits sur les répertoires structurés

Avant d'essayer d'accéder à votre projet nouvellement créé, vous devez configurer l'écriture sur les répertoires cache/ et log/ à des niveaux appropriés, afin que votre serveur web puisse écrire dedans :

$ chmod 777 cache/ log/

Le chemin de symfony

Vous pouvez obtenir la version symfony utilisée par votre projet en tapant :

$ php symfony -V

L'option -V affiche également le chemin vers le répertoire d'installation de symfony, qui est stocké dans config/ProjectConfiguration.class.php :

// config/ProjectConfiguration.class.php
require_once '/Users/fabien/symfony-1.2/lib/autoload/sfCoreAutoload.class.php';

Pour une meilleure portabilité, changez le chemin absolu de l'installation de symfony par un relatif :

// config/ProjectConfiguration.class.php
require_once dirname(__FILE__).'/../lib/vendor/symfony/lib/autoload/sfCoreAutoload.class.php';

De cette façon, vous pouvez déplacer le répertoire du projet n'importe où, sur votre machine ou une autre, et il marchera bien.

Configuration de la base de données

Une des premières choses que vous pouvez faire est de configurer la connexion à la base de donnée pour votre projet. Le framework Symfony supporte toutes les PDO-soutenus par des bases de données (MySQL, PostgreSQL, SQLite, Oracle, MSSQL, ...). Au sommet de PDO, symfony est livré avec deux outils ORM: Propel et Doctrine. Propel est celui par défaut, mais le passage à Doctrine est assez facile (voir la section suivante pour plus d'informations).

La configuration de la base de données est trés simple en utilisant la tâche configure:database :

$ php symfony configure:database "mysql:host=localhost;dbname=dbname" root mYsEcret

La tâche configure:database comporte 3 arguments: le PDO DSN, le nom de l'utilisateur, et le mot de passe pour accéder à la base de données. Si vous n'avez pas besoin d'un mot de passe pour accéder à votre base de donnée sur le serveur de développement, omettez simplement le troisième argument.

Changer pour Doctrine

Si vous souhaitez utiliser Doctrine au lieu de Propel, vous devez d'abord activer sfDoctrinePlugin et désactiver sfPropelPlugin. Cela peut être fait en changeant le code suivant dans votre config/ProjectConfiguration.class.php:

public function setup()
{
  $this->enableAllPluginsExcept(array('sfPropelPlugin', 'sfCompat10Plugin'));
}

Après avoir effectué ces modifications, lancez ces commandes :

$ php symfony plugin:publish-assets
$ php symfony cc
$ rm web/sfPropelPlugin
$ rm config/propel.ini
$ rm config/schema.yml
$ rm config/databases.yml

Ensuite, exécutez la commande suivante pour configurer votre base de données pour Doctrine :

$ php symfony configure:database --name=doctrine --class=sfDoctrineDatabase "mysql:host=localhost;dbname=jobeet" root mYsEcret