SuperAPI AI 工具集

laravel-architecture

编程与开发

查看项目

更新于 10-26 16:21

技能介绍

用途

laravel-architecture 用于指导 Laravel 项目的架构设计与代码组织,适合在以下场景使用:搭建新的 Laravel 项目结构、编写 services/repositories/actions、配置依赖注入、组织代码分层,以及配置开发环境与生产部署。

主要能力

技能围绕 Laravel 架构的清晰关注点分离、依赖注入和可维护性组织内容,覆盖项目结构、服务容器、服务提供者、门面、契约、请求生命周期、配置、安装、版本升级、开发环境、命令行、文件系统、部署、日志、异常处理、特性标志、MCP、并发与包开发等主题,并提供服务+仓库模式、AppServiceProvider、Artisan 命令、MCP 服务器、特性标志、Envoy 部署、Sail 配置、Octane 配置等模板。

技能给出的关键规则包括:控制器保持精简、把业务逻辑委托给服务;接口放在 app/Contracts/,不与实现放在一起;优先构造注入而非门面;文件大小遵循 FUSE_SOLID_MAX_LINES 并依据 SOLID 拆分;环境文件不入库。建议的 app/ 目录结构包含 Actions(单一职责动作类)、Contracts(接口)、DTOs(数据传输对象)、Enums、Events、Http(Controllers、Middleware、Requests、Resources)、Jobs、Listeners、Models(仅 Eloquent 模型)、Policies、Providers、Repositories(数据访问层)、Services(业务逻辑)。

使用方式

技能中描述的工作流程为:在任何实现之前并行启动三个代理,分别进行代码库架构分析、通过 Context7 验证 Laravel 模式、查询服务容器与依赖注入文档;实现完成后运行校验代理。文档还给出服务注入、服务提供者绑定、Artisan 生成命令、环境访问等代码示例。

Laravel 13 要点

资料列出 Laravel 13 的最低 PHP 版本为 8.3,支持 Symfony 7.4 与 8.0,Beanstalk 驱动需要 pheanstalk 7.x/8.x;当前稳定版本标注为 13.33(2026 年 9 月)。新增 Cache::touch() 刷新 TTL、Queue::route() 动态路由、php artisan dev、#[BindWhen] 条件绑定、多数管理器支持 Enum,以及 Guzzle 8 支持等。从 Laravel 12 升级需注意 PHP 最低版本、PHPUnit、Pest、CSRF 类、缓存前缀改为连字符、Beanstalk 版本、Symfony 版本、模型 boot 中嵌套实例化抛 LogicException、新增 cache.serializable_classes 配置等变更。

适用场景

适用于需要按分层架构组织 Laravel 代码、实施依赖注入与接口约束、规划开发环境(Sail、Valet、Homestead、Octane)和生产部署(含 Envoy)的团队。

限制

资料未提供该技能的具体安装命令、运行环境要求与定价信息;文中的版本说明与行为以资料为准,实际使用时应核对对应 Laravel 版本。