array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'random-randomizer.getbytes.php', 1 => 'Random\\Randomizer::getBytes', 2 => 'Get random bytes', ), 'up' => array ( 0 => 'class.random-randomizer.php', 1 => 'Random\\Randomizer', ), 'prev' => array ( 0 => 'random-randomizer.construct.php', 1 => 'Random\\Randomizer::__construct', ), 'next' => array ( 0 => 'random-randomizer.getbytesfromstring.php', 1 => 'Random\\Randomizer::getBytesFromString', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/random/random/randomizer/getbytes.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Random\Randomizer::getBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::getBytes — Get 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