Hosting Laravel: deploy di un'app Laravel

Introduzione

Per sviluppare e ospitare un'applicazione Laravel su Square Cloud, è essenziale seguire una sequenza strutturata di configurazioni e prerequisiti. Questa guida tecnica coprirà l’intero processo, dalla configurazione iniziale al deploy in produzione.

Prerequisiti

Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
Piano attivo: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri piani disponibili e scegli quello più adatto alle tue esigenze.

Questa guida usa il runtime PHP.

Creare il progetto

Ti servono PHP e Composer sul tuo computer. Installa l’installer di Laravel con Composer:

composer global require laravel/installer

Poi crea un progetto e avvia il server di sviluppo:

laravel new myapp
cd myapp
php artisan serve

Il server di sviluppo di solito ascolta su http://localhost:8000. Ecco una route di base in routes/web.php:

routes/web.php

<?php

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return 'Hello World from Laravel!';
});

Build per la produzione

Composer installa le tue dipendenze PHP su Square Cloud, nel comando START qui sotto. Se la tua applicazione usa Vite per gli asset frontend (l’impostazione predefinita), esegui npm run build prima di creare il tuo ZIP, così la cartella public/build viene inclusa.

Scegliere un server di produzione

Senza un comando START, Square Cloud esegue il server PHP integrato (php -S 0.0.0.0:80) usando la radice del progetto come document root. La document root di Laravel è la cartella public/, quindi le tue route restituirebbero errori 404 e file come .env potrebbero essere esposti. Imposta sempre un comando START che esegua il server di Laravel.

Porta e host

php artisan serve ha bisogno di entrambi i valori sulla riga di comando: --host=0.0.0.0 --port=80. Senza --host=0.0.0.0, ascolta solo su 127.0.0.1 e il tuo sito va in timeout.

Configurare Square Cloud

Crea un file squarecloud.app nella radice del tuo progetto:

squarecloud.app

MAIN=public/index.php
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My Laravel app
SUBDOMAIN=mylaravelapp
START=composer install --no-dev --optimize-autoloader && php artisan migrate --force && php artisan serve --host=0.0.0.0 --port=80

A ogni avvio, questo comando:

composer install --no-dev --optimize-autoloader installa le tue dipendenze di produzione in vendor/.
php artisan migrate --force applica le migrazioni del database in sospeso. --force è necessario per eseguire le migrazioni in produzione.
php artisan serve --host=0.0.0.0 --port=80 serve la tua applicazione dalla cartella public/ tramite il router di Laravel, sulla porta 80 e su tutte le interfacce di rete.

MAIN=public/index.php seleziona il runtime PHP. Nell’upload dalla dashboard, imposta lo stesso file principale e lo stesso comando di avvio.

Variabili d’ambiente

Imposta queste variabili d’ambiente nella tua applicazione, dalla dashboard o con squarecloud app env set, invece di caricare il tuo file .env locale:

Variabile	Valore
`APP_KEY`	L’output di `php artisan key:generate --show`
`APP_ENV`	`production`
`APP_DEBUG`	`false` (mai `true` in produzione)
`APP_URL`	L’indirizzo del tuo sito, ad esempio `https://mylaravelapp.squareweb.app`
`DB_CONNECTION`, `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`	La connessione al tuo database. I nuovi progetti Laravel usano SQLite per impostazione predefinita

Considerare attendibile il proxy di Square Cloud

Square Cloud serve il tuo sito in HTTPS tramite un proxy. Per fare in modo che Laravel generi link e URL degli asset con https://, considera attendibile il proxy in bootstrap/app.php:

bootstrap/app.php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(at: '*');
})

Prestazioni migliori con Swoole

php artisan serve gestisce una richiesta alla volta. Per un traffico più elevato, il runtime PHP include già Swoole: esegui la tua applicazione su Swoole con Laravel Octane (composer require laravel/octane).

Swoole

Esegui applicazioni PHP su Swoole su Square Cloud.

Cosa mettere nello ZIP

Tutto il progetto: app/, bootstrap/, config/, database/, public/ (con public/build se usi Vite), resources/, routes/, storage/, artisan, composer.json e composer.lock.
squarecloud.app.

Lascia fuori vendor/ e node_modules/ (Composer installa vendor/ sul server) e il tuo file .env locale.

Deploy e verifica

Tramite dashboard

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

Caricamento dell'applicazione su Square Cloud

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

Tramite CLI

Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamato squarecloud.app nella sua radice. Indica a Square Cloud come eseguire la tua applicazione.

Guida al file di configurazione

Scopri come creare il file di configurazione squarecloud.app che definisce l’ambiente della tua applicazione.

Installa la CLI

Installa la CLI di Square Cloud. Se ce l’hai già, esegui lo stesso comando per aggiornarla:

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

Accedi

