Laravel 发布了 v6.2 版本,它添加了一个新的密码确认功能,该功能使你可以要求已登录的用户重新输入密码,然后才能访问路由。
在你执行敏感操作的时候,这个功能就类似GitHub确认对话框。在 Laravel 中你可以轻松的设置它,所以让我们来试用一下新功能,以便你可以更好的了解它的工作原理:
设置
首先,为了更直观的了解这个新功能,我们创建一个新的 Laravel 应用:
laravel new confirm-app cd confirm-app composer require laravel/ui --dev
你知道, make:auth 命令在 Laravel 6 中被移除,相同功能已经迁移到 laravel/ui 这个官方扩展包中. 让我们用新的命令生成用户认证相关的代码:
1 php artisan ui vue --auth 2 yarn install 3 yarn dev
接下来,我们配置 SQLite 数据库 (当然你可以选择自己想用的数据库):
touch database/database.sqlite
我们已经创建好了 Laravel 在使用 sqlite 驱动程序时所需的默认配置文件, 但是你仍然需要去更新.env 文件来确保数据库连接和路径正确:
DB_CONNECTION=sqlite # ... # 使用 sqlite 驱动程序的默认路径 # DB_DATABASE=laravel
接下来,让我们运行迁移,然后创建一个测试用户:
php artisan migrate
我们可以通过 factory() 方法在控制台创建一个测试用户:
1 php artisan tinker 2 >>> $user = factory(AppUser::class)->create([ 3 ... 'password' => bcrypt('secret'), 4 ... 'email' => 'admin@example.com' 5 ... ]);
编写控制器.
假设你希望用户在查看诸如添加 SSH 密钥之类的管理操作之前重新验证其密码。我们希望用户在配置的窗口重新输入他们的密码(默认值是三个小时)。
我们将创建一条伪造的 /settings/ssh/create 路由,在该路由中,我们需要新的 password.confirm 中间件,然后用户才能去创建新的密钥:
php artisan make:controller Settings/SSHController
接下来,在这个控制器中创建方法 create() :
1 namespace AppHttpControllersSettings; 2 3 use AppHttpControllersController; 4 use IlluminateHttpRequest; 5 6 class SSHController extends Controller 7 { 8 public function create() 9 { 10 return view('secret'); 11 } 12 }
我们将存根 secret 模板,并将其放在视图路径的根目录当中 resources/views/secret.blade.php:
1 @extends('layouts.app') 2 @section('content') 3 <div class="container"> 4 <div class="row justify-content-center"> 5 <div class="col-md-8"> 6 <h1>Add a New SSH Key</h1> 7 <p>This page is only shown after password confirmation.</p> 8 </div> 9 </div> 10 </div> 11 @endsection
在码代码的时候时, 你应该复制文件 auth/passwords/confirm.blade.php 到你的项目中. 你可以在这里拿到要复制的文件: ui/confirm.stub. 复制这个文件并将其添加到你项目的如下路径:
resources/views/auth/passwords/confirm.blade.php
接下来, 我们需要定义路由, 在 routes/web.php 文件的末尾我讲需要这个中间件:
1 Route::namespace('Settings') 2 ->middleware(['auth']) 3 ->group(function () { 4 Route::get('/settings/ssh/create', 'SSHController@create')->middleware('password.confirm'); 5 });
注意: 通常, 你可以将所有需要通过 auth 中间件身份认证的路由聚合在一起. 在这个 demo 中, 我们在 Settings 的命名空间里面创建了一个控制器.
有了它,一旦登录,您将被重定向到 /home 。在那里,导航到 /settings/ssh/create ,然后提示您输入密码:
如果按照本教程进行操作,请输入 secret ,提交表单,然后进入 create 视图。确认密码后,无需提示即可刷新此页。
使用新的 ddd() 辅助函数 ,将其添加到您的 SSHController::create() 方法中,方法将确定下次提示您时auth.password_confirmed_at 中 session 的值:
1 public function create() 2 { 3 ddd(session('auth')); 4 return view('secret'); 5 }
这个即是上次验证密码的时间。默认情况下在3小时内不会重复的提醒用户再次验证密码,当然,你可以通过修改 config('auth.password_timeout') 配置项来自定义(配置项定义在 Laravel v6.2.0 版本 的 config/auth.php 配置文件中)。
了解更多
非常感谢 Dries Vints 为我们带来这个包含在 Laravel 6.2 版本中的超赞的新功能, 你可以通过 Pull Request #5129 了解到更多的关于中间件的实现细节。