Что такое стандарты PSR и почему они важны?

Question

Accepted Answer

**PSR (PHP Standard Recommendations)** — это набор стандартов, опубликованных **PHP-FIG** (PHP Framework Interoperability Group), которые определяют общие соглашения — стиль кодирования, автозагрузку и общие интерфейсы — обеспечивая **взаимодействие** между различными PHP-фреймворками, библиотеками и пакетами.

## Самые важные PSR

```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 автозагрузка (то, что вы используете ежедневно)

```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 — это стандарт автозагрузки, на который полагается весь современный PHP — именно благодаря этому Composer может найти и загрузить любой класс по его пространству имён.

## Интерфейсы PSR обеспечивают взаимодействие

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

Общие интерфейсы (PSR-3 для логирования, PSR-7 для HTTP, PSR-11 для контейнеров) означают, что библиотеки могут зависеть от *стандартного интерфейса*, а не от конкретной реализации — поэтому компоненты от разных поставщиков **взаимозаменяемы**.

## PSR-12 стиль кодирования (консистентность)

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

## Почему это важно

Стандарты PSR важны для профессиональной разработки на PHP, потому что они обеспечивают **взаимодействие**, необходимое для работы современной PHP-экосистемы — без общих стандартов фреймворки и библиотеки от разных источников не могли бы легко работать вместе.

Понимание их ценно по нескольким причинам. **PSR-4 автозагрузка** — это основополагающий стандарт, используемый ежедневно — это соглашение о сопоставлении пространств имён с директориями, на котором Composer полагается для автоматической загрузки классов, формируя структуру каждого современного PHP-проекта.

**Интерфейсные PSR** (PSR-3 для логирования, PSR-7 для HTTP-сообщений, PSR-11 для контейнеров, PSR-15 для middleware) — это то, что позволяет компонентам от разных поставщиков быть взаимозаменяемыми: поскольку библиотеки зависят от *стандартного интерфейса*, а не от конкретной реализации, вы можете заменить любую совместимую реализацию (любой логгер PSR-3, любую HTTP-библиотеку PSR-7) без изменения кода — это мощный инструмент для создания гибкой, слабо связанной архитектуры и причина того, что части PHP-экосистемы хорошо сочетаются друг с другом. **PSR-12 стиль кодирования** обеспечивает консистентность между командами и проектами (поддерживается инструментами), что большинство современных PHP-проектов применяют.

Знание ключевых PSR — особенно PSR-4 (автозагрузка), интерфейсных стандартов (взаимодействие) и PSR-12 (стиль) — и роли PHP-FIG отражает профессиональное понимание того, как современная PHP-экосистема достигает консистентности и взаимодействия.

Поскольку следование PSR — это стандартная практика профессиональной PHP, и поскольку они лежат в основе Composer, взаимодействия фреймворков и качества кода, понимание их — это ценные знания уровня senior, которые отличают разработчиков, пишущих совместимый с экосистемой, профессиональный PHP, от тех, кто не знает соглашений, которые делают современный PHP согласованным и взаимодействующим.