在其他框架中使用 dump () & dd () 函数

mouyong 的个人博客 / 10565 / 27 / 创建于 6年前 / 更新于 1年前 / 1 个改进

Laravel 框架用久了后，就习惯了在调试的时候使用 Laravel 的辅助函数 dd() 了。

当切换到其他框架的时候，没有找到比较好的类似该辅助函数的工具。因此萌生了从 Laravel 框架中将他们给抽取出来。

这是一篇更好的做法的文章：PHP 全局使用 Laravel 辅助函数 dd，推荐直接看这篇

> **如果你的环境是 Docker，推荐直接看这篇：[PHP 全局使用 Laravel 辅助函数 dd (补充：docker 环境下全局使用)](https://learnku.com/articles/5075/php-global-uses-the-laravel-helper-function-dd)**

文件放在 Gist 访问需自带『梯子』。

使用方式

在项目根目录执行 composer require symfony/var-dumper。
在项目入口文件将项目根目录中的 vendor/autoload.php 进行加载。
访问 Gist ，将文件保存为 helper.php。
在项目根目录的 composer.json 文件的 autoload 字段中将 helper.php 相对于 composer.json 的路径（和 composer.json 的相对路径）添加上。
在项目中执行 composer dump-autoload。

这里是一段 composer.json 的示例：

{
    .
    .
    .
    "require": {
        .
        .
        .
    },
    "autoload": {
        "files": [
                "path/to/helper.php"
        ]
    },
    .
    .
    .
}

现在应该就可以愉快的使用辅助函数 dd() 了。

为了方便没有 fq 的朋友，我将文件的内容放在下面。直接保存为 `helper.php` 即可

<?php

# install symfony/var-dump to your project
# composer require symfony/var-dumper

// use namespace
use Symfony\Component\VarDumper\Cloner\VarCloner;
use Symfony\Component\VarDumper\Dumper\CliDumper;
use Symfony\Component\VarDumper\Dumper\HtmlDumper as SymfonyHtmlDumper;

/**
 * Class HtmlDumper
 */
class HtmlDumper extends SymfonyHtmlDumper
{
    /**
     * Colour definitions for output.
     *
     * @var array
     */
    protected $styles = [
        'default' => 'background-color:#fff; color:#222; line-height:1.2em; font-weight:normal; font:12px Monaco, Consolas, monospace; word-wrap: break-word; white-space: pre-wrap; position:relative; z-index:100000',
        'num' => 'color:#a71d5d',
        'const' => 'color:#795da3',
        'str' => 'color:#df5000',
        'cchr' => 'color:#222',
        'note' => 'color:#a71d5d',
        'ref' => 'color:#a0a0a0',
        'public' => 'color:#795da3',
        'protected' => 'color:#795da3',
        'private' => 'color:#795da3',
        'meta' => 'color:#b729d9',
        'key' => 'color:#df5000',
        'index' => 'color:#a71d5d',
    ];
}

/**
 * Class Dumper
 */
class Dumper
{
    /**
     * Dump a value with elegance.
     *
     * @param  mixed  $value
     * @return void
     */
    public function dump($value)
    {
        if (class_exists(CliDumper::class)) {
            $dumper = 'cli' === PHP_SAPI ? new CliDumper : new HtmlDumper;
            $dumper->dump((new VarCloner)->cloneVar($value));
        } else {
            var_dump($value);
        }
    }
}

if (! function_exists('dd')) {
    /**
     * Dump the passed variables and end the script.
     *
     * @param  mixed
     * @return void
     */
    function dd(...$args)
    {
        foreach ($args as $x) {
            (new Dumper)->dump($x);
        }
        die(1);
    }
}

if (! function_exists('dda')) {
    /**
     * Dump the passed array variables and end the script.
     *
     * @param  mixed
     * @return void
     */
    function dda(...$args)
    {
        foreach ($args as $x) {
            (new Dumper)->dump($x->toArray());
        }
        die(1);
    }
}