Method forFileAsync

php/src/vaas/Vaas.php:139–189

* Get the verdict for a File * @param string $path Path to the file * @param ForFileOptions|null $options Options for the request * @param Cancellation|null $cancellation Cancellation token * @return Future A future that resolves to a VaasVerdict * @throws VaasClientException The request is malformed or cannot be completed. Recommended actions: Don't repeat the request. Lo

(string $path, ?ForFileOptions $options = null, ?Cancellation $cancellation = null)

     * @throws VaasServerException The server encountered an internal error. Recommended actions: You may retry the request after a certain delay. If the problem persists contact G DATA.
     */
    public function forFileAsync(string $path, ?ForFileOptions $options = null, ?Cancellation $cancellation = null): Future
    {
        return async(function () use ($path, $options, $cancellation) {
            $this->logger->debug("Requesting verdict for file: $path");
			$filesystem = filesystem($options->filesystemDriver);

            if (!$filesystem->exists($path)) {
                $this->logger->error("File does not exist: $path");
                throw new VaasClientException('File does not exist');
            }

            $options = $options ?? ForFileOptions::fromVaasOptions($this->options);

            if ($options->useCache || $options->useHashLookup) {
                $forSha256Options = new ForSha256Options(
                    $options->useCache, $options->useHashLookup, $options->vaasRequestId);
                $sha256 = Sha256::TryFromFile($path)->await();
                $this->logger->debug("Check if file $path is already known by its SHA256: $sha256");
                try {
                    $response = $this->forSha256Async($sha256, $forSha256Options, $cancellation)->await();
                    $isVerdictWithoutDetection = ($response->verdict === 'Malicious' || $response->verdict === 'Pup') && !empty($response->detection);
                    if ($response->verdict !== 'Unknown' && !empty($response->fileType) && !empty($response->mimeType) && !$isVerdictWithoutDetection) {
                        $this->logger->debug("File $path is already known from cache or G DATA cloud by its SHA256: $sha256");
                        return $response;
                    }
                }
                catch (Exception $ex) {
                    $this->logger->debug("Something went wrong while checking the SHA256 of file $path: " . $ex->getMessage());
                }
            }

            try {
                $stream = $filesystem->openFile($path, 'r');
                $cancellation?->subscribe(function () use ($stream) { $stream->close(); });
                $forStreamOptions = new ForStreamOptions($options->useHashLookup, $options->timeout, $options->vaasRequestId);
                $this->logger->debug("Requesting verdict for $path as file stream");
                return $this->forStreamAsync($stream, filesize($path), $forStreamOptions)->await();
            } catch (FilesystemException  $ex) {
                $this->logger->error("Error opening file: $path");
                throw new VaasClientException('Error opening file (' . $path . '): ' . $ex->getMessage());
            } catch (Exception $ex){
                $this->logger->error("Error requesting verdict for file '$path': " . $ex->getMessage());
                throw $ex;
            }
            finally {
                if (isset($stream)) {
                    $stream->close();
                }
            }
        });
    }

    /**
     * Get the verdict for a stream