# 5.12 系统配置管理

:::tip 概述
系统配置管理用于动态配置参数，支持分组管理。与参数管理的区别：配置管理支持键值对的分组管理（如网站配置、邮件配置），参数管理是独立的参数实体（如单个开关、阈值）。
:::

## 模块特点

| 特性 | 说明 |
|------|------|
| 基类 | BaseLogic（系统共享，不隔离） |
| 关联 | 与 ConfigItem 一对多（通过 config_id） |
| 用途 | 网站名称、Logo、版权信息等动态配置 |
| 缓存 | DictService 两级缓存（请求级 + Redis），减少数据库查询 |

## 数据库表结构

### 主表 `think_config`（配置组）

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 主键，自增 |
| name | varchar(150) | 配置组名称（如「网站配置」） |
| code | varchar(150) | 配置组编码（如 `website_config`） |
| sort | int | 排序（升序） |
| note | varchar(255) | 备注说明 |
| create_user | varchar(50) | 创建人（BaseModel 自动写入） |
| create_time | datetime | 创建时间（BaseModel 自动写入） |
| update_user | varchar(50) | 更新人（BaseModel 自动写入） |
| update_time | datetime | 更新时间（BaseModel 自动写入） |
| is_delete | int | 软删除标记（0=正常，1=已删除） |

### 子表 `think_config_item`（配置项）

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 主键，自增 |
| config_id | int | 所属配置组 ID（关联 think_config.id） |
| name | varchar(150) | 配置项名称（如「网站名称」） |
| code | varchar(150) | 配置项编码（如 `site_name`） |
| value | varchar(1000) | 配置值 |
| options | text | 配置选项（JSON 格式，用于 select/radio 等类型） |
| type | varchar(150) | 值类型（text / textarea / number / switch / image / file / select） |
| status | int | 状态（1=正常，2=停用） |
| sort | int | 排序（升序） |
| note | varchar(255) | 配置项备注 |
| create_user | varchar(50) | 创建人（BaseModel 自动写入） |
| create_time | datetime | 创建时间（BaseModel 自动写入） |
| update_user | varchar(50) | 更新人（BaseModel 自动写入） |
| update_time | datetime | 更新时间（BaseModel 自动写入） |
| is_delete | int | 软删除标记（0=正常，1=已删除） |

## API 接口

### 配置组

| 方法 | 路径 | 权限码 | 说明 |
|------|------|--------|------|
| GET | `/api/config/page` | sys:config:page | 分页列表 |
| GET | `/api/config/list` | sys:config:list | 全量列表 |
| GET | `/api/config/detail/:id` | sys:config:detail | 详情 |
| POST | `/api/config/add` | sys:config:add | 新增 |
| PUT | `/api/config/update` | sys:config:update | 修改 |
| DELETE | `/api/config/delete/:id` | sys:config:delete | 删除 |

### 网站配置（快捷接口）

| 方法 | 路径 | 权限码 | 说明 |
|------|------|--------|------|
| GET | `/api/config/web/index` | sys:config:web | 获取网站配置（按组返回所有配置项） |
| POST | `/api/config/web/save` | sys:config:web | 保存网站配置（批量更新配置项值） |

### 配置项

| 方法 | 路径 | 权限码 | 说明 |
|------|------|--------|------|
| GET | `/api/config/item/page` | sys:config:item:page | 分页列表 |
| GET | `/api/config/item/list` | sys:config:item:list | 全量列表 |
| GET | `/api/config/item/detail/:id` | sys:config:item:detail | 详情 |
| POST | `/api/config/item/add` | sys:config:item:add | 新增 |
| PUT | `/api/config/item/update` | sys:config:item:update | 修改 |
| DELETE | `/api/config/item/delete/:id` | sys:config:item:delete | 删除 |

## 使用场景

| 场景 | 配置组 | 配置项示例 |
|------|--------|----------|
| 网站基本信息 | 网站配置 | 网站名称、Logo、版权信息、ICP备案号 |
| 邮件配置 | 邮件配置 | SMTP服务器、端口、用户名、密码、发件人 |
| 短信配置 | 短信配置 | API Key、模板ID、签名 |
| 存储配置 | 存储配置 | 存储类型（本地/OSS）、AccessKey、Bucket |
| 支付配置 | 支付配置 | 商户号、密钥、回调地址 |
| 其他 | 自定义分组 | 任何需要后台动态配置的参数 |

## 代码示例

### 后端获取配置值

项目中没有 `ConfigService`，配置值通过 `ConfigItem` 模型直接查询：

```php
<?php
use app\model\ConfigItem;
use app\model\Config;

// 获取单个配置项的值（按配置组 code + 配置项 code 查询）
$value = ConfigItem::whereHas('config', function ($query) {
    $query->where('code', 'website_config')->where('is_delete', 0);
})
->where('code', 'site_name')
->where('status', 1)
->where('is_delete', 0)
->value('value');
// 返回：'RXThinkCMF'

// 获取整个配置组的所有配置项（关联数组）
$config = Config::where('code', 'website_config')->where('is_delete', 0)->find();
if ($config) {
    $items = ConfigItem::where('config_id', $config->id)
        ->where('status', 1)
        ->where('is_delete', 0)
        ->column('value', 'code');
    // 返回：['site_name' => 'RXThinkCMF', 'site_logo' => '...', 'copyright' => '...']
}

// 通过 API 获取网站配置（推荐，含类型处理和 URL 拼接）
// GET /api/config/web/index → 返回按配置组组织的完整数据
```

### 前端获取配置值

```typescript
// 获取网站配置
const { data } = await http.get('/api/config/web/index')

// 使用配置值
const siteName = data.site_name
const siteLogo = data.site_logo
```

### 网站配置保存接口

```bash
# -----------------------------------------------------------------------------
# 批量保存网站配置（按配置组 code 批量更新）
# -----------------------------------------------------------------------------
curl -X POST http://localhost:8000/api/config/web/save \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "website": {
      "site_name": "RXThinkCMF",
      "site_logo": "/uploads/logo.png",
      "copyright": "© 2026 RXThinkCMF"
    }
  }'
```

## 与参数管理的区别

| 维度 | 配置管理（Config） | 参数管理（Param） |
|------|-------------------|-------------------|
| 数据结构 | 分组 + 配置项（一对多） | 独立参数实体 |
| 适用场景 | 关联性强的配置（如网站配置包含多个字段） | 独立的开关、阈值 |
| 管理界面 | 按组展示，表单式编辑 | 列表式管理 |
| 获取方式 | `ConfigItem` 模型查询或 `/api/config/web/index` 接口 | `ParamService::getValue(code)` |
| 缓存策略 | 两级缓存（请求级 + Redis） | 两级缓存（请求级 + Redis） |

## 数据库操作示例

```sql
-- 查询所有未删除的配置组
SELECT * FROM think_config WHERE is_delete = 0 ORDER BY sort;

-- 查询某个配置组下的所有启用配置项
SELECT ci.* FROM think_config_item ci
INNER JOIN think_config c ON ci.config_id = c.id
WHERE c.code = 'website_config' AND ci.status = 1 AND ci.is_delete = 0
ORDER BY ci.sort;

-- 直接更新配置项值
UPDATE think_config_item SET value = '新网站名称'
WHERE code = 'site_name' AND config_id = (
  SELECT id FROM think_config WHERE code = 'website_config' AND is_delete = 0
);
```

## 相关文档

- [5.12 系统参数管理](/zh/core/param.html) — 独立参数实体管理
- [5.10 字典模块](/zh/core/dict.html) — 枚举/字典数据管理
- [5.11 系统配置管理](/zh/core/config.html) — 本文档