Download the PHP package wildside/userstamps without Composer
On this page you can find all versions of the php package wildside/userstamps. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wildside/userstamps
More information about wildside/userstamps
Files in wildside/userstamps
Package userstamps
Short Description Laravel Userstamps provides an Eloquent trait which automatically maintains `created_by` and `updated_by` columns on your model, populated by the currently authenticated user in your application.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package userstamps
About Laravel Userstamps
Laravel Userstamps provides an Eloquent trait which automatically maintains created_by and updated_by columns on your model, populated by the currently authenticated user in your application.
When using the Laravel SoftDeletes trait, a deleted_by column is also handled by this package.
Installing
This package requires Laravel 5.2 or later running on PHP 5.6 or higher.
This package can be installed using composer:
`
Usage
Your model will need to include a created_by and updated_by column, defaulting to null.
If using the Laravel SoftDeletes trait, it will also need a deleted_by column.
The column type should match the type of the ID column in your user's table. In Laravel <= 5.7 this defaults to unsignedInteger. For Laravel >= 5.8 this defaults to unsignedBigInteger.
An example migration:
You can now load the trait within your model, and userstamps will automatically be maintained:
Optionally, should you wish to override the names of the created_by, updated_by or deleted_by columns, you can do so by setting the appropriate class constants on your model. Ensure you match these column names in your migration.
When using this trait, helper relationships are available to let you retrieve the user who created, updated and deleted (when using the Laravel SoftDeletes trait) your model.
Methods are also available to temporarily stop the automatic maintaining of userstamps on your models:
Workarounds
This package works by hooking into Eloquent's model event listeners, and is subject to the same limitations of all such listeners.
When you make changes to models that bypass Eloquent, the event listeners won't be fired and userstamps will not be updated.
Commonly this will happen if bulk updating or deleting models, or their relations.
In this example, model relations are updated via Eloquent and userstamps will be maintained:
However in this example, model relations are bulk updated and bypass Eloquent. Userstamps will not be maintained:
As a workaroud to this issue two helper methods are available - updateWithUserstamps and deleteWithUserstamps. Their behaviour is identical to update and delete, but they ensure the updated_by and deleted_by properties are maintained on the model.
You generally won't have to use these methods, unless making bulk updates that bypass Eloquent events.
In this example, models are bulk updated and userstamps will not be maintained:
However in this example, models are bulk updated using the helper method and userstamps will be maintained:
Sponsors
This open-source software is developed and maintained by WILDSIDE.
License
This open-source software is licensed under the MIT license.
