ThinkPHP如何优雅打印错误日志：包含参数、行号和原因？

在ThinkPHP中，优雅地打印错误日志可以帮助开发者快速定位和解决问题。你可以通过以下步骤来实现包含参数、行号和原因的日志记录。

1. 使用Log类记录日志

ThinkPHP提供了Log类来记录日志。你可以使用Log::error()方法来记录错误日志。

2. 获取调用堆栈信息

为了获取错误发生的行号和文件路径，可以使用debug_backtrace()函数来获取调用堆栈信息。

3. 记录参数信息

你可以在日志中记录调用时的参数信息，以便更好地理解错误发生的上下文。

示例代码

以下是一个示例代码，展示了如何优雅地记录错误日志：

use think\facade\Log;

function logError($message, $params = []) {
    // 获取调用堆栈信息
    $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1);
    $file = $backtrace[0]['file'] ?? 'unknown';
    $line = $backtrace[0]['line'] ?? 0;

    // 构造日志信息
    $logMessage = sprintf(
        "Error in %s on line %d: %s\nParams: %s",
        $file,
        $line,
        $message,
        json_encode($params, JSON_PRETTY_PRINT)
    );

    // 记录日志
    Log::error($logMessage);
}

// 示例使用
try {
    // 模拟一个可能抛出异常的操作
    $result = someFunctionThatMightFail($param1, $param2);
} catch (\Exception $e) {
    // 记录错误日志
    logError($e->getMessage(), ['param1' => $param1, 'param2' => $param2]);
}

解释

• debug_backtrace()：获取调用堆栈信息，DEBUG_BACKTRACE_IGNORE_ARGS参数表示忽略参数信息，1表示只获取最近的一层堆栈信息。
• sprintf()：格式化日志信息，包含文件路径、行号、错误信息和参数。
• Log::error()：将格式化后的日志信息记录到错误日志中。

日志输出示例

假设someFunctionThatMightFail函数在/path/to/file.php的第42行抛出了一个异常，日志可能会如下所示：

Error in /path/to/file.php on line 42: Some error message
Params: {
    "param1": "value1",
    "param2": "value2"
}

注意事项

• 确保日志文件有适当的权限，以便应用程序可以写入日志。
• 在生产环境中，建议将日志级别设置为error或更高，以避免记录过多的调试信息。
• 如果日志文件过大，可以考虑使用日志轮转工具（如logrotate）来管理日志文件。

通过这种方式，你可以更优雅地记录错误日志，帮助快速定位和解决问题。