php - 记录有意切换失败的最佳方法是什么？

Question

我发现自己处于一种情况下，switch case fall-through 是最好的选择。我的意思是:

switch($bar)
{
    case 0:
        // do something
    case 1:
        // do more
        break;
    //more cases
}

目前，我的 IDE (phpStorm) 正在发出有关失败的警告。

在 phpDoc 中是否有一种公认的方式来记录这种预期的失败？

注意我知道你们中的一些人无疑会说不要这样做，但我订阅了这个 definition of evil这当然是“最不坏的选择”。

Answer 1

虽然这个问题明确询问了 phpDoc，但这里有一个针对 PHPStorm 的特定于 IDE 的解决方案。

对于 Javascript，注释

//noinspection FallthroughInSwitchStatementJS

在 switch 语句之上。

对于 PHP，注释

/** @noinspection PhpMissingBreakStatementInspection */

在有问题的案例陈述之上。