With this library, you can transform your internal id's to obfuscated integers based on Knuth's integer hash. It is similar to Hashids, but will generate integers instead of random strings. It is also super fast.
Install using composer:
composer require jenssegers/optimusIf you will be running your code on a 32 bit system or will be working with large prime numbers it is suggested that you install the GMP extension. For debian/ubuntu you can install the extension with one of these commands:
apt-get install php7.4-gmp
apt-get install php8.0-gmp
apt-get install php8.1-gmpTo get started you will need 3 things;
- Large prime number lower than
2147483647 - The inverse prime so that
(PRIME * INVERSE) & MAXID == 1 - A large random integer lower than
2147483647
Luckily for you, I have included a console command that can do all of this for you. To get started, just run the following command:
> php vendor/bin/optimus spark
Prime: 2123809381
Inverse: 1885413229
Random: 146808189If you prefer to choose your own prime number (from this list for example), you can pass it to the command to calculate the remaining numbers:
> php vendor/bin/optimus spark 1580030173
Prime: 1580030173
Inverse: 59260789
Random: 1163945558Using those numbers, you can start creating instances of Optimus($prime, $inverted, $random):
use Jenssegers\Optimus\Optimus;
new Optimus(1580030173, 59260789, 1163945558);NOTE: Make sure that you are using the same constructor values throughout your entire application!
To encode id's, use the encode method:
$encoded = $optimus->encode(20); // 1535832388To decode the resulting 1535832388 back to its original value, use the decode method:
$original = $optimus->decode(1535832388); // 20This is an example service provider which registers a shared Optimus instance for your entire application:
<?php
namespace App\Providers;
use Jenssegers\Optimus\Optimus;
use Illuminate\Support\ServiceProvider;
class OptimusServiceProvider extends ServiceProvider
{
public function register()
{
$this->app->singleton(Optimus::class, function ($app) {
return new Optimus(1580030173, 59260789, 1163945558);
});
}
}Once you have created the service provider, add it to the providers array in your config/app.php configuration file:
App\Providers\OptimusServiceProvider::class,
Laravel's automatic injection will pass this instance where needed. Example controller:
<?php
namespace App\Http\Controllers;
use Jenssegers\Optimus\Optimus;
use App\Http\Controllers\Controller;
class UserController extends Controller
{
public function show($id, Optimus $optimus)
{
$id = $optimus->decode($id);
}
}More information: https://laravel.com/docs/5.3/container#resolving
Third-party integrations
- An integration with Laravel is provided by the propaganistas/laravel-fakeid package.
- Laravel Optimus with multiple connections provided by the cybercog/laravel-optimus package.
- An integration with Silex 2 is provided by the jaam/silex-optimus-provider package.
- An integration with Laravel is provided by the elfsundae/laravel-hashid package.
- A PSR-15 middleware provided by the icanhazstring/optimus-middleware package.
To report a security vulnerability, follow these steps.
The MIT License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent