PHPackages                             windwork/logger - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. windwork/logger

ActiveLibrary[Logging & Monitoring](/categories/logging)

windwork/logger
===============

Windwork日志组件，按日志级别写入日志

0.7.0(8y ago)0711MITPHPPHP >=5.5.0

Since May 10Pushed 8y agoCompare

[ Source](https://github.com/windwork/wf-logger)[ Packagist](https://packagist.org/packages/windwork/logger)[ RSS](/packages/windwork-logger/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (4)DependenciesVersions (5)Used By (1)

Windwork 日志组件
=============

[](#windwork-日志组件)

实现日志保存功能，保存各种类型的应用级日志。常用于需要保存日志的逻辑中。比如错误日志、调试日志等。

安装
--

[](#安装)

该组件已包含在Windwork框架中，如果你已安装Windwork框架则可以直接使用。

- 安装方式一：通过composer安装（推荐）

```
composer require windwork/wf

```

- 安装方式二：传统方式安装
    [下载源码](https://github.com/windwork/wf/releases)后，解压源码到项目文件夹中，然后require\_once $PATH\_TO\_WF/core/lib/Loader.php文件，即可自动加载组件中的类。

初始化
---

[](#初始化)

使用日志组件之前，需要先初始化，否则无法正常使用。

```
$cfg = array(
    'class'    => 'File',     // 日志处理（\wf\logger\adapter\中）实现的类
    'dir'      => 'data/log', // 日志保存路径，支持wrapper，如新浪公有云可使用  saekv://data/log或saemc://data/cache
    'level'    => 7,          // 启用日志级别，可为0-7，记录小于或等于该级别的日志。日志等级：0)emergency，1)alert，2)critical，3)error，4)warning，5)notice，6)info，7)debug
);

$class = "\wf\\logger\\adapter\\{$cfg['class']}";
$logging = new $class($cfg);

```

通过logging()函数记录日志
-----------------

[](#通过logging函数记录日志)

```
$level = 'debug'; // 日志级别，可以是 emergency|alert|critical|error|warning|notice|info|debug
$message = 'dgb message'; // 日志内容，如果是非标量则使用var_export成字符串保存
logging($level, $message);

```

通过日志对象方法记录日志
------------

[](#通过日志对象方法记录日志)

```

// 通用日志记录方法
$logging->log('日志级别', '日志内容'); // 参数同 logging($level, $message)函数

// 系统不可用
$logging->emergency('日志内容');

// 必须立刻采取行动
$logging->alert('日志内容');

// 紧急情况
$logging->critical('日志内容');

// 运行时出现的错误，不需要立刻采取行动，但必须记录下来以备检测。
$logging->error('日志内容');

// 出现非错误性的异常。
$logging->warning('日志内容');

// 一般性重要的事件
$logging->notice('日志内容');

// 重要事件
$logging->info('日志内容');

// 调试信息
$logging->debug('日志内容');

```

日志级别
----

[](#日志级别)

```
  0）emergency 系统不可用
  1）alert     必须立刻采取行动
  2）critical  紧急情况
  3）error     运行时出现的错误，不需要立刻采取行动，但必须记录下来以备检测。
  4）warning   出现非错误性的异常（Exception等）。 例如：使用了被弃用的API、错误地使用了API或者非预想的不必要错误。
  5）notice    一般性重要的事件。
  6）info      重要事件，例如：用户登录和SQL记录。
  7）debug     调试信息

```

### 要了解更多？

[](#要了解更多)

> - [官方完整文档首页](http://docs.windwork.org/manual/)
> - [官方源码首页](https://github.com/windwork)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~15 days

Total

4

Last Release

3245d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/500cd48271ed61b12fbac17502e33a2b7ff364948c9ffe2d4a86d5d4d63540fb?d=identicon)[windwork](/maintainers/windwork)

---

Top Contributors

[![cmpan](https://avatars.githubusercontent.com/u/399927?v=4)](https://github.com/cmpan "cmpan (19 commits)")

---

Tags

logloggerloggingloglogger

### Embed Badge

![Health badge](/badges/windwork-logger/health.svg)

```
[![Health](https://phpackages.com/badges/windwork-logger/health.svg)](https://phpackages.com/packages/windwork-logger)
```

###  Alternatives

[analog/analog

Fast, flexible, easy PSR-3-compatible PHP logging package with dozens of handlers.

3451.5M24](/packages/analog-analog)[theorchard/monolog-cascade

Monolog extension to configure multiple loggers in the blink of an eye and access them from anywhere

1482.2M9](/packages/theorchard-monolog-cascade)[inpsyde/wonolog

Monolog-based logging package for WordPress.

183617.9k7](/packages/inpsyde-wonolog)[amphp/log

Non-blocking logging for PHP based on Amp, Revolt, and Monolog.

402.6M70](/packages/amphp-log)[apix/log

Minimalist, thin and fast PSR-3 compliant (multi-bucket) logger.

511.0M18](/packages/apix-log)[mtownsend/array-redactor

A PHP package to redact array values by their keys.

146112.3k1](/packages/mtownsend-array-redactor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)