在 Laravel 中使用極光推送

一個人的江湖發表於2019-07-13

最近在專案中需要用到推送，抽出時間看了看極光推送，記錄一下
Github地址：https://github.com/jpush/jpush-api-php-cli...
極光推送官方文件地址：https://docs.jiguang.cn/jpush/server/push/...

PHP 7.1.29

Laravel 5.6

在 composer.json 檔案中的 require 下新增 "jpush/jpush": "^3.6"

"require": {
    "jpush/jpush": "^3.6",
},

執行命令：composer install

在 config 目錄下新建檔案 Jpush.php 並進行如下配置：

return [
    'android_app_key' => env('JPUSH_APP_KEY'),
    'android_master_secret' => env('JPUSH_APP_MASTER_SECRET'),

    'ios_app_key' => env('JPUSH_IOS_KEY'),
    'ios_master_secret' => env('JPUSH_IOS_MASTER_SECRET'),

    // 環境 true-生產 false-開發
    'environment' => env('JPUSH_APNS_PRODUCTION', false),
];

.env 檔案進行如下配置：

JPUSH_APP_KEY=極光推送的app_key
JPUSH_APP_MASTER_SECRET=極光推送的master_secret
JPUSH_IOS_KEY=
JPUSH_IOS_MASTER_SECRET=
JPUSH_APNS_PRODUCTION=true

在 Support 目錄下新建目錄 Jpush，然後在 Jpush 目錄下新建檔案 Jpush.php 內容如下：

<?php

namespace App\Support\Jpush;

use JPush\Client;

class Jpush
{
    private $androidAppKey;
    private $androidMasterSecret;

    public function __construct()
    {
        $this->androidAppKey = config('Jpush.android_app_key');
        $this->androidMasterSecret = config('Jpush.android_master_secret');
    }

    /**
     * 初始化 JPushClient
     * @return Client
     */
    public function newJpushClient()
    {
        $client = new Client($this->androidAppKey, $this->androidMasterSecret);
        return $client;
    }

