Apakah standard PSR dan mengapa ia penting?

Question

Accepted Answer

**PSR (PHP Standard Recommendations)** ialah satu set standard yang diterbitkan oleh **PHP-FIG** (Framework Interoperability Group) yang mentakrifkan konvensyen bersama — gaya pengekodan, autoloading, dan interface berkongsi — membolehkan **kebolehoperasian (interoperability)** antara framework, pustaka, dan pakej PHP yang berbeza.

## PSR yang paling penting

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

## Autoloading PSR-4 (yang anda guna setiap hari)

```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 ialah standard autoloading yang menjadi sandaran semua PHP moden — itulah sebabnya Composer boleh mencari dan memuatkan mana-mana kelas berdasarkan namespace-nya.

## Interface PSR membolehkan kebolehoperasian

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

Interface berkongsi (logging PSR-3, HTTP PSR-7, container PSR-11) bermaksud pustaka boleh bergantung kepada *interface standard* dan bukannya implementasi tertentu — jadi komponen daripada pelbagai vendor boleh **ditukar ganti**.

## Gaya pengekodan PSR-12 (konsistensi)

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

## Mengapa ia penting

Standard PSR penting untuk pembangunan PHP profesional kerana ia membolehkan **kebolehoperasian** yang menjadikan ekosistem PHP moden berfungsi — tanpa standard bersama, framework dan pustaka daripada sumber berbeza tidak boleh bekerjasama dengan mudah.

Memahaminya berharga atas beberapa sebab. **Autoloading PSR-4** adalah asas dan digunakan setiap hari — ia ialah standard namespace-ke-direktori yang menjadi sandaran Composer untuk memuatkan kelas secara automatik, menyokong struktur setiap projek PHP moden.

**PSR interface berkongsi** (logging PSR-3, mesej HTTP PSR-7, container PSR-11, middleware PSR-15) ialah apa yang membolehkan komponen daripada pelbagai vendor ditukar ganti: kerana pustaka bergantung kepada *interface standard* dan bukannya implementasi konkrit, anda boleh menukar mana-mana implementasi yang patuh (mana-mana logger PSR-3, mana-mana pustaka HTTP PSR-7) tanpa menukar kod — pemboleh berkuasa kepada seni bina yang fleksibel dan terpisah serta sebab kepingan ekosistem PHP saling muat. **Gaya pengekodan PSR-12** membawa konsistensi merentas pasukan dan projek (dikuatkuasakan oleh alat), yang diadaptasi oleh kebanyakan PHP moden.

Mengetahui PSR utama — terutamanya PSR-4 (autoloading), standard interface (kebolehoperasian), dan PSR-12 (gaya) — dan peranan PHP-FIG mencerminkan pemahaman profesional tentang cara ekosistem PHP moden mencapai konsistensi dan kebolehoperasian.

Memandangkan mematuhi PSR ialah amalan standard dalam PHP profesional, dan memandangkan ia menyokong Composer, kebolehoperasian framework, dan kualiti kod, memahaminya ialah pengetahuan peringkat senior yang berharga yang membezakan pembangun yang menulis PHP profesional yang serasi ekosistem daripada mereka yang tidak menyedari konvensyen yang menjadikan PHP moden bersepadu dan boleh beroperasi bersama.