PHPackages                             cyberland-international/laravel-global-audit - 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. cyberland-international/laravel-global-audit

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

cyberland-international/laravel-global-audit
============================================

Simple Global Eloquent audit logging for Laravel

v1.0.7(4mo ago)0228↓50%MITPHPPHP ^8.1

Since Dec 15Pushed 4mo agoCompare

[ Source](https://github.com/cyberland-international/laravel-global-audit)[ Packagist](https://packagist.org/packages/cyberland-international/laravel-global-audit)[ RSS](/packages/cyberland-international-laravel-global-audit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (2)Versions (9)Used By (0)

Laravel Global Audit
====================

[](#laravel-global-audit)

Simple, automatic Eloquent audit logging for Laravel applications.

This package records create, update and delete events for your Eloquent models into a dedicated `global_audit_logs` table.

---

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

[](#installation)

Require the package via Composer:

```
composer require cyberland-international/laravel-global-audit
```

Laravel 10+ will auto-discover the service provider.

If you prefer to register it manually, add this to `config/app.php`:

```
'providers' => [
    // ...
    Cyberland\GlobalAudit\GlobalAuditServiceProvider::class,
],
```

---

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

[](#configuration)

Publish the config and migration files:

```
php artisan vendor:publish --provider="Cyberland\GlobalAudit\GlobalAuditServiceProvider" --tag=config
php artisan vendor:publish --provider="Cyberland\GlobalAudit\GlobalAuditServiceProvider" --tag=migrations
```

This will publish:

- Config: `config/global-audit.php`
- Migration: `database/migrations/0000_00_00_000000_create_global_audit_logs_table.php`

Run the migration:

```
php artisan migrate
```

Open `config/global-audit.php` to adjust:

- Which models are audited
- Which attributes are ignored
- User resolution logic, etc. (depending on your config options)

---

Usage
-----

[](#usage)

Once installed, the package listens globally to Eloquent model events and records audit logs whenever a model is created, updated or deleted (according to your config).

You can query the audit logs via the `GlobalAuditLog` model:

```
use Cyberland\GlobalAudit\Models\GlobalAuditLog;

$logs = GlobalAuditLog::latest()->take(50)->get();
```

Each log entry typically contains:

- `user_id` (Auth ID)
- `http_method`
- `event` (e.g. `created`, `updated`, `deleted`)
- `model_type` and `model_id`
- `ip_address`
- `url`
- `user_agent`
- `changes` (JSONB) (contains `old`, `new`, and `dirty`)
- Timestamps (created\_at)

> Note: Adjust the exact fields above to match your `global_audit_logs` migration.

---

Scoping and Filtering
---------------------

[](#scoping-and-filtering)

You can filter logs by model, user, or event, for example:

```
use Cyberland\GlobalAudit\Models\GlobalAuditLog;
use App\Models\User;

$logs = GlobalAuditLog::where('model_type', User::class)
    ->where('event', 'updated')
    ->get();
```

Feel free to add your own scopes on the `GlobalAuditLog` model to encapsulate common queries.

---

Manual logging (facade)
-----------------------

[](#manual-logging-facade)

In addition to model lifecycle events, you can manually create audit logs for actions that do not involve Eloquent models (e.g. logins, logouts, custom API calls).

First, (optionally) register the facade alias in your application's `config/app.php`:

```
'aliases' => [
    // ...
    'GlobalAudit' => Cyberland\\GlobalAudit\\Facades\\GlobalAudit::class,
],
```

Then you can log events anywhere in your application, for example in an auth controller:

```
use GlobalAudit; // if alias is registered
use Illuminate\Http\Request;

class AuthController extends Controller
{
    public function login(Request $request)
    {
        $credentials = $request->only('email', 'password');

        if (! auth()->attempt($credentials)) {
            GlobalAudit::log(__METHOD__, [
                'status' => 'failed',
                'email' => $request->input('email'),
                'guard' => 'web',
            ]);

            return response()->json(['message' => 'Invalid credentials'], 401);
        }

        $user = auth()->user();

        GlobalAudit::log(__METHOD__, [
            'status' => 'success',
            'user_id' => $user->id,
            'email' => $user->email,
        ]);

        return response()->json(['message' => 'Logged in']);
    }
}
```

The `log` method signature is:

```
GlobalAudit::log(string $event, array $changes = [], ?\Illuminate\Contracts\Auth\Authenticatable $user = null): GlobalAuditLog
```

- `$event` is a short descriptor of what happened (e.g. `__METHOD__`, `'login'`, `'logout'`, `'api_call'`).
- `$changes` is any contextual data you want to store (sensitive keys listed in `global-audit.hidden` will be removed).
- `$user` is optional; when omitted, the current authenticated user (if any) is used.

---

### Middleware-based logging

[](#middleware-based-logging)

Instead of calling the facade in every controller method, you can centralize logging using the built-in middleware `Cyberland\GlobalAudit\Http\Middleware\GlobalAuditRequestMiddleware`. It records the controller action name in the `event` column and uses `config('global-audit.middleware')` for basic scoping.

Make sure the middleware alias is registered in your application:

```
// app/Http/Kernel.php

protected $routeMiddleware = [
    // ...
    'global.audit' => \Cyberland\GlobalAudit\Http\Middleware\GlobalAuditRequestMiddleware::class,
];
```

Then you can enable and scope it via your published `config/global-audit.php`:

```
// config/global-audit.php

'middleware' => [
    'enabled' => true,
    'only' => [
        'api/*',
    ],
    'except' => [
        'telescope*',
        'pulse*',
    ],
],
```

#### Route-level usage

[](#route-level-usage)

Apply the middleware directly on routes or route groups:

```
use App\Http\Controllers\AuthController;

Route::middleware('global.audit')->group(function () {
    Route::post('/login', [AuthController::class, 'login']);
    Route::post('/logout', [AuthController::class, 'logout']);
});
```

#### RouteServiceProvider (Laravel 10-style)

[](#routeserviceprovider-laravel-10-style)

If you organize routes in your `RouteServiceProvider`, you can attach the middleware at that level:

```
// app/Providers/RouteServiceProvider.php

use Illuminate\Support\Facades\Route;

public function boot(): void
{
    $this->routes(function () {
        Route::middleware(['api', 'global.audit'])
            ->prefix('api')
            ->group(base_path('routes/api.php'));
    });
}
```

#### Laravel 11+ bootstrap/app middleware

[](#laravel-11-bootstrapapp-middleware)

In Laravel 11+, if you're using the `bootstrap/app.php` style, you can register the middleware there when configuring the HTTP kernel:

```
// bootstrap/app.php

use Cyberland\GlobalAudit\Http\Middleware\GlobalAuditRequestMiddleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        // ...
    )
    ->withMiddleware(function (Illuminate\Foundation\Http\Kernel $kernel) {
        $kernel->aliasMiddleware('global.audit', GlobalAuditRequestMiddleware::class);
    })
    ->create();
```

After that, use `'global.audit'` on your routes as shown above.

#### Controller constructor

[](#controller-constructor)

You can also attach the middleware at the controller level so all actions on that controller are audited:

```
use Illuminate\Routing\Controller;

class AuthController extends Controller
{
    public function __construct()
    {
        $this->middleware('global.audit');
    }

    // all methods here will pass through GlobalAuditRequestMiddleware
}
```

---

Testing
-------

[](#testing)

Run your test suite (if present) with:

```
php artisan test
```

or, if using PHPUnit directly:

```
phpunit
```

---

Requirements
------------

[](#requirements)

- PHP ^8.1
- Laravel 10.x (`illuminate/support` and `illuminate/database` ^10.0)

---

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance74

Regular maintenance activity

Popularity15

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

Total

8

Last Release

148d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2a37da50b35e325a241342ecf7072fc4244423bdae2904e62d28d8ee072b5051?d=identicon)[ronald-cyberland](/maintainers/ronald-cyberland)

---

Top Contributors

[![ronald-dytioco](https://avatars.githubusercontent.com/u/150100553?v=4)](https://github.com/ronald-dytioco "ronald-dytioco (13 commits)")

### Embed Badge

![Health badge](/badges/cyberland-international-laravel-global-audit/health.svg)

```
[![Health](https://phpackages.com/badges/cyberland-international-laravel-global-audit/health.svg)](https://phpackages.com/packages/cyberland-international-laravel-global-audit)
```

###  Alternatives

[spatie/laravel-activitylog

A very simple activity logger to monitor the users of your website or application

5.8k45.4M309](/packages/spatie-laravel-activitylog)[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[directorytree/metrics

Record metrics in your Laravel application

26027.8k](/packages/directorytree-metrics)[fumeapp/modeltyper

Generate TypeScript interfaces from Laravel Models

196277.9k](/packages/fumeapp-modeltyper)[masterro/laravel-mail-viewer

Easily view in browser outgoing emails.

6392.1k](/packages/masterro-laravel-mail-viewer)

PHPackages © 2026

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