Savvot\Random\Random

Complexity

Total Complexity

5

Size/Duplication

Total Lines	48
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	2

Importance

Changes	1
Bugs	0	Features	1

2 Methods

Rating	Name	Duplication	Size	Complexity
A	create()	0	8	2
A	createFromState()	0	17	3

<?php

namespace Savvot\Random;

/**
 * Static helper class.
 * Provides uniform way to create RNG objects from different generators and states
 *
 * @package Savvot\Random
 * @author  SavvoT <savvot@ya.ru>
 */
class Random
{
    const MT = '\Savvot\Random\MtRand';
    const XORSHIFT = '\Savvot\Random\XorShiftRand';
    const HASH = '\Savvot\Random\HashRand';

    /**
     * Creates RNG from specified class and initializes it with given seed
     *
     * @param string $seed     Seed to initialize generator's state. Defaults to null (auto)
     * @param string $rngClass Generator's class. Must be the child of AbstractRand. Defaults to XorShiftRand
     * @return AbstractRand Newly created PRNG
     * @throws RandException if generator class is invalid
     */
    public static function create($seed = null, $rngClass = self::XORSHIFT)
    {
        if (!is_subclass_of($rngClass, '\Savvot\Random\AbstractRand')) {

Due to PHP Bug #53727, is_subclass_of returns inconsistent results on some PHP versions for interfaces; you could instead use ReflectionClass::implementsInterface.

            throw new RandException('PRNG class must extend AbstractRand');
        }

        return new $rngClass($seed);
    }

    /**
     * Creates RNG from previously saved state
     *
     * @param array $state State array created with getState() method
     * @return AbstractRand Newly created PRNG
     * @throws RandException if specified state is invalid
     */
    public static function createFromState(array $state)
    {
        if (!isset($state['class'])) {
            throw new RandException('Invalid state');
        }

        $class = $state['class'];
        if (!is_subclass_of($class, '\Savvot\Random\AbstractRand')) {

Due to PHP Bug #53727, is_subclass_of returns inconsistent results on some PHP versions for interfaces; you could instead use ReflectionClass::implementsInterface.

            throw new RandException('Invalid RNG class in state');
        }

        /** @var \Savvot\Random\AbstractRand $prng */
        $prng = new $class;
        $prng->setState($state);

        return $prng;
    }
}