User favorite features for Laravel Application.

4.0.1 2021-06-09 06:20 UTC

This package is auto-updated.

Last update: 2021-09-27 08:17:28 UTC


❤️ User favorite feature for Laravel Application.

CI Latest Stable Version Latest Unstable Version Total Downloads License


$ composer require overtrue/laravel-favorite -vvv


This step is optional

$ php artisan vendor:publish --provider="Overtrue\\LaravelFavorite\\FavoriteServiceProvider" --tag=config


This step is also optional, if you want to custom favorites table, you can publish the migration files:

$ php artisan vendor:publish --provider="Overtrue\\LaravelFavorite\\FavoriteServiceProvider" --tag=migrations




use Illuminate\Notifications\Notifiable;
use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Overtrue\LaravelFavorite\Traits\Favoriter;

class User extends Authenticatable
    use Favoriter;


use Illuminate\Database\Eloquent\Model;
use Overtrue\LaravelFavorite\Traits\Favoriteable;

class Post extends Model
    use Favoriteable;



$user = User::find(1);
$post = Post::find(2);



Get object favoriters:

foreach($post->favoriters as $user) {
    // echo $user->name;

Get Favorite Model from User.

Used Favoriter Trait Model can easy to get Favoriteable Models to do what you want. *note: this method will return a Illuminate\Database\Eloquent\Builder *


// Do more
$favortePosts = $user->getFavoriteItems(Post::class)->get();
$favortePosts = $user->getFavoriteItems(Post::class)->paginate();
$favortePosts = $user->getFavoriteItems(Post::class)->where('title', 'Laravel-Favorite')->get();


// all

// with type

// favoriters count

List with *_count attribute:

$users = User::withCount('favorites')->get();

foreach($users as $user) {
    echo $user->favorites_count;

// for Favoriteable models: 
$posts = Post::withCount('favoriters')->get();

foreach($posts as $post) {
    echo $post->favorites_count;

Attach user favorite status to favoriteable collection

You can use Favoriter::attachFavoriteStatus(Collection $favoriteables) to attach the user favorite status, it will set has_favorited attribute to each model of $favoriteables:

For model

$post = Post::find(1);

$post = $user->attachFavoriteStatus($post);

// result
    "id" => 1
    "title" => "Add socialite login support."
    "created_at" => "2021-05-20T03:26:16.000000Z"
    "updated_at" => "2021-05-20T03:26:16.000000Z"
    "has_favorited" => true

For Collection | Paginator | LengthAwarePaginator | array:

$posts = Post::oldest('id')->get();

$posts = $user->attachFavoriteStatus($posts);

$posts = $posts->toArray();

// result
    "id" => 1
    "title" => "Post title1"
    "created_at" => "2021-05-20T03:26:16.000000Z"
    "updated_at" => "2021-05-20T03:26:16.000000Z"
    "has_favorited" => true
    "id" => 2
    "title" => "Post title2"
    "created_at" => "2021-05-20T03:26:16.000000Z"
    "updated_at" => "2021-05-20T03:26:16.000000Z"
    "has_favorited" => fasle
    "id" => 3
    "title" => "Post title3"
    "created_at" => "2021-05-20T03:26:16.000000Z"
    "updated_at" => "2021-05-20T03:26:16.000000Z"
    "has_favorited" => true

For pagination

$posts = Post::paginate(20);


N+1 issue

To avoid the N+1 issue, you can use eager loading to reduce this operation to just 2 queries. When querying, you may specify which relationships should be eager loaded using the with method:

// Favoriter
$users = User::with('favorites')->get();

foreach($users as $user) {

// Favoriteable
$posts = Post::with('favorites')->get();
// or 
$posts = Post::with('favoriters')->get();

foreach($posts as $post) {


Event Description
Overtrue\LaravelFavorite\Events\Favorited Triggered when the relationship is created.
Overtrue\LaravelFavorite\Events\Unfavorited Triggered when the relationship is deleted.

Related packages


You can contribute in one of three ways:

  1. File bug reports using the issue tracker.
  2. Answer questions or fix bugs on the issue tracker.
  3. Contribute new features or update the wiki.

The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

PHP 扩展包开发

想知道如何从零开始构建 PHP 扩展包?

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