如何让PHPStan忽略特定代码片段而非关闭对应错误检测规则

• 方案1：单行/单代码块忽略（适合少量零散的场景）
  直接在目标代码的上一行添加PHPStan忽略注释，还可以指定仅忽略对应类型的错误，避免误屏蔽其他有效报错：
  示例：

// 忽略下一行的while循环恒真报错，可附加备注说明是有意编写
/** @phpstan-ignore-next-line phpstan.alwaysTrue.whileLoopCondition 内部存在break逻辑主动跳出循环 */
while (1) {
    // 业务代码
    if ($exitCondition) {
        break;
    }
}

// 也可以在行尾添加忽略注释
if (1) { // @phpstan-ignore-line phpstan.alwaysTrue.ifCondition 固定执行的分支，仅用于临时调试/兼容场景
    // 业务代码
}

注：如果不知道错误对应的标识符，可以在执行PHPStan命令时加上--debug参数，输出内容里会附带每个错误的唯一标识符。

• 方案2：全局批量匹配忽略（适合大量统一写法的场景，推荐）
  直接在phpstan.neon配置文件的ignoreErrors节点添加规则，仅匹配你主动写死的while (1)、if (1)这类代码，不会影响变量条件导致的恒真报错检测：
  配置示例：

parameters:
    ignoreErrors:
        # 忽略所有手动写死的while(1)/while(true)的恒真报错
        -
            message: '#^While loop condition is always true\.$#'
            code: '#^\s*while\s*\(\s*(1|true)\s*\)\s*$#i'
        # 忽略所有手动写死的if(1)/if(true)的恒真报错
        -
            message: '#^If condition is always true\.$#'
            code: '#^\s*if\s*\(\s*(1|true)\s*\)\s*$#i'

这种方案不需要修改任何业务代码，正则只会匹配括号里直接写1/true的硬编码场景，因代码Bug导致的while ($动态变量)条件恒真的报错依然会正常触发，完全符合需求。

• 方案3：自定义语义化常量/函数替换
  如果你希望代码可读性更高，也可以定义统一的语义化标识替换硬编码的1：

// 全局公共文件中定义
define('INTENTIONAL_LOOP', true);

// 业务代码中使用
while (INTENTIONAL_LOOP) {
    // 业务逻辑
}

这种写法PHPStan默认不会触发恒真报错，也不需要额外加忽略配置，同时代码语义更清晰，其他开发者一看就知道这个恒真条件是有意编写的。

内容的提问来源于stack exchange，提问作者user17535142