Laravel 的密码重设功能

简介

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

大部分 web 应用为用户提供了重置密码的功能。Laravel 提供了方便的方法发送密码重置链接并完成密码重置，而不需要在每个应用中重新实现。

{note} 在使用 Laravel 的密码重置功能之前，你必须在你的用户模型中使用 Illuminate\Notifications\Notifiable 这个 trait，也就是加入 use Illuminate\Notifications\Notifiable 这行代码，框架中自带的用户模型 App\User 中已添加。

数据库注意事项

开始之前，请确认你的 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 这两个类中分别实现了通过邮件发送重置密码链接和重置密码的逻辑。所有重置密码需要用到的路由都会通过执行 make:auth 这个 Artisan 命令生成：

php artisan make:auth

视图

另外，当 Laravel 执行 make:auth 命令时，会在 resources/views/auth/passwords 目录下生成充值密码所需要的视图文件。当然你可以根据项目需求随意修改这些视图文件。

重置密码后

一旦你生成了用于重置用户密码的路由和视图，你就可以在浏览器中访问 /password/reset 这个路由来重置密码。框架中的 ForgotPasswordController 已经实现了通过邮件发送重置密码链接的逻辑，ResetPasswordController 实现了重置密码的逻辑。

重置密码后，用户就会自动登录并重定向到 /home。你可以修改 ResetPasswordController 中的 redirectTo 属性，从而自定义重置密码后重定向到的位置：

protected $redirectTo = '/dashboard';

{note} 默认情况下，重置密码的令牌一小时后会失效。你可以修改 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;

/**
 * Get the broker to be used during password reset.
 *
 * @return PasswordBroker
 */
protected function broker()
{
    return Password::broker('name');
}

自定义用于重置的邮箱（或者其他通知方式）

你可以方便的修改用于发送密码重置链接的通知类。首先，重写 User 模型中的 sendPasswordResetNotification 方法。在这个方法中，你可以选择任意的通知类来发送通知。这个方法的第一个参数为用于重置密码的令牌 $token ：

/**
 * Send the password reset notification.
 *
 * @param  string  $token
 * @return void
 */
public function sendPasswordResetNotification($token)
{
    $this->notify(new ResetPasswordNotification($token));
}

译者署名

用户名 头像 职能 签名
@lockdown56 翻译 农闲出来敲代码，农忙回家种玉米

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

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

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