1. 内省(Introspection)函数
Introspection(内省)程序在运行时检查对象的类型或属性的能力，他允许对象类由程序员操纵。
你将会发现introspection 相当有用当你不知道哪一个类后或者方法在设计时需要被执行.
Introspection 在 PHP 提供非常有用的能力去检查类(classes), 接口(interfaces), 属性(properties),
和方法(methods). PHP 提供了大量的函数你能用他来完成这些检查任务.
为了帮助你理解introspection, 我将简要概述一些 PHP的 类(classes),方法(methods), 和函数(functions)
他们被使用的时候，代码会高亮显示.
通过这篇文章, 你将会看到一组例子如何去使用一些非常有用的 PHP的 introspection 函数
以及专门针对API提供类似于introspection功能的部分, 反射(Reflection) API.
第一个例子, 我会展示一些 PHP的 introspection functions. 你能使用这些功能functions
去检查基础的信息包括关于类(classes)像他们的名字(name), 父类的名字等等.
class_exists() # 检查一个类是否被定义
get_class() # 返回对象的类名
get_parent_class() # 返回对象的类的父类名
is_subclass_of() # 检查一个对象是否是给定父类的 子类
?>
下面是一个例子 PHP 包含定义Introspection 和子类以及输出输出通过上述功能提取的信息：
class Introspection
{
public function description() {
echo "I am a super class for the Child class.n";
}
}
class Child extends Introspection
{
public function description() {
echo "I'm " . get_class($this) , " class.n";
echo "I'm " . get_parent_class($this) , "'s child.n";
}
}
if (class_exists("Introspection")) {
$introspection = new Introspection();
echo "The class name is: " . get_class($introspection) . "n";
$introspection->description();
}
if (class_exists("Child")) {
$child = new Child();
$child->description();
if (is_subclass_of($child, "Introspection")) {
echo "Yes, " . get_class($child) . " is a subclass of Introspection.n";
}
else {
echo "No, " . get_class($child) . " is not a subclass of Introspection.n";
}
}
?>
输出如下:
The class name is: Introspection
I am a super class for the Child class.
I'm Child class.
I'm Introspection's child.
Yes, Child is a subclass of Introspection.
这是第二个例子，其中包含ICurrencyConverter接口和GBPCurrencyConverter类的定义，
并输出上面列出的函数提取的信息。 与第一个例子一样，我将首先列出这些函数，然后显示一些代码。
get_declared_classes() # 返回一系列已经定义的类
get_class_methods() # 返回给定【类|对象】的所有方法 private 和 protected 方法会被跳过
get_class_vars() # 返回当前【类名】的默认属性 private 和 protected 属性会被跳过
interface_exists() # 检查某个【接口名】是否 被定义
method_exists() # 检查一个类/对象是否定义某个方法
?>
我们看个栗子:
interface ICurrencyConverter
{
public function convert($currency, $amount);
}
class GBPCurrencyConverter implements ICurrencyConverter
{
public $name = "GBPCurrencyConverter";
public $rates = array("USD" => 0.622846,
"AUD" => 0.643478);
protected $var1;
private $var2;
function __construct() {}
function convert($currency, $amount) {
return $rates[$currency] * $amount;
}
}
if (interface_exists("ICurrencyConverter")) {
echo "ICurrencyConverter interface exists.n";
}
$classes = get_declared_classes();
echo "The following classes are available:n";
print_r($classes);
if (in_array("GBPCurrencyConverter", $classes)) {
print "GBPCurrencyConverter is declared.n";
$gbpConverter = new GBPCurrencyConverter();
$methods = get_class_methods($gbpConverter);
echo "The following methods are available:n";
print_r($methods);
$vars = get_class_vars("GBPCurrencyConverter");
echo "The following properties are available:n";
print_r($vars);
echo "The method convert() exists for GBPCurrencyConverter: ";
var_dump(method_exists($gbpConverter, "convert"));
}
输出如下:
ICurrencyConverter interface exists.
The following classes are available:
Array
(
[0] => stdClass
[1] => Exception
[2] => ErrorException
[3] => Closure
[4] => DateTime
[5] => DateTimeZone
[6] => DateInterval
[7] => DatePeriod
...
[154] => GBPCurrencyConverter
)
GBPCurrencyConverter is declared.
The following methods are available:
Array
(
[0] => __construct
[1] => convert
)
The following properties are available:
Array
(
[name] => GBPCurrencyConverter
[rates] => Array
(
[USD] => 0.622846
[AUD] => 0.643478
)
)
2. 反射(Reflection)API
PHP通过他的Reflection类 API支持反射. 就像你在php官方手册中看到的,
Reflection类API比 introspection 方法更慷慨，提供了大量的类(classes)和(methods)
可以用来完成反射任务. ReflectionClass 是 API的主类 并用于对类，接口和方法应用反射，
并提取有关所有类组件的信息。Reflection在应用程序代码中很容易实现，像内省一样也很直观。
下面有个例子来解释 reflection使用相同的定义 ICurrencyConverter 接口
以及子类 GBPCurrencyConverter:
$child = new ReflectionClass("Child");
$parent = $child->getParentClass();
echo $child->getName() . " is a subclass of " . $parent->getName() . ".n";
$reflection = new ReflectionClass("GBPCurrencyConverter");
$interfaceNames = $reflection->getInterfaceNames();
if (in_array("ICurrencyConverter", $interfaceNames)) {
echo "GBPCurrencyConverter implements ICurrencyConverter.n";
}
$methods = $reflection->getMethods();
echo "The following methods are available:n";
print_r($methods);
if ($reflection->hasMethod("convert")) {
echo "The method convert() exists for GBPCurrencyConverter.n";
}
?>
下面是输出:
Child is a subclass of Introspection.
GBPCurrencyConverter implements ICurrencyConverter.
The following methods are available:
Array
(
[0] => ReflectionMethod Object
(
[name] => __construct
[class] => GBPCurrencyConverter
)
[1] => ReflectionMethod Object
(
[name] => convert
[class] => GBPCurrencyConverter
)
)
getInterfaceNames() 返回当前类实例化的接口的名字.
getParentClass() 返回一个 ReflectionClass 对象 表示这个父类或者 false(如果没有父类的话).
为了列举出 ReflectionClass 对象的名字, 你可以使用 getName() 方法, 就像你在上面的方法中看到的.
getMethods() 方法返回了一个数组的方法 还可以加一个可选参数 ReflectionMethod::IS_STATIC,IS_PUBLIC, IS_PROTECTED,IS_PRIVATE, IS_ABSTRACT, 和IS_FINAL 过率掉基于可见的方法
Reflection API 提供了一个好的实现给你反射的能力去创建更好的应用, 像 ApiGen, 虽然进一步的讨论超出了本文的目标.
总结
这篇文章里你已经看到了如何去使用 PHP的 内省函数 和 反射 API 来获取得到信息关于类, 接口, 属性, 和 方法. 获取这些信息的目的是在运行时更好地了解您的代码，并创建复杂的应用程序。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
