richan-fongdasen / eloquent-blameable
Blameable behavior implementation for your Eloquent Model in Laravel
Installs: 152 614
Dependents: 3
Suggesters: 0
Security: 0
Stars: 30
Watchers: 3
Forks: 5
Open Issues: 0
Requires
- php: ^8.0
- illuminate/database: ^8.0|^9.0|^10.0|^11.0
- illuminate/support: ^8.0|^9.0|^10.0|^11.0
Requires (Dev)
- ekino/phpstan-banned-code: ^1.0
- larastan/larastan: ^1.0|^2.0
- mockery/mockery: ^1.4
- orchestra/testbench: ^6.0|^7.0|^8.0|^9.0
- phpmd/phpmd: ^2.11
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-strict-rules: ^1.0
- phpunit/phpunit: ^9.5|^10.0|^11.0
README
Eloquent Blameable
Blameable behavior implementation for your Eloquent Model in Laravel
Synopsis
This package would help you to track the creator and updater of each database record. It would be done by filling the specified attributes with the current user ID automatically. By default, those attributes would be filled when you are saving the Eloquent Model object.
Table of contents
Setup
Install the package via Composer :
$ composer require richan-fongdasen/eloquent-blameable
Laravel version compatibility
If you are using Laravel version 5.5+ then you can skip registering the service provider in your Laravel application.
Service Provider
Add the package service provider in your config/app.php
'providers' => [ // ... RichanFongdasen\EloquentBlameable\ServiceProvider::class, ];
Configuration
Publish configuration file using php artisan
command
$ php artisan vendor:publish --provider="RichanFongdasen\EloquentBlameable\ServiceProvider"
The command above would copy a new configuration file to /config/blameable.php
return [ /* |-------------------------------------------------------------------------- | Authentication Guard |-------------------------------------------------------------------------- | | Please specify your default authentication guard to be used by blameable | service. You can leave this to null if you're using the default Laravel | authentication guard. | | You can also override this value in model classes to use a different | authentication guard for your specific models. | IE: Some of your models can only be created / updated by specific users | who logged in from a specific authentication guard. | */ 'guard' => null, /* |-------------------------------------------------------------------------- | User Model Definition |-------------------------------------------------------------------------- | | Please specify a user model that should be used to setup `creator` | and `updater` relationship. | */ 'user' => \App\User::class, /* |-------------------------------------------------------------------------- | The `createdBy` attribute |-------------------------------------------------------------------------- | | Please define an attribute to use when recording the creator | identifier. | */ 'createdBy' => 'created_by', /* |-------------------------------------------------------------------------- | The `updatedBy` attribute |-------------------------------------------------------------------------- | | Please define an attribute to use when recording the updater | identifier. | */ 'updatedBy' => 'updated_by', /* |-------------------------------------------------------------------------- | The `deletedBy` attribute |-------------------------------------------------------------------------- | | Please define an attribute to use when recording the user | identifier who deleted the record. This feature would only work | if you are using SoftDeletes in your model. | */ 'deletedBy' => 'deleted_by', ];
Usage
Add some blameable attributes to your migrations
Schema::create('some_tables', function (Blueprint $table) { // ... $table->integer('created_by')->nullable(); $table->integer('updated_by')->nullable(); $table->integer('deleted_by')->nullable(); // ... /** * You can also create foreign key constrains * for the blameable attributes. */ $table->foreign('created_by') ->references('id')->on('users') ->onDelete('cascade'); $table->foreign('updated_by') ->references('id')->on('users') ->onDelete('cascade'); });
Attach Blameable behavior into your Model
use Illuminate\Database\Eloquent\Model; use RichanFongdasen\EloquentBlameable\BlameableTrait; class Post extends Model { use BlameableTrait; // ... }
Override default configuration using static property
/** * You can override the default configuration * by defining this static property in your Model */ protected static $blameable = [ 'guard' => 'customGuard', 'user' => \App\User::class, 'createdBy' => 'user_id', 'updatedBy' => null ];
Override default configuration using public method
/** * You can override the default configuration * by defining this method in your Model */ public function blameable() { return [ 'guard' => 'customGuard', 'user' => \App\User::class, 'createdBy' => 'user_id', 'updatedBy' => null ]; }
Using Blameable Query Scopes
// Get all posts which have created by the given user id Post::createdBy($userId)->get(); // Get all posts which have updated by the given user object $user = User::findOrFail(1); Post::updatedBy($user)->get();
Accessing Creator / Updater Object
// Get the creator user object Post::findOrFail($postId)->creator; // Get the updater user object Post::findOrFail($postId)->updater;
License
The MIT License (MIT). Please see License File for more information.