PHPackages                             decoda/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. decoda/audit

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

decoda/audit
============

Lightweight object logging for CodeIgniter 4

1.2(9mo ago)028MITPHPPHP ^7.4 || ^8.0

Since Sep 10Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/gsse/ci4-audit)[ Packagist](https://packagist.org/packages/decoda/audit)[ Docs](https://github.com/gsse/ci4-audit)[ RSS](/packages/decoda-audit/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (13)Used By (0)

Caution

This project is usable but still under development, feel free to clone and change as you wish.

Decoda\\Audit
=============

[](#decodaaudit)

Lightweight object logging for CodeIgniter 4

Attention: this project is still under development, feel free to clone and change as you wish.
==============================================================================================

[](#attention-this-project-is-still-under-development-feel-free-to-clone-and-change-as-you-wish)

Quick Start
-----------

[](#quick-start)

1. Install with Composer: `> composer require decoda/audit`
2. Update the database: `> php spark migrate -all`
3. Set up your models:

```
class JobModel extends Model
{
	use \Decoda\Audit\Traits\AuditTrait;
	protected $afterInsert = ['auditInsert'];
	protected $beforeUpdate = ['auditBeforeUpdate'];
	protected $afterUpdate = ['auditAfterUpdate'];
	protected $afterDelete = ['auditDelete'];
```

Features
--------

[](#features)

Provides ready-to-use object logging for CodeIgniter 4

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

[](#installation)

Install easily via Composer to take advantage of CodeIgniter 4's autoloading capabilities and always be up-to-date:

```
> composer require decoda/audit
```

Or, install manually by downloading the source files and adding the directory to `app/Config/Autoload.php`.

Once the files are downloaded and included in the autoload, run any library migrations to ensure the database is setup correctly:

```
> php spark migrate -all
```

Configuration (optional)
------------------------

[](#configuration-optional)

The library's default behavior can be altered by extending its config file. Copy **examples/Audit.php** to **app/Config/Audit.php** and follow the instructions in the comments. If no config file is found in **app/Config** the library will use its own.

Database
--------

[](#database)

Some applications may use audit logs in separate databases. If this is your scenario, you can set the database group in the `$dbGroup` property of the **Audit.php** configuration file, or set it in your .env file by adding the environment variable `audit.dbGroup = 'your database group'`

Usage
-----

[](#usage)

Once the library is included all the resources are ready to go and you just need to specify which models and events to audit. Use AuditTrait to add support to any models you would like tracked:

```
class JobModel extends Model
{
	use \Decoda\Audit\Traits\AuditTrait;
```

Then specify which events you want audited by assigning the corresponding audit methods for those events:

```
	protected $afterInsert = ['auditInsert'];
	protected $afterUpdate = ['auditUpdate'];
	protected $afterDelete = ['auditDelete'];
```

The Audit library will create basic logs of each event in the `audits` table, for example:

```
| id | source | source_id | user_id | event  | summary  |          created_at |
+----+--------+-----------+---------+--------+----------+---------------------+
| 10 | sites  |        27 |       9 | create | 2 rows   | 2019-04-05 15:58:40 |
| 11 | jobs   |        10 |       9 | update | 5 rows   | 2019-04-05 16:01:35 |

```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance58

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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

Recently: every ~1 days

Total

12

Last Release

279d ago

Major Versions

0.9 → 1.02025-08-09

### Community

Maintainers

![](https://www.gravatar.com/avatar/40f27c8eb64306d392f97ac4ed53bc351b8b171ae8694cd9a02d6ece1bc21615?d=identicon)[gsse](/maintainers/gsse)

---

Top Contributors

[![gsse](https://avatars.githubusercontent.com/u/27927275?v=4)](https://github.com/gsse "gsse (18 commits)")

---

Tags

auditingcodeigniter4php8loggingeventscodeigniterAuditcodeigniter4

### Embed Badge

![Health badge](/badges/decoda-audit/health.svg)

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

###  Alternatives

[tatter/audits

Lightweight object logging for CodeIgniter 4

1320.1k3](/packages/tatter-audits)[bedezign/yii2-audit

Yii2 Audit records and displays web/cli requests, database changes, php/js errors and associated data.

201657.4k4](/packages/bedezign-yii2-audit)[muhammadsadeeq/laravel-activitylog-ui

A beautiful, modern UI for Spatie's Activity Log with advanced filtering, analytics, and real-time features.

17510.1k](/packages/muhammadsadeeq-laravel-activitylog-ui)[tatter/outbox

Email toolkit for CodeIgniter 4

178.6k](/packages/tatter-outbox)[cornernote/yii-audit-module

Track and store usage information including page requests, database field changes and system errors.

226.6k](/packages/cornernote-yii-audit-module)

PHPackages © 2026

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