Calitatea hostingului dă valoare site-ului tău.

Laravel și deploy · Ghid practic

Deploy Laravel: configurare, optimizări și procese de fundal

Un deploy Laravel schimbă codul, configurația cache-uită și uneori procese persistente sau schema bazei de date. Urmează o ordine verificabilă pentru ca aplicația publică și worker-ele să folosească aceeași versiune și aceleași setări.

Separă codul de configurarea mediului

Păstrează credențialele de producție în afara repository-ului și a document root-ului. Fișierul `.env` din dezvoltare poate conține valori locale, dar pe server folosește secret storage-ul ori mecanismul de mediu al procesului. Limitează accesul la variabilele sensibile și nu le afișa într-o pagină de diagnostic sau într-un log.

După ce rulezi `config:cache`, aplicația folosește configurația pregătită, iar apelurile `env()` din codul obișnuit pot întoarce `null`. Citește configurația prin `config()` în controller-e și servicii și păstrează accesul la `env()` în fișierele de configurare. După schimbarea variabilelor, regenerează cache-ul prin același flux de deploy, apoi verifică în mod sigur că runtime-ul folosește valorile așteptate.

Instalează dependențe reproductibile și pregătește cache-ul

Pentru o aplicație, versionarea `composer.lock` permite instalarea versiunilor rezolvate și testate. Rulează instalarea în etapa potrivită pentru release, cu dependențele de dezvoltare excluse în producție, și verifică dacă platforma țintă oferă versiunea PHP și extensiile solicitate. Un build care reușește local poate eșua pe server dacă CLI-ul și PHP-FPM folosesc interpretere diferite.

Laravel oferă comenzi de optimizare pentru configurație, rute, view-uri și evenimente. Rulează-le pe release-ul pregătit și tratează orice eroare ca un deploy incomplet, nu continua către comutarea traficului. Rutele care folosesc closures pot necesita ajustări înainte de cache, deci validează în staging și păstrează outputul comenzilor pentru analiza incidentelor.

Într-un release separat, setează `APP_ENV=production` și verifică fiecare comandă Artisan în contextul exact al aplicației. După ce cache-ul este creat, o comandă de deploy pornită cu alte variabile poate produce un rezultat diferit față de procesul web. Păstrează aceeași cale de release, aceeași versiune PHP și aceleași setări relevante, dar nu copia secrete în logurile pipeline-ului.

Coordonează migrarea bazei cu versiunea aplicației

Înaintea unei migrări, creează un backup verificabil și testează durata pe o copie cu volum reprezentativ. Unele schimbări de schemă pot bloca tabele sau pot deveni incompatibile cu codul care rulează în acel moment. Dacă noua versiune și cea anterioară trebuie să coexiste în timpul comutării, fă schimbările în pași compatibili și amână eliminările de câmpuri.

Comanda de migrare trebuie să ruleze într-un singur loc când sunt mai multe instanțe. Planifică cine o execută, cum verifici rezultatului și care este procedura în cazul unei migrări parțiale. Revenirea codului nu anulează automat datele modificate în baza de date, deci descrie clar ce poate fi inversat fără pierderi.

Repornește worker-ele și verifică funcțiile importante

Worker-ele Laravel sunt procese persistente și nu încarcă automat codul nou după publicarea fișierelor. Cere-le o oprire grațioasă după ce noul release este gata, apoi lasă process managerul să le pornească din versiunea nouă. Monitorizează joburile în curs și confirmă că managerul repornește procesul după ieșire.

După comutare, verifică homepage-ul și rutele folosite de utilizatori, logarea, scrierile de test controlate și starea cozilor. Testează fluxurile externe cu medii sandbox, fără plăți sau mesaje reale. Urmărește erorile, latența și vârsta jobului cel mai vechi, apoi păstrează release-ul anterior pentru revenire.

Întrebări frecvente

De ce Laravel nu citește noua valoare din .env?

Cache-ul de configurație poate păstra valorile pregătite anterior. Regenerează cache-ul în deploy și citește configurația prin config() în aplicație.

Trebuie repornite cozi după deploy?

Da, worker-ele persistente trebuie reîncărcate grațios ca să folosească noul cod. Asigură-te că managerul de procese le pornește din nou.

Pot reveni doar la cod dacă migrarea a reușit?

Depinde dacă noua schemă este compatibilă cu versiunea veche și dacă s-au scris date noi. Testează calea de revenire și definește impactul înainte de deploy.

Surse și documentare

Explicație editorială generală, bazată pe documentația de mai jos. Configurația concretă și condițiile furnizorului pot diferi. Documentare: 22 noiembrie 2026.