Fare il deploy di un progetto Laravel su hosting condiviso

Vediamo come fare il deploy di un’applicazione Laravel su un piano hosting condiviso di SupportHost.

La struttura di un progetto Laravel

Non è sufficiente caricare semplicemente i file nella root per far funzionare un’applicazione Laravel, questo dipende dal fatto che i server condivisi sono configurati per servire i file da una precisa cartella che, nel caso di un hosting SupportHost, è public_html. Laravel, invece, va a richiamare i file dalla cartella public.

Questa è la tipica struttura di un progetto Laravel:

applicazione/
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── vendor/
├── .env
├── artisan
└── composer.json

In genere, ma questo dipende da come è stato strutturato il progetto, è sufficiente che solo la cartella public sia accessibile per far funzionare l’applicazione.

Come ospitare un’applicazione Laravel su un hosting condiviso

Per far funzionare un applicativo Laravel su un hosting condiviso è necessario:

• caricare il progetto sul server e configurare il file .env;
• rinominare la cartella public_html;
• creare un link simbolico.

Puoi eseguire tutti i passaggi usando il terminale accessibile da cPanel oppure collegandoti via SSH (la connessione SSH è disponibile su tutti i piani hosting di SupportHost).

Vediamo le operazioni da fare passo passo.

Caricare i file sul server

Puoi creare un file compresso, ad esempio un archivio zip, del progetto Laravel e caricarlo sul server nella root usando il file manager, dopodiché potrai estrarlo ed eliminare l’archivio.

In alternativa, se ad esempio il progetto si trova su un repository git, puoi clonare direttamente il repository usando il comando:

git clone https://indirizzo-repository.com

Ricordati che dovrai modificare la configurazione del file .env con URL dell’applicazione e i dati del database.

Rinominare la cartella public_html

Se hai già del contenuto nella cartella public_html e non vuoi perderlo, ti basterà rinominarla, ad esempio in “public_html_old”.

Puoi farlo da file manager o da terminale con il comando mv:

mv /home/utente/public_html /home/utente/public_html_old

Assicurati di sostituire “utente” con il nome utente corretto.

Creare il link simbolico

A questo punto con il comando ln possiamo creare un link simbolico che faccia sì che la cartella public_html punti alla cartella public del progetto Laravel.

Usiamo il seguente comando:

ln -s /home/utente/nome-progetto/public/ /home/utente/public_html

Dovrai assicurarti di inserire il percorso corretto, sostituendo “utente” con il tuo nome utente e “nome-progetto” con il nome della cartella in cui è contenuta la cartella “public”.