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.
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
phpdicomposer.json(8.3 se non è indicato). - Composer —
composer install --no-dev --optimize-autoloader. - Asset front-end — se
package.jsonha uno scriptbuild(Vite), viene eseguito epublic/buildviene 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 usanohttps://senza che tu debba configurare i proxy attendibili.
Variabili impostate per te
| Variabile | Valore |
|---|---|
APP_KEY | generata una sola volta al primo deploy e conservata con le tue variabili |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | l'indirizzo dell'applicazione |
LOG_CHANNEL | stderr — così la scheda Log mostra il log di Laravel |
SESSION_DRIVER, CACHE_STORE | redis 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:
| Cosa | Comando |
|---|---|
| Worker in background «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Comando pianificato, ogni minuto | php 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=redisREDIS_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.