nickdekruijk/settings

为您的 Laravel 项目提供基本缓存启用设置模型、迁移和助手

1.2.0 2022-03-10 11:42 UTC

This package is auto-updated.

Last update: 2024-09-10 17:20:28 UTC


README

Latest Stable Version Latest Unstable Version Monthly Downloads Total Downloads License

设置

为您的 Laravel 项目提供基本缓存启用设置模型、迁移和助手。它使用数据库来存储应用程序的设置。在检索设置时,它们将被存储在 Laravel 缓存中,以防止不必要的数据库查询。

安装

要安装此包,请使用

composer require nickdekruijk/settings

配置

如果您不喜欢默认的配置选项,请发布配置文件并更改 Laravel app/config 文件夹中的 settings.php 文件。

php artisan vendor:publish --tag=config --provider="NickDeKruijk\Settings\ServiceProvider"

使用方法

检索设置

如果设置表已创建(运行 php artisan migrate)并且您已添加第一个设置,您可以从应用程序的任何位置使用 setting('key');。设置助手还接受默认值,以防数据库中没有该键,如 setting('key', 'defaultvalue');。您也可以调用 NickDeKruijk\Settings\Setting::get($key)

以数组形式检索设置

当您有一个具有如下值的设置时

facebook = https://#/
twitter = https://twitter.com/
instagram = https://instagram.com/

您可以使用 setting('key', null, '=') 将其作为数组返回,这将返回此数组

[
  "facebook" => "https://#/",
  "twitter" => "https://twitter.com/",
  "instagram" => "https://instagram.com/"
]

添加设置

要更新或创建新的设置,请使用带有数组的设置助手,如 setting(['key' => 'value']); 或调用 NickDeKruijk\Settings\Setting::set([$key => $value]);。要包含描述,可以使用 setting(['key' => ['value' => 1, 'description' => 'string']]);。设置将被添加到数据库或更新(如果已存在)。设置模型还会在更新和创建时触发事件,将新值存储在缓存中。

许可

Settings 是开源软件,根据 MIT 许可证 许可。