delight-im / ids
Short, obfuscated and efficient IDs for PHP
Installs: 7 200
Dependents: 1
Suggesters: 0
Security: 0
Stars: 27
Watchers: 4
Forks: 2
Open Issues: 0
Requires
- php: >=5.6.0
- ext-gmp: *
- jenssegers/optimus: ^0.2.1
Requires (Dev)
- phpseclib/phpseclib: ^2.0
This package is auto-updated.
Last update: 2024-10-24 06:59:56 UTC
README
Short, obfuscated and efficient IDs for PHP
No database changes are required. The original (integer) IDs are all you need.
No collisions. Reversible.
Why do I need this?
- Don't leak information to your competitors (e.g. number of orders, sign-ups per day)
- Prevent resource enumeration by waiving sequential IDs
- Mix up IDs a little bit in order to make guessing them harder
Security through obscurity
Requirements
- PHP 5.6.0+
- GMP extension
Installation
-
Include the library via Composer [?]:
$ composer require delight-im/ids
-
Include the Composer autoloader:
require __DIR__ . '/vendor/autoload.php';
Usage
Creating an instance
$generator = new \Delight\Ids\Id();
Encoding and decoding IDs
$generator->encode(6); // => "43Vht7" $generator->decode('43Vht7'); // => 6
Shortening a number without obfuscating it
$generator->shorten(3141592); // => "vJST" $generator->unshorten("vJST"); // => 3141592
Obfuscating a number without shortening it
$generator->obfuscate(42); // => 958870139 $generator->deobfuscate(958870139); // => 42
Customization
- Shuffle the characters of the alphabet that is used for the base conversion. Calling
\Delight\Ids\Id::createRandomAlphabet()
may be helpful for that purpose. You might also change the alphabet entirely, but there's usually no need to do that. - Pass your new alphabet to the constructor as the first argument.
- Clone this repository and then execute the file
tests/index.php
to generate your custom prime number, inverse prime and random number for Knuth's multiplicative hashing. - Pass your three new numbers to the constructor as the second, third and fourth argument, respectively.
Contributing
All contributions are welcome! If you wish to contribute, please create an issue first so that your feature, problem or question can be discussed.
License
This project is licensed under the terms of the MIT License.