大多數網頁應用程式都提供了一種方式讓使用者重設他們忘記的密碼。 Laravel 提供了方便的服務來發送重設密碼連結和安全地重設密碼，而不是強迫您為每個應用程式重新手動實現此功能。
Note
想要快速開始嗎？在全新的 Laravel 應用程式中安裝 Laravel 應用程式起始套件。 Laravel 的起始套件將負責搭建整個身份驗證系統，包括重設忘記的密碼。
在使用 Laravel 的重設密碼功能之前，您的應用程式的 App\Models\User 模型必須使用 Illuminate\Notifications\Notifiable 特性。通常，這個特性已經包含在使用新的 Laravel 應用程式創建的預設 App\Models\User 模型中。
接下來，請確認您的 App\Models\User 模型實作了 Illuminate\Contracts\Auth\CanResetPassword 契約。框架中包含的 App\Models\User 模型已經實作了這個介面，並使用 Illuminate\Auth\Passwords\CanResetPassword 特性來包含實作介面所需的方法。
必須建立一個表來存儲您的應用程式的重設密碼標記。通常，這是包含在 Laravel 的預設 0001_01_01_000000_create_users_table.php 資料庫遷移中。
默認情況下，Laravel 將對收到的所有請求做出回應，而不管 HTTP 請求的 Host 標頭的內容如何。此外，在網絡請求期間生成絕對 URL 到您的應用程序時，Host 標頭的值將被使用。
通常，您應該配置您的 Web 伺服器，如 Nginx 或 Apache，僅將符合特定主機名的請求發送到您的應用程序。但是，如果您無法直接自定義您的 Web 伺服器並且需要指示 Laravel 僅回應特定主機名，您可以在應用程序的 bootstrap/app.php 檔案中使用 trustHosts 中介層方法來執行此操作。當您的應用程序提供密碼重設功能時，這一點尤為重要。
要了解有關此中介層方法的更多信息，請參考TrustHosts 中介層文件。
為了正確實現支持用戶重設密碼的功能，我們需要定義幾個路由。首先，我們需要一對路由來處理允許用戶通過其電子郵件地址請求重設密碼鏈接。其次，我們需要一對路由來處理當用戶訪問發送到他們的電子郵件的密碼重設鏈接並完成密碼重設表單時實際重設密碼。
首先，我們將定義需要請求重設密碼鏈接的路由。首先，我們將定義一個路由，返回一個帶有密碼重設鏈接請求表單的視圖：
Route::get('/forgot-password', function () {
return view('auth.forgot-password');
})->middleware('guest')->name('password.request');
此路由返回的視圖應包含一個 email 欄位的表單，該欄位將允許用戶為給定的電子郵件地址請求密碼重設鏈接。
接下來，我們將定義一個路由，用於處理來自「忘記密碼」視圖的表單提交請求。這個路由將負責驗證電子郵件地址並將重設密碼請求發送給相應的使用者：
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Password;
Route::post('/forgot-password', function (Request $request) {
$request->validate(['email' => 'required|email']);
$status = Password::sendResetLink(
$request->only('email')
);
return $status === Password::ResetLinkSent
? back()->with(['status' => __($status)])
: back()->withErrors(['email' => __($status)]);
})->middleware('guest')->name('password.email');在繼續之前，讓我們更詳細地檢視這個路由。首先，驗證請求的 email 屬性。接下來，我們將使用 Laravel 內建的「密碼代理」（透過 Password 門面）向使用者發送重設密碼連結。密碼代理將負責通過給定的字段（在這種情況下是電子郵件地址）檢索使用者並通過 Laravel 內建的通知系統向使用者發送重設密碼連結。
sendResetLink 方法會返回一個「狀態」標記。可以使用 Laravel 的本地化輔助工具來翻譯此狀態，以便向使用者顯示有關其請求狀態的友好消息。密碼重設狀態的翻譯由您應用程式的 lang/{lang}/passwords.php 語言文件決定。passwords 語言文件中包含了狀態標記的每個可能值的條目。
Note
默認情況下，Laravel 應用程式骨架不包含 lang 目錄。如果您想自定義 Laravel 的語言文件，可以通過 lang:publish Artisan 命令來發布它們。
您可能想知道當調用 Password 門面的 sendResetLink 方法時，Laravel 如何知道如何從您應用程式的資料庫檢索使用者記錄。Laravel 密碼代理利用您的身份驗證系統的「使用者提供者」來檢索資料庫記錄。密碼代理使用的使用者提供者在您的 config/auth.php 配置文件的 passwords 配置陣列中配置。要了解有關編寫自定義使用者提供者的更多信息，請參考身份驗證文件。
Note
當手動實現密碼重置時，您需要自行定義視圖和路由的內容。如果您希望包含所有必要的認證和驗證邏輯的腳手架，請查看Laravel應用程式起始套件。
接下來，我們將定義實際重置密碼所需的路由，一旦用戶點擊已通過電子郵件發送的重置密碼鏈接並提供新密碼，便會執行重置。首先，讓我們定義將顯示重置密碼表單的路由，當用戶點擊重置密碼鏈接時顯示。此路由將接收一個token參數，我們稍後將使用它來驗證密碼重置請求：
Route::get('/reset-password/{token}', function (string $token) {
return view('auth.reset-password', ['token' => $token]);
})->middleware('guest')->name('password.reset');此路由返回的視圖應該顯示一個包含email字段、password字段、password_confirmation字段和一個隱藏的token字段的表單，該字段應包含我們路由接收到的秘密$token的值。
當然，我們需要定義一個路由來實際處理密碼重置表單的提交。此路由將負責驗證傳入的請求並在數據庫中更新用戶的密碼：
use App\Models\User;
use Illuminate\Auth\Events\PasswordReset;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Password;
use Illuminate\Support\Str;
Route::post('/reset-password', function (Request $request) {
$request->validate([
'token' => 'required',
'email' => 'required|email',
'password' => 'required|min:8|confirmed',
]); $status = Password::reset(
$request->only('email', 'password', 'password_confirmation', 'token'),
function (User $user, string $password) {
$user->forceFill([
'password' => Hash::make($password)
])->setRememberToken(Str::random(60));
$user->save();
event(new PasswordReset($user));
}
);
return $status === Password::PasswordReset
? redirect()->route('login')->with('status', __($status))
: back()->withErrors(['email' => [__($status)]]);
})->middleware('guest')->name('password.update');在繼續之前，讓我們更詳細地檢查這個路由。首先，對請求的 token、email 和 password 屬性進行驗證。接下來，我們將使用 Laravel 內建的 "password broker"（透過 Password 門面）來驗證密碼重設請求的憑證。
如果傳給密碼 broker 的 token、電子郵件地址和密碼是有效的，則將調用傳遞給 reset 方法的閉包。在這個閉包中，接收到用戶實例和提供給密碼重設表單的純文字密碼，我們可以在資料庫中更新用戶的密碼。
reset 方法會返回一個 "status" 標記。可以使用 Laravel 的 本地化 助手來翻譯此狀態，以便向用戶顯示有關其請求狀態的友好消息。密碼重設狀態的翻譯取決於您應用程式的 lang/{lang}/passwords.php 語言檔。passwords 語言檔中包含了每個狀態標記可能值的條目。如果您的應用程式沒有 lang 目錄，您可以使用 lang:publish Artisan 命令來創建它。
在繼續之前，您可能想知道 Laravel 如何在調用 Password 門面的 reset 方法時從您應用程式的資料庫中檢索用戶記錄。Laravel 密碼 broker 使用您的身份驗證系統的 "用戶提供者" 來檢索資料庫記錄。密碼 broker 使用的用戶提供者在您的 config/auth.php 配置檔的 passwords 配置陣列中配置。要了解更多關於編寫自訂用戶提供者的資訊，請參考 身份驗證文件。
## 刪除過期的標記
密碼重設的標記一旦過期，將仍然存在於您的資料庫中。但是，您可以使用 `auth:clear-resets` Artisan 指令輕鬆刪除這些記錄：
```shell
php artisan auth:clear-resets
如果您希望自動化此流程，請考慮將該指令添加到您應用程式的 排程器 中：
use Illuminate\Support\Facades\Schedule;
Schedule::command('auth:clear-resets')->everyFifteenMinutes();您可以使用 ResetPassword 通知類別提供的 createUrlUsing 方法來自訂密碼重設連結的 URL。此方法接受一個閉包，該閉包接收正在接收通知的使用者實例以及密碼重設連結標記。通常，您應該從您的 App\Providers\AppServiceProvider 服務提供者的 boot 方法中調用此方法：
use App\Models\User;
use Illuminate\Auth\Notifications\ResetPassword;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
ResetPassword::createUrlUsing(function (User $user, string $token) {
return 'https://example.com/reset-password?token='.$token;
});
}您可以輕鬆修改用於向使用者發送密碼重設連結的通知類別。要開始，請覆蓋您的 App\Models\User 模型上的 sendPasswordResetNotification 方法。在此方法中，您可以使用您自己創建的任何 通知類別 來發送通知。密碼重設 $token 是該方法接收的第一個參數。您可以使用此 $token 來構建您選擇的密碼重設 URL 並將通知發送給使用者：
use App\Notifications\ResetPasswordNotification;
/**
* Send a password reset notification to the user.
*
* @param string $token
*/
public function sendPasswordResetNotification($token): void
{
$url = 'https://example.com/reset-password?token='.$token;$this->notify(new ResetPasswordNotification($url));