The secure Pseudo Random Number Generator (PRNG) for PHP.

v3.0.0 2017-04-30 12:13 UTC

README

26927954?v=3&s=80

Logo of rng

The secure Pseudo Random Number Generator PRNG for PHP.

Build Status Codacy branch grade Codacy coverage clickalicious open source
GitHub release license Issue Stats Dependency Status

Table of Contents

Features

  • Provides a secure PRNG: pseudo random number generator (64-Bit support)
  • OOP facade to PHP core functionality
  • High performance (developed using a profiler)
  • Lightweight and high-quality codebase (following PSR standards e.g. PSR-1,2,4)
  • Stable, clean + well documented code
  • Unit-tested with a good coverage

Examples

Generate random number between 1 and 10 using OPEN_SSL random bytes (library default):

$generator = new \Clickalicious\Rng\Generator();
$number    = $generator->generate(1, 10);
echo $number;

Generate random number between 1 and 10 using PHP_MERSENNE_TWISTER random bytes:

$generator = new \Clickalicious\Rng\Generator(\Clickalicious\Rng\Generator::MODE_PHP_MERSENNE_TWISTER);
$number    = $generator->generate(1, 10);
echo $number;

Generate 16 random bytes using MODE_OPEN_SSL random bytes (library default):

$generator = new \Clickalicious\Rng\Generator();
$bytes     = $generator->getRandomBytes(16);

Generate 32 random bytes using NATIVE-PHP random bytes:

$generator = new \Clickalicious\Rng\Generator();
$bytes     = $generator->getRandomBytes(32);

Visualization

You can create a visualization of randomization (as you can see below but larger size) through visual.php » (the file is located in root). As you may see: The first square (light grey) is the default PHP random generated noise which is aligned by a pattern (you will see in the large version of the picture). The following three squares a generated using a more secure generator like Open-SSL for example.

Logo of rng

Requirements

  • PHP >= 5.6 (compatible up to version 7.2 as well as HHVM)

Philosophy

This library provides a state of the art PRNG (Pseudo Random Number Generator) implementation to generate secure Pseudo Random Numbers with PHP. The generation is either based on Open SSL or MCrypt or as fallback on PHP's internal functionality. The library also provides a very good Seed generator on puplic API. If you are interested in the difference between real and pseduo randomness then you could start at https://www.random.org/randomness/.

Scott Adams

DILBERT © 2001 Scott Adams.

Versioning

For a consistent versioning i decided to make use of Semantic Versioning 2.0.0 http://semver.org. Its easy to understand, very common and known from many other software projects.

Roadmap

  • No open issues.

Throughput Graph

Security Issues

If you encounter a (potential) security issue don't hesitate to get in contact with us opensource@clickalicious.de before releasing it to the public. So i get a chance to prepare and release an update before the issue is getting shared. Thank you!

Participate & Share

... yeah. If you're a code monkey too - maybe we can build a force ;) If you would like to participate in either Code, Comments, Documentation, Wiki, Bug-Reports, Unit-Tests, Bug-Fixes, Feedback and/or Critic then please let me know as well! 687474703a2f2f6a70696c6c6f72612e636f6d2f6769746875622d747769747465722d627574746f6e2f696d672f74776565742e706e67

Sponsors

Thanks to our sponsors and supporters:

JetBrains Navicat
68747470733a2f2f7265736f75726365732e6a6574627261696e732e636f6d2f6173736574732f6d656469612f6f70656e2d67726170682f6a6574627261696e735f323530783235302e706e67 687474703a2f2f75706c6f61642e77696b696d656469612e6f72672f77696b6970656469612f656e2f392f39302f5072656d69756d536f66745f4e6176696361745f5072656d69756d5f4c6f676f2e706e67
Copyright
Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY