Come installare il framework PHP Laravel su Ubuntu 24.04

Laravel è un framework per applicazioni web basato su PHP utilizzato per costruire applicazioni web aziendali. È un framework web gratuito e open source che segue l’architettura model-view-controller (MVC) ed è basato su Symfony. Fornisce una sintassi elegante che consente di creare applicazioni con codice pulito ed è facile da leggere e comprendere.

Laravel è un framework web di livello enterprise per costruire applicazioni web complete e robuste. Le applicazioni Laravel possono essere consegnate rapidamente senza problemi, dal processo di sviluppo alla produzione.

Questa guida ti insegnerà come installare il framework web Laravel sul server Ubuntu 24.04. Installerai Laravel con il LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e il gestore di pacchetti PHP Composer.

Prerequisiti

Prima di iniziare questa guida, assicurati di avere quanto segue:

• Un server Ubuntu 24.04.
• Un utente non root con privilegi di amministratore

Installazione del LAMP Stack e di Composer

Laravel è un popolare framework PHP per lo sviluppo web moderno. Quindi, devi assicurarti che PHP e altre dipendenze siano installate sul tuo server Ubuntu. In questa sezione, installerai Laravel con il LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e Composer.

Prima di installare il pacchetto, esegui il seguente comando per aggiornare il tuo repository Ubuntu.

sudo apt update

Ora esegui il seguente comando per installare le dipendenze di Laravel, incluso il LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP), Composer e Git.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

Digita Y per procedere con l’installazione.

Una volta completata l’installazione, controlla lo stato del servizio Apache e MariaDB. Quindi, controlla le versioni di PHP e Composer.

Controlla lo stato del servizio Apache con il seguente comando. Il servizio Apache predefinito su Ubuntu dovrebbe essere abilitato e in esecuzione automaticamente.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Output:

Ora controlla il servizio MariaDB utilizzando il comando qui sotto. Il server MariaDB dovrebbe essere abilitato e in esecuzione sul tuo sistema Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Output:

Infine, controlla le versioni di PHP e Composer utilizzando il comando qui sotto. Dovresti vedere PHP 8.3 e Composer 2.7.1 installati sul tuo sistema.

php -v  
sudo -u www-data composer -v

Opzionale: Installazione di Node.js e NPM (Node.js Package Manager)

Node.js e NPM sono necessari se stai utilizzando Laravel con un motore di templating come Blade e JavaScript. In questa sezione, installerai sia Node.js che NPM (Node.js Package Manager) tramite il repository di Ubuntu.

Per installare Node.js e NPM sul tuo sistema Ubuntu, esegui quanto segue:

sudo apt install nodejs npm

Digita Y per confermare l’installazione.

Quando l’installazione è completata, inserisci il comando qui sotto per controllare la versione di Node.js e NPM.

node --version  
npm --version

Il seguente output mostra che Node.js 18 e NPM 9.5 sono installati.

Configurazione di PHP

Per eseguire Laravel, devi assicurarti che alcune estensioni PHP siano abilitate, come fileinfo, mbstring e openssl. Quindi ora carichi quelle estensioni PHP modificando il file ‘php.ini’.

Utilizzando l’editor nano, modifica il file di configurazione PHP predefinito ‘/etc/php/8.3/apache2/php.ini’.

sudo nano /etc/php/8.3/apache2/php.ini

Decommenta le seguenti righe per abilitare le estensioni PHP fileinfo, mbstring e openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Salva il file ed esci dall’editor.

Ora esegui il comando qui sotto per riavviare il servizio Apache e applicare le modifiche su PHP.

sudo systemctl restart apache2

Successivamente, verifica le estensioni PHP fileinfo, mbstring e openssl con il seguente comando. Se quelle estensioni sono abilitate, verrà mostrato il nome di ciascuna estensione.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

Inoltre, puoi verificare l’elenco delle estensioni PHP abilitate tramite PHPINFO. Crea un nuovo file PHPINFO con il seguente comando.

echo "" > /var/www/html/info.php

Quindi, visita http://192.168.5.30/info.php. Controlla le estensioni fileinfo, mbstring e openssl per assicurarti che quelle estensioni siano abilitate.

Configurazione del server MariaDB

Dopo aver configurato PHP, devi mettere in sicurezza il tuo server MariaDB e creare un nuovo database e utente per Laravel.

Esegui il comando ‘mariadb-secure-installation’ qui sotto per mettere in sicurezza il tuo server MariaDB. Ora ti verrà chiesto di configurare il server MariaDB.

sudo mariadb-secure-installation

Quando richiesto, inserisci Y per applicare la nuova configurazione o digita N per rifiutarla.

