custom-d/hashed-search

A hashed search package for adding a searchable hash to your encrypted database columns
2,647 3
Install
composer require custom-d/hashed-search
Latest Version:v1.4.0
PHP:^8.1
License:MIT
Last Updated:Jun 10, 2025
Links: GitHub  ·  Packagist
Maintainer: customd

Laravel Hashed Search

PHP Composer Packagist Packagist Release

Package description: Package to allow hashing of encrypted data for searching

Installation

Install via composer

composer require custom-d/hashed-search

Publish package assets

php artisan vendor:publish --provider="CustomD\HashedSearch\ServiceProvider"

Usage

Eloqent Models

In your model add the use CustomD\HashedSearch\Contracts\HasSearchableHash; trait and add a new property protected $searchableHash = ['bank_name'];

Eg:

<?php

namespace App\Models;

...
use CustomD\EloquentModelEncrypt\ModelEncryption;
use CustomD\HashedSearch\Contracts\HasSearchableHash;

class EncryptedModel extends Model
{
    use ModelEncryption;
    use HasSearchableHash;


    protected $searchableHash = ['encryp_column_1','encypted_column_2'];
...
}

Now on each save event, it will update the search hash for those columns.

To search:

EncryptdModel::searchHashedField('encryp_column_1','clear text here');

Manual usage

You can manually has items by running the follwing code:

\CustomD\HashedSearch\Facades\HashedSearch::create('string to hash');

Methods

the \CustomD\HashedSearch\Facades\HashedSearch Class has the following methods

  • create(string $value, string $saltModifier = "" ): ?string
  • setSalt(string salt): SELF
  • setTransliterator(string rule): SELF
  • setHashes(?string $cypherA = null, ?string $cypherB = null): SELF

Security

An important consideration in searchable encryption is leakage, which is information an attacker can gain. Blind indexing leaks that rows have the same value. If you use this for a field like last name, an attacker can use frequency analysis to predict the values. In an active attack where an attacker can control the input values, they can learn which other values in the database match.

Here’s a great article on leakage in searchable encryption. Blind indexing has the same leakage as deterministic encryption.

Credits

Related Packages

teamtnt/laravel-scout-tntsearch-driver

Driver for Laravel Scout search package based on https://github.com/teamtnt/tnts...

2,736,735 1,135
mmanos/laravel-search

A search package for Laravel 5.

75,739 351
pmatseykanets/laravel-scout-postgres

PostgreSQL Full Text Search Driver for Laravel Scout

221,532 164
torann/laravel-hunt

Unified search for Laravel models using Elasticsearch.

375 4
laravel/scout

Laravel Scout provides a driver based solution to searching your Eloquent models...

60,694,421 1,676