Lezione 2 — Installare Laravel con Composer: Guida Completa per Principianti

Scopri come configurare il tuo ambiente di sviluppo e installare Laravel utilizzando Composer, il gestore di dipendenze standard per PHP.

Introduzione all'ecosistema Laravel

Benvenuti alla seconda lezione del nostro corso "Impara Laravel in 50 lezioni". Dopo aver compreso cos'è Laravel e perché è diventato il framework PHP più popolare al mondo, è arrivato il momento di sporcarsi le mani. Prima di scrivere la nostra prima riga di codice, dobbiamo preparare l'ambiente di sviluppo.

Installare Laravel non significa semplicemente scaricare un file .zip e scompattarlo. Laravel è un framework moderno che si appoggia a un vasto ecosistema di librerie esterne. Per gestire queste librerie in modo efficiente, professionale e aggiornabile, utilizziamo uno strumento chiamato Composer. In questa lezione vedremo nel dettaglio cos'è Composer, come installarlo e come utilizzarlo per creare il nostro primo progetto Laravel.

Cos'è Composer e perché è fondamentale?

Se vieni dal mondo di JavaScript, puoi pensare a Composer come l'equivalente di npm o yarn. Se invece sei nuovo nel mondo della programmazione web, ecco una spiegazione semplice: Composer è un dependency manager (gestore di dipendenze) per PHP.

Il problema delle dipendenze

Immagina di voler aggiungere al tuo sito una funzione per inviare email tramite un servizio esterno o un sistema per generare PDF. Invece di scrivere migliaia di righe di codice da zero, puoi utilizzare una libreria scritta da altri sviluppatori. Tuttavia, quella libreria potrebbe a sua volta aver bisogno di un'altra libreria per funzionare. Questo crea una "catena di dipendenze".

Gestire manualmente questi file sarebbe un incubo: dovresti scaricare ogni singola cartella, assicurarmi che le versioni siano compatibili e aggiornarle una per una.

La soluzione di Composer

Composer risolve questo problema leggendo un file chiamato composer.json. In questo file vengono elencate tutte le librerie di cui il progetto ha bisogno. Quando esegui il comando di installazione, Composer:

  1. Analizza le dipendenze richieste.
  2. Scarica le versioni corrette.
  3. Le organizza in una cartella chiamata vendor.
  4. Genera un file di autoloading, che permette a PHP di trovare e caricare automaticamente le classi di queste librerie senza che tu debba usare decine di istruzioni require o include.

Requisiti preliminari

Prima di procedere con l'installazione di Laravel, il tuo computer deve avere alcuni componenti installati. Senza di essi, Composer o Laravel restituiranno errori di compatibilità.

1. PHP

Laravel è scritto in PHP. A seconda della versione di Laravel che installerai (attualmente Laravel 10 o 11), avrai bisogno di una versione di PHP aggiornata (solitamente PHP 8.1 o superiore).

2. Un server locale (Ambiente di Sviluppo)

Per eseguire PHP sul tuo computer, hai bisogno di un server web e di un database. Le opzioni più comuni per i principianti sono:

  • XAMPP o MAMP: Pacchetti "all-in-one" che installano Apache, MySQL e PHP.
  • Laravel Herd (Consigliato per macOS e Windows): Un ambiente di sviluppo ultra-veloce e specifico per Laravel che non richiede configurazioni complesse.
  • Docker / Laravel Sail: Per utenti più avanzati che preferiscono l'isolamento via container.

Per questa guida, assumiamo che tu abbia già installato PHP e che sia disponibile nel tuo PATH di sistema (ovvero che tu possa digitare php -v nel terminale e ricevere una risposta).

Passaggio 1: Installazione di Composer

Ora installiamo lo strumento principale. Il processo varia leggermente a seconda del sistema operativo.

Su Windows

  1. Scarica l'eseguibile Composer-Setup.exe dal sito ufficiale getcomposer.org.
  2. Avvia l'installazione. Durante il processo, l'installer ti chiederà di individuare il file php.exe. Se usi XAMPP, lo troverai solitamente in C:\\xampp\\php\\php.exe.
  3. Completa l'installazione e riavvia il tuo terminale (Prompt dei comandi o PowerShell).

Su macOS e Linux

Puoi installare Composer tramite riga di comando. Apri il terminale e segui i passaggi indicati sul sito ufficiale, oppure usa Homebrew su macOS:

brew install composer

Verifica l'installazione

Per essere sicuri che tutto funzioni, apri il terminale e digita:

composer --version

Se vedi una stringa simile a Composer version 2.x.x, sei pronto per procedere.

Passaggio 2: Installare Laravel

Esistono due modi principali per creare un progetto Laravel tramite Composer. Vediamoli entrambi.

Metodo A: Utilizzo dell'Installer di Laravel (Consigliato)

