README

❤️ 此包可以帮助您将基于用户的关注系统添加到您的模型中。

功能

支持操作
- 关注
- 点赞
- 书签
- 订阅
- 收藏
- 投票（赞同 & 反对票）

安装

要求

PHP 7.0 +
Laravel 5.5 +

您可以使用 composer 安装此包

$ composer require infobizzs/laravel-follow -vvv

然后将服务提供者添加到 config/app.php

Overtrue\LaravelFollow\FollowServiceProvider::class

发布迁移文件

$ php artisan vendor:publish --provider="Overtrue\LaravelFollow\FollowServiceProvider" --tag="migrations"

如果需要修改默认配置，可以选择发布配置文件（可选）

$ php artisan vendor:publish --provider="Overtrue\LaravelFollow\FollowServiceProvider" --tag="config"

并创建表

$ php artisan migrate

最后，将功能特质添加到 User 模型中

use Overtrue\LaravelFollow\Traits\CanFollow;
use Overtrue\LaravelFollow\Traits\CanBeFollowed;

class User extends Model
{
    use CanFollow, CanBeFollowed;
}

用法

将 CanXXX 特质添加到 User 模型。

use Overtrue\LaravelFollow\Traits\CanFollow;
use Overtrue\LaravelFollow\Traits\CanLike;
use Overtrue\LaravelFollow\Traits\CanFavorite;
use Overtrue\LaravelFollow\Traits\CanSubscribe;
use Overtrue\LaravelFollow\Traits\CanVote;
use Overtrue\LaravelFollow\Traits\CanBookmark;

class User extends Model
{
    use CanFollow, CanBookmark, CanLike, CanFavorite, CanSubscribe, CanVote;
}

将 CanBeXXX 特质添加到目标模型，例如 'Post' 或 'Music'...

use Overtrue\LaravelFollow\Traits\CanBeLiked;
use Overtrue\LaravelFollow\Traits\CanBeFavorited;
use Overtrue\LaravelFollow\Traits\CanBeVoted;
use Overtrue\LaravelFollow\Traits\CanBeBookmarked;

class Post extends Model
{
    use CanBeLiked, CanBeFavorited, CanBeVoted, CanBeBookmarked;
}

所有可用的 API 列表如下。

关注

`\Overtrue\LaravelFollow\Traits\CanFollow`

$user->follow($targets)
$user->unfollow($targets)
$user->toggleFollow($targets)
$user->followings()->get() // App\User:class
$user->followings(App\Post::class)->get()
$user->areFollowingEachOther($anotherUser);
$user->isFollowing($target)

`\Overtrue\LaravelFollow\Traits\CanBeFollowed`

$object->followers()->get()
$object->isFollowedBy($user)

书签

`\Overtrue\LaravelFollow\Traits\CanBookmark`

$user->bookmark($targets)
$user->unbookmark($targets)
$user->toggleBookmark($targets)
$user->hasBookmarked($target)
$user->bookmarks()->get() // App\User:class
$user->bookmarks(App\Post::class)->get()

`\Overtrue\LaravelFollow\Traits\CanBeBookmarked`

$object->bookmarkers()->get() // or $object->bookmarkers 
$object->isBookmarkedBy($user)

`\Overtrue\LaravelFollow\Traits\CanLike`

$user->like($targets)
$user->unlike($targets)
$user->toggleLike($targets)
$user->hasLiked($target)
$user->likes()->get() // default object: App\User:class
$user->likes(App\Post::class)->get()

`\Overtrue\LaravelFollow\Traits\CanBeLiked`

$object->likers()->get() // or $object->likers
$object->fans()->get() // or $object->fans
$object->isLikedBy($user)

`\Overtrue\LaravelFollow\Traits\CanFavorite`

$user->favorite($targets)
$user->unfavorite($targets)
$user->toggleFavorite($targets)
$user->hasFavorited($target)
$user->favorites()->get() // App\User:class
$user->favorites(App\Post::class)->get()

`\Overtrue\LaravelFollow\Traits\CanBeFavorited`

$object->favoriters()->get() // or $object->favoriters 
$object->isFavoritedBy($user)

投票

`\Overtrue\LaravelFollow\Traits\CanVote`

$user->vote($target) // Vote with 'upvote' for default
$user->upvote($target)
$user->downvote($target)
$user->cancelVote($target)
$user->hasUpvoted($target)
$user->hasDownvoted($target)
$user->votes(App\Post::class)->get()
$user->upvotes(App\Post::class)->get()
$user->downvotes(App\Post::class)->get()

`\Overtrue\LaravelFollow\Traits\CanBeVoted`

$object->voters()->get()
$object->upvoters()->get()
$object->downvoters()->get()
$object->isVotedBy($user)
$object->isUpvotedBy($user)
$object->isDownvotedBy($user)

参数

上述创建关系的方法（如 'follow', 'like', 'unfollow', 'unlike'）的语法如下

follow(array|int|\Illuminate\Database\Eloquent\Model $targets, $class = __CLASS__)

因此您可以这样调用它们

// Id / Id array
$user->follow(1); // targets: 1, $class = App\User
$user->follow(1, App\Post::class); // targets: 1, $class = App\Post
$user->follow([1, 2, 3]); // targets: [1, 2, 3], $class = App\User

// Model
$post = App\Post::find(7);
$user->follow($post); // targets: $post->id, $class = App\Post

// Model array
$posts = App\Post::popular()->get();
$user->follow($posts); // targets: [1, 2, ...], $class = App\Post

查询关系

$followers = $user->followers
$followers = $user->followers()->where('id', '>', 10)->get()
$followers = $user->followers()->orderByDesc('id')->get()

其他用法相同。

与模型交互。

use Overtrue\LaravelFollow\FollowRelation;

// get most popular object

// all types
$relations = FollowRelation::popular()->get();

// followable_type = App\Post
$relations = FollowRelation::popular(App\Post::class)->get(); 

// followable_type = App\User
$relations = FollowRelation::popular('user')->get();
 
// followable_type = App\Post
$relations = FollowRelation::popular('post')->get();

// Pagination
$relations = FollowRelation::popular(App\Post::class)->paginate(15);

事件

Overtrue\LaravelFollow\Events\RelationAttaching
Overtrue\LaravelFollow\Events\RelationAttached
Overtrue\LaravelFollow\Events\RelationDetaching
Overtrue\LaravelFollow\Events\RelationDetached
Overtrue\LaravelFollow\Events\RelationToggling
Overtrue\LaravelFollow\Events\RelationToggled

Event::listen(\Overtrue\LaravelFollow\Events\RelationAttached::class, function($event) {
    // $event->causer; 
    // $event->getTargetsCollection(); 
    // $event->getRelationType();
});

关于切换事件。

对于 Overtrue\LaravelFollow\Events\RelationToggled 事件，有一个额外的属性。

$event->results; // ['attached' => [1, 2, 3], 'detached' => [5, 6]]
$event->attached; // [1, 2, 3]
$event->detached; // [5, 6]

PHP 扩展包开发

想知道如何从头开始构建 PHP 扩展包吗？

请关注我的实战课程，我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》

许可证

MIT

infobizzs / laravel-follow

维护者

详细信息