SuperAPI AI 工具集

spatie-laravel-php-standards

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:该技能用于在编写或维护 Laravel/PHP 代码时套用 Spatie 的 Laravel 与 PHP 规范,保持代码风格一致并贴近 Laravel 原生写法。即使用户未提及 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;倾向提前返回,尽量避免 else;控制结构始终使用花括号;使用字符串插值而非拼接。

建议做法:URL 使用 kebab-case,路由名与路由参数使用 camelCase;验证规则使用数组写法;使用 config(),避免在配置文件之外使用 env()。不建议:在已有完整类型提示时添加 docblock;在 docblock 中使用完全限定类名;用 @lang 替代 __()。

限制:资料未提供安装命令、依赖版本、许可证、性能或兼容性信息,这些暂未提供。