goaop /
parser-reflection
Complex classes like ReflectionClassLikeTrait often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use ReflectionClassLikeTrait, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 29 | trait ReflectionClassLikeTrait |
||
| 30 | { |
||
| 31 | use InitializationTrait; |
||
| 32 | |||
| 33 | /** |
||
| 34 | * @var ClassLike |
||
| 35 | */ |
||
| 36 | protected $classLikeNode; |
||
| 37 | |||
| 38 | /** |
||
| 39 | * Short name of the class, without namespace |
||
| 40 | * |
||
| 41 | * @var string |
||
| 42 | */ |
||
| 43 | protected $className; |
||
| 44 | |||
| 45 | /** |
||
| 46 | * List of all constants from the class |
||
| 47 | * |
||
| 48 | * @var array |
||
| 49 | */ |
||
| 50 | protected $constants; |
||
| 51 | |||
| 52 | /** |
||
| 53 | * Interfaces, empty array or null if not initialized yet |
||
| 54 | * |
||
| 55 | * @var \ReflectionClass[]|array|null |
||
| 56 | */ |
||
| 57 | protected $interfaceClasses; |
||
| 58 | |||
| 59 | /** |
||
| 60 | * List of traits, empty array or null if not initialized yet |
||
| 61 | * |
||
| 62 | * @var \ReflectionClass[]|array|null |
||
| 63 | */ |
||
| 64 | protected $traits; |
||
| 65 | |||
| 66 | /** |
||
| 67 | * Additional list of trait adaptations |
||
| 68 | * |
||
| 69 | * @var TraitUseAdaptation[]|array |
||
| 70 | */ |
||
| 71 | protected $traitAdaptations; |
||
| 72 | |||
| 73 | /** |
||
| 74 | * @var array|ReflectionMethod[] |
||
| 75 | */ |
||
| 76 | protected $methods; |
||
| 77 | |||
| 78 | /** |
||
| 79 | * Namespace name |
||
| 80 | * |
||
| 81 | * @var string |
||
| 82 | */ |
||
| 83 | protected $namespaceName = ''; |
||
| 84 | |||
| 85 | /** |
||
| 86 | * Parent class, or false if not present, null if uninitialized yet |
||
| 87 | * |
||
| 88 | * @var \ReflectionClass|false|null |
||
| 89 | */ |
||
| 90 | protected $parentClass; |
||
| 91 | |||
| 92 | /** |
||
| 93 | * @var array|ReflectionProperty[] |
||
| 94 | */ |
||
| 95 | protected $properties; |
||
| 96 | |||
| 97 | /** |
||
| 98 | * Returns the string representation of the ReflectionClass object. |
||
| 99 | * |
||
| 100 | * @return string |
||
| 101 | */ |
||
| 102 | public function __toString() |
||
| 103 | { |
||
| 104 | $isObject = $this instanceof \ReflectionObject; |
||
| 105 | |||
| 106 | $staticProperties = $staticMethods = $defaultProperties = $dynamicProperties = $methods = []; |
||
| 107 | |||
| 108 | $format = "%s [ <user> %sclass %s%s%s ] {\n"; |
||
| 109 | $format .= " @@ %s %d-%d\n\n"; |
||
| 110 | $format .= " - Constants [%d] {%s\n }\n\n"; |
||
| 111 | $format .= " - Static properties [%d] {%s\n }\n\n"; |
||
| 112 | $format .= " - Static methods [%d] {%s\n }\n\n"; |
||
| 113 | $format .= " - Properties [%d] {%s\n }\n\n"; |
||
| 114 | $format .= ($isObject ? " - Dynamic properties [%d] {%s\n }\n\n" : '%s%s'); |
||
| 115 | $format .= " - Methods [%d] {%s\n }\n"; |
||
| 116 | $format .= "}\n"; |
||
| 117 | |||
| 118 | foreach ($this->getProperties() as $property) { |
||
| 119 | if ($property->isStatic()) { |
||
| 120 | $staticProperties[] = $property; |
||
| 121 | } elseif ($property->isDefault()) { |
||
| 122 | $defaultProperties[] = $property; |
||
| 123 | } else { |
||
| 124 | $dynamicProperties[] = $property; |
||
| 125 | } |
||
| 126 | } |
||
| 127 | |||
| 128 | foreach ($this->getMethods() as $method) { |
||
| 129 | if ($method->isStatic()) { |
||
| 130 | $staticMethods[] = $method; |
||
| 131 | } else { |
||
| 132 | $methods[] = $method; |
||
| 133 | } |
||
| 134 | } |
||
| 135 | |||
| 136 | $buildString = function (array $items, $indentLevel = 4) { |
||
| 137 | if (!count($items)) { |
||
| 138 | return ''; |
||
| 139 | } |
||
| 140 | $indent = "\n" . str_repeat(' ', $indentLevel); |
||
| 141 | return $indent . implode($indent, explode("\n", implode("\n", $items))); |
||
| 142 | }; |
||
| 143 | $buildConstants = function (array $items, $indentLevel = 4) { |
||
| 144 | $str = ''; |
||
| 145 | foreach ($items as $name => $value) { |
||
| 146 | $str .= "\n" . str_repeat(' ', $indentLevel); |
||
| 147 | $str .= sprintf( |
||
| 148 | 'Constant [ %s %s ] { %s }', |
||
| 149 | gettype($value), |
||
| 150 | $name, |
||
| 151 | $value |
||
| 152 | ); |
||
| 153 | } |
||
| 154 | return $str; |
||
| 155 | }; |
||
| 156 | $interfaceNames = $this->getInterfaceNames(); |
||
| 157 | $parentClass = $this->getParentClass(); |
||
| 158 | $modifiers = ''; |
||
| 159 | if ($this->isAbstract()) { |
||
| 160 | $modifiers = 'abstract '; |
||
| 161 | } elseif ($this->isFinal()) { |
||
| 162 | $modifiers = 'final '; |
||
| 163 | }; |
||
| 164 | |||
| 165 | $string = sprintf( |
||
| 166 | $format, |
||
| 167 | ($isObject ? 'Object of class' : 'Class'), |
||
| 168 | $modifiers, |
||
| 169 | $this->getName(), |
||
| 170 | false !== $parentClass ? (' extends ' . $parentClass->getName()) : '', |
||
| 171 | $interfaceNames ? (' implements ' . implode(', ', $interfaceNames)) : '', |
||
| 172 | $this->getFileName(), |
||
| 173 | $this->getStartLine(), |
||
| 174 | $this->getEndLine(), |
||
| 175 | count($this->getConstants()), |
||
| 176 | $buildConstants($this->getConstants()), |
||
| 177 | count($staticProperties), |
||
| 178 | $buildString($staticProperties), |
||
| 179 | count($staticMethods), |
||
| 180 | $buildString($staticMethods), |
||
| 181 | count($defaultProperties), |
||
| 182 | $buildString($defaultProperties), |
||
| 183 | $isObject ? count($dynamicProperties) : '', |
||
| 184 | $isObject ? $buildString($dynamicProperties) : '', |
||
| 185 | count($methods), |
||
| 186 | $buildString($methods) |
||
| 187 | ); |
||
| 188 | |||
| 189 | return $string; |
||
| 190 | } |
||
| 191 | |||
| 192 | |||
| 193 | /** |
||
| 194 | * {@inheritDoc} |
||
| 195 | */ |
||
| 196 | 6 | public function getConstant($name) |
|
| 204 | |||
| 205 | /** |
||
| 206 | * {@inheritDoc} |
||
| 207 | */ |
||
| 208 | 26 | public function getConstants() |
|
| 221 | |||
| 222 | /** |
||
| 223 | * {@inheritDoc} |
||
| 224 | */ |
||
| 225 | 13 | public function getConstructor() |
|
| 234 | |||
| 235 | /** |
||
| 236 | * Gets default properties from a class (including inherited properties). |
||
| 237 | * |
||
| 238 | * @link http://php.net/manual/en/reflectionclass.getdefaultproperties.php |
||
| 239 | * |
||
| 240 | * @return array An array of default properties, with the key being the name of the property and the value being |
||
| 241 | * the default value of the property or NULL if the property doesn't have a default value |
||
| 242 | */ |
||
| 243 | 22 | public function getDefaultProperties() |
|
| 269 | |||
| 270 | /** |
||
| 271 | * {@inheritDoc} |
||
| 272 | */ |
||
| 273 | 22 | public function getDocComment() |
|
| 279 | |||
| 280 | 22 | public function getEndLine() |
|
| 284 | |||
| 285 | 22 | public function getExtension() |
|
| 289 | |||
| 290 | 22 | public function getExtensionName() |
|
| 294 | |||
| 295 | 11 | public function getFileName() |
|
| 299 | |||
| 300 | /** |
||
| 301 | * {@inheritDoc} |
||
| 302 | */ |
||
| 303 | 22 | public function getInterfaceNames() |
|
| 307 | |||
| 308 | /** |
||
| 309 | * {@inheritDoc} |
||
| 310 | */ |
||
| 311 | 22 | public function getInterfaces() |
|
| 324 | |||
| 325 | /** |
||
| 326 | * {@inheritdoc} |
||
| 327 | */ |
||
| 328 | 24 | public function getMethod($name) |
|
| 339 | |||
| 340 | /** |
||
| 341 | * Returns list of reflection methods |
||
| 342 | * |
||
| 343 | * @param null|integer $filter Optional filter |
||
| 344 | * |
||
| 345 | * @return array|\ReflectionMethod[] |
||
| 346 | */ |
||
| 347 | 69 | public function getMethods($filter = null) |
|
| 378 | |||
| 379 | /** |
||
| 380 | * Returns a bitfield of the access modifiers for this class. |
||
| 381 | * |
||
| 382 | * @link http://php.net/manual/en/reflectionclass.getmodifiers.php |
||
| 383 | * |
||
| 384 | * NB: this method is not fully compatible with original value because of hidden internal constants |
||
| 385 | * |
||
| 386 | * @return int |
||
| 387 | */ |
||
| 388 | 21 | public function getModifiers() |
|
| 415 | |||
| 416 | /** |
||
| 417 | * {@inheritDoc} |
||
| 418 | */ |
||
| 419 | 79 | public function getName() |
|
| 425 | |||
| 426 | /** |
||
| 427 | * {@inheritDoc} |
||
| 428 | */ |
||
| 429 | 29 | public function getNamespaceName() |
|
| 433 | |||
| 434 | /** |
||
| 435 | * {@inheritDoc} |
||
| 436 | */ |
||
| 437 | 101 | public function getParentClass() |
|
| 454 | |||
| 455 | /** |
||
| 456 | * Retrieves reflected properties. |
||
| 457 | * |
||
| 458 | * @param int $filter The optional filter, for filtering desired property types. |
||
| 459 | * It's configured using the ReflectionProperty constants, and defaults to all property types. |
||
| 460 | * |
||
| 461 | * @return array|\Go\ParserReflection\ReflectionProperty[] |
||
| 462 | */ |
||
| 463 | 46 | public function getProperties($filter = null) |
|
| 496 | |||
| 497 | /** |
||
| 498 | * {@inheritdoc} |
||
| 499 | */ |
||
| 500 | 3 | public function getProperty($name) |
|
| 511 | |||
| 512 | /** |
||
| 513 | * {@inheritDoc} |
||
| 514 | */ |
||
| 515 | 79 | public function getShortName() |
|
| 519 | |||
| 520 | 22 | public function getStartLine() |
|
| 524 | |||
| 525 | /** |
||
| 526 | * Returns an array of trait aliases |
||
| 527 | * |
||
| 528 | * @link http://php.net/manual/en/reflectionclass.gettraitaliases.php |
||
| 529 | * |
||
| 530 | * @return array|null an array with new method names in keys and original names (in the format "TraitName::original") in |
||
| 531 | * values. |
||
| 532 | */ |
||
| 533 | 41 | public function getTraitAliases() |
|
| 553 | |||
| 554 | /** |
||
| 555 | * Returns an array of names of traits used by this class |
||
| 556 | * |
||
| 557 | * @link http://php.net/manual/en/reflectionclass.gettraitnames.php |
||
| 558 | * |
||
| 559 | * @return array |
||
| 560 | */ |
||
| 561 | 22 | public function getTraitNames() |
|
| 565 | |||
| 566 | /** |
||
| 567 | * Returns an array of traits used by this class |
||
| 568 | * |
||
| 569 | * @link http://php.net/manual/en/reflectionclass.gettraits.php |
||
| 570 | * |
||
| 571 | * @return array|\ReflectionClass[] |
||
| 572 | */ |
||
| 573 | 101 | public function getTraits() |
|
| 583 | |||
| 584 | /** |
||
| 585 | * {@inheritDoc} |
||
| 586 | */ |
||
| 587 | 7 | public function hasConstant($name) |
|
| 594 | |||
| 595 | /** |
||
| 596 | * {@inheritdoc} |
||
| 597 | */ |
||
| 598 | 15 | public function hasMethod($name) |
|
| 609 | |||
| 610 | /** |
||
| 611 | * {@inheritdoc} |
||
| 612 | */ |
||
| 613 | public function hasProperty($name) |
||
| 624 | |||
| 625 | /** |
||
| 626 | * {@inheritDoc} |
||
| 627 | */ |
||
| 628 | 22 | public function implementsInterface($interfaceName) |
|
| 634 | |||
| 635 | /** |
||
| 636 | * {@inheritDoc} |
||
| 637 | */ |
||
| 638 | 22 | public function inNamespace() |
|
| 642 | |||
| 643 | /** |
||
| 644 | * {@inheritDoc} |
||
| 645 | */ |
||
| 646 | 22 | public function isAbstract() |
|
| 658 | |||
| 659 | /** |
||
| 660 | * Currently, anonymous classes aren't supported for parsed reflection |
||
| 661 | */ |
||
| 662 | public function isAnonymous() |
||
| 666 | |||
| 667 | /** |
||
| 668 | * {@inheritDoc} |
||
| 669 | */ |
||
| 670 | 22 | public function isCloneable() |
|
| 682 | |||
| 683 | /** |
||
| 684 | * {@inheritDoc} |
||
| 685 | */ |
||
| 686 | 43 | public function isFinal() |
|
| 692 | |||
| 693 | /** |
||
| 694 | * {@inheritDoc} |
||
| 695 | */ |
||
| 696 | public function isInstance($object) |
||
| 706 | |||
| 707 | /** |
||
| 708 | * {@inheritDoc} |
||
| 709 | */ |
||
| 710 | 22 | public function isInstantiable() |
|
| 722 | |||
| 723 | /** |
||
| 724 | * {@inheritDoc} |
||
| 725 | */ |
||
| 726 | 43 | public function isInterface() |
|
| 730 | |||
| 731 | /** |
||
| 732 | * {@inheritDoc} |
||
| 733 | */ |
||
| 734 | 22 | public function isInternal() |
|
| 739 | |||
| 740 | /** |
||
| 741 | * {@inheritDoc} |
||
| 742 | */ |
||
| 743 | 22 | public function isIterateable() |
|
| 747 | |||
| 748 | /** |
||
| 749 | * {@inheritDoc} |
||
| 750 | */ |
||
| 751 | public function isSubclassOf($class) |
||
| 774 | |||
| 775 | /** |
||
| 776 | * {@inheritDoc} |
||
| 777 | */ |
||
| 778 | 22 | public function isTrait() |
|
| 782 | |||
| 783 | /** |
||
| 784 | * {@inheritDoc} |
||
| 785 | */ |
||
| 786 | 22 | public function isUserDefined() |
|
| 791 | |||
| 792 | /** |
||
| 793 | * Gets static properties |
||
| 794 | * |
||
| 795 | * @link http://php.net/manual/en/reflectionclass.getstaticproperties.php |
||
| 796 | * |
||
| 797 | * @return array |
||
| 798 | */ |
||
| 799 | 23 | public function getStaticProperties() |
|
| 820 | |||
| 821 | /** |
||
| 822 | * Gets static property value |
||
| 823 | * |
||
| 824 | * @param string $name The name of the static property for which to return a value. |
||
| 825 | * @param mixed $default A default value to return in case the class does not declare |
||
| 826 | * a static property with the given name |
||
| 827 | * |
||
| 828 | * @return mixed |
||
| 829 | * @throws ReflectionException If there is no such property and no default value was given |
||
| 830 | */ |
||
| 831 | 1 | public function getStaticPropertyValue($name, $default = null) |
|
| 842 | |||
| 843 | |||
| 844 | /** |
||
| 845 | * Creates a new class instance from given arguments. |
||
| 846 | * |
||
| 847 | * @link http://php.net/manual/en/reflectionclass.newinstance.php |
||
| 848 | * @param mixed $args Accepts a variable number of arguments which are passed to the class constructor |
||
| 849 | * |
||
| 850 | * @return object |
||
| 851 | */ |
||
| 852 | 1 | public function newInstance($args = null) |
|
| 858 | |||
| 859 | /** |
||
| 860 | * Creates a new class instance from given arguments. |
||
| 861 | * |
||
| 862 | * @link http://php.net/manual/en/reflectionclass.newinstanceargs.php |
||
| 863 | * |
||
| 864 | * @param array $args The parameters to be passed to the class constructor as an array. |
||
| 865 | * |
||
| 866 | * @return object |
||
| 867 | */ |
||
| 868 | 1 | public function newInstanceArgs(array $args = []) |
|
| 875 | |||
| 876 | /** |
||
| 877 | * Creates a new class instance without invoking the constructor. |
||
| 878 | * |
||
| 879 | * @link http://php.net/manual/en/reflectionclass.newinstancewithoutconstructor.php |
||
| 880 | * |
||
| 881 | * @return object |
||
| 882 | */ |
||
| 883 | 1 | public function newInstanceWithoutConstructor($args = null) |
|
| 890 | |||
| 891 | /** |
||
| 892 | * Sets static property value |
||
| 893 | * |
||
| 894 | * @link http://php.net/manual/en/reflectionclass.setstaticpropertyvalue.php |
||
| 895 | * |
||
| 896 | * @param string $name Property name |
||
| 897 | * @param mixed $value New property value |
||
| 898 | */ |
||
| 899 | 1 | public function setStaticPropertyValue($name, $value) |
|
| 905 | |||
| 906 | 101 | private function recursiveCollect(\Closure $collector) |
|
| 928 | |||
| 929 | /** |
||
| 930 | * Returns list of constants from the class |
||
| 931 | * |
||
| 932 | * @return array |
||
| 933 | */ |
||
| 934 | 26 | private function findConstants() |
|
| 953 | } |
||
| 954 |
Loading history...
This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.
If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.
In this case you can add the
@ignorePhpDoc annotation to the duplicate definition and it will be ignored.