Download the PHP package mtvs/eloquent-hashids without Composer
On this page you can find all versions of the php package mtvs/eloquent-hashids. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mtvs/eloquent-hashids
More information about mtvs/eloquent-hashids
Files in mtvs/eloquent-hashids
Package eloquent-hashids
Short Description On-the-fly hashids for Laravel Eloquent models.
License MIT
Informations about the package eloquent-hashids
Using hashids instead of integer ids in urls and list items can be more appealing and clever. For more information visit hashids.org.
Eloquent-Hashids
This adds hashids to Laravel Eloquent models by encoding/decoding them on the fly rather than persisting them in the database. So no need for another database column and also higher performance by using primary keys in queries.
Features include:
- Generating hashids for models
- Resloving hashids to models
- Ability to customize hashid settings for each model
- Route binding with hashids (optional)
Installation
Install the package with Composer:
Also, publish the vendor config files to your application (necessary for the dependencies):
Setup
Base features are provided by using HasHashid
trait then route binding with
hashids can be added by using HashidRouting
.
Custom Hashid Settings
It's possible to customize hashids settings for each model by overwriting
getHashidsConnection()
. It must return the name of a connection of
vinkla/hashids
that provides
the desired settings.
Usage
Basics
Add the hashid to the serialized model
Set it as default:
or specify it specificly:
return $item->append('hashid')->toJson();
Implicit Route Bindings
If you want to resolve implicit route bindings for the model using its hahsid
value you can use HashidRouting
in the model.
It overwrites getRouteKeyName()
, getRouteKey()
and resolveRouteBindingQuery()
to use the hashids as the route keys.
It supports the Laravel's feature for customizing the key for specific routes.
Customizing The Default Route Key Name
If you want to by default resolve the implicit route bindings using another
field you can overwrite getRouteKeyName()
to return the field's name to the
resolving process and getRouteKey()
to return its value in your links.
You'll still be able to specify the hashid for specific routes.
Supporting The Other Laravel's Implicit Route Binding Features
When using HashidRouting
you'll still be able to use softdeletable and child
route bindings.
All versions of eloquent-hashids with dependencies
vinkla/hashids Version ^9.0|^10.0|^11.0|^12.0