phpstorm调试教程

1. 确认调试环境：PHP 与 Xdebug 是否就绪
   打开 PhpStorm，进入「Settings」→「Languages & Frameworks」→「PHP」。在「CLI Interpreter」右侧点击「...」按钮，确认已关联一个可用的 PHP 解释器（如本地安装的 PHP 或 Docker 容器）。接着在「Debug」选项卡中，检查「Xdebug」是否被识别。如果未识别，需在 PHP 配置文件 php.ini 中启用 xdebug 扩展，并设置 xdebug.mode=debug。若你使用 Docker 或远程服务器，还需在「Servers」中配置路径映射，确保本地代码与远程代码对应。
2. 设置调试端口与监听器
   在「Settings」→「Languages & Frameworks」→「PHP」→「Debug」中，确认「Debug port」为 9000（或 9003，取决于 Xdebug 版本）。同时，在「Settings」→「Build, Execution, Deployment」→「Debugger」中，确保「External connections」已勾选「Can accept external connections」。之后，点击工具栏上的「Start Listening for PHP Debug Connections」按钮（电话图标），使其变为绿色，表示 PhpStorm 正在监听调试连接。
3. 在代码中设置断点
   打开你要调试的 PHP 文件，在需要暂停执行的代码行左侧的灰色区域单击，即可设置断点（红色圆点）。断点可以设置在函数调用、条件判断、循环等关键位置。建议在入口文件（如 index.php）或业务逻辑的核心方法处设置第一个断点。设置后，断点会高亮显示，PhpStorm 会在执行到该行时暂停。
4. 启动调试会话并逐行执行
   在浏览器中访问你的 PHP 项目（如 http://localhost/your-project），并携带调试参数。常见方式是在 URL 后添加「?XDEBUG_SESSION_START=1」，或者使用 PhpStorm 自带的「Run」→「Debug」按钮（如果配置了运行配置）。当代码执行到断点时，PhpStorm 会自动弹出调试工具窗口，显示当前变量的值、调用栈和输出。你可以使用工具栏上的「Step Over」（跳过当前行）、「Step Into」（进入函数内部）、「Step Out」（跳出函数）等按钮逐行控制执行流程。
5. 查看变量与表达式求值
   在调试窗口的「Variables」面板中，可以展开当前作用域的所有变量，查看其值和类型。你也可以在「Watch」面板中添加表达式（如 $user->getName()），实时观察其计算结果。右键点击变量，选择「Add to Watches」即可加入监视列表。此外，在「Console」选项卡中可以直接输入 PHP 表达式，PhpStorm 会在当前断点上下文中执行并返回结果，方便验证逻辑。

软件页面：PhpStorm。