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

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

oumartraore/log-reader
======================

A library to get logs from file.

02PHP

Since Feb 1Pushed 5y ago1 watchersCompare

[ Source](https://github.com/traoreoumar/log-reader)[ Packagist](https://packagist.org/packages/oumartraore/log-reader)[ RSS](/packages/oumartraore-log-reader/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Log Reader
==========

[](#log-reader)

[![Latest Stable Version](https://camo.githubusercontent.com/7c0fb494c47b4b4a43e984b3454b3cc566db84a8023746d4e95516a72f291423/68747470733a2f2f706f7365722e707567782e6f72672f6f756d61727472616f72652f6c6f672d7265616465722f76)](//packagist.org/packages/oumartraore/log-reader)[![Total Downloads](https://camo.githubusercontent.com/c09a7d97e1446f6a39fe0469062096232646a4c308c6e9f5bf4116b347931007/68747470733a2f2f706f7365722e707567782e6f72672f6f756d61727472616f72652f6c6f672d7265616465722f646f776e6c6f616473)](//packagist.org/packages/oumartraore/log-reader)[![Latest Unstable Version](https://camo.githubusercontent.com/f21f73abecc4782b624ed571875ca218d1a7bcb11f2002f0a605b8bb6c13871a/68747470733a2f2f706f7365722e707567782e6f72672f6f756d61727472616f72652f6c6f672d7265616465722f762f756e737461626c65)](//packagist.org/packages/oumartraore/log-reader)[![License](https://camo.githubusercontent.com/61c50cf6089318ae62d45c94a4f994ca862cda665e4a5ba9af494e35aa9a3352/68747470733a2f2f706f7365722e707567782e6f72672f6f756d61727472616f72652f6c6f672d7265616465722f6c6963656e7365)](//packagist.org/packages/oumartraore/log-reader)

Installation
------------

[](#installation)

### Using composer

[](#using-composer)

In your project, call `bash composer require oumartraore/log-reader`.

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use OumarTraore\LogReader\LogService;

$path = '...';

$logService = new LogService();
$logService->getLogsFromFile($path);
```

### Paginate

[](#paginate)

```
use OumarTraore\LogReader\LogService;

$path = '...';

$logService = new LogService();

$logFilterDto = new LogFilterDto();
$logFilterDto->setDirection(LogFilterDto::DIRECTION_BEFORE); // or LogFilterDto::DIRECTION_AFTER
$logFilterDto->setLimit(25);
$logFilterDto->setOffset(50);

$logService->getLogsFromFile($path, $logFilterDto);
```

### With Filter

[](#with-filter)

You can filter logs by:

- channels
- levels
- date

```
use OumarTraore\LogReader\LogService;

$path = '...';

$logService = new LogService();

$logFilterDto = new LogFilterDto();
$logFilterDto->setChannels(['channel_1', 'channel_2']);
$logFilterDto->setLevels(['level_1', 'level_2']);
$logFilterDto->setDateFrom(new \DateTime('2021-01-01 10:10:45'));
$logFilterDto->setDateTo(new \DateTime('2021-01-01 12:10:45'));

$logService->getLogsFromFile($path, $logFilterDto);
```

### With a custom pattern

[](#with-a-custom-pattern)

```
use OumarTraore\LogReader\LogService;

$path = '...';

$logService = new LogService();
$pattern = '/\[(?P.*)\] \[(?P[\w-]+)\] \[(?P\w+)\]: (?P[^\[\{]+) (?P[\[\{].*[\]\}]) (?P[\[\{].*[\]\}])/';

$logService->getLogsFromFile($path, null, $pattern);
```

###  Health Score

16

—

LowBetter than 4% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity31

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/60544895?v=4)[Oumar Traore](/maintainers/traoreoumar)[@traoreoumar](https://github.com/traoreoumar)

---

Top Contributors

[![traoreoumar](https://avatars.githubusercontent.com/u/60544895?v=4)](https://github.com/traoreoumar "traoreoumar (9 commits)")

### Embed Badge

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

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

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B11.4k](/packages/psr-log)[open-telemetry/api

API for OpenTelemetry PHP.

1941.5M275](/packages/open-telemetry-api)[open-telemetry/sdk

SDK for OpenTelemetry PHP.

2328.5M340](/packages/open-telemetry-sdk)

PHPackages © 2026

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