Czym są standardy PSR i dlaczego są ważne?

Question

Accepted Answer

**PSR-y (PHP Standard Recommendations)** to zestaw standardów publikowanych przez **PHP-FIG** (Framework Interoperability Group), które definiują wspólne konwencje — styl kodowania, autoloading oraz wspólne interfejsy — umożliwiające **interoperacyjność** między różnymi frameworkami PHP, bibliotekami i pakietami.

## Najważniejsze PSR-y

```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 autoloading (ten, którego używasz codziennie)

```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 to standard autoloadingu, na którym opiera się cały nowoczesny PHP — dzięki niemu Composer może znaleźć i załadować dowolną klasę na podstawie jej namespace'u.

## Interfejsy PSR umożliwiają interoperacyjność

```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
```

Wspólne interfejsy (PSR-3 logging, PSR-7 HTTP, PSR-11 container) oznaczają, że biblioteki mogą zależeć od *standardowego interfejsu* zamiast konkretnej implementacji — dzięki temu komponenty od różnych dostawców są **wymienne**.

## PSR-12 styl kodowania (spójność)

```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.
```

## Dlaczego to ważne

Standardy PSR są ważne dla profesjonalnego rozwoju PHP, ponieważ umożliwiają **interoperacyjność**, która sprawia, że nowoczesny ekosystem PHP funkcjonuje — bez wspólnych standardów frameworki i biblioteki z różnych źródeł nie mogłyby łatwo pracować razem.

Zrozumienie ich jest cenne z kilku powodów. **PSR-4 autoloading** jest fundamentalny i używany codziennie — to standard mapowania namespace'u na katalog, na którym Composer opiera się, aby automatycznie ładować klasy, stanowiące podstawę struktury każdego nowoczesnego projektu PHP.

**Interfejsy PSR** (PSR-3 logging, PSR-7 HTTP messages, PSR-11 containers, PSR-15 middleware) pozwalają komponentom od różnych dostawców być wymiennymi: ponieważ biblioteki zależą od *standardowego interfejsu* zamiast konkretnej implementacji, możesz zamienić dowolną zgodną implementację (dowolny logger PSR-3, dowolną bibliotekę HTTP PSR-7) bez zmiany kodu — to potężne narzędzie elastycznej, luźno powiązanej architektury i powód, dla którego części ekosystemu PHP dopasowują się do siebie. **PSR-12 styl kodowania** wprowadza spójność w zespołach i projektach (wymuszaną przez narzędzia), którą większość nowoczesnego PHP przyjmuje.

Znajomość kluczowych PSR-ów — szczególnie PSR-4 (autoloading), interfejsów standardowych (interoperacyjność) i PSR-12 (styl) — oraz roli PHP-FIG odzwierciedla profesjonalne zrozumienie, jak nowoczesny ekosystem PHP osiąga spójność i interoperacyjność.

Ponieważ przestrzeganie PSR-ów jest standardową praktyką w profesjonalnym PHP, a ponieważ stanowią one podstawę Composera, interoperacyjności frameworków i jakości kodu, ich zrozumienie jest wartościową wiedzą na poziomie senior, która wyróżnia programistów piszących ekosystem-kompatybilny, profesjonalny PHP od tych, którzy nie znają konwencji, które czynią nowoczesny PHP spójnym i interoperacyjnym.