PHPackages                             unionworx/laravel-serializes-models-with-cache - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Caching](/categories/caching)
4. /
5. unionworx/laravel-serializes-models-with-cache

ActiveLibrary[Caching](/categories/caching)

unionworx/laravel-serializes-models-with-cache
==============================================

This package provides a drop-in replacement for Laravel's SerializesModels trait that leverages your application's cache when unserializing models.

0.1.1(1y ago)2384↓33.3%MITPHPPHP ^8.0CI failing

Since Jun 12Pushed 1y ago2 watchersCompare

[ Source](https://github.com/Union-Worx/laravel-serializes-models-with-cache)[ Packagist](https://packagist.org/packages/unionworx/laravel-serializes-models-with-cache)[ Docs](https://github.com/Union-Worx/laravel-serializes-models-with-cache)[ RSS](/packages/unionworx-laravel-serializes-models-with-cache/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (5)Versions (3)Used By (0)

Laravel Serializes Models With Cache
====================================

[](#laravel-serializes-models-with-cache)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e8a1650c9c01bc5f6066043c06c56ae33f738f019cf5c4cc9698e72a502b0ad0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f756e696f6e776f72782f6c61726176656c2d73657269616c697a65732d6d6f64656c732d776974682d63616368652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/unionworx/laravel-serializes-models-with-cache)[![Total Downloads](https://camo.githubusercontent.com/7cb3b3ea84c19403d08d9cdf70b3bc5f7d07243dda1ba748474a7dd85b00a425/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f756e696f6e776f72782f6c61726176656c2d73657269616c697a65732d6d6f64656c732d776974682d63616368652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/unionworx/laravel-serializes-models-with-cache)[![GitHub Actions](https://github.com/unionworx/laravel-serializes-models-with-cache/actions/workflows/main.yml/badge.svg)](https://github.com/unionworx/laravel-serializes-models-with-cache/actions/workflows/main.yml/badge.svg)

This package provides a drop-in replacement for Laravel's SerializesModels trait that leverages your application's cache when unserializing models.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require unionworx/laravel-serializes-models-with-cache
```

Usage
-----

[](#usage)

To use the `SerializesModelsWithCache` trait, simply replace Laravel's `SerializesModels` trait with `SerializesModelsWithCache` in your classes:

```
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use UnionWorx\LaravelSerializesModelsWithCache\SerializesModelsWithCache;
use App\Models\Message;

class SendMessage
{
    use Dispatchable, InteractsWithQueue, SerializesModelsWithCache;

    public Message $message;

    public function handle()
    {
        // Your job logic
    }
}
```

Under the hood this uses most of the default behavior of the `SerializesModels` trait, but will attempt to retrieve the model from the cache before querying the database. This uses the [remember](https://laravel.com/docs/11.x/cache#retrieve-store) feature of the Laravel cache to retrieve the model from the cache or uses the default `SerializesModels` behavior and stores the result.

### Attributes

[](#attributes)

You can further customize the caching behavior using attributes:

- **`CacheKey`**: Define a custom cache key for a specific property.
- **`CacheTTL`**: Set a custom Time-To-Live (TTL) for the cache entry of a property.
- **`CacheSkip`**: Skip caching for a specific property.

```
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheKey;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheTTL;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheSkip;
use App\Models\User;
use App\Models\Message;

class SendMessage
{
    use Dispatchable, InteractsWithQueue, SerializesModelsWithCache;

    #[CacheKey(key: 'custom_key_{id}')]
    #[CacheTTL(ttl: 120)]
    public Message $message;

    #[CacheSkip]
    public User $user;

    public function handle()
    {
        // Your job logic
    }
}
```

### Methods

[](#methods)

Alternatively, you can use the `cacheKey`, `cacheTTL`, and `cacheSkip` methods to customize the caching behavior:

```
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheKey;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheTTL;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheSkip;
use App\Models\User;
use App\Models\Message;

class SendMessage
{
    use Dispatchable, InteractsWithQueue, SerializesModelsWithCache;

    public Message $message;

    public User $user;

    public function handle()
    {
        // Your job logic
    }

    public function cacheKey(string $propertyName, mixed $id): ?string
    {
        if ($propertyName === 'message') {
            return 'custom_key_' . $id;
        }
    }

    public function cacheTTL(): array|DateInterval|DateTimeInterface|int|null
    {
        return [
            'message' => 120,
        ];
    }

    public function cacheSkip(): ?array
    {
        return [
            'user',
        ];
    }
}
```

### Cache Prefix

[](#cache-prefix)

By default, the cache key is generated using the following pattern `model_classname_id`. This means that models used across multiple contexts will share the same cache key. In most cases this would be beneficial however, you can further isolate the cache by adding a `cachePrefix` method to your class. This will apply the prefix to all keys, even if using custom cache keys.

```
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheKey;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheTTL;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheSkip;
use App\Models\Message;

class SendMessage
{
    use Dispatchable, InteractsWithQueue, SerializesModelsWithCache;

    #[CacheKey(key: 'custom_key_{id}')]
    public Message $message;

    public function handle()
    {
        // Your job logic
    }

    public function cachePrefix(): ?string
    {
        return get_class($this);
    }
}
```

### Cache Store

[](#cache-store)

By default, the cache store used is the default cache store defined in your Laravel configuration. You can override this by adding a `cacheStoreName` method to your class.

```
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheKey;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheTTL;
use UnionWorx\LaravelSerializesModelsWithCache\Attributes\CacheSkip;
use App\Models\Message;

class SendMessage
{
    use Dispatchable, InteractsWithQueue, SerializesModelsWithCache;

    #[CacheKey(key: 'custom_key_{id}')]
    public Message $message;

    public function handle()
    {
        // Your job logic
    }

    public function cacheStoreName(): ?string
    {
        return 'file';
    }
}
```

### Testing

[](#testing)

You can run the package tests via composer:

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on recent changes.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Christopher Carranza](https://github.com/ChristopherCarranza)

License
-------

[](#license)

MIT. Please see [License File](LICENSE.md) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance44

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~259 days

Total

2

Last Release

440d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4485800?v=4)[Christopher Carranza](/maintainers/ChristopherCarranza)[@ChristopherCarranza](https://github.com/ChristopherCarranza)

---

Tags

laravelcachemodelsunionworxserializeslaravel-serializes-models-with-cache

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/unionworx-laravel-serializes-models-with-cache/health.svg)

```
[![Health](https://phpackages.com/badges/unionworx-laravel-serializes-models-with-cache/health.svg)](https://phpackages.com/packages/unionworx-laravel-serializes-models-with-cache)
```

###  Alternatives

[spatie/laravel-responsecache

Speed up a Laravel application by caching the entire response

2.8k8.2M51](/packages/spatie-laravel-responsecache)[dragon-code/laravel-cache

An improved interface for working with cache

6844.8k10](/packages/dragon-code-laravel-cache)[nexxai/laravel-cfcache

A handful of Cloudflare cache helpers for Laravel

1317.7k](/packages/nexxai-laravel-cfcache)[yangusik/laravel-balanced-queue

Laravel queue management with load balancing between partitions (user groups)

786.4k](/packages/yangusik-laravel-balanced-queue)[omaralalwi/lexi-translate

Laravel translation package with morph relationships and caching.

754.3k2](/packages/omaralalwi-lexi-translate)[suitmedia/laravel-cacheable

Decorate your repositories and make them cacheable

1237.7k](/packages/suitmedia-laravel-cacheable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)