• L’installazione predefinita di MariaDB viene fornita senza password. Premi INVIO quando ti viene chiesta la password.
• Ora, inserisci Y per impostare la password di root di MariaDB. Quindi, digita la nuova password per MariaDB e ripeti la password.
• Inserisci Y per rimuovere l’utente anonimo dalla tua installazione di MariaDB.
• Inserisci di nuovo Y quando ti viene chiesto di disabilitare il login remoto per l’utente root di MariaDB.
• Inserisci Y per rimuovere il database di test predefinito dalla tua MariaDB.
• Infine, inserisci Y per ricaricare i privilegi delle tabelle e applicare le nuove modifiche.

Dopo aver messo in sicurezza il server MariaDB, devi creare un nuovo database e utente per il tuo progetto Laravel.

Accedi al server MariaDB utilizzando il comando qui sotto. Inserisci la tua password di root di MariaDB quando richiesto.

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database e utente ‘laravelapp‘, con la password ‘password‘.

CREATE DATABASE laravelapp;  
CREATE USER laravelapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravelapp@localhost;  
FLUSH PRIVILEGES;

Successivamente, esegui la seguente query per verificare i privilegi per l’utente ‘laravelapp‘. Questo garantirà che il tuo utente possa accedere al database Laravel ‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

Infine, digita quit per uscire dal server MariaDB.

Installazione di Laravel tramite Composer

Ora che hai configurato PHP e creato il database e l’utente MySQL/MariaDB, puoi installare Laravel. In questa sezione, imposterai la directory del progetto, installerai Laravel tramite Composer e integrerai Laravel con il database MySQL/MariaDB.

Per prima cosa, esegui il comando qui sotto per creare le directory /var/www/.cache (per la cache di Composer), /var/www/.config (per la configurazione aggiuntiva di Composer) e /var/www/laravelapp (per il tuo progetto Laravel).

sudo mkdir -p /var/www/{.cache,.config,laravelapp}

Ora cambia la proprietà delle directory /var/www/.cache, /var/www/.config e /var/www/laravelapp all’utente ‘www-data‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Successivamente, vai nella directory /var/www/laravelapp e installa Laravel con il comando Composer qui sotto.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

L’installazione di Laravel dovrebbe iniziare come segue:

Ora apri il file ‘.env’ utilizzando il comando dell’editor nano qui sotto.

nano .env

Cambia il valore predefinito ‘APP_URL‘ con il tuo nome di dominio locale. In questo esempio, Laravel verrà eseguito sul dominio ‘laravelapp.local’.

APP_URL=http://laravelapp.local

Cambia il valore predefinito ‘DB_CONNECTION‘ in ‘mysql‘, decommenta e cambia i dettagli del database con le tue informazioni.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravelapp  
DB_PASSWORD=password

Salva ed esci dal file.

Infine, esegui il comando qui sotto per migrare il database per il tuo progetto Laravel.

sudo -u www-data php artisan migrate

Output della migrazione del database Laravel:

Configurazione di un host virtuale per Laravel

In questa sezione, imposterai il file dell’host virtuale per Laravel. Assicurati di avere il nome di dominio locale pronto per il tuo sviluppo Laravel.

Prima di creare un host virtuale, abilita il modulo ‘ rewrite ‘ di Apache con il comando qui sotto.

sudo a2enmod rewrite

Crea una nuova configurazione dell’host virtuale ‘/etc/apache2/sites-available/laravelapp.conf‘ con l’editor nano.

sudo nano /etc/apache2/sites-available/laravelapp.conf

Aggiungi la seguente configurazione e cambia l’opzione ServerName con il tuo nome di dominio Laravel, come ‘laravelapp.local‘.

  
  
 ServerAdmin [email protected]  
 ServerName laravelapp.local  
 DocumentRoot /var/www/laravelapp/public  
  
   
 Options FollowSymLinks  
 AllowOverride None  
   
   
 AllowOverride All  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Salva il file ed esci dall’editor.

Ora esegui il comando qui sotto per attivare l’host virtuale ‘laravelapp.conf‘ e verificare la sintassi di Apache. Se non ci sono errori, dovresti vedere l’output ‘Syntax OK‘.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Riavvia il servizio Apache per applicare il nuovo file dell’host virtuale Laravel. Dopo che Apache è stato riavviato, la tua installazione di Laravel è pronta.

sudo systemctl restart apache2

Accesso al progetto Laravel

A questo punto, sei pronto per accedere alla tua installazione di Laravel tramite il file ‘hosts’.

Per gli utenti Linux o MacOS, modifica il file ‘/etc/hosts‘ con privilegi di root. Per gli utenti Windows, apri il file ‘C:\Windows\System32\drivers\etc\hosts‘ come amministratore.

Aggiungi l’indirizzo IP del tuo server Ubuntu seguito dal nome di dominio Laravel come segue:

192.168.5.30 laravelapp.local

Salva ed esci dal file.

Ora visita http://laravelapp.local/ con il tuo browser web. Se la tua installazione di Laravel è riuscita, dovresti ottenere la seguente pagina:

Conclusione

Congratulazioni! Hai completato l’installazione di Laravel su Ubuntu 24.04. Hai Laravel in esecuzione con il LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e hai appreso il comando base di Composer per creare un progetto.