本文将详细介绍如何结合Phpstudy和VSCode搭建php开发调试环境,非常适合刚刚入门的小白。

1 Phpstudy下载、安装和配置

Phpstudy在Windows端提供了配置LNMP、LAMP服务器环境的一键式解决方案,支持php多版本共存与切换,非常适合使用其在Windows端进行php开发和调试。

Phpstudy官网:https://www.xp.cn/
Phpstudy下载地址:https://www.xp.cn/download.html

1.1 下载

这里我们选择下载phpstudy v8.1 64位。

1.2 安装

使用的默认安装路径,默认安装路径为:D:\phpstudy_pro

1.3 配置

1.3.1 php开启xdebug调试组件

在软件管理,找到需要使用的php版本(默认的是php7.3.4nts),点击设置

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

在设置-扩展组件开启xdebug调试组件,并勾选Profiler输出,Trace输出,端口监听默认为9000,这里修改为9001

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

1.3.2 修改php.ini

在D:\phpstudy_pro\Extensions\php\php7.3.4nts中找到php.ini文件,或者从设置-配置文件中打开php.ini文件

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

如果按照1.3.2节中开启了XDebug调试组件,那么在php.ini中会生成以下关于xdebug的配置内容

[Xdebug]
zend_extension=D:/phpstudy_pro/Extensions/php/php7.3.4nts/ext/php_xdebug.dll
xdebug.collect_params=1
xdebug.collect_return=1
xdebug.auto_trace=On
xdebug.trace_output_dir=D:/phpstudy_pro/Extensions/php_log/php7.3.4nts.xdebug.trace
xdebug.profiler_enable=On
xdebug.profiler_output_dir=D:/phpstudy_pro/Extensions/php_log/php7.3.4nts.xdebug.profiler
xdebug.remote_enable=Off
xdebug.remote_host=localhost
xdebug.remote_port=9001
xdebug.remote_handler=dbgp

我们可以将remote_enable修改为On,然后增加xdebug.remote_autostart=On,修改完成的配置信息如下

[Xdebug]
zend_extension=D:/phpstudy_pro/Extensions/php/php7.3.4nts/ext/php_xdebug.dll
xdebug.collect_params=1
xdebug.collect_return=1
xdebug.auto_trace=On
xdebug.trace_output_dir=D:/phpstudy_pro/Extensions/php_log/php7.3.4nts.xdebug.trace
xdebug.profiler_enable=On
xdebug.profiler_output_dir=D:/phpstudy_pro/Extensions/php_log/php7.3.4nts.xdebug.profiler
xdebug.remote_enable=On
xdebug.remote_autostart=On
xdebug.remote_host=localhost
xdebug.remote_port=9001
xdebug.remote_handler=dbgp

2 VSCode配置php调试环境

2.1 下载安装PHP Debug插件

点击左侧边栏最后一个图标插件,然后搜索PHP Debug,安装即可

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

2.2 配置php.validate.executablePath

点击文件 - 首选项 - 设置

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

然后在设置中搜索php,点击在settings.json中编辑

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

然后将php.validate.executablePath"设置为phpstudy中的php的路径。

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

2.3 编辑launch.json文件

在运行和调试中,点击创建launch.json文件,

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

然后在调试里面选择PHP

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

在launch.json中添加一个xdebug的配置,或者找到已经存在的配置进行修改,一般来说会有xdebug的配置

{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9001
}
Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

这里要注意的是,需要将launch.json中的xdebug的端口和phpstudy的xdebug的端口保持一致,这里都是使用的是9001。

3 Php调试

新建一个index.php文件,代码为

<?php
$a = 'hello world';
echo $a;
?>

将index.php文件放到phpstudy默认的网站目录D:\phpstudy_pro\WWW中,然后在phpstudy中开启nginx或者Apache

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

在VSCode中打开D:\phpstudy_pro\WWW目录,并且在index.php打一个断点,然后在运行与调试中,点击Listen to Xdebug

Phpstudy+VSCode搭建php开发调试环境保姆级教程-StubbornHuang Blog

然后在浏览器中访问localhost/index.php即可在VSCode中命中断点。

好了,到此整个使用Phpstudy+VSCode搭建Php开发调试环境的教程就结束了,应该还是比较详细的。