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

2023-05-14 19:05:01 框架 反射 手写

上一篇《手写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获取类的一个属性的 ReflectionProperty
ReflectionClass::getReflectionConstantGets a ReflectionClassConstant for a class's constant
ReflectionClass::getReflectionConstantsGets class constants
ReflectionClass::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检查类是否声明为 final
ReflectionClass::isInstance检查类的实例
ReflectionClass::isInstantiable检查类是否可实例化
ReflectionClass::isInterface检查类是否是一个接口(interface)
ReflectionClass::isInternal检查类是否由扩展或核心在内部定义
ReflectionClass::isIterableCheck whether this class is iterable
ReflectionClass::isIterateable检查是否可迭代(iterateable)
ReflectionClass::isSubclassOf检查是否为一个子类
ReflectionClass::isTrait返回了是否为一个 trait
ReflectionClass::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 API框架(三)之反射介绍的详细内容,更多请关注其它相关文章!

相关文章