random_bytes( int $bytes )

Windows with PHP < 5.3.0 will not have the function openssl_random_pseudo_bytes() available, so let's use CAPICOM to work around this deficiency.

Contents

Description Description

Parameters Parameters

$bytes

(int) (Required)

Top ↑

Return Return

(string)

Top ↑

Source Source

File: wp-includes/random_compat/random_bytes_com_dotnet.php

41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
function random_bytes($bytes)
{
    try {
        $bytes = RandomCompat_intval($bytes);
    } catch (TypeError $ex) {
        throw new TypeError(
            'random_bytes(): $bytes must be an integer'
        );
    }
 
    if ($bytes < 1) {
        throw new Error(
            'Length must be greater than 0'
        );
    }
 
    $buf = '';
    if (!class_exists('COM')) {
        throw new Error(
            'COM does not exist'
        );
    }
    $util = new COM('CAPICOM.Utilities.1');
    $execCount = 0;
 
    /**
     * Let's not let it loop forever. If we run N times and fail to
     * get N bytes of random data, then CAPICOM has failed us.
     */
    do {
        $buf .= base64_decode($util->GetRandom($bytes, 0));
        if (RandomCompat_strlen($buf) >= $bytes) {
            /**
             * Return our random entropy buffer here:
             */
            return RandomCompat_substr($buf, 0, $bytes);
        }
        ++$execCount;
    } while ($execCount < $bytes);
 
    /**
     * If we reach here, PHP has failed us.
     */
    throw new Exception(
        'Could not gather sufficient random data'
    );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/random_compat/cast_to_int.php: RandomCompat_intval()

Cast to an integer if we can, safely.
wp-includes/random_compat/byte_safe_strings.php: RandomCompat_strlen()

strlen() implementation that isn’t brittle to mbstring.func_overload
wp-includes/random_compat/byte_safe_strings.php: RandomCompat_substr()

substr() implementation that isn’t brittle to mbstring.func_overload

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/random_compat/random_int.php: random_int()

Fetch a random integer between $min and $max inclusive

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.