Come installare Symfony

Terminate le premesse introduttive, entriamo finalmente nel vivo della nostra guida!

Requisiti di sistema per installare Symfony

Prima di procedere con la creazione di un progetto Symfony è necessario verificare i requisiti di base.

Avendo installato XAMPP, abbiamo a già a disposizione la versione di PHP corretta, ovvero maggiore o uguale alla 8.1. Per verificare, avviare Apache dal pannello di controllo di XAMPP e visitare la pagina http://localhost/dashboard/phpinfo.php.

Oltre alla versione, è necessario verificare che siano abilitate le seguenti estensioni PHP:

• Ctype
• iconv
• PCRE
• Session
• SimpleXML
• Tokenizer

Le estensioni sopra elencate dovrebbero già essere abilitate di default sul sistema. Per verificarlo, è sufficiente ricercare per nome estensione nella schermata phpinfo precedente. Ad esempio, ricercando l’estensione PCRE dovrebbe presentarsi una schermata come la seguente (notare l’evidenziazione in verde):

In generale, per abilitare le estensioni che non lo sono già di default o che non fanno parte del core di PHP, accedere in modifica al file php.ini tramite pannello di controllo di XAMPP:

Ricercare l’estensione tramite la chiave di ricerca extension={nome estensione}. Ad esempio, per verificare che sia abilitata l’estensione intl ricercare extension=intl:

Dalla schermata precedente, si nota che tale estensione non è abilitata in quanto commentata tramite il carattere ; (punto e virgola). Per abilitarla è sufficiente rimuovere il carattere ; da inizio riga, salvare e riavviare il servizio Apache dal pannello di controllo di XAMPP.

Altro requisito fondamentale per procedere con la creazione di un nuovo progetto Symfony è il gestore di dipendenze Composer, già approfondito nel capitolo relativo alla configurazione dell’ambiente di sviluppo.

Come creare un progetto Symfony con XAMPP

Per creare un nuovo progetto Symfony, aprire il terminale, posizionarsi nella directory che si preferisce e lanciare il seguente comando

composer create-project symfony/skeleton:"6.3.*" symfony-test

sostituendo symfony-test con il nome del proprio progetto. Il comando si occuperà di creare un nuova cartella chiamata “symfony-test”, scaricare le dipendenze base di Symfony e generare le cartelle di default necessarie per iniziare a sviluppare il progetto web.

Una volta creata la struttura base del progetto, possiamo configurare un virtual host per navigare le pagine web del sito. Aprire in modifica il file httpd-vhosts.conf localizzato solitamente in C:\xampp\apache\conf\extra\ su Windows, /Applications/XAMPP/xamppfiles/etc/extra/ su macOS e /etc/httpd/conf/extra/ su Linux. Quindi, aggiungere la seguente configurazione alla fine del file:

<VirtualHost *:80>
    DocumentRoot "C:\percorso\progetto\symfony\public"
    ServerName symfony-test.local

    <Directory "C:\percorso\progetto\symfony\public">
	  AllowOverride None
        Require all granted
        FallbackResource /index.php
    </Directory>
</VirtualHost>

sostituendo correttamente il percorso con quello relativo alla cartella del progetto sul proprio sistema. Da notare come, ad essere esposta sul web server sia solo la cartella public. Il dominio assegnato per questo virtual host è symfony-test.local.

Il passo successivo è quello di registrare il dominio scelto all’interno del file hosts:

127.0.0.1       symfony-test.local

in questo modo, si associa l’indirizzo locale (127.0.0.1) al dominio symfony-test.local.

A questo punto, non resta che riavviare il servizio Apache tramite il pannello di controllo XAMPP e visitare con il browser l’indirizzo symfony-test.local:

Congratulazioni! Hai installato Symfony! Vediamo, a seguire, come si presenterà la cartella del progetto appena creato.