Skip to content

Commit 8bea911

Browse files
committed
Update UPGRADING wrt. [RFC]: Add Argon2 to password_*
1 parent 6cd06d3 commit 8bea911

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

UPGRADING

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,10 @@ PHP 7.2 UPGRADE NOTES
3232
- PCRE:
3333
. Added `J` modifier for setting PCRE_DUPNAMES.
3434

35+
- Standard:
36+
. Simplified password hashing API updated to support Argon2i hashes when PHP is compiled with libargon2
37+
(https://wiki.php.net/rfc/argon2_password_hash).
38+
3539
========================================
3640
3. Changes in SAPI modules
3741
========================================
@@ -44,6 +48,14 @@ PHP 7.2 UPGRADE NOTES
4448
5. Changed Functions
4549
========================================
4650

51+
- Standard:
52+
. password_hash() can generate Argon2i hashes when the algorithm is set to PASSWORD_ARGON2I.
53+
When using PASSWORD_ARGON2I, the following cost factors may be set: 'memory_cost', 'time_cost',
54+
and 'threads'. These cost factors will default to 'PASSWORD_ARGON2_DEFAULT_MEMORY_COST',
55+
'PASSWORD_ARGON2_DEFAULT_TIME_COST', and 'PASSWORD_ARGON2_DEFAULT_THREADS' respectively if not set.
56+
. password_verify() can verify Argon2i hashes.
57+
. password_get_info() and password_needs_rehash() can accept Argon2i hashes.
58+
4759
========================================
4860
6. New Functions
4961
========================================
@@ -82,6 +94,12 @@ PHP 7.2 UPGRADE NOTES
8294
10. New Global Constants
8395
========================================
8496

97+
- Standard:
98+
. PASSWORD_ARGON2_DEFAULT_MEMORY_COST
99+
. PASSWORD_ARGON2_DEFAULT_TIME_COST
100+
. PASSWORD_ARGON2_DEFAULT_THREADS
101+
. PASSWORD_ARGON2I
102+
85103
========================================
86104
11. Changes to INI File Handling
87105
========================================

0 commit comments

Comments
 (0)