PHP Hashage de mots de passe : Argon2id, bcrypt et migration sécurisée
Apprenez à hasher en toute sécurité les mots de passe en PHP en utilisant Argon2id et bcrypt, choisissez des paramètres sûrs, vérifiez les identifiants et migrez les hachages existants sans forcer les réinitialisations de mot de passe.
Hachage de mot de passe PHP : Argon2id, bcrypt et migration sécurisée
Le stockage des mots de passe est l'une des décisions de sécurité les plus importantes dans une application web. Une violation de base de données ne devrait pas révéler immédiatement les identifiants des utilisateurs, mais un hachage de mot de passe faible peut rendre les hachages volés peu coûteux à attaquer.
PHP inclut des fonctions intégrées pour hacher, vérifier et mettre à niveau les mots de passe. Le défi consiste à sélectionner le bon algorithme, à le configurer pour votre infrastructure et à migrer les comptes existants sans perturber l'authentification.
Pour les nouvelles applications, Argon2id est généralement le choix privilégié lorsque votre build PHP le prend en charge. bcrypt reste une option de compatibilité pratique. Les deux doivent être utilisés via l'API de mot de passe PHP, plutôt que par une cryptographie maison.
Ce guide couvre l'implémentation, la sélection des paramètres, la migration de l'héritage et les erreurs courantes.
Pourquoi SHA-256 ne convient pas pour le stockage des mots de passe
SHA-256 est conçu pour être rapide. Cela le rend utile pour les vérifications d'intégrité, mais inconvéniable par lui-même pour le stockage des mots de passe : un attaquant avec des hachages volés peut tester de nombreuses devinettes de mot de passe rapidement.
Les algorithmes de hachage de mot de passe délibérément consomment plus de ressources. Argon2id peut nécessiter une mémoire substantielle ainsi que du temps de traitement, ce qui rend le guess à grande échelle plus coûteux.
Un système de stockage sécurisé a besoin d'un sel aléatoire unique, d'un facteur de travail configurable et d'un moyen d'augmenter le facteur de travail à mesure que le hardware s'améliore. PHP's password_hash() génère et stocke les informations de sel nécessaires automatiquement.
Le OWASP Password Storage Cheat Sheet recommande le hachage adaptatif des mots de passe plutôt que les fonctions de hachage généralistes rapides.
Argon2id vs bcrypt : lequel choisir ?
| Fonctionnalité | Argon2id | bcrypt |
|---|---|---|
| Défense principale | Coût de mémoire et de calcul | Coût de calcul |
| Mémoire difficile | Oui | Non |
| Paramètres configurables | Mémoire, itérations, parallélisme | Facteur de coût |
| Limite d'entrée du mot de passe | Pas de limite de 72 octets de style bcrypt | 72 octets |
| Disponibilité dans PHP | Dépend de la build | largement disponible |
| Meilleur choix | Privilégié pour le stockage nouveau de mots de passe | Compatibilité et systèmes hérités |
Argon2id est conçu pour résister aux attaques qui bénéficient d'un hardware massivement parallèle. bcrypt est toujours un algorithme de hachage de mot de passe adaptatif légitime, mais sa limite d'entrée nécessite des précautions : il considère au maximum les premiers 72 octets, pas caractères.
Ne supposez pas que PASSWORD_DEFAULT sélectionne Argon2id. La documentation PHP password_hash documente actuellement bcrypt comme algorithme par défaut. PHP 8.4 a augmenté le coût par défaut de bcrypt de 10 à 12, illustrant pourquoi s'appuyer sur des paramètres implicites peut modifier les performances de l'application après des mises à niveau.
Étape 1 : Vérifier la prise en charge d'Argon2id
Argon2id n'est pas nécessairement disponible sur chaque environnement d'hébergement. Vérifiez le runtime avant de le sélectionner :
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
La disponibilité dépend de la façon dont PHP a été construit. Ne supposez pas que la mise à niveau de la version PHP active automatiquement Argon2id.
Étape 2 : Hacher un mot de passe avec Argon2id
OWASP documente plusieurs configurations de base acceptables. Une utilise 19 MiB de mémoire, deux itérations et un parallélisme de un. PHP exprime memory_cost en KiB, donc 19 MiB est 19 * 1024 KiB.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$password = 'example-user-password';
$hash = password_hash(
$password,
PASSWORD_ARGON2ID,
$options
);
L'option de parallélisme threads est prise en charge avec certains backends Argon2, y compris libargon2, mais pas chaque build PHP. Si prise en charge, une valeur de un correspond à cette ligne de base ; l'omettre est plus portable. Benchmark your actual configuration.
Le hachage encodé résultat inclut l'identificateur d'algorithme, les paramètres et le sel. Il n'est pas nécessaire de sauvegarder ces valeurs dans des colonnes de base de données séparées. Une colonne VARCHAR(255) est un point de départ raisonnable pour les hachages de mot de passe modernes, à condition qu'elle stocke la valeur entièrement encodée.
Ce sont des paramètres de base, pas une configuration de production universelle. Testez la latence et l'utilisation de la mémoire sous un trafic d'authentification concurrentiel réaliste.
Étape 3 : Vérifier correctement les identifiants

