PHPackages                             cerpus/cerpushelper - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. cerpus/cerpushelper

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

cerpus/cerpushelper
===================

Base package for common components

v2.3.0(1y ago)09.0k↓42.9%16GPL-3.0-onlyPHPPHP ^8.2CI passing

Since Dec 20Pushed 1y ago3 watchersCompare

[ Source](https://github.com/cerpus/php-cerpushelper)[ Packagist](https://packagist.org/packages/cerpus/cerpushelper)[ RSS](/packages/cerpus-cerpushelper/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (9)Versions (33)Used By (6)

Cerpus Helper
=============

[](#cerpus-helper)

This package contains some useful and common helper utilities for use in Laravel based projects.

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

[](#installation)

```
$ composer require cerpus/cerpushelper

```

Models/Traits/UuidAsId
----------------------

[](#modelstraitsuuidasid)

Let you use the primary key as UUID not the default auto incrementing value

### Usage

[](#usage)

In your model

```
namespace App;

use Cerpus\Helper\Models\Traits\UuidAsId;

...

class MyModel extends Authenticatable
{
    use UuidAsId;

    ...

```

Middleware/RequestId
--------------------

[](#middlewarerequestid)

Handle RequestId. Pick RequestId from request header and if that does not exist generate a new RequestId.

Adds the RequestId to response headers.

Include the RequestId when logging and requests to other systems to easily trace requests through different systems.

### Installation

[](#installation-1)

In the global middleware of your app `app/Http/Kernel.php`

```
  use Cerpus\Helper\Middleware\RequestId;
  ...
  protected $middleware = [
        RequestId::class,
        ...
    ];
```

You can also put it in front of API endpoints and the like to fine tune better.

### Usage

[](#usage-1)

To access the requestId in your app

`$requestId = app("requestId")`

### Profile

[](#profile)

Can support simple profiles in Laravel by adding subdirectories in the config folder and name it with the profile name as folder name. Add the config files(or only parts of it) in the profile folder to override the default values. *The name of the files must be identical to the one you want to override.*

```
|-- config
    |-- myprofile
        |-- setting.php
    |-- setting.php

```

Then import the "profile" function in the namespace area to use the logic.

```
use function Cerpus\Helper\Helpers\profile as config;
```

This will use the profile values, if found, instead of the default config values.

*Will look for 'app.deploymentEnvironment' in app.php if the function is not provided with a profile*

### Releases

[](#releases)

1.5.0 Updated to use auth0/auth0-php v7.5

License
-------

[](#license)

This package is released under the GNU General Public License 3.0. See the `LICENSE` file for more information.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance41

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~260 days

Total

26

Last Release

528d ago

Major Versions

v1.6.0 → v2.0.02021-12-03

v1.6.1 → v2.0.12022-02-01

PHP version history (6 changes)1.0.0PHP ^7.0

1.2.0PHP ^7.2

1.3.0PHP ^7.2|^7.3|^7.4

v1.6.0PHP ^7.4|^8.0

v2.2.0PHP ^8.0

v2.3.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/8c90acdd5f5be43c562112cef1f69ab98614691bc737089cb1becd9d6b22e046?d=identicon)[max\_edlib](/maintainers/max_edlib)

---

Top Contributors

[![cerpusoddarne](https://avatars.githubusercontent.com/u/28703438?v=4)](https://github.com/cerpusoddarne "cerpusoddarne (10 commits)")[![emmachughes](https://avatars.githubusercontent.com/u/84008144?v=4)](https://github.com/emmachughes "emmachughes (7 commits)")[![runarCerpus](https://avatars.githubusercontent.com/u/83068491?v=4)](https://github.com/runarCerpus "runarCerpus (3 commits)")[![jonepet](https://avatars.githubusercontent.com/u/51231558?v=4)](https://github.com/jonepet "jonepet (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cerpus-cerpushelper/health.svg)

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

###  Alternatives

[nativephp/mobile

NativePHP for Mobile

82724.0k43](/packages/nativephp-mobile)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)[pulkitjalan/ip-geolocation

IP Geolocation Wrapper with Laravel Support

89164.9k1](/packages/pulkitjalan-ip-geolocation)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[adrianorosa/laravel-geolocation

Laravel Geo Location package to get details for a given IP Address

6593.3k1](/packages/adrianorosa-laravel-geolocation)

PHPackages © 2026

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