random_bytes

Function • Misc changes in PHP 8.2

Get cryptographically secure random bytes.

PHP 5

Added

PHP 7.1-7.4

Improved

PHP 8.1-8.2

PHP 8.3-8.4

PHP 8.5

PHP 8.6

`random_bytes` Function synopsis

random_bytes(int $length): string

Parameters

`$length`

Typeint

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

Return value

Typestring

A string containing the requested number of cryptographically secure random bytes.

Changes to the `random_bytes` Function

PHP 8.2

Moved from standard extension to random extension

PHP 8.0

Return type added: string
Parameter type added for parameter #1 ($length): int

- random_bytes($length)
+ random_bytes(int $length): string

PHP 7.0

Function added

`random_bytes` Function Availability

PHP Version	Availability
PHP 8.6Upcoming Release	Yes
PHP 8.5Supported (Latest)	Yes
PHP 8.4Supported	Yes
PHP 8.3Supported	Yes
PHP 8.2Security-Fixes Only	Yes
PHP 8.1Security-Fixes Only	Yes
PHP 8.0Unsupported	Yes
PHP 7.4Unsupported	Yes
PHP 7.3Unsupported	Yes
PHP 7.2Unsupported	Yes
PHP 7.1Unsupported	Yes
PHP 7.0Unsupported	Yes
PHP 5.6Unsupported	No
PHP 5.5Unsupported	No
PHP 5.4Unsupported	No
PHP 5.3Unsupported	No