Laravel：如何通过路由变量指定分页显示条数

咱们一步步来搞定这个动态分页的需求，先从路由排查入手，再落实控制器的逻辑：

一、先排查路由配置是否正确 #

首先确认你的分类页面路由是否指向了ShopController的对应方法，举个典型的Laravel路由配置例子：

// routes/web.php
// 固定分类路由
Route::get('/first-category', [ShopController::class, 'showCategory'])->name('category.first');
// 或者支持动态分类slug的通用路由
Route::get('/{categorySlug}', [ShopController::class, 'showCategory'])->name('category.view');

需要检查的点：

• 路由是否准确关联到ShopController的目标方法（比如上面的showCategory）
• 有没有路由参数和请求参数numProducts重名？如果路由里定义了同名参数，会覆盖URL上的请求参数，这点一定要注意

二、在ShopController中实现动态分页逻辑 #

接下来在控制器方法里处理请求参数，同时做必要的合法性校验，避免非法值导致报错：

// app/Http/Controllers/ShopController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Product;

class ShopController extends Controller
{
    public function showCategory(Request $request, $categorySlug = null)
    {
        // 1. 获取请求参数，设置默认分页数量（比如默认每页12个）
        $perPage = $request->input('numProducts', 12);
        
        // 2. 校验参数：确保是正整数，防止非法值破坏分页逻辑
        $perPage = is_numeric($perPage) && $perPage > 0 ? (int)$perPage : 12;

        // 3. 查询对应分类的商品并应用分页
        // 这里的分类关联逻辑请根据你的实际模型关系调整
        $products = Product::where('category_slug', $categorySlug)
            ->paginate($perPage);

        // 4. 把分页数据传给视图
        return view('pages.category', compact('products'));
    }
}

这段代码的核心逻辑：

• 用$request->input()获取URL上的numProducts参数，第二个参数是默认值，用户没传参数时就用默认值
• 加了一层校验，确保传入的是正整数，避免用户传负数、字符串等无效值导致分页出错
• 把分页后的商品集合传给pages.category视图，视图里可以直接用Laravel自带的分页渲染代码（比如{{ $products->links() }}）

三、常见问题排查 #

如果设置后还是不生效，检查这几个地方：

• 请求参数是否正常传递：在控制器方法里加dd($request->all());，访问目标URL后看看numProducts参数是否能被正确获取
• 视图是否正确使用分页数据：确认视图里用的是分页实例$products，而不是普通的查询集合
• 路由缓存问题：如果之前缓存过路由，执行php artisan route:clear清除缓存，确保新的路由配置生效

这样调整后，用户访问http://example.com/first-category?numProducts=99时，pages.category视图就会每页显示99个商品了。

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