首页 / PHP / yii2项目实战之restful api授权验证详解

yii2项目实战之restful api授权验证详解

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了yii2项目实战之restful api授权验证详解，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含11155字，纯文字阅读大概需要16分钟。

内容图文

前言

什么是restful风格的api呢？我们之前有写过大篇的文章来介绍其概念以及基本操作。

既然写过了，那今天是要说点什么吗？

这篇文章主要针对实际场景中api的部署来写。

我们今天就来大大的侃侃那些年api遇到的授权验证问题！独家干活，如果看完有所受益，记得不要忘记给我点赞哦。

业务分析

我们先来了解一下整个逻辑

用户在客户端填写登录表单
用户提交表单，客户端请求登录接口login
服务端校验用户的帐号密码，并返回一个有效的token给客户端
客户端拿到用户的token，将之存储在客户端比如cookie中
客户端携带token访问需要校验的接口比如获取用户个人信息接口
服务端校验token的有效性，校验通过，反正返回客户端需要的信息，校验失败，需要用户重新登录

本文我们以用户登录，获取用户的个人信息为例进行详细的完整版说明。
以上，便是我们本篇文章要实现的重点。先别激动，也别紧张，分析好了之后，细节部分我们再一步一个脚印走下去。

准备工作

你应该有一个api应用，如果你还没有，请先移步这里→_→Restful api基础
对于客户端，我们准备采用postman进行模拟，如果你的google浏览器还没有安装postman，请先自行下载
要测试的用户表需要有一个api_token的字段，没有的请先自行添加，并保证该字段足够长度
api应用开启了路由美化，并先配置post类型的login操作和get类型的signup-test操作
关闭了user组件的session会话

关于上面准备工作的第4点和第5点，我们贴一下代码方便理解

'components' => [
 'user' => [ 
 'identityClass' => 'common\models\User',
 'enableAutoLogin' => true,
 'enableSession' => false,
 ],
 'urlManager' => [
 'enablePrettyUrl' => true,
 'showScriptName' => false,
 'enableStrictParsing' => true,
 'rules' => [
  [
  'class' => 'yii\rest\UrlRule',
  'controller' => ['v1/user'],
  'extraPatterns' => [
   'POST login' => 'login',
   'GET signup-test' => 'signup-test',
  ]
  ],
 ]
 ],
 // ......
],

signup-test操作我们后面添加测试用户，为登录操作提供便利。其他类型的操作后面看需要再做添加。

认证类的选择

我们在api\modules\v1\controllers\UserController中设定的model类指向 common\models\User类，为了说明重点这里我们就不单独拿出来重写了，看各位需要，有必要的话再单独copy一个User类到api\models下。

校验用户权限我们以 yii\filters\auth\QueryParamAuth 为例

use yii\filters\auth\QueryParamAuth;

public function behaviors() 
{
 return ArrayHelper::merge (parent::behaviors(), [ 
  'authenticator' => [ 
  'class' => QueryParamAuth::className() 
  ] 
 ] );
}

如此一来，那岂不是所有访问user的操作都需要认证了？那不行，客户端第一个访问login操作的时候哪来的token，yii\filters\auth\QueryParamAuth对外提供一个属性，用于过滤不需要验证的action。我们将UserController的behaviors方法稍作修改

public function behaviors() 
{
 return ArrayHelper::merge (parent::behaviors(), [ 
  'authenticator' => [ 
  'class' => QueryParamAuth::className(),
  'optional' => [
   'login',
   'signup-test'
  ],
  ] 
 ] );
}

这样login操作就无需权限验证即可访问了。

添加测试用户

为了避免让客户端登录失败，我们先写一个简单的方法，往user表里面插入两条数据，便于接下来的校验。

UserController增加signupTest操作，注意此方法不属于讲解范围之内，我们仅用于方便测试。

use common\models\User;
/**
 * 添加测试用户
 */
public function actionSignupTest ()
{
 $user = new User();
 $user->generateAuthKey();
 $user->setPassword('123456');
 $user->username = '111';
 $user->email = '111@111.com';
 $user->save(false);

 return [
 'code' => 0
 ];
}

如上，我们添加了一个username是111，密码是123456的用户

登录操作

假设用户在客户端输入用户名和密码进行登录，服务端login操作其实很简单，大部分的业务逻辑处理都在api\models\loginForm上，来先看看login的实现

