Debian Codegraph @

vendor/ramsey/uuid/src/Generator/RandomLibAdapter.php

raw
1 <?php
2 /**
3 * This file is part of the ramsey/uuid library
4 *
5 * For the full copyright and license information, please view the LICENSE
6 * file that was distributed with this source code.
7 *
8 * @copyright Copyright (c) Ben Ramsey <[email protected]>
9 * @license http://opensource.org/licenses/MIT MIT
10 * @link https://benramsey.com/projects/ramsey-uuid/ Documentation
11 * @link https://packagist.org/packages/ramsey/uuid Packagist
12 * @link https://github.com/ramsey/uuid GitHub
13 */
14
15 namespace Ramsey\Uuid\Generator;
16
17 use RandomLib\Generator;
18 use RandomLib\Factory;
19
20 /**
21 * RandomLibAdapter provides functionality to generate strings of random
22 * binary data using the paragonie/random-lib library
23 *
24 * @link https://packagist.org/packages/paragonie/random-lib
25 */
26 class RandomLibAdapter implements RandomGeneratorInterface
27 {
28 /**
29 * @var Generator
30 */
31 private $generator;
32
33 /**
34 * Constructs a `RandomLibAdapter` using a `RandomLib\Generator`
35 *
36 * By default, if no `Generator` is passed in, this creates a high-strength
37 * generator to use when generating random binary data.
38 *
39 * @param Generator $generator An paragonie/random-lib `Generator`
40 */
41 public function __construct(Generator $generator = null)
42 {
43 $this->generator = $generator;
44
45 if ($this->generator === null) {
46 $factory = new Factory();
47
48 $this->generator = $factory->getHighStrengthGenerator();
49 }
50 }
51
52 /**
53 * Generates a string of random binary data of the specified length
54 *
55 * @param integer $length The number of bytes of random binary data to generate
56 * @return string A binary string
57 */
58 public function generate($length)
59 {
60 return $this->generator->generate($length);
61 }
62 }