概述

系统提供全局便捷助手函数用于快速读取后台配置与组合数据。底层通过 SystemConfigServices 和 GroupDataService 进行缓存与数据解析。

---

读取系统单项配置 (sys_config)

助手函数用法

// 获取配置项值（若不存在返回默认值）
$siteName = sys_config('site_name', '承信租');

// 获取微信配置
$wechatAppId = sys_config('wechat_appid');

// 获取支付配置
$alipayAppId = sys_config('alipay_app_id');

批量读取配置

// 传入数组批量获取
$configs = sys_config(['site_name', 'site_logo', 'site_url']);
// 返回格式: ['site_name' => '...', 'site_logo' => '...', 'site_url' => '...']

---

读取组合数据 (sys_data)

后台许多复杂配置（如首页轮播图、个人中心菜单、导航栏、热门推荐等）使用**组合数据（Group Data）**存储。

助手函数用法

// 获取指定组合数据列表（例如首页轮播图）
$bannerList = sys_data('home_banner');

// 限制获取数量（例如获取前 5 条）
$hotKeywords = sys_data('hot_search_keyword', 5);

返回数据结构

sys_data() 返回包含组合数据字段值的二维数组：

[
    [
        'id'   => 1,
        'name' => '轮播1',
        'pic'  => 'https://.../banner1.jpg',
        'url'  => '/pages/goods/detail?id=10',
        'sort' => 100
    ],
    // ...
]

---

服务层直接调用

如需在 Services 层进行更为灵活的配置操作或清除缓存：

use app\services\system\config\SystemConfigServices;
use app\services\system\group\GroupDataServices;

// 获取配置服务实例
$configServices = app()->make(SystemConfigServices::class);
$value = $configServices->get('site_name');

// 获取组合数据服务实例
$groupDataServices = app()->make(GroupDataServices::class);
$groupList = $groupDataServices->getGroupData('home_banner');