Lumen Passport安装配置全解bootstrap/app.php逐行配置与密钥生成详解【免费下载链接】lumen-passportMaking Laravel Passport work with Lumen项目地址: https://gitcode.com/gh_mirrors/lu/lumen-passportLumen Passport安装配置是很多 Laravel 开发者转向 Lumen 微框架后的第一道坎Lumen 天生不带 Laravel Passport而 lu/lumen-passport 这个项目正是为了解决这一痛点而生——它的全部使命就是Making Laravel Passport work with Lumen让 Lumen 也能拥有完整的 OAuth2 令牌签发能力。本文将以零基础视角带你完成 Lumen Passport 的完整安装、bootstrap/app.php 逐行配置以及 passport:install 密钥生成的详细演示全程可复制、可运行。 为什么 Lumen 需要 lumen-passportLaravel Passport 是 Laravel 官方推荐的 OAuth2 服务端实现但它的服务提供者依赖 Lumen 不具备的部分容器能力。lumen-passport 通过一个极简的服务提供者src/PassportServiceProvider.php把两者桥接起来同时补齐了config_path()等 Lumen 缺失的辅助函数见 src/helpers.php。 第一步安装 Lumen Passport 扩展包先准备好一个 Lumen 项目然后执行一行命令composer require dusterio/lumen-passport安装完成后整个扩展包的核心逻辑都在src/目录下结构非常清晰服务提供者负责注册src/LumenPassport.php 提供路由注册与高级配置入口。 第二步bootstrap/app.php 逐行配置核心步骤这是全流程最关键的一步。打开bootstrap/app.php按以下顺序逐行添加配置。1️⃣ 开启 Facades 与 EloquentLumen 默认不加载这两项而 Passport 的模型和加密都依赖它们// 开启 Facades门面 $app-withFacades(); // 开启 Eloquent ORM $app-withEloquent();2️⃣ 注册 auth 路由中间件Passport 的令牌管理接口需要认证保护因此必须先注册 Lumen 自带的 auth 中间件$app-routeMiddleware([ auth App\Http\Middleware\Authenticate::class, ]);3️⃣ 注册两个服务提供者顺序不能错Lumen Passport 需要同时注册Laravel Passport 官方提供者和本项目的适配提供者$app-register(Laravel\Passport\PassportServiceProvider::class); $app-register(Dusterio\LumenPassport\PassportServiceProvider::class);适配提供者的作用是在 boot 阶段注册数据库连接单例并挂载passport:purge清理命令实现见 src/Console/Commands/Purge.php。4️⃣ Lumen 7.x 用户替换 Application 类如果你使用 Laravel Passport 7.3.2需要把默认的 Application 换成项目提供的兼容类否则会报方法不存在//$app new Laravel\Lumen\Application(dirname(__DIR__)); $app new \Dusterio\LumenPassport\Lumen7Application(dirname(__DIR__));这个类的原理很简单只是新增了一个永远返回false的configurationIsCached()方法源码见 src/Lumen7Application.php。5️⃣ 加载 auth 配置文件Lumen 不会自动加载配置文件需要手动声明$app-configure(auth);同时在config/auth.php中配置用户提供者例如使用 Eloquent 驱动指向你的 User 模型。 第三步注册 OAuth 路由在某个服务提供者的boot()方法中调用路由注册方法例如新建app/Providers/AuthServiceProvider.phpuse Dusterio\LumenPassport\LumenPassport; class AuthServiceProvider extends ServiceProvider { public function boot() { LumenPassport::routes($this-app); } }调用后会自动挂载/oauth/token、/oauth/tokens、/oauth/clients等全部 OAuth 端点具体清单定义在 src/RouteRegistrar.php 中。 第四步数据迁移与 passport:install 密钥生成这是「密钥生成详解」的重头戏依次执行两条命令# 创建 Passport 所需的数据库表 php artisan migrate # 生成加密密钥与 OAuth 客户端并写入数据库 php artisan passport:install执行完成后命令行会输出两类凭据务必妥善保存Personal access client的 ID 与 secret用于个人访问令牌Password grant client的 ID 与 secret用于密码授权换取 access_token 第五步用 curl 快速验证令牌签发用第四步拿到的客户端凭据向/oauth/token发起密码授权请求curl --location --request POST {{APP_URL}}/oauth/token \ --header Content-Type: application/json \ --data-raw { grant_type: password, client_id: {{CLIENT_ID}}, client_secret: {{CLIENT_SECRET}}, username: {{USER_EMAIL}}, password: {{USER_PASSWORD}}, scope: * }返回的 JSON 中包含access_token和refresh_token将其放入请求头即可访问受保护接口curl --location --request GET {{APP_URL}}/ping \ --header Authorization: Bearer {{ACCESS_TOKEN}} 进阶技巧与常见问题允许多设备同时登录默认同一客户端新令牌会吊销旧令牌调用LumenPassport::allowMultipleTokens()即可放行逻辑在 src/Http/Controllers/AccessTokenController.php 中实现。为不同客户端设置不同有效期LumenPassport::tokensExpireIn(Carbon::now()-addDays(14), $clientId);清理过期令牌php artisan passport:purge这条命令会删除所有过期的 refresh_token 及其关联的 access_token保持数据库干净整洁。✅ 总结到这里Lumen Passport 安装配置已经全部完成从composer require到 bootstrap/app.php 逐行配置再到passport:install密钥生成一条龙流程清晰可控。只要严格按上述顺序配置两个服务提供者、替换 Lumen7 的 Application 类你的 Lumen 项目就能像 Laravel 一样优雅地签发和校验 OAuth2 令牌了。【免费下载链接】lumen-passportMaking Laravel Passport work with Lumen项目地址: https://gitcode.com/gh_mirrors/lu/lumen-passport创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考