uniqid
(PHP 4, PHP 5)
uniqid — Génère un identifiant unique
Description
Génère un identifiant unique basé sur la date et heure courante en microsecondes.
Liste de paramètres
- prefix
-
Peut être utile pour identifier facilement différents hôtes, si vous générez simultanément des fichiers depuis plusieurs hôtes, à la même micro-seconde.
Sans prefix (préfixe vide), la chaîne retournée fera 13 caractères. Si more_entropy est à TRUE, elle fera 23 caractères.
- more_entropy
-
Si le paramètre optionnel more_entropy est TRUE, uniqid() ajoutera une entropie "combined LCG" à la fin de la valeur retournée, ce qui renforcera encore l'unicité de l'identifiant.
Valeurs de retour
Retourne un identifiant unique, sous la forme d'une chaîne de caractères.
Exemples
Si vous voulez utiliser un identifiant unique, ou bien gérer des cookies, il est recommandé d'utiliser un code tel que celui-ci :
Ceci va créer un identifiant de 32 caractères (un nombre hexadécimal de 128) qui sera très difficile à prédire.
Example#1 Exemple avec uniqid()
<?php
// Aucun préfixe
// fonctionne uniquement avec PHP 5 et suivants
$token = md5(uniqid());
// meilleur, difficile à deviner
$better_token = md5(uniqid(rand(), true));
?>
Historique
| Version | Description |
|---|---|
| 5.0.0 | Le paramètre prefix est devenu optionnel. |
| 4.3.1 | La limite de 114 caractères de long pour le paramètre prefix a été augmentée. |