無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

uniqid

(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 文字までではなくなりました。