README

简介

当记录事件和错误时，Craft CMS 将将日志写入 craft/storage/runtime/logs/craft.log 和 craft/storage/runtime/logs/phperrors.log 文件。

这可能会在具有短暂文件系统的托管环境中（如 Heroku、Amazon EC2 和一些 Docker 配置）引起问题，因为日志文件将不会持久化，日志数据将会丢失。

此插件增加了将 Craft CMS 的日志输出重定向到除默认日志文件之外的其他源的能力。

安装

此插件可以通过手动安装或使用 Composer 安装。

Composer

首选的安装方式是通过 Composer

composer require nerds-and-company/loghelper

这将把 nerds-and-company/loghelper 添加到您的项目的 composer.json 文件中，并将插件安装到 craft/plugins/loghelper 目录。

手动

如果无法通过 Composer 进行安装，则也可以手动安装此软件包。下载最新版本或将此存储库的内容克隆到 craft/plugins/loghelper 目录。

重要

插件的文件夹必须命名为 "loghelper"

使用方法

此插件提供不同类型的操作，可以通过编辑/添加 craft/config/logHelper.php 配置文件进行配置。

配置

以下设置可用

useFileLog

确定是否将日志写入文件。这允许禁用 Craft 的默认行为。

'useFileLog' => true,

useProfileLog

确定是否在浏览器控制台窗口中显示分析结果。这允许禁用 Craft 的默认行为。

'useProfileLog' => true,

useStdErrLog

确定是否将日志写入 STDERR（shell 错误输出流）。启用此功能允许在 Heroku（或在像 Papertrail 这样的持久化 Heroku 日志的工具中）查看 Craft 日志。

'useStdErrLog' => false,

useSysLog

确定是否将日志写入系统日志。启用此功能允许从系统日志中读取的工具（如非 Heroku 的 Papertrail）持久化 Craft 日志。

'useSysLog' => false,

useWebLog

确定是否在浏览器控制台窗口中显示日志内容。这允许禁用 Craft 的默认行为。

'useWebLog' => true,

屏幕截图

Docker

Heroku

Papertrail

许可证

此插件已根据 MIT 许可证（MIT）授权。有关更多信息，请参阅许可证文件。

变更日志

2.0.3

更好的日志处理

2.0.2

修复了读取默认配置值的问题

2.0.1

添加了更多文档

2.0.0

添加了对系统日志记录的支持，这是 Papertrail（非 Heroku）的默认设置
添加了删除 Web、文件和分析日志的能力
通过追加换行符提高了日志的可读性

1.0.0

初始发布

nerds-and-company / loghelper

维护者

详细信息