# simple-dingtalk
**Repository Path**: C-BAND/simple-dingtalk
## Basic Information
- **Project Name**: simple-dingtalk
- **Description**: 轻量级钉钉服务端PHP-SDK，简化初学者的使用难度。（非官方）
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 16
- **Created**: 2022-02-20
- **Last Updated**: 2022-02-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
轻量级钉钉服务端PHP-SDK，简化初学者的使用难度。
### 介绍
这是一款PHP编写的轻量级钉钉服务端扩展包，以最简单的方式取调用、源码易懂、模块化。
### 安装方式
`composer require michonnehsu/simpledingtalk`
### 文档地址
点击访问[文档](https://gitee.com/michonnehsu/simple-dingtalk/wikis/pages)
### 配置
预先配置多个应用后，只修改app_type 进行切换。
预先配置多个机器人后，只修改robot_type 进行切换。
```
关键字解释：
CORP_ID：当前公司的Corp_id
app：微应用或小程序
APP_KEY：当前应用的app_key
APP_SECRET：当前应用的app_secret
access_token：当前应用的access_token信息
access_token->expires：access_token的提前超时重新获取时间，单位秒
access_token->file_path：access_token的文件路径，建议填写绝对路径
callback_info：回调信息
callback_info->aes_key：当前应用的加密
callback_info->token：当前应用的签名
login_info：扫码登录信息
login_info->authorize->redirect_uri：统一授权登录第三方网站
login_info->authorize->dingtalk_login_uri：钉钉内免登第三方网站跳转url
userAccessToken：获取用户通讯录个人信息需要的token信息
v2：新版服务端信息
robot:群聊机器人
robot->SEC：机器人的加签码，用于加密发送消息。可在群设置的智能群助手的机器人信息里查看
如何配置：
$apps=[
'miniprogram_app' => [
'info' => [
'AGENT_ID' => 0,
'APP_KEY' => '',
'APP_SECRET' => '',
],
'access_token' => [
'expires' => 180,
'file_path' => './a.json'
],
'login_info' => [
'authorize' => [
'redirect_uri' => 'https://www.dingtalk.com',
'dingtalk_login_uri'=>'https://www.dingtalk.com'
]
],
'callback_info' => [
'aes_key' => '',
'token' => ''
],
'v2' => [
'access_token' => [
'expires' => 180,
'file_path' => './c.json'
]
],
'userAccessToken' => [
'expires' => 180,
'file_path' => './uat.json'
]
],
];
$robots=[
'robot1' => [
'info' => [
'AGENT_ID' => 0,
'APP_KEY' => '',
'APP_SECRET' => '',
'access_token' => '',
'SEC' => ''
],
'access_token' => [
'expires' => 180,
'file_path' => './robot.json'
]
],
];
Config::setRobot($robots)->
setApp($apps)->
setAppType('miniprogram_app')->
setRobotType('robot1')->
setCorpId('dingf0xxxxx69');
```
### 用法
#### 基础用法
```
require_once './vendor/autoload.php';
use SimpleDingTalk\WorkFlow;
$json=[
'process_instance_id'=>$process_instance_id,
'text'=>'测试评论',
'comment_userid'=>$userid
];
WorkFlow::add_comment($json);
```
### 函数定义规则
1. 如果接口需要的参数复杂并且有必填和非必填的话，函数需要的参数需要开发者自行组装参数。
2. 如果接口需要的参数不复杂并且不多、有必填和非必填，则只需要按照函数所需填入即可。
3. 如果接口需要的参数全是必填的话则函数需要的参数不需要完全自行组装参数，按照函数所需的参数填入即可。
4. 如果参数过多的话需要开发者自行填入到`$json`或`$body`里面。
## License
MIT
## Stars 趋势
[](https://whnb.wang)