use api\models\LoginForm;

/**
 * 登录
 */
public function actionLogin ()
{
 $model = new LoginForm;
 $model->setAttributes(Yii::$app->request->post());
 if ($user = $model->login()) {
 if ($user instanceof IdentityInterface) {
  return $user->api_token;
 } else {
  return $user->errors;
 }
 } else {
 return $model->errors;
 }
}

登录成功后这里给客户端返回了用户的token，再来看看登录的具体逻辑的实现

新建api\models\LoginForm.PHP

<?php
namespace api\models;

use Yii;
use yii\base\Model;
use common\models\User;

/**
 * Login form
 */
class LoginForm extends Model
{
 public $username;
 public $password;

 private $_user;

 const GET_API_TOKEN = 'generate_api_token';

 public function init ()
 {
 parent::init();
 $this->on(self::GET_API_TOKEN, [$this, 'onGenerateApiToken']);
 }


 /**
 * @inheritdoc
 * 对客户端表单数据进行验证的rule
 */
 public function rules()
 {
 return [
  [['username', 'password'], 'required'],
  ['password', 'validatePassword'],
 ];
 }

 /**
 * 自定义的密码认证方法
 */
 public function validatePassword($attribute, $params)
 {
 if (!$this->hasErrors()) {
  $this->_user = $this->getUser();
  if (!$this->_user || !$this->_user->validatePassword($this->password)) {
  $this->addError($attribute, '用户名或密码错误.');
  }
 }
 }
 /**
 * @inheritdoc
 */
 public function attributeLabels()
 {
 return [
  'username' => '用户名',
  'password' => '密码',
 ];
 }
 /**
 * Logs in a user using the provided username and password.
 *
 * @return boolean whether the user is logged in successfully
 */
 public function login()
 {
 if ($this->validate()) {
  $this->trigger(self::GET_API_TOKEN);
  return $this->_user;
 } else {
  return null;
 }
 }

 /**
 * 根据用户名获取用户的认证信息
 *
 * @return User|null
 */
 protected function getUser()
 {
 if ($this->_user === null) {
  $this->_user = User::findByUsername($this->username);
 }

 return $this->_user;
 }

 /**
 * 登录校验成功后，为用户生成新的token
 * 如果token失效，则重新生成token
 */
 public function onGenerateApiToken ()
 {
 if (!User::apiTokenIsValid($this->_user->api_token)) {
  $this->_user->generateApiToken();
  $this->_user->save(false);
 }
 }
}

我们回过头来看一下，当我们在UserController的login操作中调用LoginForm的login操作后都发生了什么

1、调用LoginForm的login方法

2、调用validate方法，随后对rules进行校验

3、rules校验中调用validatePassword方法，对用户名和密码进行校验

4、validatePassword方法校验的过程中调用LoginForm的getUser方法，通过common\models\User类的findByUsername获取用户，找不到或者common\models\User的validatePassword对密码校验失败则返回error

5、触发LoginForm::GENERATE_API_TOKEN事件，调用LoginForm的onGenerateApiToken方法,通过common\models\User的apiTokenIsValid校验token的有效性，如果无效，则调用User的generateApiToken方法重新生成

注意：common\models\User类必须是用户的认证类，如果不知道如何创建完善该类，请围观这里用户管理之user组件的配置

下面补充本节增加的common\models\User的相关方法

/**
 * 生成 api_token
 */
public function generateApiToken()
{
 $this->api_token = Yii::$app->security->generateRandomString() . '_' . time();
}

/**
 * 校验api_token是否有效
 */
public static function apiTokenIsValid($token)
{
 if (empty($token)) {
 return false;
 }

 $timestamp = (int) substr($token, strrpos($token, '_') + 1);
 $expire = Yii::$app->params['user.apiTokenExpire'];
 return $timestamp + $expire >= time();
}

继续补充apiTokenIsValid方法中涉及到的token有效期，在api\config\params.php文件内增加即可

<?php
return [
 // ...
 // token 有效期默认1天
 'user.apiTokenExpire' => 1*24*3600,
];

到这里呢，客户端登录服务端返回token给客户端就完成了。

按照文中一开始的分析，客户端应该把获取到的token存到本地，比如cookie中。以后再需要token校验的接口访问中，从本地读取比如从cookie中读取并访问接口即可。

