O que são padrões PSR e por que eles importam?

Question

Accepted Answer

**PSRs (PHP Standard Recommendations)** são um conjunto de padrões publicados pelo **PHP-FIG** (Framework Interoperability Group) que definem convenções comuns — estilo de codificação, autocarregamento e interfaces compartilhadas — permitindo **interoperabilidade** entre diferentes frameworks PHP, bibliotecas e pacotes.

## Os PSRs mais importantes

```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 autocarregamento (o que você usa diariamente)

```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 é o padrão de autocarregamento que todo PHP moderno depende — é por isso que o Composer consegue encontrar e carregar qualquer classe pelo seu namespace.

## Interfaces PSR habilitam interoperabilidade

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

Interfaces compartilhadas (logging PSR-3, HTTP PSR-7, container PSR-11) significam que bibliotecas podem depender de uma *interface padrão* em vez de uma implementação específica — então componentes de diferentes fornecedores são **intercambiáveis**.

## PSR-12 estilo de codificação (consistência)

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

## Por que isso importa

Os padrões PSR são importantes para desenvolvimento profissional em PHP porque permitem a **interoperabilidade** que faz o ecossistema PHP moderno funcionar — sem padrões comuns, frameworks e bibliotecas de diferentes fontes não conseguiriam trabalhar juntos facilmente.

Compreendê-los é valioso por vários motivos. **PSR-4 autocarregamento** é fundamental e usado diariamente — é o padrão namespace-para-diretório que o Composer depende para carregar classes automaticamente, sustentando a estrutura de todo projeto PHP moderno.

Os **PSRs de interface compartilhada** (PSR-3 logging, PSR-7 mensagens HTTP, PSR-11 containers, PSR-15 middleware) são o que permite componentes de diferentes fornecedores serem intercambiáveis: porque bibliotecas dependem de uma *interface padrão* em vez de uma implementação concreta, você pode substituir qualquer implementação compatível (qualquer logger PSR-3, qualquer biblioteca HTTP PSR-7) sem alterar código — um facilitador poderoso de arquitetura flexível e desacoplada e a razão pela qual as peças do ecossistema PHP se encaixam. **PSR-12 estilo de codificação** traz consistência entre times e projetos (aplicada por ferramentas), que a maioria do PHP moderno adota.

Conhecer os PSRs principais — especialmente PSR-4 (autocarregamento), os padrões de interface (interoperabilidade) e PSR-12 (estilo) — e o papel do PHP-FIG reflete compreensão profissional de como o ecossistema PHP moderno alcança consistência e interoperabilidade.

Como seguir PSRs é prática padrão em PHP profissional, e como eles sustentam Composer, interoperabilidade de frameworks e qualidade de código, compreendê-los é conhecimento valioso de nível sênior que distingue desenvolvedores que escrevem PHP compatível com o ecossistema e profissional daqueles desavisados das convenções que tornam o PHP moderno coeso e interoperável.