之前写过一篇博客《PHP的学习--在sublime中使用XDebug（Ubuntu）》，讲了在Ubuntu系统 sublime 中配置 XDebug，其实配置好之后，我也很少用，原因有两点：一是正常情况下使用 var_dump 就够了，二是插件的快捷键太复杂，又没有相应的操作的按钮，使用太不方便。
后来，编辑器切换到了Atom，也就一直没尝试去使用 XDebug，最近想要了解一下 Laravel 的源码，想起了看看 Atom 是否有 XDebug 的工具，这一看，还真有，就是 php-debug 项目。发现其操作也比之前 sublime 上插件方便很多。不过在安装过程中遇到了一些坑，在这里记录一下。
首先安装 XDebug，命令如下 ：
brew install homebrew/php/php56-xdebug
我使用了 brew 去安装，因为之前装的 php56，所以 XDebug 也要安装相应的版本。
编辑 /usr/local/etc/php/5.6/conf.d/ext-xdebug.ini 文件，添加如下内容：
xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_connect_back=1 # Not safe for production servers
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_autostart=true
然后重启 php-fpm，这样 php XDebug 就配置好了。
关于上面配置项的相关解释可以查看之前的博客《PHP的学习--在sublime中使用XDebug（Ubuntu）》
有一点要注意的是，需要确认 9000 端口号没有被占用，如果已被占用，可以更换为其它端口号。
然后在 Atom 中安装 php-debug 插件，这个我就不细说了。
最后编辑 vim ~/.atom/config.cson 文件，添加如下内容：
"php-debug":
{
ServerPort: 9000
}
这里的端口号跟 XDebug 的配置保持一致即可。
你会发现这里要添加的内容跟 php-debug 的 doc 里的不太一样，doc 中的内容如下：
"php-debug":
{
ServerPort: 9000
PathMaps: [
"remotepath;localpath"
"/base/path/on/remote/system;C:\\base\\path\\on\\local\\system"
]
}
之前照着 doc 填进去了，没有看相关的解释，结果每次 Debug 时，都是跳到了空页面。后来重新读了一下 doc， 才发现这个问题。
PathMaps的解释是如果调试代码在远程机器上，使用PathMaps可以映射远程机器到本地机上。
所以如果我们只是在本地使用，根本就不需要这个配置。就因为这个，我纠结了小半天。。。
得到的经验是，一定要仔细阅读文档，一定要仔细阅读文档，一定要仔细阅读文档，重要的事情说三遍～～