Questo metodo installa un comando globale nel tuo sistema che ti permette di creare nuovi progetti con un comando molto semplice.

Per prima cosa, installa l'installer globale:

composer global require laravel/installer

Nota: Assicurati che la cartella dei binari di Composer sia nel tuo PATH di sistema per poter usare il comando laravel ovunque.

Ora puoi creare un nuovo progetto semplicemente digitando:

laravel new mio-progetto

L'installer ti farà alcune domande (quale database usare, se installare un kit di avvio come Breeze o Jetstream). Per ora, scegli le opzioni predefinite o le più semplici.

Metodo B: Creazione tramite comando create-project

Se non vuoi installare l'installer globale, puoi usare il comando standard di Composer. Questo metodo scarica l'ultima versione stabile di Laravel direttamente in una nuova cartella:

composer create-project laravel/laravel mio-progetto

Spiegazione del comando:

  • composer create-project: Indica a Composer di creare un nuovo progetto basandosi su un pacchetto esistente.
  • laravel/laravel: È il nome del "pacchetto" ufficiale che contiene lo scheletro di un'applicazione Laravel.
  • mio-progetto: È il nome della cartella che verrà creata. Puoi chiamarla come preferisci.

Passaggio 3: Avviare l'applicazione

Una volta completato il download, entrerai nella cartella del progetto e avvierai il server di sviluppo integrato di Laravel. Non hai bisogno di configurare Apache o Nginx per iniziare a programmare.

Esegui questi comandi nel terminale:

cd mio-progetto
php artisan serve

Cosa succede qui?

  • cd mio-progetto: Entra nella directory appena creata.
  • php artisan serve: Avvia un piccolo server PHP locale. Artisan è l'interfaccia a riga di comando potente di Laravel che useremo in quasi ogni lezione di questo corso.

Dopo aver lanciato il comando, vedrai un messaggio che dice: Server running at http://127.0.0.1:8000. Apri il tuo browser, visita quell'indirizzo e vedrai la pagina di benvenuto di Laravel!

Esempi pratici e configurazione iniziale

Ora che Laravel è installato, ci sono due cose fondamentali che ogni sviluppatore deve fare subito.

Configurazione del file .env

Nella root del tuo progetto troverai un file chiamato .env. Questo file contiene le impostazioni specifiche per il tuo ambiente (database, chiavi di sicurezza, email).

Apri il file con un editor di testo (come VS Code) e cerca la sezione del database:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nome_tuo_database
DB_USERNAME=root
DB_PASSWORD=

Modifica DB_DATABASE con il nome del database che creerai nel tuo strumento di gestione (es. phpMyAdmin).

Generazione della Application Key

Se hai clonato un progetto da GitHub invece di installarlo da zero, potresti notare che l'app dà un errore. Questo succede perché manca la chiave di crittografia. Puoi generarla con:

php artisan key:generate

Questa chiave viene salvata in .env e serve per crittografare le sessioni e i cookie dell'utente, garantendo la sicurezza dell'applicazione.

Errori comuni e risoluzioni (FAQ)

"Composer not found" o "Comando non riconosciuto"

Questo è l'errore più frequente. Significa che il percorso della cartella bin di Composer non è stato aggiunto alle variabili d'ambiente (PATH) del tuo sistema operativo. Soluzione: Aggiungi manualmente il percorso C:\\Users\\TuoUtente\\AppData\\Roaming\\Composer\\vendor\\bin (su Windows) o /usr/local/bin (su Mac/Linux) al PATH.

Errori di estensioni PHP mancanti

Durante l'installazione, Composer potrebbe dirti che mancano estensioni come mbstring, openssl o curl. Soluzione: Apri il tuo file php.ini (solitamente in C:\\xampp\\php\\php.ini), cerca le righe che iniziano con ;extension=mbstring (o simili) e rimuovi il punto e virgola (;) all'inizio per abilitarle. Riavvia poi il server.

Permessi negati su Linux/macOS

Se ricevi errori di scrittura nelle cartelle storage o bootstrap/cache. Soluzione: Esegui il comando per dare i permessi corretti: chmod -R 775 storage bootstrap/cache.

Prossimi passi

Congratulazioni! Hai installato con successo Laravel e hai configurato il tuo ambiente di sviluppo. Ora hai tra le mani uno degli strumenti più potenti per creare applicazioni web moderne.

Nella prossima lezione, esploreremo la Struttura delle Cartelle di Laravel. Vedremo dove scrivere il codice, dove salvare le viste HTML e come navigare tra i vari file per non sentirsi smarriti nella complessità del framework.

Risorse consigliate per approfondire:

  • Documentazione ufficiale di Composer (getcomposer.org)
  • Documentazione ufficiale di Laravel (laravel.com)
  • Installazione di Visual Studio Code con l'estensione "Laravel Extension Pack" per migliorare la produttività.