Getting Started with symfony

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:

Per quale motivo symfony genera così tanti file? Uno dei maggiori benefici che derivano dall'uso di un framework full-stack è quello della standardizzazione dello sviluppo. Grazie alla struttura predefinita di file e directory di symfony, ogni sviluppatore che conosca symfony può occuparsi della manutenzione di qualsiasi progetto symfony. In pochi minuti avrà la possibilità di analizzare il codice, sistemare i bug e aggiungere nuove caratteristiche.

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

Essendo il collegamento a symfony un file eseguibile, gli utenti Unix possono d'ora in poi sostituire tutte le occorrenze di 'php symfony' con './symfony'

Su Windows si può copiare il file 'symfony.bat' all'interno del progetto ed usare 'symfony' invece di 'php symfony':

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/:

Richiamando il task generate:app task, abbiamo usato anche due opzioni relative alla sicurezza:

• --escaping-strategy: Abilita l'escape dell'output, per prevenire attacchi XSS
• --csrf-secret: Abilita i token di sessione nei form, per prevenire attacchi CSRF

Passando queste due opzioni facoltative al task, abbiamo messo in sicurezza lo sviluppo futuro da due delle più diffuse vulnerabilità del web. Già, symfony si prende cura della sicurezza per noi.

Se si ignora cosa siano XSS e CSRF, sarebbe meglio spendere un po' di tempo per sapere di più su queste vulnerabilità.

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/

Consigli per chi usa uno strumento di revisione del codice

symfony scrive solamente in due directory di un progetto symfony, cache/ e log/. Il contenuto di queste due directory dovrebbe essere ignorato dagli strumenti di revisione del codice (ad esempio utilizzando la proprietà svn:ignore, se si usa Subversion).

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