一个用于文章收藏的扩展包 Laravel Collect

[Laravel Collect](https://github.com/VetorPers/laravel-collect) 是我开发的一个收藏文章的扩展，借鉴于 [cybercog/laravel-love](https://github.com/cybercog/laravel-love) ，我也有幸参加了社区对该扩展的外文翻译文章 [为你的 Eloquent 模型添加喜欢和讨厌功能](https://learnku.com/laravel/t/15898?#SectionIndex_4)。我的初衷是学习怎么开发 Laravel 扩展包，所以实现的功能可能比较简单，请大神勿喷。但是对于想学习开发 Laravel 扩展包的同学还是不错的。望大家点赞支持，感谢。

最近发现已经有人使用我的扩展包到项目里，我更有动力不断更新完善。fight！

## 安装

通过 composer 安装，命令如下：

```sh

$ composer require vetor/laravel-collect

```

我们需要执行模型迁移命令，将 `Collections` 表发布到我们的数据库：

```sh

$ php artisan migrate

```

## 使用

在我们的收藏者表，即 `User` 表里需要实现 `CollectorContract` 接口，并引用 `Collector trait`:

```

use Illuminate\Foundation\Auth\User as Authenticatable;

use Vetor\Laravel\Collect\Collector\Models\Traits\Collector;

use Vetor\Contracts\Collect\Collector\Models\Collector as CollectorContract;

class User extends Authenticatable implements CollectorContract

{

    use Collector;

}

```

如果用户需要收藏文章，在 `Article` 表里实现 `CollectableContract` 接口并引用 `Collectable trait` 即可：

```

use Vetor\Laravel\Collect\Collectable\Models\Traits\Collectable;

use Vetor\Contracts\Collect\Collectable\Models\Collectable as CollectableContract;

class Article extends Model implements CollectableContract

{

    use Collectable;

}

```

## 可用的方法

对于用户来说,可用的方法有：

```

// 收藏

$user->collect($article);

// 取消收藏

$user->cancelCollect($article);

// 用户的所有收藏记录

$user->collections;

// 用户收藏的文章记录

$user->collectionsWhereCollectable(Article::class);

```

文章可用的方法有：

```

// 收藏

$article->collect();

// 取消收藏(默认为当前用户，可以把用户实例作为参数传入)

$article->cancelCollect();

//  获取文章的收藏情况

$article->collections();

// 获取文章收藏数

$article->collections_count;

// 根据收藏数排序(升序 'asc'；降序 'desc'；默认为升序)

Article::orderByCollectionsCount()->get();

```

我们可以通过下面的方法来获取收藏表里所有文章：

```

Collection::whereCollectable(Article::class)->get();

```

## 更多

代码参见 Github 仓库 [vetor/laravel-collect](https://github.com/VetorPers/laravel-collect)，欢迎大家提出自己的想法，指出不足，我们一起学习进步。再次感谢 [cybercog/laravel-love](https://github.com/cybercog/laravel-love) 。