Laravel控制器方法依据路由返回结果的最佳实践问询

在PossessionController中，我编写了如下store方法：

public function store(StorePossessionRequest $r)
{
    $poss = Possession::create($r->validated());

    Log::quickStore(Possession::class, null, $poss);
    
    if (request()->url() != route('possessions.create'))
        return response(['message' => 'OK.'], 200);
    return redirect()->route('possessions');
}

该方法可通过两个URI访问：

https://apk.test/possessions/create
https://apk.test/api/possessions/create

目前我通过判断请求URL来决定返回JSON响应或重定向，请问这种根据URI决定返回内容的方式是否为最佳实践？是否有更优实现方案？

回答 #

原实现的问题 #

• 耦合性过高：业务逻辑与URI路径强绑定，后续如果调整URI规则（比如修改API前缀），必须同步修改判断条件，维护成本高。
• 灵活性不足：无法覆盖同一URI下的不同请求场景（比如Web页面提交和AJAX异步提交）。
• 不符合HTTP规范：RESTful架构中，响应类型应由请求的Accept头决定，而非URI路径。

更优实现方案 #

1. 拆分路由与控制器（推荐）

将Web端和API端的逻辑拆分到独立控制器，通过路由分组明确区分：

路由定义：

// web.php
Route::post('/possessions/create', [WebPossessionController::class, 'store'])->name('possessions.create');

// api.php
Route::post('/possessions/create', [ApiPossessionController::class, 'store']);

Web端控制器：

class WebPossessionController extends Controller
{
    public function store(StorePossessionRequest $r)
    {
        $poss = Possession::create($r->validated());
        Log::quickStore(Possession::class, null, $poss);
        return redirect()->route('possessions');
    }
}

API端控制器：

class ApiPossessionController extends Controller
{
    public function store(StorePossessionRequest $r)
    {
        $poss = Possession::create($r->validated());
        Log::quickStore(Possession::class, null, $poss);
        return response(['message' => 'OK.'], 200);
    }
}

这种方式职责清晰，代码可维护性更强，后续扩展新功能也更方便。

2. 根据请求Accept头判断

如果不想拆分控制器，可以利用Laravel内置方法判断请求是否期望JSON响应：

public function store(StorePossessionRequest $r)
{
    $poss = Possession::create($r->validated());
    Log::quickStore(Possession::class, null, $poss);
    
    if (request()->wantsJson()) {
        return response(['message' => 'OK.'], 200);
    }
    return redirect()->route('possessions');
}

wantsJson()会自动识别请求头中的Accept: application/json，或者AJAX请求的X-Requested-With头，更符合HTTP规范。

3. 路由前缀标识（可选）

可以通过路由前缀区分请求类型，比如：

// web.php
Route::prefix('web')->group(function () {
    Route::post('/possessions/create', [PossessionController::class, 'store'])->name('possessions.create');
});

// api.php
Route::prefix('api')->group(function () {
    Route::post('/possessions/create', [PossessionController::class, 'store']);
});

控制器中通过request()->route()->getPrefix()判断：

public function store(StorePossessionRequest $r)
{
    $poss = Possession::create($r->validated());
    Log::quickStore(Possession::class, null, $poss);
    
    if (request()->route()->getPrefix() === 'api') {
        return response(['message' => 'OK.'], 200);
    }
    return redirect()->route('possessions');
}

不过这种方式的优雅度低于前两种，仅作为备选方案。

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