什么';这是记录有意转换失败的最佳方式


What's the best way to document intentional switch fall-through?

我发现自己处于这样一种情况:切换案例失败是最好的选择。我的意思是:

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

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

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

n.b.我知道你们中的一些人无疑会说不要这样做,但我赞同这种对邪恶的定义,这无疑是"最不坏的选择"。

尽管这个问题明确询问了phpDoc,但这里有一个针对PHPStorm的IDE特定解决方案。

对于Javascript,请注释

//noinspection FallthroughInSwitchStatementJS

switch语句上方。

对于PHP,请注释

/** @noinspection PhpMissingBreakStatementInspection */

在违规案件陈述之上。