PHPackages                             meusistemabr/ci4-sqlite-logger - 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. meusistemabr/ci4-sqlite-logger

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

meusistemabr/ci4-sqlite-logger
==============================

Logger SQLite rotativo para aplicações CodeIgniter 4.

v1.1.2(3w ago)010MITPHPPHP >=8.1

Since May 9Pushed 2d agoCompare

[ Source](https://github.com/meusistemabr/ci4-sqlite-logger)[ Packagist](https://packagist.org/packages/meusistemabr/ci4-sqlite-logger)[ RSS](/packages/meusistemabr-ci4-sqlite-logger/feed)WikiDiscussions main Synced 1w ago

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

CI4 SQLite Logger 🛡️
====================

[](#ci4-sqlite-logger-️)

O CI4 SQLite Logger é uma biblioteca de logging de alta integridade para CodeIgniter 4. Diferente dos logs tradicionais em texto, ele armazena eventos em um banco de dados SQLite rotativo, utilizando uma Corrente de Custódia (Hash Chain) para garantir que os registros não sejam alterados ou deletados sem detecção.

✨ Recursos Principais
---------------------

[](#-recursos-principais)

- **Banco de Dados Rotativo:** Monitoramento automático do tamanho do arquivo com rotação inteligente.
- **Corrente de Custódia:** Cada log contém um hash SHA-256 que o vincula matematicamente ao log anterior.
- **Modo Performance (WAL):** Utiliza Write-Ahead Logging para permitir escritas rápidas sem travar a aplicação.
- **Dados Forenses:** Captura automática de IP (IPv4/IPv6), UUID, Device Info e porta remota.
- **Metadados de Segurança:** Identificação única do banco de dados para evitar substituição de arquivos.

🚀 Instalação
------------

[](#-instalação)

Instale a lib via Composer:

```
  composer require meusistemabr/ci4-sqlite-logger
```

⚙️ Configuração
---------------

[](#️-configuração)

Abra o arquivo `app/Config/Logger.php` instancie a biblioteca do SQLite Logger no início do arquivo, logo após as instâncias padrão do Codeigniter, adicione `use MeusistemaBR\Ci4SqliteLogger\SqliteHandler;` e, adicione o handler no array `$handlers` no mesmo arquivo, veja um exemplo:

```
  ...
  ...
  ...
  ...
  ... // bastante codigo acima e algumas instruções
  public $handlers = [
    // ... outros handlers
    SqliteHandler::class => [
        'handles'     => ['critical', 'error', 'debug', 'info', 'notice'],
        'dbPath'      => WRITEPATH . 'database/system_logs.db', // aqui você pode inserir o caminho do banco de dados que preferir, desde que possua permissão de leitura/escrita e espaço disponível. Você pode deixar essa variável vazia também, o caminho default é WRITEPATH . 'database/system_logs.db'
        'maxFileSize' => 10 * 1024 * 1024, // 10MB para rotação automática, você pode digitar valores maiores ou menores, ao chegar no limiar, o sistema "tranca" o Banco de Dados anterior e abre outro Banco de Dados para continuar.
    ],
];
```

🔍 Funções Forenses e Segurança
------------------------------

[](#-funções-forenses-e-segurança)

Pensamos nesta lib para logs no Codeigniter 4 principalmente não só para registrar e rastrear os registros de erros e ingestões de sua aplicação, mas também para oferecer garantia de, caso necessário, caso seu Software com nossa lib instalada passe por alguma perícia forense digita; ou análise de consistência, você poderá oferecer conformidade e confiabilidade.

### 1. Integridade de Dados (Hash Chain)

[](#1-integridade-de-dados-hash-chain)

Cada linha inserida gera um hash baseado em: `Hash Anterior + UUID + Nível + Mensagem + IP + Contexto`.Se um hacker apagar o log de um ataque, a corrente será quebrada, invalidando o banco.

### 2. Rastreabilidade Total

[](#2-rastreabilidade-total)

Diferente do log padrão, salvamos:

- **UUID:** Identificador único para rastrear uma falha específica.
- **Contexto JSON:** Dados estruturados para auditoria.
- **Fingerprint:** Informações do navegador e sistema operacional do originador.

### 3. Consulta dos Logs pelo Spark

[](#3-consulta-dos-logs-pelo-spark)

Exiba os 10 registros mais recentes do banco SQLite em uso:

```
php spark logs:tail
```

Informe uma quantidade entre 1 e 1000 para alterar o limite:

```
php spark logs:tail 25
```

Apoiado e mantido por
---------------------

[](#apoiado-e-mantido-por)

[![MeuSistema sistemas online personalizados](https://camo.githubusercontent.com/4b3d5471cc73052a142b3ff1d743b5c35340f238f1f59ab0bc0ea703ea37e8b2/68747470733a2f2f63646e2d61312d62722d736c2e6d657573697374656d612e636f6d2e62722f696d6167656e732f6c6f676f5f6d732e706e67)](https://camo.githubusercontent.com/4b3d5471cc73052a142b3ff1d743b5c35340f238f1f59ab0bc0ea703ea37e8b2/68747470733a2f2f63646e2d61312d62722d736c2e6d657573697374656d612e636f6d2e62722f696d6167656e732f6c6f676f5f6d732e706e67)

**Meu Sistema - Sistemas online personalizados**
Acesse: [https://meusistema.com.br](https://meusistema.com.br "Sistemas online personalizados")
Fale consoco em: contato\[at\]meusistema.com.br

Licença
-------

[](#licença)

[MIT](https://choosealicense.com/licenses/mit/)

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance97

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

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

Total

4

Last Release

21d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/93db6b03504d08e383e4b74262654393e7b00c95b9e98f769da44d42f1c15e3b?d=identicon)[meusistemabr](/maintainers/meusistemabr)

---

Top Contributors

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

---

Tags

ci4codeigniter4forensicslibrariesloggersphpsecurity-toolssqlite

### Embed Badge

![Health badge](/badges/meusistemabr-ci4-sqlite-logger/health.svg)

```
[![Health](https://phpackages.com/badges/meusistemabr-ci4-sqlite-logger/health.svg)](https://phpackages.com/packages/meusistemabr-ci4-sqlite-logger)
```

###  Alternatives

[psr/log

Common interface for logging libraries

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

API for OpenTelemetry PHP.

1938.5M259](/packages/open-telemetry-api)[open-telemetry/sdk

SDK for OpenTelemetry PHP.

2326.5M315](/packages/open-telemetry-sdk)[illuminated/console-logger

Logging and Notifications for Laravel Console Commands.

8676.7k](/packages/illuminated-console-logger)

PHPackages © 2026

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