Random\Randomizer::getBytes

Get random bytes

Description

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

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.
  • Any Throwables thrown by the Random\Engine::generate method of the underlying Random\Randomizer::$engine.

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

  • random_bytes
  • bin2hex
  • base64_encode
  • Random\Randomizer::getBytesFromString