Password reset in Laravel

Introduction

Password reset helps users get a new password if they forget the old one. It keeps accounts safe and easy to access again.

When a user forgets their password and cannot log in.

When you want to allow users to change their password securely.

When you want to improve user experience by providing a simple way to recover access.

When you want to keep user accounts secure by verifying identity before changing passwords.

Syntax

Laravel

php artisan ui vue --auth

// Use built-in Laravel routes and controllers for password reset

// Routes in routes/web.php
Route::get('password/reset', [ForgotPasswordController::class, 'showLinkRequestForm'])->name('password.request');
Route::post('password/email', [ForgotPasswordController::class, 'sendResetLinkEmail'])->name('password.email');
Route::get('password/reset/{token}', [ResetPasswordController::class, 'showResetForm'])->name('password.reset');
Route::post('password/reset', [ResetPasswordController::class, 'reset'])->name('password.update');

Laravel provides built-in controllers and views for password reset.

You can customize email templates and views if needed.

Examples

This route shows the form where users enter their email to get a reset link.

Laravel

// Show form to request password reset link
Route::get('password/reset', [ForgotPasswordController::class, 'showLinkRequestForm'])->name('password.request');

This route sends the reset link email after user submits their email.

Laravel

// Send password reset email
Route::post('password/email', [ForgotPasswordController::class, 'sendResetLinkEmail'])->name('password.email');

This route shows the form where user enters a new password after clicking the email link.

Laravel

// Show form to reset password using token
Route::get('password/reset/{token}', [ResetPasswordController::class, 'showResetForm'])->name('password.reset');

This route processes the new password and updates it securely.

Laravel

// Update password in database
Route::post('password/reset', [ResetPasswordController::class, 'reset'])->name('password.update');

Sample Program

This example shows a simple controller to display the password reset request form and send the reset email. The routes connect to these controller methods.

Laravel

<?php

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Password;

class ForgotPasswordController extends Controller
{
    public function showLinkRequestForm()
    {
        return view('auth.passwords.email');
    }

    public function sendResetLinkEmail(Request $request)
    {
        $request->validate(['email' => 'required|email']);

        $status = Password::sendResetLink(
            $request->only('email')
        );

        return $status === Password::RESET_LINK_SENT
                    ? back()->with(['status' => __($status)])
                    : back()->withErrors(['email' => __($status)]);
    }
}

// In routes/web.php
use App\Http\Controllers\Auth\ForgotPasswordController;

Route::get('password/reset', [ForgotPasswordController::class, 'showLinkRequestForm'])->name('password.request');
Route::post('password/email', [ForgotPasswordController::class, 'sendResetLinkEmail'])->name('password.email');

Important Notes

Make sure your mail settings in .env are configured to send emails.

Laravel stores reset tokens securely and expires them after a set time.

You can customize views in resources/views/auth/passwords/ for branding.

Summary

Password reset lets users recover access safely.

Laravel has built-in routes and controllers to handle this easily.

Always validate user input and configure email sending properly.

Practice

1. What is the main purpose of Laravel's password reset feature?

easy

A. To update the user's profile picture

B. To change the user's email address

C. To delete the user's account permanently

D. To allow users to safely recover access to their accounts

Solution

1. Step 1: Understand password reset functionality

   Password reset is designed to help users regain access if they forget their password.

2. Step 2: Identify the correct purpose in options

   Only To allow users to safely recover access to their accounts describes recovering account access safely, which matches password reset.

3. Final Answer:

   To allow users to safely recover access to their accounts -> Option D

4. Quick Check:

   Password reset = recover access [OK]

Hint: Password reset helps regain account access safely [OK]

Common Mistakes:

• Confusing password reset with profile updates
• Thinking it deletes the account
• Assuming it changes email address

2. Which Laravel command publishes the password reset email template for customization?

easy

A. php artisan vendor:publish --tag=laravel-password-reset

B. php artisan make:auth

C. php artisan vendor:publish --tag=laravel-mail

D. php artisan migrate

Solution

1. Step 1: Identify command to publish email templates

   Laravel uses vendor:publish with specific tags to publish resources like email templates.

2. Step 2: Match the correct tag for mail templates

   The tag 'laravel-mail' is used to publish mail templates including password reset emails.

3. Final Answer:

   php artisan vendor:publish --tag=laravel-mail -> Option C

4. Quick Check:

   Publish mail templates = vendor:publish --tag=laravel-mail [OK]

Hint: Use vendor:publish with mail tag to customize emails [OK]

Common Mistakes:

• Using make:auth which is deprecated
• Wrong tag like laravel-password-reset
• Running migrate instead of publishing

3. Given this Laravel password reset route snippet, what HTTP method should the form use to submit the reset token and new password?

<form action="{{ route('password.update') }}" method="?">
  @csrf
  <input type="hidden" name="token" value="{{ $token }}">
  <input type="email" name="email" required>
  <input type="password" name="password" required>
  <input type="password" name="password_confirmation" required>
  <button type="submit">Reset Password</button>
</form>

medium

A. GET

B. POST

C. PUT

D. DELETE

Solution

1. Step 1: Understand password reset form submission

   The form sends sensitive data (password, token) to update the password securely.

2. Step 2: Identify correct HTTP method for secure data submission

   POST method is used to send data to the server for processing, especially for updates like password reset.

3. Final Answer:

   POST -> Option B

4. Quick Check:

   Form sending data securely = POST [OK]

Hint: Use POST to send password reset data securely [OK]

Common Mistakes:

• Using GET which exposes data in URL
• Using PUT or DELETE which are not default form methods
• Omitting CSRF token with POST

4. You wrote this code to send a password reset link but users report no emails received:

use Illuminate\Support\Facades\Password;

Password::sendResetLink(['email' => $request->email]);

What is the likely mistake?

medium

A. Missing the return statement to check success

B. Using the wrong facade, should use Mail instead

C. Not validating the email before sending reset link

D. Not calling the notify() method on the user model

Solution

1. Step 1: Understand Password::sendResetLink usage

   This method returns a status indicating if the email was sent successfully or failed.

2. Step 2: Identify missing check for success

   Without capturing and checking the return value, you won't know if sending failed silently.

3. Final Answer:

   Missing the return statement to check success -> Option A

4. Quick Check:

   Check sendResetLink return to confirm email sent [OK]

Hint: Always check sendResetLink return status for success [OK]

Common Mistakes:

• Assuming Mail facade is needed directly
• Skipping email validation before sending
• Trying to call notify() manually for reset link

5. You want to customize Laravel's password reset to expire tokens after 30 minutes instead of the default. Which file and setting should you modify?

hard

A. config/auth.php, 'passwords.users.expire' => 30

B. config/mail.php, 'reset_token_expiry' => 30

C. routes/web.php, add middleware for token expiry

D. app/Http/Controllers/ResetPasswordController.php, set token expiry property

Solution

1. Step 1: Identify where password reset token expiry is configured

   Laravel stores password reset settings in config/auth.php under 'passwords' array.

2. Step 2: Locate the 'expire' key for users password broker

   The 'expire' key defines token validity in minutes; changing it to 30 sets expiry to 30 minutes.

3. Final Answer:

   config/auth.php, 'passwords.users.expire' => 30 -> Option A

4. Quick Check:

   Token expiry set in config/auth.php passwords.users.expire [OK]

Hint: Change expire in config/auth.php under passwords.users [OK]

Common Mistakes:

• Trying to set expiry in mail config
• Adding middleware instead of config change
• Modifying controller instead of config