Skip to content

Numbers and Strings#

randomDigit#

Generates a random integer from 0 until 9.

echo $faker->randomDigit();

// an integer between 0 and 9

randomDigitNot#

Generates a random integer from 0 until 9, excluding a given number.

echo $faker->randomDigitNot(2);

// 0, 1, 3, 4, 5, 6, 7, 8 or 9

randomDigitNotNull#

Generates a random integer from 1 until 9.

echo $faker->randomDigitNotNull();

// an integer between 1 and 9

randomNumber#

Generates a random integer, containing between 0 and $nbDigits amount of digits. When the $strict parameter is true, it will only return integers with $nbDigits amount of digits.

echo $faker->randomNumber(5, false);

// 123, 43, 19238, 5, or 1203

echo $faker->randomNumber(5, true);

// 12643, 42931, or 32919

randomFloat#

Generates a random float. Optionally it's possible to specify the amount of decimals.

The second and third parameters optionally specify a lower and upper bound respectively.

echo $faker->randomFloat();

// 12.9830, 2193.1232312, 102.12

echo $faker->randomFloat(2);

// 43.23, 1203.49, 3428.93

echo $faker->randomFloat(1, 20, 30);

// 21.7, 27.2, 28.1

numberBetween#

Generates a random integer between $min and $max. By default, an integer is generated between 0 and 2,147,483,647 (32-bit integer).

echo $faker->numberBetween();

// 120378987, 182, 102310983

echo $faker->numberBetween(0, 100);

// 32, 87, 91, 13, 75

randomLetter#

Generates a random character from the alphabet.

echo $faker->randomLetter();

// 'h', 'i', 'q'

randomElements#

Returns $count amount of random element from the given array, traversable, or enum. By default, the $count parameter is set to 1, when null a random number of elements is returned.

echo $faker->randomElements(['a', 'b', 'c', 'd', 'e']);

// ['c']

echo $faker->randomElements(['a', 'b', 'c', 'd', 'e'], null);

// ['c', 'a', 'e']

echo $faker->randomElements(new \ArrayIterator(['a', 'b', 'c', 'd', 'e']));

// ['c']

enum Bar
{
    case A = 'a';
    case B = 'b';
    case C = 'c';
    case D = 'd';
    case E = 'e';
}

echo $faker->randomElements(Bar::class);

// ['c']

echo $faker->randomElements(['a', 'b', 'c', 'd', 'e'], 3);

// ['a', 'd', 'e']

randomElement#

Returns a random element from the given array, traversable, or enum.

echo $faker->randomElement(['a', 'b', 'c', 'd', 'e']);

// 'c'

echo $faker->randomElement(new \ArrayIterator(['a', 'b', 'c', 'd', 'e']));

// 'c'

enum Bar
{
    case A = 'a';
    case B = 'b';
    case C = 'c';
    case D = 'd';
    case E = 'e';
}

echo $faker->randomElement(Bar::class);

// 'c'

randomKey#

Returns a random key from the given array.

echo $faker->randomKey(['a' => 1, 'b' => 2, 'c' => 3]);

// 'b'

shuffle#

Returns a shuffled version of either an array or string.

echo $faker->shuffle('hello-world');

// 'lrhoodl-ewl'

echo $faker->shuffle([1, 2, 3]);

// [3, 1, 2]

numerify#

Generate a string where all # characters are replaced by digits between 0 and 9. By default, ### is used as input.

echo $faker->numerify();

// '912', '271', '109', '674'

echo $faker->numerify('user-####');

// 'user-4928', 'user-3427', 'user-1280'

lexify#

Generate a string where all ? characters are replaces with a random letter from the Latin alphabet. By default, ???? is used as input.

echo $faker->lexify();

// 'sakh', 'qwei', 'adsj'

echo $faker->lexify('id-????');

// 'id-xoqe', 'id-pqpq', 'id-zpeu'

bothify#

Generate a string where ? characters are replaced with a random letter, # characters are replaced with a random digit between 0 and 9, and * characters are replaced with either a random letter or a random digit. By default, ## ?? is used as input.

echo $faker->bothify();

// '46 hd', '19 ls', '75 pw'

echo $faker->bothify('?????-#####');

// 'lsadj-10298', 'poiem-98342', 'lcnsz-42938'

asciify#

Generate a string where * characters are replaced with a random character from the ASCII table. By default, **** is used as input.

echo $faker->asciify();

// '%Y+!', '{<"B', 'kF^a'

echo $faker->asciify('user-****');

// 'user-ntwx', 'user-PK`A', 'user-n`,X'

regexify#

Generate a random string based on a regex. By default, an empty string is used as input.

echo $faker->regexify();

// ''

echo $faker->regexify('[A-Z]{5}[0-4]{3}');

// 'DRSQX201', 'FUDPA404', 'CQVIU411'