Grav - 调试与日志记录

在开发主题和插件时，调试和日志记录信息非常必要。Grav 使用一些如下所述的功能来使用调试信息。

PHP 调试栏

Grav 带有一个名为调试栏的工具来显示调试信息。默认情况下，此功能被禁用。您可以全局开启它，或使用system.yaml为您的开发环境开启。

debugger:
   enabled: true
   twig: true
   shutdown:
      close_connection: true

启用调试器为true后，您可以查看如下所示的调试栏。点击位于角落左侧的 G 符号。

在调试栏中，您可以在右侧角落查看总内存使用情况和处理时间。它还包含多个选项卡，提供详细的信息。

在“消息”选项卡中，您可以查看有助于调试 Grav 开发过程的消息，这些信息将通过$Grav['debugger']→addMessage($my_var)从代码发布到此选项卡。

在“时间轴”选项卡中，您可以查看 Grav 定时的细分。

错误显示

它显示有关块或页面在运行时的错误消息。在 Grav 中，您可以轻松识别错误并快速解决错误。以下是将在屏幕上显示的错误消息，如以下屏幕截图所示。

在user/config/system.yaml文件中，您可以通过将其设置为 false 来禁用错误页面。

errors:
   display: false
   log: true

日志记录

日志记录用于报告来自库和应用程序的错误和状态信息。在 Grav 中，有一些重要的日志记录功能，如下所述。

$Grav['log']->info('My informational message');
$Grav['log']->notice('My notice message');
$Grav['log']->debug('My debug message');
$Grav['log']->warning('My warning message');
$Grav['log']->error('My error message');
$Grav['log']->critical('My critical message');
$Grav['log']->alert('My alert message');
$Grav['log']->emergency('Emergency, emergency, there is an emergency here!');

所有日志消息都将显示在Grav.log文件中，该文件位于<您的文件夹名称>/logs/Grav.log文件夹下。