Lecteur Markdown
ERROR_LOGS_DOCUMENTATION_EN
Feature: Error Logs #
Centralised PHP error dashboard. Aggregates fatal errors, warnings and notices, displays statistics, and allows filtering, suspending and deleting entries.
---
Installation and Configuration #
Via FTP: Upload the `error_logs/` directory into `/plugins/`.
Via package manager: Select `error_logs` from the available plugins list.
Paths:
- Main plugin: `/plugins/error_logs/error_logs.php`
- Configuration: `/plugins/error_logs/conf/error_logs.conf.inc.php`
- Handler: `/plugins/error_logs/handlers/`
- JavaScript: `/plugins/error_logs/js/`
Configuration parameters:
| Variable | Default | Description |
|---|---|---|
| `$basedisplevel` | `BASE_LEVEL_OVERMIND` | Reserved for super-admins |
| `$ftype` | `3` | Plugin type (system) |
Required SQL table: `error_logs`
Columns: `id`, `message`, `level`, `file`, `line`, `hits`, `last_seen`, `error_hash`, `status`
---
Usage #
Dashboard #
- Total active error count
- Breakdown by level (fatal, error, warning, notice)
Filtering #
- By error level
- By status (active / suspended)
Pagination: 50 errors per page.
Actions #
| Action | Description |
|---|---|
| View detail | Shows file, line and full message |
| Suspend | Marks the error as handled (logged to `var/hist.txt`) |
| Delete | Permanently removes the entry |
| Clear all | Deletes all error entries |
Deduplication: repeated errors increment the `hits` counter rather than creating new records (via `error_hash`).
---
Hooks and Entry Points #
POST actions:
action=suspend&id=ID — Suspend an error
action=delete&id=ID — Delete an error
action=clear_all — Clear all logs
---
Dependencies #
- `Beamreactor\Logger\ErrorLogger` — error collection
- `Beamreactor\Database\SQL`
- `Beamreactor\Notifications\Toast` — user feedback