如何在PHP执行query函数时输出其所在的包含文件名？

嘿，我正好有个完美的解决方案，完全不用你修改现有的include语句或者自定义包装函数——利用PHP内置的debug_backtrace()函数就能精准获取query()被调用时所在的文件！

问题的关键在于，__FILE__只能返回当前函数所在的文件（也就是你的includes/functions.php），而debug_backtrace()可以帮我们拿到调用这个函数的代码所在的文件路径，这正是你需要的信息。

具体实现步骤： #

• 只需要修改你的query()函数，在内部加入调用栈追踪逻辑，完全不影响现有业务代码。
• debug_backtrace()返回的数组中，索引1对应的就是调用query()的那一层上下文（索引0是函数自身的信息），我们可以从中提取出调用文件的路径。

改造后的query()函数示例： #

假设你原来的query()函数是这样的：

function query($sql) {
    // 原有逻辑：执行SQL并返回结果
    $result = mysqli_query($db_conn, $sql);
    return $result;
}

修改后：

function query($sql) {
    // 获取调用栈信息
    $call_stack = debug_backtrace();
    
    // 提取调用当前query()的文件（处理边界情况，避免数组越界）
    $calling_file = isset($call_stack[1]['file']) 
        ? basename($call_stack[1]['file'])  // 只取文件名，和你的示例一致
        : 'unknown-file';
    
    // 按照你的需求输出文件名和SQL语句
    echo $calling_file . ' ' . $sql . ' ';
    
    // 原有执行逻辑
    $result = mysqli_query($db_conn, $sql);
    return $result;
}

验证你的场景： #

当页面加载时：

1. 入口文件包含file.php
2. file.php调用query('SELECT * FROM clients')
3. query()内部通过debug_backtrace()捕捉到调用它的是file.php
4. 函数输出file.php SELECT * FROM clients，和页面的<h1>Page</h1>一起渲染，完全符合你的预期

额外优化建议： #

• 可以添加一个调试开关，避免生产环境输出调试信息：

  // 全局开关或者通过参数控制
  define('DEBUG_QUERIES', true);
  
  function query($sql) {
      if (DEBUG_QUERIES) {
          $call_stack = debug_backtrace();
          $calling_file = isset($call_stack[1]['file']) ? basename($call_stack[1]['file']) : 'unknown-file';
          echo $calling_file . ' ' . $sql . ' ';
      }
      // 原有逻辑...
  }
  

• 如果需要完整文件路径，去掉basename()直接使用$call_stack[1]['file']即可。

这个方案完全不需要修改任何现有include语句，只需要改动一次query()函数就能解决问题，非常适合你的需求！

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