Doctrine Migrations

1. 1. Doctrine Migrations: دليل شامل للمطورين المبتدئين

Doctrine Migrations هي أداة قوية لإدارة [تغييرات مخطط قاعدة البيانات](https://www.doctrine-project.org/projects/migrations/en/latest/tutorials/basic-usage.html) في مشاريع PHP التي تستخدم مكتبة Doctrine ORM. تتيح لك هذه الأداة تطبيق التغييرات على مخطط قاعدة البيانات بطريقة منظمة وقابلة للتكرار، مما يضمن سهولة التعاون بين المطورين وتجنب المشاكل المحتملة عند نشر التطبيق على بيئات مختلفة. هذا المقال موجه للمبتدئين ويشرح المفاهيم الأساسية لـ Doctrine Migrations وكيفية استخدامها.

لماذا نستخدم Doctrine Migrations؟

بدون أداة لإدارة التغييرات، قد يواجه المطورون صعوبات في الحفاظ على تناسق مخطط قاعدة البيانات عبر البيئات المختلفة (تطوير، اختبار، إنتاج). قد يؤدي إجراء تغييرات يدوية على قاعدة البيانات إلى أخطاء، خاصة في المشاريع الكبيرة التي يعمل عليها عدة مطورين. Doctrine Migrations تحل هذه المشاكل من خلال:

• التحكم في الإصدارات: كل تغيير على مخطط قاعدة البيانات يتم تسجيله كـ "هجرة" (Migration)، مما يسمح لك بتتبع التغييرات والتراجع عنها إذا لزم الأمر.
• التكرار: يمكنك تطبيق نفس مجموعة الهجرات على أي بيئة، مما يضمن أن مخطط قاعدة البيانات متطابق.
• التعاون: يمكن للمطورين العمل على تغييرات مختلفة في مخطط قاعدة البيانات بشكل متزامن دون التسبب في تعارضات.
• السهولة: توفر Doctrine Migrations واجهة سطر أوامر سهلة الاستخدام وأدوات لتوليد الهجرات تلقائيًا.

المفاهيم الأساسية

• الهجرة (Migration): ملف PHP يمثل تغييراً واحداً أو مجموعة من التغييرات على مخطط قاعدة البيانات. يحتوي على وظائف `up()` و `down()` لتطبيق التغييرات والتراجع عنها على التوالي.
• التكوين (Configuration): ملف يحدد كيفية عمل Doctrine Migrations، مثل مسار مجلد الهجرات، ومعلومات الاتصال بقاعدة البيانات.
• قاعدة البيانات (Database): نظام إدارة قواعد البيانات الذي تستخدمه، مثل MySQL, PostgreSQL, أو SQLite.
• الـ Schema (المخطط): هيكل قاعدة البيانات، بما في ذلك الجداول والأعمدة والفهارس والعلاقات.
• الـ Version (الإصدار): رقم تسلسلي يمثل ترتيب الهجرات. كل هجرة جديدة تحصل على رقم إصدار أعلى من الهجرات السابقة.

خطوات استخدام Doctrine Migrations

1. التثبيت: قم بتثبيت Doctrine Migrations باستخدام Composer:

   ```bash
   composer require doctrine/migrations
   ```

2. التكوين: قم بتكوين Doctrine Migrations في ملف `config/packages/doctrine_migrations.yaml` (أو ما يعادله في مشروعك). تأكد من تحديد معلومات الاتصال بقاعدة البيانات بشكل صحيح. راجع [[وثائق Doctrine Migrations](https://www.doctrine-project.org/projects/migrations/en/latest/reference/configuration.html) لمزيد من التفاصيل.

3. إنشاء الهجرة: استخدم الأمر `bin/console doctrine:migrations:diff` لإنشاء هجرة جديدة بناءً على التغييرات التي أجريتها على entities (كيانات) Doctrine. سيقوم هذا الأمر بمقارنة مخطط قاعدة البيانات الحالي بمخطط قاعدة البيانات المحدد في كياناتك، وإنشاء ملف هجرة يحتوي على التعليمات اللازمة لتحديث قاعدة البيانات.

4. تطبيق الهجرة: استخدم الأمر `bin/console doctrine:migrations:migrate` لتطبيق الهجرات المعلقة على قاعدة البيانات. سيقوم هذا الأمر بتنفيذ وظيفة `up()` في كل هجرة معلقة، مما يؤدي إلى تحديث مخطط قاعدة البيانات.

5. التراجع عن الهجرة: استخدم الأمر `bin/console doctrine:migrations:rollback` للتراجع عن آخر هجرة تم تطبيقها. سيقوم هذا الأمر بتنفيذ وظيفة `down()` في آخر هجرة، مما يؤدي إلى استعادة مخطط قاعدة البيانات إلى حالته السابقة.

أمثلة عملية

لنفترض أنك أضفت عمودًا جديدًا إلى كيان `Product`. بعد إجراء هذا التغيير، يمكنك إنشاء هجرة لتحديث قاعدة البيانات:

```bash bin/console doctrine:migrations:diff ```

سيقوم هذا الأمر بإنشاء ملف هجرة مشابه لما يلي:

```php <?php

declare(strict_types=1);

namespace DoctrineMigrations;

use Doctrine\DBAL\Schema\Schema; use Doctrine\Migrations\AbstractMigration;

/**

* Auto-generated Migration: Please modify to your needs!
*/

final class Version20231027100000 extends AbstractMigration {

   public function getDescription(): string
   {
       return ;
   }

   public function up(Schema $schema): void
   {
       // this up() migration is auto-generated, please modify it to your needs
       $this->addSql('ALTER TABLE product ADD COLUMN new_column VARCHAR(255) NOT NULL');
   }

   public function down(Schema $schema): void
   {
       // this down() migration is auto-generated, please modify it to your needs
       $this->addSql('ALTER TABLE product DROP COLUMN new_column');
   }

} ```

ثم قم بتطبيق الهجرة:

```bash bin/console doctrine:migrations:migrate ```

استراتيجيات متقدمة

• استخدام البيانات الأولية (Fixtures): يمكنك استخدام fixtures لملء قاعدة البيانات ببيانات اختبارية بعد تطبيق الهجرات.
• التحكم في الهجرات: يمكنك التحكم في أي الهجرات يتم تطبيقها عن طريق تحديد إصدارات معينة.
• البيئات المتعددة: يمكنك تكوين Doctrine Migrations لاستخدام ملفات تكوين مختلفة لكل بيئة.
• الـ Schema Diff: استخدم `doctrine:migrations:diff` بانتظام للتأكد من أن مخطط قاعدة البيانات الخاص بك متزامن مع كيانات Doctrine الخاصة بك.

أدوات إضافية وموارد تعليمية

• [[Doctrine DBAL](https://www.doctrine-project.org/projects/dbal.html)]
• [[Doctrine ORM](https://www.doctrine-project.org/projects/orm.html)]
• [[Symfony Console](https://symfony.com/doc/current/console.html)]
• [[Composer](https://getcomposer.org/)]
• [[تحليل الموجات إليوت](https://www.investopedia.com/terms/e/elliottwavetheory.asp)]
• [[مؤشر القوة النسبية (RSI)](https://www.investopedia.com/terms/r/rsi.asp)]
• [[التقاطع المتحرك المتوسط](https://www.investopedia.com/terms/m/movingaverage.asp)]
• [[خطوط فيبوناتشي](https://www.investopedia.com/terms/f/fibonacciretracement.asp)]
• [[أنماط الشموع اليابانية](https://www.investopedia.com/terms/c/candlestick.asp)]
• [[تحليل حجم التداول](https://www.investopedia.com/terms/v/volume.asp)]
• [[استراتيجية الاختراق](https://www.investopedia.com/terms/b/breakout.asp)]
• [[استراتيجية الارتداد](https://www.investopedia.com/terms/r/reversal.asp)]
• [[استراتيجية الاتجاه](https://www.investopedia.com/terms/t/trendtrading.asp)]
• [[استراتيجية التداول المتأرجح](https://www.investopedia.com/terms/s/swingtrading.asp)]
• [[استراتيجية فروق الأسعار](https://www.investopedia.com/terms/s/spreadtrading.asp)]
• [[استراتيجية المتوسط المتحرك](https://www.investopedia.com/terms/m/movingaverages.asp)]
• [[استراتيجية بولينجر باند](https://www.investopedia.com/terms/b/bollingerbands.asp)]
• [[تحليل MACD](https://www.investopedia.com/terms/m/macd.asp)]
• [[تحليل ستوكاستيك](https://www.investopedia.com/terms/s/stochasticoscillator.asp)]
• [[التحليل الفني الشامل](https://www.investopedia.com/terms/t/technicalanalysis.asp)]
• [[تحليل حجم التداول المتقدم](https://www.investopedia.com/articles/trading/04/032604.asp)]

باستخدام Doctrine Migrations، يمكنك إدارة تغييرات مخطط قاعدة البيانات الخاصة بك بكفاءة وموثوقية، مما يساهم في تطوير تطبيقات PHP عالية الجودة.

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين