ThinkPHP6 apart_level 参数怎么使用-ThinkPHP-PHP中文网

apart_level 是 ThinkPHP6 日志系统中用于按级别分离日志文件的配置项，值为小写字符串数组（如['info','error']），启用后对应级别日志将独立成文件（如29_info.log），仅对 type='File' 通道生效，且需 path 以/结尾、权限正确、不与 single=true 冲突。

thinkphp6 apart_level 参数怎么使用

apart_level 是 ThinkPHP6 日志系统中用于按日志级别自动分离文件的关键配置项，它让不同严重程度的日志（如 info、warning、error）各自写入独立的文件，便于排查和归档。

什么是 apart_level？

它是一个数组，定义哪些日志级别需要「单独成文件」。启用后，对应级别的日志不再混在主日志里，而是按日期+级别命名，例如：

runtime/log/202610/29_info.log
runtime/log/202610/29_warning.log
runtime/log/202610/29_error.log

注意：apart_level 只对 type => 'File' 的通道生效，且需配合正确的目录权限和路径格式。

怎么配置 apart_level？

在 config/log.php 的某个通道（比如默认的 file 通道）中添加：

'file' => [
    'type' => 'File',
    'path' => runtime_path() . 'log/',
    'apart_level' => ['info', 'warning', 'error'],
    'level' => ['info', 'notice', 'warning', 'error', 'critical'],
],

✅ 关键点：

apart_level 值必须是小写字符串数组，如 ['info', 'warning']
不能写成 'info,warning' 或 ['INFO','WARNING']，否则无效
它不影响日志是否记录，只控制「是否单独写文件」；是否记录由 level 控制
日志仍会照常写入主日志（如 202610/29.log），除非你禁用 single => true 或调整逻辑

配合自定义通道使用（如 pay、sql）

若想让支付日志单独存为 pay/202610/29_info.log，可这样配：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

'pay' => [
    'type' => 'File',
    'path' => runtime_path() . 'log/pay/', // 必须以 / 结尾
    'apart_level' => ['info', 'error'],
    'level' => ['info', 'error'],
    'single' => false,
],

然后调用：

Log::channel('pay')->info('订单ID:10001 创建成功');
Log::channel('pay')->error('支付回调验签失败');

生成的文件就是：

runtime/log/pay/202610/29_info.log
runtime/log/pay/202610/29_error.log

⚠️ 注意事项：

通道名必须全小写（'pay' ✅，'Pay' ❌）
path 结尾必须有 /，否则可能错写成 pay_pay.log
PHP 进程用户（如 www-data）需对 runtime/log/pay/ 目录有写权限，否则静默失败

和 level 的关系

level 决定「哪些级别允许写入该通道」
apart_level 是 level 的子集，决定其中哪些级别要「再拆成独立文件」
例如：'level'=>['info','error'] + 'apart_level'=>['error'] → info 写进主日志，error 单独成 xxx_error.log