Laravel Fortify 自定义密码创建流程中的令牌生成指南

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\RedirectResponse;
use Illuminate\Support\Str;
use Illuminate\Auth\Passwords\PasswordBroker; // 引入 PasswordBroker 类
use App\Http\Requests\UserCreateRequest; // 假设您有这样的请求类

class UserController extends Controller
{
    /**
     * 处理新用户的创建并发送密码设置邮件。
     *
     * @param UserCreateRequest $request
     * @return RedirectResponse
     */
    public function store(UserCreateRequest $request): RedirectResponse
    {
        // 1. 创建用户，初始密码可以随机生成或为空，因为用户将自行设置
        $user = User::create(
            array_merge(
                $request->validated(),
                ['password' => bcrypt(Str::random(8))] // 初始设置一个随机密码，或者可以设置为 null
            )
        );

        // 2. 使用 PasswordBroker 服务生成令牌
        // 从服务容器中获取 PasswordBroker 实例
        $passwordBroker = app(PasswordBroker::class);
        // 为指定用户生成令牌，并自动存储到 password_resets 表
        $token = $passwordBroker->createToken($user);

        // 3. 发送包含令牌的密码创建通知邮件
        // 假设您已经定义了 sendPasswordCreateNotification 方法
        // 并且该方法接受一个令牌作为参数，用于构建密码设置链接
        $user->sendPasswordCreateNotification($token);

        // 返回重定向或其他响应
        return redirect()->route('users.index')->with('success', '用户已创建，密码设置邮件已发送！');
    }
}

// app/Models/User.php

use App\Notifications\PasswordCreateNotification; // 引入您的通知类

class User extends Authenticatable
{
    // ... 其他属性和方法

    /**
     * 发送密码创建通知。
     *
     * @param string $token
     * @return void
     */
    public function sendPasswordCreateNotification(string $token): void
    {
        $this->notify(new PasswordCreateNotification($token));
    }
}

// app/Notifications/PasswordCreateNotification.php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;

class PasswordCreateNotification extends Notification
{
    use Queueable;

    public string $token;

    /**
     * 创建一个新的通知实例。
     *
     * @param string $token
     * @return void
     */
    public function __construct(string $token)
    {
        $this->token = $token;
    }

    /**
     * 获取通知的交付渠道。
     *
     * @param mixed $notifiable
     * @return array
     */
    public function via(mixed $notifiable): array
    {
        return ['mail'];
    }

    /**
     * 获取邮件表示形式的通知。
     *
     * @param mixed $notifiable
     * @return MailMessage
     */
    public function toMail(mixed $notifiable): MailMessage
    {
        // 构建密码设置链接
        // 假设您的密码设置路由是 'password.create.form'，并且接受 token 和 email 参数
        $url = url(route('password.create.form', [
            'token' => $this->token,
            'email' => $notifiable->getEmailForPasswordReset(),
        ], false)); // false 表示生成相对 URL，如果需要绝对 URL，请根据实际情况调整

        return (new MailMessage)
                    ->subject('请设置您的账户密码')
                    ->line('您好，请点击下方链接为您的账户设置密码：')
                    ->action('设置密码', $url)
                    ->line('如果您没有请求此操作，请忽略此邮件。');
    }
}

// routes/web.php

use App\Http\Controllers\Auth\NewPasswordController; // 假设您自定义了控制器

// 自定义密码创建路由，用于展示密码设置表单
Route::get('/create-password/{token}', [NewPasswordController::class, 'create'])
    ->name('password.create.form');

// 处理密码创建提交
Route::post('/create-password', [NewPasswordController::class, 'store'])
    ->name('password.create.store');