| Dir : /home/foruwedy/public_html/vendor/overtrue/laravel-favorite/ |
| Server: Linux premium227.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64 IP: 66.29.146.38 |
| Dir : /home/foruwedy/public_html/vendor/overtrue/laravel-favorite/README.md |
## Laravel Favorite
â¤ï¸ User favorite feature for Laravel Application.
[](https://github.com/overtrue/laravel-favorite/actions)
[](https://packagist.org/packages/overtrue/laravel-favorite)
[](https://packagist.org/packages/overtrue/laravel-favorite)
[](https://packagist.org/packages/overtrue/laravel-favorite)
[](https://packagist.org/packages/overtrue/laravel-favorite)
[](https://github.com/sponsors/overtrue)
## Installing
```shell
composer require overtrue/laravel-favorite -vvv
```
### Configuration & Migrations
```php
php artisan vendor:publish --provider="Overtrue\LaravelFavorite\FavoriteServiceProvider"
```
## Usage
### Traits
#### `Overtrue\LaravelFavorite\Traits\Favoriter`
```php
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;
<...>
}
```
#### `Overtrue\LaravelFavorite\Traits\Favoriteable`
```php
use Illuminate\Database\Eloquent\Model;
use Overtrue\LaravelFavorite\Traits\Favoriteable;
class Post extends Model
{
use Favoriteable;
<...>
}
```
### API
```php
$user = User::find(1);
$post = Post::find(2);
$user->favorite($post);
$user->unfavorite($post);
$user->toggleFavorite($post);
$user->getFavoriteItems(Post::class)
$user->hasFavorited($post);
$post->hasBeenFavoritedBy($user);
```
#### Get object favoriters:
```php
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` _
```php
$user->getFavoriteItems(Post::class);
// Do more
$favoritePosts = $user->getFavoriteItems(Post::class)->get();
$favoritePosts = $user->getFavoriteItems(Post::class)->paginate();
$favoritePosts = $user->getFavoriteItems(Post::class)->where('title', 'Laravel-Favorite')->get();
```
### Aggregations
```php
// all
$user->favorites()->count();
// with type
$user->favorites()->withType(Post::class)->count();
// favoriters count
$post->favoriters()->count();
```
List with `*_count` attribute:
```php
$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($favoriteables)` to attach the user favorite status, it will set `has_favorited` attribute to each model of `$favoriteables`:
#### For model
```php
$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 | CursorPaginator | array`:
```php
$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" => false
],
[
"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
```php
$posts = Post::paginate(20);
$user->attachFavoriteStatus($posts);
```
### 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:
```php
// Favoriter
$users = User::with('favorites')->get();
foreach($users as $user) {
$user->hasFavorited($post);
}
// with favoriteable object
$users = User::with('favorites.favoriteable')->get();
foreach($users as $user) {
$user->hasFavorited($post);
}
// Favoriteable
$posts = Post::with('favorites')->get();
// or
$posts = Post::with('favoriters')->get();
foreach($posts as $post) {
$post->isFavoritedBy($user);
}
```
### Events
| **Event** | **Description** |
| --------------------------------------------- | ------------------------------------------- |
| `Overtrue\LaravelFavorite\Events\Favorited` | Triggered when the relationship is created. |
| `Overtrue\LaravelFavorite\Events\Unfavorited` | Triggered when the relationship is deleted. |
## Related packages
- Follow: [overtrue/laravel-follow](https://github.com/overtrue/laravel-follow)
- Like: [overtrue/laravel-like](https://github.com/overtrue/laravel-like)
- Favorite: [overtrue/laravel-favorite](https://github.com/overtrue/laravel-favorite)
- Subscribe: [overtrue/laravel-subscribe](https://github.com/overtrue/laravel-subscribe)
- Vote: [overtrue/laravel-vote](https://github.com/overtrue/laravel-vote)
- Bookmark: overtrue/laravel-bookmark (working in progress)
## Contributing
You can contribute in one of three ways:
1. File bug reports using the [issue tracker](https://github.com/overtrue/laravel-favorites/issues).
2. Answer questions or fix bugs on the [issue tracker](https://github.com/overtrue/laravel-favorites/issues).
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._
## :heart: Sponsor me
[](https://github.com/sponsors/overtrue)
å¦‚æžœä½ å–œæ¬¢æˆ‘çš„é¡¹ç›®å¹¶æƒ³æ”¯æŒå®ƒï¼Œ[点击这里 :heart:](https://github.com/sponsors/overtrue)
## Project supported by JetBrains
Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.
[](https://www.jetbrains.com/?from=https://github.com/overtrue)
## PHP 扩展包开å‘
> 想知é“如何从零开始构建 PHP 扩展包？
>
> 请关注我的实战课程，我会在æ¤è¯¾ç¨‹ä¸åˆ†äº«ä¸€äº›æ‰©å±•å¼€å‘ç»éªŒ —— [《PHP 扩展包实战教程 - 从入门到å‘布》](https://learnku.com/courses/creating-package)
## License
MIT