PHPackages                             movor/laravel-custom-casts - 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. [Database & ORM](/categories/database)
4. /
5. movor/laravel-custom-casts

ActiveLibrary[Database & ORM](/categories/database)

movor/laravel-custom-casts
==========================

Make your own custom cast type for Laravel model attributes

v0.2.1(7y ago)5172MITPHP

Since Aug 9Pushed 7y ago1 watchersCompare

[ Source](https://github.com/movor/laravel-custom-casts)[ Packagist](https://packagist.org/packages/movor/laravel-custom-casts)[ RSS](/packages/movor-laravel-custom-casts/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (3)Versions (5)Used By (0)

Laravel Custom Casts
====================

[](#laravel-custom-casts)

[![Build](https://camo.githubusercontent.com/9aed99c978e085665a1b67d10fd93a1c01d8e051af2d3ff66c5f5ed1f38c6266/68747470733a2f2f6170692e7472617669732d63692e6f72672f6d6f766f722f6c61726176656c2d637573746f6d2d63617374732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/movor/laravel-custom-casts)[![Downloads](https://camo.githubusercontent.com/513813cf891bf9bc02d20a0e9242a8b19523129deee52a6dbe7ebe176cb978cb/68747470733a2f2f706f7365722e707567782e6f72672f6d6f766f722f6c61726176656c2d637573746f6d2d63617374732f646f776e6c6f616473)](https://packagist.org/packages/movor/laravel-custom-casts)[![Stable](https://camo.githubusercontent.com/d8f94aaa90635bf1d1a637fdc51d98167b4babbd14e3f701a24a187e8c1eca91/68747470733a2f2f706f7365722e707567782e6f72672f6d6f766f722f6c61726176656c2d637573746f6d2d63617374732f762f737461626c65)](https://packagist.org/packages/movor/laravel-custom-casts)[![License](https://camo.githubusercontent.com/8503a3ffb41a0916758accda6eb2849e3ce117fcd195c83f6caccf602d57d2bb/68747470733a2f2f706f7365722e707567782e6f72672f6d6f766f722f6c61726176656c2d637573746f6d2d63617374732f6c6963656e7365)](https://packagist.org/packages/movor/laravel-custom-casts)

### Make your own custom cast type for Laravel model attributes

[](#make-your-own-custom-cast-type-for-laravel-model-attributes)

By default, from version 5 Laravel supports attribute casting. If we define `$cast` property on our model, Laravel will help us convert defined attributes to common data types. Currently supported cast types (Laravel 5.6) are: `integer`, `real`, `float`, `double`, `string`, `boolean`, `object`, `array`, `collection`, `date`, `datetime` and `timestamp`.

If those default cast types are not enough and you want to make your own, you'r on the right track.

---

❗❗❗ **MOVING GIT REPOSITORY**❗❗❗

This package **repo and maintenance will continue on**:

[**vkovic/laravel-custom-casts**](https://github.com/vkovic/laravel-custom-casts).

🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚 🚚

---

Compatibility
-------------

[](#compatibility)

The package is compatible with Laravel versions `>= 5.1`

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

[](#installation)

Install the package via composer:

```
composer require movor/laravel-custom-casts
```

Example: Casting User Image
---------------------------

[](#example-casting-user-image)

When saving an image, there is two things that needs to be done:

1. Save image name (sometimes with path) into corresponding database field
2. Save image physically on the disk

As a guidance for this example we'll use default Laravel user model found in `app/User.php`.

Beside basic, predefined fields: `name`, `email` and `password`, we also want to allow user to upload his avatar. Assume that we already have `users` table with `image` field (you should create seeder for this).

To utilize custom casts, we'll need to add trait to user model, and via `$casts` property link it to the cast class.

```
// File: app/User.php

namespace App;

use App\CustomCasts\ImageCast;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Movor\LaravelCustomCasts\HasCustomCasts;

class User extends Authenticatable
{
    use Notifiable, HasCustomCasts;

    protected $fillable = [
        'name', 'email', 'password', 'image'
    ];

    protected $hidden = [
        'password', 'remember_token'
    ];

    protected $casts = [
        'image' => ImageCast::class
    ];
}

// ...
```

Next step is to create class that'll handle casting. It must implement `setAttribute` method which will take care of saving the image (from UploadedFile object, via form upload in this case) and generating image name with path - to be preserved in database.

```
// File: app/CustomCasts/ImageCast.php

namespace App\CustomCasts;

use Movor\LaravelCustomCasts\CustomCastBase;
use Illuminate\Http\UploadedFile;

class ImageCast extends CustomCastBase
{
    public function setAttribute($file)
    {
        // Define storage folder
        // (relative to "storage/app" folder in Laravel project)
        // Don't forget to create it !!!
        $storageDir = 'images';

        // Generate random image name
        $filename = str_random() . '.' . $file->extension();

        // Save image to predefined folder
        $file->storeAs($storageDir, $filename);

        // This will be stored in db field: "image"
        return $storageDir . '/' . $filename;
    }
}
```

Let's jump to user creation example. This will trigger our custom cast logic.

Assume that we have user controller which will handle user creation. You should create this on your own.

> Code below is just a simple example and should be used as guidance only.

```
// File: app/Http/Controllers/UserController.php

// ...

protected function create(Request $request)
{
    User::create([
        'name' => $request->name,
        'email' => $request->email,
        'password' => bcrypt($request->password),
        // Past the whole Illuminate\Http\UploadedFile object,
        // we'll handle it in our ImageCast class
        'image' => $request->file('image')
    ]);
}

// ...
```

Visit corresponding route input basic details and attach the image. After that, we'll have our user created and image stored.

But we should also handle deleting image when user is deleted. This can be accomplished by utilizing underlying eloquent events handling. Each time eloquent event is fired, logic will look up for public method with the same name in our custom cast class.

Possible method names are: `retrieved`, `creating`, `created`, `updating`, `updated`, `saving`, `saved`, `deleting`, `deleted`, `restoring` and `restored`.

```
// File: app/CustomCasts/ImageCast.php

// Add at the top
use Storage;

// ...

// This method will be triggered after model has been deleted
public function deleted()
{
    // We can access underlying model with $this->model
    // and attribute name that is being casted with $this->attribute

    // Retrieve image path and delete it from the disk
    $imagePath = $this->model->image;
    Storage::delete($imagePath);
}

// ...
```

This should cover basics usage of custom casts.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~37 days

Total

4

Last Release

2769d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4613605?v=4)[Vladimir Ković](/maintainers/vkovic)[@vkovic](https://github.com/vkovic)

---

Top Contributors

[![vkovic](https://avatars.githubusercontent.com/u/4613605?v=4)](https://github.com/vkovic "vkovic (10 commits)")

---

Tags

accessorattributecastcastingcustomlaravelmutatorlaravelmodelcastdatatypecasts

### Embed Badge

![Health badge](/badges/movor-laravel-custom-casts/health.svg)

```
[![Health](https://phpackages.com/badges/movor-laravel-custom-casts/health.svg)](https://phpackages.com/packages/movor-laravel-custom-casts)
```

###  Alternatives

[vkovic/laravel-custom-casts

Make your own custom cast type for Laravel model attributes

218370.6k3](/packages/vkovic-laravel-custom-casts)[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11222.5M33](/packages/anourvalar-eloquent-serialize)[wendelladriel/laravel-lift

Take your Eloquent Models to the next level

70448.7k](/packages/wendelladriel-laravel-lift)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135212.4k7](/packages/statamic-rad-pack-runway)[esensi/model

The base model traits of Esensi

20067.0k1](/packages/esensi-model)[waad/laravel-model-metadata

A robust Laravel package for handling metadata with JSON casting, custom relation names, and advanced querying capabilities.

854.1k](/packages/waad-laravel-model-metadata)

PHPackages © 2026

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