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

Composer și dependențe · Ghid practic

Composer pe server: instalare reproductibilă și depanarea dependențelor

Composer construiește arborele de dependențe al unei aplicații PHP, iar comenzile rulate pe server pot schimba codul sau executa scripturi. Ghidul arată cum folosești lockfile-ul, verifici platforma și pregătești un release sigur.

Păstrează composer.lock împreună cu aplicația

`composer.json` descrie dependențele acceptate, iar `composer.lock` înregistrează versiunile rezolvate pentru proiect. Pentru o aplicație publicată, păstrează ambele fișiere în versionare și folosește `composer install` ca să instalezi versiunile fixate. `composer update` este o operație de rezolvare și actualizare care trebuie făcută, testată și revizuită separat.

Un lockfile ajută build-urile să fie repetabile, dar nu garantează că platforma serverului satisface cerințele. Verifică PHP, extensiile și bibliotecile raportate de Composer în mediul de deploy. Asigură-te că CLI folosește aceeași familie de runtime și extensii ca procesul web.

Înțelege cerințele platformei înainte de instalare

Composer tratează versiunea PHP și extensiile ca platform packages; pachetele pot declara cerințe pentru ele. `show --platform` oferă lista platformei văzute de interpreterul care rulează comanda. Dacă instalarea locală reușește, dar serverul eșuează, compară aceste liste și identifică extensia ori versiunea lipsă.

Configurația `platform` poate influența rezolvarea dependențelor, dar nu instalează și nu schimbă interpreterul serverului. Evită să folosești `--ignore-platform-reqs` pentru a masca lipsuri, fiindcă aplicația poate eșua la runtime. Testează instalarea în aceeași platformă sau într-un mediu care o reproduce.

Rulează instalarea cu drepturi și scripturi controlate

Instalarea poate executa scripturi definite de proiect și pluginuri autorizate. Revizuiește scripturile, rulează build-ul cu un utilizator cu privilegii minime și nu expune secretele de producție procesului dacă etapa de build nu are nevoie de ele. Logurile pipeline-ului trebuie să evite afișarea credentialelor.

În producție, `--no-dev` omite pachetele dezvoltării, iar autoloader-ul optimizat poate îmbunătăți încărcarea claselor. Asigură-te că niciun fișier runtime nu depinde accidental de pachete din `require-dev`. Dacă folosești classmap authoritative, re-generează classmap-ul după ce codul generat sau clasele aplicației au fost incluse.

Depanează erori Composer fără să afectezi release-ul activ

Dacă `composer install` eșuează, colectează versiunea Composer, PHP-ul CLI, eroarea completă redactată și starea lockfile-ului. Verifică și spațiul liber pentru cache, fișiere temporare și directorul `vendor`. Nu instala peste codul activ până când noul release nu a trecut de etapa de build.

Păstrează artefactul anterior și publică noul director numai după instalare și verificări. Nu copia un `vendor` construit pe un sistem incompatibil atunci când există extensii native ori diferențe de platformă. După deploy, testează bootstrap-ul aplicației și confirmă că autoloader-ul găsește clasele din release.

Păstrează codul sursă și directoarele de lucru în afara rădăcinii servite de web server. Configurează document root-ul către directorul public al frameworkului și confirmă prin cereri externe că fișiere precum `composer.json`, `.env` și directoarele interne nu sunt descărcabile. În felul acesta, o regulă de rewrite greșită nu transformă structura proiectului într-un fișier public.Păstrează rezultatul instalării ca parte din release, nu într-un director comun pe care următorul build îl modifică în loc. Astfel poți compara dependențele și reveni la artefactul anterior fără să amesteci clase din două versiuni. Înainte de comutare, pornește bootstrap-ul într-un mediu de test și verifică dacă autoload-ul, conexiunile și comenzile de consolă rulează cu aceleași variabile ca serviciul web. Dacă deploy-ul eșuează, păstrează mesajele Composer redactate și nu elimina release-ul care încă deservește traficul.

Întrebări frecvente

De ce folosesc composer install în loc de composer update pe server?

install respectă versiunile fixe din composer.lock. update rezolvă din nou pachetele și poate schimba dependențele.

Ce fac dacă lipsește o extensie PHP cerută?

Instalează sau activează extensia pentru interpreterul care rulează aplicația și repetă verificarea platformei.

Este în regulă --ignore-platform-reqs?

Nu ca soluție de deploy. Opțiunea ocolește verificarea, dar nu face platforma compatibilă la runtime.

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.