rector/rules/Php70/Rector/ClassMethod/Php4ConstructorRector.php
Tomas Votruba 96112cb1f0 Updated Rector to commit 2da49992cc
2da49992cc [Downgrade] [PHP 7.2] Make DowngradeParameterTypeWideningRector always downgrade to phpdoc type (#390)
2021-07-05 22:50:18 +00:00

175 lines
6.2 KiB
PHP

<?php
declare (strict_types=1);
namespace Rector\Php70\Rector\ClassMethod;
use PhpParser\Node;
use PhpParser\Node\Expr;
use PhpParser\Node\Expr\MethodCall;
use PhpParser\Node\Expr\StaticCall;
use PhpParser\Node\Identifier;
use PhpParser\Node\Name;
use PhpParser\Node\Stmt\Class_;
use PhpParser\Node\Stmt\ClassMethod;
use PhpParser\Node\Stmt\Expression;
use PHPStan\Analyser\Scope;
use PHPStan\Reflection\ClassReflection;
use Rector\Core\Rector\AbstractRector;
use Rector\Core\ValueObject\MethodName;
use Rector\NodeTypeResolver\Node\AttributeKey;
use Rector\Php70\NodeAnalyzer\Php4ConstructorClassMethodAnalyzer;
use Symplify\RuleDocGenerator\ValueObject\CodeSample\CodeSample;
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
/**
* @changelog https://wiki.php.net/rfc/remove_php4_constructors
* @see \Rector\Tests\Php70\Rector\ClassMethod\Php4ConstructorRector\Php4ConstructorRectorTest
*/
final class Php4ConstructorRector extends \Rector\Core\Rector\AbstractRector
{
/**
* @var \Rector\Php70\NodeAnalyzer\Php4ConstructorClassMethodAnalyzer
*/
private $php4ConstructorClassMethodAnalyzer;
public function __construct(\Rector\Php70\NodeAnalyzer\Php4ConstructorClassMethodAnalyzer $php4ConstructorClassMethodAnalyzer)
{
$this->php4ConstructorClassMethodAnalyzer = $php4ConstructorClassMethodAnalyzer;
}
public function getRuleDefinition() : \Symplify\RuleDocGenerator\ValueObject\RuleDefinition
{
return new \Symplify\RuleDocGenerator\ValueObject\RuleDefinition('Changes PHP 4 style constructor to __construct.', [new \Symplify\RuleDocGenerator\ValueObject\CodeSample\CodeSample(<<<'CODE_SAMPLE'
class SomeClass
{
public function SomeClass()
{
}
}
CODE_SAMPLE
, <<<'CODE_SAMPLE'
class SomeClass
{
public function __construct()
{
}
}
CODE_SAMPLE
)]);
}
/**
* @return array<class-string<Node>>
*/
public function getNodeTypes() : array
{
return [\PhpParser\Node\Stmt\ClassMethod::class];
}
/**
* @param ClassMethod $node
*/
public function refactor(\PhpParser\Node $node) : ?\PhpParser\Node
{
if (!$this->php4ConstructorClassMethodAnalyzer->detect($node)) {
return null;
}
$classLike = $node->getAttribute(\Rector\NodeTypeResolver\Node\AttributeKey::CLASS_NODE);
if (!$classLike instanceof \PhpParser\Node\Stmt\Class_) {
return null;
}
// process parent call references first
$this->processClassMethodStatementsForParentConstructorCalls($node);
// not PSR-4 constructor
if (!$this->nodeNameResolver->areNamesEqual($classLike, $node)) {
return null;
}
$classMethod = $classLike->getMethod(\Rector\Core\ValueObject\MethodName::CONSTRUCT);
// does it already have a __construct method?
if (!$classMethod instanceof \PhpParser\Node\Stmt\ClassMethod) {
$node->name = new \PhpParser\Node\Identifier(\Rector\Core\ValueObject\MethodName::CONSTRUCT);
}
if ($node->stmts === null) {
return null;
}
if (\count($node->stmts) === 1) {
/** @var Expression|Expr $stmt */
$stmt = $node->stmts[0];
if (!$stmt instanceof \PhpParser\Node\Stmt\Expression) {
return null;
}
if ($this->isLocalMethodCallNamed($stmt->expr, \Rector\Core\ValueObject\MethodName::CONSTRUCT)) {
$this->removeNode($node);
return null;
}
}
return $node;
}
private function processClassMethodStatementsForParentConstructorCalls(\PhpParser\Node\Stmt\ClassMethod $classMethod) : void
{
if (!\is_iterable($classMethod->stmts)) {
return;
}
foreach ($classMethod->stmts as $methodStmt) {
if (!$methodStmt instanceof \PhpParser\Node\Stmt\Expression) {
continue;
}
$methodStmt = $methodStmt->expr;
if (!$methodStmt instanceof \PhpParser\Node\Expr\StaticCall) {
continue;
}
$this->processParentPhp4ConstructCall($methodStmt);
}
}
private function processParentPhp4ConstructCall(\PhpParser\Node\Expr\StaticCall $staticCall) : void
{
$parentClassName = $this->resolveParentClassName($staticCall);
// no parent class
if ($parentClassName === null) {
return;
}
if (!$staticCall->class instanceof \PhpParser\Node\Name) {
return;
}
// rename ParentClass
if ($this->isName($staticCall->class, $parentClassName)) {
$staticCall->class = new \PhpParser\Node\Name('parent');
}
if (!$this->isName($staticCall->class, 'parent')) {
return;
}
// it's not a parent PHP 4 constructor call
if (!$this->isName($staticCall->name, $parentClassName)) {
return;
}
$staticCall->name = new \PhpParser\Node\Identifier(\Rector\Core\ValueObject\MethodName::CONSTRUCT);
}
private function resolveParentClassName(\PhpParser\Node\Expr\StaticCall $staticCall) : ?string
{
$scope = $staticCall->getAttribute(\Rector\NodeTypeResolver\Node\AttributeKey::SCOPE);
if (!$scope instanceof \PHPStan\Analyser\Scope) {
return null;
}
$classReflection = $scope->getClassReflection();
if (!$classReflection instanceof \PHPStan\Reflection\ClassReflection) {
return null;
}
$parentClassReflection = $classReflection->getParentClass();
if (!$parentClassReflection instanceof \PHPStan\Reflection\ClassReflection) {
return null;
}
return $parentClassReflection->getName();
}
private function isLocalMethodCallNamed(\PhpParser\Node\Expr $expr, string $name) : bool
{
if (!$expr instanceof \PhpParser\Node\Expr\MethodCall) {
return \false;
}
if ($expr->var instanceof \PhpParser\Node\Expr\StaticCall) {
return \false;
}
if ($expr->var instanceof \PhpParser\Node\Expr\MethodCall) {
return \false;
}
if (!$this->isName($expr->var, 'this')) {
return \false;
}
return $this->isName($expr->name, $name);
}
}