README

#Laravel 4 LogViewer

轻松查看和删除 Laravel 4 的日志。

灵感来源于 Fire Log（由 David Morrow 为 CodeIgniter 创建）和 Larvel Log Viewer（由 Eric Barnes 为 Laravel 3 创建）

#关于 Laravel 4.1 的注意事项

截至现在（2013-11-29），新的 Laravel 4.1 应用程序记录事物的方式与以前不同。虽然这 技术上 并没有破坏 LogViewer，但 LogViewer 也不知道如何处理这些变化。以下是一个快速的修复方法

在你的 app/start/global.php 中，第 34 行进行更改

Log::useFiles(storage_path().'/logs/laravel.log');

改为

$logFile = 'log-'.php_sapi_name().'.txt';

Log::useDailyFiles(storage_path().'/logs/'.$logFile);

这仅适用于 Laravel 4.1 的新安装。如果你已经升级了一个现有的 4.0 应用程序（并且没有更改日志的创建和存储方式），一切应该仍然正常工作。

##演示

##安装

将 kmd/logviewer 添加到 composer.json 的要求中

{
    ...
    "require": {
        ...
        "kmd/logviewer": "1.2.*"
        ...
    },
}

更新 composer

$ php composer.phar update

将提供者添加到你的 app/config/app.php

'providers' => array(

    ...
    'Kmd\Logviewer\LogviewerServiceProvider',

),

发布包资产

$ php artisan asset:publish kmd/logviewer

(可选) 你可以配置你的 composer.json 在每次 $ composer update 后执行此操作

"scripts":{
    "post-update-cmd":[
        "php artisan asset:publish kmd/logviewer",
        "php artisan optimize",
    ]
},

(可选) 发布包配置

$ php artisan config:publish kmd/logviewer

请注意：如果你已经更改了你的 app/config/packages/kmd/logviewer/config.php，请不要再发布包配置。它将覆盖你的配置而不发出任何警告。

##使用和配置

###使用

默认情况下，LogViewer 将注册一些路由

logviewer -> 重定向到今天的日志，显示所有级别。
logviewer/$app/$sapi/$date/delete -> 在 $date（格式为 Y-m-d）的 $sapi（见：php_sapi_name）上删除日志。
logviewer/$app/$sapi/$date/$level? -> 显示 $sapi 在 $date 上的日志，带有 $level（如果没有提供，默认为所有）。

LogViewer 还注册了一些过滤器

logviewer.logs：聚合你配置的监视目录中的所有日志，并通过 $logs 变量共享它们。
logviewer.messages：检查会话中是否有成功、错误或信息提示消息，并将 $has_messages 变量设置为 true 或 false。

###配置

base_url：LogViewer 可用的 URL。你可以将其嵌套（例如：admin/logviewer）。默认：logviewer。
filters：应用于路由的前后过滤器。我们默认不定义任何过滤器，因为不是每个人都使用身份验证或相同的过滤器名称。
- global：影响整个 logviewer 的过滤器。例如：'global' => array('before' => 'auth'), 将应用默认的 Laravel auth 过滤器到 logviewer，要求所有路由都需要登录用户。
- view：影响日志文件查看的过滤器。
- delete：影响日志文件删除的过滤器。
log_dirs：要监控的日志目录关联数组。数组键是您应用程序的'名称'，值是它们app/storage/logs目录的路径（不含尾斜杠）。默认：array('app' => storage_path().'/logs')。
log_order：按升序或降序排列日志内容。默认：'asc'。
per_page：分页显示每页日志消息的数量。默认：10。
view：用于显示日志的视图的名称（和位置）。有关更多详细信息，请参阅“高级用法”部分，其中提供了有关传递给此视图的变量的详细说明。默认：'logviewer::viewer'。
p_view：要使用的分页视图。当使用Bootstrap 3作为应用程序的默认时，分页将在LogViewer中中断。如果您创建了您自己的视图，请确保如果您使用Bootstrap 3（或编写自己的分页视图），则更改此设置。默认：'pagination::slider'。

高级用法

不喜欢LogViewer的外观？需要更好地与您应用程序的主题集成？您可以通过创建自己的视图并更改配置选项来做到这一点。以下是要传递给视图的变量

$has_messages：布尔值。logviewer.messages过滤器确定会话中是否有成功、错误或信息闪存消息。用于隐藏闪存消息容器。
$logs：数组。由logviewer.logs过滤器生成的聚合日志，来自所有监控的应用程序。按SAPI和应用程序分组。结构
- SAPI作为键，值是一个具有以下键的数组
  - sapi：可读的SAPI。
  - logs：应用程序'简称'作为键，值是日志日期的数组。
$log：数组。当前所选日志的内容。每条消息都被分割成数组。结构
- level：字符串。日志消息的级别。
- header：字符串。日志消息的第一行。
- stack：字符串。日志消息的其余部分。如果消息不包含堆栈跟踪，则可能为空。
$empty：布尔值。当前日志是否为空。
$date：字符串。当前所选日志的日期。
$sapi：字符串。当前所选日志的可读SAPI。
$sapi_plain：字符串。当前所选日志的SAPI。用于URI。
$url：字符串。配置中的基本URL。
$levels：数组。所有可能的日志级别，按psr/log。
$path：字符串。当前所选日志应用程序的数组键。