ما هو Composer وكيف يعمل التحميل التلقائي؟

Question

Accepted Answer

**Composer** هو **مدير الاعتماديات** القياسي في PHP — فهو يثبّت وينظّم حزم الطرف الثالث (المكتبات والأطر العمل) ويوفّر **التحميل التلقائي** بحيث تُحمّل الفئات تلقائياً دون بيانات `require` يدوية. إنه أساسي لجميع تطوير PHP الحديث.

## إدارة الاعتماديات

```bash
composer require guzzlehttp/guzzle    # add a package (records it + installs it)
composer install                       # install all deps from composer.json/lock
composer update                        # update to newer allowed versions
```

```json
// composer.json — declares your project's dependencies
{
  "require": {
    "guzzlehttp/guzzle": "^7.0",      // a package + version constraint
    "monolog/monolog": "^3.0"
  },
  "autoload": {
    "psr-4": { "App\": "src/" }        // map the App\ namespace to the src/ folder
  }
}
```

ملف `composer.json` يُعلّن الاعتماديات (مع قيود الإصدار) وإعدادات التحميل التلقائي. ملف **`composer.lock`** يثبّت الإصدارات الدقيقة (التزمْ بـه لتثبيتات قابلة للتكرار عبر الفريق والإنتاج — مثل ملفات القفل الأخرى).

## التحميل التلقائي: تُحمّل الفئات عند الطلب

```php
<?php
require "vendor/autoload.php";    // include the autoloader ONCE (bootstraps everything)

$user = new App\Models\User();    // App\Models\User loaded AUTOMATICALLY from src/Models/User.php
$client = new GuzzleHttp\Client(); // package classes load automatically too
// NO manual require for each class!
```

مع بيان `require "vendor/autoload.php"` واحد، محمّل Composer التلقائي يحمّل أي فئة **عند الطلب** أول مرة تُستخدم — بمطابقة namespace الفئة مع مسار ملف (**PSR-4**) وإدراجها تلقائياً. هذا يحل محل الممارسة القديمة المرهقة المتمثلة في `require` يدوي لكل ملف فئة.

## كيف يرسم PSR-4 التحميل التلقائي الأسماء على الملفات

```text
Namespace prefix "App" → directory "src/"
Class App\Models\User → file src/Models/User.php
Class App\Services\Mailer → file src/Services/Mailer.php
→ The autoloader resolves the class name to a path and includes it. No config per class.
```

## تحسين التحميل التلقائي

```bash
composer dump-autoload -o    # generate an OPTIMIZED classmap for production (faster)
```

## لماذا يهمّ هذا

Composer أساسي لـ PHP الحديث — إنه كيف تدير تقريباً كل مشاريع PHP الاعتماديات وتحمّل الفئات، لذا فهم هذا ضروري لأي تطوير PHP معاصر.

دوراه اثنان كلاهما حرج: كـ **مدير اعتماديات**، فهو يثبّت وينظّم إصدارات حزم الطرف الثالث والأطر العمل (Laravel و Symfony و Guzzle وغيرها) التي تعتمد عليها التطبيقات الحقيقية، حيث يعلّن `composer.json` الاعتماديات و `composer.lock` يضمن تثبيتات قابلة للتكرار (التزمْ به، مثل أي ملف قفل، للإصدارات المتسقة عبر الفريق والإنتاج).

كـ **محمّل تلقائي**، فهو يقضي على الممارسة القديمة الخطأ المتمثلة في `require` يدوي لكل ملف فئة — بدلاً من ذلك، بيان `require "vendor/autoload.php"` واحد يمكّن الفئات من التحميل التلقائي عند الطلب عبر **PSR-4** (ربط namespaces بالمجلدات).

هذا التحميل التلقائي، مقترناً بـ namespaces، هو أساس بنية مشاريع PHP الحديثة.

نظراً لأنك لا يمكنك استخدام أي إطار عمل أو حزمة PHP حديثة بدون Composer، وبما أن التحميل التلقائي هو كيف ينظّم ويُحمّل كل كود PHP حديث، فإن فهم Composer (إدارة الاعتماديات وملف القفل و PSR-4 والتحميل التلقائي و `vendor/autoload.php` للتمهيد) ضروري لا غنى عنه، معرفة يومية لتطوير PHP احترافي — إنه أساسي لـ PHP مثلما npm أساسي لـ Node.js.