lepampim/fast-dbg-php

用于在HTML环境中简单快速地调试PHP页面的库

v1.0.0 2024-02-17 23:01 UTC

This package is not auto-updated.

Last update: 2024-09-29 23:56:00 UTC


README

用于在HTML环境中以简单和快速的方式进行PHP页面调试的库。创建此项目的主要原因是简化调试过程,同时不失去个性化定制的可能性。

$a = "Hello Word";
$b = null;
$c = True;
$d = 42;
$e = 3.14159265359;
$f = [];
$g = ["orange", "banana", "apple"];
$h = [
    "name" => [
        "first" => "Gustavo",
        "middle" => ["de", "Sousa"],
        "last" => "Correa"
    ],
    "age" => 18,
    "from" => "Brazil"
];
$i = new Person("Maria", 19);

fdbg($a, $b, $c, $d, $e, $f, $g, $h, $i);

image

因此,通过此存储库,调试过程变得更加容易,要调试您的代码,只需调用函数 fdbg 来创建有关变量的信息面板。此外,通过以下所述的关键字,调试您的环境变得更快、更高效。而且,项目的基本原则之一是个性化,为此创建了如 FastDbgPHP::setProjectNameFastDbgPHP::setStyles 这样的函数。

使用方法

要在项目中使用此库,只需导入并定义项目状态,通过函数 FastDbgPHP::setDevelopmentMode,即如果处于开发模式,则将 True 定义为 True,否则为 False。之后,所有基本配置都已完成,只需调试您感兴趣的变量,无需节省,可以放置任意多个,总是了解代码在做什么是好的。

// Importando a biblioteca FastDbgPHP
require_once "../fastDbgPHP.class.php";

// Defina o modo que da página
// no caso de estar no modo de desenvolvimento defina True, se não, False
FastDbgPHP::setDevelopmentMode($isDev);

// Por fim, simplesmente depure suas variáveis
$value = rand(1, 1000);
$other_value = $value - 10;

fdbg($value, $other_value);

我们不推荐在生产环境中留下调试代码,例如 fdbg,但是为了提高代码的安全性,只有当项目处于开发模式时,此函数才会显示页面上的结果。

以下是一些重要的函数。

关键字

全局变量:##GET##POST##SERVER##FILES##COOKIE##SESSION##REQUEST##ENV

关键字 ##GET##POST##SERVER##FILES##COOKIE##SESSION##REQUEST##ENV 分别显示全局变量 $_GET$_POST$_SERVER$_FILES$_COOKIE$_SESSION$_REQUEST$_ENV,简化了调试并便于在代码中阅读。

fdbg('##GET', '##POST', '##SERVER', '##FILES', '##COOKIE', '##SESSION', '##REQUEST', '##ENV');

为了更快速地显示HTML页面的GET和POST数据,可以简单地调用函数 fdbg,但是没有任何参数,如下所示

// para maior velocidade, use:
fdbg();
// em vez de:
fdbg('##GET', '##POST');
// as duas formas mostram a mesma coisa

时间控制:##TIME

要检查某段代码或任何其他时间计数所用的时间,请使用关键字 ##TIME,它显示从页面开始到调用 fdbg 的时刻之间的时间。为了使此关键字正常工作,必须使用函数 FastDbgPHP::setInicialTime 定义页面的Unix起始时间,如下所示

// Pegue o tempo inicial de referencia do código, sempre deve ser aferido no começo da página
$inicial_time = microtime(true);

// Definindo o tempo inicial de referência
FastDbgPHP::setInicialTime($inicial_time);

/* O corpo do seu código */

// Por fim, mostra o tempo usado pelo código
fdbg('##TIME');

##TRACE

以列表形式显示从调用 fdbg 的函数到代码行的历史。例如,我们有

function factorial(int $n) {
    if ($n == 0 or $n == 1) {
        fdbg('##TRACE');
        return 1;
    }

    return $n * factorial($n-1);
}

fdbg(factorial(10));

##EXIT

在调用 fdbg 函数结束后,函数将结束页面。例如

$zero = 0;
fdbg($zero, `##EXIT`);
// nada a partir daqui será executado

echo 'Hello world';
echo $zero / $zero;