ما هي معايير PSR ولماذا تُعتبر مهمة؟

Question

Accepted Answer

**PSRs (توصيات PHP القياسية)** هي مجموعة من المعايير التي ينشرها **PHP-FIG** (مجموعة التوافقية بين الأطر) وتحدد الاتفاقيات الشائعة — أسلوب الترميز، التحميل التلقائي، والواجهات المشتركة — مما يُمكّن **التوافقية** بين أطر العمل والمكتبات والحزم المختلفة في 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 يستطيع العثور على أي class وتحميله من خلال 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 للتسجيل، 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** أساسي ويُستخدم يومياً — إنه معيار namespace-إلى-الدليل الذي يعتمد عليه Composer لتحميل الفئات تلقائياً، وهو يدعم بنية كل مشروع PHP حديث.

معايير **الواجهات المشتركة** (PSR-3 للتسجيل، PSR-7 لرسائل HTTP، PSR-11 للحاويات، PSR-15 للوسيطات) هي ما تسمح بأن تكون المكونات من مورّدين مختلفين قابلة للتبديل: لأن المكتبات تعتمد على *واجهة قياسية* بدلاً من تطبيق ملموس، يمكنك استبدال أي تطبيق متوافق (أي logger PSR-3، أي مكتبة HTTP PSR-7) دون تغيير الكود — وهذا يُمكّن العمارة المرنة والمفكوكة بشكل قوي والسبب في أن قطع نظام PHP البيئي تتلاءم مع بعضها. **أسلوب الترميز PSR-12** يجلب التناسق عبر الفرق والمشاريع (يُفرضه الأدوات)، وهو ما تعتمده معظم مشاريع PHP الحديثة.

معرفة معايير PSR الرئيسية — خاصةً PSR-4 (التحميل التلقائي)، معايير الواجهات (التوافقية)، و PSR-12 (الأسلوب) — ودور PHP-FIG يعكس الفهم الاحترافي لكيفية تحقيق نظام PHP البيئي الحديث للتناسق والتوافقية.

بما أن اتباع معايير PSR هو ممارسة قياسية في PHP الاحترافي، وبما أنها تدعم Composer، وتوافقية الأطر، وجودة الكود، فإن فهمها يشكل معرفة قيمة على مستوى الخبراء التي تميز المطورين الذين يكتبون PHP متوافقاً مع النظام البيئي واحترافياً عن أولئك الذين لا يعرفون الاتفاقيات التي تجعل PHP الحديث متماسكاً وقابلاً للتوافقية.