根据token请求用户的认证操作

假设我们已经把获取到的token保存起来了，我们再以访问用户信息的接口为例。

yii\filters\auth\QueryParamAuth类认定的token参数是 access-token，我们可以在行为中修改下

public function behaviors() 
{
 return ArrayHelper::merge (parent::behaviors(), [ 
   'authenticator' => [ 
    'class' => QueryParamAuth::className(),
    'tokenParam' => 'token',
    'optional' => [
     'login',
     'signup-test'
    ],
   ] 
 ] );
}

这里将默认的access-token修改为token。

我们在配置文件的urlManager组件中增加对userProfile操作

'extraPatterns' => [
 'POST login' => 'login',
 'GET signup-test' => 'signup-test',
 'GET user-profile' => 'user-profile',
]

我们用postman模拟请求访问下 /v1/users/user-profile?token=apeuT9dAgH072qbfrtihfzL6qDe_l4qz_1479626145发现，抛出了一个异常

\"findIdentityByAccessToken\" is not implemented.

这是怎么回事呢？

我们找到 yii\filters\auth\QueryParamAuth 的authenticate方法，发现这里调用了 common\models\User类的loginByAccessToken方法，有同学疑惑了，common\models\User类没实现loginByAccessToken方法为啥说findIdentityByAccessToken方法没实现？如果你还记得common\models\User类实现了yii\web\user类的接口的话，你应该会打开yii\web\User类找答案。没错，loginByAccessToken方法在yii\web\User中实现了，该类中调用了common\models\User的findIdentityByAccessToken，但是我们看到，该方法中通过throw抛出了异常，也就是说这个方法要我们自己手动实现！

这好办了，我们就来实现下common\models\User类的findIdentityByAccessToken方法吧

public static function findIdentityByAccessToken($token, $type = null)
{
 // 如果token无效的话，
 if(!static::apiTokenIsValid($token)) {
  throw new \yii\web\UnauthorizedHttpException("token is invalid.");
 }

 return static::findOne(['api_token' => $token, 'status' => self::STATUS_ACTIVE]);
 // throw new NotSupportedException('"findIdentityByAccessToken" is not implemented.');
}

验证完token的有效性，下面就要开始实现主要的业务逻辑部分了。

/**
 * 获取用户信息
 */
public function actionUserProfile ($token)
{
 // 到这一步，token都认为是有效的了
 // 下面只需要实现业务逻辑即可，下面仅仅作为案例，比如你可能需要关联其他表获取用户信息等等
 $user = User::findIdentityByAccessToken($token);
 return [
  'id' => $user->id,
  'username' => $user->username,
  'email' => $user->email,
 ];
}

服务端返回的数据类型定义

在postman中我们可以以何种数据类型输出的接口的数据，但是，有些人发现，当我们把postman模拟请求的地址copy到浏览器地址栏，返回的又却是xml格式了，而且我们明明在UserProfile操作中返回的是属组，怎么回事呢？

这其实是官方捣的鬼啦，我们一层层源码追下去，发现在yii\rest\Controller类中，有一个 contentNegotiator行为，该行为指定了允许返回的数据格式formats是json和xml，返回的最终的数据格式根据请求头中Accept包含的首先出现在formats中的为准，你可以在yii\filters\ContentNegotiator的negotiateContentType方法中找到答案。

你可以在浏览器的请求头中看到

Accept:

text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8

即application/xml首先出现在formats中，所以返回的数据格式是xml类型，如果客户端获取到的数据格式想按照json进行解析，只需要设置请求头的Accept的值等于application/json即可

有同学可能要说，这样太麻烦了，啥年代了，谁还用xml，我就想服务端输出json格式的数据，怎么做？

办法就是用来解决问题滴，来看看怎么做。api\config\main.php文件中增加对response的配置

'response' => [
 'class' => 'yii\web\Response',
 'on beforeSend' => function ($event) {
  $response = $event->sender;
  $response->format = yii\web\Response::FORMAT_JSON;
 },
],

如此，不管你客户端传什么，服务端最终输出的都会是json格式的数据了。

自定义错误处理机制

再来看另外一个比较常见的问题：

你看我们上面几个方法哈，返回的结果是各式各样的，这样就给客户端解析增加了困扰，而且一旦有异常抛出，返回的代码还都是一堆一堆的，头疼，怎么办？

