sodium_crypto_secretbox で使うランダムな鍵を生成する

# sodium_crypto_secretbox_keygen

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretbox_keygen — sodium_crypto_secretbox で使うランダムな鍵を生成する

### 説明

function sodium_crypto_secretbox_keygen(): string

sodium_crypto_secretbox() と sodium_crypto_secretbox_open() で使うための鍵を生成します。

### パラメータ

この関数にはパラメータはありません。

### 戻り値

暗号学的にセキュアな、ランダムなバイト列を生成し、文字列で返します。

### 例

例1 sodium_crypto_secretbox_keygen() の例

    <?php
    $key = sodium_crypto_secretbox_keygen();
    var_dump( sodium_bin2hex( $key ) );
    ?>

上の例の出力は、 たとえば以下のようになります。

    string(64) "88bd1dc51ec81984f3ddc5a8f59a3d95b647e2da3e879f1b9ceb0abd89e7286c"

例2 sodium_crypto_secretbox_keygen() と random_bytes() の比較

    <?php
    $key = sodium_crypto_secretbox_keygen();
    $bytes = random_bytes( SODIUM_CRYPTO_SECRETBOX_KEYBYTES );
    var_dump( mb_strlen( $key, '8bit' ) === mb_strlen( $bytes, '8bit' ) );
    ?>

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

    bool(true)

### 参考

- sodium_bin2hex() - 16進数にエンコードする
- random_bytes() - 暗号学的にセキュアな、ランダムなバイト列を生成する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open