Add resource helper functions

laravel · taylorotwell · Apr 2, 2025 · Mar 20, 2025 · Mar 20, 2025 · Mar 20, 2025
commit 0909ce1da6ff1f57d1ab54ba40daab449bfed35e
diff --git a/src/Illuminate/Database/Eloquent/Collection.php b/src/Illuminate/Database/Eloquent/Collection.php
@@ -6,6 +6,8 @@
 use Illuminate\Contracts\Queue\QueueableEntity;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Database\Eloquent\Relations\Concerns\InteractsWithDictionary;
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Http\Resources\Json\ResourceCollection;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection as BaseCollection;
 use LogicException;
@@ -843,4 +845,16 @@ public function toQuery()
 
         return $model->newModelQuery()->whereKey($this->modelKeys());
     }
+
+
+    /**
+     * Create a new resource collection instance for the given resource.
+     *
+     * @param class-string<JsonResource> $resourceClass
+     * @return ResourceCollection
+     */
+    public function toResourceCollection(string $resourceClass): ResourceCollection
+    {
+        return $resourceClass::collection($this);
+    }
 }
diff --git a/src/Illuminate/Database/Eloquent/Model.php b/src/Illuminate/Database/Eloquent/Model.php
@@ -17,6 +17,7 @@
 use Illuminate\Database\Eloquent\Relations\Concerns\AsPivot;
 use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Database\Eloquent\Relations\Pivot;
+use Illuminate\Http\Resources\Json\JsonResource;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection as BaseCollection;
 use Illuminate\Support\Str;
@@ -2459,4 +2460,15 @@ public function __wakeup()
 
         $this->initializeTraits();
     }
+
+    /**
+     * Create a new resource object for the given resource.
+     *
+     * @param class-string<JsonResource> $resourceClass
+     * @return JsonResource
+     */
+    public function toResource(string $resourceClass): JsonResource
+    {
+        return $resourceClass::make($this);
+    }
 }
diff --git a/src/Illuminate/Pagination/AbstractPaginator.php b/src/Illuminate/Pagination/AbstractPaginator.php
@@ -4,6 +4,8 @@
 
 use Closure;
 use Illuminate\Contracts\Support\Htmlable;
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Http\Resources\Json\ResourceCollection;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Traits\ForwardsCalls;
@@ -799,4 +801,15 @@ public function __toString()
     {
         return (string) $this->render();
     }
+
+    /**
+     * Create a paginated resource collection.
+     *
+     * @param class-string<JsonResource> $resourceClass
+     * @return ResourceCollection
+     */
+    public function toResourceCollection(string $resourceClass): ResourceCollection
+    {
+        return $resourceClass::collection($this);
+    }
 }