手写PHP API框架（三）之反射介绍

上一篇《手写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类不止于这些方法。

更多方法

立即学习“PHP免费学习笔记（深入）”；

ReflectionClass类还有更多方法：

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

• PHP反射

反射的实际应用

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

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

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

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

反射的优点

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

  

  Cutout.Pro

  AI驱动的视觉设计平台

  下载

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

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

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

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

反射的缺点

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

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

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

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

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

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

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