ImplementationOfAgentFinder.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\Setup;

use ILIAS\Refinery\Factory as Refinery;
use ILIAS\Data;

class ImplementationOfAgentFinder implements AgentFinder, \ILIAS\Component\EntryPoint
{
    protected array|AgentCollection $component_agents;

    public function __construct(
        protected Refinery $refinery,
        protected Data\Factory $data_factory,
        protected \ILIAS\Language\Language $lng,
        protected ImplementationOfInterfaceFinder $interface_finder,
        $component_agents
    ) {
        $this->component_agents = $component_agents;
    }

    public function getAgents(): AgentCollection
    {
        $agents = $this->getComponentAgents();

        // Get a list of existing plugins in the system.
        $plugins = $this->getPluginNames();

        foreach ($plugins as $plugin_name) {
            $agents = $agents->withAdditionalAgent(
                $plugin_name,
                $this->getPluginAgent($plugin_name)
            );
        }

        return $agents;
    }


    public function getComponentAgents(): AgentCollection
    {
        if ($this->component_agents instanceof AgentCollection) {
            return $this->component_agents;
        }

        $agents = new AgentCollection($this->refinery, []);

        foreach ($this->component_agents as $agent) {
            $agents = $agents->withAdditionalAgent(
                $this->getAgentNameByClassName(get_class($agent)),
                $agent
            );
        }

        $this->component_agents = $agents;
        return $this->component_agents;
    }

    public function getPluginAgent(string $name): Agent
    {
        // TODO: This seems to be something that rather belongs to Services/Component/
        // but we put it here anyway for the moment. This seems to be something that
        // could go away when we unify Services/Modules/Plugins to one common concept.
        $path = "[/]public/Customizing/global/plugins/.*/.*/" . $name . "/.*";
        $agent_classes = iterator_to_array($this->interface_finder->getMatchingClassNames(
            Agent::class,
            [],
            $path
        ));

        if ($agent_classes === []) {
            return new class ($name) extends \ilPluginDefaultAgent {
            };
        }

        $agents = [];
        foreach ($agent_classes as $class_name) {
            $agents[] = new $class_name(
                $this->refinery,
                $this->data_factory,
                $this->lng
            );
        }

        if (count($agents) === 1) {
            return $agents[0];
        }

        return new AgentCollection(
            $this->refinery,
            $agents
        );
    }

    public function getAgentByClassName(string $class_name): Agent
    {
        if (!class_exists($class_name)) {
            throw new \InvalidArgumentException("Class '" . $class_name . "' not found.");
        }

        return new $class_name(
            $this->refinery,
            $this->data_factory,
            $this->lng
        );
    }

    public function getAgentNameByClassName(string $class_name): string
    {
        // We assume that the name of an agent in the class ilXYZSetupAgent really
        // is XYZ. If that does not fit we just use the class name.
        $match = [];
        if (preg_match("/il(\w+)SetupAgent/", $class_name, $match)) {
            return strtolower($match[1]);
        }
        return $class_name;
    }

    protected function getPluginNames(): \Generator
    {
        $directories =
            new \RecursiveIteratorIterator(
                new \RecursiveDirectoryIterator(__DIR__ . "/../../../../public/Customizing/global/plugins")
            );
        $names = [];
        foreach ($directories as $dir) {
            $groups = [];
            if (preg_match("%^" . __DIR__ . "/[.][.]/[.][.]/[.][.]/[.][.]/public/Customizing/global/plugins/(Services|Modules)/((\\w+/){2})([^/\.]+)(/|$)%", (string) $dir, $groups)) {
                $name = $groups[4];
                if (isset($names[$name])) {
                    continue;
                }
                $names[$name] = true;
                yield $name;
            }
        }
    }

    public function getName(): string
    {
        return 'Agent Finder Adapter';
    }

    public function enter(): int
    {
        global $DIC;
        $DIC['setup.agentfinder'] = fn() => $this;
        return 0;
    }

}