Laravel 极光推送驱动,使用极光不再那么麻烦!

我们在开发针对国内运营的时候进行需要使用过程的几家推送,极光推送则是其中之一。这个包就可以让你方便的在你构件的 Laravel 应用中进行极光推送的使用。

GitHub: https://github.com/medz/laravel-jpush-noti...

前提

  • PHP >= 7
  • Laravel >= 5.5

安装

在 Laravel 应用目录使用 Composer 进行依赖:

composer require medz/laravel-jpush-notification-channel

包中依赖了匹配的 jpush/jpush 依赖版本为 ^3.6,你已经依赖了更低版本的不兼容版本包,使用的时候要小心了!

配置

config/services.php 中进行如下配置:

return [
    'jpush' => [
        'app_key' => env('JPUSH_APP_KEY', ''),
        'master_secret' => env('JPUSH_MASTER_SECRET', ''),
        'apns_production' => env('JPUSH_APNS_PRODUCTION', false),
    ],
]

然后在 .env 文件中进行配置:

JPUSH_APP_KEY=
JPUSH_MASTER_SECRET=
JPUSH_APNS_PRODUCTION=

使用

首先,要在数据模型上添加一个 routeNotificationForJpush 方法:

use Illuminate\Foundation\Auth\User as Authenticatable;
use Medz\Laravel\Notifications\JPush\Sender as JPushSender;

class User extends Authenticatable
{
    /**
     * Get Notification for JPush sender.
     * @return \Medz\Laravel\Notifications\JPush\Sender
     */
    protected function routeNotificationForJpush()
    {
        return new JPushSender([
            'platform' => 'all',
            'audience' => [
                'alias' => sprintf('user_%d', $this->id),
            ],
        ]);
    }
}

这里我们返回一个 Medz\Laravel\Notifications\JPush\Sender 实例,可以使用构造参数快速配置,如同上面一样,也可以使用链式调用进行配置。链式调用的 API 如下:

  • setPlatform 设置平台,值有 all、winphone、android 和 ios
  • setAudience 推送目标进行设置

setAudience 方法或者构造参数中的 audience 设置参考:推送目标文档。

然后打开通知类,添加一个 toJpush 方法,这里我们已 app/Notifications/CommentNotification.php 为例:

<?php

namespace App\Notifications;

use Illuminate\Notifications\Notification;
use Medz\Laravel\Notifications\JPush\Message as JPushMessage;

class CommentNotification extends Notification
{
    public function toJpush($notifiable)
    {
        $message = new JPushMessage();
        // TODO

        /*
            ====== 把所有的配置都进行配置 ===
            $message->setAlert('Alert.'); // 简单地给所有平台推送相同的 alert 消息

            // 自定义消息
            $message->setMessage('Message', [
                'title' => '', // 通知标题,会填充到 toast 类型 text1 字段上
                '_open_page' => '', 点击打开的页面名称
                'extras' => [], // 自定义的数据内容
            ]);

            // iOS 通知
            $message->setNotification(JPushMessage::IOS, 'Alert 内容', [
                'alert' => '', // 覆盖第二个参数的 Alert 内,推荐不传,
                'sound' => '', // 表示通知提示声音,默认填充为空字符串
                'badge' => '', // 表示应用角标,把角标数字改为指定的数字;为 0 表示清除,支持 '+1','-1' 这样的字符串,表示在原有的 badge 基础上进行增减,默认填充为 '+1'
                /// ...
            ])

            // 更多通知请参考 https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/#notification 官方文档
            // 使用 `setNotification` 方法第一个常量有三个: IOS/ANDROID/WP

            // 可选参数
            $message->setOptions([]); // 参考 https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/#options
        */

        return $message
    }
}

toJpush 方法需要返回一个 Medz\Laravel\Notifications\JPush\Message 对象实例!

完成上面的配置后,就可以推送了,记得在 via 方法中返回 jpush 这个值哈,例如:

public function via()
{
    return ['database', 'jpush'];
}
本作品采用《CC 协议》,转载必须注明作者和本文链接
Seven 的代码太渣,欢迎关注我的新拓展包 medz/cors 解决 PHP 项目程序设置跨域需求。
本帖由 Summer 于 5年前 加精
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 3
xin6841414

目前只能推送对象为别名么, 别名测试没问题, 搞半天没搞定all广播,是姿势不对,还是不能支持all广播?

4年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!
创始人 @ Odore Inc.
文章
33
粉丝
202
喜欢
532
收藏
198
排名:23
访问:24.7 万
私信
所有博文
社区赞助商