ParagonIE_Sodium_File

9class ParagonIE_Sodium_File extends ParagonIE_Sodium_Core_Util10{11    /* PHP's default buffer size is 8192 for fread()/fwrite(). */12    const BUFFER_SIZE = 8192;13 14    /**15     * Box a file (rather than a string). Uses less memory than16     * ParagonIE_Sodium_Compat::crypto_box(), but produces17     * the same result.18     *19     * @param string $inputFile  Absolute path to a file on the filesystem20     * @param string $outputFile Absolute path to a file on the filesystem21     * @param string $nonce      Number to be used only once22     * @param string $keyPair    ECDH secret key and ECDH public key concatenated23     *24     * @return bool25     * @throws SodiumException26     * @throws TypeError27     */28    public static function box(29        $inputFile,30        $outputFile,31        $nonce,32        #[\SensitiveParameter]33        $keyPair34    ) {35        /* Type checks: */36        if (!is_string($inputFile)) {37            throw new TypeError('Argument 1 must be a string, ' . gettype($inputFile) . ' given.');38        }39        if (!is_string($outputFile)) {40            throw new TypeError('Argument 2 must be a string, ' . gettype($outputFile) . ' given.');41        }42        if (!is_string($nonce)) {43            throw new TypeError('Argument 3 must be a string, ' . gettype($nonce) . ' given.');44        }45 46        /* Input validation: */47        if (!is_string($keyPair)) {48            throw new TypeError('Argument 4 must be a string, ' . gettype($keyPair) . ' given.');49        }50        if (self::strlen($nonce) !== ParagonIE_Sodium_Compat::CRYPTO_BOX_NONCEBYTES) {51            throw new TypeError('Argument 3 must be CRYPTO_BOX_NONCEBYTES bytes');52        }53        if (self::strlen($keyPair) !== ParagonIE_Sodium_Compat::CRYPTO_BOX_KEYPAIRBYTES) {54            throw new TypeError('Argument 4 must be CRYPTO_BOX_KEYPAIRBYTES bytes');55        }56 57        /** @var int $size */58        $size = filesize($inputFile);59        if (!is_int($size)) {60            throw new SodiumException('Could not obtain the file size');61        }62 63        /** @var resource $ifp */64        $ifp = fopen($inputFile, 'rb');65        if (!is_resource($ifp)) {66            throw new SodiumException('Could not open input file for reading');67        }68 69        /** @var resource $ofp */70        $ofp = fopen($outputFile, 'wb');71        if (!is_resource($ofp)) {72            fclose($ifp);73            throw new SodiumException('Could not open output file for writing');74        }75 76        $res = self::box_encrypt($ifp, $ofp, $size, $nonce, $keyPair);77        fclose($ifp);78        fclose($ofp);79        return $res;80    }81 82    /**83     * Open a boxed file (rather than a string). Uses less memory than84     * ParagonIE_Sodium_Compat::crypto_box_open(), but produces85     * the same result.86     *87     * Warning: Does not protect against TOCTOU attacks. You should88     * just load the file into memory and use crypto_box_open() if