რა არის PSR სტანდარტები და რატომ აქვთ მნიშვნელობა?

Question

Accepted Answer

**PSRs (PHP Standard Recommendations)** არის სტანდარტების ერთობლიობა, რომელიც გამოქვეყნებულია **PHP-FIG**(Framework Interoperability Group) მიერ და განსაზღვრავს საერთო კონვენციებს — კოდის სტილი, ავტომატური ჩატვირთვა და საზიარი ინტერფეისები — რაც უზრუნველყოფს **ურთიერთმოქმედებას** სხვადსხვა PHP ჩარჩოებს, ბიბლიოთეკებსა და პაკეტებს შორის.

## ყველაზე მნიშვნელოვანი PSRs

```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-ს შესაძლებელს ხდის ნებისმიერი კლასი იპოვოს და ჩატვირთოს მისი namespace-ით.

## 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 logging, PSR-7 HTTP, PSR-11 container) ნიშნავს, რომ ბიბლიოთეკები შეიძლება დამოკიდებული იყვნენ *სტანდარტულ ინტერფეისზე* ვიდრე კონკრეტულ რეალიზაციაზე — ამიტომ კომპონენტები სხვადსხვა მყიდველებისგან არის **ურთიერთშემცვლელი**.

## 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 ავტომატური ჩატვირთვა** არის საფუძველი და გამოიყენება ყოველდღე — ეს არის namespace-დან დირექტორიამდე სტანდარტი, რომელზე დამოკიდებულია Composer კლასების ავტომატური ჩატვირთვისთვის, რაც გახლავთ თითოეული თანამედროვე PHP პროექტის სტრუქტურის ძირითადი საფუძველი.

**საზიარი ინტერფეისის PSRs** (PSR-3 logging, PSR-7 HTTP messages, PSR-11 containers, PSR-15 middleware) საშუალებას აძლევს სხვადსხვა მყიდველების კომპონენტებს იყოს ურთიერთშემცვლელი: რადგან ბიბლიოთეკები დამოკიდებულია *სტანდარტულ ინტერფეისზე* და არა კონკრეტულ რეალიზაციაზე, შეგიძლიათ ნებისმიერი თავსებადი რეალიზაცია შეცვალოთ (ნებისმიერი PSR-3 logger, ნებისმიერი PSR-7 HTTP ბიბლიოთეკა) კოდის შეცვლის გარეშე — ეს არის მძლავრი საშუალება მოქნილი, დეკოპლირებული არქიტექტურისთვის და ის მიზეზი, რის გამოც PHP ეკოსისტემის ნაწილები ერთმანეთს ხელს უჭირენ. **PSR-12 კოდის სტილი** მოაქვს თანმიმდევრობა გუნდებსა და პროექტებში (იძულებითი კი სხვადსხვა ინსტრუმენტით), რომელსაც უმეტესი თანამედროვე PHP იყენებს.

კვანტური PSRs-ის ცოდნა — განსაკუთრებით PSR-4 (ავტომატური ჩატვირთვა), ინტერფეისის სტანდარტები (ურთიერთმოქმედება) და PSR-12 (სტილი) — და PHP-FIG-ის როლი ასახავს პროფესიონალური გაგება იმისა, თუ როგორ მიაღწია თანამედროვე PHP ეკოსისტემა თანმიმდევრობას და ურთიერთმოქმედებას.

ვინაიდან PSRs-ის დაცვა სტანდარტული პრაქტიკაა პროფესიონალური PHP-ში, და რადგან ისინი განიმტკიცებენ Composer-ს, ჩარჩოს ურთიერთმოქმედებას და კოდის ხარისხს, მათი გაგება ღირებული უფროსი დონის ცოდნაა, რაც განასხვავებს დეველოპერებს, რომლებიც წერენ ეკოსისტემასთან თავსებად, პროფესიონალურ PHP-ს მათ, ვისაც არ აქვთ ცნობიერება კონვენციების შესახებ, რომელიც თანამედროვე PHP-ს თანმიმდევრ და ურთიერთმოქმედებაში აქცევს.