Home/ Manual/ random / randomizer/ Random\Randomizer::getBytes

Random\Randomizer::getBytes

PHP function Edit on GitHub ✎

(PHP 8 >= 8.2.0)

Get random bytes

Description

Random\Randomizer::getBytes(int $length): string

Generates a string containing uniformly selected random bytes with the requested length.

As the returned bytes are selected completely randomly, the resulting string is likely to contain unprintable characters or invalid UTF-8 sequences. It may be necessary to encode it before transmission or display.

Parameters

length: The length of the random String that should be returned in bytes; must be 1 or greater.

Return Values

A String containing the requested number of random bytes.

Errors/Exceptions

If the value of length is less than 1, a ValueError will be thrown.

Examples

Random\Randomizer::getBytes() example

php

<?php
$r = new \Random\Randomizer();

echo bin2hex($r->getBytes(8)), "\n";
?>

The above example will output something similar to:

output

ebdbe93cd56682c2