VSCode调试PHP必须安装Xdebug和PHP Debug插件，核心是php.ini中配置xdebug.mode=debug、client_port=9003、start_with_request=trigger，并在launch.json中严格匹配端口与pathMappings，通过URL参数或浏览器插件手动触发调试。
PHP调试必须装xdebug和PHP扩展
VS Code本身不带PHP调试能力，xdebug 是唯一被广泛支持的PHP调试器，且必须配合官方 PHP 扩展（由 Felix Becker 维护）才能识别 launch.json 中的 "type": "php" 配置。没装这两个，无论怎么写配置都会卡在“找不到调试器”或“无法启动会话”。
验证是否就绪：
– 打开命令面板（Ctrl+Shift+P），输入 PHP: Select Interpreter，确认已选中带 xdebug 的 PHP 可执行路径；
– 运行 php -v，输出中应含 with Xdebug v3.x 字样。
常见错误现象：
– 启动调试时弹出 “Could not find debugger extension for type ‘php’”
– 断点灰色不可用，hover 提示 “Breakpoint ignored because generated code not found”
type=php 时 request 只能是 launch，不能 attach
PHP 调试器（php 类型）在 VS Code 中仅支持 "request": "launch" 模式，不支持 "attach"。这是由 xdebug v3 的通信机制决定的：它依赖 CLI 启动时注入 XDEBUG_CONFIG 环境变量，而非监听端口等待连接。
立即学习“PHP免费学习笔记（深入）”；
如果你硬写 "request": "attach"，VS Code 不报错但调试根本不会触发——程序直接运行完退出，断点完全无效。
正确做法：
– 必须指定 "program" 指向一个可执行的 PHP 脚本（如 ${workspaceFolder}/index.php）
– 不要设 "port" 或 "address" 字段（这些是 Node.js / Python 的 attach 模式字段，对 PHP 无意义）
– 若需调试 Web 请求（如 Apache/Nginx 下的页面），应改用浏览器插件 + chrome 类型配置，而非强行用 php 类型
program、args、env 是最常配错的三个字段
program 必须是相对路径，且指向真实存在的 .php 文件；硬编码绝对路径（如 /home/user/project/index.php）会导致协作失效，也违反 VS Code 路径变量规范。
args 和 env 表现很“脆弱”：如果脚本里用了 $_SERVER['argv'] 或 getenv()，但配置写错，结果就是参数收不到、环境变量读为空——没有报错，只有静默失败。
实操建议：
– "program": "${workspaceFolder}/test.php"（确保文件存在）
– "args": ["--verbose", "user123"]（数组内每个字符串是独立参数，不要合并成一个）
– "env": {"APP_ENV": "local", "XDEBUG_MODE": "debug"}（XDEBUG_MODE 是 xdebug v3 必须显式开启的开关）
– 别漏掉 "cwd": "${workspaceFolder}"，否则 require/require_once 基于当前工作目录加载会失败
console 设为 integratedTerminal 才能交互输入
PHP CLI 脚本常需要 fgets(STDIN) 或 readline() 等交互式输入，但默认 "console": "internalConsole"（即调试控制台）不支持标准输入流——敲字没反应，程序卡死。
必须显式设置："console": "integratedTerminal"
这样调试才会在底部集成终端中启动，支持完整 stdin/stdout 行为。副作用是：终端窗口会保留历史输出，方便复现问题；但也意味着每次调试都会新开一个终端 tab，记得手动关闭避免堆积。
其他选项：
– "externalTerminal" 在系统终端打开，适合需要 GUI 弹窗或特殊权限的场景
– "internalConsole" 仅适合纯输出、无输入的脚本，且不显示 ANSI 颜色
