SilverStripe 4如何将内部服务器错误日志写入文件？

SilverStripe 4已经完全弃用了旧版的SS_Log体系，转而基于Monolog实现日志功能——这也是你按旧思路配置无效的核心原因。下面是一套经过验证的完整解决方案，帮你把所有500级内部服务器错误写入指定日志文件：

1. 先搞定日志目录权限（最容易踩坑的点） #

首先确保目标日志目录存在，并且Web服务器进程（比如www-data、apache）拥有读写权限，否则日志根本写不进去，看起来就像配置没生效：

sudo mkdir -p /var/log/silverstripe/
sudo chown www-data:www-data /var/log/silverstripe/
sudo chmod 755 /var/log/silverstripe/

2. 通过YAML配置Monolog StreamHandler #

SilverStripe 4的日志配置核心在app/_config/logging.yml文件（如果没有就新建）。我们要在这里注册一个针对ERROR级别的文件处理器，并关联到主日志实例：

SilverStripe\Core\Injector\Injector:
  # 给主Monolog实例添加自定义处理器
  Monolog\Logger:
    calls:
      - [pushHandler, ['%$ErrorFileHandler']]
  # 定义错误日志文件处理器
  ErrorFileHandler:
    class: Monolog\Handler\StreamHandler
    constructor:
      # 日志文件路径
      - '/var/log/silverstripe/errors.log'
      # 捕获ERROR及以上级别（包含CRITICAL、ALERT等致命错误）
      - 'Monolog\Logger::ERROR'
    properties:
      # 使用SilverStripe自带的详细格式化器，包含堆栈追踪
      formatter: '%$DetailedFormatter'
  # 配置详细日志格式
  DetailedFormatter:
    class: SilverStripe\Logging\DetailedFormatter

3. 捕获PHP致命错误（避免遗漏极端场景） #

有些Internal Server Error来自PHP致命错误（比如未定义函数、内存耗尽），默认不会被Monolog自动捕获。我们可以注册一个全局 shutdown 处理器来兜底：

先在app/src/Extensions/MySiteLoggingExtension.php创建扩展类：

use SilverStripe\Core\Extension;
use SilverStripe\Control\Director;
use Monolog\Logger;
use SilverStripe\Core\Injector\Injector;

class MySiteLoggingExtension extends Extension
{
    public function onAfterInit()
    {
        // 仅在非开发环境生效，避免本地调试日志泛滥
        if (!Director::isDev()) {
            register_shutdown_function(function () {
                $lastError = error_get_last();
                // 捕获PHP致命级错误
                if ($lastError && in_array($lastError['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
                    $logger = Injector::inst()->get(Logger::class);
                    $logger->critical(
                        "Fatal PHP Error: {$lastError['message']}",
                        [
                            'file' => $lastError['file'],
                            'line' => $lastError['line'],
                            'error_type' => $lastError['type']
                        ]
                    );
                }
            });
        }
    }
}

然后在app/_config/config.yml中注册这个扩展：

SilverStripe\Control\Director:
  extensions:
    - MySiteLoggingExtension

4. 测试配置是否生效 #

手动触发一个内部服务器错误验证，比如在某个控制器里写：

public function index()
{
    // 触发致命错误
    undefinedFatalFunction();
}

访问该页面后，查看/var/log/silverstripe/errors.log，应该能看到包含详细堆栈信息的错误记录。

常见排查点 #

• 如果日志没生成，优先检查目录权限，确保Web服务器进程能写入
• 确认YAML配置没有语法错误（可以用本地编辑器的YAML校验功能检查）
• 开发环境中SilverStripe默认会直接显示错误而非写入文件，测试时可以临时在.env中设置SS_ENVIRONMENT_TYPE=live

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