sodium_crypto_secretstream_xchacha20poly1305_init_pull

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretstream_xchacha20poly1305_init_pull復号のためのシークレットストリームのコンテキストを初期化する

説明

sodium_crypto_secretstream_xchacha20poly1305_init_pull(string $header, string $key): string

復号のためのシークレットストリームのコンテキストを初期化します。

パラメータ

header

シークレットストリームのヘッダ。 これは、 sodium_crypto_secretstream_xchacha20poly1305_init_push() が生成する値のうちの一つを指定しなければいけません。

key

暗号化キー(256ビット)

戻り値

シークレットストリームのステートを返します。

例1 sodium_crypto_secretstream_xchacha20poly1305_init_pull() の例

<?php
function decrypt_file(string $inputFilePathstring $outputFilePathstring $key): void
{
    
$inputFile fopen($inputFilePath'rb');
    
$outputFile fopen($outputFilePath'wb');
    
$header fread($inputFile24);

    
$state sodium_crypto_secretstream_xchacha20poly1305_init_pull($header$key);
    
$inputFileSize fstat($inputFile)['size'];

    
// Decrypt the file and write its contents to the output file:
    
for ($i 24$i $inputFileSize$i += 8192) {
        
$ctxt_chunk fread($inputFile8192);

        
// We're not using $tag, but in real protocols you can use this on encrypt to e.g.
        // trigger a re-key or indicate the end of file. Then, on decrypt, you can assert
        // this behavior.
        
[$ptxt_chunk$tag] = sodium_crypto_secretstream_xchacha20poly1305_pull($state$ctxt_chunk);
        
fwrite($outputFile$ptxt_chunk);
    }

    
sodium_memzero($state);
    
fclose($inputFile);
    
fclose($outputFile);
}

// sodium_crypto_secretstream_xchacha20poly1305_keygen()
$key sodium_base642bin('MS0lzb7HC+thY6jY01pkTE/cwsQxnRq0/2L1eL4Hxn8='SODIUM_BASE64_VARIANT_ORIGINAL);

$example sodium_hex2bin('971e33b255f0990ef3931caf761c59136efa77b434832f28ec719e3ff73f5aec38b3bba1574ab5b70a8844d8da36a668e802cfea2c');
file_put_contents('hello.enc'$example);
decrypt_file('hello.enc''hello.txt.decrypted'$key);
var_dump(file_get_contents('hello.txt.decrypted'));
?>

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

string(12) "Hello world!"
関連キーワード:  ストリーム, 復号, コンテキスト, 初期, sodium, crypto, init, poly, xchacha, secretstream