    /**
     * android 通過 註冊ID 給單個裝置或多個裝置推送訊息(已測可用)
     * @param $platform
     * @param $registrationId
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function androidPushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform($platform)
            ->addRegistrationId($registrationId)
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }

    /**
     * ios 通過 註冊ID 給單個裝置或多個裝置推送訊息（未測）
     * @param $platform
     * @param $registrationId
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function iosPushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform($platform)
            ->addRegistrationId($registrationId)
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }

    /**
     * android 通過 別名 給單個裝置或多個裝置推送訊息（已測可用）
     * @param $platform
     * @param $alias
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function androidPushByAlias($platform, $alias, $title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform($platform)
            ->addAlias($alias)
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }

    /**
     * ios 通過 別名 給單個裝置或多個裝置推送訊息（未測）
     * @param $platform
     * @param $alias
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function iosPushByAlias($platform, $alias, $title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform($platform)
            ->addAlias($alias)
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }

    /**
     * 推送所有 android裝置 或者 ios裝置（android 已測可用）
     * @param $platform
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function AndroidOrIosPushAll($platform, $title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform($platform)
            ->addAllAudience()
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }

    /**
     * 推送所有裝置（android 已測可用）
     * @param $platform
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public function pushAll($title, $content, $builder, $extras)
    {
        $response = $this->newJpushClient()
            ->push()
            ->setPlatform('all')
            ->addAllAudience()
            ->androidNotification($content, [
                "title" => $title,
                "builder_id" => $builder,
                "extras" => $extras
            ])->send();
        return $response;
    }
}

在 Modules 目錄下新建目錄 Jpush，然後在 Jpush 目錄下新建檔案 JpushService.php 內容如下：

<?php
namespace App\Modules\Jpush;

use App\BaseService;
use App\Exceptions\BaseResponseException;
use App\Support\Jpush\Jpush;
use Log;

class JpushService extends BaseService
{

    /**
     * 通過 註冊id 推送
     * @param $platform
     * @param $registrationId
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public static function pushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras)
    {
        $jpush = new Jpush();
        if ($platform == 'android') {
            $response = $jpush->androidPushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras);
        } elseif ($platform == 'ios') {
            $response = $jpush->iosPushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras);
        } else {
            throw new BaseResponseException('推送平臺型別錯誤');
        }

        if ($response['http_code'] != 200) {
            Log::info('推送失敗 by registrationId', compact('response', 'platform', 'registrationId', 'title', 'content'));
        } else {
            Log::info('推送成功 by registrationId', compact('response', 'platform', 'registrationId', 'title', 'content'));
        }

        return $response;
    }

    /**
     * 通過 別名 推送
     * @param $platform
     * @param $alias
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public static function pushByAlias($platform, $alias, $title, $content, $builder, $extras)
    {
        $jpush = new Jpush();
        if ($platform == 'android') {
            $response = $jpush->androidPushByAlias($platform, $alias, $title, $content, $builder, $extras);
        } elseif ($platform == 'ios') {
            $response = $jpush->iosPushByAlias($platform, $alias, $title, $content, $builder, $extras);
        } else {
            throw new BaseResponseException('推送平臺型別錯誤');
        }

        if ($response['http_code'] != 200) {
            Log::info('推送失敗 by alias', compact('response', 'platform', 'alias', 'title', 'content'));
        } else {
            Log::info('推送成功 by alias', compact('response', 'platform', 'alias', 'title', 'content'));
        }

        return $response;
    }

    /**
     * 推送全部 android裝置 或 ios裝置
     * @param $platform
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public static function pushAllAndroidOrIos($platform, $title, $content, $builder, $extras)
    {
        $jpush = new Jpush();
        $response = $jpush->AndroidOrIosPushAll($platform, $title, $content, $builder, $extras);
        if ($response['http_code'] != 200) {
            Log::info('推送失敗 by all', compact('response', 'platform', 'title', 'content'));
        } else {
            Log::info('推送成功 by all', compact('response', 'platform', 'title', 'content'));
        }
        return $response;
    }

    /**
     * 推送全部
     * @param $title
     * @param $content
     * @param $builder
     * @param $extras
     * @return array
     */
    public static function pushAll($title, $content, $builder, $extras)
    {
        $jpush = new Jpush();
        $response = $jpush->pushAll($title, $content, $builder, $extras);
        if ($response['http_code'] != 200) {
            Log::info('推送失敗 by all', compact('response', 'title', 'content'));
        } else {
            Log::info('推送成功 by all', compact('response', 'title', 'content'));
        }
        return $response;
    }
}

新建路由：

// 手動推送測試（極光推送）
Route::post('message/jpush', 'MessageController@testJpush');

新建控制器並新增方法如下：

   /**
     * 手動測試推送（極光推送）
     */
    public function testJpush()
    {
        // 推送平臺 android 或 ios
        $platform = 'android';

        // 通過id推送，支援單個（字串）或多個（陣列）
        // $registrationId = '170976fa8afac898f28443';
        // $registrationId = [
        //     '170976fa8afac898f2822',
        //     '100d8559093c40254b03'
        // ];

        // 通過別名推送，支援單個（字串）或多個（陣列），下面的 * 號只是為了隱藏手機號
        // $alias = '188****2730';
        // $alias = [
        //     '188****2730',
        //     '176****4994',
        // ];

        $title = '恭喜您中獎了！';
        $content = '恭喜您中獎了！500萬元大獎哦！';
        // 通知欄樣式 ID
        $builder = 1;
        // 返回給客戶端的引數，用於其他需求，比如點選通知跳轉到詳情
        $extras = [
            'orderid' => 13545,
        ];

        // 通過id推送
        // $data = JpushService::pushByRegistrationId($platform, $registrationId, $title, $content, $builder, $extras);

        // 通過別名推送
        // $data = JpushService::pushByAlias($platform, $alias, $title, $content, $builder, $extras);

        // 推送所有android裝置或者ios裝置
        // $data = JpushService::pushAllAndroidOrIos($platform, $title, $content, $builder, $extras);

        // 推送所有裝置
        $data = JpushService::pushAll($title, $content, $builder, $extras);
        dd($data);
    }

