CentOS xdebug 使用教程
一、前言
在PHP开发中，调试代码是一个必不可少的环节，对于初学者来说，使用简单的文本编辑器如Notepad++进行开发已经足够，但在学习深入之后，使用像PhpStorm这样的IDE结合Xdebug进行断点调试，可以极大地提高调试效率和代码质量，本文将详细介绍如何在CentOS环境下安装和配置Xdebug，并结合PhpStorm进行调试。
二、准备和系统说明
本文假设你使用的是CentOS 7操作系统，并且系统中安装了Nginx和PHP 7.0，你的centos系统是通过VMware虚拟化的，具备两个网卡：一个NAT模式用于上网，另一个hostonly模式用于与主机通信。
三、Xdebug的安装
1. 安装Xdebug
在CentOS上安装Xdebug可以通过以下步骤完成：
1.1 通过yum安装
- sudo yum search xdebug
- sudo yum install epelrelease
- sudo yum install xdebug
此方法会自动将xdebug.so放置在PHP的扩展目录中，并启用Xdebug。
1.2 手动编译安装
如果需要自定义安装，可以通过Xdebug官网提供的wizard生成安装指令：
打开[Xdebug wizard](https://xdebug.org/wizard.php)，输入php i命令的输出结果，解析后会给出详细的安装步骤：
- # 下载Xdebug源码
- wget https://xdebug.org/files/xdebug2.9.8.tgz
- tar xvzf xdebug2.9.8.tgz
- cd xdebug2.9.8
- # 运行安装脚本
- phpize
- ./configure
- make
- cp modules/xdebug.so /usr/local/php/lib/php/extensions/nodebugnonzts20151012/
- echo "zend_extension=/usr/local/php/lib/php/extensions/nodebugnonzts20151012/xdebug.so" >> /usr/local/php/etc/php.ini
2. 配置php.ini
安装完成后，需要配置php.ini文件以启用Xdebug：
- [Xdebug]
- zend_extension="/path/to/xdebug.so"
- xdebug.remote_enable=1
- xdebug.remote_host=127.0.0.1
- xdebug.remote_port=9000
- xdebug.remote_handler=dbgp
- xdebug.remote_mode=req
- xdebug.remote_autostart=1
- xdebug.idekey=PHPSTORM
- xdebug.profiler_enable=0
- xdebug.profiler_output_dir="/tmp"
请将/path/to/xdebug.so替换为实际的路径。
四、PhpStorm的配置
1. 配置Debug会话
在PhpStorm中，导航到Run >Edit Configurations，添加一个新的PHP Remote Debug配置：
IDE Key: PHPSTORM（与php.ini中的xdebug.idekey保持一致）
Debug port: 9000（与php.ini中的xdebug.remote_port保持一致）
Server: 填写你的CentOS服务器IP地址
Path mapping: 将本地项目目录映射到服务器上的相应目录
2. 开始调试
设置好后，在PhpStorm中打开需要调试的PHP文件，设置断点，然后点击调试按钮开始调试，访问对应的URL，触发断点，即可开始调试。
五、常见问题及解决方案
Q1: Xdebug未加载怎么办？
A1: 确保php.ini文件中正确配置了zend_extension路径，并检查是否有拼写错误，可以使用php m | grep xdebug命令检查Xdebug是否加载成功。
Q2: 无法连接到调试端口怎么办？
A2: 确保防火墙允许调试端口（默认9000）的通信，或者修改php.ini中的端口配置并同步修改PhpStorm中的配置，同时确保服务器IP地址和路径映射正确。
通过以上步骤，你应该能够在CentOS环境下成功安装和配置Xdebug，并结合PhpStorm进行高效的PHP代码调试，在实际开发中，掌握这些技能将大大提高你的开发效率和代码质量，希望这篇教程对你有所帮助！
