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

运行环境

PHP Version 7.1.22

Xdebug v2.6.0

PHP2016.2；

操作系统：MacOS 10.12.3

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

确认运行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_enable=1 开启远程调试，不开启这个参数的话，自然无法Remote Debug;

remote_host=127.0.0.1(本机情况) or remote_connect_back=1,由于这两个配置项有紧密联系，所以放在一起讲。 首先，如果你指针对单个调试用户，比如就你自己调试，你可以将remote_host设成你的Web程序运行的ip（比如本机，就设置为127.0.0.1），remote_connect_back的值不设置或者设置为0（你不设置默认也是0）。这样Xdebug每次调试的时候会固定连接remote_host指定的ip；但是如果你支持的是多人调试，明显设置一个remote_host是没办法的。这个时候就可以用remote_connect_back=1来设置。当remote_connect_back设置为1的时候，xdebug会根据请求来的ip自动回连，进行调试，从而支持多人调试。同时，这个值设为1的话会使remote_host的设置无效；一般情况下，推荐使用remote_connect_back=1的配置

remote_port=9001 PHP进程与DebugClient通信的端口号，必须要设置与PHPStorm中的一致，否则无法正常通信；

idekey=PHPSTORM 可以理解为通信用到的口令，必须要设置与PHPStorm中的一致；

推荐设置的参数：

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、百度，看看能否找到问题的所在。