PestPHP中Laravel预设对控制器静态中间件方法的兼容性问题分析

问题背景

在PestPHP测试框架的Laravel预设中，存在一个对控制器类方法限制的架构测试规则。该规则默认只允许控制器包含特定的公共方法，如__construct、__invoke以及常见的CRUD方法（index、show、create等）。然而，这一预设与Laravel 11引入的新特性产生了兼容性问题。

技术细节

Laravel 11引入了一项新特性：开发者可以通过在控制器中定义静态的middleware方法来声明中间件。这种方法提供了一种更优雅的方式来管理控制器的中间件逻辑，使代码组织更加清晰。例如：

class UserController extends Controller
{
    public static function middleware(): array
    {
        return [
            'auth',
            'verified',
        ];
    }
    
    // 其他控制器方法...
}

然而，PestPHP的Laravel预设目前并未将middleware方法纳入允许的公共方法列表中，导致架构测试会将这些控制器标记为不符合规范。

解决方案探讨

临时解决方案

对于急需解决此问题的开发者，目前有两种临时解决方案：

1. 忽略特定控制器：可以使用ignoring方法将包含静态中间件方法的控制器排除在架构测试之外

   arch()->preset()->laravel()->ignoring(UserController::class);
   

2. 自定义测试规则：完全重写控制器层的架构测试规则，但这会增加维护成本

长期解决方案

从技术架构角度看，最合理的长期解决方案是更新PestPHP的Laravel预设，将middleware方法加入允许的公共方法列表中。由于这是Laravel框架的官方特性，理应得到测试框架的原生支持。

架构设计思考

这个问题引发了对测试框架预设设计的深入思考：

1. 预设的灵活性：理想的测试预设应该在提供合理默认值的同时，允许开发者进行必要的自定义
2. 框架特性同步：测试工具需要及时跟进其所支持框架的新特性
3. 扩展性设计：可以考虑实现预设规则的链式覆盖机制，使开发者能够在不完全重写预设的情况下进行微调

最佳实践建议

在实际项目开发中，建议：

1. 对于短期项目，可以采用忽略方案快速解决问题
2. 对于长期维护的项目，建议提交PR到PestPHP项目，完善Laravel预设
3. 在团队内部建立框架版本和测试工具版本的同步更新机制，避免类似兼容性问题

总结

测试工具与框架特性的同步是一个持续的过程。作为开发者，我们既要理解工具预设的价值，也要认识到框架演进带来的必要调整。这个案例很好地展示了如何在保持代码规范性的同时，适应框架的新特性发展。