PHPackages                             sherifai/clearcut - 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. sherifai/clearcut

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

sherifai/clearcut
=================

Laravel package for logging Http request/response in the database

2.0.0(6y ago)32.7kMITPHP

Since Feb 2Pushed 6y ago1 watchersCompare

[ Source](https://github.com/sherifalaa55/ClearCut)[ Packagist](https://packagist.org/packages/sherifai/clearcut)[ RSS](/packages/sherifai-clearcut/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

ClearCut
========

[](#clearcut)

Laravel package for logging Http requests/responses to database. It provides a middleware that handles request logging and sets a header "X-Request-Id" with a uuid for tracking each request. All logging is done in the background so it won't affect response time.

Features
--------

[](#features)

- Handles Request Logging to Database as a background job
- Provides a UUID for each request for tracking/debugging
- Dumps log table to laravel storage periodically
- Configurable to match or exclude certain requests

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

[](#installation)

Require the `sherifai/clearcut` package in your `composer.json` and update your dependencies:

```
$ composer require sherifai/clearcut
```

Next publish the configuration. This is an optional step, it contains some configurations that by default logs all requests.

```
$ php artisan vendor:publish
```

Next generate the migration file:

```
$ php artisan clearcut:migration
```

It will generate the <timestamp>\_request\_logs\_table.php migration.

Usage
-----

[](#usage)

To Start logging requests add LogRequests Middleware in Kernel.php

```
protected $middleware = [
    // ...
    \SherifAI\ClearCut\Middleware\LogRequests::class,
];
```

Clearcut then pushes the logging process to a background job.

Configuration
-------------

[](#configuration)

The configuration file `config/clearcut.php` conatins values for selectively logging requests. By default ClearCut Logs all requests. The most important configurations however are

1. `'dump_every' => 1000` which specifies the interval for logging requests before dumping the database.
2. `'storage_disk' => 'local'` which specifies the storage location for the dump file
3. `'queue_name' => 'clearcut'` which is the default queue for processing log job
4. `'enabled' => true` which determines of the package is working and storing request logs

Contribution
------------

[](#contribution)

Support follows PSR-2 PHP coding standards.

Please report any issue you find in the issues page. Pull requests are welcome.

License
-------

[](#license)

Released under the MIT License, see [LICENSE](LICENSE).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

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

Recently: every ~20 days

Total

6

Last Release

2373d ago

Major Versions

1.1.3 → 2.0.02019-11-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/9466bb779be5e5ea1be4c2e30182a3fae4de9058c730a1439f2e38ad8a94a68f?d=identicon)[sherifalaa55](/maintainers/sherifalaa55)

---

Top Contributors

[![sherifalaa55](https://avatars.githubusercontent.com/u/7817556?v=4)](https://github.com/sherifalaa55 "sherifalaa55 (10 commits)")

### Embed Badge

![Health badge](/badges/sherifai-clearcut/health.svg)

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

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork

php dev tools in your browser

5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php

A php implementation to send log-messages to a GELF compatible backend like Graylog2.

41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger

Official Bugsnag PHP PSR Logger.

32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log

Improved Psr-3 / Psr\\Log logger based on Symfony Console components.

15462.2M7](/packages/consolidation-log)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)

PHPackages © 2026

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