5.13 系统参数管理

概述

ParamService 管理系统级参数，如默认密码、系统名称等，采用两级缓存（请求级 + 持久缓存），大幅减少数据库查询。

缓存架构

请求级缓存（static::$cache）    ← 同一请求内不重复查库
        │ 未命中
        ▼
持久缓存（cache()，1小时）      ← 跨请求复用
        │ 未命中
        ▼
数据库查询（param 表）          ← 查询后写入两级缓存

核心方法

// app/service/ParamService.php

// 获取参数值（通用）
$value = ParamService::get('DEFAULT_PASSWORD', '123456');

// 获取字符串参数
$value = ParamService::getString('SITE_NAME', 'RXThinkCMF');

// 获取整数参数
$value = ParamService::getInt('MAX_LOGIN_ATTEMPTS', 5);

// 获取布尔参数
$value = ParamService::getBool('ENABLE_SMS', false);

// 获取默认密码（从系统参数读取，默认 '123456'）
$password = ParamService::getDefaultPassword();

// 清除指定参数缓存
ParamService::clearCache('DEFAULT_PASSWORD');

// 清除所有参数缓存
ParamService::clearAllCache();

方法签名

方法	说明	返回值
get($code, $default)	获取参数值	mixed
getString($code, $default)	获取字符串	string
getInt($code, $default)	获取整数	int
getBool($code, $default)	获取布尔	bool
getDefaultPassword()	获取默认密码明文	string
clearCache($code)	清除指定缓存	void
clearAllCache()	清除所有缓存	void

查询条件

仅查询满足以下条件的参数：

• status = 1（启用）
• is_delete = 0（未删除）

API 接口

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

与配置管理的区别

维度	参数管理（Param）	配置管理（Config）
数据结构	独立的键值对	分组 + 配置项
适用场景	系统级参数（默认密码、限流阈值）	网站配置（名称、Logo、SMTP）
读取方式	ParamService::get('code')	ConfigItemLogic 查询
缓存	两级缓存	无特殊缓存

常用系统参数

编码	说明	默认值
DEFAULT_PASSWORD	默认密码	123456