php - 使用 Visual Studio Code 的 Xdebug 会忽略一些断点

Question

我正在使用带有 PHP 调试扩展的 Visual Studio Code 来调试 Laravel 项目。但是有些断点被忽略了，我不明白为什么。我坚持认为并不是所有的断点都会被忽略。例如，方法声明处的所有断点都会被忽略，但变量声明处的断点会被命中。

我的 php.ini 的 Xdebug 部分:

xdebug.profiler_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_connect_back=1
xdebug.remote_enable = 1
xdebug.remote_port = 9000

这是我的 launch.json:

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9001,
            "log": true
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9000
        }
    ]
}

我尝试过的:

• 将默认端口 9000 更改为 9001
• 卸载并重新安装 PHP 调试扩展(您永远不知道)

示例:“•”表示行断点。下面代码示例中的所有断点都将被忽略。

 public function testCreateWhenAllParametersAreCorrectlySpecifiedReturnsCompany()
 {
•    $attributes = [
         'business_name' => 'DANONE'
     ];

     $address = factory(Address::class)->create();

     $company = Company::create($attributes, $address);

     $this->assertInstanceOf(Company::class, $company);

     $this->assertDatabaseHas('companies', [
•        'address_id' => $address->id,
         'business_name' => 'DANONE'
     ]);
 }

如何让 Xdebug 与 Visual Studio Code 命中所有断点或者这是正常行为？预先感谢您的帮助。

更新 #1 (08/07/2019)

Zend 扩展路径在我的 php.ini 中指定，如下所示。

zend_extension = "/usr/local/Cellar/php@7.2/7.2.18/pecl/20170718/xdebug.so"

我尝试在我的 settings.json 中添加 php.validate.executablePath。

更新 #2 (08/08/2019)

根据本次更新时的评论和回答，Xdebug 忽略某些行是正常行为。那么我的问题是为什么有些行会被忽略？忽略了哪些行？有官方名单吗？

Answer 1

在 PhpStorm 中运行它，但 Xdebug 在 PHP 上运行时，行为是相同的。

Xdebug 在事情“完成”时停止，在事情“完成”的那一行。这可以是函数调用、变量赋值、数据转换等。所有这些的共同点是它们必须是显式的。隐式赋值被忽略。

Xdebug 不会为放置在 Action “中”的断点暂停执行。这就是为什么您的代码中的第一个断点不会起作用，而第二个会起作用。

显式和隐式示例:

$attributes = [                   // this is implicitly an array, no pausing execution
    'business_name' => 'DANONE'   // this is explicitly assigned a string, execution paused
];

一些截图(代码来自 Symfony 4 public/index.php，有一些明显的添加 - 蓝色背景暂停执行“当前行”):

显然在 if() 语句中执行函数 - 它暂停

正如我们所见，断点位于该数组的所有 3 行上。但是，它唯一暂停的是键/值对的分配。这是显式完成的，数组本身是隐式声明的。

这里我们明确声明$testArray 是一个数组。所以:它暂停了。

这是完整的，可以在上面添加。类型数组的隐式设置，但键/值的显式分配。

---

所以:是的。

如果您放置的断点略有不同，它们就会暂停执行。不暂停隐含的是正常行为。

---

完成:

在本地 Apache 安装上，我有以下配置:

[XDEBUG]
zend_extension = C:\xampp\php\ext\php_xdebug-2.7.1-7.3-vc15-x86_64.dll

xdebug.remote_mode = req
xdebug.remote_connect_back = 1
xdebug.default_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_enable = 1
xdebug.remote_port = 9000
xdebug.remote_handler = dbgp
xdebug.max_nesting_level = 200;

但我通常在 Docker 中运行它。在 docker-compose PHP 镜像中:

environment:
  PHP_XDEBUG_ENABLED: ${XDEBUG_ENABLED:-0}
  PHP_IDE_CONFIG: ${PHP_IDE_CONFIG:-serverName=ProjectName}
  XDEBUG_CONFIG: >
    idekey=PHPSTORM 
    remote_host=${XDEBUG_REMOTE_HOST_IP:-host.docker.internal}
    remote_port=${XDEBUG_REMOTE_PORT:-9000}
    remote_enable=1

• (要启用 xdebug，在开始使用 docker-compose up 时将应用程序中的 XDEBUG_ENABLED 环境配置设置为 1)
• (将“ProjectName”替换为项目名称，在 Xdebug 的 PhpStorm 设置中的“服务器”配置中使用该名称)

并且在 Dockerfile

pecl install xdebug-2.7.2 redis && \
docker-php-ext-enable xdebug redis && \

• (确保将 xdebug-2.7.2 替换为您想要的版本/与您的 PHP 版本兼容，check that here)

---

编辑:根据对 OP 问题的评论进行补充。

有很多错误报告(请参阅这些评论，感谢 LazyOne 找到它们)。

他提供的最后一个 URL 很有趣，因为它是关于即将推出的 V2.8.0(目前是 2.8.0beta1，不是一般发布)，他在 this ticket 中对此发表了评论。关于 Xdebug 不暂停执行隐式赋值:

I've just merged this into the master branch, which will become part of 2.8.0. I will release 2.7.2 soon (this week, today?!), and then probably next week a 2.8alpha1 release so that people can try this out.

(引用 Xdebug 作者 Derick 2019-05-06 12:49)

你可以看看changelog page或 roadmap用于 Xdebug。

路线图显示了将包含的所有功能/修复。

对于 2.8.0，它表明将添加对 IDE 的支持，以便 IDE 显示是否可以解决断点。它的当前发布日期定为 2019-09-30。

已发布