PSR-2 sau cum să deveniți un programator mai bun
Cum vă ajută un standard de cod să deveniți un programator mai bun.
PSR-2 sau cum să deveniți un programator mai bun
În lumea PHP, comunitatea nu a fost deloc unită la început când venea vorba de standardele de cod. Ideea unui standard de cod comun este greu de acceptat pentru unii dintre noi și mai degrabă complică procesul de gândire.
Acest lucru se vede foarte clar, de exemplu, la code review și poate duce la discuții inutile în echipa de dezvoltare.
Avantaje
PHP Standard Recommendations (PSR) sunt punctul de referință pentru orice programator PHP. Din experiența mea, adoptarea unui standard de cod precum PSR-2 aduce numeroase beneficii. Le voi enumera aici:
- mentenanța software-ului; acesta este punctul principal și cel mai important. Dacă faceți o căutare, veți afla că între 40 și 80 la sută din costul total al unui software pe durata vieții sale se duce pe mentenanță și că aproape niciun software nu este întreținut de autorul său pe toată durata existenței.
- calitatea codului; munca de dezvoltare software presupune citirea multor linii de cod. Fie că scrieți cod, fie că faceți code review, citiți cod, iar asta nu ar trebui să fie perceput ca ceva dificil sau, mai frumos spus, ca ceva enervant.
- keep it simple; în cele mai multe cazuri, complexitatea structurii codului lucrează împotriva securității. Dacă încercați să scrieți cât mai puțin cod în timpul dezvoltării proiectului, veți scrie și mai puține bug-uri (ascunse).
- refactorizarea; redenumirea unei variabile sau a unei metode ori împărțirea codului în bucăți mai mici se numește refactorizare. Când codul arată curat și ordonat, refactorizarea merge ușor și bine.
- limba codului; orice programator ar trebui să știe engleză. Toată documentația despre componentele unui software este în engleză. Și cel care va lucra la cod după dumneavoastră știe engleză, așa că, din toate aceste motive, limba codului este legată de procesul de mentenanță și aduce un plus de lizibilitate codului.
Convențiile PSR-2
Convențiile PSR-2 au mult sens, cel puțin pentru mine, în ceea ce privește îmbunătățirea generală a codului.
Indentarea
Am citit multe articole despre ce e mai bine, tab-uri sau spații. Pentru PSR-2, lucrurile sunt simple din punctul meu de vedere: „Codul TREBUIE să folosească o indentare de 4 spații și NU TREBUIE să folosească tab-uri pentru indentare.”
Proprietăți
Programatorii știu că denumirea variabilelor este cel mai greu lucru, așa că reguli precum „Numele proprietăților NU AR TREBUI să fie prefixate cu un singur underscore pentru a indica vizibilitatea protected sau private.” sau „Vizibilitatea TREBUIE declarată pentru toate proprietățile.” sunt aici ca să ajute.
Closures
„Closure-urile TREBUIE declarate cu un spațiu după cuvântul cheie function și cu un spațiu înainte și după cuvântul cheie use.” Pentru toate convențiile standardului PSR-2, vizitați acest link
Unelte
O unealtă excelentă pentru a automatiza verificarea standardelor de cod este PHP CodeSniffer. O puteți instala, de exemplu, așa:
apt install php-codesniffer
sau, dacă aveți PEAR instalat:
pear install PHP_CodeSniffer
După instalare, o puteți folosi din consolă, de exemplu așa:
phpcs --standard=PSR2 src/
Sau vă puteți configura IDE-ul să verifice automat standardul de cod folosind phpcs.
Deveniți un programator PHP mai bun
Un programator bun ar trebui să urmeze un standard de cod. Eu susțin aici PSR-2, dar ce standard de cod folosiți depinde de dumneavoastră. Important este să aveți unul și să îl respectați cu strictețe.
Dacă sunteți antreprenor sau proprietarul unui proiect, discutați cu programatorii dumneavoastră despre standardele de cod.
Dacă sunteți programator, adoptați un standard de cod.