nightmare / jmessage
基于极光官方,修改了一些问题,增加了一些功能
1.1.13
2018-12-11 02:07 UTC
Requires
- php: >=5.4
- ext-curl: *
README
这是 JMessage REST API 的 PHP 版本封装开发包,由极光推送官方提供,通常支持最新的 API 功能。
对应的 REST API 文档: https://docs.jiguang.cn/jmessage/server/rest_api_im/
支持的 PHP 版本: 5.4 ~ 5.6.x, 7
安装
使用 Composer 安装
- 在项目的
composer.json
文件中添加 jmessage 依赖:
"require": { "jiguang/jmessage": "~1.1" }
- 执行
$ php composer.phar install
或$ composer install
进行安装。
直接下载源码安装
直接下载源代码也是一种安装 SDK 的方法,但由于版本更新的维护问题,这种方式非常不推荐。但由于种种原因导致无法使用 Composer,因此我们也提供了这种情况下的备选方案。
- 下载源代码包,解压到项目中
- 在项目中引入 autoload(在源码根目录下):
require 'path_to_sdk/autoload.php';
用法
示例
注意:这只是一个使用示例,不应该直接用于实际环境中!!
在项目的 examples 文件夹中有简单的使用示例代码,开发者可以参考其中的样例快速了解该库的使用方法。
注意:所下载的样例代码不可直接使用,需要在 examples/config.php
文件中填入相关的必要参数,或者设置相关环境变量。如果不进行此操作,示例将运行失败。另外,为保护开发者隐私,examples/config.php
文件不在版本控制中,需要使用如下命令手动复制:
$ cp examples/config.php.example examples/config.php
简单使用示例
若要运行 friend_examples.php 中的示例代码:
# 假定当前目录为 JMessage 源码所在的根目录
$ php examples/friend_examples.php
当然也可以编辑相关的示例文件,更改参数查看执行效果
ErrorCode
JMessage 服务器端报的错误码。可能出现在返回值中,可在此查询含义: https://docs.jiguang.cn/jmessage/client/im_errorcode_server/
贡献
欢迎在 GitHub 上提交错误报告和拉取请求:https://github.com/jpush/jmessage-api-php-client.
许可
该库以开源形式提供,遵循 MIT 许可协议。