说到这个问题之前呢，我们先说一下yii中先关的异常处理类，当然，有很多哈。比如下面常见的一些，其他的自己去挖掘

yii\web\BadRequestHttpException
yii\web\ForbiddenHttpException
yii\web\NotFoundHttpException
yii\web\ServerErrorHttpException
yii\web\UnauthorizedHttpException
yii\web\TooManyRequestsHttpException

实际开发中各位要善于去利用这些类去捕获异常，抛出异常。说远了哈，我们回到重点，来说如何自定义接口异常响应或者叫自定义统一的数据格式，比如向下面这种配置，统一响应客户端的格式标准。

'response' => [
 'class' => 'yii\web\Response',
 'on beforeSend' => function ($event) {
  $response = $event->sender;
  $response->data = [
   'code' => $response->getStatusCode(),
   'data' => $response->data,
   'message' => $response->statusText
  ];
  $response->format = yii\web\Response::FORMAT_JSON;
 },
],

说道了那么多，本文就要结束了，刚开始接触的同学可能有一些蒙，不要蒙，慢慢消化，先知道这么个意思，了解下restful api接口在整个过程中是怎么用token授权的就好。这样真正实际用到的时候，你也能举一反三！

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。

内容总结

以上是互联网集市为您收集整理的yii2项目实战之restful api授权验证详解全部内容，希望文章能够帮你解决yii2项目实战之restful api授权验证详解所遇到的程序开发问题。如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端

扫描二维码推送至手机访问。

本文链接：https://qyyshop.com/info/273016.html

来源：【匿名】

【上一篇】老生常谈PHP 文件写入和读取(必看篇)【下一篇】PHP 5 数据对象 (PDO) 抽象层与 Oracle

更多 ►

【yii2项目实战之restful api授权验证详解】教程文章相关的互联网学习教程文章

树莓派学习笔记——Restful服务采用slim php apache【图】

0.前言前些时间沉迷于Restful，采用PHP+Slim+MySQL实现了一些简单的API函数。但是这些工作都是在windows中实现（采用wamp server集成安装包），但是转到linux中还确实有些不一样，下面就使用树莓派尝试一把。1.安装php和apache2 在这里仅安装php和apache2，如果需要安装mysql请再增加php5-mysql和mysql-server sudo apt-get update sudo apt-get install apache2 php 2.配置apache2 【为什么配置apache】需...

用PHPStorm的RESTful如何模拟json数据【图】

HI，我尝试使用PHPStorm的REST Client来模拟一条POST数据，数据格式如下：{ "user_ids":[1,2] } 我改如何模拟呢？回复内容： HI，我尝试使用PHPStorm的REST Client来模拟一条POST数据，数据格式如下：{ "user_ids":[1,2] } 我改如何模拟呢？我用RAW模式模拟了JSON，参看这里https://code.google.com/p/chrome-rest-client/issues/detail?id=228

PHP中Restfulapi错误提示返回值实现思路restfulapi例子restful接口jerseyrestful

RESTful架构是一种流行的互联网软件架构，它结构清晰，符合标准，易于理解，扩展方便。REST是Representational State Transfer的缩写，翻译为“表现层状态转化”。表现层其实就是资源，因此可以理解为“资源状态转化”。网络应用上的任何实体都可以看作是一种资源，通过一个URI(统一资源定位符)指向它。序言不管是微博还是淘宝，他们都有自己的错误返回值格式规范，以及错误代码说明，这样不但手机端用起来方便，给人的感觉也清晰明...

php-Symfony Restful API-公开当前登录用户的isLiked虚拟属性【代码】

