Inizia ora

Applicazioni Laravel.

Cosa ottiene subito un progetto Laravel: APP_KEY e impostazioni di produzione, SQLite finché non aggiungi un database, le migrazioni come comando di rilascio, un worker per le code e lo scheduler.

3 MIN DI LETTURA

Laravel viene riconosciuto da laravel/framework in composer.json. Lo pubblichi così com'è — nessuna configurazione del server, nessun file aggiuntivo nel repository.

Come viene compilato ed eseguito

  • PHP — la versione più bassa tra 8.2, 8.3 e 8.4 che soddisfa il requisito php di composer.json (8.3 se non è indicato).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Asset front-end — se package.json ha uno script build (Vite), viene eseguito e public/build viene incluso.
  • All'avvio — storage:link, poi vengono generate le cache di configurazione, rotte e viste.
  • HTTPS — la tua applicazione considera sicure le richieste HTTPS, quindi url(), asset() e i reindirizzamenti usano https:// senza che tu debba configurare i proxy attendibili.

Variabili impostate per te

VariabileValore
APP_KEYgenerata una sola volta al primo deploy e conservata con le tue variabili
APP_ENVproduction
APP_DEBUGfalse
APP_URLl'indirizzo dell'applicazione
LOG_CHANNELstderr — così la scheda Log mostra il log di Laravel
SESSION_DRIVER, CACHE_STOREredis quando l'applicazione ha Valkey, altrimenti file

Ognuna può essere sostituita da una tua variabile con lo stesso nome — ad esempio SESSION_DRIVER=database. Vedi Variabili d'ambiente.

Il database: prima SQLite

Una nuova applicazione Laravel senza database conserva i dati in SQLite — il default di Laravel stesso — in storage/app/database.sqlite sul disco dell'applicazione. Il file sopravvive ai deploy ed è incluso nei backup giornalieri dell'applicazione, quindi puoi partire subito e decidere il database più avanti.

Quando aggiungi PostgreSQL o MySQL al progetto (Panoramica → Servizi → Aggiungi un servizio), l'applicazione passa al nuovo database con il deploy successivo e le migrazioni vengono eseguite lì. I dati del file SQLite non vengono trasferiti — se ti servono, esportali prima e importali nella scheda Dati del database. Vedi Database.

Migrazioni — il comando di rilascio

Il comando di rilascio consigliato è php artisan migrate --force. Viene eseguito una volta a ogni deploy, prima che la nuova versione riceva visitatori; se una migrazione fallisce, la versione attuale resta in esecuzione. Puoi cambiarlo nella scheda Processi. Vedi Deploy.

Worker per le code e scheduler

Di serie, la scheda Processi esegue:

CosaComando
Worker in background «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Comando pianificato, ogni minutophp artisan schedule:run

Condividono le risorse dell'applicazione e si riavviano a ogni deploy. Modificali o rimuovili nella scheda Processi — ad esempio, sostituisci il worker con php artisan horizon se usi Horizon con Valkey.

Per una coda pesante, esegui il worker come servizio worker in background separato con risorse proprie e rimuovilo da Processi. Vedi Servizi di un progetto.

Valkey per cache, sessioni e code

Aggiungi Valkey al progetto: sessioni e cache vi si spostano da sole (con il deploy successivo; i visitatori dovranno accedere di nuovo una volta). Le code e tutto il resto le imposti nella scheda Variabili, ad esempio:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST, REDIS_PASSWORD, REDIS_PORT e REDIS_CLIENT=phpredis vengono impostate per te.

WebSocket (Laravel Reverb)

Esegui Reverb come servizio web dal codice di questo progetto con il comando php artisan reverb:start --host=0.0.0.0 --port=$PORT. Riceve un proprio indirizzo.

File e upload

I file in storage/app — i dischi local e public di Laravel — restano sul disco dell'applicazione tra un deploy e l'altro e vengono salvati ogni giorno nei backup. Tutto il resto della cartella del progetto arriva nuovo dal repository a ogni deploy. Per molti file o file di grandi dimensioni, usa l'object storage con il disco s3 di Laravel.

Hai ancora dubbi?

Scrivici in chat: l'AI risponde subito e un tecnico si unisce quando serve, a qualsiasi ora.

Contatta l'assistenza