# 重置密码
- [重置密码说明](#introduction)
- [数据库注意事项](#resetting-database)
- [路由](#resetting-routing)
- [视图](#resetting-views)
- [重置密码后](#after-resetting-passwords)
- [密码自定义](#password-customization)
## 重置密码说明
> ｛提示｝ **想要快速上手此功能？** 首先在 Laravel 应用下运行 `php artisan make:auth` 命令，然后使用浏览器打开 `http://your-app.dev/register` ，或者任意一个在应用中分配的 URL 。这个命令将会生成包括密码重置在内的整个认证系统。
大部分的 web 应用都为用户提供重置密码的功能。Laravel 提供了一种方便的方法用于发送密码提示及执行密码重置，而不需要在每个应用中重新实现。
> ｛注意｝ 在使用 Laravel 密码重置功能之前, 你必须 `use` 这个 `IlluminateNotificationsNotifiable` `trait` 。
## 数据库注意事项
开始之前，请先确认 `AppUser` 模型是否实现了 `IlluminateContractsAuthCanResetPassword` `contract` 。当然，在 Laravel 框架中 `AppUser` 模型已经实现了这个接口，并使用 `IlluminateContractsAuthCanResetPassword` `trait` 来实现该接口包含的方法。
#### 生成重置令牌表迁移
接下来，用来存储密码重置令牌的表必须被创建。 Laravel 已经自带了这张表的迁移，就存放在 `database/migrations` 目录，因此，你只需要运行数据库迁移命令：
php artisan migrate
## 路由
Laravel 在 `AuthForgotPasswordController` 和 `AuthResetPasswordController` 两个类中包含了电子邮件密码重置链接和重置用户密码的必要逻辑。所有需要密码重置的路由可以使用 `make:auth` Artisa 命令生成：
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 IlluminateSupportFacadesAuth;
protected function guard()
{
return Auth::guard('guard-name');
}
#### 自定义密码 Broker
在配置文件 `auth.php` 中, 可以配置多个密码 `brokers` ，它可以用于多个用户表重置密码。你可以通过重写 `ForgotPasswordController` 和 `ResetPasswordController` 控制器的 `broker` 方法来实现你的自定义 `broker` ：
protected function broker()
{
return Password::broker('name');
}
#### 自定义重置邮箱
你可以方便的修改通知类用以给用户发送密码重置链接。在开始之前， 重写`User` 模型中 `sendPasswordResetNotification` 方法。在这个方法中，你可以使用你选择的任意通知类发送通知。密码重置令牌 `$token` 是这个方法的接收第一个参数：
public function sendPasswordResetNotification($token)
{
$this->notify(new ResetPasswordNotification($token));
}