有两个实体Restaurant和Users.餐馆实体与用户,字段名称favoriteBy具有多对多关系.<many-to-many field="favoriteBy" target-entity="UserBundle\Entity\Users" mapped-by="favoriteRestaurants"/>我正在将JMS序列化程序与FOSRestfulAPI一起使用.在餐厅列表API中,我必须公开一个额外的布尔字段“ isFavorited”,如果当前登录的用户在数组集合favoriteBy中,则为true. 我如何才能找到当前用户是否喜欢实体中的餐厅？/*** Get is favor...

PHP编写RESTful接口的方法，php编写restful_PHP教程

PHP编写RESTful接口的方法，php编写restful这是一个轻量级框架，专为快速开发RESTful接口而设计。如果你和我一样，厌倦了使用传统的MVC框架编写微服务或者前后端分离的API接口，受不了为了一个简单接口而做的很多多余的coding（和CTRL-C/CTRL-V），那么，你肯定会喜欢这个框架！先举个栗子 1、写个HelloWorld.php，放到框架指定的目录下（默认是和index.php同级的apis/目录）/*** @path("/hw")*/ class HelloWorld {/** * @route(...

php-通过Yii2 RESTful API上的其他字段过滤【代码】

首先抱歉英语不好！我正在YII2中测试一个RESTful API,创建它非常容易,遵循official guide.但是(据我所知)默认情况下,我只能将id作为参数传递来获取特定记录. 例如,假设我有一个名为person的下表：ID,姓名,年龄,性别,电子邮件,电话在这种情况下,我只能按ID进行过滤,如下所示：http：// myserver / api / persons / 1 我需要知道如何按其他字段进行过滤,例如年龄或性别. 我的控制器：class PersonController extends ActiveControl...

RESTful中登录接口怎么命名呢？

在RESTful架构中，每个网址代表一种资源（resource），所以网址中不能有动词，只能有名词，而且所用的名词往往与数据库的表格名对应。一般来说，数据库中的表都是同种记录的"集合"（collection），所以API中的名词也应该使用复数。GET /zoos：列出所有动物园POST /zoos：新建一个动物园GET /zoos/ID：获取某个指定动物园的信息PUT /zoos/ID：更新某个指定动物园的信息（提供该动物园的全部信息）PATCH /zoos/ID：更新某个指定动物园...

php处理restful请求的路由类分享_PHP教程

代码如下: class Router { // 路由表 private $routers = array( array("name"=>"userlist", "pattern"=>"get /user", "action"=>"User#get"), array("name"=>"userinfo", "pattern"=>"get /user/:s", "action"=>"User#getById"), array("name"=>"useradd", "pattern"=>"post /user", "action"=>"User#add"), array("name"=>"userupdate", "pattern"=>"update /user...

什么是restful架构？【图】

用最简单的语言说清楚什么是restful架构。不要复制网上的，我看了好多长篇大论感觉还是一头雾水啊回复内容：用最简单的语言说清楚什么是restful架构。不要复制网上的，我看了好多长篇大论感觉还是一头雾水啊简单地说，RESTful架构就是简化HTTP方法，要获取数据用GET方法，要上传数据用POST或者PUT，要删除数据就用DELETE。和数据库的CRUD类似，即以数据为中心的架构。可以看看我2011年写的一篇文章：http://www.infoq.com/cn/artic...

求大神帮忙，CI访问restful问题

CI访问restful服务，服务是C#写的，返回的数据格式为json 接口：MemberService。方法login(int a,string b,string c) 我在网上找了些资料，参考上面写了结果报错。我的代码如下： $this->load->library(rest,array(server=>http://localhost/TeamLoggingWebHost/MemberService.svc/,http_auto=>basic));$param=array(a=>1,b=>hh,c=>kk);$result=$this->rest->Get(login,$param,application/json); 调试后报错 Unab...

如何POST一个JSON格式的数据给Restful服务

在Android/java平台上实现POST一个json数据：JSONObject jsonObj =newJSONObject();jsonObj.put("username", username);jsonObj.put("apikey", apikey);// Create the POST object and add the parametersHttpPost httpPost =newHttpPost(url);StringEntity entity =newStringEntity(jsonObj.toString(), HTTP.UTF_8);entity.setContentType("application/json");httpPost.setEntity(entity);HttpClient client =newDefaultHttpCli...

如何自定义Yii2的RESTful数据Model

如何自己写一个 Model 继承 yii\base\Model 来实现RESTful 的所有操作。现在我的主要问题是，我用了 Yii2 的 RESTful 和 RBAC，现在我希望用户在后台可以对权限进行修改。比如权限管理 Permission Manager列出所有的权限的真实代码，这个就是数据源$auth = Yii::$app->getAuthManager();$permissions = $auth->getPermissions(); 创建一个权限：当然 permissionName 是接收的用户输入的值$auth = Yii::$app->getAuthManager();$p...

PHP中Restful api 错误提示返回值实现思路