php设置token的方法：1、定义获取Token的路由路径；2、建立Service层；3、使用UserToken类处理整个逻辑；4、在Model层里建立User类；5、在验证器类和异常类创建相应的验证方法和异常处理。

推荐：《PHP视频教程》

PHP_设置权限令牌Token

我们开发的后端API接口会对访问者有一个权限要求，比如一些包含私人信息的接口，就需要访问者请求接口的同时，传递一个提前已经发放给访问者的Token。

这就像一个令牌一样，只有访问者展示出来我们才会“通过放行”。

下面就记录一下权限令牌的代码编写思路。

一、流程概要

二、具体说明

首先定义好路由路径：

Route::post(
 'api/:version/token/user',
 'api/:version.Token/getToken'
);

然后创建Token控制器，定义对应路由路径的getToken方法：

public function getToken($code='') {
 (new TokenGet())->goCheck($code); // 验证器
 $token = (new UserToken($code))->get();
 return [
 'token' => $token
 ];
 }

在调用Service层之前，还得检查一下传递过来的参数，于是定义TokenGet这个验证器：

class TokenGet extends BaseValidate
{
 protected $rule = [
 'code' => 'require|isNotEmpty'
 ];

 protected $message = [
 'code' => '需要code才能获得Token！'
 ];
 }

回到Token控制器，验证通过后，我们调用Service层定义的UserToken类：

$token = (new UserToken($code))->get();复制代码

这里讨论一下Service层和Model层。我们普遍的理解是Service层是基于Model层的一次抽象封装。

但我觉得小项目的话，Service其实和Model就有点平级的意思，因为有些简单的接口Model层直接对接Controller就可以了，只有相对复杂的接口，比如用户权限，就可以再经过Service层分隔不同功能的代码。

这样的处理更加灵活，有大量确实很简单的接口就不用过一次Service层了，这样更像是走过过场而已，没什么意义了。

回到Service层的代码编写，由于Token还会有不同的种类，所以先创建一个Token基类，里面包含一些通用的方法。然后就是给访问者返回令牌的UserToken类的编写了。

由于是基于微信，我们需要三个信息：code，appid，appsecret，然后通过构造函数来给UserToken类赋上初始值：

function __construct($code) {
 $this->code = $code;
 $this->wxAppID = config('wx.app_id');
 $this->wxAppSecret = config('wx.app_secret');
 $this->wxLoginUrl = sprintf(
 config('wx.login_url'),
 $this->wxAppID, $this->wxAppSecret, $this->code
 );
 }

然后把这三个放入微信提供的接口的参数位置，目的是获得一个完整的微信服务器端的url，请求到我们需要的openid。

然后是通过发送网络请求的步骤就在此略过。微信服务器会返回包含openid的对象，判断这个对象的值没问题后，我们就开始生成令牌的步骤了，创建函数grantToken()：

private function grantToken($openidObj) {

 // 取出openid
 $openid = $openidObj['openid'];
 
 // 通过Model层调用数据库，检查openid是否已经存在
 $user = UserModel::getByOpenID($openid);
 
 // 如果存在，不处理，反之则新增一条user记录
 if ($user) {
 $uid = $user->id;
 } else {
 // 不存在，生成一条数据，具体方法略过
 $uid = $this->newUser($openid); 
 }
 
 // 生成令牌，写入缓存（具体方法见下面的定义）
 $cachedValue = $this->prepareCacheValue($openidObj, $uid);
 $token = $this->saveToCache($cachedValue);
 
 // 令牌返回到调用者端
 return $token;
}

private function prepareCacheValue($openidObj, $uid) {
 $cachedValue = $openidObj;
 $cachedValue['uid'] = $uid;
 $cachedValue['scope'] = 16; // 权限值，自己定义
 return $cachedValue;
}
 
private function saveToCache($cachedValue) {
 $key = self::generateToken(); // 生成令牌的方法
 $value = json_encode($cachedValue);
 $tokenExpire = config('setting.token_expire'); // 设定的过期时间

 $request = cache($key, $value, $tokenExpire);
 if (!$request) {
 throw new TokenException([
 'msg' => '服务器缓存异常',
 'errorCode' => 10005
 ]);
 }
 return $key; // 返回令牌:token
}

可以看到，核心流程就是：

其中generateToken()这个方法详细定义如下：

public static function generateToken() {
 $randomChars = getRandomChars(32); // 32个字符组成一组随机字符串
 $timestamp = $_SERVER['REQUEST_TIME_FLOAT']; 
 $salt = config('security.token_salt'); // salt 盐
 // 拼接三组字符串，进行MD5加密，然后返回
 return md5($randomChars.$timestamp.$salt);
}
 
function getRandomChars($length) {
 $str = null;
 $strPoll = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567';
 $max = strlen($strPoll) - 1;

 for ($i = 0; $i < $length; $i++) {
 $str .= $strPoll[rand(0, $max)];
 }
 return $str;
}

它的主要作用毫无疑问就是生成我们的需要的令牌——Token字符串。值得一提的是由于generateToken()在其他类型的Token里也会用到，所以是放在Token基类里的。

至此，只需要把生成的令牌再返回到Controller就行了。

三、总结

令牌的编写涉及到很多的流程，为了避免混乱，一定要注意把负责不同工作的代码分别定义在不同的方法里。就像上面例子里grantToken()方法体现的那样，这是个核心方法，包含所有流程，但是不同的具体流程又定义在其他方法里，然后提供给grantToken()方法调用。

这样做之后grantToken()方法即使包含所有流程，但也依然很容易阅读。