如何修改Laravel的Password Facade？（涉及PasswordBroker与DatabaseTokenRepository）

需求描述 #

我希望通过扩展DatabaseTokenRepository和PasswordBroker来给Password Facade添加getTokenRecord($user)方法，目标是通过Password::getTokenRecord($user)获取password_resets表中的记录，相比直接使用DB::table('password_resets')->where('email', $user->email)->first()，这种方式和Laravel的密码重置体系更具一致性。我考虑过注册自定义方法、使用宏，或者扩展原有类并替换绑定这几种方式，想了解具体可行的实现方案。

自定义方法代码示例：

class CustomDatabaseTokenRepository extends DatabaseTokenRepository
{
    public function getRecord(CanResetPasswordContract $user)
    {
        return (array) $this->getTable()->where(
            'email', $user->getEmailForPasswordReset()
        )->first();
    }
}

class CustomPasswordBroker extends PasswordBroker
{
    public function getTokenRecord(CanResetPasswordContract $user)
    {
        return $this->tokens->getRecord($user);
    }
}

可行实现方案 #

方案一：扩展类并替换服务容器绑定（推荐） #

这是最符合Laravel架构规范的方式，通过替换容器中原有的类绑定，让Password Facade使用自定义实现：

1. 创建自定义扩展类
   上述CustomDatabaseTokenRepository和CustomPasswordBroker代码已正确继承原有类，注意引入对应命名空间即可。

2. 在服务提供者中替换绑定
   在AppServiceProvider（或自定义服务提供者）的register方法中添加以下代码：

   use Illuminate\Auth\Passwords\PasswordBroker;
   use Illuminate\Auth\Passwords\DatabaseTokenRepository;
   use App\Auth\CustomPasswordBroker;
   use App\Auth\CustomDatabaseTokenRepository;
   
   public function register()
   {
       // 替换DatabaseTokenRepository绑定
       $this->app->bind(DatabaseTokenRepository::class, function ($app) {
           $connection = $app['db']->connection();
           $table = $app['config']['auth.passwords.users.table'];
           $key = $app['config']['app.key'];
   
           return new CustomDatabaseTokenRepository(
               $connection, $app['hash'], $table, $key
           );
       });
   
       // 替换PasswordBroker绑定
       $this->app->bind(PasswordBroker::class, function ($app) {
           $tokens = $app->make(DatabaseTokenRepository::class);
           $users = $app->make('auth')->createUserProvider('users');
           $mailer = $app->make('mailer');
   
           return new CustomPasswordBroker(
               $tokens, $users, $mailer, $app['config']['auth.passwords.users.email']
           );
       });
   }
   

   注意：若使用非默认users guard，需替换对应配置项（如auth.passwords.{guard}.table和auth.passwords.{guard}.email）。

3. 测试调用
   完成绑定后，即可直接通过Password::getTokenRecord($user)调用自定义方法，完全契合Laravel现有体系。

方案二：使用宏快速实现（适合简单场景） #

若仅需添加单个方法，无需大量扩展原有类功能，可使用Laravel宏功能，无需创建额外扩展类：

在AppServiceProvider的boot方法中添加：

use Illuminate\Auth\Passwords\PasswordBroker;
use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract;

PasswordBroker::macro('getTokenRecord', function (CanResetPasswordContract $user) {
    $record = $this->tokens->getTable()->where(
        'email', $user->getEmailForPasswordReset()
    )->first();

    return $record ? (array) $record : null;
});

添加后同样可通过Password::getTokenRecord($user)调用该方法，这种方式轻量快捷，但扩展性较差，不适合复杂扩展需求。

方案对比 #

• 扩展类绑定：适合对密码重置体系进行多处扩展的场景，代码结构清晰，符合Laravel依赖注入设计，便于测试和维护。
• 宏：适合快速添加单个或少量方法，无需创建额外类文件，实现成本低，但扩展性有限。

内容的提问来源于stack exchange，提问作者Autodesk