This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

A simple Laravel package based on davidmpeace/immutability that allows you to enforce immutable attributes on Eloquent models.

0.3 2018-10-26 13:36 UTC

This package is auto-updated.

Last update: 2021-06-20 01:24:21 UTC


repat/immutability is a simple package based on davidmpeace/immutability that is used in your Eloquent models to enforce attribute immutability. Immutable attributes may be only set if they are != null, but once the model is saved, the value can not be changed.


Immutability is open-sourced software licensed under the MIT license


To get started with Immutability, add to your composer.json file as a dependency:

$ composer require davidmpeace/immutability

Basic Usage

To use the Immutability library, you simply need to use the Immutability trait for any model you wish to identify immutable attributes for. Typically, you would want to implement the trait in your super-class so that all your sub-classes will automatically inherit the functionality.

namespace App;

use Illuminate\Database\Eloquent\Model;
use Eloquent\Attributes\Immutability;

class MyAppSuperModel extends Model
    use Immutability;

    protected $immutable = ['id', 'uuid'];

Class override.

namespace App;

class User extends MyAppSuperModel
    protected $immutable = ['id', 'uuid', 'username'];

Catching exceptions

namespace App;

use Eloquent\Attributes\Exceptions\ImmutableFieldViolationException;
use Exception;

$user = User::find(1);

try {
    $user->username = "myNewUserName";
} catch ( ImmutableFieldViolationException $e ) {
   // Handle immutable attribute violation error
} catch ( Exception $e ) {
   // Handle error