最近花了大约一星期的时间写了一个PHP扩展模块Opdumer,并封装成了Web服务(点击这里访问)。这个模块的主要内容是输出PHP代码对应的opcode。其实之前已经有一些用于查看opcode的扩展模块,如比较有名的vld。之所以重新实现一个这样的模块,主要是因为vld不支持PHP_FUNCTION API,也就是说vld只能用于CLI形式,而Opdumer同时拥有CLI API和PHP_FUNCTION API,另外,也想借助编写这个模块的机会学习Zend Engine中opcode的编译和执行机制。个人打算后面专门针对opcode的编译执行机制写一篇文章,而本文主要描述Opcode的使用方法及对应Web服务的使用。
Opdumper
安装
Opdumper的源码已经托管在github上,其地址为:https://github/ericzhang-cn/opdumper。可以通过以下命令克隆源代码:
git clone https://github/ericzhang-cn/opdumper.git
Opdumper是一个标准的PHP Extension,安装方法如下:
首先将Opdumper源码放到PHP源码包的ext/opdumper目录下,进入此目录执行如下命令:
phpize
./configure
make
make install
然后在php.ini中添加一行配置:
extension=opdumper
目前opdumper支持PHP>=5.3,在Linux和MacOS下测试通过,Windows下未做测试。
CLI API
Opdumper支持类似vld的命令行方式输出opcode,只需在执行php命令时通过-d参数将opdumper.active=1传入。例如我们有一个foo.php:
<?php
$a = 'hello';
echo $a;
?>
执行如下命令:
php -d opdumper.active=1 foo.php
结果如下:
PHP_FUNCTION API
Opdumper还支持vld不支持的PHP_FUNCTION API,Opdumper提供了两个PHP函数:od_dump_opcodes_string和od_dump_opcodes_file。前者接受一个字符串作为产生,字符串是一段PHP代码;后者接受一个PHP文件作为参数,返回值均是一个存有opcode结果的PHP数组。以od_dump_opcodes_file为例,我们在foo.php同一目录下再写一个bar.php:
<?php
$opcodes = od_dump_opcodes_file('./foo.php');
var_dump($opcodes);
?>
执行结果如下:
array(3) {
[0]=>
array(8) {
["lineno"]=>
int(2)
["opcode"]=>
string(11) "ZEND_ASSIGN"
["op1_type"]=>
string(2) "CV"
["op2_type"]=>
string(5) "CONST"
["result_type"]=>
string(0) ""
["op1"]=>
string(2) "~0"
["op2"]=>
string(5) "hello"
["result"]=>
string(0) ""
}
[1]=>
array(8) {
["lineno"]=>
int(3)
["opcode"]=>
string(9) "ZEND_ECHO"
["op1_type"]=>
string(2) "CV"
["op2_type"]=>
string(6) "UNUSED"
["result_type"]=>
string(6) "UNUSED"
["op1"]=>
string(2) "~0"
["op2"]=>
string(6) "UNUSED"
["result"]=>
string(6) "UNUSED"
}
[2]=>
array(8) {
["lineno"]=>
int(5)
["opcode"]=>
string(11) "ZEND_RETURN"
["op1_type"]=>
string(5) "CONST"
["op2_type"]=>
string(6) "UNUSED"
["result_type"]=>
string(6) "UNUSED"
["op1"]=>
string(1) "1"
["op2"]=>
string(6) "UNUSED"