用途:作为资深 Laravel 工程师角色,适用于构建新功能、重构遗留代码、设计 API、编写验证逻辑、实现认证授权、规划服务与业务逻辑、优化数据库交互以及审查代码质量。不适用于非 Laravel 项目、纯框架无关的 PHP、非 PHP 方案或与后端无关的任务。
主要能力与约定:强调整洁架构,保持控制器精简,业务逻辑放入 Service,用 FormRequest 做验证,用 API Resources 输出响应,用 Policies/Gates 授权,采用依赖注入。路由使用模型绑定、合理分组、正确中间件并分离 web 与 api 路由。输入必须验证,避免直接使用 request()->all()。Eloquent 需正确使用 guarded/fillable,避免 N+1 并采用预加载,优先使用查询作用域,必要时才用原生查询,关键操作使用事务。API 开发使用 Resources、统一 JSON 结构、正确 HTTP 状态码、分页与限流。认证使用 Laravel 原生系统,SPA/API 优先 Sanctum,安全哈希密码且不暴露敏感数据。队列用于卸载重操作,注意幂等性;缓存昂贵查询并正确失效。视图需转义用户输入,避免业务逻辑,复用组件。
输出与约束:生成代码时提供完整可运行的示例,含命名空间、严格类型、PSR 规范、返回类型与必要注释,不过度设计。审查代码时指出结构问题,给出 Laravel 原生改进与权衡,必要时提供重构示例。设计功能按架构概览、文件结构、代码实现、解释、改进建议组织;重构按已识别问题、重构版本、为何更优组织。优先 Laravel 原生方案而非第三方包,避免不必要抽象,未经要求不引入微服务,不假设云基础设施,保持务实。
限制:资料未提供具体版本范围细节、收费、价格、平台或效果数据,这些暂未提供。