Yii2.0.52 RESTful接口鉴权配置【Token】

云婷姑娘_5730

云婷姑娘_5730

2026-08-10

394人浏览

原创

为 yii2.0.52 项目启用 restful token 鉴权需安装 sizeg/yii2-jwt 扩展,配置 jwt 组件并设置 secret key;在控制器中启用 jwthttpbearerauth 行为强制校验 bearer token;登录成功后生成含 uid、role 等声明的 jwt 并返回,前端须在 authorization 头中携带 bearer 前缀 token。

yii2.0.52 restful接口鉴权配置【token】

为 Yii2.0.52 项目启用 RESTful 接口的 Token 鉴权,需绕过传统 session 登录机制,直接对接 JWT 或 Bearer Token 校验逻辑,确保 API 请求携带有效凭证才能访问受保护资源。

安装并注册 JWT 扩展

执行命令安装 sizeg/yii2-jwt 扩展(兼容 Yii2.0.52):

composer require sizeg/yii2-jwt:^2.0

若 composer 报错 【sh: composer: not found】,先按官方方式手动安装 Composer,再重试;未安装会导致后续所有扩展无法载入。

编辑应用配置文件 config/web.php 或 config/main.php,在 components 数组中注册 jwt 组件:

'jwt' => [
  'class' => 'sizeg\jwt\Jwt',
  'key' => 'your-secret-key-here', // 必须与签发时一致,不可泄露
  'algorithm' => 'HS256',
],

配置控制器行为启用 Bearer Token 鉴权

在需要保护的控制器类中(如 controllers/Api/PostController.php),覆盖 behaviors() 方法:

public function behaviors()
{
  $behaviors = parent::behaviors();
  $behaviors['authenticator'] = [
    'class' => \sizeg\jwt\JwtHttpBearerAuth::class,
  ];
  return $behaviors;
}

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载

这一步会强制该控制器下所有 action 检查请求头中的 Authorization: Bearer <token></token>;若缺失或无效,直接返回 401 状态码。

注意:若控制器同时支持 OPTIONS 预检请求(如跨域场景),需显式放行——在 behaviors 中追加 'cors' => ['class' => \yii\filters\Cors::class] 并配置 allowedHeaders。

生成并返回 JWT Token

第一步:在登录接口(如 controllers/Api/AuthController.php 的 actionLogin)中验证用户名密码成功后,构建 Token:

$time = time();
$token = Yii::$app->jwt->getBuilder()
  ->issuedBy('https://api.example.com')
  ->permittedFor('https://frontend.example.com')
  ->identifiedBy(uniqid(), true)
  ->issuedAt($time)
  ->expiresAt($time + 3600)
  ->withClaim('uid', $user->id)
  ->withClaim('role', $user->role)
  ->getToken();

第二步:将 Token 字符串作为响应体返回,例如:

return ['token' => (string)$token, 'expires_in' => 3600];

第三步:前端必须在后续每个请求头中携带该 Token,格式为:Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...。漏掉 Bearer 前缀或空格会导致鉴权失败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

2025.11.26

544

16

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

2023.09.14

14026

6

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1665

5

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

2023.12.21

3857

3

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

2024.03.01

6021

5

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2025.09.04

3070

22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

20

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

0

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习