Enum cast for Eloquent

1.4.0 2022-02-17 08:48 UTC

This package is auto-updated.

Last update: 2022-06-17 09:26:48 UTC


Latest Version on Packagist Total Downloads GitHub Actions

Simple Enum cast for Eloquent ORM using myclabs/php-enum.


Since the release of PHP 8.1 this package is no longer maintained!

With PHP 8.1 you should use native enums and as of Laravel v8.71.0 Eloquent has official support to cast from and to native backed enums.


  • PHP ^7.3 or PHP ^8.0
  • Laravel 8.0 or higher


You can install the package via composer:

composer require orkhanahmadov/eloquent-enum-cast


Let's say you have following Enum class using myclabs/php-enum.

namespace App\Enums;

use MyCLabs\Enum\Enum;

class Role extends Enum
    private const ADMIN = 1;
    private const USER = 2;

To make it Eloquent castable, instead of MyCLabs\Enum\Enum, extend from Orkhanahmadov\EloquentEnumCast\EnumCast

namespace App\Enums;

use Orkhanahmadov\EloquentEnumCast\EnumCast;

class Role extends EnumCast
    private const ADMIN = 1;
    private const USER = 2;

Note: Orkhanahmadov\EloquentEnumCast\EnumCast extends MyCLabs\Enum\Enum, you can still use any other methods and properties that it has.

Finally, in your Eloquent model cast attribute using your Enum class

use App\Enums\Role;
use Illuminate\Database\Eloquent\Model;

class User extends Model
    protected $casts = [
        'role' => Role::class,

Now Eloquent will cast raw database values to your App\Enums\Role enum whenever you retrieve User model from database.

Likewise, whenever you save User model with App\Enums\Role enum as role attribute Eloquent will automatically save enum's underlying value into database.


composer test


Please see CHANGELOG for more information what has changed recently.


Please see CONTRIBUTING for details.


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



The MIT License (MIT). Please see License File for more information.