array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.sodium-crypto-aead-aes256gcm-encrypt.php', 1 => 'sodium_crypto_aead_aes256gcm_encrypt', 2 => '使用 AES-256-GCM 加密并认证', ), 'up' => array ( 0 => 'ref.sodium.php', 1 => 'Sodium 函数', ), 'prev' => array ( 0 => 'function.sodium-crypto-aead-aes256gcm-decrypt.php', 1 => 'sodium_crypto_aead_aes256gcm_decrypt', ), 'next' => array ( 0 => 'function.sodium-crypto-aead-aes256gcm-is-available.php', 1 => 'sodium_crypto_aead_aes256gcm_is_available', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/sodium/functions/sodium-crypto-aead-aes256gcm-encrypt.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sodium_crypto_aead_aes256gcm_encrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_aes256gcm_encrypt — 使用 AES-256-GCM 加密并认证

说明

function sodium_crypto_aead_aes256gcm_encrypt(
    #[\SensitiveParameter] string $message,
    string $additional_data,
    string $nonce,
    #[\SensitiveParameter] string $key
): string

使用 AES-256-GCM 先加密再认证。仅当 sodium_crypto_aead_aes256gcm_is_available() 返回 true 时可用。

参数

message: 要加密的明文消息。
additional_data: 经过认证的附加数据。它用于验证追加到密文的认证标签，但不会被加密，也不会存储在密文中。
nonce: 每条消息只能使用一次的数字，长度为 12 字节。
key: 加密密钥（256 位）。

返回值

以原始二进制字节字符串返回密文和认证标签（格式：先是密文，然后是标签）。

更新日志

版本	说明
8.4.0	此函数现在也在 aarch64 上定义。以前仅在 x86 和 x86_64 上定义。