Crawler.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\Services\WOPI\Discovery;

use ILIAS\Data\URI;

class Crawler
{
    private const XPATH = '/wopi-discovery/net-zone/app';
    private array $crawl_actions = [];
    private ?string $content = null;
    private ?\SimpleXMLElement $discovery = null;
    private ?array $xml_app_elements = null;

    public function __construct()
    {
        $this->crawl_actions = [
            ActionTarget::VIEW->value,
            ActionTarget::EMBED_VIEW->value,
            ActionTarget::EDIT->value,
            ActionTarget::EMBED_EDIT->value,
            ActionTarget::CONVERT->value,
        ];
    }

    public function validate(URI $discovery_url): bool
    {
        try {
            $this->content = file_get_contents((string) $discovery_url) ?: null;
            if ($this->content === null) {
                return false;
            }

            $this->discovery = simplexml_load_string($this->content) ?: null;
            if ($this->discovery === null) {
                return false;
            }
            $this->xml_app_elements = $this->discovery->xpath(self::XPATH);

            return is_array($this->xml_app_elements);
        } catch (\Throwable $t) {
            return false;
        }
    }

    public function crawl(URI $discovery_url): ?Apps
    {
        if (!$this->validate($discovery_url)) {
            return null;
        }

        // read wopi-discovery XML from $discovery_url and parse Apps with it's Actions
        $apps = [];
        foreach ($this->xml_app_elements as $app) {
            $actions = [];
            foreach ($app->action as $action) {
                $action_name = $action['name'] ?? null;
                $action_ext = $action['ext'] ?? null;
                $action_urlsrc = $action['urlsrc'] ?? null;
                $target_text = isset($action['targetext']) ? (string) $action['targetext'] : null;
                if (!$action_name instanceof \SimpleXMLElement) {
                    continue;
                }
                if (!$action_ext instanceof \SimpleXMLElement) {
                    continue;
                }
                if (!$action_urlsrc instanceof \SimpleXMLElement) {
                    continue;
                }

                if (!in_array((string) $action_name, $this->crawl_actions, true)) {
                    continue;
                }

                $uri_string = rtrim((string) $action_urlsrc, '?');
                // remove all after ?
                $uri = explode('?', $uri_string);
                $uri_string = $uri[0];
                $actions[] = new Action(
                    0,
                    (string) $action_name,
                    (string) $action_ext,
                    new URI($uri_string),
                    $uri[1] ?? null,
                    $target_text
                );
            }
            if ($actions === []) {
                continue;
            }

            $app_name = $app['name'] ?? null;
            if ($app_name === null) {
                continue;
            }
            $app_fav_icon_url = $app['favIconUrl'] ?? null;
            $apps[] = new App(
                0,
                (string) $app_name,
                $actions,
                $app_fav_icon_url === null ? null : new URI((string) $app_fav_icon_url)
            );
        }
        return new Apps($apps);
    }
}