Esegui il comando qui sotto. Apre il tuo browser: approva l’accesso lì e la CLI è pronta. Non c’è nessuna chiave API da copiare. Per script e CI, consulta Autenticazione della CLI.

squarecloud auth login

Carica il tuo progetto

Dalla cartella del tuo progetto, esegui il comando qui sotto. La CLI comprime la cartella corrente, escludendo ciò che elenca squarecloud.ignore, e la carica:

squarecloud upload

Per caricare uno zip che hai creato tu, passalo con --file:

squarecloud upload --file <path/to/zip>

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:

squarecloud app status
squarecloud app logs

Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

Errori comuni

Dominio personalizzato

Per utilizzare un dominio personalizzato (ad esempio, mysite.com) invece dell’URL predefinito mysite.squareweb.app, hai bisogno del piano Standard o superiore. L’URL predefinito deriva dal campo SUBDOMAIN nel file di configurazione. Per collegare il tuo dominio, segui come configurare il tuo dominio.

Requisiti minimi di RAM

Minimo: 512MB di RAM per siti web e API, sufficienti per una build statica sul runtime statico. Per le app che generano le pagine su un server (Next.js, Nuxt, Angular SSR e simili), consigliamo almeno 1GB di RAM. Per applicazioni più grandi, alloca più RAM per evitare che l’applicazione esaurisca la memoria e si arresti in modo anomalo.

Impossibile trovare questo sito.

Verifica che il sottodominio/dominio corrisponda a quanto configurato nel campo SUBDOMAIN o nelle impostazioni del dominio personalizzato. Se hai appena caricato il sito, attendi fino a 60 secondi affinché Square abiliti il primo accesso.

Il sito ha impiegato troppo tempo per rispondere…

Il tuo server deve ascoltare sulla porta 80 e sull’host 0.0.0.0. Square Cloud imposta le variabili d’ambiente PORT (80) e HOST (0.0.0.0) nella tua applicazione: leggile nel codice invece di scrivere altri valori fissi. Un server che ascolta solo su localhost o 127.0.0.1 non riceve mai richieste.

No application encryption key has been specified

Manca APP_KEY. Generane una con php artisan key:generate --show, impostala come variabile d’ambiente, poi riavvia l’applicazione.

Prossimi passi

Variabili d'ambiente

Tieni segreti e impostazioni fuori dal codice e leggili in fase di esecuzione.

Dominio personalizzato

Pubblica la tua app sul tuo dominio, dal piano Standard in su.

Risoluzione dei problemi

Sistema un’app che non si avvia o un sito che non risponde.

Per saperne di più su Laravel, consulta la documentazione ufficiale di Laravel.

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.

Bots

Siti web

API e backend

Database

App self-hosted

Guide

Guide alla migrazione

Hosting Laravel: deploy di un'app Laravel

Introduzione

Prerequisiti

Creare il progetto

Build per la produzione

Scegliere un server di produzione

Porta e host

Configurare Square Cloud

Variabili d’ambiente

Considerare attendibile il proxy di Square Cloud

Prestazioni migliori con Swoole

Swoole

Cosa mettere nello ZIP

Deploy e verifica

Tramite dashboard

Tramite CLI

Guida al file di configurazione

Errori comuni

Dominio personalizzato

Requisiti minimi di RAM

Impossibile trovare questo sito.

Il sito ha impiegato troppo tempo per rispondere…

No application encryption key has been specified

Prossimi passi

Variabili d'ambiente

Dominio personalizzato

Risoluzione dei problemi

Contattaci

​Introduzione

​Prerequisiti

​Creare il progetto

​Build per la produzione

​Scegliere un server di produzione

​Porta e host

​Configurare Square Cloud

​Variabili d’ambiente

​Considerare attendibile il proxy di Square Cloud

​Prestazioni migliori con Swoole

Swoole

​Cosa mettere nello ZIP

​Deploy e verifica

​Tramite dashboard

​Tramite CLI

Guida al file di configurazione

​Errori comuni

​Dominio personalizzato

​Requisiti minimi di RAM

​Impossibile trovare questo sito.

​Il sito ha impiegato troppo tempo per rispondere…

​No application encryption key has been specified

​Prossimi passi

Variabili d'ambiente

Dominio personalizzato

Risoluzione dei problemi

​Contattaci

Introduzione

Prerequisiti

Creare il progetto

Build per la produzione

Scegliere un server di produzione

Porta e host

Configurare Square Cloud

Variabili d’ambiente

Considerare attendibile il proxy di Square Cloud

Prestazioni migliori con Swoole

Cosa mettere nello ZIP

Deploy e verifica

Tramite dashboard

Tramite CLI

Errori comuni

Dominio personalizzato

Requisiti minimi di RAM

Impossibile trovare questo sito.

Il sito ha impiegato troppo tempo per rispondere…

No application encryption key has been specified

Prossimi passi

Contattaci