log.php library

Path in the Gestor bibliotecas/log.php

Two different things under the same prefix: file logs (log_disco, log_backtrace) and database history (log_debugar and three legacy functions). Registered as log; command-line scripts include it directly.

When included, it ensures $_GESTOR['debug'] (default false) and $_GESTOR['logs-path'] (default gestor/logs/, created if missing).

File log

log_disco('Import finished: 42 records', 'import');
// gestor/logs/import-2026-09-26.log
// [2026-09-26 14:03:11] Import finished: 42 records

• log_disco($msg, $file = 'gestor', $deleteBefore = false) appends the line with date and time to <logs-path><file>-<YYYY-MM-DD>.log. With $deleteBefore, it restarts the day's file.

• With $_GESTOR['debug'] on, it prints the message instead of writing it (useful on the CLI; in a web request, it lands in the middle of the HTML).

• log_backtrace($title, $file, $deleteBefore, $context) writes the current call stack with the request metadata (method, path, module, option, language and only the names of the GET/POST fields, never their values) and returns the stack. It is the tool to find out what triggered an unexpected alert or redirect.

Other files in gestor/logs/: hooks-errors.log (hooks), cron-<dd-mm-yyyy>.log (cron) and the atualizacoes/ and plugins/ subfolders of the update scripts.

Database history (historico)

The historico table records who changed what. The normal way to write it is through interface.php, which records the changes of CRUD forms. In this library:

• log_debugar(['alteracoes' => [[ 'modulo' => …, 'id' => …, 'alteracao' => …, 'alteracao_txt' => … ]]]) writes one row per change with the current user and the date. A single caller in the core.

• log_controladores(), log_usuarios() and log_hosts_usuarios() belong to the multi-host mode: they require id_hosts, read the record version from the given table (with id unescaped in the SQL) and have no callers.

Functions

log_debugar(array|false $params = false): void

log_controladores(array|false $params = false): void

log_usuarios(array|false $params = false): void

log_hosts_usuarios(array|false $params = false): void

log_backtrace(string $titulo = 'Encadeamento de chamada:', string $logFilename = 'gestor', bool $deleteFileAfter = false, array $contexto = Array()): string

log_disco(string $msg, string $logFilename = "gestor", bool $deleteFileAfter = false): void