ParagonIE_Sodium_Compat::crypto_aead_aes256gcm_encrypt( string $plaintext = '', string $assocData = '', string $nonce = '', string $key = '' ): string

654    public static function crypto_aead_aes256gcm_encrypt(655        #[\SensitiveParameter]656        $plaintext = '',657        $assocData = '',658        $nonce = '',659        #[\SensitiveParameter]660        $key = ''661    ) {662        if (!self::crypto_aead_aes256gcm_is_available()) {663            throw new SodiumException('AES-256-GCM is not available');664        }665        ParagonIE_Sodium_Core_Util::declareScalarType($plaintext, 'string', 1);666        ParagonIE_Sodium_Core_Util::declareScalarType($assocData, 'string', 2);667        ParagonIE_Sodium_Core_Util::declareScalarType($nonce, 'string', 3);668        ParagonIE_Sodium_Core_Util::declareScalarType($key, 'string', 4);669 670        /* Input validation: */671        if (ParagonIE_Sodium_Core_Util::strlen($nonce) !== self::CRYPTO_AEAD_AES256GCM_NPUBBYTES) {672            throw new SodiumException('Nonce must be CRYPTO_AEAD_AES256GCM_NPUBBYTES long');673        }674        if (ParagonIE_Sodium_Core_Util::strlen($key) !== self::CRYPTO_AEAD_AES256GCM_KEYBYTES) {675            throw new SodiumException('Key must be CRYPTO_AEAD_AES256GCM_KEYBYTES long');676        }677 678        if (!is_callable('openssl_encrypt')) {679            throw new SodiumException('The OpenSSL extension is not installed, or openssl_encrypt() is not available');680        }681 682        $authTag = '';683        $ciphertext = openssl_encrypt(684            $plaintext,685            'aes-256-gcm',686            $key,687            OPENSSL_RAW_DATA,688            $nonce,689            $authTag,690            $assocData691        );692        return $ciphertext . $authTag;693    }