PHP 8.1.24 Released!
    Submit a Pull Request Report a Bug

    random_bytes

    (PHP 7, PHP 8)

    random_bytes — Получает криптографически безопасные случайные байты

    Описание

    random_bytes(int $length): string

    Создаёт строку, содержащую равномерно выбранные случайные байты с запрошенной длиной.

    Поскольку возвращаемые байты выбираются совершенно случайно, полученная строка может содержать непечатаемые символы или недопустимые последовательности UTF-8. Может потребоваться её кодирование перед передачей или отображением.

    Случайная последовательность, создаваемая функцией, подходит для всех приложений, включая генерацию долгосрочных секретов, таких как ключи шифрования.

    Источники случайных величин в порядке приоритета:

    • Linux: » getrandom(), /dev/urandom

    • FreeBSD >= 12 (PHP >= 7.3): » getrandom(), /dev/urandom

    • Windows (PHP >= 7.2): » CNG-API

      Windows: » CryptGenRandom

    • macOS (PHP >= 8.2; >= 8.1.9; >= 8.0.22, если CCRandomGenerateBytes доступен во время компиляции): CCRandomGenerateBytes()

      macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), /dev/urandom

    • NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), /dev/urandom

    • OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), /dev/urandom

    • DragonflyBSD (PHP >= 8.1): » getrandom(), /dev/urandom

    • Solaris (PHP >= 8.1): » getrandom(), /dev/urandom

    • Любая комбинация операционной системы и версии PHP, не указанная ранее: /dev/urandom
    • Если ни один из источников не доступен или все они не генерируют случайную величину, то будет выброшено исключение Random\RandomException.

    Замечание: Эта функция была добавлена в PHP 7.0, а для версий с 5.2 по 5.6 включительно доступна » пользовательская реализация.

    Список параметров

    length

    Длина генерируемой строки в байтах; должно быть 1 или больше.

    Возвращаемые значения

    Возвращает строку, состоящую из заданного количества криптографически безопасных байт.

    Ошибки

    • Если подходящие источники случайных величин отсутствуют, то выбрасывается исключение Random\RandomException.
    • Если значение параметра length меньше 1, будет выброшена ошибка ValueError.

    Список изменений

    Версия Описание
    8.2.0 В случае возникновения ошибки CSPRNG, функция теперь будет выбрасывать исключение Random\RandomException. Ранее выбрасывалось исключение Exception.

    Примеры

    Пример #1 Пример использования random_bytes()

    <?php
    $bytes     = random_bytes(5);
    var_dump(bin2hex($bytes));
    ?>

    Результатом выполнения данного примера будет что-то подобное:

    string(10) "385e33f741"

    Смотрите также

    • Random\Randomizer::getBytes() - Получает случайные байты
    • random_int() - Получает криптографически безопасное, равномерно выбранное целое число
    • bin2hex() - Преобразует бинарные данные в шестнадцатеричное представление
    • base64_encode() - Кодирует данные в формат MIME base64
    ＋add a note

    User Contributed Notes 1 note

    up
    -1
    ccbsschucko at gmail dot com
    5 years ago
    <?php
    function str_rand(int $length = 64){ // 64 = 32
    $length = ($length < 4) ? 4 : $length;
    return     bin2hex(random_bytes(($length-($length%2))/2));
    }

    var_dump(str_rand());
    // d6199909d0b5fdc22c9db625e4edf0d6da2b113b21878cde19e96f4afe69e714
    ?>
    ＋add a note
    To Top