重置密码

简介

想要快速实现该功能？需要通过 Composer 安装 laravel/ui 扩展包，再运行 php artisan ui vue --auth 命令生成认证脚手架代码，以及 npm install && npm run dev 编译前端资源，然后运行数据库迁移命令（如果你已经执行过此命令，可忽略），在浏览器中访问 http://your-app.test/register 或者其他分配给应用的 URL。以上脚手架代码会包含用户登录注册所需要的所有东西，包括密码重置！

大多数 Web 应用都提供了为用户重置密码的功能，Laravel 也不例外，Laravel 提供了用于发送密码重置链接及实现密码重置逻辑的便捷方法，而不需要你在每个应用中自己重复实现。

注：在使用 Laravel 提供的密码重置功能之前，User 模型必须使用了 Illuminate\Notifications\Notifiable trait。

数据库相关

开始之前，先验证 App\User 模型实现了 Illuminate\Contracts\Auth\CanResetPassword 契约。当然，Laravel 自带的 App\User 模型已经实现了该接口，并使用 Illuminate\Auth\Passwords\CanResetPassword trait 来包含实现该接口需要的方法。

生成重置令牌表迁移

接下来，用来存储密码重置令牌的表必须被创建，Laravel 已经自带了这张表的迁移，就存放在 database/migrations 目录。所以，你所要做的仅仅是运行迁移：

php artisan migrate

这张表就是 password_resets：

路由

Laravel 自带了 Auth\ForgotPasswordController 和 Auth\ResetPasswordController 控制器，分别用于发送密码重置链接邮件和重置用户密码功能。重置密码所需的路由都已经通过 laravel/ui Composer 扩展包提供的命令生成了：

composer require laravel/ui --dev

php artisan ui vue --auth

注：对应路由定义在 Laravel\Ui\AuthRouteMethods 的 auth 方法中，然后通过 Laravel\Ui\UiServiceProvider 的 boot 方法载入。

视图

和路由一样，重置密码所需的视图文件也通过 laravel/ui Composer 扩展包 提供的命令生成了：

composer require laravel/ui --dev

php artisan ui vue --auth

这些视图文件位于resources/views/auth/passwords 目录下，你可以按照所需对生成的文件进行相应修改。

重置密码后

定义好重置用户密码路由和视图后，只需要在浏览器中通过 /password/reset 访问这个入口路由。框架自带的 ForgotPasswordController 已经包含了发送密码重置链接邮件的逻辑， ResetPasswordController 包含了重置用户密码的逻辑：

输入注册邮箱，点击发送密码重置链接，就会发送密码重置链接到该邮箱：

打开邮箱会收到这样一封重置密码邮件：

点击重置密码按钮，即可进入重置密码页面：

填写表单提交之后即可重置密码。

密码被重置后，用户将会自动登录到应用并重定向到 /home。你可以通过定义 ResetPasswordController 的 redirectTo 属性来自定义密码重置成功后的跳转链接：

protected $redirectTo = '/dashboard';

注：默认情况下，密码重置令牌一小时内有效，你可以通过修改 config/auth.php 文件中的选项 expire 来改变有效时间。

自定义

自定义认证 Guard

在配置文件 auth.php 中，可以配置多个「guards」，以便用于实现基于多用户表的独立认证，你可以通过重写内置的 ResetPasswordController 控制器上的 guard 方法来使用你所选择的 guard，该方法将会返回一个 guard 实例：

use Illuminate\Support\Facades\Auth;

protected function guard()
{
    return Auth::guard('guard-name');
}

自定义密码 Broker

在配置文件 auth.php 中，可以配置多个密码，以便用于重置多个用户表的密码 broker，同样，可以通过重写自带的 ForgotPasswordController 和 ResetPasswordController 控制器中的 broker 方法来使用你所选择的 broker：

use Illuminate\Support\Facades\Password;

/**
 * 获取密码重置期间所使用的broker.
 *
 * @return PasswordBroker
 * @translator laravelacademy.org
 */
protected function broker()
{
    return Password::broker('name');
}

自定义密码重置邮件

你可以很方便地编辑发送密码重置链接给用户的通知类实现自定义密码重置邮件，要实现这一功能，需要重写 User 模型上的 sendPasswordResetNotification 方法，在这个方法中，可以使用任何你所喜欢的通知类发送通知，该方法接收的第一个参数是密码重置 $token：

/**
 * 发送密码重置通知.
 *
 * @param  string  $token
 * @return void
 */
public function sendPasswordResetNotification($token)
{
    $this->notify(new ResetPasswordNotification($token));
}