uniqid

(PHP 3, PHP 4, PHP 5)

uniqid -- 一意な ID を生成する

説明

string uniqid ( [string prefix [, bool more_entropy]] )

マイクロ秒単位の現在時刻にもとづいた、接頭辞つきの一意な ID を取得します。

パラメータ

prefix

これが有用なのは、たとえば複数ホストで同時に ID を生成するような場合です。このような場合、同じマイクロ秒で同じ ID が生成されてしまう可能性があります。

空の prefix を指定すると、 返される文字列は 13 文字となります。 more_entropyTRUE の場合は 23 文字となります。

more_entropy

TRUE にすると、uniqid() は 返り値の最後にさらに別のエントロピーを (線形合同法を使用して) 追加します。これにより、結果がより一意になります。

返り値

一意な識別子を文字列で返します。

一意な ID またはトークンが必要な場合、そして、ネットワーク経由で ユーザにそのトークンを渡そうとする場合(例えば、セッションクッキー)、 次の例のようにするのが推奨されます。

この例は、極めて予測困難な 32 文字の ID(128 ビット十六進数) を作成します。

例 1. uniqid() の例

<?php
// 接頭辞なし
// PHP 5 以降でのみ動作します
$token = md5(uniqid());

// よりよい、推測しにくい方法
$better_token = md5(uniqid(rand(), true));
?>

変更履歴

バージョン説明
5.0.0 パラメータ prefix が必須ではなくなりました。
4.3.1 prefix の制限が 114 文字までではなくなりました。