LegacyClassUsageRule.php

Go to the documentation of this file.

<?php

namespace ILIAS\CI\PHPStan\Rules;

use PhpParser\Node\Expr\CallLike;
use PHPStan\Reflection\ReflectionProvider;
use PHPStan\Rules\Rule;
use PhpParser\Node;
use PHPStan\Analyser\Scope;
use PHPStan\Rules\RuleErrorBuilder;

abstract class LegacyClassUsageRule implements Rule
{
    protected ReflectionProvider $reflectionProvider;
    protected \PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck;
    private array $forbidden_classes = [];
    private array $ancestor_cache = [];

    public function __construct(
        ReflectionProvider $reflectionProvider,
        \PHPStan\Rules\Generics\GenericAncestorsCheck $genericAncestorsCheck
    ) {
        $this->reflectionProvider = $reflectionProvider;
        $this->genericAncestorsCheck = $genericAncestorsCheck;

        // Determine possible class-names (parents and children) of the forbidden classes
        $forbidden_classes = [];

        foreach ($this->getForbiddenClasses() as $forbidden_class) {
            $ancestors = $this->getClassAncestors($forbidden_class);
            $this->cacheAncestors($forbidden_class, $ancestors);
            $forbidden_classes = array_merge(
                $forbidden_classes,
                $ancestors
            );
        }

        $this->forbidden_classes = array_unique($forbidden_classes);
    }

    private function getClassAncestors(string $class_name): array
    {
        if (isset($this->ancestor_cache[$class_name])) {
            return $this->ancestor_cache[$class_name];
        }

        $ancestors[] = $class_name;

        try {
            $reflection = $this->reflectionProvider->getClass($class_name);
            $ancestors = array_merge($ancestors, $reflection->getParentClassesNames());
        } catch (\PHPStan\Broker\ClassNotFoundException $e) {
            // Do nothing
        } finally {
            unset($reflection);
        }
        return array_unique($ancestors);
    }

    private function cacheAncestors($class_name, array $ancestor_classes): void
    {
        $this->ancestor_cache[$class_name] = $ancestor_classes;
    }

    public function getNodeType(): string
    {
        return CallLike::class;
    }

    abstract protected function getForbiddenClasses(): array;

    abstract protected function getHumanReadableRuleName(): string;

    abstract protected function getRelevantILIASVersion(): int;

    final public function processNode(Node $node, Scope $scope): array
    {
        switch (true) {
            case $node instanceof Node\Expr\StaticCall:
            case $node instanceof Node\Expr\New_:
                if ($node->class instanceof Node\Name) {
                    $class_name = $node->class->toString();
                } else {
                    return [];
                }
                break;
            default:
                return [];
        }

        $class_names_to_test = $this->getClassAncestors($class_name);

        $array_intersect = array_intersect($class_names_to_test, $this->forbidden_classes);
        if ($array_intersect !== []) {
            $this->cacheAncestors($class_name, $class_names_to_test);
            return [
                RuleErrorBuilder::message("Usage of $class_name is forbidden.")
                    ->metadata([
                        'rule' => $this->getHumanReadableRuleName(),
                        'version' => $this->getRelevantILIASVersion(),
                    ])
                    ->build()
            ];
        }

        return [];
    }
}