كيف تعمل الهجرات والمزارعون؟

Question

Accepted Answer

**الهجرات** (Migrations) هي تعريفات للمخطط الخاص بك تحت التحكم بالإصدارات (إنشاء/تعديل الجداول) مكتوبة بلغة PHP، لذلك يتم تتبع تغييرات المخطط مع الكود وقابلة للتكرار عبر البيئات المختلفة. **المزارعون** (Seeders) يملأون قاعدة البيانات ببيانات الاختبار أو البيانات الافتراضية.

## هجرة واحدة

```php
<?php
// generate: php artisan make:migration create_users_table
return new class extends Migration {
    public function up(): void {        // apply the change
        Schema::create('users', function (Blueprint $table) {
            $table->id();                          // auto-increment primary key
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();                   // created_at + updated_at
        });
    }
    public function down(): void {       // reverse the change (rollback)
        Schema::dropIfExists('users');
    }
};
```

تحدد دالة `up()` في الهجرة التغيير في المخطط (باستخدام مُنشئ `Schema`)، وتعكسه `down()`. تكتب المخطط في PHP وليس SQL — وهو مستقل عن قاعدة البيانات.

## تشغيل الهجرات

```bash
php artisan migrate              # apply all pending migrations
php artisan migrate:rollback     # undo the last batch (uses down())
php artisan migrate:fresh         # drop everything and re-run all (dev)
php artisan make:migration add_phone_to_users   # a new migration to alter a table
```

الهجرات **محفوظة في التحكم بالإصدارات**، لذلك يصل كل مطور وCI وبيئة الإنتاج إلى نفس المخطط بتشغيل `migrate` — قابل للتكرار وودود للفريق.

## المزارعون — ملء البيانات

```php
class DatabaseSeeder extends Seeder {
    public function run(): void {
        User::factory()->count(50)->create();        // 50 fake users via a factory
        User::create(['name' => 'Admin', 'email' => 'admin@x.com']);
    }
}
// run with: php artisan db:seed
```

يملأ المزارعون قاعدة البيانات ببيانات افتراضية أو بيانات اختبار. يتزاوجون مع **المصانع** (Factories) (التي تنشئ بيانات مزيفة واقعية) — لا غنى عنها للتطوير والاختبار.

## لماذا يهم

الهجرات والمزارعون ضروريون للعمل مع طبقة قاعدة البيانات في Laravel بطريقة احترافية وودودة للفريق. **الهجرات** تحل المشكلة الحرجة المتمثلة في الحفاظ على مخطط قاعدة البيانات متزامناً مع الكود: بتحديد تغييرات المخطط كملفات PHP تحت التحكم بالإصدارات، فإنها تجعل تطور المخطط **قابلاً للتكرار** (كل بيئة — آلة كل مطور، CI، الإنتاج — تصل إلى نفس المخطط بتشغيل `migrate`)، **قابلاً للتتبع** (يتم مراجعة التغييرات في طلبات السحب جنباً إلى جنب مع الكود)، و**آمناً** (كتابة المخطط في PHP بدلاً من SQL اليدوي، مع طرق `down()` قابلة للعكس).

هذا يلغي الانجراف في المخطط والبيئات غير المتسقة — مصدر شائع للأخطاء. **المزارعون** (مع المصانع التي تنشئ بيانات مزيفة واقعية) يملأون قاعدة البيانات للتطوير والاختبار، مما يسهل العمل مع بيانات واقعية وإعداد سيناريوهات الاختبار.

فهم سير عمل الهجرة (`make:migration`، `migrate`، `rollback`)، أن الهجرات محفوظة في التحكم بالإصدارات لضمان التكرار، وكيفية ملء البيانات باستخدام المزارعين/المصانع هو معرفة أساسية يومية لأي مشروع Laravel حقيقي — إنها الطريقة التي تطور بها الفرق مخطط قاعدة البيانات التعاوني والموثوق وإعداد البيانات للتطوير والاختبارات، مما يجعلها مادة أساسية لتطوير Laravel الاحترافي.