本文概述
编程世界中的调试过程通常很繁琐, 不容易并且要花费大量时间。这就是为什么有许多开发人员专注于如何改进多种技术的开发过程的原因。在PHP中, 已经有人实现了这样的调试条的想法, PHP开发人员可以使用它来调试视图上的代码, 而无需使用var_dump, echo等。尽管许多现代框架(例如Symfony)已经包含了这样一个有用的调试条( Symfony Profiler):
还有其他类似Laravel, Zend, Phalcon等不提供此类实用程序的工具。这就是在这种情况下使用独立库的原因, 因此我们想向你介绍PHP Debug Bar项目。
什么是PHP调试栏
调试栏库使你可以轻松地在任何项目中集成有用的调试栏, 该调试栏可以显示来自应用程序任何部分的概要分析数据。它内置了用于标准PHP功能和流行项目的数据收集器。
- 没有其他依赖项的通用调试栏。
- 易于与任何项目集成。
- 干净, 快速且易于使用的界面。
- 处理AJAX请求。
- 包括通用数据收集器和知名库的收集器。
- 客户端栏是用JavaScript 100%编码的。
- 在栏中轻松创建自己的收集器及其关联的视图。
- 保存并重新打开以前的请求。
- 非常有据可查。
有关此项目的详细信息, 请访问其官方网站或Github上的存储库。你也可以在他们的网站上观看实时演示。
安装
使用以下命令, 可以轻松地将该库与composer一起安装使用:
composer require maximebf/debugbar
安装后, 你将能够包括PHP Debug bar的类, 并在视图中实现渲染器。
如何使用?
使用DebugBar \ JavascriptRenderer类执行渲染。它包含所有有用的功能, 以包含所需的资产并生成调试栏, 但是你可以使用StandardDebugBar类实现标准的调试栏:
<?php
use DebugBar\StandardDebugBar;
$debugbar = new StandardDebugBar();
$debugbarRenderer = $debugbar->getJavascriptRenderer();
$debugbar["messages"]->addMessage("hello world!");
?>
<html>
<head>
<!-- As a good practice, load CSS etc in the head tag -->
<?php echo $debugbarRenderer->renderHead() ?>
</head>
<body>
<!-- Render the bar in the body tag -->
<?php echo $debugbarRenderer->render() ?>
</body>
</html>
调试栏的默认客户端实现完全使用Javascript制作, 位于debugbar.js文件中。它添加了一个底部锚定的栏, 其中可以包含选项卡和指示器。条可以处于打开或关闭状态。打开时, 选项卡面板可见。指示符是显示在栏的始终可见部分中的一条信息。该栏通过显示一个选择框来处理多个数据集, 你可以在它们之间进行切换。条状状态(高度, 可见性, 活动面板)可以在两次请求之间保存(在标准条中启用)。
每个面板由一个小部件组成, 用于显示来自数据收集器的数据。 widgets.js文件中提供了一些常见的窗口小部件。 PhpDebugBar命名空间用于所有对象, 唯一的依赖项是jQuery和FontAwesome(css)。 FontAwesome是可选的, 但用于添加漂亮的图标。主要类是PhpDebugBar.DebugBar。它提供了用于管理选项卡, 指标和数据集的基础结构。初始化后, DebugBar类将自身添加到页面的<body>中。默认情况下为空。
有关更详细的实现, 我们建议你访问实现调试栏的存储库中的演示源代码。
如何贡献?
该项目是MIT许可下的开源项目, 这意味着你可以报告问题, 在官方存储库上创建拉取请求。
评论前必须登录!
注册