# 釘釘 ## 輔助函數 ```php /** * curl 請求 * * @param string $method 請求方法 POST/GET/DELETE/PUT * @param string $url * @param array|string $data 提交數據 * @param array $header 請求頭 * @return string|null */ function curl_request($method = 'POST', $url, $data='', $header=[]) { $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => $url, CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => $method, CURLOPT_POSTFIELDS => $data, CURLOPT_HTTPHEADER => $header, )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) throw new Exception($err, 1); return $response; } ``` ## 封裝代碼 file：`application/utils/DingTalk.php` ```php <?php namespace app\utils; use think\Exception; use think\facade\Cache; /** * 應用密鑰 */ define('DINGTALK_CORPID', env('DINGTALK.CORPID')); define('DINGTALK_SECRET', env('DINGTALK.SECRET')); /** * 釘釘 */ class DingTalk { /** * 企業開發者消息ID */ const AGENT_ID = ''; /** * 獲取access_token * * @return string */ static function getAccessToken() { $access_token = Cache::get('DING_TOKEN'); if ($access_token) { return $access_token; } $corpid = DINGTALK_CORPID; $corpsecret = DINGTALK_SECRET; $response = curl_request('GET', "https://oapi.dingtalk.com/gettoken?corpid={$corpid}&corpsecret={$corpsecret}"); // dump($response); $result = json_decode($response, true); if (!isset($result['access_token'])) throw new Exception($result['errmsg'], 1); $access_token = $result['access_token']; Cache::set('DING_TOKEN', $access_token, 60); // 60秒內用同一個 return $access_token; } /** * 獲取用戶userid * * @param string $code * @return string */ static function getUserid($code) { $access_token = self::getAccessToken(); $url = "https://oapi.dingtalk.com/user/getuserinfo?access_token={$access_token}&code={$code}"; $response = curl_request('GET', $url); $result = json_decode($response, true); if (!isset($result['userid'])) throw new Exception($result['errmsg'], 1); $userid = $result['userid']; return $userid; } /** * 獲取用戶信息 * * @param integer $userid * @return array */ static function getUserinfo($userid) { $access_token = self::getAccessToken(); $url = "https://oapi.dingtalk.com/user/get?access_token={$access_token}&userid={$userid}"; $response = curl_request('POST', $url); $result = json_encode($response, true); return $result; } /** * 發送消息 * * @param integer $agent_id 應用agentId 參考常量: DingTalk::AGENT_ID * @param string $user_id 釘釘用戶id * @param array $msg 消息格式參考: https://ding-doc.dingtalk.com/doc#/serverapi2/ye8tup * @return array|null array(3) { errcode=>0, task_id=>18988591062, request_id=>6iq4ab1gd7il } */ static function sendMsg($agent_id, $userid = '', $msg) { $access_token = self::getAccessToken(); $url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=$access_token"; $postData["agent_id"] = $agent_id; $postData["userid_list"] = $userid; $postData["msg"] = $msg; $result = json_decode(curl_request('POST', $url, $postData), true); return $result; } /** * 發送文本消息 * * @param integer $agent_id 應用agentId 參考常量: DingTalk::AGENT_ID * @param string $userid 釘釘用戶id * @param string $content 發送內容 * @return void */ static function sendTextMsg($agent_id, $userid, $content) { $msgData = [ 'msgtype' => 'text', 'text' => [ 'content' => $content, ], ]; return self::sendMsg($agent_id, $userid, $msgData); } } ``` ## 登錄 1. 前端， 通過`corpId`換取`code` ```javascript <scriptsrc="http://g.alicdn.com/dingding/dingtalk-pc-api/2.3.1/index.js"></script> <scriptsrc="https://g.alicdn.com/dingding/open-develop/1.6.9/dingtalk.js"></script> dd.ready(function(){ dd.runtime.permission.requestAuthCode({ corpId:{corpId}, onSuccess:function(result) { // result.code }, }); }); DingTalkPC.runtime.permission.requestAuthCode({ corpId:{corpId}, onSuccess:function(result) { // result.code }, onFail:function(err) { } }); dd.error(function(err){ alert('dd error:'+JSON.stringify(err)); }); ``` 2. 獲取`access_token` 3. 通過`code`和`access_token`換取`userid`（釘釘用戶id） ```php $access_token = DingTalk::getAccessToken(); if (!$access_token) error("沒有成功獲取access_token"); // get userid $userid = DingTalk::getUserid($code); if (!$userid) error("授權失敗"); // get userinfo $userinfo = DingTalk::getUserinfo($userid); if (!$userinfo) error('授權失敗'); ``` **其他：發送消息通知** ``` $msgContent = sprintf('您的學員【%s】提交的資料被駁回了，原因請進入系統查看', '測試'); DingTalk::sendTextMsg(DingTalk::AGENT_ID, 釘釘userid, $msgContent); ```