README

从 berkayk/laravel-onesignal 分支 fork，修复了 laravel 7.3 无法 composer install 的问题

OneSignal 推送通知 for Laravel

简介

这是一个简单的 OneSignal 包装器库，用于 Laravel。它使用定义的方法简化了基本的推送通知流程。您可以向所有用户发送消息，也可以通知单个用户。在开始安装此服务之前，请在 https://onesignal.com 完成您的 OneSignal 设置，并完成所有必要的步骤以获取应用程序 ID 和 REST API 密钥。

安装

首先，您需要使用 Composer 引入此包

composer require hafizhassan/onesig-laravel

然后，从命令行运行 composer update。

如果您的 Laravel 版本低于 5.5，则需要执行以下操作:

然后，通过在 config/app.php 文件中添加服务提供者条目来更新 config/app.php。

'providers' => [
	// ...
	Hafizhassan\OneSignal\OneSignalServiceProvider::class
];

然后，通过在别名部分添加条目来注册类别名

'aliases' => [
	// ...
	'OneSignal' => Hafizhassan\OneSignal\OneSignalFacade::class
];

最后，再次从命令行运行以下命令

php artisan vendor:publish --tag=config

以发布默认配置文件。这将发布一个名为 onesignal.php 的配置文件，其中包含您的 OneSignal 授权密钥。

注意：如果前面的命令无法成功发布配置文件，请检查涉及 提供者 和别名的 config/app.php 文件中的步骤。

配置

您需要填写位于您的应用程序 config 目录中的 onesignal.php 文件。其中 app_id 是您的 OneSignal App ID，而 rest_api_key 是您的 REST API 密钥。

用法

向所有用户发送通知

您可以使用以下命令轻松地向所有注册用户发送消息

    OneSignal::sendNotificationToAll(
        "Some Message", 
        $url = null, 
        $data = null, 
        $buttons = null, 
        $schedule = null
    );

$url、$data、$buttons 和 $schedule 字段是特例。如果您提供 $url 参数，用户将被重定向到该 URL。

基于标签/筛选发送通知

您可以使用以下命令根据一组标签发送消息

示例 1

    OneSignal::sendNotificationUsingTags(
        "Some Message",
        array(
            ["key" => "email", "relation" => "=", "value" => "email21@example.com"],
            ["key" => "email", "relation" => "=", "value" => "email1@example.com"],
            ...
        ),
        $url = null,
        $data = null,
        $buttons = null,
        $schedule = null
    );

示例 2

    OneSignal::sendNotificationUsingTags(
        "Some Message",
        array(
            ["key" => "session_count", "relation" => ">", "value" => '2'],
            ["key" => "first_session", "relation" => ">", "value" => '2000'],
        ),
        $url = null,
        $data = null,
        $buttons = null,
        $schedule = null
    );

向特定用户发送通知

将用户的令牌存储在表中后，您可以使用以下方式发送消息

    OneSignal::sendNotificationToUser(
        "Some Message",
        $userId,
        $url = null,
        $data = null,
        $buttons = null,
        $schedule = null
    );

$userId 是用户注册通知的唯一 ID。有关更多详细信息，请参阅 https://documentation.onesignal.com/docs/web-push-tagging-guide。 $url、$data、$buttons 和 $schedule 字段是特例。如果您提供 $url 参数，用户将被重定向到该 URL。

向特定外部用户（用户添加的自定义用户 ID）发送通知

将用户的令牌存储在表中后，您可以使用以下方式发送消息

    OneSignal::sendNotificationToExternalUser(
        "Some Message",
        $userId,
        $url = null,
        $data = null,
        $buttons = null,
        $schedule = null
    );

$userId 是用户注册通知的唯一外部 ID（自定义 ID）。有关更多详细信息，请参阅 https://documentation.onesignal.com/docs/web-push-tagging-guide。 $url、$data、$buttons 和 $schedule 字段是特例。如果您提供 $url 参数，用户将被重定向到该 URL。

向特定段发送通知

您可以使用以下命令简单地向特定段发送通知

    OneSignal::sendNotificationToSegment(
        "Some Message",
        $segment,
        $url = null,
        $data = null,
        $buttons = null,
        $schedule = null
    );

$url、$data、$buttons 和 $schedule 字段是特例。如果您提供 $url 参数，用户将被重定向到该 URL。

发送自定义通知

您可以使用以下方式发送自定义消息

    OneSignal::sendNotificationCustom($parameters);

异步发送自定义通知

您可以使用以下方式异步发送自定义消息

    OneSignal::async()->sendNotificationCustom($parameters);

请参阅https://documentation.onesignal.com/reference获取所有可自定义参数。

hafizhassan / onesig-laravel

维护者

详情