本文详解如何为 Fortify 的 /user/confirm-password 路由实现条件化响应：对 AJAX 请求返回标准 JSON，对普通请求执行重定向，通过绑定自定义响应类替代默认空接口实现。
本文详解如何为 fortify 的 `/user/confirm-password` 路由实现条件化响应：对 ajax 请求返回标准 json，对普通请求执行重定向，通过绑定自定义响应类替代默认空接口实现。
Laravel Fortify 默认将密码确认逻辑封装在 ConfirmablePasswordController@store 方法中，其响应行为依赖两个契约接口：PasswordConfirmedResponse 和 FailedPasswordConfirmationResponse。值得注意的是，这两个接口本身不包含任何方法定义（即“空接口”），Fortify 仅通过依赖注入容器解析其实现类，并调用其 toResponse($request) 方法——这正是我们自定义响应逻辑的关键入口。
要使 /user/confirm-password 在 XHR 请求时返回 JSON（如前端使用 Axios 或 Fetch 触发确认），需在服务提供者中显式绑定这两个接口的具体实现。推荐在 App\Providers\FortifyServiceProvider 的 register() 方法中完成：
use Illuminate\Http\JsonResponse;
use Laravel\Fortify\Contracts\FailedPasswordConfirmationResponse;
use Laravel\Fortify\Contracts\PasswordConfirmedResponse;
public function register()
{
$this->app->instance(PasswordConfirmedResponse::class, new class implements PasswordConfirmedResponse {
public function toResponse($request)
{
return $request->wantsJson()
? new JsonResponse(['confirmed' => true], 200)
: redirect()->back()->with('confirmed', true);
}
});
$this->app->instance(FailedPasswordConfirmationResponse::class, new class implements FailedPasswordConfirmationResponse {
public function toResponse($request)
{
return $request->wantsJson()
? new JsonResponse(['confirmed' => false, 'message' => 'Password confirmation failed.'], 422)
: redirect()->back()->with('error', 'Invalid password.');
}
});
}
✅ 关键说明：
- new class implements XxxResponse { ... } 是 PHP 的匿名类语法，避免创建独立文件；
- redirect()->back() 比 back() 更明确，语义一致且兼容性更佳；
- JSON 响应建议包含语义化字段（如 confirmed, message）和合理状态码（成功用 200，失败用 422 Unprocessable Entity）；
- 确保已引入 Illuminate\Http\JsonResponse 类；
- 修改后需运行 php artisan config:clear（若缓存了配置）或重启开发服务器以确保绑定生效。
此方案完全遵循 Fortify 的契约设计哲学：不修改核心控制器，而是通过容器绑定解耦定制逻辑，既保持升级安全性，又满足前后端分离场景下的 API 响应需求。
