Laravel路由如何获取URL中?后的offset与limit查询参数？

嘿，其实你完全不需要修改现有的路由定义哦！因为offset和limit属于URL的查询字符串参数，不是路由路径参数，Laravel会自动把这些参数传递给对应的控制器方法，根本不用在路由里额外配置。

为什么不用改路由？ #

你当前的路由：

Route::group(['prefix' => 'api'], function () { 
    Route::get('/authors/{authorId}/books', 'ApiController@show')->name('api.show'); 
});

已经完美匹配http://test.com/api/authors/carroll/books?offset=1&limit=5这个URL了——路由只负责匹配/api/authors/carroll/books这部分路径，后面的?offset=1&limit=5是查询参数，Laravel会自动处理并让你在控制器中获取。

如何在控制器中获取这两个参数？ #

有两种常用的方式：

方式一：使用request()辅助函数

直接在控制器方法里调用辅助函数获取，还可以设置默认值（防止参数未传递时出现错误）：

public function show($authorId)
{
    $offset = request()->get('offset', 0); // 默认值0
    $limit = request()->get('limit', 10); // 默认值10
    
    // 用参数执行逻辑，比如查询书籍
    $books = \App\Models\Book::where('author_id', $authorId)
        ->skip($offset)
        ->take($limit)
        ->get();
        
    return response()->json($books);
}

方式二：注入Request实例（更推荐，符合依赖注入规范）

在控制器方法中注入Illuminate\Http\Request类，然后通过query()方法获取参数：

use Illuminate\Http\Request;

public function show(Request $request, $authorId)
{
    // 获取参数，带默认值
    $offset = $request->query('offset', 0);
    $limit = $request->query('limit', 10);
    
    // 可选：对参数做验证，确保合法性
    $validated = $request->validate([
        'offset' => 'integer|min:0',
        'limit' => 'integer|min:1|max:50', // 限制最大条数防止性能问题
    ]);
    
    // 用验证后的参数查询
    $books = \App\Models\Book::where('author_id', $authorId)
        ->skip($validated['offset'])
        ->take($validated['limit'])
        ->get();
        
    return response()->json($books);
}

额外提示 #

如果你的需求是强制要求这两个参数必须存在，可以在验证规则里加上required，比如：

$validated = $request->validate([
    'offset' => 'required|integer|min:0',
    'limit' => 'required|integer|min:1|max:50',
]);

这样当参数缺失时，Laravel会自动返回422验证错误响应。

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