ZendStudio调试PHP必须启用匹配版本的Xdebug扩展并正确配置：Xdebug 3需设xdebug.start_with_request=off、client_host/port与IDE一致，且CLI与Web的php.ini均需生效；调试时PHP主动反向连接ZendStudio。
ZendStudio 调试 PHP 必须启用 Xdebug 且版本匹配
ZendStudio 本身不自带调试引擎，它依赖外部的 Xdebug 扩展完成断点、变量查看、单步执行等功能。如果点击“Debug”没反应、控制台无监听日志、或提示 Failed to connect to debugger，大概率是 Xdebug 没装、没启、或与 ZendStudio 版本不兼容。
关键点：
-
Xdebug 3.x和Xdebug 2.x的配置项完全不同，ZendStudio 13.6+ 支持 Xdebug 3，但旧版（如 13.5）可能仅稳定支持 Xdebug 2.9.x - 必须确认
phpinfo()页面中出现Xdebug模块，并且Loaded Configuration File指向你修改的php.ini - Windows 下扩展文件名是
php_xdebug.dll，Linux/macOS 是xdebug.so，路径错一个字符就加载失败
php.ini 中 Xdebug 3 配置要精简且关闭 IDE Key 自动检测
ZendStudio 默认不发送 XDEBUG_SESSION_START 参数，也不读取浏览器插件传的 IDE key，它靠主动连接（client mode）。所以 xdebug.start_with_request = trigger 或 on 都不行，必须设为 off，并启用远程连接模式。
zend_extension=xdebug.so xdebug.mode=debug xdebug.start_with_request=off xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.log=/tmp/xdebug.log xdebug.log_level=7
注意：xdebug.client_port 必须和 ZendStudio 中设置的端口一致（默认是 9003，不是旧版的 9000）。如果改过端口，两边必须同步；xdebug.log 开启后能直接看到连接拒绝、超时等底层错误，比 ZendStudio 界面提示更准。
立即学习“PHP免费学习笔记（深入）”；
ZendStudio 里 Debug Configuration 要选对 Server 和 PHP Executable
右键 PHP 文件 → Debug As → PHP Web Application，这时弹出的配置窗口里两个选项最容易错：
-
Server：不能只填http://localhost，必须是完整 URL（如http://localhost:8080/test.php），否则 ZendStudio 不知道该请求哪个脚本 -
PHP Executable：必须指向你实际运行php -v的那个二进制路径（如/usr/bin/php或C:\xampp\php\php.exe），而不是 ZendStudio 自带的 stub - 勾选
Break at first line有助于确认调试通道是否打通；不勾选时若断点没命中，先检查是不是脚本根本没被访问到
常见失败现象和对应排查动作
断点灰色不可用、Debug 启动后立刻结束、Console 显示 Waiting for Xdebug connection... 却一直等不到：
- 运行
php --ini和php -m | grep xdebug，确认 CLI 模式下 Xdebug 已加载（Web 和 CLI 的 php.ini 可能不同） - 在 ZendStudio 的
Window → Preferences → PHP → Debug中，检查Debugger是否选的是Xdebug，端口是否与php.ini一致 - 用
telnet 127.0.0.1 9003测试端口是否被 ZendStudio 监听（启动 Debug 配置后才监听） - 临时把
xdebug.log_level=7，复现一次，然后看日志末尾是否有Connection closed或Could not connect to debugging client
Xdebug 连接是“反向”的：PHP 进程主动连回 ZendStudio，不是 ZendStudio 去连 PHP。这个方向性一旦理解错，所有排查都会跑偏。
