eonx-com/easy-random

Provides easy way to generate random values (string, int, uuids, ...)

6.4.0 2024-11-18 15:43 UTC

Requires

• php: ^8.2
• symfony/config: ^7.1
• symfony/dependency-injection: ^7.1
• symfony/http-kernel: ^7.1
• symfony/string: ^7.1
• symfony/uid: ^7.1

Requires (Dev)

• eonx-com/easy-test: ^6.4
• laravel/lumen-framework: ^11.0
• phpunit/phpunit: ^10.2
• symfony/framework-bundle: ^7.1

MIT

README

---eonx_docs--- title: Introduction weight: 0 ---eonx_docs---

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:

$ composer require eonx-com/easy-random

Usage

Integers

// Will generate a random integer between 0 and 20 (both included)
$myNumber = (new \EonX\EasyRandom\Generator\RandomGenerator(...))->integer(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\Generator\RandomGenerator(...))
    ->string(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\Generator\RandomGenerator(...))
    ->string(16)
    ->userFriendly();

UUID

The random generator allows you to generate UUID. This package comes with built-in implementations for: symfony/uid. If you want to use your own, then you will need to make sure it implements EonX\EasyRandom\Generator\UuidGeneratorInterface.

$uuid = (new \EonX\EasyRandom\Generator\RandomGenerator(...))->uuid();