Aplicații Laravel.
Ce primește din start un proiect Laravel: APP_KEY și setări de producție, SQLite până adaugi o bază de date, migrările drept comandă de lansare, un worker pentru coadă și schedulerul.
Laravel este recunoscut după laravel/framework din composer.json. Îl publici așa cum este — fără configurare de server și fără fișiere în plus în repository.
Cum se construiește și cum rulează
- PHP — cea mai mică dintre versiunile 8.2, 8.3 și 8.4 care satisface cerința
phpdincomposer.json(8.3 când nu se specifică). - Composer —
composer install --no-dev --optimize-autoloader. - Resursele front-end — dacă
package.jsonare un scriptbuild(Vite), acesta rulează șipublic/buildeste inclus. - La pornire —
storage:link, apoi se construiesc cache-urile de config, rute și view-uri. - HTTPS — aplicația ta vede cererile HTTPS ca sigure, așa că
url(),asset()și redirecționările foloseschttps://fără să configurezi tu proxy-uri de încredere.
Variabile setate pentru tine
| Variabilă | Valoare |
|---|---|
APP_KEY | generată o singură dată, la primul deploy, și păstrată cu variabilele tale |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | adresa aplicației |
LOG_CHANNEL | stderr — ca fila Loguri să afișeze logul Laravel |
SESSION_DRIVER, CACHE_STORE | redis când aplicația are Valkey, altfel file |
Oricare dintre ele poate fi înlocuită de o variabilă proprie cu același nume — de exemplu SESSION_DRIVER=database. Vezi Variabile de mediu.
Baza de date: întâi SQLite
O aplicație Laravel nouă, fără bază de date, își ține datele în SQLite — varianta implicită a Laravel —, în storage/app/database.sqlite pe discul aplicației. Fișierul rămâne între deploy-uri și este inclus în backupurile zilnice ale aplicației, așa că poți lansa întâi și decide mai târziu asupra bazei de date.
Când adaugi PostgreSQL sau MySQL la proiect (Prezentare generală → Servicii → Adaugă un serviciu), aplicația trece pe ea la următorul deploy, iar migrările rulează acolo. Datele din fișierul SQLite nu se transferă — exportă-le mai întâi dacă ai nevoie de ele și importă-le din fila Date a bazei de date. Vezi Baze de date.
Migrările — comanda de lansare
Comanda de lansare recomandată este php artisan migrate --force. Rulează o dată la fiecare deploy, înainte ca versiunea nouă să primească vizitatori; dacă o migrare eșuează, versiunea curentă rulează în continuare. O poți schimba din fila Procese. Vezi Deploy-uri.
Workerul pentru coadă și schedulerul
Din start, fila Procese rulează:
| Ce | Comandă |
|---|---|
| Worker în fundal „queue” | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Comandă programată, în fiecare minut | php artisan schedule:run |
Acestea împart resursele aplicației și repornesc la fiecare deploy. Le schimbi sau le elimini din fila Procese — de exemplu, înlocuiești workerul cu php artisan horizon când folosești Horizon cu Valkey.
Pentru o coadă încărcată, rulează workerul ca serviciu separat de tip worker în fundal, cu propriile resurse, și elimină-l din Procese. Vezi Serviciile unui proiect.
Valkey pentru cache, sesiuni și cozi
Adaugă Valkey la proiect: sesiunile și cache-ul se mută singure pe el (la următorul deploy; vizitatorii se autentifică încă o dată). Cozile și orice altceva le setezi în fila Variabile, de exemplu:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT și REDIS_CLIENT=phpredis sunt setate pentru tine.
WebSockets (Laravel Reverb)
Rulează Reverb ca serviciu web din codul acestui proiect, cu comanda php artisan reverb:start --host=0.0.0.0 --port=$PORT. Primește propria adresă.
Fișiere și fișiere încărcate
Fișierele din storage/app — discurile local și public ale Laravel — rămân pe discul aplicației între deploy-uri și au backup zilnic. Tot restul din folderul proiectului vine proaspăt din repository la fiecare deploy. Pentru multe fișiere sau fișiere mari, folosește stocarea de obiecte cu discul s3 al Laravel.