PHP VLD扩展使用

PHP VLD扩展使用

VLD(Vulcan Logic Dumper)是一个挂钩在 Zend 引擎下,并且输出PHP脚本生成的中间件代码(执行单元)的扩展。它可以在一定程序上查看 Zend 引擎内部的一些实现原理,是我们学习PHP源码的必备良器。
安装扩展,这里省略
下面看一个简单例子,test.php文件
<?php
$a = 10;
echo $a;

 

在命令行下使用 VLD 扩展来展示信息

php -dvld.active=1 test.php

 

-dvld.active=1 表示激活VLD扩展,使用VLD扩展输出中间代码,在命令行输入信息如下

[root@localhost code]# /usr/local/php7.1.11/bin/php -dvld.active=1 test.php
Finding entry points                            # 找到入口点
Branch analysis from position: 0                # 分支分析的位置
Jump found. (Code = 62) Position 1 = -2         #
filename:       /test/code/test.php             # 分析的文件名
function name:  (null)                          # 函数名
number of ops:  3                               # 生成的操作数
compiled vars:  !0 = $a                         # 编译期间的变量,变量在PHP源码中以 IS_CV 标记
line     #* E I O op                           fetch          ext  return  operands
-------------------------------------------------------------------------------------
   2     0  E >   ASSIGN                                                   !0, 10
   3     1        ECHO                                                     !0
         2      > RETURN                                                   1

branch: #  0; line:     2-    3; sop:     0; eop:     2; out1:  -2
path #1: 0,
10

-dvld.verbosity=3 参数,查看更多详细信息,最大可以设置为3,再大输出效果一样
[root@localhost code]# /usr/local/php7.1.11/bin/php -dvld.active=1 -dvld.verbosity=3 test.php
Finding entry points
Branch analysis from position: 0
Add 0
Add 1
Add 2
Jump found. (Code = 62) Position 1 = -2
filename:       /test/code/test.php
function name:  (null)
number of ops:  3
compiled vars:  !0 = $a
line     #* E I O op                           fetch          ext  return  operands
-------------------------------------------------------------------------------------
144     0  E >   ASSIGN                                                    OP1[  IS_CV !0 ] OP2[ ,  IS_CONST (0) 10 ]
145     1        ECHO                                                      OP1[  IS_CV !0 ]
158     2      > RETURN                                                    OP1[  IS_CONST (1) 1 ]

branch: #  0; line:   144-  158; sop:     0; eop:     2; out1:  -2
path #1: 0,
10
以上信息与没有加 -dvld.verbosity=3 输出信息相比,多了 Add 字段,还有中间代码的操作数据类型,如 IS_CV,IS_CONST 等。
PHP代码代码中 $a = 10; 其中10的类型为 IS_CONST,$a作为一个编译期间的一个缓存变量存在,其类型为 IS_CV
-dvld.execute=0 禁止代码执行,只查看输出OPCODE信息
[root@localhost code]# /usr/local/php7.1.11/bin/php -dvld.active=1 -dvld.verbosity=3 -dvld.execute=0 test.php
Finding entry points
Branch analysis from position: 0
Add 0
Add 1
Add 2
Jump found. (Code = 62) Position 1 = -2
filename:       /test/code/test.php
function name:  (null)
number of ops:  3
compiled vars:  !0 = $a
line     #* E I O op                           fetch          ext  return  operands
-------------------------------------------------------------------------------------
144     0  E >   ASSIGN                                                    OP1[  IS_CV !0 ] OP2[ ,  IS_CONST (0) 10 ]
145     1        ECHO                                                      OP1[  IS_CV !0 ]
158     2      > RETURN                                                    OP1[  IS_CONST (1) 1 ]

branch: #  0; line:   144-  158; sop:     0; eop:     2; out1:  -2
path #1: 0,
VLD 扩展中可以设置的配置项。代码在VLD扩展源码 vld.c 文件中
PHP_INI_BEGIN()
    STD_PHP_INI_ENTRY("vld.active",       "0", PHP_INI_SYSTEM, OnUpdateBool, active,       zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.skip_prepend", "0", PHP_INI_SYSTEM, OnUpdateBool, skip_prepend, zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.skip_append",  "0", PHP_INI_SYSTEM, OnUpdateBool, skip_append,  zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.execute",      "1", PHP_INI_SYSTEM, OnUpdateBool, execute,      zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.verbosity",    "1", PHP_INI_SYSTEM, OnUpdateBool, verbosity,    zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.format",       "0", PHP_INI_SYSTEM, OnUpdateBool, format,       zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.col_sep",      "\t", PHP_INI_SYSTEM, OnUpdateString, col_sep,   zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.save_dir",     "/tmp", PHP_INI_SYSTEM, OnUpdateString, save_dir, zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.save_paths",   "0", PHP_INI_SYSTEM, OnUpdateBool, save_paths,   zend_vld_globals, vld_globals)
    STD_PHP_INI_ENTRY("vld.dump_paths",   "1", PHP_INI_SYSTEM, OnUpdateBool, dump_paths,   zend_vld_globals, vld_globals)
PHP_INI_END()

# 默认配置项
static void vld_init_globals(zend_vld_globals *vg)
{
    vg->active       = 0;
    vg->skip_prepend = 0;
    vg->skip_append  = 0;
    vg->execute      = 1;
    vg->format       = 0;
    vg->col_sep   = "\t";
    vg->path_dump_file = NULL;
    vg->dump_paths   = 1;
    vg->save_paths   = 0;
    vg->verbosity    = 1;
}

VLD扩展参数列表
  • -dvld.active 是否在执行PHP时激活VLD挂钩,默认为0,表示禁用。可以使用-dvld.active=1启用。
  • -dvld.skip_prepend 是否跳过php.ini配置文件中auto_prepend_file指定的文件, 默认为0,即不跳过包含的文件,显示这些包含的文件中的代码所生成的中间代码。此参数生效有一个前提条件:-dvld.execute=0
  • -dvld.skip_append 是否跳过php.ini配置文件中auto_append_file指定的文件, 默认为0,即不跳过包含的文件,显示这些包含的文件中的代码所生成的中间代码。此参数生效有一个前提条件:-dvld.execute=0
  • -dvld.execute 是否执行这段PHP脚本,默认值为1,表示执行。可以使用-dvld.execute=0, 表示只显示中间代码,不执行生成的中间代码。
  • -dvld.format 是否以自定义的格式显示,默认为0,表示否。可以使用-dvld.format=1, 表示以自己定义的格式显示。这里自定义的格式输出是以-dvld.col_sep指定的参数间隔
  • -dvld.col_sep 在-dvld.format参数启用时此函数才会有效,默认为 “\t”。
  • -dvld.verbosity 是否显示更详细的信息,默认为1,其值可以为0,1,2,3 其实比0小的也可以, 只是效果和0一样,比如0.1之类,但是负数除外,负数和效果和3的效果一样 比3大的值也是可以的,只是效果和3一样。
  • -dvld.save_dir 指定文件输出的路径,默认路径为/tmp。
  • -dvld.save_paths 控制是否输出文件,默认为0,表示不输出文件
  • -dvld.dump_paths 控制输出的内容,现在只有0和1两种情况,默认为1,输出内容

发表评论

电子邮件地址不会被公开。 必填项已用*标注