我又来发极光 JMessage PHP API Client 的更新了

为什么说 “又” ？可以看看这个大家有没有用过极光推送 JPush ，现在发布新版本了 v3.5.0

想必很多人都在用或者用过极光推送的这个第三方推送服务吧（laravel-china 就在用），那个~~很辣鸡很难用的~~东西正是老夫在维护的...

如果关注过的人也许会知道，如今极光不只有推送的业务，依托推送业务开辟了另一个叫做 JMessage 的业务（当然也有其他的业务），所以理所当然的需要一个 PHP 的 API Client。然后，就有了，

如果想了解极光 IM 业务可以点击这里，如果不想就可以离开这个页面了。

下面照例简单写一下基本用法

安装

在项目中的 composer.json 文件中添加 jmessage 依赖：

"require": {
    "jiguang/jmessage": "1.0.*"
}

执行 $ php composer.phar install 或 $ composer install 进行安装。

当然了，也提供了对下载源码安装的支持，也提供了一个简单的 autoload 文件以方便使用。

配置

在 Github 的 README 和 examples 中，为了方便表达与兼容性我是把 appKey 和 masterSecret 直接写在文件中，注意：在实际开发中请千万一定不要这么做，谁要是这么做了，将来报道出了偏差你可是要负责任的。好消息是 Laravel 本身作为一个开箱即用的 Web 开发框架对此做了原生的支持，那就是 .env 和 config 由于经验与背景的不足，我没有使用过 Laravel ，所以只是稍稍读了一下 Laravel-China 中关于 JPush 配置的做法在下面会给出比较详细做法。

初始化 JMessage Client

use JMessage\JMessage;

$appKey = 'xxxx';
$masterSecret = 'xxxx';

$client = new JMessage($appKey, $masterSecret);

毕竟是 Laravel 社区，那我就现学现卖说一下 Laravel 应该怎么做，如果有任何问题，欢迎拍砖

.env 中添加配置项

# .env
JMESSAGE_APP_KEY="xxxx"
JMESSAGE_MASECT_SECRET="xxxx"

config 文件夹下面新建 jmessage.php 作为配置文件

# config/jmessage
<?php
return [
    'appKey' => env("JMESSAGE_APP_KEY"),
    'masterSecret'  =>env("JMESSAGE_MASECT_SECRET") 
];

然后在相关的类中使用

use JMessage\JMessage;

$appKey = config('jmessage.appKey ');
$masterSecret = config('jmessage.masterSecret');

$client = new JMessage($appKey, $masterSecret);