README

Slim 框架的 PHP-Console 日志写入器

使用此自定义日志写入器，将 Slim 框架 的日志消息输出到浏览器控制台，使用 PHP-Console。

安装

只需将 amenadiel/slim-phpconsole 添加到你的 composer.json 文件中 require 或 require-dev 部分

{
    "require": {
        "amenadiel/slim-phpconsole":"~0.0.4"
    }
}

用法

实例化日志写入器。如果你不希望自动启动处理器，则将 false 作为参数传递，否则默认为 true。

当处理器启动时，它将将自己设置为错误和异常处理器，除非你另行设置。

    $logwriter = new \Amenadiel\SlimPHPConsole\PHPConsoleWriter(true);

    $app = new \Slim\Slim(array(
        'log.enabled' => true,
        'log.level' => \Slim\Log::DEBUG,
        'log.writer' => $logwriter
    ));

从版本 0.0.6 开始，此适配器扩展了 Slim\Middleware。因此，你也可以使用你应用的 add 方法。

    $app = new \Slim\Slim(array(
        'log.enabled' => true,
        'log.level' => \Slim\Log::DEBUG
    ));

    $app->add(new \Amenadiel\SlimPHPConsole\PHPConsoleWriter);

两种将 PHP-Console 设置为日志记录器的方法几乎相同。之后，你可以使用 $app->log 的方法将消息发送到浏览器控制台。

    $app->log->debug('Debug called!');
    $app->log->info('This is just info');
    $app->log->warning('Heads Up! This is a warning');

你可以通过使用此适配器的 debug 方法将自定义标签传递给 PHPConsole，它将参数转发到 PHPConsole 的 debug 方法。

    $app->log->getWriter()->debug('This has a custom tag', 'custom.tag');

如果你在其他地方直接使用 PHPConsole，请记住不要重复启动它，因为它将抛出异常。使用它的 isStarted 方法检查它是否已经启动。

    $myHandler = \PhpConsole\Handler::getInstance();
    
    if (!$myHandler->isStarted()) {
        $myHandler->start(); // Only start it if it hasn't been started yet
    }

可选设置

你可以通过获取处理器实例或连接器实例的引用来使用 PHP-Console 的配置方法。例如

   $logwriter = new \Amenadiel\SlimPHPConsole\PHPConsoleWriter(false);
   $handler = $logwriter->getHandler();
   $handler->setHandleErrors(false);  // disable errors handling, must be done before 'start' method
   $handler->start();

   $connector = $logwriter->getConnector();
   $connector->setPassword('macoy123'); //sets a very insecure passwd