openssl_random_pseudo_bytes
疑似ランダムなバイト文字列を生成する
&reftitle.description;
stringopenssl_random_pseudo_bytes
intlength
boolstrong_result&null;
疑似ランダムなバイト文字列を生成します。長さは
length パラメータで指定します。
暗号学的に強いアルゴリズムを使って疑似乱数を生成したかどうかを知ることもできます。
オプションのパラメータ strong_result を使います。
これが &false; になることはまずないでしょうが、
古いシステムなどではそうなることもあります。
&reftitle.parameters;
length
希望するバイト長。
2147483647 以下の正の整数でなければなりません。
PHP は、
このパラメータを非 null の整数値にキャストして利用します。
strong_result
これを渡しておくと、使ったアルゴリズムが暗号学的に強いものであるかどうかを表す
bool 値が格納されます。「強い」とは、
GPG やパスワードなどに使っても安全であるという意味です。強い場合は
&true;、そうでない場合は &false; となります。
&reftitle.returnvalues;
成功した場合は指定したバイト長の &string; を返します。
&reftitle.errors;
openssl_random_pseudo_bytes は、
失敗した場合に Exception をスローします。
&reftitle.changelog;
&Version;
&Description;
8.0.0
strong_result は、nullable になりました。
7.4.0
この関数は、失敗時に &false; を返さなくなりました。
代わりに Exception
をスローするようになっています。
&reftitle.examples;
openssl_random_pseudo_bytes の例
]]>
&example.outputs.similar;
&reftitle.seealso;
random_bytes
bin2hex
crypt
random_int