Opzione 1) Composer¶

Composer è una libreria di gestione delle dipendenze per PHP, utilizzabile per scaricare Symfony2 Standard Edition.

Iniziare con lo scaricare Composer sul proprio computer. Se si ha curl installato, è facile:

1

$ curl -s https://getcomposer.org/installer | php

Composer è un file PHAR eseguibile, che si può usare oer scarucare la Standard Distribution:

1

$ php composer.phar create-project symfony/framework-standard-edition /percorso/web/Symfony

Questo comando può richiedere diversti minuti, mentre Composer scarica la Standard Distribution e tutte le librerie dei venditori necessarie. Quando avrà finito, si dovrebbe avere una cartella simile a questa:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

percorso/web/ <- la propria cartella radice del web
    Symfony/ <- l'archivio scompattato
        app/
            cache/
            config/
            logs/
        src/
            ...
        vendor/
            ...
        web/
            app.php
            ...

Opzione 2) Scaricare un archivio¶

Si può anche scaricare un archivio della Standard Edition. Qui, si possono fare due scelte:

• Scaricare un archivio .tgz o .zip, sono equivalenti, scegliere quello che si preferisce;
• Scaricare la distribuzione con o senza venditori. Se si pensa di usare molte librerie o bundle di terze parti e gestirli tramite Composer, probabilmente sarà meglio scaricare quella senza venditori.

Scaricare uno degli archivi e lo si scompatti da qualche parte sotto la cartella radice del web del proprio server. Da una linea di comando UNIX, si può farlo con uno dei seguenti comandi (sostituire ### con il vero nome del file):

1
2
3
4
5

# per il file .tgz
$ tar zxvf Symfony_Standard_Vendors_2.1.###.tgz

# per il file .zip
$ unzip Symfony_Standard_Vendors_2.1.###.zip

Se si è optato per la versione senza venditori, occorerà leggere la prossima sezione.

Aggiornare i venditori¶

A questo punto, si dispone di un progetto Symfony funzionale, nel quale si può iniziare a sviluppare la propria applicazione. Un progetto Symfony dipende da diverse librerie esterne. Queste vanno scaricate nella cartella vendor/ del progetto, tramite una libreria chiamata Composer.

A seconda di come Symfony è stato scaricato, si potrebbe aver bisogno o no di aggiornare i venditori. Aggiornare i venditori è sempre sicuro e garantisce di disporre di tutte le librerie necessarie.

Passo 1: Ottenere Composer (il nuovo bellissimo sistema di pacchetti PHP)

1

$ curl -s http://getcomposer.org/installer | php

Ci si assicuri di scaricare composer.phar nella stessa cartella in cui risiede il file composer.json (per impostazione predefinita, la radice del progetto Symfony).

Passo 2: Installare i venditori

1

$ php composer.phar install

Questo comando scarica tutte le librerie dei venditori necessarie, incluso Symfony stesso, nella cartella vendor/.

1
2

$ php installer
$ php composer.phar install

"extra": {
    "symfony-app-dir": "app",
    "symfony-web-dir": "web",
    "symfony-assets-install": "symlink"
}

Configurazione¶

A questo punto, tutte le librerie di terze parti che ci occorrono sono nella cartella vendor/. Abbiamo anche una configurazione predefinita dell'applicazione in app/ e un po' di codice di esempio in src/.

Symfony2 dispone di uno strumento visuale per la verifica della configurazione del server, per assicurarsi che il server web e PHP siano configurati per usare Symfony2. Usare il seguente URL per la verifica della configurazione:

1

http://localhost/config.php

Se ci sono problemi, correggerli prima di proseguire.

1

$ ps aux | grep httpd

1

$ ps aux | grep apache

1
2
3
4
5

$ rm -rf app/cache/*
$ rm -rf app/logs/*

$ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs
$ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs

1
2

$ sudo setfacl -R -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
$ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs

1
2
3
4
5

umask(0002); // Imposta i permessi a 0775

// oppure

umask(0000); // Imposta i permessi a 0777

Quando tutto è a posto, cliccare su "Go to the Welcome page" per accedere alla prima "vera" pagina di Symfony2:

1

http://localhost/app_dev.php/

Symfony2 dovrebbe dare il suo benvenuto e congratularsi per il lavoro svolto finora!

Ignorare la cartella vendor/¶

Chi ha scelto di scaricare l'archivio senza venditori può tranquillamente ignorare l'intera cartella vendor/ e non inviarla in commit al controllo di sorgenti. Con Git, lo si può fare aggiungendo al file .gitignore la seguente riga:

1

/vendor/

Ora la cartella dei venditori non sarà inviata in commit al controllo di sorgenti. Questo è bene (anzi, benissimo!) perché quando qualcun altro clonerà o farà checkout del progetto, potrà semplicemente eseguire lo script php composer.phar install per scaricare tutte le librerie dei venditori necessarie.