如何在Laravel中高效发送短信通知？LaravelMessageBirdChannel助你轻松搞定！-composer-PHP中文网

如何在Laravel中高效发送短信通知？LaravelMessageBirdChannel助你轻松搞定！

碧海醫心

发布： 2025-10-07 11:59:14

原创

121人浏览过

如何在laravel中高效发送短信通知？laravelmessagebirdchannel助你轻松搞定！

可以通过一下地址学习composer：学习地址

想象一下，你正在用Laravel构建一个全新的电商平台。其中一个核心功能是向客户发送订单确认短信。最初，你可能会考虑直接集成MessageBird的API。这意味着你需要编写大量自定义代码来处理API请求、管理API密钥、格式化消息以及解析响应。很快你就会发现，这种方法会导致逻辑分散、代码重复，并且当你需要更换短信服务商或添加更多通知类型时，会带来巨大的维护负担。你渴望一种更简洁、更符合Laravel哲学的方式来发送这些关键提醒，而不是每次都从头开始。

告别繁琐：Composer与MessageBird Channel的完美结合

好消息是，我们不必再为这些问题头疼！laravel-notification-channels/messagebird这个Composer包正是为解决此类痛点而生。它完美地扩展了Laravel强大的通知系统，让你能够以最少的代码，通过MessageBird服务发送SMS消息。借助Composer，我们可以轻而易举地将这个强大的解决方案引入到我们的项目中，从而节省宝贵的开发和维护时间。

如何使用：从安装到发送，步步为营

使用laravel-notification-channels/messagebird非常简单，只需几个步骤：

1. 注册MessageBird账户并获取Access Key

首先，你需要一个MessageBird账户。注册并登录后，在开发者部分创建一个新的access_key，这是我们与MessageBird API通信的凭证。

2. 使用Composer安装包

通过Composer，我们可以轻松地将这个包添加到Laravel项目中：

<code class="bash">composer require laravel-notification-channels/messagebird</code>

登录后复制

如果你使用的是Laravel 5.4或更低版本，还需要手动在config/app.php中添加服务提供者：

<pre class="brush:php;toolbar:false;">// config/app.php
'providers' => [
    // ... 其他服务提供者
    NotificationChannels\Messagebird\MessagebirdServiceProvider::class,
],

登录后复制

3. 配置MessageBird服务

接下来，我们需要在Laravel中配置MessageBird的凭证。在config/services.php文件中添加MessageBird的配置项：

<pre class="brush:php;toolbar:false;">// config/services.php
return [
    // ... 其他服务配置
    'messagebird' => [
        'access_key' => env('MESSAGEBIRD_ACCESS_KEY'),
        'originator' => env('MESSAGEBIRD_ORIGINATOR'), // 短信发送方名称或号码
        'recipients' => env('MESSAGEBIRD_RECIPIENTS'), // 默认接收方（可选）
    ],
];

登录后复制

然后在你的.env文件中填入相应的环境变量：

<pre class="brush:php;toolbar:false;"># .env
MESSAGEBIRD_ACCESS_KEY=your_messagebird_access_key
MESSAGEBIRD_ORIGINATOR=YourApp
MESSAGEBIRD_RECIPIENTS=+1234567890

登录后复制

请注意，originator（发送方）最多包含11个字母数字字符。

知我AI

一款多端AI知识助理，通过一键生成播客/视频/文档/网页文章摘要、思维导图，提高个人知识获取效率；自动存储知识，通过与知识库聊天，提高知识利用效率。

查看详情

4. 创建并发送通知

现在，你可以像发送任何其他Laravel通知一样，通过MessageBird通道发送短信了。

首先，创建一个通知类（例如 VpsServerOrdered）：

<pre class="brush:php;toolbar:false;">// app/Notifications/VpsServerOrdered.php
<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use NotificationChannels\Messagebird\MessagebirdChannel;
use NotificationChannels\Messagebird\MessagebirdMessage;
use Illuminate\Notifications\Notification;

class VpsServerOrdered extends Notification
{
    use Queueable;

    protected $serviceName;

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

    /**
     * 获取通知的发送通道。
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return [MessagebirdChannel::class];
    }

    /**
     * 将通知转换为MessageBird消息。
     *
     * @param  mixed  $notifiable
     * @return \NotificationChannels\Messagebird\MessagebirdMessage
     */
    public function toMessagebird($notifiable)
    {
        return (new MessagebirdMessage("您的 {$this->serviceName} 服务已成功订购！"));
    }
}

登录后复制

你可以通过setRecipients()方法指定接收者（单个号码或数组），或者通过setReference()添加一个参考ID，以便追踪短信状态报告：

<pre class="brush:php;toolbar:false;">// 在 toMessagebird 方法中
public function toMessagebird($notifiable)
{
    $recipients = $notifiable->phone_number; // 假设notifiable模型有phone_number字段
    $orderId = $notifiable->order_id; // 假设notifiable模型有order_id字段

    return (new MessagebirdMessage("您的 {$this->serviceName} 服务已成功订购！"))
                ->setRecipients($recipients)
                ->setReference($orderId);
}

登录后复制

最后，在你需要发送通知的地方，调用notify()方法即可：

<pre class="brush:php;toolbar:false;">// 例如，在控制器或服务中
use App\Notifications\VpsServerOrdered;
use App\Models\User; // 假设你的用户模型

$user = User::find(1); // 获取需要通知的用户
$user->notify(new VpsServerOrdered('VPS Server Pro'));

登录后复制

总结：优势与实际应用效果

laravel-notification-channels/messagebird彻底改变了在Laravel中处理短信通知的方式。它将复杂的自定义集成转化为简洁、符合框架规范的操作。这不仅大大加快了开发速度，也让你的通知逻辑更加清晰、易于维护和扩展。你将获得MessageBird可靠的短信投递服务，同时享受Laravel优雅的通知系统带来的便利。

通过这个包，我们能够：