sodium_crypto_secretstream_xchacha20poly1305_init_pull()函式—用法及示例

函式：sodium_crypto_secretstream_xchacha20poly1305_init_pull()

適用版本：PHP 7.2.0+

用法： sodium_crypto_secretstream_xchacha20poly1305_init_pull(string $header, string $key): string|false

引數：

• $header：一個包含加密的流的頭部資訊的字串。這個頭部資訊必須是透過sodium_crypto_secretstream_xchacha20poly1305_init_push()函式生成的。
• $key：一個32位元組的金鑰字串，用於解密流。

返回值：

• 成功時，返回一個字串，代表一個解密的流物件。
• 失敗時，返回false。

示例：

<?php
$encryptedHeader = '...'; // 加密流的頭部資訊
$secretKey = '...'; // 金鑰

$stream = sodium_crypto_secretstream_xchacha20poly1305_init_pull($encryptedHeader, $secretKey);
if ($stream === false) {
    die('初始化解密流失敗');
}

// 解密流的進一步操作
?>

注意事項：

• 在使用該函式之前，必須確保已經正確載入了libsodium擴充套件。
• 使用該函式之前，需要先使用sodium_crypto_secretstream_xchacha20poly1305_init_push()函式生成加密流的頭部資訊。
• 金鑰必須是一個32位元組的字串，可以使用sodium_crypto_secretstream_xchacha20poly1305_keygen()函式生成一個隨機的金鑰。
• 返回的流物件可以用於後續的解密操作，比如sodium_crypto_secretstream_xchacha20poly1305_pull()函式來解密具體的資料塊。