0

0

详细介绍Laravel Passport的流程、配置和使用

PHPz

PHPz

发布时间:2023-04-23 09:17:58

|

1786人浏览过

|

来源于php中文网

原创

laravel passport是laravel框架下的一款完整的oauth2服务端实现, 允许你通过api对用户身份进行认证和授权,使得api服务可以在无需暴露用户凭据的情况下进行访问,这大大降低了客户端开发的难度,提高了应用程序的安全性。

Laravel Passport背后的OAuth2协议是业界标准,所以你可以使用相同的工具和流程,轻松地在其他语言和框架中集成OAuth2认证和授权。下面,本文将详细介绍Laravel Passport的流程、配置和使用。

安装Passport

在使用Laravel Passport之前,需要先安装它。我们可以使用composer命令来安装Passport,命令如下:

composer require laravel/passport

启用Passport

Laravel Passport安装完毕后,需要将其服务提供程序添加到config/app.php文件中的providers数组中,打开该文件,找到providers数组并添加Laravel Passport的服务提供程序,如下所示:

'providers' => [
    // Other Service Providers...
    Laravel\Passport\PassportServiceProvider::class,
],

创建数据库表

在使用Laravel Passport之前,还需要新建Passport所需的数据库表,可以使用以下artisan命令来生成迁移文件:

php artisan migrate

执行以上命令后,Laravel Passport将在你的数据库中创建几个新的表来保存OAuth2客户端、Access Token和Refresh Token等数据。

发布配置文件

执行以下artisan命令,将Passport的配置文件发布到Laravel项目的config目录下:

php artisan vendor:publish --tag=passport-config

创建密钥

到此,我们已经做好了使用Laravel Passport所需的前置条件。接下来,我们需要使用以下artisan命令来生成加密密钥:

php artisan passport:keys

以上命令将生成encryption keys,用于签署cookie和access token等数据。

配置Passport

完成上述步骤后,我们接下来需要配置Passport,以便使其运行。在config/auth.php配置文件中,将api驱动程序的driver更改为passport,并设置guards和providers,如下所示:

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'api' => [
        'driver' => 'passport',
        'provider' => 'users',
    ],
],

在同一个文件中配置providers,如下所示:

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],
],

一旦配置文件完成, API认证便已经就绪。

创建Route

接下来,我们需要在app/Http路由文件中创建API路由,如下所示:

企业网站管理系统源码2.0
企业网站管理系统源码2.0

这是一款比较精美的企业网站管理系统源码,功能比较完整,比较适合新手学习交流使用,也可以作为毕业设计或者课程设计使用,感兴趣的朋友可以下载看看哦。功能介绍:该源码主要包括前台和后台两大部分,具体功能如下:网站前台模块:主要包括企业简介、新闻中心、产品展示、公司证书、工程业绩、联系我们、客户系统、人才招聘等信息的浏览,以及客户留言的功能。网站后台模块1、常规管理:企业简介、链接管理、投票管理、系统设置

下载
Route::middleware('auth:api')->get('/user', function (Request $request) {
    return $request->user();
});

在以上路由示例中,定义了auth:api中间件,用于验证请求是否来自已认证用户,若非已认证用户,则在验证失败时返回401状态码。

创建Client

现在,我们已经完成了应用程序配置和API路由的设置,接下来需要创建API客户端。在Laravel Passport中,提供了artisan命令passport:client,用于创建新的OAuth2客户端。执行如下所示的命令:

php artisan passport:client --client

在执行命令后,我们需要输入客户端名称和授权重定向URI,如下所示:

php artisan passport:client --client
Which user ID should the client be assigned to? [0]:
 > 1
What should we name the client?
 > Test
Where should we redirect the request after authorization?
 > http://example.com/callback

以上命令将创建一个新的OAuth2客户端,用于向此应用程序的API发送请求。我们将得到一个客户端ID和客户端密钥,用于后面的API请求中。

获取授权

客户端已经创建完成,并获得了授权重定向URI,现在我们需要向该URI发送一个请求,用以获取授权。之后,Passport将会为客户端生成访问令牌,并返回给该客户端。使用如下所示的URL,替换其中的Client ID和重定向URI:

http://your-app.com/oauth/authorize?client_id={client-id}&redirect_uri={redirect-uri} &response_type=code&scope=

在输入URL后,如下所示的OAuth2授权屏幕将会显示:

oauth_screen

在点击'Authorize'按钮后,将会发生授权并重定向到重定向URI。

获取访问令牌

现在,我们已经获得了授权,并且客户端已经被授予访问API的权限。我们需要使用OAuth2授权码,与客户端密钥换取访问令牌,我们可以使用如下所示的curl命令,从API授权服务器获得访问令牌:

$ curl -X POST -H "Accept: application/json" -F "client_id={client-id}" -F "client_secret={client-secret}" -F "grant_type=authorization_code" -F "code={code}" -F "redirect_uri={redirect-uri}" http://your-app.com/oauth/token

执行以上命令后,将得到如下所示的JSON对象,其中包含access_token和refresh_token等信息:

{
    "token_type": "Bearer",
    "expires_in": 86400,
    "access_token": "{access-token}",
    "refresh_token": "{refresh-token}",
}

使用访问令牌进行API请求

现在,我们已经获得了访问令牌,我们可以使用访问令牌与API进行请求。我们需要在API请求头部中增加Authorization头,并设置Bearer鉴权方案,将访问令牌作为令牌内容即可,如下所示:

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'http://your-app.com/api/user', [
    'headers' => [
        'Authorization' => 'Bearer '.$accessToken,
        'Accept' => 'application/json',
    ],
]);

在以上代码中,我们将访问令牌以Bearer TOKEN 的格式提交到API服务端进行验证,成功后将得到API的响应结果。

总结

在本文中,我们讲述了Laravel Passport的流程、配置和使用。使用Laravel Passport,我们可以快速地为API应用程序添加安全的认证和授权,同时支持OAuth2协议,与其他编程语言和框架实现OAuth2授权的应用程序进行互操作,这使得开发者能够快速地构建安全性高、易于使用的API应用程序。

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

相关专题

更多
Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

8

2026.01.15

公务员递补名单公布时间 公务员递补要求
公务员递补名单公布时间 公务员递补要求

公务员递补名单公布时间不固定,通常在面试前,由招录单位(如国家知识产权局、海关等)发布,依据是原入围考生放弃资格,会按笔试成绩从高到低递补,递补考生需按公告要求限时确认并提交材料,及时参加面试/体检等后续环节。要求核心是按招录单位公告及时响应、提交材料(确认书、资格复审材料)并准时参加面试。

44

2026.01.15

公务员调剂条件 2026调剂公告时间
公务员调剂条件 2026调剂公告时间

(一)符合拟调剂职位所要求的资格条件。 (二)公共科目笔试成绩同时达到拟调剂职位和原报考职位的合格分数线,且考试类别相同。 拟调剂职位设置了专业科目笔试条件的,专业科目笔试成绩还须同时达到合格分数线,且考试类别相同。 (三)未进入原报考职位面试人员名单。

58

2026.01.15

国考成绩查询入口 国考分数公布时间2026
国考成绩查询入口 国考分数公布时间2026

笔试成绩查询入口已开通,考生可登录国家公务员局中央机关及其直属机构2026年度考试录用公务员专题网站http://bm.scs.gov.cn/pp/gkweb/core/web/ui/business/examResult/written_result.html,查询笔试成绩和合格分数线,点击“笔试成绩查询”按钮,凭借身份证及准考证进行查询。

11

2026.01.15

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

65

2026.01.14

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

36

2026.01.13

PHP 高性能
PHP 高性能

本专题整合了PHP高性能相关教程大全,阅读专题下面的文章了解更多详细内容。

75

2026.01.13

MySQL数据库报错常见问题及解决方法大全
MySQL数据库报错常见问题及解决方法大全

本专题整合了MySQL数据库报错常见问题及解决方法,阅读专题下面的文章了解更多详细内容。

21

2026.01.13

PHP 文件上传
PHP 文件上传

本专题整合了PHP实现文件上传相关教程,阅读专题下面的文章了解更多详细内容。

35

2026.01.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号