Comme chaque hachage de mot de passe utilise un sel aléatoire, générer un nouveau hachage et comparer des chaînes ne fonctionnera pas. Utilisez password_verify() :
<?php
declare(strict_types=1);
$submittedPassword = (string)($_POST['password'] ?? '');
$storedHash = (string)$user['password_hash'];
if(!password_verify($submittedPassword, $storedHash)) {
// Reject authentication without disclosing account existence.
return;
}
// The password is valid. Continue with secure session handling.
La documentation PHP spécifie que password_verify() est sécurisée contre les attaques de timing. Elle lit l'algorithme et les paramètres de travail depuis le hachage stocké.
La vérification du mot de passe ne remplace pas le throttled de connexion, les sessions sécurisées, HTTPS, la gestion d'erreurs appropriée ou l'authentification multifacteur.
Étape 4 : Faire passer les hachages de mot de passe existants lors de la connexion
password_needs_rehash() détecte lorsque un hachage stocké utilise un algorithme ou des paramètres obsolètes. Cela permet une migration progressive sans forcer chaque actif à réinitialiser leur mot de passe.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
if(password_verify($submittedPassword, $storedHash)) {
if(password_needs_rehash(
$storedHash,
PASSWORD_ARGON2ID,
$options
)) {
$newHash = password_hash(
$submittedPassword,
PASSWORD_ARGON2ID,
$options
);
// Persist with a prepared statement.
// Prefer a conditional UPDATE to avoid overwriting
// a newer hash from a concurrent request.
}
// Finish authentication and rotate the session identifier.
}
Re-hachez après avoir vérifié avec succès le mot de passe soumis. Une mise à jour conditionnelle peut s'assurer que le hachage stocké correspond encore à la valeur qui vient d'être vérifiée. Par exemple, mettez à jour le hachage de mot de passe seulement là où l'ID utilisateur et l'ancien hachage correspondent.
Voir PHP password_needs_rehash() pour les détails de l'API.
Étape 5 : Migrer les hachages MD5 ou SHA-1 hérités
Les applications plus anciennes peuvent contenir des formats de mot de passe MD5, SHA-1 ou personnalisés. Ces hachages ne peuvent pas toujours être vérifiés avec password_verify().
Une migration devrait suivre une séquence contrôlée :
- Identifiez le format hérité en utilisant des métadonnées de confiance ou un format documenté non ambigu.
- Vérifiez le mot de passe soumis à l'aide du schéma hérité original seulement pour les comptes qui le requirent encore.
- Après une vérification réussie, créez immédiatement un hachage moderne en utilisant
password_hash(). - Remplacez le hachage hérité stocké en utilisant une mise à jour de base de données sécurisée.
- Retirez la vérification héritée lorsque la migration est terminée.
Ne devinez pas l'algorithme uniquement à partir de la longueur du hachage lorsque plusieurs formats sont possibles. N'essayez pas de décrypter les hachages de mot de passe : le hachage n'est pas un chiffrement.
Pour les comptes qui ne se connectent jamais, envisagez une politique de réinitialisation du mot de passe plutôt que de retenir des hachages faibles indéfiniment. Ne introduisez pas de chemin de secours insecure qui accepte des hachages faibles pour les utilisateurs nouvellement enregistrés.
Étape 6 : Benchmark du hachage sur votre infrastructure
Les bons paramètres de coût dépendent de votre hardware, du volume de connexions concurrentielles et des exigences de latence.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$start = hrtime(true);
$hash = password_hash(
'benchmark-password',
PASSWORD_ARGON2ID,
$options
);
$milliseconds = (hrtime(true) - $start) / 1_000_000;
echo round($milliseconds, 2) . ' ms';

