(PHP 5 >= 5.3.0, PHP 7, PHP 8)
openssl_random_pseudo_bytes — 疑似ランダムなバイト文字列を生成する
$length, bool &$strong_result = null): string
疑似ランダムなバイト文字列を生成します。長さは
length パラメータで指定します。
暗号学的に強いアルゴリズムを使って疑似乱数を生成したかどうかを知ることもできます。
オプションのパラメータ strong_result を使います。
これが false になることはまずないでしょうが、
古いシステムなどではそうなることもあります。
length
希望するバイト長。
2147483647 以下の正の整数でなければなりません。
PHP は、
このパラメータを非 null の整数値にキャストして利用します。
strong_result
これを渡しておくと、使ったアルゴリズムが暗号学的に強いものであるかどうかを表す
bool 値が格納されます。「強い」とは、
GPG やパスワードなどに使っても安全であるという意味です。強い場合は
true、そうでない場合は false となります。
成功した場合は指定したバイト長の string を返します。
openssl_random_pseudo_bytes() は、 失敗した場合に Exception をスローします。
| バージョン | 説明 |
|---|---|
| 8.0.0 |
strong_result は、nullable になりました。
|
| 7.4.0 |
この関数は、失敗時に false を返さなくなりました。
代わりに Exception
をスローするようになっています。
|
例1 openssl_random_pseudo_bytes() の例
<?php
for ($i = 1; $i <= 4; $i++) {
$bytes = openssl_random_pseudo_bytes($i, $cstrong);
$hex = bin2hex($bytes);
echo "Lengths: Bytes: $i and Hex: " . strlen($hex) . PHP_EOL;
var_dump($hex);
var_dump($cstrong);
echo PHP_EOL;
}
?>上の例の出力は、 たとえば以下のようになります。
Lengths: Bytes: 1 and Hex: 2 string(2) "42" bool(true) Lengths: Bytes: 2 and Hex: 4 string(4) "dc6e" bool(true) Lengths: Bytes: 3 and Hex: 6 string(6) "288591" bool(true) Lengths: Bytes: 4 and Hex: 8 string(8) "ab86d144" bool(true)