Kas yra PSR standartai ir kodėl jie svarbūs?

Question

Accepted Answer

**PSRs (PHP Standard Recommendations)** yra standartų rinkinys, kurį publikuoja **PHP-FIG** (Framework Interoperability Group), apibrėžiantis bendras konvencijas — kodavimo stilių, automatinį įkėlimą ir bendras sąsajas — įgalinantis **sąveiką** tarp skirtingų PHP sistemų, bibliotekų ir paketų.

## Svarbiausi PSR standartai

```text
PSR-1 / PSR-12 → CODING STYLE (basic + extended): naming, braces, indentation, etc.
PSR-4         → AUTOLOADING: namespace ↔ directory mapping (used by Composer)
PSR-3         → LoggerInterface: a common logging interface
PSR-7         → HTTP message interfaces (Request/Response objects)
PSR-11        → ContainerInterface: a common DI container interface
PSR-15        → HTTP middleware interface
PSR-6 / PSR-16 → Caching interfaces
PSR-18        → HTTP client interface
```

## PSR-4 automatinis įkėlimas (standartinis, kurį naudojate kasdien)

```json
// composer.json — PSR-4 maps namespaces to directories
{ "autoload": { "psr-4": { "App\": "src/" } } }
// App\Models\User → src/Models/User.php — Composer autoloads it automatically
```

PSR-4 yra automatinio įkėlimo standartai, kuris naudojamas visoje šiuolaikinėje PHP — todėl Composer gali rasti ir įkelti bet kurią klasę pagal jos namespace.

## PSR sąsajos įgalina sąveiką

```php
// because libraries depend on the PSR-3 LoggerInterface (not a concrete logger),
// you can swap ANY PSR-3-compliant logger (Monolog, etc.) without changing code
use Psr\Log\LoggerInterface;

class Service {
    public function __construct(private LoggerInterface $logger) {}   // PSR-3 interface
}
// inject Monolog, or any PSR-3 logger — the service doesn't care which
```

Bendros sąsajos (PSR-3 loggavimas, PSR-7 HTTP, PSR-11 konteineris) reiškia, kad bibliotekos gali priklausyti nuo *standartinės sąsajos* vietoj konkretaus diegimo — todėl komponentai iš skirtingų pardavėjų yra **keičiami vienas kitam**.

## PSR-12 kodavimo stilius (nuoseklumas)

```text
PSR-12 defines a standard code style (spacing, brace placement, naming).
Following it → consistent code across teams and projects; tools (PHP-CS-Fixer,
PHPCS) auto-format/check against it. Most modern PHP projects adopt PSR-12.
```

## Kodėl tai svarbu

PSR standartai yra svarbūs profesionaliai PHP plėtrai, nes jie įgalina **sąveiką**, kuri paleidžia šiuolaikinę PHP ekosistemą — be bendrų standartų, sistemų ir bibliotekų iš skirtingų šaltinių negalėtų lengvai bendradarbiauti.

Jų supratimas yra naudingas dėl kelių priežasčių. **PSR-4 automatinis įkėlimas** yra pagrindinis ir naudojamas kasdien — tai namespace-į-direktoriją standartai, kuriuo remiasi Composer, automatiškai įkeldamas klases ir sudaro kiekvieno šiuolaikinio PHP projekto struktūros pagrindą.

**Bendros sąsajos PSR** (PSR-3 loggavimas, PSR-7 HTTP pranešimai, PSR-11 konteineriai, PSR-15 middleware) leidžia komponentams iš skirtingų pardavėjų būti keičiamiems: nes bibliotekos priklauso nuo *standartinės sąsajos* vietoj konkrečios realizacijos, galite pakeisti bet kokią atitinkančią realizaciją (bet kurį PSR-3 logger, bet kurią PSR-7 HTTP biblioteką) nekeičiant kodo — galingas lanksčios, nesusietosios architektūros įgalintojas ir priežastis, kodėl PHP ekosistemos dalys susirištos. **PSR-12 kodavimo stilius** atnešdina nuoseklumą komandose ir projektuose (užtikrintas įrankiais), kurį priima dauguma šiuolaikinės PHP.

Žinodami pagrindinius PSR — ypač PSR-4 (automatinis įkėlimas), sąsajos standartus (sąveika) ir PSR-12 (stilius) — ir PHP-FIG vaidmenį, atspindimas profesionalus supratimas apie tai, kaip šiuolaikinė PHP ekosistema pasiekia nuoseklumą ir sąveiką.

Kadangi PSR laikymasis yra profesionalios PHP praktika, ir kadangi jie sudaro Composer, sistemų sąveika ir kodo kokybės pagrindą, jų supratimas yra naudingas aukštesnio lygio žinios, išskiriant kūrėjus, kurie rašo ekosistemoje suderinamą, profesionalią PHP, nuo tų, kurie nežino konvencijų, kurios sudaro šiuolaikinę PHP koherentišką ir sąveikią.