wp_generate_uuid4() の使い方|説明・引数・注意点

説明

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

コメント

タイトルとURLをコピーしました