48 lines
1.2 KiB
Markdown
48 lines
1.2 KiB
Markdown
---
|
|
name: backend-config
|
|
description: 配置体系规范，覆盖 28 个配置文件的结构、加载顺序、环境变量覆盖规则
|
|
globs:
|
|
- "config/**/*.php"
|
|
- "app/**/config/**/*.php"
|
|
---
|
|
|
|
## 配置体系
|
|
|
|
### 全局配置 (config/)
|
|
|
|
| 文件 | 说明 |
|
|
|------|------|
|
|
| `app.php` | 应用基础配置 |
|
|
| `database.php` | 数据库连接配置 |
|
|
| `cache.php` | 缓存配置 (Redis/File) |
|
|
| `log.php` | 日志配置 |
|
|
| `route.php` | 路由配置 |
|
|
| `middleware.php` | 全局中间件 |
|
|
| `exception.php` | 异常处理配置 |
|
|
| `thinkorm.php` | Laravel Eloquent ORM 配置 |
|
|
|
|
### 环境变量覆盖
|
|
|
|
所有配置项可通过 `.env` 文件覆盖，使用 `env()` 函数读取：
|
|
|
|
```php
|
|
return [
|
|
'host' => env('DB_HOST', '127.0.0.1'),
|
|
'port' => env('DB_PORT', 3306),
|
|
];
|
|
```
|
|
|
|
## 关键约定
|
|
|
|
- 配置返回 PHP 数组，键名使用 snake_case
|
|
- 敏感信息必须通过 `env()` 从环境变量读取
|
|
- 动态配置存储在数据库中，通过 Config Service 读取
|
|
- 插件配置放在 `plugin/{name}/config/` 下
|
|
|
|
## 检查清单
|
|
|
|
- [ ] 配置键名是否 snake_case
|
|
- [ ] 敏感信息是否使用 env() 读取
|
|
- [ ] 是否有合理的默认值
|
|
- [ ] 插件配置是否放在正确路径
|