PHP | ReflectionGenerator getExecutingLine()函数

简介

ReflectionGenerator getExecutingLine() 函数是PHP 7.1及以上版本的反射扩展ReflectionGenerator类中的方法，用于获取当前Generator Object的执行指令行号。

语法

public ReflectionGenerator::getExecutingLine ( void ) : int

参数

此函数没有参数。

返回值

返回Generator Object的当前执行指令的行号，如果无法获取则返回 null。

示例

function generator(){
    echo "line 1\n";
    yield;
    echo "line 4\n";
}

$genObj = generator();
$reflectionObj = new ReflectionGenerator($genObj);

echo "Current executing line is: ".$reflectionObj->getExecutingLine()."\n";
$genObj->next();
echo "Current executing line is: ".$reflectionObj->getExecutingLine()."\n";

运行以上示例，会输出如下结果：

Current executing line is: 3
line 4
Current executing line is: 3

注意事项

• getExecutingLine()只能在Generator Object正在运行时才能获取到执行指令的行号，如果当前的Generator Object已经运行完毕，获取到的执行指令行号为 null。
• 可以通过ReflectionFunction::getStartLine()和ReflectionFunction::getEndLine()方法获取Generator函数所在代码段的开始行号和结束行号，从而得到Generator Object执行指令行号的大致范围。

总结

ReflectionGenerator getExecutingLine() 函数可以帮助程序员在Generator Object执行时获取执行指令的行号，如果需要对Generator Object进行动态分析或调试，该函数非常有用。同时需要注意的是，由于Generator Object的特殊性质，该函数无法像普通函数一样精准地获取到行号，但是可以通过结合 ReflectionFunction::getStartLine() 和 ReflectionFunction::getEndLine() 等方法对行号进行大致的定位。