Do you need to generate random and unique values? This package is for you!
- Strings
- Numbers
- UUIDs
All the randomness you need!
# Require package (Composer)
The recommended way to install this package is to use Composer (opens new window):
$ composer require eonx-com/easy-random
# Usage
# Integers
// Will generate a random integer between 0 and 20 (both included)
$myNumber = (new \EonX\EasyRandom\RandomGenerator())->randomInteger(0, 20);
# Strings
The random generator allows you to control the length, and the composition of the generated random strings via a nice fluent interface:
$myString = (new \EonX\EasyRandom\RandomGenerator())
->randomString(16)
->excludeSimilar() // Will exclude similar characters
->excludeVowel() // Will exclude vowels, nice trick to avoid "bad words" in generated random strings
->includeNumeric(); // Include 0-9 numbers
Do you need to generate random strings for your end users?
// Will generate "user friendly" random string:
// - exclude ambiguous characters
// - exclude symbols
// - exclude vowels
// - include numeric
// - include uppercase
$reference = (new \EonX\EasyRandom\RandomGenerator())
->randomString(16)
->userFriendly();
# UUID V4
The random generator allows you to generate UUID V4, to do so, you will need to set the UUID V4 generator of your choice
onto the random generator instance.
This package comes with built-in implementations for: ramsey/uuid (opens new window), symfony/uid (opens new window).
If you want to use your own, then you will need to make sure it implements EonX\EasyRandom\Interfaces\UuidV4GeneratorInterface
.
$uuidV4Generator = new \EonX\EasyRandom\UuidV4\RamseyUuidV4Generator();
$randomGenerator = (new \EonX\EasyRandom\RandomGenerator())->setUuidV4Generator($uuidV4Generator);
$uuidV4 = $randomGenerator->uuidV4();
← Introduction Symfony →