indentar - phpstorm indentation

¿Cuál es la mejor manera de documentar el cambio intencional del cambio intencional?

Question

Me he encontrado en una situación en la que un caso de cambio es la mejor opción. Con esto quiero decir:

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

Actualmente mi IDE (phpStorm) está lanzando una advertencia sobre la caída.

¿Hay una forma aceptada en phpDoc para documentar tal caída intencionada?

nb Soy consciente de que algunos de ustedes indudablemente dirán que no deben hacer esto, pero me suscribo a esta definición de mal, y esta es sin duda la "la menos mala de las alternativas".

Answer 1

Aunque la pregunta se refiere explícitamente a phpDoc, aquí hay una solución específica de IDE para PHPStorm.

Para Javascript, comentar

//noinspection FallthroughInSwitchStatementJS

por encima de la declaración de cambio.

Para PHP, comenta

/** @noinspection PhpMissingBreakStatementInspection */

Por encima de la declaración del caso infractor.