Tiqr_Random

Complexity

Total Complexity

2

Size/Duplication

Total Lines	24
Duplicated Lines	0 %

Test Coverage

Coverage

80%

Importance

Changes	3
Bugs	0	Features	0

1 Method

Rating	Name	Duplication	Size	Complexity
A	randomBytes()	0	10	2

<?php

/**
 * This file is part of the tiqr project.
 * 
 * The tiqr project aims to provide an open implementation for 
 * authentication using mobile devices. It was initiated by 
 * SURFnet and developed by Egeniq.
 *
 * More information: http://www.tiqr.org
 *
 * @author Ivo Jansch <ivo@egeniq.com>
 * 
 * @package tiqr
 *
 * @license New BSD License - See LICENSE file for details.
 *
 * @copyright (C) 2010-2011 SURFnet BV
 */


/**
 * A class implementing secure random number generation.
 *
 * @author ivo
 *
 */
class Tiqr_Random
{
    /**
     * Generate $length cryptographically secure pseudo-random bytes
     * Throws when requested number of bytes cannot be generated
     *
     * Note that this function generates random BYTES, it uses the string type as an array of bytes with values
     * from 0 to 255.
     *
     * @param int $length the number of bytes to generate.
     * @return string containing $length cryptographically secure pseudo-random bytes
     *
     * @throws Exception, Error, TypeError
     */
    public static function randomBytes(int $length): string
    {
        // Get $length cryptographically secure pseudo-random bytes
        $rnd=\random_bytes($length);

        if (strlen($rnd) !== $length) {
            throw new Exception("random_bytes did not return the requested number of bytes");
        }

        return $rnd;
    }

}