<?php
namespace app\controller\api;
use laytp\controller\Api;
use laytp\library\Random;
/**
* Token相关
*/
class Token extends Api
{
public $no_need_login = [];
/*@formatter:off*/
/**
* @ApiTitle (检测Token是否过期)
* @ApiSummary (检测Token是否过期)
* @ApiMethod (POST)
* @ApiRoute (/api.token/check)
* @ApiHeaders (name="token", type="string", required="true", description="用户登录后得到的Token")
* @ApiReturnParams (name="code", type="integer", description="接口返回码.0=常规正确码，表示常规操作成功；1=常规错误码，客户端仅需提示msg；其他返回码与具体业务相关。框架实现了的唯一其他返回码：10401，前端需要跳转至登录界面。在一个复杂的交互过程中，你可能需要自行定义其他返回码")
* @ApiReturnParams (name="msg", type="string", description="返回描述")
* @ApiReturnParams (name="time", type="integer", description="请求时间，Unix时间戳，单位秒")
* @ApiReturnParams (name="data", type="object", description="返回的数据对象")
* @ApiReturnParams (name="data.token", type="string", description="用户登录凭证，token")
* @ApiReturnParams (name="data.expires_in", type="integer", description="token有效时间，单位秒")
* @ApiReturn
({
"code": 0,
"msg": "Token有效",
"time": 1591167181,
"data": {
"token": "827fb87e-2064-45c8-839a-128e195a7411",
"expires_in": 1789
}
})
*/
/*@formatter:on*/
public function check()
{
$token = $this->service_user->getToken();
$tokenInfo = \library\Token::get($token);
$this->success('Token有效', ['token' => $tokenInfo['token'], 'expires_in' => $tokenInfo['expires_in']]);
}
/*@formatter:off*/
/**
* @ApiTitle (刷新Token)
* @ApiSummary (刷新Token)
* @ApiMethod (POST)
* @ApiRoute (/api.token/refresh)
* @ApiHeaders (name="token", type="string", required="true", description="用户登录后得到的Token")
* @ApiReturnParams (name="code", type="integer", description="接口返回码.0=常规正确码，表示常规操作成功；1=常规错误码，客户端仅需提示msg；其他返回码与具体业务相关。框架实现了的唯一其他返回码：10401，前端需要跳转至登录界面。在一个复杂的交互过程中，你可能需要自行定义其他返回码")
* @ApiReturnParams (name="msg", type="string", description="返回描述")
* @ApiReturnParams (name="time", type="integer", description="请求时间，Unix时间戳，单位秒")
* @ApiReturnParams (name="data", type="object", description="返回的数据对象")
* @ApiReturnParams (name="data.token", type="string", description="用户登录凭证，token")
* @ApiReturnParams (name="data.expires_in", type="integer", description="token有效时间，单位秒")
* @ApiReturn
({
"code": 0,
"msg": "成功刷新Token",
"time": 1591167423,
"data": {
"token": "e356df60-ff03-4f15-bb66-c0e3ef37f335",
"expires_in": 1800
}
})
*/
/*@formatter:on*/
public function refresh()
{
//删除源Token
$token = $this->service_user->getToken();
\library\Token::delete($token);
//创建新Token
$token = Random::uuid();
\library\Token::set($token, $this->service_user->id, $this->service_user->token_keep_time);
$this->success('成功刷新Token', ['token' => $token, 'expires_in' => $this->service_user->token_keep_time]);
}
}