如何在VSCode中用指定按钮调试带参数的PHP CLI脚本？

安全阿岳

2026-7-6

在VSCode中为PHP CLI脚本的「Run/Debug PHP File」按钮配置命令行参数

要让VSCode右上角的「Run PHP File」或「Debug PHP File」按钮启动时携带命令行参数，你可以通过配置launch.json并结合PHP Debug扩展的purpose字段实现，具体操作如下：

调试模式（Debug PHP File）配置

打开VSCode调试面板（快捷键Ctrl+Shift+D），点击面板顶部的齿轮图标，打开launch.json配置文件。
在configurations数组中添加或修改PHP调试配置，关键内容如下：
```
{
    "type": "php",
    "request": "launch",
    "name": "Debug PHP File with Args",
    "program": "${file}",
    "args": ["--input=test.txt", "verbose"],
    "purpose": ["debug"]
}
```
- ${file}表示自动关联当前打开的PHP脚本；
- args字段填入需要的命令行参数，格式为字符串数组；
- purpose设为["debug"]，是让默认「Debug PHP File」选项自动匹配该配置的核心。
保存launch.json后，点击右上角播放按钮选择「Debug PHP File」，脚本就会带着配置的参数启动调试。可在脚本中通过$argv变量验证参数是否正确传递。

运行模式（Run PHP File）配置

如果需要「Run PHP File」按钮也带参数，可在launch.json中新增运行配置：

{
    "type": "php",
    "request": "launch",
    "name": "Run PHP File with Args",
    "program": "${file}",
    "args": ["--output=result.csv"],
    "purpose": ["run"],
    "console": "integratedTerminal"
}

保存后，选择「Run PHP File」就会用该配置启动脚本。