实现一个简单的 dd 库

Nine 的个人博客 / 3083 / 7 / 创建于 6年前 / 更新于 4年前

前几天写了一个简单的Laravel的dd库。
为什么自己要写一个这样的库？
Laravel本身已经实现了自己的输出dd函数，但是我之所以要写这样一个库，一来是因为Laravel本身对这个库的封装没办法很好的解剖出来，另一方面，他的实现过于复杂。
如果觉得好用可以star一下嘛~

安装方式

composer 安装
```
composer require nine/dd 
```
直接下载
clone 下来即可

使用

如我在exapmle.php中所写，我们既可以直接使用:

\dd\Dump::dump('hello,nine');

同时也可以自己封装一个dd函数:

function dd($value)
{
    \dd\Dump::dump($value);
}
dd("hello,nine");

不管是哪种方式，他都会自动的识别我们的类型来予以不同的展示效果。

此外，如果需要自己单独配置样式和新增装饰符号，可以在conf目录下根据所给的注释予以添加。

效果

string

array

function

object

+代表public，-代表private，#代表protected，属性后面灰色的部分代表默认值。

结构

.
├── Dump.php
├── conf
│   ├── css.php
│   └── decorator.php
├── decorator
│   ├── DecoratorComponent.php
│   ├── Div.php
│   ├── P.php
│   └── Span.php
└── render
    ├── AbstractDump.php
    ├── DumpArray.php
    ├── DumpObject.php
    └── DumpString.php

以上是他的主要目录结构。

其中Dump.php主要是我们用来中转类型的地方，他会根据我们提供数据的不同类型，来解析并用反射类来帮我们实现中转。
conf层主要是一些配置文件，css.php是一个样式配置文件，decorator.php是一个我们需要定制的装饰器，比如=>符号之类的。
decorator是装饰器层，DecoratorComonent.php是一个装饰器基类，他的主要工作是用来初始化我们的样式表，同时提供了一些可以让我们自定义的方法，比如添加span装饰器，或者给这个装饰器添加一些样式等等。Span.php等文件主要是我们的具体装饰器，其中主要有两个方法，wrap方法来完善最终的输出效果，而display方法则是用来输出。
render是渲染层，这里就像是一个效果加工厂，比如前面提到的decorator提供了一些添加样式的工具，那么这里就是用来调用这些工具的地方。AbstractRender.php是一个基类，里面提供了一些初始化我们前面提到的自定义装饰器符号的工具，还有包裹解析我们的数组形成数组的装饰效果(因为像对象还有函数都会用到它)，还有像parseParams会根据我们传入的函数(方法)的参数所形成的反射数组，来进行解析，判断他的默认值等，最终形成一个包裹好的装饰器；display方法主要就是获取我们的span之类的装饰器，然后最终调用装饰器的display方法来予以输出。
而里面的诸如DumpString.php主要是有提供一个render方法来给外面的Dump.php使用，这几个就是会根据具体的类型来进行解析了。

大概思路

我们最终要实现的一个页面效果是像Dom节点一样，一层一层的包裹着我们最终的元素。所以我能第一时间联系到的就是装饰器。装饰器去生产各种Dom节点，为了防止生产对象的滥用，我这里也在AbstractDump.php文件中加入了单例的判断。当然，里面可能有许多设计的不够合理的地方，还望指正。

欢迎关注我的公众号，每周至少一篇比较有深度的原创文章：

实现一个简单的 dd 库