Preparazione del progetto

In symfony, le applicazioni che condividono lo stesso modello dei dati sono raggruppate in progetti. Per la maggior parte dei progetti si avranno due diverse applicazioni: un frontend ed un backend.

Creazione del progetto

Dalla directory sfproject/, eseguire il task di symfony generate:project per creare effettivamente il progetto symfony:

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

Su Windows:

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

Il task generate:project genera la struttura predefinita di directory e di file necessaria ad un progetto symfony:

Il task generate:project crea anche un collegamento symfony nella directory radice del progetto, per accorciare il numero di caratteri da scrivere quando si esegue un task.

Quindi, d'ora in poi, invece di usare il percorso completo a symfony, si può usare il collegamento symfony.

Creazione di un'applicazione

Creare l'applicazione frontend, eseguendo il task generate:app:

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

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

Basandosi sul nome dell'applicazione fornito come parametro, il task generate:app crea la struttura di directory predefinita necessaria per l'applicazione, nella directory apps/frontend/:

Permessi sulla struttura delle directory

Prima di provare ad accedere al nuovo progetto, occorre impostare i permessi di scrittura sulle directory cache/ e log/ ai livelli appropriati, in modo tale che il server web possa scriverci dentro:

$ chmod 777 cache/ log/

Il path di symfony

Per sapere la versione di symfony utilizzata da un progetto basta digitare:

$ php symfony -V

L'opzione -V mostra il path della directory di installazione di symfony che è memorizzato in config/ProjectConfiguration.class.php:

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

Per una maggiore portabilità cambiare il path assoluto dell'installazione di symfony con un path relativo:

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

In questo modo è possibile spostare la directory del progetto in qualsiasi punto della vostra macchina o su un'altra facendo in modo che il progetto continui a funzionare.

Configurare il database

Una delle prime cose da fare è quella di configurare la connessione al database del progetto. Il framework symfony supporta tutti i database supportati da PDO (MySQL, PostgreSQL, SQLite, Oracle, MSSQL, ...). Appoggiandosi a PDO, symfony è distribuito con due strumenti ORM: Propel e Doctrine. Propel è quello predefinito, ma passare a Doctrine è molto facile (si veda la prossima sezione per maggiori informazioni).

La configurazione del database è semplificata dall'uso del task configure:database:

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

Il task configure:database accetta tre parametri: il DSN di PDO, il nome utente e la password per accedere al database. Se non si ha bisogno di una password per accedere al database sul server di sviluppo, basta omettere il terzo parametro.

Passare a Doctrine

Se si sceglie di usare Doctrine al posto di Propel, occorre innanzitutto abilitare sfDoctrinePlugin e disabilitare sfPropelPlugin. L'operazione può essere eseguita modificando il seguente codice in config/ProjectConfiguration.class.php:

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

Dopo tali modifiche, lanciare i seguenti comandi:

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

Quindi, eseguire i seguenti comandi per configurare un database per Doctrine:

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