PHP调试需启用错误报告、用var_dump/print_r检查变量、配置Xdebug断点调试、查错误日志及用内置服务器隔离测试。
如果您在运行 PHP 代码时遇到预期之外的输出、空白页面或错误提示不明确的情况，则可能是由于逻辑错误、变量未定义或执行流程异常所致。以下是多种实用的 PHP 代码调试方法与工具使用步骤：
一、启用错误报告并查看错误信息
PHP 默认可能隐藏了部分错误提示，开启错误显示可直接在浏览器或日志中看到警告、错误和语法问题。
1、在 PHP 脚本开头添加以下代码：
error_reporting(E_ALL); ini_set('display_errors', 1);
立即学习“PHP免费学习笔记（深入）”；
2、若需全局生效，编辑 php.ini 文件，将 display_errors 设置为 On，并将 error_reporting 设为 E_ALL。
3、保存后重启 Web 服务器（如 Apache 或 Nginx）使配置生效。
二、使用 var_dump() 和 print_r() 输出变量状态
这两个函数可用于检查变量类型、结构和值，适用于快速验证数据是否符合预期。
1、在关键位置插入 var_dump($variable); die();，强制中断执行并输出变量完整信息。
2、对数组或对象使用 print_r($array, true) 并配合 echo '' . ... . '
' 实现格式化显示。
3、避免在生产环境中保留此类调试语句，防止敏感信息泄露。
三、利用 Xdebug 进行断点调试
Xdebug 是功能强大的 PHP 扩展，支持单步执行、变量监视、堆栈追踪等，需配合 IDE（如 PHPStorm、VS Code）使用。
1、确认已安装 Xdebug 扩展，通过 php -m | grep xdebug 检查加载状态。
2、在 php.ini 中添加配置项：zend_extension=xdebug.so（Linux/macOS）或 zend_extension=php_xdebug.dll（Windows）。
3、设置 xdebug.mode=debug 与 xdebug.client_host=127.0.0.1，并启用远程调试端口（默认 9003）。
4、在 IDE 中配置监听，并在 PHP 脚本中设置断点，触发请求后即可进入交互式调试流程。
四、查看 PHP 错误日志定位问题根源
当 display_errors 关闭或页面空白时，错误通常记录在服务器错误日志中，该方式适用于线上环境排查。
1、查找 php.ini 中 error_log 配置项，确认日志文件路径（如 /var/log/php_errors.log）。
2、使用命令行实时监控日志变化：tail -f /var/log/php_errors.log。
3、复现问题操作，观察日志中最新出现的 Warning、Notice 或 Fatal error 内容。
五、使用内置 Web 服务器结合 CLI 调试
PHP 自带的内置服务器可脱离完整 Web 环境独立运行脚本，便于隔离环境干扰进行测试。
1、进入项目根目录，执行命令：php -S localhost:8000 router.php（router.php 可选，用于处理路由）。
2、在浏览器访问 http://localhost:8000/test.php，观察响应结果与终端输出的错误信息。
3、直接在命令行运行脚本：php test.php，查看 CLI 模式下的报错详情。
