53 lines
1.0 KiB
Markdown
53 lines
1.0 KiB
Markdown
---
|
||
name: backend-enum
|
||
description: 枚举规范，继承 IEnum 接口，支持 label()/tryFrom() 模式
|
||
globs:
|
||
- "app/enum/**/*.php"
|
||
- "app/**/enum/**/*.php"
|
||
---
|
||
|
||
## 文件位置
|
||
|
||
```
|
||
app/enum/{module}/{Name}Enum.php
|
||
```
|
||
|
||
## 代码模板
|
||
|
||
```php
|
||
<?php
|
||
|
||
namespace app\enum\{module};
|
||
|
||
use core\interface\IEnum;
|
||
|
||
enum {Name}Enum: int implements IEnum
|
||
{
|
||
case ACTIVE = 1;
|
||
case INACTIVE = 0;
|
||
|
||
public function label(): string
|
||
{
|
||
return match ($this) {
|
||
self::ACTIVE => '启用',
|
||
self::INACTIVE => '禁用',
|
||
};
|
||
}
|
||
}
|
||
```
|
||
|
||
## 关键约定
|
||
|
||
- 所有枚举实现 `core\interface\IEnum` 接口
|
||
- 枚举使用 PHP 8.1+ native enum，backed by int 或 string
|
||
- 必须实现 `label()` 方法返回中文描述
|
||
- 枚举值一旦发布不可修改（只能追加）
|
||
- 模型字段转换使用 `$casts` 中的 `EnumsCast`
|
||
|
||
## 检查清单
|
||
|
||
- [ ] 是否实现 IEnum 接口
|
||
- [ ] 是否包含 label() 方法
|
||
- [ ] 枚举值是否稳定（发布后不改）
|
||
- [ ] 命名空间是否正确
|