PestPHP 架构测试中忽略指令失效问题分析

问题背景

在PestPHP 3.0.1版本中，架构测试功能提供了@pest-arch-ignore-line和@pest-arch-ignore-next-line两个指令，用于在代码中临时忽略特定行的架构规则检查。然而，开发者发现这些指令在实际使用中并未生效，导致架构测试仍然会报告被标记为忽略的代码违规。

问题复现

当开发者尝试在代码中使用以下两种方式忽略die()函数调用时：

1. 行内忽略指令：

die('This line will be ignored'); // @pest-arch-ignore-line

2. 下一行忽略指令：

// @pest-arch-ignore-next-line
die('This line will be ignored');

架构测试仍然会报告违规，显示这些被标记为忽略的die()调用违反了架构规则。

技术分析

经过项目维护者检查，发现问题出在架构测试插件的Blueprint实现中。当前版本的代码只在特定类型的期望检查中实现了忽略指令的支持，而没有在所有可能的架构检查场景中都正确处理这些指令。

临时解决方案

由于该功能的完整修复需要一定时间，项目维护者建议开发者暂时使用架构测试提供的ignoring方法来替代行级忽略功能：

test('Classes don\'t use die')
    ->expect(['die'])
    ->ignoring('App\SomeClass') // 忽略整个类
    ->not->toBeUsed();

这种方法虽然不如行级忽略精确，但可以暂时解决特定类或文件的架构规则排除需求。

未来展望

虽然当前版本中移除了这个不完善的功能，但有社区开发者表示愿意贡献代码修复这个问题。预计在未来的版本中，PestPHP可能会重新引入更健壮的行级忽略功能实现。

对于需要精确控制架构规则的应用场景，开发者可以关注PestPHP的更新日志，或考虑在项目中使用更细粒度的架构规则定义来替代行级忽略的需求。