php/archived-php-src
1
0
Fork 0
mirror of https://github.com/php/php-src.git synced 2026-04-09 17:13:31 +02:00
Code Issues Packages Projects Releases Wiki Activity

UPGRADING: Document algorithm specific hash options [ci skip]

Browse Source 
Signed-off-by: Anatol Belski <ab@php.net>
This commit is contained in:
Anatol Belski
2020-12-13 16:36:57 +01:00
parent 110b4e9094
commit c6d3c68fb4
1 changed files with 18 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
UPGRADING
View File

@@ -24,12 +24,29 @@ PHP 8.1 UPGRADE NOTES
========================================
- hash:
. Added MurmurHash3 with streaming support. The following variants are implemented
. The following functions have changed signatures:
- function hash(string $algo, string $data, bool $binary = false, array $options = []): string|false {}
- function hash_file(string $algo, string $filename, bool $binary = false, array $options = []): string|false {}
- function hash_init(string $algo, int $flags = 0, string $key = "", array $options = []): HashContext {}
The additional `$options` argument can be used to pass algorithm specific data.
. Added MurmurHash3 with streaming support. The following variants are implemented:
- murmur3a, 32-bit hash
- murmur3c, 128-bit hash for x86
- murmur3f, 128-bit hash for x64
The initial hash state can be passed through the `seed` key in the `$options` array, for example:
```php
$h = hash("murmur3f", $data, options: ["seed" => 42]);
echo $h, "\n";
```
A valid seed value is within the range from 0 to the plaform defined UINT_MAX, usually 4294967295.
========================================
3. Changes in SAPI modules
========================================