Laravel模型自定义集合？集合类如何自定义？

app/Models/Collections

// app/Collections/MyCustomCollection.php <?php  namespace AppCollections;  use IlluminateDatabaseEloquentCollection;  class MyCustomCollection extends Collection {     /**      * 获取集合中所有商品的销售总额。      * 假设集合中的每个模型都有一个 'price' 属性。      *      * @return float      */     public function getTotalSales(): float     {         return $this->sum('price');     }      /**      * 过滤出所有已发布的商品。      * 假设集合中的每个模型都有一个 'is_published' 属性。      *      * @return static      */     public function publishedItems(): static     {         return $this->Filter(fn ($item) => $item->is_published);     } }

// app/Models/Product.php <?php  namespace AppModels;  use AppCollectionsMyCustomCollection; // 引入你的自定义集合类 use IlluminateDatabaseEloquentModel; use IlluminateDatabaseEloquentCollection; // 引入基础集合类，尽管不直接使用，但明确其父类  class Product extends Model {     // ... 其他模型定义      /**      * 创建一个新的 Eloquent 集合实例。      *      * @param  array  $models      * @return IlluminateDatabaseEloquentCollection      */     public function newCollection(array $models = []): Collection     {         return new MyCustomCollection($models);     } }

Product

Product::all()

Product::where(...)->get()

MyCustomCollection

getTotalSales()

publishedItems()

// 示例用法 $products = Product::all(); // $products 现在是 MyCustomCollection 的实例  $totalSales = $products->getTotalSales(); $publishedProducts = $products->publishedItems();

Order

// 在控制器或服务中 $orders = Order::where('user_id', auth()->id())->get(); $totalAmount = $orders->sum('amount'); $paidOrders = $orders->filter(fn($order) => $order->status === 'paid');

OrderCollection

// 在 OrderCollection 中 public function getTotalAmount(): float {     // 这里可以包含复杂的折扣、运费计算逻辑     return $this->sum('amount_after_discount'); }  public function getPaidOrders(): static {     return $this->filter(fn($order) => $order->status === 'paid'); }  public function generateSummaryReport(): array {     // 生成一份订单摘要报告     return [         'total' => $this->count(),         'paid' => $this->getPaidOrders()->count(),         'unpaid' => $this->filter(fn($order) => $order->status === 'pending')->count(),         'total_revenue' => $this->getTotalAmount(),     ]; }

$userOrders = Order::where('user_id', auth()->id())->get(); // 返回 OrderCollection 实例 $report = $userOrders->generateSummaryReport(); $paidOrders = $userOrders->getPaidOrders();

// app/Collections/PostCollection.php <?php  namespace AppCollections;  use IlluminateDatabaseEloquentCollection;  class PostCollection extends Collection {     /**      * 过滤出所有已发布的文章。      * 假设 Post 模型有一个 'is_published' 字段。      *      * @return static      */     public function published(): static     {         return $this->filter(fn ($post) => $post->is_published);     }      /**      * 计算所有文章的阅读时长总和。      * 假设 Post 模型有一个 'read_time_minutes' 字段。      *      * @return int      */     public function totalReadTime(): int     {         return $this->sum('read_time_minutes');     }      /**      * 过滤出包含特定标签的文章。      * 假设 Post 模型有一个 'tags' 关联关系，返回一个标签集合。      *      * @param string $tag      * @return static      */     public function withTag(string $tag): static     {         return $this->filter(fn ($post) =>             $post->tags->contains('name', $tag) // 假设标签模型有 'name' 字段         );     } }

published()

totalReadTime()

极简智能王

极简智能- 智能聊天AI绘画，还可以创作、编写、翻译、写代码等多种功能，满足用户生活和工作的多方面需求

27

查看详情

// app/Models/Post.php <?php  namespace AppModels;  use AppCollectionsPostCollection; // 引入我们自定义的集合类 use IlluminateDatabaseEloquentModel; use IlluminateDatabaseEloquentCollection as BaseCollection; // 引入基础集合类，用于类型提示  class Post extends Model {     // ... 其他模型属性和方法      /**      * 创建一个新的 Eloquent 集合实例。      *      * @param  array  $models      * @return IlluminateDatabaseEloquentCollection      */     public function newCollection(array $models = []): BaseCollection     {         return new PostCollection($models);     }      // 假设 Post 模型有一个 'tags' 关联关系     public function tags()     {         return $this->belongsToMany(Tag::class);     } }

IlluminateDatabaseEloquentCollection

// 假设在控制器或路由中 use AppModelsPost;  // 获取所有文章 $allPosts = Post::all(); // $allPosts 现在是 PostCollection 的实例  // 获取所有已发布的文章 $publishedPosts = $allPosts->published();  // 计算所有已发布文章的总阅读时长 $totalPublishedReadTime = $publishedPosts->totalReadTime();  // 获取所有关于 'Laravel' 标签的文章 // 注意：如果 withTag 方法内部需要访问关联关系，你可能需要提前加载 $laravelPosts = Post::with('tags')->get()->withTag('Laravel');  // 你也可以链式调用 $featuredPublishedPosts = Post::where('is_featured', true)                                 ->get()                                 ->published()                                 ->totalReadTime(); // 这是一个整数，不是集合

filter()

sum()

tags

filter

post->tags

// 潜在的 N+1 问题 $posts = Post::all(); // 未加载 tags $laravelPosts = $posts->withTag('Laravel'); // 循环 N 次，每次查询 tags

// 避免 N+1 问题的正确做法 $posts = Post::with('tags')->get(); // 预加载 tags $laravelPosts = $posts->withTag('Laravel'); // 现在 withTag 内部不会触发额外查询

load()

loadMissing()