如何将Laravel应用通知实时发送到Discord？使用laravel-notification-channels/discord轻松实现！

WBOY

发布时间：2025-07-21 13:26:24

554人浏览过

来源于php中文网

原创

Composer在线学习地址：学习地址

告别信息孤岛：为何我们需要将 Laravel 通知推送到 Discord？

想象一下这样的场景：你负责维护一个在线服务，深夜时分，系统突然出现异常，或者有用户提交了关键的反馈。如果这些信息只能通过传统的邮件或在后台系统中查看，你很可能会错过最佳处理时机。而如果这些通知能直接推送到团队成员都在的 discord 频道，是不是一切都变得更高效、更及时了？

手动编写代码来调用 Discord API 来发送消息，不仅繁琐，而且容易出错，尤其是在需要处理富文本、嵌入内容等复杂格式时。我们希望有一种“Laravel 式”的优雅解决方案，能够让我们像发送普通通知一样，轻松将消息推送到 Discord。

这就是 laravel-notification-channels/discord 这个 Composer 包的用武之地。它完美地将 Discord 的通知能力集成到了 Laravel 强大的通知系统中，让开发者能够以极低的成本，实现高效的团队协作和信息同步。

解决方案：`laravel-notification-channels/discord` 让一切变得简单

laravel-notification-channels/discord 是一个专门为 Laravel 设计的 Discord 通知驱动。它将复杂的 Discord Bot API 调用封装起来，让你能够像使用邮件、短信或其他通知渠道一样，通过 Laravel 的 Notification 系统发送消息到 Discord 频道或用户。

第一步：安装与配置

首先，我们需要通过 Composer 来安装这个包。打开你的终端，进入 Laravel 项目根目录，执行以下命令：

composer require laravel-notification-channels/discord

安装完成后，别忘了在 config/app.php 中注册其服务提供者：

// config/app.php
'providers' => [
    // ...
    NotificationChannels\Discord\DiscordServiceProvider::class,
],

接下来，你需要设置你的 Discord Bot。

创建 Discord 应用和 Bot 用户： 访问 Discord 开发者门户，创建一个新的应用，然后在应用设置中点击“Bot”选项卡，再点击“Add Bot”按钮来创建一个 Bot 用户。
获取 Bot Token： 在 Bot 页面，你会看到你的 Bot 的 API Token。请务必妥善保管这个 Token，它是你的 Bot 身份的唯一凭证。
配置 Laravel： 将你的 Bot Token 配置到 Laravel 的 config/services.php 文件中：
```
// config/services.php
'discord' => [
    'token' => env('DISCORD_BOT_TOKEN', 'YOUR_API_TOKEN_HERE'), // 建议使用环境变量
],
```
当然，更推荐的做法是在 .env 文件中设置 DISCORD_BOT_TOKEN。
将 Bot 添加到你的服务器： 复制你的 Bot 的 OAuth2 URL（在 Bot 页面的 OAuth2 URL Generator 中生成，确保勾选 bot 作用域，并根据需要选择权限，例如 send messages），然后在浏览器中打开该 URL，选择你想添加 Bot 的 Discord 服务器。
识别 Bot： 最后，运行 Artisan 命令来识别你的 Bot：

萝卜简历
免费在线AI简历制作工具，帮助求职者轻松完成简历制作。

下载
```
php artisan discord:setup
```
这个命令会帮助你的应用识别并准备好与 Discord Bot 进行通信。

第二步：准备你的可通知模型

任何你希望能够接收 Discord 通知（例如，一个 User 模型，或者一个 Team 模型代表一个 Discord 频道）的模型，都需要使用 Notifiable Trait，并实现一个 routeNotificationForDiscord 方法。这个方法会返回一个 Discord 频道 ID。

use Illuminate\Notifications\Notifiable;
use Illuminate\Database\Eloquent\Model;

class Guild extends Model
{
    use Notifiable;

    /**
     * Route notifications for the Discord channel.
     *
     * @return string
     */
    public function routeNotificationForDiscord()
    {
        // 假设你的模型有一个 discord_channel 字段存储了 Discord 频道ID
        return $this->discord_channel;
    }
}

发送私聊通知？ 如果你想让 Bot 给某个 Discord 用户发送私聊消息，Discord 将私聊视为一种特殊的频道。你需要获取该用户的私聊频道 ID。NotificationChannels\Discord\Discord 类提供了 getPrivateChannel($userId) 方法来获取：

use NotificationChannels\Discord\Discord;

class UserDiscordSettingsController extends Controller
{
    public function store(Request $request)
    {
        $userId = $request->input('discord_user_id'); // 确保获取到的是 Discord 用户ID
        $channelId = app(Discord::class)->getPrivateChannel($userId);

        Auth::user()->update([
            'discord_user_id' => $userId,
            'discord_private_channel_id' => $channelId,
        ]);
        // 现在你可以通过 user->discord_private_channel_id 发送私聊通知了
    }
}

请注意，getPrivateChannel 方法只接受 Discord 的 Snowflake ID。获取用户 ID 通常需要用户授权你的应用或者通过其他方式获取。

第三步：创建和发送通知

现在，你可以像发送其他 Laravel 通知一样，创建一个新的通知类，并指定通过 Discord 渠道发送。

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use NotificationChannels\Discord\DiscordChannel;
use NotificationChannels\Discord\DiscordMessage;

class NewGameChallengeNotification extends Notification
{
    use Queueable;

    public $challenger;
    public $game;

    public function __construct(Guild $challenger, Game $game)
    {
        $this->challenger = $challenger;
        $this->game = $game;
    }

    /**
     * Get the notification's delivery channels.
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return [DiscordChannel::class]; // 指定使用 Discord 渠道
    }

    /**
     * Get the Discord representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return DiscordMessage
     */
    public function toDiscord($notifiable)
    {
        return DiscordMessage::create("你收到了一份来自 **{$this->challenger->name}** 的 *{$this->game->name}* 游戏挑战！");
    }
}

发送通知就变得非常简单了：

$guild = Guild::find(1); // 假设这是你的 Discord 频道对应的模型
$challenger = User::find(1);
$game = Game::find(1);

$guild->notify(new NewGameChallengeNotification($challenger, $game));

消息定制化：

DiscordMessage 对象提供了多种方法来定制你的消息，让它更具表现力：

body(string $content): 设置消息的文本内容，支持 Markdown 语法。
embed(array $embed): 发送富文本嵌入消息 (Embeds)。你可以构建一个包含标题、描述、颜色、图片、字段等的复杂消息体。这对于发送漂亮的通知卡片非常有用。
components(array $components): 设置消息的组件内容，例如按钮、下拉菜单等。这让你的通知更具交互性。

例如，发送一个带有嵌入内容的通知：

public function toDiscord($notifiable)
{
    return DiscordMessage::create('')
        ->embed([
            'title' => '新游戏挑战！',
            'description' => "你收到了一份来自 **{$this->challenger->name}** 的 *{$this->game->name}* 游戏挑战！",
            'color' => '7506394', // Discord 颜色代码，十进制
            'fields' => [
                [
                    'name' => '挑战者',
                    'value' => $this->challenger->name,
                    'inline' => true,
                ],
                [
                    'name' => '游戏',
                    'value' => $this->game->name,
                    'inline' => true,
                ],
            ],
            'footer' => [
                'text' => '来自你的 Laravel 应用',
            ],
            'timestamp' => now()->toIso8601String(),
        ]);
}