coderscantina/hashidable

An adapted bridge for using hashids in Laravel models.

v1.1.1 2025-03-10 20:52 UTC

Requires

• php: ~7.3||^8.0
• illuminate/support: ^8.0||^9.0||^10.0||^11.0||^12.0
• vinkla/hashids: ~9.1||~10.0||^11.0||^12.0||^13.0

Requires (Dev)

• graham-campbell/testbench: ^6.2
• illuminate/database: ^8.0||^9.0||^10.0||^11.0||^12.0
• mockery/mockery: ^1.3
• phpunit/phpunit: ^11.0

MIT

• Michael Wallner

• laravel
• hashids
• Laravel-hashids

README

An adapted bridge for using laravel-hashids in Laravel models.

Features

• Hashid route model binding
• Individual salt per model
• Optional individual configuration per model
• Helper methods for encoding, decoding and finding by hashid
• Collection support for working with multiple hashids
• Performance optimizations with factory caching

🏗 Install

Install the package via composer using this command:

composer require coderscantina/hashidable

⚙️ Usage

Add the Hashidable trait to your model

use CodersCantina\Hashidable;

class Foo extends Model
{
    use Hashidable;
}

Route Model Binding

Expose the hashid in a resource

class FooResource extends JsonResource
{
    /**
     * @param  \Illuminate\Http\Request  $request
     * @return array
     */
    public function toArray($request)
    {
        return [
            'id' => $this->getRouteKey(),
        ];
    }
}

Resolve the model via hashid in a controller

/**
* @param  \App\Models\Foo  $foo
* @return \Illuminate\Http\Response
*/
public function show(Foo $foo)
{
    return new FooResource($foo);
}

Working with Single Models/IDs

Static methods to work with hashIds:

Foo::encodeHashId(1);             // Convert ID to hashid
Foo::decodeHashId('A3');          // Convert hashid to ID
Foo::findByHashId('A3');          // Find model by hashid
Foo::findByHashIdOrFail('A3');    // Find model by hashid or throw exception

Working with Collections/Arrays

Methods for working with multiple models or IDs:

// Encode multiple IDs
Foo::encodeHashIds([1, 2, 3]);    // Returns array of hashids

// Decode multiple hashids
Foo::decodeHashIds(['A3', 'B7']); // Returns array of IDs

// Find multiple models by hashids
Foo::findByHashIds(['A3', 'B7']); // Returns collection of models

Custom Configuration

Overwrite config with a model like App\User::class

# config/hashids.php

'connections' => [

    'main' => [
        'salt' => env('HASHIDS_SALT'),
        'length' => 8,
        'alphabet' => '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ',
    ],

    \App\User::class => [
        'salt' => env('HASHIDS_SALT'),
        'length' => 5,
        'alphabet' => '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ',
    ],

],

See for more information Route Model Binding