Download the PHP package yieldstudio/eloquent-public-id without Composer
On this page you can find all versions of the php package yieldstudio/eloquent-public-id. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yieldstudio/eloquent-public-id
More information about yieldstudio/eloquent-public-id
Files in yieldstudio/eloquent-public-id
Package eloquent-public-id
Short Description Eloquent Public ID Trait for Laravel 9 and above.
License MIT
Homepage https://github.com/YieldStudio/eloquent-public-id
Informations about the package eloquent-public-id
Eloquent Public Id
What It Does
The interest of public IDs is to keep a whole and incremental ID, while having a UUID to expose to the front end, which can be convenient for security reasons.
This package offers two features:
- Allow models to manage a public ID
- Allow FormRequest to easily convert public IDs to IDs
Installation
You can install the package via composer:
HasPublicId Trait
This Trait will enable your Model to have benefit of all the actions needed to process the public id.
Once package installed, Add a public id field into your table
Next step, use the HasPublicId trait into your Model
It's ready to work :)
⚠️ By default the trait will mark the ID field as a hidden field and guard the public ID.
The Trait adds some methods to your Model, here they are:
Name | Description |
---|---|
wherePublicId(string $publicId) | A new scope to find with a public ID |
findByPublicId(string $publicId, array $columns = ['*']) | A new static method to get a model by their public ID |
getPublicIdName() | Returns the public ID column name |
getPublicId() | Returns the public ID of the model |
Change the name of the public ID column
If in your migration you have chosen another field name instead of public_id, you have to specify this field using the getPublicIdName
function.
Change the generation of the public ID
The public id is automatically generated once your Model is created in the database.
If you want to modify the value of the generation of this field, you must add the generatePublicId
function to your Model
ConvertPublicId Trait
Allowing to convert public IDs to IDs in a FormRequest (before validation).
Unit tests
To run the tests, just run composer install
and composer test
.
Contact us
Our team at Yield Studio is ready to welcome you and make every interaction an exceptional experience. You can contact us.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of eloquent-public-id with dependencies
illuminate/support Version ^9|^10.0|^11.0
illuminate/database Version ^9|^10.0|^11.0