Come installare Laravel su Debian 12

Laravel è un framework per applicazioni web basato su PHP per la creazione di 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 la costruzione di applicazioni web aziendali e robuste a pieno stack. Le applicazioni Laravel possono essere consegnate rapidamente senza problemi, dal processo di sviluppo alla produzione.

Abbinare il framework web Laravel con un altro framework come React o Vue consente di creare un frontend bello e interattivo. Inoltre, supporta più database tra cui MySQL, PostgreSQL, SQLite e SQL Server. Laravel fornisce anche scaffolding per un’autenticazione sicura.

In questa guida, ti mostreremo come installare Laravel passo dopo passo su Debian 12, in modo da poter iniziare con il progetto Laravel. Ti mostreremo come installare Laravel con il server web Apache2, MariaDB e PHP 8.2.

Prerequisiti

Di seguito sono riportati i requisiti che devi seguire per questa guida:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.

Installazione del LAMP Stack

Il primo passo da fare è installare il LAMP Stack (Apache2, MariaDB e PHP) sul tuo server Debian. Quindi, verificherai anche i servizi Apache2 e MariaDB per assicurarti che il servizio sia in esecuzione.

Prima di installare i pacchetti, esegui il comando apt update per aggiornare e rinfrescare i repository di Debian.

sudo apt update

Una volta aggiornato il repository, installa i pacchetti del LAMP Stack (Apache2, PHP e MariaDB) eseguendo il comando apt install qui sotto. Il seguente comando installa anche alcune delle estensioni PHP necessarie per Laravel.

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

Inserisci y per confermare e procedere con l’installazione.

Con il LAMP Stack installato, esegui il comando systemctl qui sotto per verificare i servizi apache2 e mariadb. Se il servizio è in esecuzione, dovresti ottenere l’output active (running).

sudo systemctl status apache2  
sudo systemctl status mariadb

Per il servizio apache2, dovresti ottenere un output simile a questo:

E di seguito è lo stato del servizio mariadb.

Successivamente, esegui il comando php qui sotto per verificare la versione di PHP e i moduli abilitati su PHP. Dovresti vedere PHP 8.2 installato con alcuni moduli abilitati, come curl, date, dom e exif.

php -v  
php -m

