本地PHP调试核心是实时查看错误、变量和执行流程，需启用错误提示（display_errors=On、error_reporting=E_ALL）、配置Xdebug断点调试、使用var_dump/print_r快速输出、以及PHP内置服务器快速验证。
本地 PHP 环境调试代码，核心是让代码运行时能实时看到错误、变量值和执行流程。不需要部署到服务器，关键在于配置好开发环境 + 调试工具链。
启用 PHP 错误提示（最基础但常被忽略）
很多新手看不到报错，是因为 PHP 默认关闭了错误显示。打开 php.ini 文件，确认以下几项已设置：
- display_errors = On（开发时必须开启）
- error_reporting = E_ALL（显示所有级别错误）
- log_errors = On（同时建议开启，错误也会写入日志）
改完记得重启 Web 服务（如 Apache 或 Nginx），或重启 PHP-FPM。用 phpinfo() 页面确认生效。
用 Xdebug 搭配 IDE 实现断点调试
Xdebug 是目前最主流的 PHP 调试扩展，配合 VS Code 或 PHPStorm 可以单步执行、查看变量、调用栈、修改值。
立即学习“PHP免费学习笔记（深入）”；
- 先安装 Xdebug：用
pecl install xdebug或下载对应版本的.dll/.so文件 - 在
php.ini中添加配置（以 Xdebug 3.x 为例）：
xdebug.mode = debug
xdebug.start_with_request = trigger
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003 - 在 VS Code 中安装 “PHP Debug” 插件，配置
launch.json，监听端口 9003 -
浏览器访问页面时，在 URL 后加
?XDEBUG_SESSION_START=1（或用官方浏览器插件一键触发）
快速输出调试信息（适合轻量场景）
不用启动完整调试器时，可以用内置函数辅助排查：
-
var_dump($var)：打印变量类型和值，适合查结构 -
print_r($var)：更简洁地打印数组/对象，可加第二个参数true返回字符串 -
error_log(print_r($var, true), 3, 'debug.log')：把调试内容写入日志文件，不干扰页面输出 -
debug_backtrace()：查函数调用链，定位问题源头
注意：上线前务必删掉或注释这些调试语句，避免泄露敏感信息。
用内置服务器快速验证脚本
PHP 5.4+ 自带简易 Web 服务器，适合纯 PHP 项目快速启动：
- 终端进入项目根目录，运行：
php -S localhost:8000 -t public/（public/是 Web 入口目录） - 支持路由文件（如
router.php），可拦截请求做预处理或重定向 - 搭配 Xdebug 使用时，确保
php -v显示已加载 Xdebug，且端口不冲突
比配 Apache/Nginx 更轻，改完代码刷新即见效果，适合 API 接口或小项目验证逻辑。
