配置PHP调试需先安装Xdebug并设置php.ini，启用xdebug.mode=debug及client_port=9003；再通过Package Control安装SublimeTextXdebug插件；随后在Sublime中设断点并启动调试，浏览器访问时附加XDEBUG_SESSION_START=1参数触发断点，Sublime将连接并进入调试模式。
Sublime Text 配置 PHP 的 Xdebug 进行调试，需要结合 Xdebug 扩展、Web 服务器（如 Apache 或 Nginx）以及调试插件 SublimeTextXdebug 来实现。整个过程并不复杂，但需注意版本兼容和端口通信。
1. 安装并配置 Xdebug 扩展
确保你的 PHP 环境已安装 Xdebug，并在 php.ini 中正确配置：
- 打开 php.ini 文件（可通过
php --ini查看路径） - 添加以下配置（根据实际情况调整 IP 和端口）：
[XDebug] zend_extension=xdebug.so xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.log="/tmp/xdebug.log"
注意：PHP 8+ 推荐使用 xdebug.mode=debug 而非旧版的 xdebug.remote_enable=1。端口默认为 9003（新版 Xdebug），旧版可能用 9000。
2. 安装 Sublime Text 插件：SublimeTextXdebug
使用 Package Control 安装调试支持插件：
立即学习“PHP免费学习笔记（深入）”；
- 按下 Ctrl+Shift+P（Mac 为 Cmd+Shift+P）打开命令面板
- 输入 “Install Package”，选择对应选项
- 搜索并安装 SublimeTextXdebug
安装完成后无需额外配置，默认监听 9003 端口，与 Xdebug 匹配即可。
3. 配置项目断点并启动调试
在 Sublime Text 中打开 PHP 项目：
- 打开要调试的 PHP 文件
- 点击行号左侧或按 F9 设置断点
- 启动 Xdebug 监听：菜单栏选择 Tools → Xdebug → Start Debugging (Launch Browser)
此时 Sublime 开始监听 9003 端口。通过浏览器访问目标 PHP 页面，URL 中加上 XDEBUG_SESSION_START=1 参数，例如：
http://localhost/test.php?XDEBUG_SESSION_START=1
请求触发后，如果配置正确，Sublime 将进入调试模式，暂停在断点处。
4. 调试操作与常见问题
调试过程中可使用以下功能：
- F5：继续执行
- F10：单步跳过
- F11：单步进入函数
- 状态栏显示 “Xdebug: Connected” 表示连接成功
常见问题排查：
-
连接失败：检查防火墙是否阻止 9003 端口，或使用
netstat -an | grep 9003查看监听状态 - 断点无效：确认 Xdebug 日志是否有错误，路径映射是否一致（本地与服务器路径）
- 无法启动监听：重启 Sublime 或手动执行 “Xdebug: Start Debugging”
基本上就这些。只要 Xdebug 正确加载，Sublime 插件安装完成，断点调试就能顺利运行。适合轻量级开发环境使用。
