xiaokus/getui

支持友盟、信鸽、个推推送。工厂模式，使用接口规范

dev-master 2018-04-23 02:27 UTC

Requires

• php: >=7.0.0

MIT

• chen xing

README

设计概要：

工厂模式：可根据配置随时切换第三方推送（本人的所有包库都是工厂模式）

PHP版本：信鸽、个推PHP7以上，友盟5.3以上，如果PHP版本低可自行改一下兼容的，应该只有一两处地方不兼容

目前支持的驱动有：信鸽，友盟、个推

接口规范

目前支持的框架：Yii

不需要依赖框架运行：是

其他说明：本包库没有对ui外观做定制功能，全都是使用推送平台的默认设置，如果以后需要定制外观时，会在配置文件配置切入。

注：友盟已完成测试无误。已在正式项目中使用，个推2018/04/04日开始在项目开发中使用， 信鸽运行测试没有问题，但是否能到达手机未测试。

吐槽

在这里我要吐槽一下，个推PHP SDK不知道是哪一位大神写的，可能写得比较早，没用上命名空间，所以得把sdk改名字再加上命名空间，但是不就是一个推送而已吗，40个多个php文件（友盟，信鸽17，18个），庞然大物啊！就说设置一个简单的属性，就写了7个类出来，且套用这些类的方法时还配了n个动态方法去调用，光是改这set_value就改了劳资近一个小时，感觉好像每一个文件都要改，人家别的就改几个文件的命名空间就能用了，看看这个推的技术水平多高啊，难道40个文件每一个文件都交叉关联使用吗？改得想死，这藕合高得没边了。我改别人的程序多垃圾的都见过，这么垃圾的还是第一次！我只是想改好命名空间直接调用，第一次对接第三方接口这样生气。妈B，改了劳资两个多小时，像信鸽，友盟的SKDK几分钟就改好了，这个推大神真牛逼！

安装

composer require xing.chen/push dev-master

运行示例

<?php

// ---------------- YII  ----------------
// 设置标题和消息、自定义参数
$push = Yii::$app->push
        ->setTitle('标题')
        ->setBody('消息正文')
        ->setExtendedData(['a' => 1, 'b' => 2]); // 自定义扩展参数;
        
        
// -------------------- 独立运行：工厂模式 ---------------------

# 赋值你要使用哪个平台的配置，说明文档最下面为各平台的配置参考

// 设置标题和消息、自定义参数
$push = \xing\push\core\PushFactory::getInstance($driveName)::init($config)
        ->setTitle('标题')
        ->setBody('消息正文')
        ->setExtendedData(['a' => 1, 'b' => 2]);// 自定义扩展参数

        
        
//   ***************  发送方法  **********   
# 广播：所有平台
$push->sendAll();
# 广播：安卓
$push->sendAllAndroid();
# 广播：IOS
$push->sendAllIOS();

# 单播：所有平台
$push->sendOne('设备码');
# 单播：安卓
$push->sendOneAndroid('设备码');
# 单播：IOS
$push->sendOneIOS('设备码');

各推送平台配置

以下为各推送平台的配置，你用哪个平台就复制哪个配置

<?php
//  ***  初始化驱动
// 友盟配置
$config = [
    'android' => [
        'appKey' => 'appKey',
        'appMasterSecret' => 'appMasterSecret'
    ],
    'IOS' => [
        'appKey' => 'appKey',
        'appMasterSecret' => 'appMasterSecret'  
    ]
];
// 信使配置
$config = [
   'expireTime' => 86400,
    'android' => [
       'accessId' => 'accessId',
       'secret_key' => 'secret_key',
    ],
    'IOS' => [
       'accessId' => 'accessId',
       'secret_key' => 'secret_key',
    ]
];

// 个推配置
$config = [
  'AppID' => 'AppID',
  'AppKey' => 'AppKey',
  'MasterSecret' => 'AppKey',
];

配置

<?php

// 接上面的配置

// 友盟
$driveName = 'Umeng';

// 信鸽
$driveName = 'Xingge';

// 个推
$driveName = 'GeTui';

// YII的components设置：
'components'=> [
        'push' => [
            'class' => 'xing\push\Yii',
            'driveName' => $driveName, // 驱动名
            // 配置
            'config' => $config
        ],
];

透传消息（自定义消息通知）

如无说明，默认都是透传消息。

其中友盟的安卓手机通知会发送两次通知，一次是消息通知，一次为透传通知

其中个推只要设置了扩展参数，就会发送透传消息，否则为默认通知。