Filament框架：能否修改默认认证表、实现手机号OTP登录并对接API？

1. 替换默认认证表 #

Filament完全支持将默认的user表替换为自定义表，操作步骤如下：

• 创建自定义认证模型（比如Admin），对应你的目标数据表（比如admins），确保模型继承Illuminate\Foundation\Auth\User并实现必要的认证接口。
• 在config/auth.php中配置对应的认证guard和provider：

  'guards' => [
      'filament' => [
          'driver' => 'session',
          'provider' => 'admins',
      ],
  ],
  
  'providers' => [
      'admins' => [
          'driver' => 'eloquent',
          'model' => App\Models\Admin::class,
      ],
  ],
  

• 修改config/filament.php中的auth配置，指定自定义的guard：

  'auth' => [
      'guard' => 'filament',
      'pages' => [
          'login' => \Filament\Pages\Auth\Login::class,
      ],
  ],
  

2. 手机号+OTP登录（手机号不在user表） #

这种场景需要自定义Filament的认证逻辑，核心步骤：

• 确保你有存储手机号的关联表（比如user_profiles，与user表通过外键关联）。
• 自定义登录请求类，替换Filament默认的LoginRequest，在验证逻辑中校验手机号和OTP，而非邮箱/密码：

  namespace App\Http\Requests\Filament;
  
  use Filament\Http\Requests\Auth\LoginRequest as BaseLoginRequest;
  
  class LoginRequest extends BaseLoginRequest
  {
      public function authorize(): bool
      {
          return true;
      }
  
      public function rules(): array
      {
          return [
              'phone' => ['required', 'string'],
              'otp' => ['required', 'string'],
          ];
      }
  
      public function authenticate(): void
      {
          $profile = \App\Models\UserProfile::where('phone', $this->phone)->firstOrFail();
          // 验证OTP逻辑，比如调用缓存或第三方验证服务
          if (!verifyOtp($this->phone, $this->otp)) {
              $this->throwValidationException(
                  \Illuminate\Validation\ValidationException::withMessages([
                      'otp' => ['验证码错误'],
                  ])
              );
          }
          auth()->login($profile->user);
      }
  }
  

• 发布Filament登录视图，替换默认字段为手机号和OTP输入框：

  php artisan vendor:publish --tag=filament-views
  

  修改resources/views/vendor/filament/pages/auth/login.blade.php中的表单字段，添加手机号输入框和OTP输入框，以及获取OTP的按钮逻辑。

3. Filament对接API支持 #

Filament完全支持对接API，常见实现方式：

• 调用外部API：在Filament的资源、页面或组件中，直接使用Laravel的Http facade调用外部API，获取数据后在Filament表格、表单中展示，或者用于业务逻辑处理。
• 提供内部API：基于Laravel的特性，你可以在项目中正常编写API路由和控制器，Filament后台与API服务可以共存，甚至通过Filament资源管理API的后台数据。
• 集成第三方API服务：比如对接短信API发送OTP、对接支付API等，都可以在Filament的自定义逻辑中直接实现，没有框架层面的限制。

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