Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Laravel CipherSweet: Searchable Encrypted Attributes

Laravel CipherSweet is a Laravel implementation of Paragon Initiative Enterprises CipherSweet searchable field level encryption.


Make sure you have some basic understanding of CipherSweet before continuing.


Install the package using composer:

composer require bjornvoesten/laravel-ciphersweet

Publish configuration file:

php artisan vendor:publish --tag=ciphersweet-config

Generate an encryption key:

php artisan ciphersweet:key

Watch out! All encrypted columns depend on this key. If the key changes, the already encrypted columns can not be decrypted anymore!



You can change the encryption algorithm by defining the crypto:


For more information about the encryption index algorithms see the documentation.


Defining encryption

Add the Bjornvoesten\CipherSweet\Traits\HasEncryption trait to the model.

    use HasEncryption;

Define the attributes that should ben encrypted.

     * The attributes that can be encrypted.
     * @var array
    protected $encrypted = [

By default the index column name is generated using the name and suffixing it with _index.

So the social_security_number attribute will use the default index column social_security_number_index.

Alternatively you can define multiple indexes per attribute and and define more options.

     * Set the social security number attribute encryption.
     * @param \Bjornvoesten\CipherSweet\Contracts\Attribute $attribute
     * @return void
    public function socialSecurityNumberAttributeEncryption($attribute): void
            ->index('social_security_number_full_index', function (Index $index) {
            ->index('social_security_number_last_four_index', function (Index $index) {
                        new LastFourDigits()

For more information about the index options see the documentation.

And make sure you have created the index columns in the database table!

Searching models

You can search encrypted attributes by using the default where clause on the query builder or with the whereEncrypted method.

    ->where('social_security_number', '=', $number)

By using the whereEncrypted method you can also define the indexes which can be searched.

    ->whereEncrypted('social_security_number', '=', $number, [

Note When searching with the equal to operator models will be returned when the value is found in one of all available or defined indexes. When searching with the not equal to operator all models where the value is not found in any of the available or the defined indexes are returned.


Because of the limited search possibilities in CipherSweet only the = and != operators are available when searching encrypted attributes.


$ composer test

To be done.


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

You can’t perform that action at this time.