如何配置Typo3/PHP使日志中堆栈跟踪逐行显示？

当前PHP（包括TYPO3）日志中的堆栈跟踪常出现所有条目挤在一行、以可见的\n分隔的问题，而Java的堆栈跟踪默认就是每行一个函数调用，可读性更强。以下是解决方法：

一、TYPO3专属配置方案 #

TYPO3基于Monolog实现日志系统，问题根源是日志格式化器默认转义了换行符，只需调整格式化器配置即可：

1. 在AdditionalConfiguration.php（推荐）或LocalConfiguration.php中添加自定义格式化器：

// 定义支持换行的日志格式化器
$GLOBALS['TYPO3_CONF_VARS']['LOG']['formatters']['lineBreakFormatter'] = [
    'className' => \Monolog\Formatter\LineFormatter::class,
    'options' => [
        'format' => "%datetime% [%level_name%] request=\"%extra.request_id%\" component=\"%channel%\": %message%\n",
        'allowInlineLineBreaks' => true, // 核心：允许换行符直接输出，不转义
        'ignoreEmptyContextAndExtra' => true,
    ],
];

2. 将该格式化器绑定到目标日志通道（比如你的Solr索引日志）：

$GLOBALS['TYPO3_CONF_VARS']['LOG']['ApacheSolrForTypo3']['Solr']['IndexQueue']['FrontendHelper']['PageIndexer']['processorConfiguration'] = [
    'formatter' => 'lineBreakFormatter',
];

配置后，Monolog会直接输出堆栈跟踪中的换行，让每个函数调用单独占一行。

二、通用PHP项目解决方案 #

如果是其他PHP应用，核心思路是避免转义堆栈中的换行符：

1. 手动捕获异常时，直接使用getTraceAsString()获取格式化好的多行堆栈：

try {
    // 业务代码
} catch (\Exception $e) {
    // 直接输出多行堆栈，无需转义
    error_log("错误信息：{$e->getMessage()}\n堆栈跟踪：\n{$e->getTraceAsString()}");
}

2. 若使用Monolog作为日志库，配置方式和TYPO3一致：
   创建LineFormatter实例时开启allowInlineLineBreaks，确保换行符不被转义。

关键原理 #

PHP的Exception::getTraceAsString()本身返回的就是多行字符串，问题出在日志处理环节：如果用json_encode处理异常信息，或者日志格式化器默认转义换行符，就会把换行变成可见的\n。只要让日志系统直接输出原始的多行字符串，就能实现类似Java的可读性堆栈。

内容的提问来源于stack exchange，提问作者fishbone