Laravel Events

1. Laravel Events

1. 1. مقدمة

في تطوير تطبيقات الويب الحديثة، غالباً ما نحتاج إلى فصل منطق التطبيق لجعله أكثر قابلية للصيانة والتوسع. يوفر إطار عمل Laravel أدوات قوية لتحقيق هذا الهدف، ومن بين هذه الأدوات نظام الأحداث (Events). نظام الأحداث يسمح لك بإرسال إشعارات عندما تحدث أحداث معينة في تطبيقك، ويمكن لمستمعين (Listeners) مختلفين الاستجابة لهذه الإشعارات وتنفيذ إجراءات محددة. هذا النمط التصميمي، المعروف أيضاً باسم نمط المراقب (Observer Pattern)، يعزز بشكل كبير من مرونة التطبيق وقابليته للتوسع.

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

1. 1. ما هي الأحداث (Events) والمستمعون (Listeners)؟

1. 1. 1. الأحداث (Events)

الحدث هو إشارة أو إشعار يتم إرساله عندما يحدث شيء مهم في تطبيقك. يمكن أن يكون هذا "شيئاً" أي شيء، مثل إنشاء مستخدم جديد، تحديث سجل في قاعدة البيانات، إرسال بريد إلكتروني، أو حتى حدث مخصص يتعلق بمنطق عملك الخاص. الأحداث لا تحتوي على منطق معالجة بذاتها؛ بل هي مجرد إشعارات. فكر في الأمر كإشارة تحذيرية توضع في مكان ما، ولا تفعل شيئاً بمفردها.

1. 1. 1. المستمعون (Listeners)

المستمع هو فئة (Class) تستمع إلى أحداث معينة، وعندما يتم إطلاق هذا الحدث، يقوم المستمع بتنفيذ طريقة (Method) محددة لمعالجة الحدث. يمكن أن يكون لديك العديد من المستمعين يستمعون إلى نفس الحدث، وكل منهم يقوم بتنفيذ إجراء مختلف. هذا يسمح لك بفصل منطق المعالجة عن منطق إطلاق الحدث، مما يجعل تطبيقك أكثر مرونة. فكر في المستمعين كأشخاص ينتظرون سماع إشارة التحذيرية، وعندما يسمعونها، يتخذون إجراءً.

1. 1. إنشاء الأحداث والمستمعين

1. 1. 1. إنشاء حدث (Event)

لإنشاء حدث في Laravel، استخدم الأمر `make:event`:

```bash php artisan make:event UserRegistered ```

سيقوم هذا الأمر بإنشاء ملف جديد باسم `UserRegistered.php` في مجلد `app/Events`. هذا الملف يحتوي على فئة الحدث الأساسية. عادةً ما تقوم بتوسيع فئة `Illuminate\Foundation\Events\Dispatchable`، والتي توفر وظائف إطلاق الحدث. يمكنك أيضاً إضافة خصائص إلى فئة الحدث لحمل البيانات المتعلقة بالحدث. مثال:

```php <?php

namespace App\Events;

use Illuminate\Foundation\Events\Dispatchable; use Illuminate\Broadcasting\InteractsWithSockets; use Contracts\Queue\ShouldQueue; use App\Models\User;

class UserRegistered {

   use Dispatchable, InteractsWithSockets, ShouldQueue;

   public $user;

   public function __construct(User $user)
   {
       $this->user = $user;
   }

} ```

في هذا المثال، قمنا بتعريف حدث `UserRegistered` يحمل كائن `User` كبيانات. `ShouldQueue` تعني أن هذا الحدث سيتم وضعه في قائمة الانتظار للمعالجة في الخلفية، مما يحسن من أداء التطبيق.

1. 1. 1. إنشاء مستمع (Listener)

لإنشاء مستمع للاستماع إلى حدث معين، استخدم الأمر `make:listener`:

```bash php artisan make:listener SendWelcomeEmail --event=UserRegistered ```

سيقوم هذا الأمر بإنشاء ملف جديد باسم `SendWelcomeEmail.php` في مجلد `app/Listeners`. هذا الملف يحتوي على فئة المستمع الأساسية. يجب أن تحتوي فئة المستمع على طريقة `handle`، والتي يتم استدعاؤها عندما يتم إطلاق الحدث الذي يستمع إليه المستمع. مثال:

```php <?php

namespace App\Listeners;

use App\Events\UserRegistered; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Support\Facades\Mail; use App\Mail\WelcomeEmail;

class SendWelcomeEmail {

   /**
    * Create the event listener.
    *
    * @return void
    */
   public function __construct()
   {
       //
   }

   /**
    * Handle the event.
    *
    * @param  UserRegistered  $event
    * @return void
    */
   public function handle(UserRegistered $event)
   {
       Mail::send(new WelcomeEmail($event->user));
   }

} ```

