خبرة developer

Laravel SMS Maroc : Notification Channel et Tutoriel في المغرب - دليل وأفضل الممارسات

دليل تقني وأفضل الممارسات حول Laravel SMS Maroc : Notification Channel et Tutoriel في المغرب مع مسارات مباشرة لمشغلي الاتصالات.

آخر تحديث: 8 يوليو 2026

Laravel SMS Maroc : Notification Channel et Tutoriel في المغرب - دليل وأفضل الممارسات

القسم 1: 1. L'Architecture des Notifications dans Laravel

في المغرب، يتطلب إرسال الرسائل الموثوقة استخدام مسارات مباشرة مع مشغلي الاتصالات (اتصالات المغرب، إنوي، أورنج) والامتثال للأنظمة المحلية. Le framework PHP Laravel intègre nativement un système de notifications extrêmement puissant capable de distribuer des alertes sur différents canaux (Mail, Database, Slack). Pour envoyer des SMS via EnvoiSMS.ma de manière idiomatique, la meilleure pratique consiste à créer un canal de notification personnalisé (Custom Notification Channel). Cela sépare proprement la logique d'envoi technique de la logique métier de votre application.

القسم 2: 2. Créer le Custom Notification Channel dans Laravel

في المغرب، يتطلب إرسال الرسائل الموثوقة استخدام مسارات مباشرة مع مشغلي الاتصالات (اتصالات المغرب، إنوي، أورنج) والامتثال للأنظمة المحلية. Vous devez créer une classe Channel qui prendra en charge la requête HTTP vers notre API REST. Voici l'implémentation propre de ce service :

// app/Channels/EnvoiSmsChannel.php
namespace App\Channels;

use Illuminate\Notifications\Notification;
use Illuminate\Support\Facades\Http;

class EnvoiSmsChannel
{
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toEnvoiSms($notifiable);
        $to = $notifiable->routeNotificationFor('EnvoiSms') ?? $notifiable->phone;

        if (!$to) return;

        Http::withHeaders([
            'Authorization' => 'Bearer ' . config('services.envoisms.key'),
            'Content-Type' => 'application/json',
        ])->post('https://api.envoisms.ma/v1/messages', [
            'to' => $to,
            'body' => $message['body'],
            'sender' => $message['sender'] ?? 'ShopMaroc',
        ]);
    }
}

القسم 3: 3. Définir la Notification et activer les files d'attente (Queues)

في المغرب، يتطلب إرسال الرسائل الموثوقة استخدام مسارات مباشرة مع مشغلي الاتصالات (اتصالات المغرب، إنوي، أورنج) والامتثال للأنظمة المحلية. Pour éviter de ralentir la navigation de vos utilisateurs en attendant la réponse HTTP de l'opérateur, implémentez l'interface ShouldQueue. Laravel va automatiquement sérialiser la notification et la distribuer en tâche de fond (via Redis, database ou SQS) :

// app/Notifications/OrderShippedNotification.php
namespace App\Notifications;

use App\Channels\EnvoiSmsChannel;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Notification;

class OrderShippedNotification extends Notification implements ShouldQueue
{
    use Queueable;

    protected $orderId;

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

    public function via($notifiable) {
        return [EnvoiSmsChannel::class];
    }

    public function toEnvoiSms($notifiable) {
        return [
            'body' => "Votre commande #" . $this->orderId . " a ete expediee ! Suivi : secure.shop.ma/track",
            'sender' => 'ShopMaroc'
        ];
    }
}

القسم 4: 4. Écouter les Webhooks DLR de livraison

في المغرب، يتطلب إرسال الرسائل الموثوقة استخدام مسارات مباشرة مع مشغلي الاتصالات (اتصالات المغرب، إنوي، أورنج) والامتثال للأنظمة المحلية. Configurez une route de webhook dans Laravel pour recevoir les accusés de réception. Notre passerelle envoie un payload JSON contenant l'état final de la livraison. Validez la signature HMAC dans un middleware dédié pour sécuriser votre endpoint de webhook.

💡 لماذا تختار EnvoiSMS لشركتك؟

⚡

توصيل فوري

أقل من 4 ثوانٍ لرموز التحقق OTP عبر قنوات مباشرة مع شركات الاتصالات IAM و Inwi و Orange Maroc.

💰

تحسين الميزانية

واجهة برمجة تطبيقات WhatsApp Business بـ 0.45 درهم لكل رسالة. أفضل عائد على الاستثمار.

🛡️

سيادة البيانات (CNDP)

استضافة متوافقة مع لوائح حماية البيانات الشخصية المحلية المغربية.

الأسئلة الشائعة

Comment valider le numéro de téléphone dans le modèle Notifiable ? (AR)

Ajoutez une méthode `routeNotificationForEnvoiSms` dans votre modèle User pour renvoyer le numéro de téléphone formaté au format international +212.

Puis-je simuler l'envoi de SMS lors de mes tests automatisés ? (AR)

Oui. Dans vos tests Laravel, utilisez `Notification::fake()` pour intercepter les envois et vérifier qu'une notification a bien été envoyée sans réellement consommer de crédits.

Comment gérer les échecs de requêtes HTTP vers l'API ? (AR)

Laravel gère nativement les retries dans les files d'attente. Vous pouvez configurer `$tries = 3` dans votre job de file d'attente pour réessayer automatiquement en cas de timeout.

مقالات مقترحة

developer

Authentification 2FA & OTP SMS en NodeJS (Maroc) : Guide Technique في المغرب - دليل وأفضل الممارسات

developer

Authentification 2FA & OTP SMS en PHP (Laravel) (Maroc) : Guide Technique في المغرب - دليل وأفضل الممارسات

developer

Laravel SMS Maroc : Notification Channel et Tutoriel في المغرب - دليل وأفضل الممارسات

القسم 1: 1. L'Architecture des Notifications dans Laravel

القسم 2: 2. Créer le Custom Notification Channel dans Laravel

القسم 3: 3. Définir la Notification et activer les files d'attente (Queues)

القسم 4: 4. Écouter les Webhooks DLR de livraison

💡 لماذا تختار EnvoiSMS لشركتك؟

توصيل فوري

تحسين الميزانية

سيادة البيانات (CNDP)

مقالات مقترحة

Authentification 2FA & OTP SMS en NodeJS (Maroc) : Guide Technique في المغرب - دليل وأفضل الممارسات

Authentification 2FA & OTP SMS en PHP (Laravel) (Maroc) : Guide Technique في المغرب - دليل وأفضل الممارسات

Authentification 2FA & OTP SMS en Python (FastAPI) (Maroc) : Guide Technique في المغرب - دليل وأفضل الممارسات