SuperAPI AI 工具集

spatie-laravel-php

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:为任何 Laravel 或 PHP 编码任务套用 Spatie 的 Laravel 与 PHP 指南,即使使用者未明确提及 Spatie;适用于生成、编辑、格式化、重构、审查或对齐 Laravel/PHP 代码。

适用文件与范围:.php、.blade.php,以及 Laravel 惯例相关内容(路由、控制器、配置、验证、迁移、测试)。不涉及 JS/TS、CSS、基础设施、数据库模式设计以及非 Laravel 框架。

工作流程:先识别产物类型(控制器、路由、配置、模型、Blade、测试等),再阅读 references/spatie-laravel-php-guidelines.md 的相关章节,依次应用 Laravel 核心原则、PHP 标准、分节规则。若规则与项目现有惯例冲突,则遵循 Laravel 惯例并保持改动一致。

核心规则摘要:Laravel 惯例优先;遵循 PSR-1、PSR-2、PSR-12;优先使用类型化属性与显式返回类型(含 void);使用 ?string 形式的短可空语法;在全部属性均可提升时使用构造器属性提升;每个 trait 单独一行 use;方法链一旦换行,后续每个 -> 都另起一行,不混用单行与多行链式调用;优先早返回并尽量避免 else;控制结构始终使用花括号;优先字符串插值而非拼接;正常路径放在最后,先处理错误条件。

建议做法:URL 用 kebab-case,路由名与路由参数用 camelCase;路由使用元组写法 [Controller::class, 'method'];控制器使用复数资源名(PostsController);验证规则使用数组写法;使用 config() 辅助函数,避免在配置文件外使用 env();服务配置加入 config/services.php 而非新建文件;翻译使用 __() 而非 @lang;枚举值与类常量使用 PascalCase。

应避免:在已有完整类型提示时添加 docblock;在 docblock 中使用完全限定类名;默认使用 final 或 readonly;在早返回可行时使用 else;在 Blade 控制结构后添加空格。

限制与缺失信息:资料未提供安装方式、价格、平台支持情况或效果保证;除上述规范内容外,其他功能细节暂未提供。