Exécutez cela seulement dans un environnement contrôlé, pas comme un point web public. Mesurez également la vérification, et répétez sous une charge représentative. Un paramètre qui semble rapide isolé peut épuiser la RAM lorsque de nombreuses demandes arrivent ensemble.
OWASP recommande d'équilibrer la sécurité avec la capacité opérationnelle et de généralement garder les opérations de hachage individuelles en dessous d'une seconde.
Erreurs courantes de hachage de mot de passe
Ajouter un sel fixe manuellement. PHP génère déjà des sels sécurisés pour son API de mot de passe. Un sel fixe retire une protection importante.
Utiliser du MD5, SHA-1 ou SHA-256 brut. Ces algorithmes sont bien trop rapides pour le stockage de mot de passe par eux-mêmes.
Ignorer la limite de 72 octets de bcrypt. Les caractères UTF-8 multi-octets peuvent atteindre cette limite plus tôt que les utilisateurs ne le s'attendent.
Choisir des paramètres de coût extrêmes. Les demandes de mémoire ou CPU excessives peuvent créer un risque de déni de service aux points d'authentification.
Journaliser les mots de passe soumis. Évitez d'exposer les identifiants via les journaux de débogage, les systèmes de surveillance ou les rapports d'erreurs.
Supposer que le hachage de mot de passe résout la sécurité d'authentification. Le limit de taux, la réponse aux violations, la sécurité des sessions et l'authentification multifacteur comptent toujours.
Devriez-vous utiliser un pepper ?
Un pepper est un secret partagé supplémentaire conservé hors de la base de données de mot de passe. Contrairement à un sel, il n'est pas stocké à côté de chaque hachage.
Un pepper correctement conçu peut fournir une défense en profondeur si un attaquant vole seulement la base de données. Mais le peppering introduit une complexité de gestion des clés et de rotation : perdre ou faire tourner un pepper peut nécessiter des réinitialisations de mot de passe.
Ne improvisez pas en concaténant un secret codé en dur à chaque mot de passe. Suivez une stratégie documentée, stockez les secrets séparément et planifiez la rotation. OWASP discute des approches de pepper pré-hachage et post-hachage.
Une politique pratique de hachage de mot de passe
Pour une nouvelle application PHP, privilégiez Argon2id lorsqu'il est disponible, commencez avec une configuration alignée OWASP, benchmarkez-le et stockez le hachage encodé complet. Lorsque Argon2id n'est pas disponible, bcrypt via l'API de mot de passe PHP est une alternative pratique si son coût et sa limite d'entrée sont compris.
Pour une application existante, continuez à vérifier les hachages hérités supportés tout en les mettant à niveau après authentification réussie. Évitez les migrations disruptives lorsque le mot de passe original n'est pas disponible.
Concevez pour les mises à dès le début. Le hardware et les recommandations changent ; votre système d'authentisation devrait être capable d'adopter de meilleurs paramètres et algorithmes sans changer le mot de passe de chaque utilisateur d'un coup.
Questions fréquemment posées
Argon2id est-il meilleur que bcrypt ?
Argon2id offre une dureté de mémoire configurable et est le choix privilégié d'OWASP pour les nouvelles implémentations de stockage de mot de passe.
PHP utilise-t-il Argon2id par défaut ?
Non. Le PASSWORD_DEFAULT de PHP sélectionne actuellement bcrypt. Utilisez PASSWORD_ARGON2ID explicitement lorsqu'il est supporté.
Puis-je migrer les hachages bcrypt sans réinitialisation de mot de passe ?
Oui. Vérifiez le hachage existant, puis re-hachez le mot de passe soumis après une connexion réussie.
Devrais-je stocker le sel séparément ?
Non. L'API de hachage de mot de passe PHP génère le sel et stocke les informations requises dans le hachage encodé.
SHA-256 est-il sécurisé pour les mots de passe ?
Pas par lui-même. Utilisez un algorithme de hachage adaptatif dédié plutôt que du SHA-256 brut.