reflectionProvider = $reflectionProvider; } public function getRuleDefinition() : RuleDefinition { return new RuleDefinition('Replace string class names by ::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> */ public function getNodeTypes() : array { return [String_::class, FuncCall::class]; } /** * @param String_|FuncCall $node */ public function refactorWithScope(Node $node, Scope $scope) { // keep allowed string as condition if ($node instanceof FuncCall) { if ($this->isName($node, 'is_a')) { return NodeTraverser::DONT_TRAVERSE_CHILDREN; } return null; } $classLikeName = $node->value; // remove leading slash $classLikeName = \ltrim($classLikeName, '\\'); if ($classLikeName === '') { return null; } if ($this->shouldSkip($classLikeName, $node)) { return null; } $fullyQualified = new FullyQualified($classLikeName); $fullyQualifiedOrAliasName = new FullyQualified($scope->resolveName($fullyQualified)); if ($classLikeName !== $node->value) { $preSlashCount = \strlen($node->value) - \strlen($classLikeName); $preSlash = \str_repeat('\\', $preSlashCount); $string = new String_($preSlash); return new Concat($string, new ClassConstFetch($fullyQualifiedOrAliasName, 'class')); } return new ClassConstFetch($fullyQualifiedOrAliasName, 'class'); } /** * @param mixed[] $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, String_ $string) : bool { if (!$this->reflectionProvider->hasClass($classLikeName)) { return \true; } $classReflection = $this->reflectionProvider->getClass($classLikeName); if ($classReflection->getName() !== $classLikeName) { return \true; } // skip short class names, mostly invalid use of strings if (\strpos($classLikeName, '\\') === \false) { return \true; } // possibly string if (\ctype_lower($classLikeName[0])) { return \true; } foreach ($this->classesToSkip as $classToSkip) { if ($this->nodeNameResolver->isStringName($classLikeName, $classToSkip)) { return \true; } } // allow class strings to be part of class const arrays, as probably on purpose $parentClassConst = $this->betterNodeFinder->findParentType($string, ClassConst::class); return $parentClassConst instanceof ClassConst; } }