PHP调试需通过Web服务器或CLI执行，核心是让错误可见、执行可追踪、变量可观察：开启错误报告、用var_dump验证路径与数据、配置Xdebug断点调试、善用日志分析生产问题。
打开PHP文件后不能像普通文本那样“直接运行调试”，必须通过Web服务器（如Apache、Nginx）或CLI环境执行，再配合调试手段定位问题。核心思路是：让错误可见、让执行可追踪、让变量可观察。
开启错误报告，第一时间看到问题
很多PHP错误在默认配置下是静默失败的，比如require找不到文件、函数名拼错、语法错误等。先确保错误能被你看见：
- 在PHP文件开头加两行：
ini_set('display_errors', 1);
error_reporting(E_ALL); - 或者修改
php.ini：把display_errors = On和error_reporting = E_ALL设好，再重启Web服务（如sudo systemctl restart apache2） - 注意：上线前务必关掉
display_errors，改用log_errors = On写入日志文件，避免泄露路径或敏感信息
用var_dump和file_exists快速验证路径与数据
尤其是处理include、require、$_GET参数或动态拼接路径时，光靠“觉得应该对”容易踩坑：
- 打印请求地址：
var_dump($_SERVER['REQUEST_URI']); - 检查文件是否存在：
var_dump(file_exists('/var/www/html/config.php')); - 输出关键变量结构：
var_dump($config);或print_r($_POST); - 别只写
echo "ok"——要带上下文，比如echo "Loading config from: " . $path;
装Xdebug + IDE实现断点调试
这是真正提升效率的方式，尤其适合逻辑复杂、多层调用、框架项目：
立即学习“PHP免费学习笔记（深入）”；
- 安装Xdebug扩展（Linux下常为
sudo apt install php-xdebug，Windows需手动配DLL） - 在
php.ini中启用：zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003 - 在VS Code或PhpStorm里安装对应插件，配置监听端口为9003，打上断点，刷新页面即可进入单步调试
- 能实时看变量值、调用栈、跳过/步入函数，比满屏
var_dump干净高效得多
善用日志，特别是生产环境
不是所有问题都能在浏览器里复现，有些只在特定用户、定时任务或并发场景下出现：
- 用
error_log("User {$id} failed login", 3, "/var/log/myapp.log");记录关键节点 - 配合
file_put_contents("debug.log", print_r($data, true) . PHP_EOL, FILE_APPEND);写结构化日志 - 记得给日志文件设好权限（如
chmod 644 debug.log），避免因权限拒绝写入而“静默丢日志” - 搭配
tail -f /var/log/myapp.log实时盯屏，比反复刷页面快得多
不复杂但容易忽略：调试不是堆工具，而是建立“假设→验证→修正”的闭环。从错误提示出发，查路径、看变量、追流程，工具只是帮你更快走完这三步。
