Eines der coolsten Features in PHP, was leider so gut wie ohne Dokumentation dasteht. Reflection ist eine M\u00f6glichkeit, Meta Informationen \u00fcber so ziemlich alles in PHP herauszubekommen. Welche Interfaces implementiert eine Klasse? Welche Methoden hat sie? Wieviele Parameter hat eine Funktion \/ Methode, davon wieviele optionale? Was ist der Default-Wert eines Parameters? Dies und einiges mehr ist wohl nur mit der Reflection herauszubekommen.<\/p>\n
Oben habe ich mit meinen Fragen bereits die Grundbereiche der Reflection erschlagen. Was ist nun wie reflektierbar?<\/p>\n
Diesen Klassen widme ich mich nun also in der mehrteiligen Reihe. Los gehts direkt in diesem Teil 1<\/b> mit der ReflectionClass (ReflectionObject schenke ich mir), sodass dann in Teil 2<\/b> ReflectionFunction und ReflectionMethod gemeinsam behandelt werden. Teil 3<\/b> wird sich um die ReflectionParameter handeln. Schlie\u00dfen wird die Serie mit Teil 4<\/b> und dem ReflectionProperty. Zu erwarten sind jede Menge Code-Beispiele.\n<\/p>\nReflectionClass<\/h3>\n
Starten werde ich mit einer „Grundinfrastruktur“, die ihr euch bitte genau anschaut. Darauf wird dann ein gro\u00dfer Teil der Codebeispiele dieses Teils basieren. Es sieht erstmal viel aus, ist vom Aufbau her aber total simpel. Es ist einfach nur m\u00f6glichst viel an Sprachkonstrukten verwendet worden.<\/p>\n
\r\ninterface ITest{}\r\n\r\nclass A implements ITest\r\n{\r\n\t\/\/constants\r\n\tconst A_Const1 = "A_Const1";\r\n\tconst A_Const2 = "A_Const2";\r\n\t\r\n\t\/\/properties\r\n\tprivate $A_Private = "A_Private";\r\n protected $A_Protected = "A_Protected";\r\n public $A_Public = "A_Public";\r\n\t\r\n\t\/\/static properties\r\n\tprivate static $A_PrivateStatic = "A_PrivateStatic";\r\n protected static $A_ProtectedStatic = "A_ProtectedStatic";\r\n public static $A_PublicStatic = "A_PublicStatic";\r\n\t\r\n\t\/\/methods\r\n\tpublic function A_PublicMethod(){}\r\n\tprivate function A_PrivateMethod(){}\r\n\tprotected function A_ProtectedMethod(){}\r\n\t\r\n\t\/\/static methodes\r\n\tpublic static function A_PublicStaticMethod(){}\r\n\tprivate static function A_PrivateStaticMethod(){}\r\n\tprotected static function A_ProtectedStaticMethod(){}\r\n}\r\n\r\n\/**\r\n * Thats a cool class\r\n * For sure!\r\n *\/\r\nclass B extends A\r\n{\r\n\t\/\/constants\r\n\tconst B_Const1 = "B_Const1";\r\n\tconst B_Const2 = "B_Const2";\r\n\t\r\n\t\/\/properties\r\n\tprivate $B_Private = "B_Private";\r\n protected $B_Protected = "B_Protected";\r\n public $B_Public = "B_Public";\r\n\t\r\n\t\/\/static properties\r\n\tprivate static $B_PrivateStatic = "B_PrivateStatic";\r\n protected static $B_ProtectedStatic = "B_ProtectedStatic";\r\n public static $B_PublicStatic = "B_PublicStatic";\r\n\t\r\n\t\/\/methods\r\n\tpublic function B_PublicMethod(){}\r\n\tprivate function B_PrivateMethod(){}\r\n\tprotected function B_ProtectedMethod(){}\r\n\t\r\n\t\/\/static methodes\r\n\tpublic static function B_PublicStaticMethod(){}\r\n\tprivate static function B_PrivateStaticMethod(){}\r\n\tprotected static function B_ProtectedStaticMethod(){}\r\n}\r\n<\/pre>\n<\/p>\nGenerelle Klasseninformationen<\/h4>\n\r\n$refclass = new ReflectionClass("B");\r\nprint "Class ".$refclass->getName()." is defined from line ".$refclass->getStartLine()." to ".$refclass->getEndLine()." in file ".$refclass->getFileName();\r\n\/\/Class B is defined from line 37 to 62 in file D:\\xampp\\htdocs\\ref1.php\r\n<\/pre>\nKonstanten<\/h4>\n
Alle Konstanten inklusive deren Wert der Klasse und aller \u00dcberklassen.<\/p>\n
\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getConstants());\r\n\/*\r\nArray\r\n(\r\n [B_Const1] => B_Const1\r\n [B_Const2] => B_Const2\r\n [A_Const1] => A_Const1\r\n [A_Const2] => A_Const2\r\n)\r\n*\/\r\n<\/pre>\nAttribute<\/h4>\n
Alle Attribute (statisch und nicht statisch) der Klasse und aller \u00dcberklassen. Sch\u00f6n zu sehen, dass die privaten Attribute der Oberklasse hier fehlen.<\/p>\n
\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getDefaultProperties()); \r\n\/*\r\nArray\r\n(\r\n [B_PrivateStatic] => B_PrivateStatic\r\n [B_ProtectedStatic] => B_ProtectedStatic\r\n [B_PublicStatic] => B_PublicStatic\r\n [A_ProtectedStatic] => A_ProtectedStatic\r\n [A_PublicStatic] => A_PublicStatic\r\n [B_Private] => B_Private\r\n [B_Protected] => B_Protected\r\n [B_Public] => B_Public\r\n [A_Protected] => A_Protected\r\n [A_Public] => A_Public\r\n)\r\n*\/\r\n<\/pre>\nDocBlock<\/h4>\n
Der Doc-Block Kommentar der Klasse.<\/p>\n
\r\n$refclass = new ReflectionClass("B");\r\nprint $refclass->getDocComment();\r\n\/**\r\n * Thats a cool class\r\n * For sure!\r\n *\/\r\n<\/pre>\nInterfaces<\/h4>\n
Alle Interfaces, die die Klasse (und Oberklassen dieser) implementieren. Als Value wird wieder ein ReflectionClass Objekt \u00fcbergeben, welches man dann nach gleichem Schema reflecten kann.<\/p>\n
\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getInterfaces()); \r\n\/*\r\nArray\r\n(\r\n [ITest] => ReflectionClass Object\r\n (\r\n [name] => ITest\r\n )\r\n)\r\n*\/\r\n<\/pre>\nMethoden<\/h4>\n
Alle Methoden der Klasse und aller Oberklassen. Hierbei sind merkw\u00fcrdigerweise (vergleiche den Punkt Attribute<\/i>) auch die privaten Methoden der Oberklasse dabei. Gilt sowohl f\u00fcr statische wie auch f\u00fcr nicht statische Methoden.<\/p>\n\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getMethods());\r\n\/*\r\nArray\r\n(\r\n [0] => ReflectionMethod Object\r\n (\r\n [name] => B_PublicMethod\r\n [class] => B\r\n )\r\n [1] => ReflectionMethod Object\r\n (\r\n [name] => B_PrivateMethod\r\n [class] => B\r\n )\r\n [2] => ReflectionMethod Object\r\n (\r\n [name] => B_ProtectedMethod\r\n [class] => B\r\n )\r\n [3] => ReflectionMethod Object\r\n (\r\n [name] => B_PublicStaticMethod\r\n [class] => B\r\n )\r\n [4] => ReflectionMethod Object\r\n (\r\n [name] => B_PrivateStaticMethod\r\n [class] => B\r\n )\r\n [5] => ReflectionMethod Object\r\n (\r\n [name] => B_ProtectedStaticMethod\r\n [class] => B\r\n )\r\n [6] => ReflectionMethod Object\r\n (\r\n [name] => A_PublicMethod\r\n [class] => A\r\n )\r\n [7] => ReflectionMethod Object\r\n (\r\n [name] => A_PrivateMethod\r\n [class] => A\r\n )\r\n [8] => ReflectionMethod Object\r\n (\r\n [name] => A_ProtectedMethod\r\n [class] => A\r\n )\r\n [9] => ReflectionMethod Object\r\n (\r\n [name] => A_PublicStaticMethod\r\n [class] => A\r\n )\r\n [10] => ReflectionMethod Object\r\n (\r\n [name] => A_PrivateStaticMethod\r\n [class] => A\r\n )\r\n [11] => ReflectionMethod Object\r\n (\r\n [name] => A_ProtectedStaticMethod\r\n [class] => A\r\n )\r\n)\r\n*\/\r\n<\/pre>\nAls optionalen Parameter kann man in getMethods()<\/i> noch spezifizieren, was man genau f\u00fcr Methoden zur\u00fcck m\u00f6chte. Zur Auswahl stehen: ReflectionMethod::IS_STATIC, ReflectionMethod::IS_PUBLIC, ReflectionMethod::IS_PROTECTED, ReflectionMethod::IS_PRIVATE, ReflectionMethod::IS_ABSTRACT, ReflectionMethod::IS_FINAL<\/i> und auch Kombinationen davon. Beispiel:<\/p>\n\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getMethods(ReflectionMethod::IS_STATIC | ReflectionMethod::IS_PRIVATE));\r\n<\/pre>\nW\u00fcrde zum Beispiel alle statischen und alle privaten Methoden zur\u00fcckgeben.<\/p>\n
Static Properties<\/h4>\n
Alle statischen Attribute der Klasse selbst und ihrer Oberklassen. Hierbei ist wieder zu bemerken, dass die privaten statischen Attribute der Oberklasse fehlen.<\/p>\n
\r\n$refclass = new ReflectionClass("B");\r\nprint_r($refclass->getStaticProperties());\r\n\/*\r\nArray\r\n(\r\n [B_PrivateStatic] => B_PrivateStatic\r\n [B_ProtectedStatic] => B_ProtectedStatic\r\n [B_PublicStatic] => B_PublicStatic\r\n [A_ProtectedStatic] => A_ProtectedStatic\r\n [A_PublicStatic] => A_PublicStatic\r\n)\r\n*\/\r\n<\/pre>\nPr\u00fcfung auf Abstraktheit einer Klasse<\/h4>\n\r\n$refclass = new ReflectionClass("B");\r\nvar_dump($refclass->isAbstract());\r\n\/\/bool(false)\r\n<\/pre>\nPr\u00fcfung auf Klassentyp<\/h4>\n
Okay, keine wirklich tolle \u00dcberschrift. Prinzip ist aber einfach. Es geht darum zu pr\u00fcfen, ob die reflektierte Klasse selbst geschrieben wurde oder „PHP-intern“ ist. Das Beispiel machts klar:<\/p>\n
\r\n$refclass = new ReflectionClass("StdClass");\r\nvar_dump($refclass->isUserDefined());\r\n\/\/bool(false)\r\n\r\n$refclass = new ReflectionClass("A");\r\nvar_dump($refclass->isUserDefined());\r\n\/\/bool(true)\r\n<\/pre>\nTo be continued<\/h4>\n
Das wars also mit der ReflectionClass. Ein paar Methoden habe ich unterschlagen, um es nicht unn\u00f6tig aufzubl\u00e4hen. F\u00fcr alles weitere steht das PHP Handbuch zur ReflectionClass<\/a> gern zur Verf\u00fcgung. Im n\u00e4chsten Teil gehts weiter mit ReflectionFunction und ReflectionMethod.<\/p>\n\nFolgende Teile:<\/b><\/p>\n\n- Teil 2: ReflectionMethod und ReflectionFunction<\/a><\/li>\n
- Teil 3: ReflectionParameter<\/a><\/li>\n
- Teil 4: ReflectionProperty<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
Was ist Reflection Eines der coolsten Features in PHP, was leider so gut wie ohne Dokumentation dasteht. Reflection ist eine M\u00f6glichkeit, Meta Informationen \u00fcber so ziemlich alles in PHP herauszubekommen. Welche Interfaces implementiert eine Klasse? Welche Methoden hat sie? Wieviele … Weiterlesen