前几天写了一个简单的Laravel
的dd库。
为什么自己要写一个这样的库?
Laravel
本身已经实现了自己的输出dd
函数,但是我之所以要写这样一个库,一来是因为Laravel
本身对这个库的封装没办法很好的解剖出来,另一方面,他的实现过于复杂。
安装方式
- composer 安装
composer require nine/dd
- 直接下载
clone 下来即可
使用
- 如我在exapmle.php中所写,我们既可以直接使用:
ddDump::dump('hello,nine');
同时也可以自己封装一个dd
函数:
function dd($value)
{
ddDump::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
文件中加入了单例的判断。当然,里面可能有许多设计的不够合理的地方,还望指正。
个人博客地址:http://www.hellonine.top
。