README

这是一个 JPush REST API 的 PHP 封装开发包，由极光推送官方提供，通常支持最新的 API 功能。

对应的 REST API 文档: https://docs.jiguang.cn/jpush/server/push/server_overview/

支持的 PHP 版本: 5.3.3 ～ 5.6.x, 7.x

若需要兼容 PHP 5.3.3 以下版本，可以使用 v3 分支的代码。因为运行 Composer 需要 PHP 5.3.2+ 以上版本，所以其不提供 Composer 支持，也可以点击链接下载 v3.4.x 版本源码。

安装

使用 Composer 安装

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

直接下载源码安装

直接下载源代码也是一种安装 SDK 的方法，但由于版本更新的维护问题，这种安装方式**非常不推荐**，但由于种种原因导致无法使用 Composer，我们也提供了这种情况下的备选方案。

• 下载源代码包，解压到项目中
• 在项目中引入 autoload：

require 'path_to_sdk/autoload.php';

使用

• 初始化 API
• 推送 API
• 报告 API
• 设备 API
• 调度 API
• 异常处理
• HTTP/2 支持
• 分组推送

初始化

use JPush\Client as JPush;
...
...

    $client = new JPush($app_key, $master_secret);

...

或者

$client = new \JPush\Client($app_key, $master_secret);

简单推送

$client->push()
    ->setPlatform('all')
    ->addAllAudience()
    ->setNotificationAlert('Hello, JPush')
    ->send();

异常处理

$pusher = $client->push();
$pusher->setPlatform('all');
$pusher->addAllAudience();
$pusher->setNotificationAlert('Hello, JPush');
try {
    $pusher->send();
} catch (\JPush\Exceptions\JPushException $e) {
    // try something else here
    print $e;
}

示例

注意: 这只是一个使用示例，不应该直接用于实际环境中!!

在下载的 examples 文件夹中有简单示例代码，开发者可以参考其中的样例快速了解该库的使用方法。

简单使用方法

先填写对应的 appKey 和 masterSecret，可以额外设定 Registration_id。

若要运行 push_example.php 中的示例代码：

# 假定当前目录为 JPush 源码所在的根目录
$ php examples/push_example.php

同时也可编辑相关的示例文件，更改参数查看执行效果

测试

# 编辑 tests/bootstrap.php 文件，填入必须的变量值
# OR 设置相应的环境变量

# 运行全部测试用例
$ composer tests

# 运行某一具体测试用例
$ composer tests/JPush/xxTest.php

贡献

欢迎在 GitHub 上提交错误报告和拉取请求 https://github.com/jpush/jpush-api-php-client。

许可证

该库在 MIT 许可证 的条款下作为开源软件提供。