From 7b2f125ba5c6c2a9a0282fd67eeef048153f80d2 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Wed, 22 Apr 2026 16:44:45 +0200 Subject: [PATCH] [Sync EN] Add documentation for 2 new openssl functions (PHP 8.4) Ajout des fichiers FR pour openssl_password_hash et openssl_password_verify (PHP 8.4, basees sur OpenSSL Argon2). Fixes #2753 --- .../functions/openssl-password-hash.xml | 184 ++++++++++++++++++ .../functions/openssl-password-verify.xml | 150 ++++++++++++++ 2 files changed, 334 insertions(+) create mode 100644 reference/openssl/functions/openssl-password-hash.xml create mode 100644 reference/openssl/functions/openssl-password-verify.xml diff --git a/reference/openssl/functions/openssl-password-hash.xml b/reference/openssl/functions/openssl-password-hash.xml new file mode 100644 index 0000000000..396fb3bbb3 --- /dev/null +++ b/reference/openssl/functions/openssl-password-hash.xml @@ -0,0 +1,184 @@ + + + + + + openssl_password_hash + Crée un hachage de mot de passe en utilisant l'implémentation Argon2 d'OpenSSL + + + + &reftitle.description; + + stringopenssl_password_hash + stringalgo + stringpassword + arrayoptions[] + + + Crée un hachage de mot de passe en utilisant l'implémentation Argon2 + d'OpenSSL. Il s'agit d'une alternative à password_hash + qui utilise OpenSSL comme moteur, ce qui peut offrir une accélération + matérielle sur certaines plateformes. + + + Cette fonction n'est disponible que lorsque PHP est compilé avec le + support OpenSSL incluant Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + L'algorithme de hachage du mot de passe. Valeurs supportées : + "argon2id" et "argon2i". + + + + + password + + + Le mot de passe de l'utilisateur. + + + + + options + + + Un &array; associatif d'options. Clés supportées : + + + memory_cost : mémoire maximale (en Kio) pouvant + être utilisée pour calculer le hachage + + + time_cost : temps maximal pouvant être pris pour + calculer le hachage + + + threads : nombre de threads à utiliser pour + calculer le hachage + + + + + + + + + + + &reftitle.returnvalues; + + Retourne le hachage du mot de passe sous forme de &string;. + + + + + &reftitle.errors; + + Lance une ValueError si algo + n'est pas l'une des valeurs supportées + ("argon2i" ou "argon2id"). + + + Lance une Error si l'opération de hachage échoue + pour une raison inconnue. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Ajout de la fonction. + + + + + + + + + &reftitle.examples; + + Exemple avec <function>openssl_password_hash</function> + + +]]> + + &example.outputs.similar; + + + + + + <function>openssl_password_hash</function> avec des options personnalisées + + 65536, + 'time_cost' => 4, + 'threads' => 1, +]); +?> +]]> + + + + + + &reftitle.seealso; + + + openssl_password_verify + password_hash + + + + + + diff --git a/reference/openssl/functions/openssl-password-verify.xml b/reference/openssl/functions/openssl-password-verify.xml new file mode 100644 index 0000000000..319b1a5768 --- /dev/null +++ b/reference/openssl/functions/openssl-password-verify.xml @@ -0,0 +1,150 @@ + + + + + + openssl_password_verify + Vérifie un mot de passe par rapport à un hachage en utilisant l'implémentation Argon2 d'OpenSSL + + + + &reftitle.description; + + boolopenssl_password_verify + stringalgo + stringpassword + stringhash + + + Vérifie qu'un mot de passe correspond à un hachage créé par + openssl_password_hash. + + + Cette fonction n'est disponible que lorsque PHP est compilé avec le + support OpenSSL incluant Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + L'algorithme de hachage du mot de passe. Valeurs supportées : + "argon2id" et "argon2i". + + + + + password + + + Le mot de passe de l'utilisateur. + + + + + hash + + + Un hachage créé par openssl_password_hash. + + + + + + + + + &reftitle.returnvalues; + + Retourne &true; si le mot de passe et le hachage correspondent, ou &false; + sinon. + + + + + &reftitle.errors; + + Lance une ValueError si algo + n'est pas l'une des valeurs supportées + ("argon2i" ou "argon2id"). + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Ajout de la fonction. + + + + + + + + + &reftitle.examples; + + Exemple avec <function>openssl_password_verify</function> + + +]]> + + + + + + &reftitle.seealso; + + + openssl_password_hash + password_verify + + + + + +