ParagonIE_Sodium_File::secretbox( string $inputFile, string $outputFile, string $nonce, string $key ): bool

465    public static function secretbox(466        $inputFile,467        $outputFile,468        $nonce,469        #[\SensitiveParameter]470        $key471    ) {472        /* Type checks: */473        if (!is_string($inputFile)) {474            throw new TypeError('Argument 1 must be a string, ' . gettype($inputFile) . ' given..');475        }476        if (!is_string($outputFile)) {477            throw new TypeError('Argument 2 must be a string, ' . gettype($outputFile) . ' given.');478        }479        if (!is_string($nonce)) {480            throw new TypeError('Argument 3 must be a string, ' . gettype($nonce) . ' given.');481        }482 483        /* Input validation: */484        if (self::strlen($nonce) !== ParagonIE_Sodium_Compat::CRYPTO_SECRETBOX_NONCEBYTES) {485            throw new TypeError('Argument 3 must be CRYPTO_SECRETBOX_NONCEBYTES bytes');486        }487        if (!is_string($key)) {488            throw new TypeError('Argument 4 must be a string, ' . gettype($key) . ' given.');489        }490        if (self::strlen($key) !== ParagonIE_Sodium_Compat::CRYPTO_SECRETBOX_KEYBYTES) {491            throw new TypeError('Argument 4 must be CRYPTO_SECRETBOX_KEYBYTES bytes');492        }493 494        if (!file_exists($inputFile)) {495            throw new SodiumException('Input file does not exist');496        }497        /** @var int $size */498        $size = filesize($inputFile);499        if (!is_int($size)) {500            throw new SodiumException('Could not obtain the file size');501        }502 503        /** @var resource $ifp */504        $ifp = @fopen($inputFile, 'rb');505        if (!is_resource($ifp)) {506            throw new SodiumException('Could not open input file for reading');507        }508 509        /** @var resource $ofp */510        $ofp = fopen($outputFile, 'wb');511        if (!is_resource($ofp)) {512            fclose($ifp);513            throw new SodiumException('Could not open output file for writing');514        }515 516        $res = self::secretbox_encrypt($ifp, $ofp, $size, $nonce, $key);517        fclose($ifp);518        fclose($ofp);519        return $res;520    }