From 128a94fb5e119d871457bda080c70a984e03162a Mon Sep 17 00:00:00 2001
From: Jakub Zelenka <bukka@php.net>
Date: Sun, 8 Dec 2024 20:51:16 +0100
Subject: [PATCH] Document argon2 installation with OpenSSL in PHP 8.4

---
 reference/password/setup.xml | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/reference/password/setup.xml b/reference/password/setup.xml
index cc1e9929873d..39d9bf0b27ee 100644
--- a/reference/password/setup.xml
+++ b/reference/password/setup.xml
@@ -8,9 +8,10 @@
   &reftitle.required;
   &no.requirement;
   <para>
-   For Argon2 password hashing, <link xlink:href="&url.libargon2;">libargon2</link>
-   is required, though. As of PHP 7.3.0, libargon2 version 20161029 or later is
-   required.
+   For Argon2 password hashing, either
+   <link xlink:href="&url.libargon2;">libargon2</link> is required or as of PHP
+   8.4.0, OpenSSL version 3.2 or later. As of PHP 7.3.0, libargon2 version
+   20161029 or later is required if libargon2 is used.
   </para>
  </section>
 
@@ -18,9 +19,11 @@
   &reftitle.install;
   &no.install;
   <para>
-   To enable Argon2 password hashing, however, PHP must be built with libargon2
-   support using the <option role="configure">--with-password-argon2</option>
-   configure option.
+   To enable Argon2 password hashing, however, PHP must be built either with
+   libargon2 support using the
+   <option role="configure">--with-password-argon2</option> configure option
+   or as of PHP 8.4.0, it can be build with OpenSSL using
+   <option role="configure">--with-openssl</option>.
   </para>
   <para>
    Prior to PHP 8.1.0, it was possible to specify the argon2 directory with