wp_rand() の使い方｜説明・引数・注意点

説明

基本構文

wp_rand( int $min = null, int $max = null ): int

引数

• $min：最小値
• $max：最大値

戻り値

乱数。

使い方（サンプル）

$n = wp_rand( 1, 10 );

注意点

• PHPの rand() より安全な乱数を使います。

実務での使いどころ

• ランダムな整数が、必要なとき（抽選、並び替えなど）。
• 推測されにくい、乱数が必要なとき。

よくあるミスと対処

• rand()・mt_rand() を使っている。セキュリティに関わる用途には、向かない。
• 範囲を指定せずに使い、想定外の大きな値が返る。$min・$max で、範囲を指定する。
• 文字列のトークンが欲しいのに、使っている。トークンは、wp_generate_password() などを使う。

NG例

$n = mt_rand( 1, 100 ); // セキュリティ用途には向かない

OK例

$n = wp_rand( 1, 100 );

使い分け早見表

関連項目

wp_generate_password()

公式リファレンス：wp_rand() | Function | WordPress Developer Resources