في هذا المثال، قمنا بتعريف مستمع `SendWelcomeEmail` يستمع إلى حدث `UserRegistered`. عندما يتم إطلاق هذا الحدث، تقوم طريقة `handle` بإرسال بريد إلكتروني ترحيبي للمستخدم الجديد باستخدام فئة البريد `WelcomeEmail`.

1. 1. تسجيل وتفعيل الأحداث والمستمعين

1. 1. 1. تسجيل المستمعين

بعد إنشاء المستمعين، يجب تسجيلهم في ملف `EventServiceProvider.php` الموجود في مجلد `app/Providers`. في هذا الملف، يوجد خاصية `$listen` وهي عبارة عن مصفوفة تربط الأحداث بالمستمعين. أضف المستمع الخاص بك إلى هذه المصفوفة:

```php public function boot() {

   parent::boot();

   Event::listen(UserRegistered::class, \App\Listeners\SendWelcomeEmail::class);

} ```

هذا السطر يخبر Laravel أنه عندما يتم إطلاق حدث `UserRegistered`، يجب استدعاء طريقة `handle` في فئة `SendWelcomeEmail`.

1. 1. 1. إطلاق الأحداث

لإطلاق حدث في تطبيقك، استخدم طريقة `event()` أو `dispatch()`:

• `event()`: يطلق الحدث بشكل متزامن (synchronously). هذا يعني أن الكود سينتظر حتى يتم معالجة جميع المستمعين قبل المتابعة.
• `dispatch()`: يطلق الحدث بشكل غير متزامن (asynchronously) باستخدام قائمة الانتظار (queue). هذا يعني أن الحدث سيتم وضعه في قائمة الانتظار، وسيتم معالجته في الخلفية.

مثال:

```php public function store(Request $request) {

   $user = User::create($request->all());

   event(new UserRegistered($user)); // إطلاق الحدث بشكل متزامن

   // أو

   dispatch(new UserRegistered($user)); // إطلاق الحدث بشكل غير متزامن

} ```

في هذا المثال، بعد إنشاء مستخدم جديد، يتم إطلاق حدث `UserRegistered` مع تمرير كائن المستخدم كبيانات.

1. 1. استخدامات متقدمة

1. 1. 1. الأحداث المخصصة (Custom Events)

يمكنك إنشاء أحداث مخصصة لتلبية احتياجات تطبيقك الخاصة. فقط قم بإنشاء فئة حدث جديدة وقم بتعريف البيانات التي تريد تمريرها مع الحدث.

1. 1. 1. المستمعون الديناميكيون (Dynamic Listeners)

يمكنك تسجيل المستمعين ديناميكياً في وقت التشغيل باستخدام طريقة `Event::listen()` أو `Event::subscribe()`. هذا يسمح لك بتغيير سلوك التطبيق بناءً على الظروف.

1. 1. 1. استخدام الأحداث في سياقات مختلفة

• **تسجيل الأنشطة:** يمكنك استخدام الأحداث لتسجيل جميع الأنشطة الهامة في تطبيقك، مثل إنشاء المستخدمين، تعديل البيانات، وتسجيل الدخول.
• **إرسال الإشعارات:** يمكنك استخدام الأحداث لإرسال إشعارات للمستخدمين أو المسؤولين عندما تحدث أحداث معينة.
• **تنفيذ مهام الخلفية:** يمكنك استخدام الأحداث لتشغيل مهام الخلفية، مثل معالجة الصور أو إرسال رسائل البريد الإلكتروني.
• **تكامل مع خدمات خارجية:** يمكنك استخدام الأحداث لدمج تطبيقك مع خدمات خارجية، مثل خدمات الدفع أو خدمات التحليل.

1. 1. الأحداث في سياق الخيارات الثنائية

في عالم الخيارات الثنائية، الوقت هو الجوهر. الاستجابة السريعة للتغيرات في السوق يمكن أن تعني الفرق بين الربح والخسارة. يمكن تشبيه الأحداث في Laravel بأحداث السوق الحقيقية.

• **حدث:** حركة سعرية كبيرة، اختراق مستوى دعم أو مقاومة، صدور خبر اقتصادي.
• **مستمع:** استراتيجية تداول آلية، روبوت تداول، تنبيه للمتداول.

عندما يحدث حدث سوقي، يجب أن يستجيب المستمع (استراتيجية التداول) بسرعة لتنفيذ الصفقة. نظام الأحداث في Laravel يمكن أن يساعد في بناء مثل هذه الأنظمة. على سبيل المثال:

• **حدث:** `PriceBreakout` (اختراق سعر).
• **مستمع:** `ExecuteTrade` (تنفيذ صفقة).

