钉钉微应用的 Access token 如何获取?
Access_Token 是企业访问钉钉开放平台全局接口的唯一凭证,即调用接口时需携带Access_Token。从接口列表看,所有接口都需要携带 access token。
对于企业接入来说,AccessToken 需要用 CorpID 和 CorpSecret 来换取,CorpID 是企业在钉钉中的标识;每个企业拥有一个唯一的 CorpID,CorpSecret 是企业每个微应用的凭证密钥。
CorpID和CorpSecret可以在开发者后台中找到。
不同的 CorpSecret 会返回不同的 AccessToken。
正常情况下AccessToken有效期为7200秒,有效期内重复获取返回相同结果,并自动续期。
请求方式:GET
接口地址:https://oapi.dingtalk.com/gettoken?corpid=id&corpsecret=secrect
返回示例
{ "errcode": 0, "errmsg": "ok", "access_token": "fw8ef8we8f76e6f7s8df8s" }
Laravel Cache 对 access token 进行缓存
https://laravel.com/docs/5.5/cache
Laravel 默认是使用文件 file 进行缓存存储的,当然,也可以替换为 mysql, redis 的存储方案。
但是当对性能要求不高的情况下,使用文件存储缓存足矣。
- 省去了对数据库的依赖,方便运维和部署
- 另外也避免了小内存服务器内存不足的尴尬情况
cache 的基本使用
$value = cache('key'); // 获取 key 对应的值
Cache 设置缓存的第二个参数支持两种类型
- 整数。代表N分钟后失效
- datetime。代表到哪个时间点失效
cache(['key' => 'value'], $minutes); cache(['key' => 'value'], now()->addSeconds(10)); cache(['key' => 'value'], now()->addMinutes(10));
示例代码
/** * 获取 Access Token * * 如果 access token 不存在,或者失效,重新获取。 * 若未失效,继续使用 cache 中的 token. */ public function get_access_token() { // 先判断 cache 中是否存在 $key = 'dingding_access_token'; $access_token = cache($key); if ($access_token) { return $access_token; } Log::info('No access token in cache. Getting...'); $client = new Client(); $url = sprintf( "https://oapi.dingtalk.com/gettoken?corpid=%s&corpsecret=%s", env("CORP_ID"), env("CORP_SECRET")); $res = $client->request('GET', $url, ['timeout' => 1.5]); $res = $res->getBody(); $res = json_decode($res); if ($res->errcode == 0) { cache([$key => $res->access_token], now()->addSeconds(7000)); return $res->access_token; } else { abort(403, 'Fail to get dingding access token.'); } }
使用 mysql 作为 cache 缓存的存储方案
如果希望修改 cache 的存储方案为 mysql,可以进行如下操作。
修改 .env 配置
将
CACHE_DRIVER=file
替换为
CACHE_DRIVER=database
新建对应得 mysql cache 表
php artisan cache:table php artisan migrate // 对应生成的数据表 CREATE TABLE `cache` ( `key` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL, `value` mediumtext COLLATE utf8mb4_unicode_ci NOT NULL, `expiration` int(11) NOT NULL, UNIQUE KEY `cache_key_unique` (`key`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
之所以没有使用 mysql 或者 redis 存储 cache,是因为我看到表中产生了其他缓存数据,总之缓存的数量看上去不可控。服务器的内存太小,暂时不想冒这个风险。