PHP 8.1.31 Released!

Random\Randomizer::getBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::getBytesGet random bytes

Description

public 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

Examples

Example #1 Random\Randomizer::getBytes() example

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

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

The above example will output something similar to:

ebdbe93cd56682c2

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top