OAuthProvider::generateToken

(PECL OAuth >= 1.0.0)

OAuthProvider::generateToken — Génère un jeton aléatoire

Description

final public static function OAuthProvider::generateToken(int $size, bool $strong = false): string

Génère une chaîne de caractères d'octets pseudo-aléatoires.

Liste de paramètres

size
La longueur désirée du jeton, en octets.
strong
Définit à true, signifie que /dev/random sera utilisé, sinon, ce sera /dev/urandom. Ce paramètre est ignoré sous Windows.

Valeurs de retour

Le jeton généré, sous la forme d'une chaîne de caractères d'octets.

Erreurs / Exceptions

Si le paramètre strong vaut true, alors, une alerte de niveau E_WARNING sera émise lorsque l'implémentation de repli rand() est utilisée pour compléter les octets aléatoires manquants (c.-à-d., lorsqu'il n'y a pas assez de données aléatoires initialement).

Exemples

Exemple #1 Exemple avec OAuthProvider::generateToken()

<?php
$p = new OAuthProvider();

$t = $p->generateToken(4);

echo strlen($t),  PHP_EOL;
echo bin2hex($t), PHP_EOL;

?>

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

4
b6a82c27

Notes

Note: Lorsqu'il n'y a pas assez de données aléatoires de disponibles sur le système, cette fonction complètera les octets manquants en utilisant la fonction PHP interne rand().

Voir aussi

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes 1 note

up
0
carlosouza at me dot com
14 years ago
Be careful when setting the 'strong' parameter to true.

If you system doesn't have enough entropy your script will block which can cause timeouts in other parts of your code.

In my case, the most serious symptom was my script blocking when trying to read from /dev/random and causing a 'MySQL has gone away' error.

Hopefully this saves someone the trouble when deciding to use /dev/random entropy
＋add a note