Laravel read only fields lets you guard fields against unexpected updates.
An example use case for this might be when a projector in an event sourced system updates a read model. You want to make sure that the read model only gets updated by the projector.
To guard fields use the HasReadOnlyFields
trait in your model, and specify the read only fields by creating an array on your model named $readOnlyFields
use Illuminate\Database\Eloquent\Model;
use Temperworks\ReadOnlyFields\HasReadOnlyFields;
class YourModel extends Model
{
use HasReadOnlyFields;
protected array $readOnlyFields = [
'read_only_field'
];
}
When you want to update a read only field, you can mark that you intend to update the field by using writable(['read_only_field'])
.
After the model is saved, the writable state is reset.
$model = YourModel::find(1);
$model->writable(['read_only_field'])->update(['read_only_field' => 'foo']);
// this will throw an exception since we already updated the model.
$model->update(['read_only_field' => 'foobar']);
The MIT License (MIT). Please see License File for more information.