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/tests/',
        '.*/vendor/',
        // Test classes depend on dev-dependencies (e.g. PHPUnit) which are missing in --no-dev installs
        '.*/tests/',
        '.*/components/ILIAS/Setup/classes/',
        // 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;
            }
        }
    }
}