Laravel HashId
Automatic HashId generator for your eloquent model.
Version Compatibilities
| Laravel HashId | PHP Version | Laravel 5.* | Laravel 6.* | Laravel 7.* | Laravel 8.* | Laravel 9.* |
|---|---|---|---|---|---|---|
1.x |
>=7.0 |
|||||
2.x |
>=7.2 - <= 8.0 |
|||||
3.x |
>=7.4 || >= 8.0 |
Install
composer require veelasky/laravel-hashidWith laravel package auto discovery, this will automatically add this package to your laravel application.
TLDR
Simply add HashableId trait on any of your eloquent model you are intending to use with HashId.
Example:
use Illuminate\Database\Eloquent\Model;
use Veelasky\LaravelHashId\Eloquent\HashableId;
class User extends Model {
use HashableId;
...
}Usage
With Eloquent Model
$user = User::find(1); // instance of user.
$user->hash; // generate HashId.
// Database operation
// get user by hashed id.
$user = User::byHash($hash);
// get user by hashed id, and throw ModelNotFoundException if not present.
$user = User::byHashOrFail($hash);
// get hashed id from the primary key.
User::idToHash($id);
// get ID from hashed string.
User::hashToId($hash);
// query scope with `byHash` method.
User::query()->byHash($hash);By default, all hash calculation will be calculated at runtime, but sometime you want to persist the hashed id to the database.
NOTE: when using persisting model, all database query will be check againts the table itself, except:
$model->hashwill always be calculated at runtime.
class User extends Model {
use HashableId;
// add this property to your model if you want to persist to the database.
protected $shouldHashPersist = true;
// by default, the persisted value will be stored in `hashid` column
// override column name to your desired name.
protected $hashColumnName = 'hashid';
...
}Route binding
When HashableId trait is used, base getRouteKey() and resolveRouteBinding() are overwritten to use the HashId as route key.
use App\Models\User;
class UserController extends Controller
{
/**
* Route /users/{user}
* Ex: GET /users/k1jTdv6l
*/
public function show(User $user)
{
...
}
}In-Depth Coverage
This package use repository pattern to store all instantiated implementation of HashId\HashId class, this to achieve different hash result on every eloquent models defined with HashableId trait.
// using facade.
HashId::hashToId($hash, User::class) // same as User::hashToId($hash);
HashId::idToHash($id, User::class) // same as User::idToHash($hash);
// HashId facade class is an implementation of \Veelasky\Laravel\HashId\RepositoryHowever you can opt-out to not using any eloquent model or implementing your own logic to the repository.
HashId::make($key, $salt); // will return \HashId\HashId class.
// once you instantiated the object, you can retrieve it on your next operation
HashId::get($key);If you're using single table inheritance model, where you want to has the same calculated hash across all inherited models, use $hashKey property, this will result the calculation remain the same across all inherited model.
class User extends Model {
protected $hashKey = 'somethingUnique';
}
class Customer extends User {
}
$customer = Customer::find(1);
$user = User::find(1);
$user->hash; // will be equal to $customer->hashYou can also specify the length and characters of the hashed Id with HASHID_LENGTH and HASHID_ALPHABET environment variable respectively, or you can publish the configuration file using this command:
php artisan vendor:publish --tag=laravel-hashid-configExtra: Validation Rules
You can also use this as validation rules, simply add this rule to your validator.
use App\Models\User;
use Veelasky\LaravelHashId\Rules\ExistsByHash;
...
Validator::make([
'id' => $hashedId
], [
'id' => ['required', new ExistsByHash(User::class)],
]);
...License
MIT License