设置

📖 组件文档请查看 amis ~
🫣 框架论坛

后台管理系统中的常用功能

在 App\Admin\Controllers\SettingsController 中有部分示例代码可供参考

可以通过 settings() 辅助函数保存或获取设置

内置以下方法:

set - 保存设置

/**
 * @param $key
 * @param $value
 *
 * @return bool
 */
public function set($key, $value = null) { }

// eg
settings()->set('site_name', 'Owl Admin');

setMany - 批量保存设置

/**
 * @param array $data
 *
 * @return bool
 */
public function setMany(array $data) { }

// eg
settings()->setMany([
    'site_name' => 'Owl Admin',
    'site_description' => 'Owl Admin is a laravel admin package',
]);

adminSetMany - 批量保存设置并返回后台响应格式数据

/**
 * @param array $data
 *
 * @return \Illuminate\Http\JsonResponse|\Illuminate\Http\Resources\Json\JsonResource
 */
public function adminSetMany(array $data) { }

// eg
public function store(Request $request)
{
    // 直接返回后台响应格式数据
    return settings()->adminSetMany($request->all());
}

all - 以数组形式返回所有设置

/**
 * @return array
 */
public function all() { }

// eg
settings()->all();

get - 获取设置项

/**
 * @param string $key 设置项key
 * @param mixed|null $default 默认值
 * @param bool $fresh 是否直接从数据库获取
 *
 * @return mixed|null
 */
public function get(string $key, mixed $default = null, bool $fresh = false) { }

// eg
settings()->get('site_name');

arrayGet - 获取设置项中的某个值

/**
 * @param string $key 设置项key
 * @param string $path 通过点号分隔的路径, 同Arr::get()
 * @param $default
 *
 * @return array|\ArrayAccess|mixed|null
 */
public function arrayGet(string $key, string $path, $default = null) { }

// eg
settings()->arrayGet('site_info', 'title.zh.value');

clearCache - 清除指定设置项的缓存

/**
 * @param $key
 *
 * @return void
 */
public function clearCache($key) { }

// eg
settings()->clearCache('site_name');

😏建议在使用前通读并背诵相关文档: laravel 、amis ~

❓常见问题参见 FAQ