PHP code example of ilovelylong / dingtalk2
1. Go to this page and download the library: Download ilovelylong/dingtalk2 library . Choose the download type require .
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
ilovelylong / dingtalk2 example snippets {4-23}
use EasyDingTalk\Application;
$config = [
//**配置文件分钉钉配置项,和程序配置项目
/*
|-----------------------------------------------------------
| 【必填】企业 corpId 钉钉配置项目
|-----------------------------------------------------------
*/
'corp_id' => 'XXXXXX',
/*
|-----------------------------------------------------------
| 【选填】后台免登配置信息 钉钉配置项目
|-----------------------------------------------------------
| 如果你用到应用管理后台免登功能,需要配置该项
*/
'sso_secret' => 'XXXXXX',
//以下三个是 H5,小程序,机器人默认公有项,如果app 不设置或者设置了没用使用,默认调用此配置,
"agentid" => "XXXXXX",
"app_key" => "XXXXXX",
"app_secret" => "XXXXXX",
//小程序配置项目
"miniappid"=>"xxxxxx",
//H5,小程序 订阅配置项目
"aes_key" => "XXXXXX",
"token" => "XXXXXX",
'app'=>[
'robot01'=>[
//以下三个是 H5,小程序,机器人公有项
'kind'=>'robot',//必填
"agentid" => "XXXXXX",
"app_key" => "XXXXXX",
"app_secret" => "XXXXXX",
//小程序配置项目
"miniappid"=>"xxxxxx",
//H5,小程序 订阅配置项目
"aes_key" => "XXXXXX",
"token" => "XXXXXX",
],
'MFC'=>[
'kind' => 'app', //必填
// or 'app_id'
'client_id' => 'XXXXX',
// or 'app_secret'
'client_secret' => 'XXXXXXXXXXXXXXXXXXXXXX',
// or 'redirect_url'
'redirect' => 'https://www.XXX.com/',
'scope' => 'snsapi_login',
]
]
];
$app = new Application($config);
$app_robot=$app->robot01; //返回robot01 配置的机器人
、、、或者
$app_robot=Application::robot01($config);//返回robot01 配置的机器人
、、、或者
$app = new Application($config);
$app_robot=$app->robot;//返回默认配置的机器人
都是返回一个机器人实例
......
$user_agent = $_SERVER['HTTP_USER_AGENT'];
//判断是不是需要钉钉浏览器打开
if (strpos($user_agent, "DingTalk") !== false) {
//没有登录的,就跳转登录页面
if (!ISLOGIN){
$redirecturl = '登录成功后的跳转页面';
$HTML = <<<SCRIPT
<script src='https://g.alicdn.com/dingding/dingtalk-jsapi/2.10.3/dingtalk.open.js'></script>
<script>
dd.ready(function() {
dd.runtime.permission.requestAuthCode({
corpId: "{$app->config['corp_id']}",
onSuccess : function(res) {
var url='你的授权页面地址?rl={$redirecturl}&code='+res.code // 通过该免登授权码可以获取用户身份
parent.location.href=url;
},
onFail : function(err) {
// 调用失败时回调
alert('dd error: ' + JSON.stringify(err));
}
});
});
</script>
SCRIPT;
echo $HTML;
exit(0);
}
}
......
......
//根据上面 的前端地址获得code
$UserDataUser = $app->user->getUserByCode($_GET['code']);
//登录逻辑代码
....
header('Location:' . $_GET['rl']);
....
$userCodeData = $app->app->stateless()->user();
// 扫码登录第三方网站
$response = $app->app->withQrConnect()->redirect();
// 钉钉内免登第三方网站、密码登录第三方网站均同样使用如下方法跳转:
$response = $app->app->redirect();
// 回调页面统一使用如下方法来获取用户信息:
$user = $app->app->user();
$server = $app->app;
$server->push(DingTalkHandler::class);
$server->serve()->send(); // ThinkPHP 等框架使用
......
class DingTalkHandler{
public function __invoke($payload)
{
// 在此处处理你的业务逻辑
$type = $payload['EventType'];
switch ($type) {
case 'bpms_task_change': //审批任务开始、结束、转交。
$this->msgdata($payload, '审批任务事件');
break;
case 'bpms_instance_change': //审批实例开始、结束。
$this->msgdata($payload, '审批实例事件');
break;
case 'attendance_check_record': //审批实例开始、结束。
$this->msgdata($payload, '员工打卡事件');
break;
case 'attendance_schedule_change': //审批实例开始、结束。
$this->msgdata($payload, '员工排班变更事件');
break;
case 'attendance_overtime_duration': //审批实例开始、结束。
$this->msgdata($payload, '员工加班事件');
break;
case 'hrm_user_record_change': //审批实例开始、结束。
$this->msgdata($payload, '员工信息变动');
break;
......
default:
$this->msgdata($payload, '其他事件');
break;
}
}
public function msgdata($payload, $type){
}
}
//用robot01 配置文件 初始化机器人
$robot= $app->robot;
//每一个处理器 都可以返回一个消息
$robot->push(function () {
$text = new EasyDingTalk\\Messages\\Text("123");
return$text->toJson();
});
$robot->push(DingTalkHandler::class);
$robot->push(function () {
$text = new EasyDingTalk\\Messages\\Text("123456789");
return$text->toJson();
});
$robot->serve()->send(); // ThinkPHP 等框架使用
//用robot01 配置文件 初始化机器人
$robot= $this->robot;
$text = new EasyDingTalk\\Messages\\Text("123456789");
$robot->send(json_encode($text));
//用robot01 配置文件 批量发送单人消息
$app->robot01->batchMsg(
["msgKey" => 'sampleMarkdown', "msgParam" => "{
'title': '触发一个通知',
'text': '### 触发一个通知\n**小标题**\n\n- 列表\nn- 列表\nn- 列表\nn'
}"],
["userid", 'userid']
);