Laravel9 Fortifyで”Route [password.reset] not defined.”のエラーが出た時の対処法

Laravel+Fortify+Sanctum+フロントエンドSPA開発(React or Vue.js)でパスワードリセット機能を実装する際、“Route [password.reset] not defined.”というエラーが出た時の解決方法を紹介します。

エラー内容

Laravel Fortifyのパスワードリセットをデフォルトのままフロントエンド側でforgot-passwordにpostすると以下のようなエラーが出ます。

なんともLaravel Fortifyではパスワードリセットをするにはpassword.resetという名前付きのルートが必要のようです。

解決策①

フロントエンドをbladeファイルで開発している場合はweb.phpにpassword.resetのルートを追記してやればエラーがなくなります。

Route::get('/reset-password/{token}', function () {
    return view('index');
})->name('password.reset');
Route::get('/{any?}', fn () => view('index'))->where('any', '.+');

解決策②

Nuxt.jsやNext.js等、フロントエンドとLaravelを分離している場合はエンドポイントを明記してやる必要があります。
app\Providers\AuthServiceProvider.phpを以下のように編集します。

<?php
 
namespace App\Providers;
 
use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
use Illuminate\Support\Facades\Gate;
use Illuminate\Auth\Notifications\ResetPassword;
 
class AuthServiceProvider extends ServiceProvider
{
    /**
     * The policy mappings for the application.
     *
     * @var array
     */
    protected $policies = [
        // 'App\Models\Model' => 'App\Policies\ModelPolicy',
    ];
 
    /**
     * Register any authentication / authorization services.
     *
     * @return void
     */
    public function boot()
    {
        $this->registerPolicies();
 
        ResetPassword::createUrlUsing(function ($user, string $token) {
            return config('app.url') . '/reset-password?email=' . $user->email . '&token=' . $token;
        });
    }
}

解決策③

さらにカスタマイズしたい場合はsendPasswordResetNotificationメソッドをオーバーライドすることで実装することもできます。

public function sendPasswordResetNotification($token)
{
    $this->notify(new \App\Notifications\ResetPassword($token));
}

vendor/laravel/framework/src/Illuminate/Auth/Notifications/ResetPassword.phpをまるっとコピーして
app/Notifications/ResetPassword.phpに貼り付けます。

コピペしたら名前空間を編集しresetUrlを任意のurlに変更します。

ちなみにリセットメールの文言等を変えたいときもここを編集することで可能です。

<?php

namespace App\Notifications;

use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
use Illuminate\Support\Facades\Lang;

class ResetPassword extends Notification
{
    /**
     * The password reset token.
     *
     * @var string
     */
    public $token;

    /**
     * The callback that should be used to create the reset password URL.
     *
     * @var (\Closure(mixed, string): string)|null
     */
    public static $createUrlCallback;

    /**
     * The callback that should be used to build the mail message.
     *
     * @var (\Closure(mixed, string): \Illuminate\Notifications\Messages\MailMessage)|null
     */
    public static $toMailCallback;

    /**
     * Create a notification instance.
     *
     * @param  string  $token
     * @return void
     */
    public function __construct($token)
    {
        $this->token = $token;
    }

    /**
     * Get the notification's channels.
     *
     * @param  mixed  $notifiable
     * @return array|string
     */
    public function via($notifiable)
    {
        return ['mail'];
    }

    /**
     * Build the mail representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return \Illuminate\Notifications\Messages\MailMessage
     */
    public function toMail($notifiable)
    {
        if (static::$toMailCallback) {
            return call_user_func(static::$toMailCallback, $notifiable, $this->token);
        }

        return $this->buildMailMessage($this->resetUrl($notifiable));
    }

    /**
     * Get the reset password notification mail message for the given URL.
     *
     * @param  string  $url
     * @return \Illuminate\Notifications\Messages\MailMessage
     */
    protected function buildMailMessage($url)
    {
        return (new MailMessage)
            ->subject(Lang::get('Reset Password Notification'))
            ->line(Lang::get('You are receiving this email because we received a password reset request for your account.'))
            ->action(Lang::get('Reset Password'), $url)
            ->line(Lang::get('This password reset link will expire in :count minutes.', ['count' => config('auth.passwords.'.config('auth.defaults.passwords').'.expire')]))
            ->line(Lang::get('If you did not request a password reset, no further action is required.'));
    }

    /**
     * Get the reset URL for the given notifiable.
     *
     * @param  mixed  $notifiable
     * @return string
     */
    protected function resetUrl($notifiable)
    {
        if (static::$createUrlCallback) {
            return call_user_func(static::$createUrlCallback, $notifiable, $this->token);
        }

        return config('app.front_url') . '/reset-password/' . $this->token . '?email=' .  $notifiable->getEmailForPasswordReset();
        // return url(route('password.reset', [
        //     'token' => $this->token,
        //     'email' => $notifiable->getEmailForPasswordReset(),
        // ], false));
    }

    /**
     * Set a callback that should be used when creating the reset password button URL.
     *
     * @param  \Closure(mixed, string): string  $callback
     * @return void
     */
    public static function createUrlUsing($callback)
    {
        static::$createUrlCallback = $callback;
    }

    /**
     * Set a callback that should be used when building the notification mail message.
     *
     * @param  \Closure(mixed, string): \Illuminate\Notifications\Messages\MailMessage  $callback
     * @return void
     */
    public static function toMailUsing($callback)
    {
        static::$toMailCallback = $callback;
    }
}

コメントを残す

入力エリアすべてが必須項目です。メールアドレスが公開されることはありません。

内容をご確認の上、送信してください。