README

将设置以键值对形式存储在数据库中。

数据库中保存的所有设置都进行了缓存，以通过减少SQL查询至零来提高性能。

安装

您可以通过composer安装此包

composer require solomon-ochepa/laravel-settings

Laravel 5.4

如果您正在安装Laravel 5.4或更低版本，您需要手动注册服务提供者，将其添加到config/app.php中的providers数组，并将外观添加到aliases数组中。

'providers' => [
    //...
    Oki\Settings\SettingsServiceProvider::class
]

'aliases' => [
    //...
    "Settings" => Oki\Settings\Facades\Settings::class
]

在Laravel 5.5或更高版本中，服务提供者将自动注册，且Settings外观将立即可用。

使用Settings::all()开始。

迁移

可选地，您可以通过运行以下命令发布迁移文件

php artisan vendor:publish --provider="Oki\Settings\SettingsServiceProvider" --tag="migrations"

现在，运行php artisan migrate以迁移设置表。

入门

您可以使用辅助函数settings()或外观Settings::all()利用Laravel设置包。

方法

all()

-- 将true传递以忽略缓存的设置

settings();
// or
settings()->all($fresh = false);
// or
Settings::all($fresh = false);

get()

获取特定的设置

settings($key, $default = null);
// or
settings()->get($key, $default = null);
// or
Settings::get($key, $default = null);

my()

获取auth()用户的设置。

settings()->my($key, $default = null);
// or
Settings::my($key, $default = null);

set()

设置特定的设置

settings([$key => $value]);
// or
settings()->set($key, $value);
// or
Settings::set($key, $value);

// 设置多个设置

settings([$key => $value, $key2 => $value2]);
// or
settings()->set([
   $key => $value,
   $key2 => $value2,
]);
// or
Settings::set([
   $key => $value,
   $key2 => $value2,
]);

has()

检查设置键是否存在

settings()->has($key);
// or
Settings::has($key);

remove()

删除设置

settings()->remove($key);
// or
Settings::remove($key);

组

您可以将设置组织成组。

如果您是从旧版本升级，请不要忘记运行迁移。

通过链式调用group()方法开始分组

// Save setting
settings([$key => $value])->group($name);

// Get setting
settings($key)->group($name);

可设置的for()

为特定实体获取/设置设置

Settings::for($settable_type, $settable_id = null)->set($key, $value)
// or
Settings::set($key, $value = null, $settable_type = null, $settable_id = null)

// helper function
settings()->for($settable_type = null, $settable_id = null)->set($key, $value = null)
// or
settings()->set($key, $value = null, $settable_type = null, $settable_id = null)

// Example:
settings()->for(User::class, auth()->id())->set('theme_mode', 'dark');

可设置的user()

将设置绑定到认证用户。

settings()->user()->all();

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

测试

该包包含一些集成/冒烟测试，使用Orchestra设置，可以通过phpunit运行这些测试。

$ composer test

贡献

请参阅CONTRIBUTING以获取详细信息。

安全

如果您发现任何安全相关的问题，请通过solomonochepa@gmail.com发送电子邮件，而不是使用问题跟踪器。

鸣谢

• ...

关于 "Oki Technologies Ltd"

Oki Technologies，https://www.okitechnologies.com.ng是一家致力于提供软件开发和相关服务的动态IT公司。凭借对创新的热情和对卓越的承诺，Oki Technologies利用最新的技术和行业最佳实践，为客户量身定制解决方案，以满足其独特的需求。

Oki Technologies提供从网站和移动应用开发到定制软件解决方案的一整套服务，旨在为各行业的商业和组织赋能。凭借一支技艺娴熟的专家团队，Oki Technologies将技术专长与创意洞察力相结合，提供高质量、可扩展且用户友好的软件解决方案。

在Oki Technologies，我们优先考虑客户满意度，并致力于与客户建立长期的合作关系。我们的协作方法确保我们了解客户的目标和目标，从而使我们能够提供能够产生实际结果并为他们的业务增加价值的解决方案。

无论您是想要推出数字产品的初创企业，还是寻求优化现有软件基础设施的成熟企业，Oki Technologies都是您在软件开发需求方面的可信赖伙伴。让我们帮助您将想法变为现实，推动您的企业在数字时代迈向新的高峰。

许可

MIT许可（MIT）。有关更多信息，请参阅许可文件。