Laravel中如何为资源控制器添加自定义方法并解决相关报错

问题原因与解决方案 #

1. 路由写法不一致导致控制器类无法找到 #

Laravel 8及之后版本，路由配置文件默认取消了$namespace前缀配置，你当前自定义路由使用了老式字符串写法'PostController@reorder'，系统无法解析到对应控制器类，这是Target class [PostController] does not exist报错的直接原因。而你的资源路由使用了PostController::class的标准写法，所以默认资源方法可以正常访问。

2. 修复路由配置 #

将自定义路由修改为和资源路由一致的写法，同时保持自定义路由放在资源路由之前的顺序即可：

// 记得顶部引入PostController的命名空间
use App\Http\Controllers\PostController;

Route::put('/post/reorder/{id}', [PostController::class, 'reorder']);
Route::resource('/post', PostController::class);

3. 控制器代码优化 #

• 注意方法中findOrfail要修正为正确写法findOrFail（首字母F大写，否则会报方法不存在错误）
• 增加字段验证，仅接收需要更新的order字段，符合你只更新单个字段的需求：

public function reorder(Request $request, $id){
    $request->validate([
        'order' => 'required|integer'
    ]);
    $post = Post::findOrFail($id);
    $post->update([
        'order' => $request->input('order')
    ]);
    // 按项目规范返回对应响应即可
    return response()->json(['code' => 0, 'msg' => '排序更新成功']);
}

4. 验证配置 #

修复完成后执行php artisan route:list，不会再抛出类不存在的错误，同时可以看到post/reorder/{id}的路由优先级高于资源路由的更新路由，不会被覆盖。前端请求路径无需修改，可以正常调用。

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