Laravel 的密码重设功能

简介

提示

想要快速上手此功能？ 首先在 Laravel 应用下运行 php artisan make:auth 命令，然后使用浏览器打开 http://your-app.dev/register ，或者任意一个在应用中分配的 URL 。这个命令将会生成包括密码重置在内的整个认证系统。

大部分的 web 应用都为用户提供重置密码的功能。Laravel 提供了一种非常方便的方法用于发送密码重置邮件来完成密码重置，而不需要在每个应用中重新实现。

备注

在使用 Laravel 密码重置功能之前, 你必须 use 这个 Illuminate\Notifications\Notifiable trait。

数据库注意事项

开始之前，请先确认你的 App\User 模型是否实现了 Illuminate\Contracts\Auth\CanResetPassword 协议。当然，在 Laravel 框架中 App\User 模型已经实现了这个接口，并使用 Illuminate\Auth\Passwords\CanResetPassword trait 来实现该接口包含的方法。

生成重置令牌表迁移

接下来，我们必须先创建用来存储密码重置令牌的数据表。由于 Laravel 已经自带了这张表的迁移，就存放在 database/migrations 目录，因此，你仅仅只需要运行下面的命令即可完成数据表的创建：

php artisan migrate

路由

Laravel 在 Auth\ForgotPasswordController 和 Auth\ResetPasswordController 两个类中包含了电子邮件密码重置链接和重置用户密码的必要逻辑。你只需要使用 Artisan 命令 make:auth 命令即可生成密码重置所需要的路由：

php artisan make:auth

视图

和路由一样Laravel 在执行 make: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 中, 可以配置多个密码 「brokers」 , 它可以用于多个用户表重置密码。你可以通过重写 ForgotPasswordController 和 ResetPasswordController 控制器的 broker 方法来实现你的自定义 broker ：

use Illuminate\Support\Facades\Password;

/**
 * 获取在密码重置期间使用的 broker 
 *
 * @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));
}

译者署名

用户名	头像	职能	签名
@GanymedeNil		翻译	我不是Full Stack Developer 2333 @GanymedeNil

---

备注

欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 [laravel-china.org] 组织翻译，详见 翻译召集帖。

文档永久地址： http://d.laravel-china.org