Looking to hire Laravel developers? Try LaraJobs

laravel-follows maintained by pharaonic

Description
Polymorphic follows for Laravel Eloquent models, with database-enforced uniqueness and explicit changed-state results.
Last update
2026/11/12 23:45 (dev-develop)
License
Links
Downloads
1

Comments
comments powered by Disqus

Installation

composer require pharaonic/laravel-follows
php artisan migrate

The service provider is registered automatically, and migrate creates the follows table. Publish the migration only to change it (--tag=follows-migrations), and the configuration only to rename the table or turn off cleanup on delete:

php artisan vendor:publish --tag=follows-config

Usage

Add CanFollow to the model that follows (it does not have to be a user) and HasFollowers to the model that is followed. A model can use both.

use Illuminate\Foundation\Auth\User as Authenticatable;
use Pharaonic\Laravel\Follows\Concerns\CanFollow;

class User extends Authenticatable
{
    use CanFollow;
}
use Illuminate\Database\Eloquent\Model;
use Pharaonic\Laravel\Follows\Concerns\HasFollowers;

class Post extends Model
{
    use HasFollowers;
}
$user->follow($post);        // true: this call created the follow
$user->follow($post);        // false: it already existed
$user->isFollowing($post);   // true
$user->unfollow($post);      // true: this call removed it, false when there was none
$user->toggleFollow($post);  // the new state: true when followed

$post->followBy($user);      // same as $user->follow($post)
$post->unfollowBy($user);    // same as $user->unfollow($post)
$post->followedBy($user);    // same as $user->isFollowing($post)

Post::withCount('followers')->with('followers.follower')->get();
Post::whereFollowedBy($user)->latest()->paginate();
$user->followings()->with('followable')->latest()->get();

Documentation

Full documentation: Laravel Follows Documentation.

Support & Security

See SUPPORT.md and SECURITY.md. Contributions are welcome; see CONTRIBUTING.md.

License

MIT. See LICENSE.