Skip to content

Easily make certain fields for a model encryptable

License

Notifications You must be signed in to change notification settings

hihaho/laravel-encryptable-trait

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Encryptable Trait

Build Status Latest Stable Version Total Downloads Latest Unstable Version License Dependency Status

This trait encrypts all your fields (defined in $this->encryptable) before saving it to the database. It makes it extremely easy to treat certain fields as encryptable by automatically encrypting and decrypting the values.

Photoware

This package is free to use, but inspired by Spaties' Poscardware we'd love to see where where this package is being developed. A photo of an important landmark in your area would be highly appreciated.

Our email address is [email protected]

Install

Simply add the following line to your composer.json and run composer update

"hihaho/laravel-encryptable-trait": "^v4.0"

Or use composer to add it with the following command

composer require hihaho/laravel-encryptable-trait

Requirements

  • illuminate/encryption ^10.0 or ^11.0
  • PHP 8.1, 8.2 or 8.3

Usage

Simply add the trait to your models and set the $encryptable to an array of values that need to be encrypted.

<?php

namespace app\Models;

use Illuminate\Database\Eloquent\Model as Eloquent;
use HiHaHo\EncryptableTrait\Encryptable;

class Phone extends Eloquent
{
    use Encryptable;

    protected $encryptable = [
        'imei',
    ];
}

DecryptException

This package will throw a DecryptException (the default Laravel one: Illuminate\Contracts\Encryption\DecryptException). You can however set $dontThrowDecryptException to true to ignore the exception. If the value can't be decrypted it will just return null.

<?php

namespace app\Models;

use Illuminate\Database\Eloquent\Model as Eloquent;
use HiHaHo\EncryptableTrait\Encryptable;

class Phone extends Eloquent
{
    use Encryptable;

    protected $encryptable = [
        'imei',
    ];
    
    protected $dontThrowDecryptException = true;
}

If the database contains an invalid value, this will return null.

$phone = Phone::find(1);
$phone->imei; //Will return null

Contributors