在現代的 web 應用中，用戶密碼的重置是一個必不可少的功能。一個經過良好設計的密碼重置過程不僅能夠保證用戶的賬號安全，還能提高用戶的使用體驗。laravel 是一個流行的 php web 開發框架，其中也集成了一個方便的密碼重置系統。本文將介紹如何使用 laravel 實現密碼重置功能。
環境準備
在開始之前，確保您已經完成了以下安裝：
- PHP 7.2 及以上版本
- Composer 2 及以上版本
- Laravel 5.5 及以上版本
如果您還未安裝 Laravel，可以通過以下命令在終端中安裝：
composer create-project --prefer-dist laravel/laravel project-name
重置密碼流程
Laravel 的密碼重置流程基于郵件通知，步驟如下：
- 用戶提交郵箱以及需要重置密碼的鏈接到應用程序；
- 應用程序發送帶有重置鏈接的郵件到用戶的郵箱；
- 用戶訪問郵件鏈接；
- 應用程序判斷鏈接是否過期、合法；
- 如果鏈接合法，頁面出現輸入密碼的表單；
- 用戶填寫新密碼；
- 用戶提交表單；
- 應用程序重置用戶密碼。
因此，我們需要實現這個流程的每個步驟。
郵件配置
首先，我們需要在 Laravel 中配置郵件。打開 .env 文件，在其中添加如下配置：
MAIL_DRIVER=smtp MAIL_HOST=smtp.mxhichina.com MAIL_PORT=25 MAIL_USERNAME=youremail@example.com MAIL_PASSWORD=yourpassword MAIL_FROM_ADDRESS=youremail@example.com MAIL_ENCRYPTION=
這里的配置需要根據您的實際情況進行修改，MAIL_DRIVER 指定了使用的郵件服務提供商，例如 smtp、mailgun 或 sendmail 等，這里我們使用了阿里云郵件服務提供商 smtp.mxhichina.com，并且需要填寫您的郵箱用戶名和密碼。MAIL_FROM_ADDRESS 用于指定發送郵件的發送地址。
接下來，我們需要在 config/mail.php 文件中配置郵件發送選項，例如設置發件人名稱和地址：
'from' => [ 'address' => env('MAIL_FROM_ADDRESS', 'youremail@example.com'), 'name' => env('MAIL_FROM_NAME', 'Your Name'), ],
路由配置
現在，我們需要配置路由來處理密碼重置操作。在 Laravel 中，我們可以使用自帶的 Password 控制器來處理重置密碼的邏輯。打開 routes/web.php 文件，添加以下路由：
// Password Reset Routes Route::get('password/reset', 'AuthForgotPasswordController@showLinkRequestForm')->name('password.request'); Route::post('password/email', 'AuthForgotPasswordController@sendResetLinkEmail')->name('password.email'); Route::get('password/reset/{token}', 'AuthResetPasswordController@showResetForm')->name('password.reset'); Route::post('password/reset', 'AuthResetPasswordController@reset');
這里我們在 Auth 中使用了兩個控制器，分別是 ForgotPasswordController 和 ResetPasswordController，分別處理重置密碼郵件發送和密碼重置操作。
視圖配置
接下來，我們需要添加視圖來展示用戶填寫郵箱和密碼的表單。我們可以使用類似以下代碼片段的 Blade 模板代碼實現：
<form method="POST" action="{{ route('password.email') }}"> @csrf <div> <input type="email" name="email" value="{{ old('email') }}" required autofocus placeholder="請輸入您的郵箱地址"> </div> <div> <button type="submit">發送重置密碼鏈接</button> </div> </form>
在這個頁面中，我們使用了一個表單來接受用戶填寫的郵箱地址，并且添加了一個發送按鈕，點擊這個按鈕將會向該郵箱發送密碼重置鏈接。
我們還需要添加另一個視圖來允許用戶輸入新密碼。類似以下代碼片段可以用于實現一個這樣的表單：
<form method="POST" action="{{ route('password.update') }}" > @csrf <input type="hidden" name="token" value="{{ $token }}"> <div> <label for="email-input">郵箱</label> <input type="email" name="email" value="{{ $email ?? old('email') }}" required autofocus> </div> <div> <label for="password-input">新密碼</label> <input type="password" name="password" required> </div> <div> <label for="password-confirm-input">確認新密碼</label> <input type="password" name="password_confirmation" required> </div> <div> <button type="submit">重置密碼</button> </div> </form>
這個表單需要用戶填寫新密碼和確認密碼，并且需要通過 $token 和 $email 參數來驗證重置鏈接是否合法。這些參數可以在 ResetPasswordController@showResetForm 中獲取。
控制器邏輯
我們在路由中使用了兩個控制器來處理密碼重置操作，分別是 ForgotPasswordController 和 ResetPasswordController。
ForgotPasswordController 提供了一個 showLinkRequestForm() 方法，用于展示用戶填寫郵箱地址的表單。另外一個方法 sendResetLinkEmail() 將會向用戶提供的郵箱地址發送含有密碼重置鏈接的郵件，其中使用了 Password::sendResetLink() 方法來處理重置鏈接的生成和發送。
ResetPasswordController 中的 showResetForm() 方法將會展示用戶輸入新密碼的表單，如果重置鏈接不合法則會返回到郵件鏈接過期的提示頁面。reset() 方法則處理了用戶填寫重置密碼表單并提交的邏輯，其中使用了 Password::reset() 方法來將用戶的密碼更新到數據庫中。
use IlluminateSupportFacadesPassword; class ForgotPasswordController extends Controller { use SendsPasswordResetEmails; } class ResetPasswordController extends Controller { use ResetsPasswords; protected $redirectTo = '/home'; public function showResetForm(Request $request, $token = null) { return view('auth.passwords.reset')->with( ['token' => $token, 'email' => $request->email] ); } }
使用密碼重置功能
現在，我們已經完成了 Laravel 中的密碼重置功能的實現，我們來試著使用實現的功能進行密碼重置：
- 打開應用程序的登錄頁面，點擊忘記密碼；
- 輸入您的注冊的郵箱，并點擊發送重置密碼鏈接按鈕；
- 打開您的郵箱，查找并點擊密碼重置鏈接；
- 輸入您的新密碼，并確認新密碼；
- 點擊提交按鈕。
如果一切順利，您的密碼已重置成功！
總結
在本文中，我們介紹了如何使用 Laravel 實現一個基本的密碼重置功能。在現代的 Web 應用中，密碼重置是一項必備功能，只有經過良好設計和實現的密碼重置過程才能夠保障用戶賬號的安全與用戶的使用體驗。相信在您學習本文所述的技術，實現完整的密碼重置功能后，用戶的密碼安全和使用體驗會有所提高。
