sodium_crypto_secretstream_xchacha20poly1305_init_push()函式—用法及示例

函式名：sodium_crypto_secretstream_xchacha20poly1305_init_push()

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

用法：該函式用於初始化一個加密流，使用 XChaCha20-Poly1305 演算法進行加密。它返回一個加密流的狀態物件。

語法：sodium_crypto_secretstream_xchacha20poly1305_init_push(string $key): string

引數：

• $key: 加密流的金鑰，必須是32位元組的二進位制字串。

返回值：一個加密流的狀態物件，是一個16位元組的二進位制字串。

示例：

$key = sodium_crypto_secretstream_xchacha20poly1305_keygen(); // 生成一個32位元組的金鑰

$state = sodium_crypto_secretstream_xchacha20poly1305_init_push($key); // 初始化加密流

// 將加密流狀態物件儲存到檔案或傳送給接收方
file_put_contents('state.bin', $state);

注意事項：

• 金鑰必須是32位元組的二進位制字串，可以使用 sodium_crypto_secretstream_xchacha20poly1305_keygen() 生成。
• 加密流狀態物件需要儲存起來，以便在後續的加密和解密過程中使用。可以將其儲存到檔案或傳送給接收方。
• 加密流的狀態物件只能用於一個傳送者和一個接收者之間的通訊。如果有多個傳送者或接收者，需要為每個傳送者/接收者對建立一個狀態物件。
• 加密流的初始化只需要在通訊開始時進行一次，後續的加密和解密操作可以重複使用同一個狀態物件。
• 加密流的初始化過程是單向的，即傳送者使用 sodium_crypto_secretstream_xchacha20poly1305_init_push() 初始化加密流，接收者使用 sodium_crypto_secretstream_xchacha20poly1305_init_pull() 初始化解密流。

更多資訊和示例程式碼可以參考 PHP 手冊：https://www.php.net/manual/en/function.sodium-crypto-secretstream-xchacha20poly1305-init-push.php