donatj/drop

支持CLI的简单调试方法

v1.1.1 2023-11-04 17:10 UTC

This package is auto-updated.

Last update: 2024-08-27 18:33:32 UTC


README

Latest Stable Version License ci.yml

"最有效的调试工具仍然是仔细思考,再加上恰当地放置的打印语句。"

—— 布莱恩·柯尼汉,《Unix入门》(1979年)

在调试小问题的时候,有时你只想查看一个或两个变量的内容。启动一个完整的调试器可能是对小问题过度杀伤,而var_dump(…); exit(1);有点难以操作,并且只接受单个参数。

drop()是一个简单的调试工具,允许你以简单友好的格式显示一个或多个变量的内容,这种格式在Web和CLI输出上都是友好且可读的。

see()drop()类似,但它不会停止执行。

致谢

这基于我的朋友Jon Henderson之前的工作,那时它还没有自己的仓库。

示例

<?php

require __DIR__ . '/../vendor/autoload.php';

drop(1, 2.0, "3", false, [ 1, 2.0, "3", false ]);
||||||||||||||||||||| Arg No. 0  |||||||||||||||||||||||||||||||||||||||||||



1



||||||||||||||||||||| Arg No. 1  |||||||||||||||||||||||||||||||||||||||||||



2.0



||||||||||||||||||||| Arg No. 2  |||||||||||||||||||||||||||||||||||||||||||



'3'



||||||||||||||||||||| Arg No. 3  |||||||||||||||||||||||||||||||||||||||||||



false



||||||||||||||||||||| Arg No. 4  |||||||||||||||||||||||||||||||||||||||||||



Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] =>
)




||||||||||||||||||||| EOF ||||||||||||||||||||||||||||||||||||||||||||||||||

要求

  • php: >=7.1

安装

使用以下命令安装最新版本:

composer require 'donatj/drop'

文档

函数:\drop

function drop(...$args) : void
参数
  • mixed $args - 要暴露值的参数
返回值
  • never - 退出时状态为1

一个有用的函数,用于清空输出缓冲区并接受任意数量的参数来暴露它们。

这对于查看数组或对象中包含的信息尤其有用。这个函数还会在回显信息后终止脚本。这个函数可以接受任意类型的任意数量的参数并将它们全部显示出来。
函数:\see
mixed $args

一个实用的函数,可以在不终止脚本输出后暴露任意数量的任意类型的参数。

function see(...$args) : void
参数
  • 函数:\see

一个实用的函数,可以在不终止脚本输出后暴露任意数量的任意类型的参数。
函数:\see