Download the PHP package ircmaxell/random-lib without Composer
On this page you can find all versions of the php package ircmaxell/random-lib. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ircmaxell/random-lib
More information about ircmaxell/random-lib
Files in ircmaxell/random-lib
Package random-lib
Short Description A Library For Generating Secure Random Numbers
License MIT
Homepage https://github.com/ircmaxell/RandomLib
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package random-lib
RandomLib
A library for generating random numbers and strings of various strengths.
This library is useful in security contexts.
Install
Via Composer
Usage
Factory
A factory is used to get generators of varying strength:
A factory can be configured with additional mixers and sources but can be used out of the box to create both medium and low strength generators.
Convenience methods are provided for creating high, medium, and low strength generators. Example:
$factory->getLowStrengthGenerator()
Convenience method to get a low strength random number generator.
Low Strength should be used anywhere that random strings are needed in a non-cryptographical setting. They are not strong enough to be used as keys or salts. They are however useful for one-time use tokens.
$factory->getMediumStrengthGenerator()
Convenience method to get a medium strength random number generator.
Medium Strength should be used for most needs of a cryptographic nature. They are strong enough to be used as keys and salts. However, they do take some time and resources to generate, so they should not be over-used
$factory->getHighStrengthGenerator()
Convenience method to get a high strength random number generator.
High Strength keys should ONLY be used for generating extremely strong cryptographic keys. Generating them is very resource intensive and may take several minutes or more depending on the requested size.
There are currently no mixers shipped with this package that are capable of creating a high space generator. This will not work out of the box!
Generator
A generator is used to generate random numbers and strings.
Example:
$generator->generate($size)
Generate a random byte string of the requested size.
$generator->generateInt($min = 0, $max = PHP_INT_MAX)
Generate a random integer with the given range. If range ($max - $min)
is zero, $max will be used.
$generator->generateString($length, $characters = '')
Generate a random string of specified length.
This uses the supplied character list for generating the new result string. The list of characters should be specified as a string containing each allowed character.
If no character list is specified, the following list of characters is used:
0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+/Examples:
License
MIT, see LICENSE.
Community
If you have questions or want to help out, join us in the #php.security channel on irc.freenode.net.
Security Vulnerabilities
If you have found a security issue, please contact the author directly at [email protected].