عندما يتم إطلاق حدث `PriceBreakout` (عندما يخترق السعر مستوى محدد)، يقوم المستمع `ExecuteTrade` بتنفيذ صفقة بناءً على معايير محددة مسبقاً.

• • استراتيجيات مرتبطة:**

• **استراتيجية الاختراق:** تستخدم الأحداث لتحديد نقاط الاختراق وتنفيذ الصفقات.
• **استراتيجية الأخبار:** تستخدم الأحداث لتتبع الأخبار الاقتصادية وتنفيذ الصفقات بناءً على تأثير الأخبار على السوق.
• **استراتيجية المتوسطات المتحركة:** يمكن استخدام الأحداث لتتبع تقاطعات المتوسطات المتحركة وتنفيذ الصفقات.
• **استراتيجية بولينجر باند:** تستخدم الأحداث لتحديد حالات الخروج عن النطاق وتنفيذ الصفقات.
• **استراتيجية RSI:** تستخدم الأحداث لتحديد حالات الشراء المفرط والبيع المفرط وتنفيذ الصفقات.

• • تحليل فني:**

• **مستويات الدعم والمقاومة:** الأحداث يمكن أن تُطلق عند اختراق هذه المستويات.
• **خطوط الاتجاه:** الأحداث يمكن أن تُطلق عند كسر خطوط الاتجاه.
• **أنماط الشموع:** الأحداث يمكن أن تُطلق عند ظهور أنماط شموع معينة.

• • تحليل حجم التداول:**

• **زيادة حجم التداول:** يمكن أن يكون حدثاً يشير إلى بداية اتجاه جديد.
• **انخفاض حجم التداول:** يمكن أن يكون حدثاً يشير إلى نهاية اتجاه.

• • المؤشرات:**

• **RSI (مؤشر القوة النسبية):** الأحداث يمكن أن تُطلق عند تجاوز مستويات معينة.
• **MACD (مؤشر التقارب والتباعد للمتوسطات المتحركة):** الأحداث يمكن أن تُطلق عند حدوث تقاطعات.
• **Stochastic Oscillator (مذبذب ستوكاستيك):** الأحداث يمكن أن تُطلق عند تجاوز مستويات معينة.

• • الاتجاهات:**

• **الاتجاه الصاعد:** الأحداث يمكن أن تُطلق عند تأكيد الاتجاه الصاعد.
• **الاتجاه الهابط:** الأحداث يمكن أن تُطلق عند تأكيد الاتجاه الهابط.
• **الاتجاه الجانبي:** الأحداث يمكن أن تُطلق عند تحديد نطاق التداول الجانبي.

• • أسماء استراتيجيات الخيارات الثنائية:**

• **60 Second Strategy:** تتطلب استجابة سريعة للأحداث.
• **Binary Options Scalping:** تعتمد على استغلال الأحداث الصغيرة في السوق.
• **Trend Following Strategy:** تستخدم الأحداث لتحديد بداية ونهاية الاتجاهات.
• **News Trading Strategy:** تعتمد على الاستجابة للأخبار الاقتصادية.
• **Straddle Strategy:** تستخدم الأحداث لتحديد حالات التقلب العالي.
• **Butterfly Spread:** تتطلب مراقبة دقيقة للأحداث.

1. 1. الخلاصة

نظام الأحداث في Laravel هو أداة قوية لفصل منطق التطبيق وتحسين قابليته للصيانة والتوسع. من خلال فهم المفاهيم الأساسية وكيفية استخدامها، يمكنك بناء تطبيقات Laravel أكثر مرونة وفعالية. كما رأينا، يمكن تطبيق هذه المفاهيم في سياقات مختلفة، بما في ذلك عالم الخيارات الثنائية، حيث الاستجابة السريعة للأحداث هي المفتاح للنجاح. تذكر دائماً أن التخطيط الجيد والتصميم المدروس هما أساس أي تطبيق ناجح. استخدم نظام الأحداث بحكمة لتحسين أداء تطبيقك وتحقيق أهدافك.

EventServiceProvider Dispatchable Trait Queue Mail Contracts\Queue\ShouldQueue Illuminate\Foundation\Events\Dispatchable Laravel PHP MVC (Model-View-Controller) Artisan Console Dependency Injection Testing in Laravel Laravel Documentation Laravel Eloquent Laravel Routing Laravel Middleware Laravel Blade Laravel Authentication Laravel Authorization Laravel Validation Laravel Caching Laravel Sessions Laravel Database Migrations Laravel Queues Laravel Notifications Laravel Broadcasting Laravel Telescope Laravel Horizon Laravel Sanctum Laravel Passport Laravel Mix Laravel Nova Laravel Forge Laravel Vapor

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

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

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

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