Notifire + FCM مع Laravel

سبتمبر 13, 2025

لو محتاج تبعت إشعارات Push من تطبيق Laravel سواء للموبايل أو للويب، فالحل الأسرع والأبسط هو إنك تستخدم Notifire اللي بيربط Laravel مباشرةً مع Firebase Cloud Messaging (FCM). الميزة الأساسية إنك مش محتاج تخرج بره نظام الـ Notifications الأصلي في لارافيل، وبتشتغل بكل الأدوات اللي إنت متعود عليها.

إيه هي Notifire وليه نستخدمها؟

Notifire عبارة عن باكدج مخصص للربط مع خدمة FCM. تقدر تبعت رسائل تنبيه بمحتوى بسيط أو متقدّم (عنوان، نص، صورة، أيقونة، صوت، أكشن…). كمان بيوفرلك إدارة للتوكنز الخاصة بالأجهزة المختلفة، وبيسهل موضوع تسجيلها وتخزينها في قاعدة البيانات.

المتطلبات الأساسية

قبل ما تبدأ، لازم يكون عندك Project على Firebase مفعّل، وتحمّل ملف Service Account وتخزّنه في مكان آمن زي storage/firebase.json. كمان محتاج Laravel Sanctum لأن عملية تسجيل التوكنات مربوطة بيه.

خطوات التثبيت

التثبيت بيتم في 3 أوامر رئيسية:

composer require devkandil/notifire
php artisan vendor:publish --provider="DevKandil\NotiFire\FcmServiceProvider"
php artisan migrate

إدارة التوكنات

الحزمة بتديك Trait تقدر تضيفه على موديل المستخدم علشان تدير الـ FCM Tokens. ودي نقطة مهمة جدًا لأن كل إشعار محتاج يروح لتوكن جهاز معين. الأفضل كمان تعمل جدول للأجهزة لو عندك يوزر بيدخل من أكتر من مكان.

تسجيل التوكن من الفرونت

Notifire بيضيفلك Endpoint جاهز اسمه POST /fcm/token، ومربوط بـ Sanctum بشكل مباشر. أي جهاز (ويب أو موبايل) هيولّد توكن من Firebase، هيبعت التوكن للسيرفر عندك علشان يتخزن ويرتبط بالمستخدم.

إرسال الإشعارات

عندك طريقتين: يا إمّا تستخدم الـ Facade مباشرة، أو تشتغل بالطريقة الرسمية بتاعة Laravel Notifications. في الحالتين بتقدر تضيف عنوان، نص، صورة، بيانات إضافية (data) وكمان تحدد الأولوية.

$ok = Fcm::withTitle('تنبيه جديد')
    ->withBody('فيه تحديث في حسابك')
    ->sendNotification($token);

أفضل الممارسات

- شغّل الإرسال دايمًا عن طريق queues علشان متبطّأش التطبيق.
- خزّن بيانات Firebase في مكان آمن بعيد عن Git.
- اعمل Rotation للتوكنات البايظة أو بعد الـ Logout.
- خطط لاستخدام Topics لو عندك Segments كبيرة من المستخدمين.

أخطاء شائعة

- لو الإشعارات مش بتوصل: راجع صلاحيات Service Worker على الويب أو جرّب إعادة تسجيل التوكن.
- لو فيه خطأ 401/403 على /fcm/token: يبقى غالبًا مشكلة في Sanctum أو التوكن ناقص.
- بطء في الإرسال: لازم تستخدم Workers وتفصل عملية الإرسال عن الـ UI.

الخلاصة

Notifire بتخلّي تكامل Laravel مع FCM عملية منظمة وبسيطة. بمجرد ما تظبط التوكنات وتربطها مع المستخدمين، وتستخدم الـQueues بشكل صح، هتقدر تبني نظام إشعارات قوي وموثوق للتطبيق بتاعك سواء على الموبايل أو الويب.

المدونة

إزاي OAuth بيشتغل

يونيو 29, 2025

إزاي OAuth بيشتغل؟ OAuth هو بروتوكول بيخلّي التطبيقات تقدر تدخل على بياناتك بطريقة آمنة من غير ما تدّيهم الباسورد بتاعك. زي مثلًا لو حبيت تطبيق ينشر...

نظام طوابير Laravel واستخدام Supervisor في الإنتاج

يوليو 01, 2025

🚀 نظام Queue & Jobs في Laravel هناخدك خطوة خطوة من أول إنشاء الجداول لحد ما تشغّل الطوابير في Production عن طريق Supervisor. الخطوة 1: إنشاء...

استكشف أقوى تقنيات Laravel الحديثة: Inertia.js، View Creators، وHLS خطوة بخطوة

يوليو 27, 2025

أدوات قوية تقدر تستخدمها لتطوير تطبيقات Laravel بشكل احترافي: Inertia.js v2، وView Creators، وحزمة Laravel HLS لبث الفيديوهات بأمان. ١. Inertia.j...

نظرة معمقة على Laravel Context: تسجيل وتحليل السياق البرمجي باحترافية

يوليو 20, 2025

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

حلل مشروع Laravel بـ Introspect

يوليو 01, 2025

حلل كود Laravel باستخدام Laravel Introspect لو بتعمل Refactor كبير أو بتبني أدوات Dev‪، Laravel Introspect بيسمحلك تستعلم عن الكود: فيوز، مودلز، رو...

تذكير بالمهام مع Laravel وMongoDB

يونيو 30, 2025

📌 بناء تطبيق تذكير مهام المقال ده بيشرح إزاي نعمل تطبيق Laravel يستخدم MongoDB علشان يذكرك بالمهمات بتاعتك، مع تسجيل دخول، CRUD، وتذكير بالإيميلات...