Chris@0
|
1 <?php
|
Chris@0
|
2 /**
|
Chris@17
|
3 * Random_* Compatibility Library
|
Chris@0
|
4 * for using the new PHP 7 random_* API in PHP 5 projects
|
Chris@17
|
5 *
|
Chris@0
|
6 * The MIT License (MIT)
|
Chris@0
|
7 *
|
Chris@16
|
8 * Copyright (c) 2015 - 2018 Paragon Initiative Enterprises
|
Chris@17
|
9 *
|
Chris@0
|
10 * Permission is hereby granted, free of charge, to any person obtaining a copy
|
Chris@0
|
11 * of this software and associated documentation files (the "Software"), to deal
|
Chris@0
|
12 * in the Software without restriction, including without limitation the rights
|
Chris@0
|
13 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
Chris@0
|
14 * copies of the Software, and to permit persons to whom the Software is
|
Chris@0
|
15 * furnished to do so, subject to the following conditions:
|
Chris@17
|
16 *
|
Chris@0
|
17 * The above copyright notice and this permission notice shall be included in
|
Chris@0
|
18 * all copies or substantial portions of the Software.
|
Chris@17
|
19 *
|
Chris@0
|
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
Chris@0
|
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
Chris@0
|
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
Chris@0
|
23 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
Chris@0
|
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
Chris@0
|
25 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
Chris@0
|
26 * SOFTWARE.
|
Chris@0
|
27 */
|
Chris@0
|
28
|
Chris@0
|
29 if (!is_callable('random_bytes')) {
|
Chris@0
|
30 /**
|
Chris@0
|
31 * Powered by ext/mcrypt (and thankfully NOT libmcrypt)
|
Chris@0
|
32 *
|
Chris@0
|
33 * @ref https://bugs.php.net/bug.php?id=55169
|
Chris@0
|
34 * @ref https://github.com/php/php-src/blob/c568ffe5171d942161fc8dda066bce844bdef676/ext/mcrypt/mcrypt.c#L1321-L1386
|
Chris@0
|
35 *
|
Chris@0
|
36 * @param int $bytes
|
Chris@0
|
37 *
|
Chris@0
|
38 * @throws Exception
|
Chris@0
|
39 *
|
Chris@0
|
40 * @return string
|
Chris@0
|
41 */
|
Chris@0
|
42 function random_bytes($bytes)
|
Chris@0
|
43 {
|
Chris@0
|
44 try {
|
Chris@16
|
45 /** @var int $bytes */
|
Chris@0
|
46 $bytes = RandomCompat_intval($bytes);
|
Chris@0
|
47 } catch (TypeError $ex) {
|
Chris@0
|
48 throw new TypeError(
|
Chris@0
|
49 'random_bytes(): $bytes must be an integer'
|
Chris@0
|
50 );
|
Chris@0
|
51 }
|
Chris@0
|
52
|
Chris@0
|
53 if ($bytes < 1) {
|
Chris@0
|
54 throw new Error(
|
Chris@0
|
55 'Length must be greater than 0'
|
Chris@0
|
56 );
|
Chris@0
|
57 }
|
Chris@0
|
58
|
Chris@16
|
59 /** @var string|bool $buf */
|
Chris@16
|
60 $buf = @mcrypt_create_iv((int) $bytes, (int) MCRYPT_DEV_URANDOM);
|
Chris@0
|
61 if (
|
Chris@16
|
62 is_string($buf)
|
Chris@16
|
63 &&
|
Chris@0
|
64 RandomCompat_strlen($buf) === $bytes
|
Chris@0
|
65 ) {
|
Chris@0
|
66 /**
|
Chris@0
|
67 * Return our random entropy buffer here:
|
Chris@0
|
68 */
|
Chris@0
|
69 return $buf;
|
Chris@0
|
70 }
|
Chris@0
|
71
|
Chris@0
|
72 /**
|
Chris@0
|
73 * If we reach here, PHP has failed us.
|
Chris@0
|
74 */
|
Chris@0
|
75 throw new Exception(
|
Chris@0
|
76 'Could not gather sufficient random data'
|
Chris@0
|
77 );
|
Chris@0
|
78 }
|
Chris@0
|
79 }
|