自定义 Laravel 5.5 Api 资源集合分页

Question

我一直在使用 laravel api 资源。默认情况下，laravel 提供如下所示的链接和元数据。

"links": {
    "first": "https://demo.test/api/v2/taxes?page=1",
    "last": "https://demo.test/api/v2/taxes?page=4",
    "prev": null,
    "next": "https://demo.test/api/v2/taxes?page=2"
},
"meta": {
   "current_page": 1,
   "from": 1,
   "last_page": 4,
   "path": "https://demo.test/api/v2/taxes",
   "per_page": 2,
   "to": 2,
   "total": 8
} 

但我不想要这个，我想要类似的东西

"pagination": {
  "total": 8,
  "count": 8,
  "per_page": 25,
  "current_page": 1,
  "total_pages": 1
}

我能够获得此信息，但如果我这样做return TaxResource::collection($taxes);，我将无法获得此信息。即使我有自定义收集方法

 public static function collection($resource)
    {
       $resource->pagination = [
        'total' => $resource->total(),
        'count' => $resource->count(),
        'per_page' => $resource->perPage(),
        'current_page' => $resource->currentPage(),
        'total_pages' => $resource->lastPage()
       ];
        return parent::collection($resource);
    }

它没有给我想要的东西。但是，如果我通过(TaxResource::collection($taxes))->pagination; 进行引用，我就能得到它。但我希望它在我做@​​987654327@时被退回

Answer 1

我对您的问题很感兴趣，并花了一些时间来解决它。我想未来还有很多工作要做来改进 Eloquent: API Resources 的 功能。

为了解决它，我必须使用 Resource Collections 而不是 Resources：

但是，如果您需要自定义随集合返回的元数据，则需要定义资源集合

php artisan make:resource Tax --collection

或

php artisan make:resource TaxCollection

路线：

Route::get('/get-taxes', function () {
    $taxes = Taxes::paginate();
    return new TaxCollection($taxes);
});

TaxCollection.php：

<?php

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\ResourceCollection;

class TaxCollection extends ResourceCollection
{        
    public function toArray($request)
    {
        return [
        'data' => $this->collection,
        'pagination' => [
            'total' => $this->total(),
            'count' => $this->count(),
            'per_page' => $this->perPage(),
            'current_page' => $this->currentPage(),
            'total_pages' => $this->lastPage()
        ],
    ];
    }  

    // Using Laravel < 5.6
    public function withResponse($request, $response)
    {
        $originalContent = $response->getOriginalContent();
        unset($originalContent['links'],$originalContent['meta']);
        $response->setData($originalContent);
    }

    // Using Laravel >= 5.6
    public function withResponse($request, $response)
    {
        $jsonResponse = json_decode($response->getContent(), true);
        unset($jsonResponse['links'],$jsonResponse['meta']);
        $response->setContent(json_encode($jsonResponse));
    }
}

这解决了问题，但现在有新的： 与 Resources 不同，我不知道如何修改 Resource Collections 中的 toArray 字段，该手册仅显示了 'data' => $this->collection 的示例，其中我们发送未修改的集合（资源集合允许我们更改元数据）。所以如果我们只使用 Resource 那么我们可以修改集合数据而不是元数据。

Answer 2

接受的答案对我不起作用（在 Laravel 5.6 中），但恕我直言，我找到了更好的方法。

将分页信息保存在 ResourceCollection 构造函数中，并将 Paginator 资源替换为底层 Collection。

TaxCollection.php：

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\ResourceCollection;

class TaxCollection extends ResourceCollection
{
    private $pagination;

    public function __construct($resource)
    {
        $this->pagination = [
            'total' => $resource->total(),
            'count' => $resource->count(),
            'per_page' => $resource->perPage(),
            'current_page' => $resource->currentPage(),
            'total_pages' => $resource->lastPage()
        ];

        $resource = $resource->getCollection();

        parent::__construct($resource);
    }

    public function toArray($request)
    {
        return [
            'data' => $this->collection,
            'pagination' => $this->pagination
        ];
    }
}

Answer 3

所以我发现在 PHP 中，您实际上可以调用祖父函数而无需反射或其他变通方法。

鉴于 TaxCollection 扩展了 ResoureCollection，而 ResoureCollection 又扩展了 JsonResource，我们实际上可以绕过处理分页的 ResourceCollection 方法。

class TaxCollection extends ResourceCollection
{        
    public function toArray($request)
    {
        return [
        'data' => $this->collection,
        'pagination' => [
            'total' => $this->total(),
            'count' => $this->count(),
            'per_page' => $this->perPage(),
            'current_page' => $this->currentPage(),
            'total_pages' => $this->lastPage()
        ],
    ];
    }  

    public function toResponse($request)
    {
        return JsonResource::toResponse($request);
    }
}

toResponse 方法调用不是静态的，而是调用祖父 JsonResource::toResponse 方法，就像 parent::toResponse 调用 ResourceCollection toResponse(..) 实例方法一样。

这将从 JSON 响应（链接、元数据等）中删除所有额外的分页字段，并允许您在 toArray($request) 中根据需要自定义响应

Answer 4

您还可以扩展 JsonResource、AnonymousResourceCollection、ResourceCollection 和最后的 PaginatedResourceResponse

Answer 5

@yrv16 Laravel 5.6 版本：

public function withResponse($request, $response)
{
    $jsonResponse = json_decode($response->getContent(), true);
    unset($jsonResponse['links'],$jsonResponse['meta']);
    $response->setContent(json_encode($jsonResponse));
}

Answer 6

JsonResource 类带有一个 Additional() 方法，可让您在使用资源时指定您希望作为响应的一部分的任何其他数据：

   Route::get('/get-taxes', function () {
    $taxes = Taxes::paginate();
    return new TaxCollection($s)->additional([
       'pagination' => [
          'total' => $taxes->total,
           ...
        ]
      ]);
   });