Laravel Cache 缓存钉钉微应用的 Access Token

钉钉微应用的 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，是因为我看到表中产生了其他缓存数据，总之缓存的数量看上去不可控。服务器的内存太小，暂时不想冒这个风险。