Laravel è uno dei framework PHP più utilizzati nello sviluppo di applicazioni web. Nel corso degli anni ha costruito un ecosistema molto ricco, fatto di strumenti, librerie e convenzioni che permettono di sviluppare applicazioni anche piuttosto complesse senza dover reinventare continuamente la ruota.
Uno dei suoi punti di forza è l'approccio architetturale basato sul pattern MVC, che abbiamo appena visto, ma Laravel offre molto altro: un ORM per interagire con i database, un sistema di routing, un motore di template, strumenti per la gestione dell'autenticazione, code di elaborazione, notifiche e un sistema di test integrato.
In questo capitolo vedremo come installare Laravel su un ambiente Linux, partendo dalla verifica dei requisiti fino all'avvio della nostra prima applicazione. Utilizzeremo Composer per creare il progetto e il server di sviluppo integrato per verificare che tutto funzioni correttamente.
La guida prende come riferimento Laravel 13, la versione disponibile al momento della stesura. È importante prestare attenzione alla versione del framework e ai requisiti di PHP: installare una versione non compatibile del linguaggio è uno dei modi più semplici per iniziare un progetto con il piede sbagliato.
Verifica dei requisiti di sistema
Prima di installare Laravel dobbiamo assicurarci che il nostro ambiente di sviluppo disponga degli strumenti necessari. Il framework si basa su PHP e Composer, mentre altri strumenti diventano necessari in funzione delle caratteristiche dell'applicazione che vogliamo realizzare.
Il primo requisito è PHP 8.3 o superiore. Laravel 13 supporta le versioni PHP dalla 8.3 alla 8.5, quindi dobbiamo verificare che la versione installata sulla nostra distribuzione Linux rientri in questo intervallo.
Oltre al linguaggio, PHP deve avere abilitate alcune estensioni utilizzate dal framework:
- Ctype
- cURL
- DOM
- Fileinfo
- Filter
- Hash
- Mbstring
- OpenSSL
- PCRE
- PDO
- Session
- Tokenizer
- XML
Possiamo verificare la versione di PHP direttamente dal terminale:
php -vPer controllare le estensioni installate possiamo utilizzare:
php -mIl secondo requisito fondamentale è Composer, il gestore delle dipendenze di PHP. Laravel utilizza Composer per scaricare il framework e tutte le librerie necessarie al funzionamento dell'applicazione.
Possiamo verificarne la presenza con:
composer --versionInfine, se intendiamo utilizzare gli strumenti frontend di Laravel, come Vite, avremo bisogno di Node.js e NPM, oppure di un ambiente alternativo come Bun. Questi strumenti servono a installare e compilare le dipendenze JavaScript e CSS del progetto.
Node.js non è un requisito indispensabile per eseguire il backend Laravel, ma diventa necessario quando vogliamo utilizzare il normale flusso di compilazione degli asset frontend.
Database supportati
Laravel mette a disposizione Eloquent, il suo ORM integrato, attraverso il quale possiamo interagire con diversi sistemi di gestione dei database.
Laravel 13 supporta direttamente cinque database relazionali:
- MariaDB 10.3 o superiore
- MySQL 5.7 o superiore
- PostgreSQL 10.0 o superiore
- SQLite 3.26.0 o superiore
- SQL Server 2017 o superiore
È inoltre disponibile il supporto a MongoDB attraverso il pacchetto ufficiale mongodb/laravel-mongodb.
Per questa guida utilizzeremo MySQL, ma la procedura di installazione del framework non dipende dal database scelto. Possiamo creare il progetto anche senza avere già configurato un database, per poi completare la connessione successivamente.
Se decidiamo di utilizzare MySQL, è buona pratica creare un database dedicato all'applicazione e un utente specifico con i permessi necessari. Eviterei di utilizzare l'utente amministratore del database per la connessione dell'applicazione: separare gli account permette di limitare i privilegi e ridurre i rischi in caso di problemi di sicurezza.
Creazione del progetto Laravel
Una volta verificati i requisiti, possiamo finalmente creare la nostra applicazione.
Spostiamoci nella directory che vogliamo utilizzare per i progetti e lanciamo Composer:
composer create-project laravel/laravel my-appIl comando scarica l'ultima versione stabile compatibile con i requisiti dell'ambiente, installa le dipendenze e crea una nuova directory chiamata my-app contenente la struttura iniziale del progetto.
Possiamo naturalmente sostituire my-app con il nome che vogliamo assegnare alla nostra applicazione.
Al termine dell'operazione troveremo la struttura standard di Laravel, con directory dedicate a controller, modelli, configurazioni, viste, rotte e altri componenti del framework.
Tra le directory più importanti troviamo app, che contiene il codice applicativo, config, che ospita i file di configurazione, database, dedicata alle migrazioni e ai dati di test, resources, che contiene le risorse frontend e le viste, e routes, dove definiamo le rotte dell'applicazione.
Troveremo inoltre la directory vendor, generata da Composer, che contiene il framework e tutte le sue dipendenze. Non dobbiamo modificarne manualmente i contenuti: la gestione dei pacchetti installati è responsabilità di Composer.
Non è necessario eseguire nuovamente composer install dopo composer create-project, perché il comando ha già provveduto a installare le dipendenze richieste.
Configurazione dei permessi
Uno degli aspetti da non trascurare quando installiamo Laravel su Linux riguarda i permessi di accesso ai file.
Laravel deve poter scrivere in alcune directory durante il funzionamento. In particolare, le cartelle storage e bootstrap/cache vengono utilizzate per salvare log, cache, sessioni, file temporanei e altri dati generati dall'applicazione.
Il processo PHP eseguito dal web server deve quindi avere i permessi necessari per scrivere in queste directory.
La configurazione dipende dall'ambiente utilizzato. Su Ubuntu e Debian, ad esempio, Apache e PHP-FPM utilizzano frequentemente l'utente www-data, mentre su altre distribuzioni possiamo trovare utenti differenti.
Possiamo verificare quale utente esegue il processo PHP o il servizio web prima di modificare i permessi. Non è una buona idea applicare indiscriminatamente chmod 777 all'intero progetto o assegnare la proprietà di tutti i file all'utente del web server.
Una configurazione possibile, quando lavoriamo con un utente di sviluppo appartenente al gruppo www-data, è utilizzare:
sudo chown -R $USER:www-data my-app
sudo chmod -R 775 my-app/storage my-app/bootstrap/cacheQuesti comandi assegnano la proprietà dei file all'utente corrente e al gruppo del web server, concedendo al gruppo i permessi di scrittura sulle directory indicate.
In ambienti condivisi o di produzione è preferibile valutare una configurazione più precisa, ad esempio attraverso ACL, evitando di concedere permessi di scrittura non necessari.
Il principio da ricordare è semplice: il web server deve poter scrivere nelle directory previste da Laravel, ma non deve necessariamente avere accesso in scrittura a tutto il codice sorgente dell'applicazione.
Configurazione dell'ambiente
Laravel utilizza un file chiamato .env per gestire le configurazioni specifiche dell'ambiente in cui viene eseguita l'applicazione.
All'interno di questo file possiamo definire, ad esempio, il nome dell'applicazione, l'ambiente di esecuzione, la modalità di debug, la connessione al database e altre informazioni necessarie al funzionamento del progetto.
Il file .env viene normalmente creato durante la generazione del progetto. Se per qualche motivo non fosse presente, possiamo partire dal modello fornito dal framework:
cp .env.example .envApriamo il file e configuriamo i parametri relativi al database. Nel nostro esempio utilizzeremo MySQL:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=your_db_username
DB_PASSWORD=your_db_passwordNaturalmente, dobbiamo sostituire i valori di esempio con quelli effettivamente configurati sul nostro sistema.
Una caratteristica importante di questo approccio è la separazione tra codice e configurazione. Possiamo utilizzare lo stesso progetto su più ambienti, modificando solamente i parametri necessari senza dover intervenire sul codice sorgente.
Il file .env contiene spesso credenziali e informazioni sensibili, quindi non deve essere pubblicato su repository Git. Laravel lo esclude normalmente attraverso il proprio file .gitignore.
Generazione della chiave applicativa
Laravel utilizza una chiave crittografica per proteggere diversi dati gestiti dall'applicazione, tra cui i cookie cifrati.
Questa chiave viene memorizzata nella variabile APP_KEY del file .env e deve essere generata per ogni nuova installazione.
Dalla directory principale del progetto eseguiamo:
php artisan key:generateArtisan è l'interfaccia a riga di comando integrata in Laravel. Attraverso di essa possiamo eseguire numerose operazioni di gestione e manutenzione del framework.
Il comando genera una chiave casuale e la inserisce automaticamente nel file .env.
È importante non utilizzare la stessa chiave tra ambienti differenti e soprattutto non rigenerarla indiscriminatamente su un'applicazione già in produzione: modificarla può rendere illeggibili dati precedentemente cifrati e invalidare le sessioni degli utenti.
Avvio dell'applicazione
A questo punto abbiamo installato Laravel e configurato le impostazioni fondamentali. Possiamo verificare che il framework sia correttamente installato avviando il server di sviluppo integrato.
Dalla directory principale del progetto eseguiamo:
php artisan serveLaravel avvierà un server HTTP locale, normalmente disponibile all'indirizzo http://127.0.0.1:8000.
Apriamo l'indirizzo nel browser e dovremmo visualizzare la schermata iniziale di Laravel.
Il server integrato è estremamente comodo durante lo sviluppo e ci permette di iniziare a lavorare senza configurare immediatamente Apache o Nginx. Non deve però essere considerato un server adatto alla produzione: quando pubblicheremo l'applicazione dovremo utilizzare un web server o un application server configurato correttamente.
Se abbiamo installato anche le dipendenze frontend, possiamo utilizzare lo script di sviluppo fornito dal progetto:
npm install
npm run build
composer run devQuesto flusso permette di avviare i servizi previsti dalla configurazione di sviluppo del progetto, compreso il server Laravel e gli strumenti necessari per il frontend.
Una prima verifica con Artisan
Prima di iniziare a sviluppare, possiamo utilizzare Artisan per ottenere alcune informazioni sull'applicazione:
php artisan aboutIl comando mostra una panoramica della configurazione corrente, dell'ambiente, delle versioni e di altri dettagli utili per verificare che il progetto sia stato inizializzato correttamente.
Se abbiamo configurato un database, possiamo anche eseguire le migrazioni iniziali:
php artisan migrateLe migrazioni permettono di creare e aggiornare la struttura del database attraverso file PHP versionabili insieme al resto dell'applicazione.
A questo punto l'installazione è completata. Abbiamo un ambiente Laravel funzionante, pronto per iniziare a lavorare su controller, modelli, viste e tutte le altre funzionalità messe a disposizione dal framework.