PhpStorm怎么调试命令行脚本_PhpStorm CLI脚本调试教程【通俗】-phpstorm-PHP中文网

phpstorm 中 cli 断点不生效是因为未启用 cli 调试监听，需显式添加 xdebug 参数（如 -dxdebug.mode=debug）并配置 phpstorm 监听 9003 端口，且通过 run configuration 启动而非终端直连。

phpstorm怎么调试命令行脚本_phpstorm cli脚本调试教程【通俗】

为什么 `php -f script.php` 在 PhpStorm 里断点不生效

因为默认没启用 CLI 调试监听，PhpStorm 不会自动捕获命令行启动的 PHP 进程。它只监听 Web 请求（比如通过内置服务器或 Apache）或显式用 php -dxdebug.mode=debug -dxdebug.start_with_request=yes 启动的 CLI 进程。

确保已安装并启用 Xdebug 3（不是 Xdebug 2），且 xdebug.mode 包含 debug
在 PhpStorm 中打开 Preferences → PHP → Debug → Xdebug，确认 Debug port 是 9003（Xdebug 3 默认），且勾选 Start listening for PHP Debug Connections
CLI 脚本必须显式触发调试连接：运行时加参数 -dxdebug.mode=debug -dxdebug.client_host=127.0.0.1 -dxdebug.client_port=9003，否则 PhpStorm 完全收不到请求
别用 php script.php 简写——它不会加载任何调试配置；哪怕 php.ini 里写了 xdebug 配置，CLI 模式下也常被忽略，显式传参最可靠

怎么让 PhpStorm 自动附加到 `php artisan` 或 `bin/console` 这类命令

不能靠“自动附加”，得靠 PhpStorm 的 Run Configuration 把命令包装成可调试入口。直接终端敲命令，PhpStorm 就是旁观者。

点右上角 Add Configuration → PHP Script，填入脚本路径（如 artisan），设置 Interpreter options 为 -dxdebug.mode=debug -dxdebug.client_host=127.0.0.1 -dxdebug.client_port=9003
如果命令带参数（如 php artisan queue:work），在 Script arguments 栏里填 queue:work，不要写完整命令
注意工作目录：Working directory 必须设为项目根目录（不是 artisan 所在目录），否则 Laravel/ Symfony 加载器会找不到类
某些框架 CLI 命令会 fork 子进程（比如队列 worker），Xdebug 默认不穿透 fork；需额外加 -dxdebug.profiler_enable_trigger=1 并配合触发器，但更简单的是避免在子进程中设断点，专注主流程

`$_SERVER['argv']` 和 `$argc` 在调试时为啥是空的或不对

不是变量问题，是 PhpStorm 的 Run Configuration 没正确传递 CLI 参数，或者脚本被当成 Web 请求执行了。

检查 Run Configuration 的 Script path 是否指向真实 PHP 文件（如 artisan），而不是一个 .php 文件里写了 include 'artisan' —— 后者会让 $_SERVER['argv'] 变成包含该文件路径的数组，而非你期望的命令行参数
确认没误选 PHP Web Page 类型配置来跑 CLI 脚本；Web 类型会模拟 HTTP 环境，$_SERVER['argv'] 根本不初始化
如果用了 Docker，宿主机和容器时间不同步会导致 Xdebug 连接超时失败，看起来像“没进断点”，实际是连接被丢弃；检查容器内 date 和宿主机是否一致

为什么断点进了，但 `var_dump()` 输出看不到，或者变量值显示 `<uninitialized></uninitialized>`

这是 Xdebug + PhpStorm 协作时的常见表现，和输出缓冲、变量作用域或扩展版本强相关。

var_dump() 输出默认被 Xdebug 拦截并转成结构化面板，控制台看不到原始文本；想看纯文本输出，临时改用 echo + print_r($var, true)，或在 PhpStorm 的 Debug Console 里直接执行表达式
<uninitialized></uninitialized> 多出现在闭包、Generator 或未初始化的属性上；不是 bug，是 Xdebug 无法安全读取这些内存状态；换用 get_defined_vars() 或在断点前加个 $x = $targetVar; 再看 $x
PHP 8.1+ 的只读属性（readonly）在调试器中可能显示不全；这不是 PhpStorm 问题，是 Xdebug 尚未完全适配新特性，保持 Xdebug 更新到最新小版本（如 3.3.x）能缓解