ParagonIE_Sodium_File::box_open( string $inputFile, string $outputFile, string $nonce, string $keypair ): bool

99    public static function box_open(100        $inputFile,101        $outputFile,102        $nonce,103        #[\SensitiveParameter]104        $keypair105    ) {106        /* Type checks: */107        if (!is_string($inputFile)) {108            throw new TypeError('Argument 1 must be a string, ' . gettype($inputFile) . ' given.');109        }110        if (!is_string($outputFile)) {111            throw new TypeError('Argument 2 must be a string, ' . gettype($outputFile) . ' given.');112        }113        if (!is_string($nonce)) {114            throw new TypeError('Argument 3 must be a string, ' . gettype($nonce) . ' given.');115        }116        if (!is_string($keypair)) {117            throw new TypeError('Argument 4 must be a string, ' . gettype($keypair) . ' given.');118        }119 120        /* Input validation: */121        if (self::strlen($nonce) !== ParagonIE_Sodium_Compat::CRYPTO_BOX_NONCEBYTES) {122            throw new TypeError('Argument 4 must be CRYPTO_BOX_NONCEBYTES bytes');123        }124        if (self::strlen($keypair) !== ParagonIE_Sodium_Compat::CRYPTO_BOX_KEYPAIRBYTES) {125            throw new TypeError('Argument 4 must be CRYPTO_BOX_KEYPAIRBYTES bytes');126        }127 128        if (!file_exists($inputFile)) {129            throw new SodiumException('Input file does not exist');130        }131        /** @var int $size */132        $size = filesize($inputFile);133        if (!is_int($size)) {134            throw new SodiumException('Could not obtain the file size');135        }136 137        /** @var resource $ifp */138        $ifp = fopen($inputFile, 'rb');139        if (!is_resource($ifp)) {140            throw new SodiumException('Could not open input file for reading');141        }142 143        /** @var resource $ofp */144        $ofp = @fopen($outputFile, 'wb');145        if (!is_resource($ofp)) {146            fclose($ifp);147            throw new SodiumException('Could not open output file for writing');148        }149 150        $res = self::box_decrypt($ifp, $ofp, $size, $nonce, $keypair);151        fclose($ifp);152        fclose($ofp);153        try {154            ParagonIE_Sodium_Compat::memzero($nonce);155            ParagonIE_Sodium_Compat::memzero($ephKeypair);156        } catch (SodiumException $ex) {157            if (isset($ephKeypair)) {158                unset($ephKeypair);159            }160        }161        return $res;162    }