Infine, apri il tuo browser web e visita l’indirizzo IP del tuo server Debian (ad es.: http://192.168.10.15/). Se l’installazione è riuscita, dovresti ottenere la pagina index.html del server web Apache.

Configurazione di PHP

Per installare Laravel, ci sono alcune estensioni PHP che devi abilitare, come fileinfo, mbstring e openssl. Puoi abilitare queste estensioni tramite il file php.ini.

Usa il seguente comando dell’editor nano per aprire il file di configurazione PHP /etc/php/8.2/apache2/php.ini.

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

Decommenta le seguenti righe per abilitare l’estensione fileinfo, mbstring e openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Quando hai finito, salva il file ed esci dall’editor.

Successivamente, esegui il seguente comando systemctl per riavviare il servizio apache2 e applicare le modifiche.

sudo systemctl restart apache2

Quindi, assicurati che le estensioni PHP fileinfo, mbstring e openssl siano abilitate eseguendo il comando php qui sotto.

sudo php -m

Ora crea un nuovo file phpinfo /var/www/html/info.php utilizzando il comando qui sotto. Se l’installazione di PHP e del server web Apache2 ha avuto successo, questo ti mostrerà informazioni dettagliate sulla tua installazione di PHP.

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

Apri il tuo browser web preferito e visita l’indirizzo IP del server seguito dal percorso del file info.php (ad es.: http://192.168.10.15/info.php). Se ha successo, dovresti vedere un output simile a questo:

Configurazione del server MariaDB

Dopo aver configurato PHP, configurerai il tuo server MariaDB, che include la messa in sicurezza del server MariaDB tramite l’utilità mariadb-secure-installation, quindi creando un nuovo database e un utente per il tuo progetto Laravel.

Per prima cosa, esegui il comando mariadb-secure-installation qui sotto per mettere in sicurezza l’installazione del tuo server MariaDB. Durante il processo, ti verrà chiesto di alcune configurazioni di MariaDB, inserisci Y per confermare la configurazione o n per No.

sudo mariadb-secure-installation

Di seguito sono riportate alcune delle impostazioni di MariaDB a cui ti verrà chiesto durante il processo:

• Premi ENTER quando ti viene chiesto della password di root di MariaDB.
• Inserisci n quando ti viene chiesto del metodo di autenticazione unix_socket.
• Inserisci Y per impostare una nuova password per l’utente root di MariaDB. Quindi, inserisci la nuova password e ripetila.
• Inserisci Y per rimuovere l’utente anonimo predefinito da MariaDB.
• Quindi, inserisci Y di nuovo per disabilitare il login remoto per l’utente root di MariaDB.
• Inserisci Y per rimuovere il database di test predefinito da MariaDB.
• Infine, inserisci Y di nuovo per ricaricare i privilegi delle tabelle e applicare le modifiche.

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

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

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database testapp, l’utente testapp e la password password. Assicurati di cambiare la password nella seguente query.

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

Successivamente, esegui la query qui sotto per assicurarti che l’utente testapp possa accedere al database testapp.

SHOW GRANTS FOR testapp@localhost;

L’output qui sotto conferma che l’utente testapp può accedere al database testapp.

Infine, digita quit per uscire dal server MariaDB e completare questo passaggio.

Installazione di Composer

Laravel può essere installato in molti modi, e il più semplice è installarlo tramite Composer, il gestore di pacchetti PHP. Ora installerai Composer sul tuo server Debian.

Per installare il gestore di pacchetti PHP Composer, esegui il comando apt install qui sotto. Digita y quando richiesto per procedere con l’installazione.

sudo apt install composer

Dopo che l’installazione è terminata, esegui il seguente comando per localizzare il file binario di Composer e verificare la versione di Composer.

which composer  
sudo -u www-data composer --version

Il file binario di Composer si trova in /usr/bin/composer e la versione di Composer 2.5.5 è installata.

Creazione del primo progetto Laravel

Con tutto in ordine, sei pronto per installare e creare il primo progetto Laravel. Creerai il primo progetto Laravel con MariaDB come database.

Per prima cosa, crea una nuova directory di root del documento /var/www/testapp per il tuo progetto e cambia la proprietà all’utente www-data tramite il comando qui sotto. Creerai anche le directory /var/www/.cache e /var/www/.config che saranno utilizzate da Composer.

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

Ora spostati nella directory /var/www/testapp/ e esegui il comando composer qui sotto per creare il primo progetto Laravel. Il tuo primo progetto Laravel è memorizzato nella directory /var/www/testapp/.

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

Durante l’installazione, dovresti ottenere un output simile a questo:

Con il progetto Laravel creato, successivamente configurerai il database per il tuo progetto tramite il file di configurazione .env. Il file .env è utilizzato come configurazione di base per il tuo progetto Laravel.

Usa il seguente comando dell’editor nano per aprire il file .env.

nano .env

Cambia il parametro APP_URL con il nome di dominio locale del tuo progetto Laravel. In questo modo, puoi accedere al tuo progetto tramite un nome di dominio locale. In questo caso, il nome di dominio è testapp.local.

APP_URL=http://testapp.local

Ora cambia la configurazione del database DB_CONNECTION in mysql e modifica i dettagli di DB_DATABASE, DB_USERNAME e DB_PASSWORD con i dettagli del tuo database e utente MariaDB.

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

Quando hai finito, salva il file ed esci dall’editor.

Ora esegui il seguente comando per migrare il database. Questo creerà le tabelle per il progetto Laravel.

sudo -u www-data php artisan migrate

Configurazione dell’host virtuale Apache

Nel passaggio successivo, creerai una nuova configurazione dell’host virtuale Apache2 per il tuo progetto Laravel. Dopo di che, dovrai attivare l’host virtuale e verificare le configurazioni di Apache2, quindi riavviare il server web Apache2 per applicare le modifiche.

Prima di creare la configurazione dell’host virtuale Apache2 per Laravel, devi abilitare il modulo rewrite su Apache2 tramite il comando qui sotto.

sudo a2enmod rewrite

Usa il seguente comando dell’editor nano per creare la configurazione dell’host virtuale Apache2 /etc/apache2/sites-available/laravel.conf.

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

Inserisci la seguente configurazione e cambia il parametro ServerName con il tuo nome di dominio.

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

Quando hai finito, salva il file ed esci dall’editor.

Successivamente, esegui il seguente comando per attivare la configurazione dell’host virtuale laravel.conf e verificare le configurazioni di Apache2. Se hai configurazioni corrette, dovresti ricevere un messaggio come Syntax OK.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Infine, riavvia il servizio apache2 eseguendo il comando qui sotto e applicando le modifiche che hai effettuato.

sudo systemctl restart apache2

Accesso a Laravel

Se sei su un client Linux, modifica il file /etc/hosts tramite il comando dell’editor nano qui sotto.

sudo nano /etc/hosts

Se sei su una macchina Windows, modifica il file C:\Windows\System32\drivers\etc\hosts.

Inserisci il nome di dominio del tuo progetto Laravel e l’indirizzo IP del tuo server Debian in questo modo:

192.168.10.15   testapp.local

Salva il file ed esci dall’editor.

Infine, avvia il tuo browser web e visita il nome di dominio locale del tuo progetto Laravel (ad es.: http://testapp.local). Se ha successo, dovresti ottenere una pagina simile a questa di Laravel:

Conclusione

In conclusione, hai installato Laravel con LAMP Stack (Apache2, MariaDB e PHP) sul server Debian 12. Hai anche installato Composer, il gestore di pacchetti PHP, e lo hai utilizzato come media di installazione per Laravel. Tenendo presente questo, ora puoi sviluppare la tua applicazione utilizzando il framework web Laravel e MariaDB come database per le tue applicazioni.