nickdekruijk / settings
为您的 Laravel 项目提供基本缓存启用设置模型、迁移和助手
Requires
- php: >=7.0.0
README
设置
为您的 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 许可证 许可。