sodium_crypto_aead_xchacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt — (Предпочтительно) Проверяет, затем расшифровывает алгоритмом XChaCha20-Poly1305

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt(
    string $ciphertext,
    string $additional_data,
    string $nonce,
    #[\SensitiveParameter] string $key
): string|false

(Предпочтительно) Функция проверяет, затем расшифровывает алгоритмом XChaCha20-Poly1305

Как правило, алгоритм XChaCha20-Poly1305 — лучший из имеющихся режимов AEAD.

ciphertext: Параметр принимает значение в формате, который предоставила функция sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() (зашифрованный текст и тег, объединённые).
additional_data: Дополнительные проверенные данные. Функция использует значение при проверке тега подлинности, который добавили к зашифрованному тексту, но не шифрует и не сохраняет в зашифрованном тексте.
nonce: Номер, который необходимо использовать только один раз для каждого сообщения. Длина 24 байта. Это достаточно большая граница, чтобы генерировать её случайным образом (то есть функцией random_bytes()).
key: Ключ шифрования (256 битов).

В случае успешного выполнения функция возвращает текст или false, если возникла ошибка.