重置密码

重置密码


重置密码

简介

{tip}想要快速上手?只需要在新建的 Laravel 应用中运行php artisan make:auth,然后在浏览器中打开http://your-app.test/register或者给你的应用分配任意一个 URL。 这个命令将会负责搭建起整个身份验证系统,包括重置密码!

大多数 web 应用都为用户提供了重置密码的功能。相较于强迫你在每个应用中都要重新实现一遍此功能,Laravel 提供了便捷的方法来发送密码提醒以及执行密码重置。

{note} 在使用 Laravel 的密码重置功能之前,你的用户模型必须使用Illuminate\Notifications\Notifiabletrait。

数据库注意事项

首先,验证你的App\User模型是否实现了Illuminate\Contracts\Auth\CanResetPassword契约。当然,框架中包含的App\User模型已经实现了该接口,并且使用了Illuminate\Auth\Passwords\CanResetPasswordtrait t 来包含实现该接口所需的方法。

生成重置令牌的表迁移

接下来,必须创建一张数据表来存储密码重置令牌。该数据表的迁移已包含在 Laravel 应用的database/migrations目录中。 所以,你需要做的只是执行数据库迁移命令:

php artisan migrate

路由

Laravel 已在Auth\ForgotPasswordControllerAuth\ResetPasswordController类中包含了发送密码重置链接电子邮件和重置用户密码的逻辑。所有执行密码重置所需的路由可以使用 Artisan 命令make:auth来生成:

php artisan make:auth

视图

当执行make:auth命令时,Laravel 会生成重置密码所需的所有视图。 这些视图位于resources/views/auth/passwords目录中。你可以根据你应用的需要随意修改这些视图。

重置密码后

一旦你定义了重置用户密码的路由和视图,你可以在浏览器中访问/password/reset这个路由来重置密码。框架中的ForgotPasswordController已包含发送密码重置链接电子邮件的逻辑,同时ResetPasswordController包含了重置用户密码的逻辑。

在重置密码后,用户将会自动登录并重定向到/home。 你可以通过在ResetPasswordController中定义一个redirectTo属性来自定义密码重置后重定向的位置:

protected $redirectTo = '/dashboard';

{note} 默认情况下,密码重置令牌会在一小时后过期。你可以通过config/auth.php文件中的密码重置expire选项对此进行修改。

自定义

自定义身份验证看守器

在你的auth.php配置文件中,你可以配置多个「看守器」,可以用来定义多个用户表的身份验证行为。你可以自定义框架中的ResetPasswordController,通过重写该控制器中的guard方法来使用你所选择的看守器。这个方法应当返回一个看守器实例:

use Illuminate\Support\Facades\Auth;protected function guard(){ return Auth::guard('guard-name'); }

自定义密码代理

在你的auth.php配置文件中,你可以配置多个密码「代理」,可以用来重置多个用户表上的密码。你可以自定义框架中的ForgotPasswordControllerResetPasswordController, 通过重写控制器中的broker方法来使用你所选择的代理:

use Illuminate\Support\Facades\Password; /** * 获取在密码重置期间使用的代理。 * * @return PasswordBroker */ protected function broker(){ return Password::broker('name'); }

自定义密码重置邮件

你可以轻松地修改用于向用户发送密码重置链接的通知类。首先,重写User模型中的sendPasswordResetNotification方法。 在此方法中,你可以使用任何你所选择的通知类来发送通知。该方法接收的第一个参数是密码重置令牌$token

/** * 发送密码重置通知。 * * @param string $token * @return void */ public function sendPasswordResetNotification($token){ $this->notify(new ResetPasswordNotification($token)); }
本文章首发在 LearnKu.com网站上。