[函数]sodium_crypto_stream_xchacha20_xor()函数—用法及示例

函数名称：sodium_crypto_stream_xchacha20_xor() 

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

函数描述：该函数用于生成一个XChaCha20流加密的密文，通过将明文与密钥进行异或运算来实现加密。

用法：

string sodium_crypto_stream_xchacha20_xor(string $message, string $nonce, string $key)

参数：

• $message: 要加密的明文字符串。
• $nonce: 用于加密的随机字符串，长度应为8字节。
• $key: 用于加密的密钥字符串，长度应为32字节。

返回值：

• 返回一个加密后的密文字符串。

示例：

$message = "Hello, world!";
$nonce = random_bytes(SODIUM_CRYPTO_STREAM_XCHACHA20_NONCEBYTES);
$key = random_bytes(SODIUM_CRYPTO_STREAM_XCHACHA20_KEYBYTES);

$ciphertext = sodium_crypto_stream_xchacha20_xor($message, $nonce, $key);

echo "明文: " . $message . PHP_EOL;
echo "密文: " . bin2hex($ciphertext) . PHP_EOL;

注意事项：

• $nonce和$key参数应该是具有足够的随机性和熵的字符串，可以使用random_bytes()函数生成。
• $nonce的长度必须为8字节，可以使用SODIUM_CRYPTO_STREAM_XCHACHA20_NONCEBYTES常量获取。
• $key的长度必须为32字节，可以使用SODIUM_CRYPTO_STREAM_XCHACHA20_KEYBYTES常量获取。
• 密文是以二进制形式返回的，可以使用bin2hex()函数将其转换为十六进制字符串进行展示。
• 在解密时，必须使用相同的$nonce和$key参数才能正确还原明文。