最後，請求該測試方法，得到返回結果如下：

在 Laravel 中使用極光推送

本文只用到了最常用的通知欄推送，如需其他方式請參考官方文件。

為了能夠看的清楚些，寫的有點囉嗦，很多地方都可以優化，大家多多擔待，以上方法都在 android demo 下測試過，可用，等 IOS 小哥哥整合 IOS 包後，我測過 iOS 後重新補充整理一下，Thanks♪(･ω･)ﾉ。

乾坤未定，你我皆是黑馬

Laravel 極光推送驅動，使用極光不再那麼麻煩！
2019-02-27
Laravel
極光筆記｜極光推送在APICloud平臺的使用教程
2022-03-24
筆記APICloud
快捷地整合極光推送（JPush）到 Laravel 專案中
2019-01-30
Laravel
iOS —— 極光推送和極光IM
2019-03-04
iOS
極光推送總結
2016-09-08
極光推送demo在android studio中無法執行
2018-06-29
Android
在ionic專案中使用極光推送實現推送 & 伺服器端程式碼
2015-08-25
伺服器
極光推送-java工具類
2017-06-25
Java
極光推送—java快速接入
2017-08-18
Java
極光推送證書篇
2017-01-10
iOS極光推送封裝
2016-04-12
iOS封裝
Flutter應用整合極光推送
2020-02-27
Flutter
極光推送 tag alias 設定
2017-08-21
Swift3.0整合極光推送
2017-01-09
Swift
APP訊息推送極光推送示例程式碼
2020-11-25
APP
iOS 極光推送整合與開發
2017-12-13
iOS
iOS 極光推送遇到的問題
2015-06-08
iOS
iOS-極光推送開發小結
2015-10-27
iOS
使用極光推送實現分組傳送和服務端整合
2017-08-21
服務端
在Android裝置上使用極光推送id重複的原因分析和解決辦法
2019-12-23
Android
極光筆記丨iOS 15推送新特性
2021-10-20
筆記iOS
Android開發之極光推送的整合
2016-04-26
Android
極光推送-服務端端智慧人社訊息推送方式
2016-11-30
服務端
適配 iOS 10，極光推送使用者要做這 6 處更改
2016-12-16
iOS
極光推送申請iOS推送證書p12及配置教程
2019-11-06
iOS
極光推送申請iOS推送證書p12及配置流程
2019-09-04
iOS
[外掛擴充套件]APP極光推送外掛！
2020-04-04
套件APP
iOS_極光推送的UNNotificationServiceExtension實現富文字
2018-01-19
iOS
JPush極光推送Java伺服器端例項
2017-08-21
Java伺服器
Swift - JPush極光推送的使用4（根據Tag標籤，給同一類別使用者發推送）
2017-08-21
Swift
極光筆記丨Spark SQL 在極光的建設實踐
2021-11-09
筆記SparkSQL
在Laravel中整合騰訊雲移動(APP)推送（TPNS）
2020-07-20
LaravelAPP
php 第三方極光推送domo（Android版）
2017-02-17
PHPAndroid
iOS .a庫打包成.framework（將極光推送的.a庫打包進framework）
2017-01-09
iOSFramework
ios 極光推送獲取當前控制器進行介面跳轉
2017-03-29
iOS
聊聊 Interface 在 Laravel 開發中的使用
2022-05-12
Laravel
在 Laravel 中不用 Node / npm 使用 Tailwind CSS
2022-02-10
LaravelNPMAICSS
極光筆記 | 極光服務的信創改造實踐
2023-09-18
筆記

在 Laravel 中使用 極光推送

相關文章

在 Laravel 中使用極光推送