Laravel 5.5：如何在分类控制器实现单分类/全分类返回？

云上老周

2026-5-19

实现Laravel 5.5分类API的单/全量返回功能

嘿，这个需求完全不用新建路由！咱们直接在现有GET路由上做调整，就能实现「传ID返回指定分类、不传返回全部分类」的效果，步骤很简单：

1. 修改路由配置

在routes/api.php里，把原有的分类GET路由改成带可选参数的形式，问号?表示这个参数是可选的：

// 可选：加上路由命名方便后续生成URL
Route::get('categories/{category?}', 'CategoriesController@index')->name('categories.index');

// 更严谨的做法：给ID参数加数字约束，非数字ID直接返回404
Route::get('categories/{category?}', 'CategoriesController@index')
    ->where('category', '[0-9]+')
    ->name('categories.index');

2. 调整控制器的index方法

在CategoriesController里，修改index方法接收可选参数，然后根据参数是否存在来返回对应数据：

public function index($categoryId = null)
{
    if ($categoryId) {
        // 查找指定分类，找不到自动返回404响应
        $category = Category::findOrFail($categoryId);
        return response()->json(['data' => $category]);
    }

    // 没有传ID时返回全部分类
    $categories = Category::all();
    return response()->json(['data' => $categories]);
}