https://github.com/clickalicious/rng
The secure Pseudo Random Number Generator PRNG for PHP.
https://github.com/clickalicious/rng
php prng random-bytes random-number-generator random-number-generators rng
Last synced: 1 day ago
JSON representation
The secure Pseudo Random Number Generator PRNG for PHP.
- Host: GitHub
- URL: https://github.com/clickalicious/rng
- Owner: clickalicious
- License: mit
- Created: 2015-03-16T13:35:09.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-05-29T16:08:25.000Z (over 7 years ago)
- Last Synced: 2025-07-02T15:55:24.826Z (8 months ago)
- Topics: php, prng, random-bytes, random-number-generator, random-number-generators, rng
- Language: PHP
- Homepage: http://clickalicious.github.io/rng
- Size: 2.82 MB
- Stars: 1
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
The secure **Pseudo Random Number Generator** `PRNG` for PHP.
| [](https://travis-ci.org/clickalicious/rng) | [](https://www.codacy.com/app/clickalicious/rng?utm_source=github.com&utm_medium=referral&utm_content=clickalicious/rng&utm_campaign=Badge_Grade) | [](https://www.codacy.com/app/clickalicious/rng?utm_source=github.com&utm_medium=referral&utm_content=clickalicious/rng&utm_campaign=Badge_Grade) | [](https://clickalicious.de/) |
|--- |--- |--- |--- |
| [](https://github.com/clickalicious/rng/releases) | [](https://opensource.org/licenses/MIT) | [](https://github.com/clickalicious/rng/issues) | [](https://dependencyci.com/github/clickalicious/rng) |
## Table of Contents
- [Features](#features)
- [Examples](#examples)
- [Requirements](#requirements)
- [Philosophy](#philosophy)
- [Versioning](#versioning)
- [Roadmap](#roadmap)
- [Security-Issues](#security-issues)
- [License »](LICENSE)
## 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):
```php
$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:
```php
$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):
```php
$generator = new \Clickalicious\Rng\Generator();
$bytes = $generator->getRandomBytes(16);
```
Generate `32 random bytes` using `NATIVE-PHP` random bytes:
```php
$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` »](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.
## Requirements
- `PHP >= 5.6` (compatible up to version `7.2` as well as `HHVM`)
## Philosophy
This library provides a state of the art `PRNG` (**P**seudo **R**andom **N**umber **G**enerator) 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/](https://www.random.org/randomness/ "https://www.random.org/randomness/").
[](http://dilbert.com/strip/2001-10-25 "Copyright Universal Uclick / 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.
[](https://waffle.io/clickalicious/rng/metrics)
## 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!
## Sponsors
Thanks to our sponsors and supporters:
| JetBrains | Navicat |
|---|---|
| 
| 
|
###### Copyright