Download the PHP package deligoez/laravel-model-hashid without Composer

Using this package you can generate, save and, route Stripe-like Hash Ids for your Eloquent Models.

Hash Ids are short, unique, and non-sequential, and can generate unique Ids for URLs and hide database row numbers from the user. For more information about Hash Ids please visit hashids.org.

With this package, you can customize Hash Id generation and add a model prefix and also separator.

For a User model with an id of 1234, you can generate Hash Ids like user_kqYZeLgo.

So instead of;
https://your-endpoint.com/user/1234

You can have endpoints like;
https://your-endpoint.com/user/user_kqYZeLgo

You have complete control over your Hash Id length and style. Check out the configuration file for more options.

Table of contents

• Features
• Compatibility Table
• Installation
• Usage
  • Model Hash Id Generation
  • Routing and Route Model Binding (Optional)
  • Saving Hash Ids to the Database (Optional)
• Hash Id Terminology
• Configuration
• Roadmap
• Testing
• Used By
• Changelog
• Contributing
• Security Vulnerabilities
• Credits
• License

Features

• Customizable Hash Id Generation
  • Hash Id Salt
  • Length
  • HashID Alphabet
  • Model Prefix Length and Case
  • Separator
• Model Specific Hash Id Generation
  • User-defined prefix per Model (optional)
  • Define separate configurations per Model
• Route (Model) Binding using Hash Ids (optional)
• Automatically save Hash Ids to the database (optional)

Compatibility Table

The table below shows the compatibility across Laravel, PHP, and this package's current version.

Installation

1. Install via Composer:

2. Publish the config file:

Usage

Model Hash Id Generation

Add the HasHashId trait to any Laravel Model that should use Hash Ids.

Model Attributes and Static Model Functions

You will be able to use hashId and hashIdRaw attributes and keyFromHashId() static model function.

Query Builder Functions

You can use all finding related Laravel query builder functions with Hash Ids.

Routing and Route Model Binding (Optional)

Simply add the HasHashIdRouting trait to your model that you want to route using Hash Ids.

Route Model Binding (Implicit)

You can define a route and/or controller method like this by Laravel conventions.

Route Model Binding (Explicit)

You can also define a custom model key on your RouteServiceProvider.

Saving Hash Ids to the Database (Optional)

You can add the SavesHashId Trait to any of your Laravel Model that should save the generated Hash Ids.

After that, you should set database_column setting in the configuration file. You can define database_column setting per model separately or for all of your models.

All Hash Id generation or decoding methods work ON-THE-FLY. So you DO NOT need to save Hash Ids to the database for that reason.

Since generating a Hash Id requires an integer model id/key, remember that storing the Hash Ids to a database will result in an additional database query.

Hash Id Terminology

A typical Hash Id consist of 3 parts.

• Model Prefix (model_a)
• Separator (_)
• Raw Hash Id (kqYZeLgo)

Model Prefix and Separator are OPTIONAL. You can generate Hash Ids that only contains Raw Hash Ids.

Configuration

This is the contents of the published config file:

Roadmap

• [x] Custom Model Prefixes (Not generated from a Model name) (Thanks to @plunkettscott)
• [ ] Hash Id Validation Rules
• [ ] Generic Generators (Not bound to a Laravel Model)

Testing

Used By

This project is used by the following companies/products, you can add yours too:

• blindnote.com
• tarfin.com

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Yunus Emre Deligöz
• Scott Plunkett
• Wade
• Laravel Shift
• Faruk
• All Contributors

License

The MIT License (MIT). Please see License File for more information.