Laravel Process Stamps
It is sometimes very useful to know which process created or modified a particular record in your database. This package provides a trait to add to your Laravel models which automatically logs that for you.
Installation
You can install the package via composer:
composer require orisintel/laravel-process-stamps
Configuration
php artisan vendor:publish --provider="\OrisIntel\ProcessStamps\ProcessStampsServiceProvider"
Running the above command will publish both the migration and the config file.
Usage
After adding the proper fields to your table, add the trait to your model.
// User model
class User extends Model
{
use ProcessStampable;
Next, create a migration for your table and include the following:
$table->processIds();
To specify your own foreign key or index names, include the following options:
$table->processIds([
'created_index_name' => 'custom_created_index_name',
'updated_index_name' => 'custom_updated_index_name',
'created_foreign_key_name' => 'custom_created_foreign_key_name',
'updated_foreign_key_name' => 'custom_updated_foreign_key_name',
]);
That will generate the nessesary field names to track processes.
Testing
composer test
Using Docker
All assets are set up under the docker-compose.yml file. The first time you run the docker image you must build it with the following command:
docker-compose build
Then you can bring it up in the background using:
docker-compose up -d
And the image is aliased so you can access its command line via:
docker exec -it processes-stamp-app /bin/bash
From there you can run the tests within an isolated environment
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
334 Jan 6, 2023
7 Aug 16, 2022
20.1k Jan 8, 2023
377 Dec 16, 2022
99 Jan 3, 2023
73 Nov 14, 2022
107 Dec 12, 2022
7 Aug 31, 2022
281 Nov 24, 2022
42 Dec 11, 2022
1 Jan 13, 2022
3 Jun 13, 2022
7 Nov 1, 2022
3 Aug 9, 2022
67 Dec 14, 2022
75 Dec 21, 2021
7.1k Dec 29, 2022
272 Dec 22, 2022