sodium_crypto_stream()函式—用法及示例

函式名稱：sodium_crypto_stream()

適用版本：PHP 7.2.0 及以上版本

函式說明：sodium_crypto_stream() 函式用於生成加密強度的偽隨機位元組流。此函式使用加密庫 Sodium 提供的加密演算法。

用法：

sodium_crypto_stream(int $length, string $nonce, string $key): string|false

引數：

• $length：生成的位元組流的長度。
• $nonce：一個隨機的字串，用於生成唯一的加密流。必須是 8 位元組長。
• $key：加密金鑰。必須是 32 位元組長。

返回值：

• 如果成功生成了位元組流，則返回一個字串。
• 如果生成位元組流失敗，則返回 false。

示例：

$length = 1024;
$nonce = random_bytes(SODIUM_CRYPTO_STREAM_NONCEBYTES);
$key = random_bytes(SODIUM_CRYPTO_STREAM_KEYBYTES);

$stream = sodium_crypto_stream($length, $nonce, $key);

if ($stream !== false) {
    echo "生成的位元組流： " . bin2hex($stream);
} else {
    echo "生成位元組流失敗";
}

注意事項：

• 生成的位元組流是偽隨機的，但是在給定相同的 nonce 和 key 的情況下，將始終生成相同的位元組流。
• nonce 必須是唯一的，每次生成位元組流時都應該使用不同的 nonce。
• key 必須是保密的，不應該被洩露。
• 生成的位元組流可以用於加密和解密資料，也可以用於生成隨機的初始化向量等。
• 在使用此函式前，確保已經正確安裝並啟用了 Sodium 加密庫。