最近花了大约一星期的时间写了一个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.com/ericzhang-cn/opdumper。可以通过以下命令克隆源代码:
git clone https://github.com/ericzhang-cn/opdumper.git
opdumper是一个标准的php extension,安装方法如下:
首先将opdumper源码放到php源码包的ext/opdumper目录下,进入此目录执行如下命令:
phpize
./configure
make
make install
然后在php.ini中添加一行配置:
extension=opdumper.so
目前opdumper支持php>=5.3,在linux和macos下测试通过,windows下未做测试。
cli api
opdumper支持类似vld的命令行方式输出opcode,只需在执行php命令时通过-d参数将opdumper.active=1传入。例如我们有一个foo.php:
执行如下命令:
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:
执行结果如下:
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
[result]=>
string(6) unused
}
}
opdumper的web服务:opcode dumper
坦白说,安装php模块还是挺麻烦的。所以为了方便朋友们查看opcode,我为opdumper搭建了一个在线web服务:http://supercompiler.com/app/opcode_dumper。
web页面访问
只要访问这个页面,在编辑框中输入或粘贴进php代码,就可以快速看到相应的opcode:
同时,也可以将结果下载到本地(csv文件格式)。
http api方式访问
您可以通过访问如下api获取php代码的opcode:
uri: http://supercompiler.com/api/dump_opcodes
method: post
params: php_script=[您的php代码]
返回值为json格式,成功时success字段为”true”,data字段存储opcodes;失败时success字段为”false”,msg字段存放失败原因。
由于跨越的关系,目前只能使用curl而不能使用ajax方式调用这个api,后续会为其增加jsonp接口。
结语
目前这个模块还比较初级,有很多需要完善的地方。也欢迎有兴趣的朋友通过github贡献代码。
原文链接:http://www.codinglabs.org/html/opdumper-and-web-opcode-dumper.html