AbstractOfFinder.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\Setup;

abstract class AbstractOfFinder
{
    protected string $root;

    protected array $ignore = [
        '.*/components/ILIAS/Setup/',
        '.*/components/ILIAS/GlobalScreen/',
        '.*/vendor/',
        '.*/components/ILIAS/App/tests/',
        '.*/components/ILIAS/BackgroundTasks/tests/',
        '.*/components/ILIAS/Cache/tests/',
        '.*/components/ILIAS/Data/tests/',
        '.*/components/ILIAS/FileUpload/tests/',
        '.*/components/ILIAS/Filesystem/tests/',
        '.*/components/ILIAS/GlobalCache/tests/',
        '.*/components/ILIAS/HTTP/tests/',
        '.*/components/ILIAS/KioskMode/tests/',
        '.*/components/ILIAS/Language/tests/',
        '.*/components/ILIAS/Refinery/tests/',
        '.*/components/ILIAS/ResourceStorage/tests/',
        '.*/components/ILIAS/Types/tests/',
        '.*/components/ILIAS/UI/tests/',
        '.*/components/ILIAS/VirusScanner/tests/',
        '.*/components/ILIAS/setup_/',
        // Classes using removed Auth-class from PEAR
        '.*ilSOAPAuth.*',
        // Classes using unknown
        '.*ilPDExternalFeedBlockGUI.*',
    ];

    protected ?array $classmap = null;

    public function __construct()
    {
        $this->root = substr(__FILE__, 0, strpos(__FILE__, DIRECTORY_SEPARATOR . "components"));
        $external_classmap = include(__DIR__ . "/../../../../vendor/composer/vendor/composer/autoload_classmap.php");
        $this->classmap = $external_classmap ?: null;
    }

    protected function genericGetMatchingClassNames(
        callable $is_matching,
        array $additional_ignore = [],
        ?string $matching_path = null
    ): \Iterator {
        foreach ($this->getAllClassNames($additional_ignore, $matching_path) as $class_name) {
            try {
                $reflection_class = new \ReflectionClass($class_name);
                if ($is_matching($reflection_class)) {
                    yield $class_name;
                }
            } catch (\Throwable $e) {
                // ignore
            }
        }
    }

    protected function getAllClassNames(array $additional_ignore, ?string $matching_path = null): \Iterator
    {
        $ignore = array_merge($this->ignore, $additional_ignore);

        if (!is_array($this->classmap)) {
            throw new \LogicException("Composer ClassMap not loaded");
        }

        $regexp = implode(
            "|",
            array_map(
                // fix path-separators to respect windows' backspaces.
                fn($v): string => "(" . str_replace('/', '(/|\\\\)', $v) . ")",
                $ignore
            )
        );
        if ($matching_path) {
            $matching_path = str_replace('/', '(/|\\\\)', $matching_path);
        }


        foreach ($this->classmap as $class_name => $file_path) {
            $real_path = realpath($file_path);
            if ($real_path === false) {
                throw new \RuntimeException(
                    "Could not find file for class $class_name (path: $file_path). " .
                    "Please check the composer classmap, maybe it is outdated. " .
                    "You can regenerate it by executing 'composer du' or 'composer install' " .
                    "(which also ensures dependencies are correctly installed) in the ILIAS root directory."
                );
            }

            $path = str_replace($this->root, "", $real_path);
            if ($matching_path && !preg_match("#^" . $matching_path . "$#", $path)) {
                continue;
            }
            if (!preg_match("#^" . $regexp . "$#", $path)) {
                yield $class_name;
            }
        }
    }
}