手写PHP API框架(三)之反射介绍

编辑: admin 分类: php 发布时间: 2023-04-26 来源:互联网

上一篇《手写PHP API框架之Composer的安装使用(二)》文章中我们介绍了Composer的安装使用,这一文我们来介绍一下有关反射的概念介绍。

反射,直观理解就是根据到达地找到出发地和来源。 反射指在PHP运行状态中,扩展分析PHP程序,导出或提出关于类、方法、属性、参数等的详细信息,包括注释。这种动态获取信息以及动态调用对象方法的功能称为反射API。

不妨先来看一个demo:

<?php


function p($msg, $var)
{
    echo($msg.":".print_r($var, true)).PHP_EOL.PHP_EOL;
}


class Demo
{
    private $id;

    protected $name;

    public $skills = [];

    public function __construct($id, $name, $skills = [])
    {
        $this->id = $id;
        $this->name = $name;
        $this->skills = $skills;
    }

    public function getName()
    {
        return $this->name;
    }
    public function getSkill()
    {
        p('skill', $this->skills);
    }
}


$ref = new ReflectionClass('Demo');
if ($ref->isInstantiable()) {
    p('检查类是否可实例化isInstantiable', null);
}
$constructor = $ref->getConstructor();
p('获取构造函数getConstructor', $constructor);

$parameters = $constructor->getParameters();
foreach ($parameters as $param) {
    p('获取参数getParameters', $param);
}

if ($ref->hasProperty('name')) {
    $attr = $ref->getProperty('name');
    p('获取属性getProperty', $attr);
}

$attributes = $ref->getProperties();
foreach ($attributes as $row) {
    p('获取属性列表getProperties', $row->getName());
}

if ($ref->hasMethod('getSkill')) {
    $method = $ref->getMethod('getSkill');
    p('获取方法getMethod', $method);
}

$methods = $ref->getMethods();
foreach ($methods as $row) {
    p('获取方法列表getMethods', $row->getName());
}

$instance = $ref->newInstanceArgs([1, 'sai', ['php', 'js']]);
p('newInstanceArgs', $instance);
登录后复制

输出:

➜  php git:(main) php reflect.php 

检查类是否可实例化isInstantiable:

获取构造函数getConstructor:ReflectionMethod Object
(
    [name] => __construct
    [class] => Demo
)


获取参数getParameters:ReflectionParameter Object
(
    [name] => id
)


获取参数getParameters:ReflectionParameter Object
(
    [name] => name
)


获取参数getParameters:ReflectionParameter Object
(
    [name] => skills
)


获取属性getProperty:ReflectionProperty Object
(
    [name] => name
    [class] => Demo
)


获取属性列表getProperties:id

获取属性列表getProperties:name

获取属性列表getProperties:skills

获取方法getMethod:ReflectionMethod Object
(
    [name] => getSkill
    [class] => Demo
)


获取方法列表getMethods:__construct

获取方法列表getMethods:getName

获取方法列表getMethods:getSkill

newInstanceArgs:Demo Object
(
    [id:Demo:private] => 1
    [name:protected] => sai
    [skills] => Array
        (
            [0] => php
            [1] => js
        )

)
登录后复制

demo里面就有使用了ReflectionClass类,当然ReflectionClass类不止于这些方法。

更多方法

ReflectionClass类还有更多方法:

