説明
wp_generate_uuid4() は、UUID(バージョン4)を生成する関数です。
基本構文
wp_generate_uuid4(): string
引数
引数はありません。
戻り値
UUIDの文字列。
使い方(サンプル)
$uuid = wp_generate_uuid4();
注意点
- ランダムな識別子を生成するときに使います。
実務での使いどころ
- データベースに保存する、ランダムな識別子を、作るとき。
- ファイル名や、外部システムとの連携で、重複しない文字列が必要なとき。
よくあるミスと対処
- 並び順に、使えると考えている。UUID(v4)は、ランダムで、順序を持たない。
- UUID v4 は、WordPress 6.9以前では、暗号論的に安全でない乱数から作られる。推測されたくないトークンには、
wp_generate_password()などを使う。 - HTMLの
id属性だけが、目的で、使っている。その場合は、wp_unique_id()で十分。
NG例
$id = wp_generate_uuid4(); // 時刻順に並ぶと思っている
OK例
$token = wp_generate_uuid4();
update_option( 'my_job_id', $token );
使い分け早見表
| 関数 | 特徴 |
|---|---|
wp_generate_uuid4() |
ランダムなUUID(v4) |
wp_unique_id() |
そのリクエストの中で、一意な文字列 |
wp_generate_password() |
ランダムなパスワード |
関連項目
wp_unique_id()、wp_generate_password()
公式リファレンス:wp_generate_uuid4() | Function | WordPress Developer Resources

コメント