PHPackages                             koalaphp/log - 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. koalaphp/log

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

koalaphp/log
============

based on monolog, save log to files with high performance

v0.04(6y ago)08MITPHPPHP >=5.6.0CI failing

Since Apr 21Pushed 6y agoCompare

[ Source](https://github.com/koalaphp/log)[ Packagist](https://packagist.org/packages/koalaphp/log)[ Docs](https://my.oschina.net/laiconglin/blog)[ RSS](/packages/koalaphp-log/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

KoalaPHP Logger Component
=========================

[](#koalaphp-logger-component)

KoalaPHP 基于 monolog 写入本地文件的json格式日志的组件

1. 快速开始
-------

[](#1-快速开始)

### 1.1 日志组件初始化

[](#11-日志组件初始化)

建议在Bootstrap的时候初始化一次

```
define('LOG_PATH', './logs')
$logConfig = [
    'level' => \Monolog\Logger::INFO,
    'logPath' =>  LOG_PATH,
    'logFileExtension' => '.log',
    'delayThreshold' => 100, // log buffer threshold
    // 用于输出日志的附加信息   ---start
    'extra' => [
        'REQUEST_URI'    => 'A', // 请求的地址
        'REMOTE_ADDR'    => 'B', // request ip, 如果要获取用户真实ip，需要重新获取
        'REQUEST_METHOD' => 'C', // 请求的方法，get or post ?
        'HTTP_REFERER'   => 'D', // 请求的referer
        'SERVER_NAME'    => 'E', // 请求的host
        'UNIQUE_ID'      => md5(uniqid(mt_rand(), true)), // 请求的唯一的ID，可用于链路追踪
    ],
    // 用户输出日志的附加信息 ---start
];
Koala\Log\MyLogger::initLogConfig($logConfig);

```

### 1.2 日志对象的获取和使用

[](#12-日志对象的获取和使用)

```
$apiLogger = Koala\Log\MyLogger::getLogger("api");
$apiLogger->info("test log", ["target_id" => "123456"]);

```

### 1.3 日志信息预览

[](#13-日志信息预览)

在日志文件`./logs/api-2019-05-25.log` 中，写入如下的一条日志：

```
{"message":"test log","context":{"target_id":"123456"},"level":200,"level_name":"INFO","channel":"api","datetime":"2019-05-25 12:02:21.758641","extra":{"url":"A","ip":"B","http_method":"C","server":"E","referrer":"D","unique_id":"cf026132e86bc2799375bbabeeab3edc"}}

```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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 ~399 days

Total

2

Last Release

2546d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2a8163316c8a86b26b22935e85930344fe9a16b4a275299f91d7482ca36a27a7?d=identicon)[laiconglin3](/maintainers/laiconglin3)

---

Top Contributors

[![laiconglin](https://avatars.githubusercontent.com/u/5069073?v=4)](https://github.com/laiconglin "laiconglin (8 commits)")

---

Tags

logloggingfilesPSR-4

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/koalaphp-log/health.svg)

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

###  Alternatives

[symfony/monolog-bundle

Symfony MonologBundle

2.9k249.1M1.6k](/packages/symfony-monolog-bundle)[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)[ytake/laravel-fluent-logger

fluent logger for laravel and lumen

63541.6k1](/packages/ytake-laravel-fluent-logger)[logtail/monolog-logtail

Logtail handler for Monolog

233.2M3](/packages/logtail-monolog-logtail)[inpsyde/logzio-monolog

Logz.io integration for Monolog

191.2M1](/packages/inpsyde-logzio-monolog)

PHPackages © 2026

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