WINDOWS下用VSCODE调试PHP7源代码

0.前言

在之前一段时间涉及PHP扩展开发,对PHP源代码有调试需求,然而网上大部分都是在LINUX下调试的教程,WINDOWS系统下的非常少并且过程也只是粗略一讲。所以决定自己尝试在WINDOWS下建立调试环境,毕竟,原理是相通的:)。

1.准备

以下是我开发机上的配置,可以和我保持一致减少因为工具版本而出现额外问题的几率。

1.Visual Code源代码编辑调试工具

2.Visual Studio Community2017(VS一般都把WIN下开发需要的东西都带全了,毕竟宇宙全家桶.....)
红色标注区域必须安装

WINDOWS下用VSCODE调试PHP7源代码_第1张图片
VS安装配置

3.PHP7源代码(也可以选择从github上拉取)
可以任意选择一个打包版本的源代码

WINDOWS下用VSCODE调试PHP7源代码_第2张图片
选择一个PHP源代码打包版本

4.PHP7-SDK
我的开发机是64位,因为是编译PHP7所以选择了64位的deps-7.1-vc14-x64(扩展依赖库包),建立php-sdk-binary-tools文件夹,将php-sdk-binary-tools-xxx.zip解压至这个文件夹中,建立deps-vc14-x64文件夹,也将deps-7.1-vc14-x64.7z解压至这个文件夹中。同时将php-sdk-binary-tools中的bin路径添加到WINDOWS系统变量PATH中。deps-7.1-vc14-x64本文暂时用不上,不过你也可以先下载下来,因为编译自带的一些扩展所依赖的库和头文件都包含在里面,当你要编译自带扩展的时候可以用上:)。

WINDOWS下用VSCODE调试PHP7源代码_第3张图片
PHP-SDK

2.编译源代码

安装VS后,运行在开始菜单里的Visual Studio 2017文件夹下的x64 Native Tools Command Prompt for VS 2017


WINDOWS下用VSCODE调试PHP7源代码_第4张图片

运行后,进入到PHP7源代码目录中

WINDOWS下用VSCODE调试PHP7源代码_第5张图片

1.执行buildconf.bat生成WIN下的configure文件(configure.js)
2.可以运行configure.bat --help查看支持的编译参数
3.执行configure.bat --disable-all --enable-cli --enable-debug(为了示范简单编译,可以自行添加参数)
4.执行nmake命令开始编译

以本机的配置,编译完成后的执行文件在源代码目录中的x64/Debug_TS下,后面就可以准备开始调试了。

3.使用VSCODE调试

调试方式可以分2种,一种是附加进程调试,一种是运行启动调试,两种方式都会介绍,先介绍运行启动调试。
先创建一个用于测试的php的源代码文件,我创建在源代码目录下的x64/Debug_TS里。

WINDOWS下用VSCODE调试PHP7源代码_第6张图片

随后选择菜单调试->打开配置,并选择C++(Windows)

WINDOWS下用VSCODE调试PHP7源代码_第7张图片

最后将配置文件修改如下所示

WINDOWS下用VSCODE调试PHP7源代码_第8张图片

我们之前编译了PHP SAPI的cli,我们打开sapi/cli/php_cli.c源文件,定位到1197行的main函数内打上断点。

WINDOWS下用VSCODE调试PHP7源代码_第9张图片

随后我们到VS的DEBUG控制面板运行调试即可。

WINDOWS下用VSCODE调试PHP7源代码_第10张图片

随后即可看到断点命中。

WINDOWS下用VSCODE调试PHP7源代码_第11张图片

附加进程调试配置也是大同小异,我们点击菜单选项调试->打开配置,并选择添加配置,在弹出来的选择列表中选择C/C++(Windows) Attach


WINDOWS下用VSCODE调试PHP7源代码_第12张图片

最后的配置文件如下:

WINDOWS下用VSCODE调试PHP7源代码_第13张图片

我们首先用PHP -S启动一个内置服务器(这个php一定要是你编译生成的php.exe文件),来方便演示附加进程调试,我启动的位置是在我们之前创建的test.php文件所在的目录下。

WINDOWS下用VSCODE调试PHP7源代码_第14张图片

访问效果如下:

启动调试的方式一样,在VSCODE的调试面板里面选择(Windows) Attach运行即可。

WINDOWS下用VSCODE调试PHP7源代码_第15张图片

随后在弹出来的进程列表中选择PHP进程后开始进入调试状态。

WINDOWS下用VSCODE调试PHP7源代码_第16张图片

我们test.php中使用了array_push函数,我们这次到这个函数的实现中断点,打开ext/standard/array.c,定位到2540行,打上断点。

WINDOWS下用VSCODE调试PHP7源代码_第17张图片

随后在浏览器中访问http://127.0.0.1:8080/test.php 即可触发断点。

WINDOWS下用VSCODE调试PHP7源代码_第18张图片

4.最后

本文的调试方式也可以作为扩展开发的调试方式,当然,同样的配置思路也适用于宇宙IDE Visual Studio,我在WINDOWS下配置VSCODE调试PHP源代码的思路也适用于其它平台(Mac/Linux......)。如果你感兴趣在Visual Studio中调试PHP源代码,不如以本文为思路尝试着自己思考动手来试试~

by zhiyanglee | email:[email protected]

你可能感兴趣的:(WINDOWS下用VSCODE调试PHP7源代码)