PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    gmp_random

    (PHP 4 >= 4.0.4, PHP 5, PHP 7)

    gmp_random — 乱数を生成する

    警告

    この関数は PHP 7.2.0 で 非推奨 になり、PHP 8.0.0 で 削除 されました。この関数に頼らないことを強く推奨します。

    説明

    gmp_random(int $limiter = 20): GMP

    乱数を生成します。乱数の範囲は 0 と (2 ** n) - 1 の間です。 n は limb * limiter のビット数になります。 limiter が負の場合、負の値が生成されます。

    limb は GMP の内部機構です。limb のビット数は固定ではなく、 システムによって変化します。一般的には limb は 16 あるいは 32 ビットですが、それが保証されているわけではありません。

    警告

    この関数が生成する値は、暗号学的にセキュアではありません。そのため、これを暗号や、戻り値を推測できないことが必須の値として使っては いけません。

    暗号学的にセキュアな乱数が必要な場合は、Random\Randomizer を Random\Engine\Secure と一緒に使いましょう。簡単なユースケースの場合、random_int() と random_bytes() 関数が、オペレーティングシステムの CSPRNG を使った、 便利で安全な API を提供します。

    パラメータ

    limiter

    リミッタ。

    GMP オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。

    戻り値

    ランダムな GMP 数を返します。

    例

    例1 gmp_random() の例

    <?php
    $rand1     = gmp_random(1); // 0 から 1 * limb のビット数までの間の乱数
    $rand2 = gmp_random(2); // 0 から 2 * limb のビット数までの間の乱数

    echo gmp_strval($rand1) . "\n";
    echo     gmp_strval($rand2) . "\n";
    ?>

    上の例の出力は以下となります。

    1915834968
8642564075890328087

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    1
    asphp at dsgml dot com
    8 years ago
    Warning: Do not use this function.

    Use gmp_random_bits() or gmp_random_range() instead.

    The documentation and the code for this function do NOT match, and in any case this function is quite useless.
    ＋add a note
    To Top