方法说明ReflectionClass::__construct初始化 ReflectionClass 类ReflectionClass::export导出一个类ReflectionClass::getConstant获取定义过的一个常量ReflectionClass::getConstants获取一组常量ReflectionClass::getConstructor获取类的构造函数ReflectionClass::getDefaultProperties获取默认属性ReflectionClass::getDocComment获取文档注释ReflectionClass::getEndLine获取最后一行的行数ReflectionClass::getExtension根据已定义的类获取所在扩展的 ReflectionExtension 对象ReflectionClass::getExtensionName获取定义的类所在的扩展的名称ReflectionClass::getFileName获取定义类的文件名ReflectionClass::getInterfaceNames获取接口(interface)名称ReflectionClass::getInterfaces获取接口ReflectionClass::getMethod获取一个类方法的 ReflectionMethod。ReflectionClass::getMethods获取方法的数组ReflectionClass::getModifiers获取类的修饰符ReflectionClass::getName获取类名ReflectionClass::getNamespaceName获取命名空间的名称ReflectionClass::getParentClass获取父类ReflectionClass::getProperties获取一组属性ReflectionClass::getProperty获取类的一个属性的 ReflectionPropertyReflectionClass::getReflectionConstantGets a ReflectionClassConstant for a class's constantReflectionClass::getReflectionConstantsGets class constantsReflectionClass::getShortName获取短名ReflectionClass::getStartLine获取起始行号ReflectionClass::getStaticProperties获取静态(static)属性ReflectionClass::getStaticPropertyValue获取静态(static)属性的值ReflectionClass::getTraitAliases返回 trait 别名的一个数组ReflectionClass::getTraitNames返回这个类所使用 traits 的名称的数组ReflectionClass::getTraits返回这个类所使用的 traits 数组ReflectionClass::hasConstant检查常量是否已经定义ReflectionClass::hasMethod检查方法是否已定义ReflectionClass::hasProperty检查属性是否已定义ReflectionClass::implementsInterface接口的实现ReflectionClass::inNamespace检查是否位于命名空间中ReflectionClass::isAbstract检查类是否是抽象类(abstract)ReflectionClass::isAnonymous检查类是否是匿名类ReflectionClass::isCloneable返回了一个类是否可复制ReflectionClass::isFinal检查类是否声明为 finalReflectionClass::isInstance检查类的实例ReflectionClass::isInstantiable检查类是否可实例化ReflectionClass::isInterface检查类是否是一个接口(interface)ReflectionClass::isInternal检查类是否由扩展或核心在内部定义ReflectionClass::isIterableCheck whether this class is iterableReflectionClass::isIterateable检查是否可迭代(iterateable)ReflectionClass::isSubclassOf检查是否为一个子类ReflectionClass::isTrait返回了是否为一个 traitReflectionClass::isUserDefined检查是否由用户定义的ReflectionClass::newInstance从指定的参数创建一个新的类实例ReflectionClass::newInstanceArgs从给出的参数创建一个新的类实例。ReflectionClass::newInstanceWithoutConstructor创建一个新的类实例而不调用它的构造函数ReflectionClass::setStaticPropertyValue设置静态属性的值ReflectionClass::__toString返回 ReflectionClass 对象字符串的表示形式。

除去强大的ReflectionClass,还有Reflection、ReflectionClassConstant 、ReflectionMethod 、ReflectionFunctionAbstract等等。建议查看手册:

  • PHP反射

反射的实际应用

  • 反射可以用于文档、文件生成。可以用它对文件里的类进行扫描,逐个生成描述文档;

  • 既然反射可以探知类的内部结构,那么可以用它做hook实现插件功能;

  • 可以用于做动态代理,在未知或者不确定类名的情况下,动态生成和实例化一些类和执行方法;

  • 依赖注入。对于多次继承的类,我们可以通过多次反射探索到基类的结构,或者采用递归的形式反射,实现实例化所有继承类,这也是PHP依赖注入的原理。

反射的优点

  • 支持反射的语言提供了一些在低级语言中难以实现的运行时特性。

  • 可以在一定程度上避免硬编码,提供灵活性和通用性。

  • 可以作为一个第一类对象发现并修改源代码的结构(如代码块、类、方法、协议等)。

  • 可以在运行时像对待源代码语句一样计算符号语法的字符串(类似JavaScript的eval()函数),进而可将跟class或function匹配的字符串转换成class或function的调用或引用。

  • 可以创建一个新的语言字节码解释器来给编程结构一个新的意义或用途。

反射的缺点

  • 学习成本高。面向反射的编程需要较多的高级知识,包括框架、关系映射和对象交互,以利用更通用的代码执行

  • 同样因为反射的概念和语法都比较抽象,过多地滥用反射技术会使得代码难以被其他人读懂,不利于合作与交流

  • 反射在提高了代码灵活性的同时,牺牲了一点点运行效率,有一定的消耗

  • 反射也会破坏类的封装性,把本不该暴露的方法或属性暴露了出来

在平时的开发中,我们用到反射其实不多,为什么把它拿到这里来说呢?一来是我们后面会使用到反射去实现Ioc容器,二来反射也是PHP核心功能之一,在我们流行的框架中十分常见,理解它是很有必要的。

这一节是比较独立的,在后面的章节中我们会使用它。

推荐学习:《PHP视频教程》

以上就是手写PHP API框架(三)之反射介绍的详细内容,更多请关注海外IDC网其它相关文章!