array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.openssl-password-hash.php', 1 => 'openssl_password_hash', 2 => 'Crée un hachage de mot de passe en utilisant l\'implémentation Argon2 d\'OpenSSL', ), 'up' => array ( 0 => 'ref.openssl.php', 1 => 'Fonctions OpenSSL', ), 'prev' => array ( 0 => 'function.openssl-open.php', 1 => 'openssl_open', ), 'next' => array ( 0 => 'function.openssl-password-verify.php', 1 => 'openssl_password_verify', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/openssl/functions/openssl-password-hash.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

openssl_password_hash

(No version information available, might only be in Git)

openssl_password_hash — Crée un hachage de mot de passe en utilisant l'implémentation Argon2 d'OpenSSL

Description

openssl_password_hash(string $algo, string $password, array $options = []): string

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).

Liste de paramètres

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 tableau 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

Valeurs de retour

Retourne le hachage du mot de passe sous forme de chaîne de caractères.

Erreurs / Exceptions

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.

Historique

Version Description
8.4.0 Ajout de la fonction.

Exemples

Exemple #1 Exemple avec openssl_password_hash()

<?php
$hash = openssl_password_hash('argon2id', 'mon-mot-de-passe-secret');
echo $hash;
?>

Résultat de l'exemple ci-dessus est similaire à :

$argon2id$v=19$m=65536,t=4,p=1$c29tZXNhbHR2YWx1ZQ$hashvalue...

Exemple #2 openssl_password_hash() avec des options personnalisées

<?php
$hash = openssl_password_hash('argon2id', 'mon-mot-de-passe-secret', [
'memory_cost' => 65536,
'time_cost' => 4,
'threads' => 1,
]);
?>

Voir aussi