日志系统 (Log)
Anon Framework Next 提供了基于文件系统的日志组件，能够按天切割日志文件，并将不同类型的日志进行隔离。
默认情况下，所有的日志文件都会被写入到 runtime/log 目录下。
基础使用
通过 Anon\Core\Facade\Log 门面记录不同级别的日志。该方法接受字符串或数组，数组会自动转换为 JSON。
php
use Anon\Core\Facade\Log;
// 记录普通信息
Log::info('This is an info message.');
// 记录错误
Log::error(['error_code' => 500, 'message' => 'Something went wrong']);
// 记录调试信息（仅在 DEBUG_MODE=true 或 app.debug=true 时才会真正写入日志文件）
Log::debug('Debugging connection...');
// 记录警告
Log::warning('Disk space is running low.');内存缓冲日志 (Buffered I/O)
框架底层实现了日志缓冲池。当调用 Log 方法时，日志会先追加到内存中。 只有在以下两种情况才会批量写入磁盘：
- 请求生命周期结束时（通过
register_shutdown_function触发）。 - 单个请求产生的同类日志条数达到 1000 条。
这有效减少了频繁的磁盘 I/O 操作。
自定义日志通道 (分类)
日志方法接收可选的第二个参数 $type，表示日志的分类通道（默认是 'app'）。 当传入分类时，日志将被写入独立文件，例如 access.log 或 sql.log。
php
// 写入 runtime/log/YYYY-MM-DD/access.log
Log::info('User login successful', 'access');
// 写入 runtime/log/YYYY-MM-DD/sql.log
Log::debug('SELECT * FROM users', 'sql');调试模式专属日志 (Debug Mode)
为了在开发阶段提供充足的上下文，又不在生产环境产生大量的日志垃圾占用磁盘，框架专门为 Log::debug() 做了调试模式级别拦截：
- 依赖调试配置：只有在
.env*中设置DEBUG_MODE=true，或在anon.config.php中设置app.debug=true时，Log::debug()才会落盘。 - 生产环境静默：当调试模式关闭时，所有调用
Log::debug()的代码会直接返回，没有额外 I/O 开销。
最低写入级别 (log.level)
除 debug 方法的开关外，log() 统一走级别过滤：
配置 log.level | 行为 |
|---|---|
debug | 写入全部级别（默认：app.debug=true 时） |
info | 跳过 debug（默认：生产） |
warning | 仅 warning / error |
error | 仅 error |
php
// anon.config.php
'log' => [
'path' => RUNTIME_PATH . '/log',
'level' => 'warning',
// 按日目录保留天数；0 表示不自动清理
'max_files' => 14,
],也可运行时调整：
php
Log::setMinLevel('error');日志保留 (log.max_files)
日志按 Y-m-d 分子目录写入。flush() 时会删除早于 log.max_files 天的日期目录（默认 14）。设为 0 关闭自动清理。 动态调整 Debug 状态
你可以随时通过 setDebug() 方法动态更改调试记录状态（适用于某些需要临时开启高频日志的脚本）：
php
use Anon\Core\Facade\Log;
// 检查当前是否开启了 debug 模式
$isDebug = Log::isDebug();
// 临时在生产环境为某个复杂任务开启 debug 日志记录
Log::setDebug(true);
Log::debug('This will be logged regardless of DEBUG_MODE value');
Log::setDebug($isDebug); // 恢复原有状态异常接管
框架底层实现了全局异常处理器 Anon\Core\Exception\Handler。当发生 500 及以上级别的致命错误或未捕获异常时，系统会自动拦截并记录到 exception.log。
领域异常与 HTTP 异常的分工见 异常体系。