PHP 8.1.0 RC 4 available for testing


(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt(Preferred) Verify then decrypt with XChaCha20-Poly1305


    string $ciphertext,
    string $additional_data,
    string $nonce,
    string $key
): string|false

Verify then decrypt with ChaCha20-Poly1305 (eXtended-nonce variant).

Generally, XChaCha20-Poly1305 is the best of the provided AEAD modes to use.

Liste de param├Ętres


Must be in the format provided by sodium_crypto_aead_chacha20poly1305_ietf_encrypt() (ciphertext and tag, concatenated).


Additional, authenticated data. This is used in the verification of the authentication tag appended to the ciphertext, but it is not encrypted or stored in the ciphertext.


A number that must be only used once, per message. 24 bytes long. This is a large enough bound to generate randomly (i.e. random_bytes()).


Encryption key (256-bit).

Valeurs de retour

Returns the plaintext on success, ou false si une erreur survient.

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top