VSCODE+PHP8.2配置踩坑记录 – WhiteNight's Site
我配置过的最恶心的环境之一:windows上的php。另一个是我centos服务器上的php。
进不了断点
端口配置和xdebug的安装
这个应该是最常见的问题了。从网上下载完php并解压到本地,打开vscode,安装php拓展和php server,php debug这两个调试用的拓展,敲下了人生中的第一段php代码
<?php
$a=1+2;
$b=$a*2;
phpinfo(); //测试用,能正常访问说明php环境配置是正常的
?>
接下来有几种情况:
- 右键代码,选择 reload server(php server拓展的功能),如果能正常打开phpinfo()的页面,说明你的php环境配置没问题。
phpinfo
这是比较好的情况,未来可期。接下来你可以试着打几个断点,先开debug调试,再reload server,看看能不能命中断点,命中的话在vscode的debug界面,左边有“变量”,“监视”啥的,变量那一栏会显示当前变量的值之类的的信息。
写者注
debug需要用vscode打开xxx.php所在的文件夹,再选中你要调试的php文件。
如果这一步也没问题,说明大功告成。能正常访问phpinfo()+能正常debug和命中断点的话,接下来就可以开始php之旅了。
但上面也说过这是最好的情况。实际上你可能会碰到以下几种情况。
- 无法访问phpinfo(),打开的页面显示request not found之类的。
- 能访问phpinfo(),但是设置了断点后,debug键都点烂了还是没法命中断点。
- 右键reload server不会自动打开浏览器界面,需要手动输localhost:port才能访问,而且访问的界面也是request not found(php server拓展默认reload server后会自动打开浏览器。如果没打开除了php的问题之外,也可能是你改拓展设置的时候不小心点到了)
- …
总之问题有很多,导致问题的原因也有很多。这里也只是举出我解决该问题的方法。由于php和xdebug的版本不同,该方法可能适用也可能一点用都没有,建议自己摸索。
部分解决方法
php 8.2与xdebug 3.3.0alpha2
上面是我的php和xdebug的版本。毕竟版本不同的话解决方法可能不通用。
除此之外,在vscode中你还应该安装以下三个拓展:
- php
- php debug
- php server
先来说说xdebug,这东西是必须要装的。不装这东西就没法debug调试。安装的话去xdebug官网下,记得下载的xdebug版本要和你用的php版本相匹配。
下载完之后,可以下载的dll重命名为php.xdebug.dll,方便后面的配置。然后扔进php的ext文件夹。接下来开始最重要的第一步:xdebug的配置。
打开php文件夹下的php.ini,在文件末尾输入
[XDebug]
zend_extension="F:\php\ext\php_xdebug.dll"
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.remote_host=localhost
xdebug.remote_port=9003
xdebug.remote_handler=dbgp
该配置仅能保证你能正常使用debug功能,其他的需要自己配置。
接下来开始第二步,vscode中debug的配置。在debug界面找到launch.json,开始配置端口。
配置文件的格式大致如下,其中最重要的是端口的配置。这里的端口需要和你在php.in中为xdebug配置的端口保持一致。
{
// 使用 IntelliSense 了解相关属性。
// 悬停以查看现有属性的描述。
// 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Listen for XDebug",
"type": "php",
"request": "launch",
"port": 9003
},
{
"name": "Launch currently open script",
"type": "php",
"request": "launch",
"program": "${file}",
"cwd": "${fileDirname}",
"port": 9003
}
]
}
之后再打断点-启动调试-启动php server,应该就不会出现问题了。