实现一个简单的Laravel的dd库

前几天写了一个简单的Laraveldd库。

为什么自己要写一个这样的库?

Laravel本身已经实现了自己的输出dd函数,但是我之所以要写这样一个库,一来是因为Laravel本身对这个库的封装没办法很好的解剖出来,另一方面,他的实现过于复杂。

安装方式

  1. composer 安装
composer require nine/dd
  1. 直接下载

    clone 下来即可

使用

  1. 如我在exapmle.php中所写,我们既可以直接使用:
\dd\Dump::dump('hello,nine');

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

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

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

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

效果

  • string

实现一个简单的Laravel的dd库

  • array

实现一个简单的Laravel的dd库

  • function

实现一个简单的Laravel的dd库

  • object

实现一个简单的Laravel的dd库

+代表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

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

  1. 其中Dump.php主要是我们用来中转类型的地方,他会根据我们提供数据的不同类型,来解析并用反射类来帮我们实现中转。

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

    而里面的诸如DumpString.php主要是有提供一个render方法来给外面的Dump.php使用,这几个就是会根据具体的类型来进行解析了。

大概思路

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


个人博客地址:http://www.hellonine.top

上一篇:fido-uaf-protocol-v1.0


下一篇:Mistakes I Made(as a developer)...大龄程序员的忠告...(部分转...)