23、Laravel API开发：排序、过滤、转换、嵌套及认证全解析

Laravel API开发：排序、过滤、转换、嵌套及认证全解析

1. 排序和过滤

1.1 JSON API规范

JSON API是处理基于JSON的API中许多常见任务的标准，包括过滤、排序、分页、认证、嵌入、链接、元数据等。虽然Laravel的默认分页不完全符合JSON API规范，但它为我们指明了正确的方向。JSON API规范要求文档至少包含以下顶级成员之一：
- data ：文档的“主要数据”
- errors ：错误对象数组
- meta ：包含非标准元信息的元对象

data 和 errors 不能在同一文档中同时存在。

1.2 排序API结果

1.2.1 单字段单方向排序

// Handles /dogs?sort=name
Route::get('dogs', function (Request $request) {
    // Get the sort query parameter (or fall back to default sort "name")
    $sortCol = $request->input('sort', 'name');
    return Dog::orderBy($sortCol)->paginate(20);
});

1.2.2 单字段双向排序