PHPのuniqid()関数の使い方を徹底解説！一意なIDを生成する方法

PHPのuniqid()関数は、現在の時刻をマイクロ秒単位で取得し、それをもとに一意なID（ユニークな識別子）を生成する関数です。セッションIDやファイル名、トークンの生成など、さまざまな場面で活用できます。

基本構文

uniqid(prefix, more_entropy)

パラメータ

• prefix − 生成されるユニークIDの先頭に付加する接頭辞（プレフィックス）を指定します。省略可能です。

• more_entropy − 戻り値の末尾に追加のエントロピー（乱数要素）を付けるかどうかを指定します。trueを設定すると、より一意性の高いIDが生成され、戻り値は13文字＋小数点以下の文字列になります。

戻り値

uniqid()関数は、生成された一意な識別子を文字列（string）として返します。

使用例

以下は、uniqid()関数を使ってユニークIDを生成する基本的なサンプルコードです。

<?php
   echo uniqid();
?>

実行結果

上記コードを実行すると、次のような出力が得られます。

5bfd5bd045faa

補足：より一意性を高めるには

デフォルトでは時刻ベースのIDが生成されるため、同一マイクロ秒内に複数回呼び出すと同じIDが返される可能性があります。その場合は、第2引数のmore_entropyにtrueを指定することで、衝突のリスクを大幅に減らせます。

<?php
   echo uniqid('item_', true);
?>

このようにprefixと組み合わせれば、「item_5bfd5bd045faa1.23456789」のように用途がひと目でわかるIDを作成することも可能です。

注意点

uniqid()は便利ですが、時刻情報に基づいているため予測可能性があります。セキュリティが重要な場面（パスワードリセット用トークンなど）では、random_bytes()やbin2hex(random_bytes())など、暗号学的に安全な乱数生成関数を使用することを推奨します。