PHP中如何获取函数调用时传入参数的变量名？

PHP本身没有原生函数直接实现这个需求——因为函数调用时变量会被解析为对应的值传递，变量名并不会保留在函数的执行上下文里。不过可以通过解析调用栈与源代码的方式间接实现。

实现思路 #

1. 用debug_backtrace()获取调用栈信息，定位到调用当前函数的代码行与对应文件。
2. 读取目标文件的源代码，提取函数调用语句中的参数部分。
3. 通过正则表达式匹配出传入的变量名。

示例代码 #

function testfunc($param = 'i do not want this..', $array = array()) {
    // 获取调用栈，忽略参数值以提升性能
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
    $callerInfo = $trace[0];
    
    // 校验调用文件是否可读取
    if (!file_exists($callerInfo['file'])) {
        var_dump('无法读取调用文件');
        return;
    }
    
    // 读取调用所在行的代码
    $sourceLines = file($callerInfo['file']);
    $callLine = trim($sourceLines[$callerInfo['line'] - 1]);
    
    // 正则匹配函数调用的参数列表
    preg_match('/testfunc\((.*?)\)/', $callLine, $matches);
    if (!isset($matches[1])) {
        var_dump('未匹配到有效参数');
        return;
    }
    
    // 处理参数，分割并去除多余空格
    $paramNames = array_map(function($item) {
        return trim($item);
    }, explode(',', $matches[1]));
    
    // 输出获取到的变量名
    var_dump($paramNames);
}

// 测试调用
$testString = '示例字符串';
$testArray = ['a', 'b', 'c'];
testfunc($testString, $testArray);

执行后会输出：

array(2) {
  [0]=>
  string(11) "$testString"
  [1]=>
  string(10) "$testArray"
}

局限性说明 #

• 若函数调用的代码是多行拆分（比如参数换行），正则表达式可能无法正确匹配。
• 如果参数中包含复杂表达式（如testfunc($a + $b, fn() => $c)），匹配结果会包含表达式而非单纯变量名。
• 若代码经过压缩、缓存，或调用文件存在权限问题无法读取，该方法会失效。

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