1
0
mirror of https://github.com/php/doc-en.git synced 2026-04-28 17:53:18 +02:00
Commit Graph

66 Commits

Author SHA1 Message Date
Tim Düsterhus 2ab45105b4 Stop referring to openssl_random_pseudo_bytes() outside of ext/openssl (#1967)
* random: Remove openssl_random_pseudo_bytes() from caution.cryptographically-insecure

The `random_bytes()` and `random_int()` alternatives are available since since
PHP 7.0, are available by default and directly map to the OS' CSPRNG and thus
are likely more secure.

Thus this commit stops mentioning `openssl_random_pseudo_bytes()` as a possible
option any more to keep things simple for the reader.

* random: Remove `openssl_random_pseudo_bytes()` from “See Also” sections for ext/random

The reasoning as with the previous commit applies.

* hash: Replace `openssl_random_pseudo_bytes()` by `random_bytes()`

* session: Replace `openssl_random_pseudo_bytes()` by `random_bytes()`
2022-11-10 14:08:01 +01:00
Tim Starling 91e303f2d2 Updates for hash functions that now throw errors
Update the manual for the changes to the hash functions by Mark Randall
in August 2019 and subsequent tweaks by Máté Kocsis in March 2020.

Closes GH-1932.
2022-11-03 11:34:34 +01:00
Juliette 03bb26ae70 PHP 8.1 | Update hash_algos() documentation
> **MurmurHash3**
>
> Added support for 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
>
> **xxHash**
>
> Added support for xxHash. The following variants are implemented:
> * xxh32, 32-bit hash
> * xxh64, 64-bit hash
> * xxh3, 64-bit hash
> * xxh128, 128-bit hash

Refs:
* https://www.php.net/manual/en/migration81.new-features.php#migration81.new-features.hash.murmurhash3
* https://github.com/php/php-src/pull/6059
* https://github.com/php/php-src/commit/72e91e9fc82b85d0c5a6ff043cd1b2daee6c26d0
* https://www.php.net/manual/en/migration81.new-features.php#migration81.new-features.hash.xxhash
* https://github.com/php/php-src/pull/6524
* https://github.com/php/php-src/commit/23590f7c5348de4f8b69da81439b7c42c7ba084c

Co-authored-by: jrfnl <jrfnl@users.noreply.github.com>

Closes GH-1451.
2022-03-11 14:20:23 +01:00
Christoph M. Becker 1adf24615e Update name of 3rd param of hash_hmac_file()
See <https://github.com/php/php-src/issues/7826>.
2021-12-26 13:07:57 +01:00
Yoshinari Takaoka 4b4c8b4740 fixed function name in changelog 2021-12-18 10:23:36 +09:00
Máté Kocsis ac6b36357e Update ext/hash documentation
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Closes GH-1215.
2021-12-17 15:15:19 +01:00
Christoph M. Becker 8ad9c12d9b Fix #81473: hash_pbkdf2 truncate in hex
We extend the example to show the behavior of raw binary results.
2021-09-27 14:33:58 +02:00
Máté Kocsis 7f99d5e488 Remove some unnecessary methodsynopsis role attributes (#913) 2021-09-14 14:37:29 +02:00
Yoshinari Takaoka abb0c22310 Deleted old PHP 5.3 -> 5.4 tiger hash compatibility example. (#926) 2021-09-08 00:41:10 +01:00
George Peter Banyard 4283ca8aa3 Fix section order issues in Hash extension
Part of #658
2021-06-06 18:03:03 +01:00
Christoph Michael Becker e41806c30b Revert revision(s) 351724 from phpdoc/en/trunk:
Document false and null return types

Cf. <https://news-web.php.net/php.doc.cvs/17645>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351730 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 18:05:44 +00:00
Jakub Vrana c80da7c04a Document false and null return types
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351724 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 12:54:59 +00:00
Christoph Michael Becker dabaf662b1 Generate hash methodsynopses based on stubs
Patch contributed by Máté Kocsis <kocsismate@woohoolabs.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351417 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-17 22:46:27 +00:00
Andrey Gromov 01a7e4684e Fixes from volunteers
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350953 c90b9560-bf6c-de11-be94-00142212c4b1
2020-10-20 08:54:50 +00:00
Christoph Michael Becker 3e15d2894f Remove more changelog entries, mostly from PHP 5.4 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350656 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 14:15:17 +00:00
Christoph Michael Becker 7f569e1f17 Remove more changelog entries, mostly from PHP 5.3 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350655 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 14:08:59 +00:00
Christoph Michael Becker d666d3b377 Updated hash_algos doc for PHP 7.4
Patch contributed by Graham Campbell.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350291 c90b9560-bf6c-de11-be94-00142212c4b1
2020-08-08 12:55:04 +00:00
Christoph Michael Becker ff3d7bb38b Link to hash_algos() from hash() and hash_file()
Patch provided by Ryan McCue <me@ryanmccue.info>.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349408 c90b9560-bf6c-de11-be94-00142212c4b1
2020-03-13 18:01:28 +00:00
Christoph Michael Becker 72ff27ac10 Document new hash algos as of PHP 7.1.0
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344357 c90b9560-bf6c-de11-be94-00142212c4b1
2018-02-24 18:14:35 +00:00
Christoph Michael Becker 173b1454c1 Clarify return value for non-cryptographic algos
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344350 c90b9560-bf6c-de11-be94-00142212c4b1
2018-02-24 15:54:44 +00:00
Jakub Vrana f3e46c7b29 Fix #75739: Hash uses objects since PHP 7.2.0
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344006 c90b9560-bf6c-de11-be94-00142212c4b1
2018-01-28 13:32:11 +00:00
Jakub Vrana b8758b0605 Use entities in initializer
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@343899 c90b9560-bf6c-de11-be94-00142212c4b1
2018-01-25 19:11:34 +00:00
Christoph Michael Becker 38fb328862 Fix bug #75266: hash_algos doesnt work properly for listing HMAC algos
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@343152 c90b9560-bf6c-de11-be94-00142212c4b1
2017-09-27 15:13:33 +00:00
Mark Jones dfb5e6fa03 openssl_pbkf2 commit, removing bad ciphers from get cipher methods example
https://bugs.php.net/bug.php?id=71817


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@343015 c90b9560-bf6c-de11-be94-00142212c4b1
2017-09-06 20:12:11 +00:00
Andrey Gromov 1fed7cc0df typo
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342645 c90b9560-bf6c-de11-be94-00142212c4b1
2017-07-04 17:10:03 +00:00
Andrey Gromov 7315ad1258 typo fix
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342644 c90b9560-bf6c-de11-be94-00142212c4b1
2017-07-04 16:53:22 +00:00
Andrey Andreev a028258b51 Fix docs bug #66366: Tiger hash BC not documented in migration54
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342107 c90b9560-bf6c-de11-be94-00142212c4b1
2017-03-13 10:19:17 +00:00
Andrey Andreev 722c4a62ca Add changelogs for non-crypto hashes being blacklisted for HMACs as of PHP 7.2.0
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342106 c90b9560-bf6c-de11-be94-00142212c4b1
2017-03-13 09:46:54 +00:00
Andrey Andreev e099327c0b Add hash_hkdf() documentation
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@341989 c90b9560-bf6c-de11-be94-00142212c4b1
2017-02-28 11:20:58 +00:00
Christoph Michael Becker 22eec6c860 added example regarding changed byte-order of tiger hashes as of PHP 5.4 (fixes #61307)
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@336947 c90b9560-bf6c-de11-be94-00142212c4b1
2015-06-14 15:00:38 +00:00
Pieter Hordijk 8547098010 Changed i.e. -> e.g. as per https://bugs.php.net/bug.php?id=69507
http://www.grammarly.com/blog/2014/know-your-latin-i-e-vs-e-g/

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@336629 c90b9560-bf6c-de11-be94-00142212c4b1
2015-04-23 08:29:06 +00:00
Mike Griffiths cb94cca3e4 Added word 'immediately' to add clarity, address bug #68328
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@335150 c90b9560-bf6c-de11-be94-00142212c4b1
2014-10-30 10:04:51 +00:00
Tjerk Anne Meesters 92d06574ba Added length information leak when parameters of hash_equals() aren't of equal lengths.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@334682 c90b9560-bf6c-de11-be94-00142212c4b1
2014-09-01 00:08:06 +00:00
Adam Harvey b9524cc57c Fix last commit. Sorry!
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@334632 c90b9560-bf6c-de11-be94-00142212c4b1
2014-08-28 04:26:20 +00:00
Adam Harvey 29b7b9e17d Note the addition of gost-crypto on the hash_algos() page, and update the list.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@334630 c90b9560-bf6c-de11-be94-00142212c4b1
2014-08-28 03:53:50 +00:00
Peter Cowburn 378c046c40 initial hash_equals() page
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@334601 c90b9560-bf6c-de11-be94-00142212c4b1
2014-08-25 20:17:58 +00:00
Philip Olson d06d3727d5 Mentions a case that false is returned. Patch by Alok Menghrajani.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332977 c90b9560-bf6c-de11-be94-00142212c4b1
2014-03-12 23:25:43 +00:00
Nikita Popov ac78bae531 Improve hash_pbkdf2 docs
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332089 c90b9560-bf6c-de11-be94-00142212c4b1
2013-11-09 11:52:44 +00:00
Joe Watkins 898667f44c #64933 clarity in prototype
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@331807 c90b9560-bf6c-de11-be94-00142212c4b1
2013-10-13 17:43:44 +00:00
Pieter Hordijk 3e6a2269a8 Added text about retrieving supported algos
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@331014 c90b9560-bf6c-de11-be94-00142212c4b1
2013-07-24 11:24:53 +00:00
TAKAGI Masahiro 7da0357629 Set svn:keywords
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328153 c90b9560-bf6c-de11-be94-00142212c4b1
2012-10-27 05:41:49 +00:00
Adam Harvey 390f124427 Fix indentation, remove the unneeded changelog, and tweak the wording of the
caution slightly (although I suspect Sherif will probably tweak it again,
somehow).


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@326953 c90b9560-bf6c-de11-be94-00142212c4b1
2012-08-03 04:40:43 +00:00
Anthony Ferrara 1ebd60969a Fix an issue with an invalid xml id leading to an invalid page name
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@326580 c90b9560-bf6c-de11-be94-00142212c4b1
2012-07-11 11:43:41 +00:00
Anthony Ferrara f7dfa45134 Add hash_pbkdf2 documentation for added feature in master
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@326574 c90b9560-bf6c-de11-be94-00142212c4b1
2012-07-10 17:16:58 +00:00
Justin Martin 1d62341de3 Added changelog, indicating that the Tiger hash algorithm now uses big-endian byte ordering. Closes bug #60221.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@322885 c90b9560-bf6c-de11-be94-00142212c4b1
2012-01-27 23:12:24 +00:00
Justin Martin a0194922b8 Noted in changelog that Salsa10 and Salsa20 algos are removed in 5.4.0. Changed example to specify that the output will be similar, rather than exact, depending on the PHP version. Closes bug #60783.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@322701 c90b9560-bf6c-de11-be94-00142212c4b1
2012-01-24 22:48:25 +00:00
Jakub Vrana 84f749b644 PHP 5.4.0 algos
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@312734 c90b9560-bf6c-de11-be94-00142212c4b1
2011-06-30 21:24:40 +00:00
Anthony Ferrara 8c9aa4f043 Update hash_algos docs to include new algorithms introduced in 5.3.0, and a changelog entry to indicate the change as well
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@312716 c90b9560-bf6c-de11-be94-00142212c4b1
2011-06-30 18:57:36 +00:00
Daniel Egeberg 2b587ab01f Normalized initializer NULL-values to use the &null; entity:
for file in `find -name '*.xml'`; do sed -i -e 's/<initializer>null<\/initializer>/<initializer>\&null;<\/initializer>/i' $file; done



git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@298918 c90b9560-bf6c-de11-be94-00142212c4b1
2010-05-03 17:10:04 +00:00
Daniel Egeberg 96c9d88bad Converted to utf-8
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@297028 c90b9560-bf6c-de11-be94-00142212c4b1
2010-03-28 22:10:10 +00:00