Update docs to reflect PHP 8.2 final release
parent
0e5326edae
commit
1b1be45ea1
13
README.md
13
README.md
|
@ -5,12 +5,7 @@
|
|||
[](https://gitlab.com/sandfox/php-random-polyfill/-/pipelines)
|
||||
[](https://codecov.io/gl/sandfox/php-random-polyfill/)
|
||||
|
||||
This is a polyfill for the new `ext-random` extension that will be released with PHP 8.2.
|
||||
|
||||
RFC:
|
||||
|
||||
* https://wiki.php.net/rfc/rng_extension
|
||||
* https://wiki.php.net/rfc/random_extension_improvement
|
||||
This is a polyfill for the new `ext-random` extension that was released with PHP 8.2.
|
||||
|
||||
## Requirements
|
||||
|
||||
|
@ -29,6 +24,12 @@ The library aims to be compatible with `ext-random` as released in PHP 8.2.0 and
|
|||
|
||||
## Documentation
|
||||
|
||||
### Random Extension
|
||||
|
||||
Read the official PHP doc: https://www.php.net/manual/en/book.random.php
|
||||
|
||||
### The Polyfill
|
||||
|
||||
Read full documentation here: <https://sandfox.dev/php/random-polyfill.html>
|
||||
|
||||
Also on Read the Docs: <https://php-random-polyfill.readthedocs.io/>
|
||||
|
|
|
@ -4,9 +4,28 @@ Compatibility Notes
|
|||
PHP
|
||||
===
|
||||
|
||||
.. note::
|
||||
Random Extension doc on the PHP website:
|
||||
https://www.php.net/manual/en/book.random.php
|
||||
|
||||
The library aims to be compatible with ``ext-random`` as released in PHP 8.2.0 and subsequent patch releases.
|
||||
The library will not be a full replacement for ``ext-random`` and total compatibility does not seem to be achievable.
|
||||
|
||||
Available classes:
|
||||
|
||||
* This polyfill:
|
||||
|
||||
* `Random\\Randomizer <https://www.php.net/manual/en/class.random-randomizer.php>`__
|
||||
* `Random\\Engine\\Mt19937 <https://www.php.net/manual/en/class.random-engine-mt19937.php>`__
|
||||
* `Random\\Engine\\PcgOneseq128XslRr64 <https://www.php.net/manual/en/class.random-engine-pcgoneseq128xslrr64.php>`__
|
||||
* `Random\\Engine\\Xoshiro256StarStar <https://www.php.net/manual/en/class.random-engine-xoshiro256starstar.php>`__
|
||||
|
||||
* From `symfony/polyfill-php82 <https://packagist.org/packages/symfony/polyfill-php82>`__:
|
||||
|
||||
* `Random\\Engine <https://www.php.net/manual/en/class.random-engine.php>`__
|
||||
* `Random\\Engine\\CryptoSafeEngine <https://www.php.net/manual/en/class.random-cryptosafeengine.php>`__
|
||||
* `Random\\Engine\\Secure <https://www.php.net/manual/en/class.random-engine-secure.php>`__
|
||||
|
||||
Version 1.99.0
|
||||
==============
|
||||
|
||||
|
|
|
@ -3,12 +3,7 @@ Random Extension Polyfill
|
|||
|
||||
|Packagist| |GitLab| |GitHub| |Bitbucket| |Gitea|
|
||||
|
||||
This is a polyfill for the new ``ext-random`` extension that will be released with PHP 8.2.
|
||||
|
||||
RFC:
|
||||
|
||||
* https://wiki.php.net/rfc/rng_extension
|
||||
* https://wiki.php.net/rfc/random_extension_improvement
|
||||
This is a polyfill for the new ``ext-random`` extension that was released with PHP 8.2.
|
||||
|
||||
Requirements
|
||||
============
|
||||
|
@ -23,6 +18,11 @@ Installation
|
|||
|
||||
composer require 'arokettu/random-polyfill'
|
||||
|
||||
Random Extension Documentation
|
||||
==============================
|
||||
|
||||
On the PHP website: https://www.php.net/manual/en/book.random.php
|
||||
|
||||
Documentation
|
||||
=============
|
||||
|
||||
|
|
|
@ -12,7 +12,7 @@ https://github.com/arokettu/random-polyfill-perf
|
|||
* Secure engine is mostly unaffected by the choice of backend (except for nextInt() case)
|
||||
* PHP 7:
|
||||
|
||||
* With GMP installed, all engines is approximately 400 times slower than native
|
||||
* With GMP installed, all engines are approximately 400 times slower than native
|
||||
* Mersenne Twister is consistently 400 times slower than native, whether you use GMP or not
|
||||
* PCG is 100 times slower without GMP and xoshiro256** is 50 times slower without GMP
|
||||
* PHP 8:
|
||||
|
|
Loading…
Reference in New Issue