Cad iad na caighdeáin PSR agus cén fáth a bhfuil siad tábhachtach?

Question

Accepted Answer

**PSRs (PHP Standard Recommendations)** is tacair chaighdeáin a foilsíodh ag an **PHP-FIG** (Framework Interoperability Group) a shainíonn coinbhinsiúin choitinn — stíl chódaithe, foluain-ualú, agus comhéadain dhlisteanach — ag cumasú **inoiriúnachta** idir crumchláracha PHP difriúla, leabharlanna, agus pacáistí.

## Na PSR-anna is thábhachtaí

```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 foluain-ualú (an ceann a úsáideann tú go laethúil)

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

Is í PSR-4 an caighdeán foluain-ualaithe a bhíonn ag brath ar fhreamalworks PHP nua-aimseartha — is é sin an fáth go bhfuil Composer ábalta aon rang a aimsiú agus a thiomsú trína ainm spáis.

## Cuireann iompar PSR oiriúnachas ar fáil

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

Ciallaíonn comhéadain dhlisteanach (PSR-3 logáil, PSR-7 HTTP, PSR-11 coimeádán) gur féidir le leabharlanna a bheith ag brath ar *chomhéadan caighdeánach* seachas fheidhmiúchán ar leith — agus mar sin is féidir le comhpháirteanna ó bhiréadaithe éagsúla a bheith **iniomlánaithe**.

## PSR-12 stíl chódaithe (comhsheasmhachta)

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

## Cén fáth a bhfuil sé tábhachtach

Tá caighdeáin PSR tábhachtach do fhorbairt PHP ghairmúil toisc go gcumasaíonn siad an **oiriúnacht** a fhágann gur féidir leis an sprioc-chóras PHP nua-aimseartha a bheith ag feidhmiú — gan chaighdeáin choitinn, ní bhéarfadh crumchláracha agus leabharlanna ó fhoinsí difriúla a bheith ábalta a bheith ag obair le chéile go réidh.

Tá sé luachmhar tuiscint a bheith agat orthu ar dhá chúis thábhachtach. **PSR-4 foluain-ualú** is bhunúsach agus in úsáid laethúil — is é an caighdeán ainm spáis-le-comhfhreagras gur bhraithníonn Composer air chun ranganna a thiomsú go huathoibríoch, ag bunú struchtúr gach tionscadal PHP nua-aimseartha.

Is é **comhéadain PSR dhlisteancha** (PSR-3 logáil, PSR-7 teachtaireachtaí HTTP, PSR-11 coimeádáin, PSR-15 idirghreanannúint) an rud a chumasaíonn do chomhpháirteanna ó bhiréadaithe éagsúla a bheith iniomlánaithe: toisc go bhraithníonn leabharlanna ar *chomhéadan caighdeánach* seachal fheidhmiúchán nochta, is féidir leat aon fheidhmiúchán comhfhreagartha (aon logálaí PSR-3, aon leabharlann HTTP PSR-7) a bhogadh i ngan fhios do chód — cumasóir cumhachtach ar ailtireacht dheeisce agus an fáth gur oibríonn píosaí an sprioc-chórais PHP le chéile. **PSR-12 stíl chódaithe** tugann comhsheasmhachta ar fud fhoireann agus thionscadal (fhorfheidhmithe ag uirlisí), ar glacadh leis an chuid is mó de PHP nua-aimseartha.

Ma fhisíonn tú na príomhPSR-anna — go háirithe PSR-4 (foluain-ualú), na caighdeáin chomhéadain (oiriúnacht), agus PSR-12 (stíl) — agus an ról atá ag PHP-FIG, is ionann agus tuiscint ghairmiúil a bheith agat ar conas a bhíonn an sprioc-chóras PHP nua-aimseartha ag fáil comhsheasmhachta agus oiriúnachta.
"]}