PHP调试常用五种方法：一、var_dump()和print_r()输出变量；二、启用错误日志记录；三、Xdebug配合IDE断点调试；四、内置Web服务器+echo验证流程；五、自定义错误/异常处理器。
如果您在编写PHP代码时遇到逻辑错误、变量值异常或程序意外终止等问题，需要借助调试手段定位问题根源。以下是几种常用的PHP代码调试方法和工具：
一、使用var_dump()和print_r()函数进行基础调试
这两个内置函数可用于快速输出变量的类型、结构和值，适用于开发环境中的简单排查。var_dump()显示更详细的信息，包括数据类型和长度；print_r()则以更易读的格式展示数组和对象。
1、在代码中需要检查的位置插入 var_dump($variable); 或 print_r($variable);。
2、确保PHP配置中 display_errors = On 且 error_reporting = E_ALL 已启用，以便错误和调试信息能直接输出到页面。
立即学习“PHP免费学习笔记（深入）”；
3、执行脚本后查看浏览器或命令行输出结果，确认变量内容是否符合预期。
二、启用错误报告与日志记录
通过配置PHP的错误处理机制，可将运行时错误、警告和通知写入日志文件，避免敏感信息暴露在前端，同时便于回溯问题发生的时间点和上下文。
1、在php.ini中设置 log_errors = On 并指定日志路径：error_log = /var/log/php_errors.log。
2、在脚本开头添加 error_reporting(E_ALL); ini_set('display_errors', '0'); 关闭页面输出，仅记录日志。
3、复现问题后，使用 tail -f /var/log/php_errors.log 实时查看最新错误条目。
三、使用Xdebug配合IDE进行断点调试
Xdebug是一个功能强大的PHP扩展，支持单步执行、断点、变量监视、堆栈跟踪等功能，需与支持远程调试的IDE（如PhpStorm、VS Code）协同工作。
1、安装Xdebug扩展，并在php.ini中添加配置：zend_extension=xdebug.so（Linux/macOS）或 zend_extension=php_xdebug.dll（Windows）。
用eclipse开发android程序的时,跟VS一样是可以断点单步调试的。 Eclipse Java编辑器不但能够为开发者提供代码编写、语法纠错和实时编译等常用功能，而且还能够对Java源代码进行快速修改、重构等高级操作。感兴趣的朋友可以过来看看
2、配置Xdebug启用远程调试：xdebug.mode=debug、xdebug.client_host=127.0.0.1、xdebug.client_port=9003（新版默认端口）。
3、在IDE中设置监听PHP Debug端口，于代码行号左侧点击设置断点，然后通过浏览器访问带 ?XDEBUG_SESSION_START=PHPSTORM 参数的URL触发调试会话。
四、使用PHP内置Web服务器配合echo调试
对于小型脚本或路由逻辑验证，可利用PHP自带的CLI Web服务器启动轻量环境，在关键路径插入echo语句观察执行流程是否进入预期分支。
1、进入项目根目录，运行 php -S localhost:8000 router.php 启动服务（router.php用于处理路由转发）。
2、在待调试的PHP文件中，在条件判断前后分别加入 echo "Reached step A"; exit; 和 echo "Reached step B"; exit;。
3、刷新页面并观察终端或浏览器输出，确认代码执行流是否按设想路径推进。
五、使用错误抑制符与自定义错误处理器捕获异常
通过set_error_handler()和set_exception_handler()可接管PHP默认的错误与异常处理逻辑，实现统一的日志格式、上下文快照或条件性中断，适用于需要精细控制调试行为的场景。
1、定义回调函数，例如：function debug_error_handler($errno, $errstr) { error_log("[$errno] $errstr at " . debug_backtrace()[0]['file'] . ":" . debug_backtrace()[0]['line']); }
2、注册该函数：set_error_handler('debug_error_handler');
3、在可能抛出异常的代码块外包裹try-catch，并在catch中调用 var_dump($e->getTraceAsString()); 输出完整调用栈。
