commit work php,GitHub - sbzhu/weworkapi_php: official lib of wework api

About

weworkapi_php 是为了简化开发者对企业微信API接口的使用而设计的，API调用库系列之php版本

包括企业API接口、消息回调处理方法、第三方开放接口等

本库仅做示范用，并不保证完全无bug；

另外，作者会不定期更新本库，但不保证与官方API接口文档同步，因此一切以官方文档为准。

Requirement

经测试，PHP 5.3.3 ~ 7.2.0 版本均可使用

Director

├── api // API 接口

│   ├── datastructure // API接口需要使用到的一些数据结构

│   ├── examples // API接口的测试用例

│   ├── README.md

│   └── src // API接口的关键逻辑

├── callback // 消息回调的一些方法

├── config.php

├── README.md

└── utils // 一些基础方法

Usage

将本项目下载到你的目录，既可直接引用相关文件

include_once("api/src/CorpAPI.class.php");

// 实例化 API 类

$api = new CorpAPI($corpId='ww55ca070cb9b7eb22', $secret='ktmzrVIlUH0UW63zi7-JyzsgTL9NfwUhHde6or6zwQY');

try {

// 创建 User

$user = new User();

{

$user->userid = "userid";

$user->name = "name";

$user->mobile = "131488888888";

$user->email = "sbzhu@ipp.cas.cn";

$user->department = array(1);

}

$api->UserCreate($user);

// 获取User

$user = $api->UserGet("userid");

// 删除User

$api->UserDelete("userid");

} catch {

echo $e->getMessage() . "\n";

$api->UserDelete("userid");

}

详细使用方法参考每个模块下的测试用例

关于token的缓存

token是需要缓存的，不能每次调用都去获取token，否则会中频率限制

在本库的设计里，token是以类里的一个变量缓存的

比如api/src/CorpAPI.class.php 里的$accessToken变量

在类的生命周期里，这个accessToken都是存在的， 当且仅当发现token过期，CorpAPI类会自动刷新token

刷新机制在 api/src/API.class.php

所以，使用时，只需要全局实例化一个CorpAPI类，不要析构它，就可一直用它调函数，不用关心 token

$api = new CorpAPI(corpid, corpsecret);

$api->dosomething()

$api->dosomething()

$api->dosomething()

....

当然，如果要更严格的做的话，建议自行修改，全局缓存token，比如存redis、存文件等，失效周期设置为2小时。

Contact us