亲宝软件园·资讯

展开

PHPStorm+Xdebug无法进入断点排查 PHPStorm+Xdebug进行emote Debug时无法进入断点问题排查

wowo_zZ 人气:3
想了解PHPStorm+Xdebug进行emote Debug时无法进入断点问题排查的相关内容吗,wowo_zZ在本文为您仔细讲解PHPStorm+Xdebug无法进入断点排查的相关知识和一些Code实例,欢迎阅读和指正,我们先划重点:phpstorm,xdebug,phpstorm,emote,Debug,phpstorm,断点,下面大家一起来学习吧。

最近一直在研究Xdebug的用法,主要是因为Xdebug对PHP的开发效率提升确实很大,而却能帮我们解决很多问题。所以这里就总结下我在配置PHPStorm+Xdebug环境中遇到的坑,给遇到进不去断点的朋友一些排查的建议。

运行环境

如果遇到无法进入断点的问题,可以按照以下的步骤进行排查

确认运行Web程序的PHP安装了Xdebug扩展

PHP永久了,难免会在电脑上多装几个版本。这个时候就必须注意,你是否将Xdebug安装到了你需要调试的PHP版本中,而且要注意,命令行运行的php,不一定是Web程序运行的PHP。例如你安装了PHP的5.6和7.1两个版本,命令行跑的是5.6,但fpm跑的是7.1。这时如果你给5.6安装Xdebug,你运行php -m | grep xdebug确实可以看到Xdebug扩展,但是如果想调试7.1运行的Web程序,当然是不可能的。所以这里最关键一点,就是:

在Web程序中输出phpinfo();exit; ,来确认运行fpm的php中是否安装了Xdubug扩展。

确认Xdebug扩展的版本与PHP版本匹配

如果你安装了Xdebug,但是版本与PHP不匹配,也是没办法正常工作的。如何正确的选择PHP对应的Xdebug版本。

确认Xdebug配置了有效的参数

在PHPStorm中调试不同的PHP程序,需要配置不同的Xdebug参数。在Remote Debug模式下:

必须要设置的参数有:

推荐设置的参数:

remote_autostart=1
默认状态下,触发调试需要在url中增加get参数:XDEBUG_SESSION_START= {xdebug.idekey},如果想自动启动调试,即不加这个参数也能自动触发调试,可以将这个值设为1,所以推荐将这个值设为1;

确认PHPStorm监听的端口是Xdebug中配置的端口

一定要在此确认Xdebug中配置的remote_port(最好使用打印出phpinfo来查看)和PHPStorm中配置的一致,否则无法进入调试。

确认PHPStorm中的debugclient顺利启动

在PHPStorm的工具栏中启动了Remote Debug之后,需要检查是否顺利启动了DebugClient进程。这个进程就是PHPStorm启动来进行调试的,所以只需要查看PHPStorm是否监听了我们设置的端口(remote_port)就可以了。例如我指定的端口是9001,那么在Mac上可以通过lsof -i tcp:9001命令查看:

确认PHPStorm中的IDEKey和Xdebug中配置的一致

一定要确认PHPStorm中配置的IDEKey和Xdebug中配置的idekey是一样的,否则无法进入调试。

代码部署在远程,需要开启目录映射

如果你是调试远程的Web程序(即代码不是部署在本机),必须要设置目录映射,否则找不到代码所在,是无法调试的。设置的方法如下图:

确认PHPStorm和Xdebug+PHP的版本匹配

使用Xdebug调试,是PHP进程通过Xdebug扩展和PHPStorm的debugclient通信的过程,所以必须这三方在版本上兼容才可以。有的时候碰到一些奇葩的问题,比如我就碰到过可以进入断点,但是无法单步调试(点击下一步调试进程就卡死)的情况。这种情况很有可能是PHPStorm的版本和Xdebug+PHP的版本不兼容。比如我碰到的这个问题就是因为我用了最新版本的Xdebug2.7,但是使用的PHPStorm却是2017.2的版本,而我将xdebug降到2.6之后就可以正常调试了。所以,最好保证PHPStorm、Xdebug和PHP的版本协调一致。

总结

如果按照上面说的还是不行,那么就需要查看remote_log,来看下问题到底出在哪了。
这个时候需要在xdebug的配置中增加:xdebug.remote_log=/tmp/xdebug.log来打开remote_log。
配置完成之后,重新启动fpm,查看phpinfo,确认remote_log生效之后(默认是不启动remote_log的)之后,调试的时候就可以tail -f /tmp/xdebug.log来查看日志了。举个例子,我故意将remote_port设置为一个不存在的9999端口,然后查看remote_log的报错信息:

从日志中看出,Xdebug尝试去连接127.0.0.1的9999端口,但是失败了。这样,我们就能看出到底问题出在哪里,当我们是在找不到配置的问题时,可以借助日志,再结合google、百度,看看能否找到问题的所在。

加载全部内容

相关教程
猜你喜欢
用户评论