Deploy și operare · Ghid practic
Deploy PHP fără întreruperi inutile: release-uri, verificări și rollback
Publicarea fișierelor peste codul activ poate lăsa temporar versiuni amestecate. Ghidul descrie un flux de deploy controlat, verificări înainte și după publicare și limitele revenirii când schema bazei s-a schimbat.
Pregătește release-ul înainte să atingi versiunea activă
Un deploy începe cu un artefact identificabil: versiune de cod, dependențe și configurație necesară. Construiește ori pregătește release-ul într-un director care nu este servit public și verifică fișierele, permisiunile și compatibilitatea runtime-ului. Nu copia repository-ul complet în rădăcina web dacă acesta conține fișiere interne, istoricul Git sau secrete.
Separă configurația de cod și păstrează secretele în afara document root, cu permisiuni limitate. Notează ce versiuni PHP și extensii sunt cerute de aplicație și compară cu mediul țintă. O verificare pe staging ar trebui să includă paginile și fluxurile importante, nu doar pornirea serverului.
Păstrează release-ul anterior și identifică exact ce cale sau legătură va deveni activă. Un model de release separat permite o comutare controlată, însă trebuie să iei în calcul directoarele de upload, sesiunile, cache-ul și fișierele create de aplicație. Datele persistente nu trebuie pierdute când schimbi codul.
Planifică migrațiile bazei de date separat
Schimbarea codului și schimbarea schemei bazei au riscuri diferite. Testează migrarea pe o copie reprezentativă, estimează durata și verifică dacă poate bloca tabele sau operații. Pentru deploy-uri graduale, o schimbare compatibilă temporar cu versiunea veche și cea nouă poate reduce riscul de întrerupere.
Un rollback de cod nu anulează automat migrarea. Dacă noua versiune a eliminat ori reinterpretat date, revenirea poate cere pași suplimentari sau poate să nu fie sigură. Documentează ce schimbări sunt reversibile și când restaurarea bazei ar pierde comenzi ori alte date produse după backup.
Înainte de migrare, asigură-te că backupul poate fi restaurat și că ai timpul necesar. Nu folosi backupul ca singură procedură de revenire pentru fiecare deploy: acesta poate fi vechi, iar restaurarea poate dura mai mult decât fereastra permisă.
Comută și verifică după publicare
Validează configurația serverului web înainte de reload și aplică schimbarea prin mecanismul suportat de serviciu. O comutare de release poate reduce intervalul cu fișiere mixte, dar nu garantează zero întrerupere dacă procesul trebuie repornit ori sesiunile nu sunt partajate.
După publicare, verifică statusul HTTP, TLS, rutele principale, autentificarea, formularele și accesul bazei de date. Pentru magazine, testează căutarea, coșul și checkout-ul într-un mod care nu creează plăți reale. Urmărește rata erorilor și logurile în fereastra imediat următoare.
Înregistrează versiunea observată și rezultatele verificărilor. Dacă o probă critică eșuează, folosește procedura pregătită de revenire și verifică din nou după comutare. Evită să faci în același timp mai multe schimbări fără legătură, fiindcă identificarea cauzei devine mai grea.
Definește un rollback care păstrează datele
Un rollback trebuie să precizeze ce se schimbă înapoi: cod, configurație, versiunea PHP, cache, serviciu ori schema bazei. Dacă există scrieri noi în sistem după deploy, schimbarea înapoi a codului nu trebuie să șteargă sau să suprascrie acele date. Definește limitele și cine aprobă operația.
Păstrează logurile dinainte și după deploy, hash-ul release-ului și momentul comutării. Acestea ajută la compararea comportamentului și la raportarea incidentului. După stabilizare, investighează cauza și actualizează testele ori procedura, nu doar repeta deploy-ul cu un patch netestat.
Întrebări frecvente
Este suficient să fac git pull în public_html?
Poate expune fișiere interne și poate publica o versiune parțială. Folosește un proces care pregătește release-ul și publică numai fișierele necesare.
Pot reveni la codul vechi după orice migrare?
Nu neapărat. Migrarea poate schimba datele ori schema într-un mod incompatibil; planifică ordinea și testarea revenirii.
Ce verific imediat după deploy?
Rutele critice, TLS, autentificarea și formularele, baza de date, logurile și rata erorilor.
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.