Laravel API分页：如何仅返回next_page_url？移除指定字段无效问题

你遇到的问题很常见——直接操作LengthAwarePaginator实例的属性没用，因为它是一个对象，不是普通数组。下面给你几个实用的解决办法：

方法1：手动构建响应数组（快速直接） #

直接提取你需要的字段返回，不需要修改分页器本身：

$categories = Category::paginate(15);

return response()->json([
    'data' => $categories->items(), // 获取当前页的数据
    'next_page_url' => $categories->nextPageUrl() // 仅保留下一页链接
]);

方法2：使用资源集合（优雅复用） #

如果这个分页格式需要在多个地方使用，推荐用Laravel的资源集合来标准化响应：

1. 生成资源集合类：

php artisan make:resource CategoryCollection

2. 修改CategoryCollection类的toArray方法：

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\ResourceCollection;

class CategoryCollection extends ResourceCollection
{
    public function toArray($request)
    {
        return [
            'data' => $this->collection,
            'next_page_url' => $this->nextPageUrl()
        ];
    }
}

3. 在控制器中使用：

use App\Http\Resources\CategoryCollection;
use App\Models\Category;

// ...

return new CategoryCollection(Category::paginate(15));

方法3：转换为数组后过滤字段 #

如果你不想用资源，可以先把分页器转为数组，再删除不需要的字段：

$categories = Category::paginate(15)->toArray();

// 删除不需要的字段
unset($categories['last_page'], $categories['prev_page_url'], $categories['first_page_url'], $categories['last_page_url']);

// 或者用array_only只保留需要的键
$filteredResponse = array_only($categories, ['data', 'next_page_url']);

return response()->json($filteredResponse);

顺便说下为什么之前unset($categories->last_page)无效：因为paginate()返回的是LengthAwarePaginator对象，它的属性是受保护的，直接unset对象属性不会生效，必须先转为数组再操作。

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