<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="password.setup" xmlns:xlink="http://www.w3.org/1999/xlink">

&reftitle.setup;

<section xml:id="password.requirements">

&reftitle.required;

&no.requirement;

<para>

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>

<section xml:id="password.installation">

&reftitle.install;

&no.install;

<para>

However, to enable Argon2 password hashing, PHP must be built either with

libargon2 support using the

<option role="configure">--with-password-argon2</option> configure option

or, starting from PHP 8.4.0, with OpenSSL using

<option role="configure">--with-openssl</option> and

<option role="configure">--with-openssl-argon2</option>.

</para>

<para>

Prior to PHP 8.1.0, it was possible to specify the argon2 directory with

<option role="configure">--with-password-argon2[=DIR]</option>.

</para>

</section>

</chapter>