StringClassNameToClassConstantRector.php

<?php

declare(strict_types=1);

namespace Rector\Php55\Rector\String_;

use PhpParser\Node;
use PhpParser\Node\Expr\ClassConstFetch;
use PhpParser\Node\Name\FullyQualified;
use PhpParser\Node\Scalar\String_;
use PHPStan\Reflection\ReflectionProvider;
use Rector\Contract\Rector\ConfigurableRectorInterface;
use Rector\NodeTypeResolver\Node\AttributeKey;
use Rector\Rector\AbstractRector;
use Rector\ValueObject\PhpVersionFeature;
use Rector\VersionBonding\Contract\MinPhpVersionInterface;
use Symplify\RuleDocGenerator\ValueObject\CodeSample\ConfiguredCodeSample;
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
use Webmozart\Assert\Assert;

/**
 * @see \Rector\Tests\Php55\Rector\String_\StringClassNameToClassConstantRector\StringClassNameToClassConstantRectorTest
 */
final class StringClassNameToClassConstantRector extends AbstractRector implements MinPhpVersionInterface, ConfigurableRectorInterface
{
    /**
     * @var string[]
     */
    private array $classesToSkip = [];

    public function __construct(
        private readonly ReflectionProvider $reflectionProvider,
    ) {
    }

    public function getRuleDefinition(): RuleDefinition
    {
        return new RuleDefinition('Replace string class names by `<class>::class` constant', [
            new ConfiguredCodeSample(
                <<<'CODE_SAMPLE'
class AnotherClass
{
}

class SomeClass
{
    public function run()
    {
        return 'AnotherClass';
    }
}
CODE_SAMPLE
                ,
                <<<'CODE_SAMPLE'
class AnotherClass
{
}

class SomeClass
{
    public function run()
    {
        return \AnotherClass::class;
    }
}
CODE_SAMPLE
                ,
                ['ClassName', 'AnotherClassName'],
            ),
        ]);
    }

    /**
     * @return array<class-string<Node>>
     */
    public function getNodeTypes(): array
    {
        return [String_::class];
    }

    /**
     * @param String_ $node
     */
    public function refactor(Node $node): ClassConstFetch|null
    {
        if ($this->shouldSkipIsA($node)) {
            return null;
        }

        $classLikeName = $node->value;

        // remove leading slash
        $classLikeName = ltrim($classLikeName, '\\');
        if ($classLikeName === '') {
            return null;
        }

        if ($this->shouldSkip($classLikeName)) {
            return null;
        }

        $fullyQualified = new FullyQualified($classLikeName);
        return new ClassConstFetch($fullyQualified, 'class');
    }

    /**
     * @param string[] $configuration
     */
    public function configure(array $configuration): void
    {
        Assert::allString($configuration);

        $this->classesToSkip = $configuration;
    }

    public function provideMinPhpVersion(): int
    {
        return PhpVersionFeature::CLASSNAME_CONSTANT;
    }

    private function shouldSkip(string $classLikeName): bool
    {
        // skip short class names, mostly invalid use of strings
        if (! str_contains($classLikeName, '\\')) {
            return true;
        }

        // possibly string
        if (ctype_lower($classLikeName[0])) {
            return true;
        }

        if (! $this->reflectionProvider->hasClass($classLikeName)) {
            return true;
        }

        foreach ($this->classesToSkip as $classToSkip) {
            if (str_contains($classToSkip, '*')) {
                if (fnmatch($classToSkip, $classLikeName, FNM_NOESCAPE)) {
                    return true;
                }

                continue;
            }

            if ($this->nodeNameResolver->isStringName($classLikeName, $classToSkip)) {
                return true;
            }
        }

        return false;
    }

    private function shouldSkipIsA(String_ $string): bool
    {
        if (! $string->getAttribute(AttributeKey::IS_ARG_VALUE, false)) {
            return false;
        }

        $funcCallName = $string->getAttribute(AttributeKey::FROM_FUNC_CALL_NAME);

        return $funcCallName === 'is_a';
    }
}