yiisoft/log-target-file

Yii 日志库 - 文件目标

3.0.0 2023-02-17 05:52 UTC

This package is auto-updated.

Last update: 2024-09-02 15:11:40 UTC


README

Yii

Yii 日志库 - 文件目标


Latest Stable Version Total Downloads Build status Code coverage Mutation testing badge static analysis type-coverage

此包为 yiisoft/log 提供 File 目标。目标

  • 将日志消息记录到文件
  • 允许您配置日志文件轮换
  • 提供压缩轮换日志文件的能力

要求

  • PHP 8.0 或更高版本。

安装

可以使用 Composer 安装此包

composer require yiisoft/log-target-file

通用用法

创建轮换器

$rotator = new \Yiisoft\Log\Target\File\FileRotator(
    $maxFileSize,
    $maxFiles,
    $fileMode,
    $compressRotatedFiles
);
  • $maxFileSize (int) - 最大文件大小,以千字节为单位。默认为 10240,即 10MB。
  • $maxFiles (int) - 用于轮换的文件数量。默认为 5
  • $fileMode (int|null) - 新创建文件设置的权限。默认为 null
  • $compressRotatedFiles (bool) - 是否使用 gzip 压缩轮换文件。默认为 false

创建目标

$fileTarget = new \Yiisoft\Log\Target\File\FileTarget(
    $logFile,
    $rotator,
    $dirMode,
    $fileMode
);
  • $logFile (string) - 日志文件路径。默认为 /tmp/app.log
  • $rotator (\Yiisoft\Log\Target\File\FileRotatorInterface|null) - 默认为 null,这意味着日志文件不会轮换。
  • $dirMode (int) - 新创建目录设置的权限。默认为 0775
  • $fileMode (int|null) - 新创建日志文件设置的权限。默认为 null

创建日志记录器

$logger = new \Yiisoft\Log\Logger([$fileTarget]);

对于在 Yii 框架 中的使用,请参阅配置文件

文档

有关使用日志记录器的说明,请参阅 yiisoft/log 包。

如果您需要帮助或有任何问题,Yii 论坛 是一个不错的选择。您还可以查看其他 Yii 社区资源

许可证

Yii 日志库 - 文件目标是自由软件。它根据 BSD 许可证的条款发布。有关更多信息,请参阅 LICENSE

Yii 软件 维护。

支持项目

Open Collective

关注更新

Official website Twitter Telegram Facebook Slack