启用错误报告、使用var_dump()和print_r()、error_log()记录日志、配置xdebug调试、使用assert()断言检查是php调试的五种基本方法。

如果您在运行 PHP 代码时遇到逻辑错误、变量值异常或脚本意外终止,但未输出明确错误信息,则可能是由于错误报告未启用、错误被静默忽略或调试手段缺失所致。以下是调试运行中 PHP 代码的多种基本方法:
一、启用错误报告与显示
PHP 默认可能关闭错误显示和详细错误报告,导致问题难以定位。通过修改运行时配置,可强制显示所有错误、警告和通知,便于即时发现语法与运行时问题。
1、在 PHP 脚本开头添加以下三行代码:
2、error_reporting(E_ALL);
立即学习“PHP免费学习笔记(深入)”;
3、ini_set('display_errors', '1');
4、ini_set('display_startup_errors', '1');
二、使用 var_dump() 和 print_r() 输出变量状态
这两个函数用于直观查看变量类型、结构与值,适用于检查数组、对象、布尔值等复杂数据的实际内容,是定位逻辑偏差最直接的手段。
1、在关键逻辑分支前后插入 var_dump($variable);
2、对数组或对象使用 print_r($array, true); 并配合 echo '' . ... . '
'; 实现格式化输出
3、调试完成后必须删除或注释掉所有此类语句,避免生产环境暴露敏感数据
三、利用 error_log() 记录调试信息到文件
当无法直接查看页面输出(如 AJAX 请求、CLI 脚本或 header 已发送场景),将调试信息写入日志文件可避免干扰响应流,且支持异步追踪。
1、调用 error_log('调试点A: $count=' . $count, 3, '/tmp/php_debug.log');
2、确保目标日志路径具有 Web 服务器用户(如 www-data 或 apache)的写入权限
3、使用 tail -f /tmp/php_debug.log 实时监控日志追加内容
四、配置 Xdebug 进行断点调试
Xdebug 是功能完整的 PHP 调试扩展,支持单步执行、变量监视、堆栈追踪与远程调试,需在 php.ini 中启用并配合 IDE 使用。
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、xdebug.client_port=9003
五、使用 assert() 设置运行时断言检查
assert() 可在开发阶段插入条件校验,当表达式为 false 时触发警告或异常,适合验证函数输入、中间状态或不变量是否成立。
1、启用断言:在脚本开头设置 assert_options(ASSERT_ACTIVE, 1);
2、插入断言语句:assert(is_array($data), 'Expected $data to be array');
3、可自定义断言失败处理器:assert_options(ASSERT_CALLBACK, 'my_assert_handler');










