README

laravel 的键值存储

简介

Armincms Option 是一个用于存储 key-value 的包。使用此包，您可以通过 key 和 tag 以最简单的方式将值存储到多个存储中。

安装

要开始使用 Armincms Option，首先运行

    composer require armincms/option

然后发布配置

    php artisan vendor:publish --tag=armincms.option

此命令将 config 和 migration 文件发布到适当的路径。

配置

此包支持 file 和 database 存储来存储数据。默认存储是 file。要更改存储类型，您有两种方法

使用 .env 文件： OPTION_DRIVER=database
使用 Config 仓库：Config::set('option.default', 'file')

注意 1： 如果您想使用数据库存储，应在控制台中运行 php artisan migrate。

注意 2： 要通过 Laravel 容器访问 option-manager，可以使用 app('armincms.option')

注意 3： 为了简化编码，您可以使用辅助函数 option() 代替 app('armincms.option')

单个存储

存在两种存储单个数据的方式

首先： option()->put(key, value)
其次： option()->key = value

批量存储

要批量存储数据，请使用以下方法

option()->putMany([
	key1 => value1,
	key2 => value2,
])

分组数据

要对多个选项进行分组，可以在存储数据时传递 tag 参数

app('armincms.option')->put(key, value, tag)

此外，在批量存储时也可以将标签附加到数据上

app('armincms.option')->putMany([
	key1 => value1,
	key2 => value2,
], tag)

检索

有几种方法可以检索您的数据。您可以以 单个 或 多个 的方式检索数据。

单个检索

要检索一个选项，可以使用 option()->key。但如果您需要缺失值的 默认 值，可以使用 option(key, default) 或 option()->get(key, default)。

多个检索

此外，检索多个选项也不困难。您可以使用 many 方法通过其键检索多个值，例如 option()->many(keys)。如果您需要缺失值的默认值，您可以传递一个关联数组，其中包含 keys 和 default values；如下所示

	option()->many([
		key1 => key1-default, 
		key2 => key2-default,
		key3,
		key4,
		key5 => key5-default
	])

您还可以使用 option()->tag(tag) 检索 tagged 值。

从其他存储检索

要将选项存储到 无默认 驱动程序，假设默认驱动程序是 database，请按照以下操作

app('armincms.option')->store('file')->put(key, value, tag)
app('armincms.option')->store('file')->many([key1, key2], tag)

要检索，请使用此

app('armincms.option')->store('file')->get(key, default)
app('armincms.option')->store('file')->tag(tag) 
app('armincms.option')->store('file')->many(keys)

检查是否存在

如果您想检查选项是否存在，可以使用辅助函数 option_exists(key) 或 option()->has(key)。

armincms / option

维护者

详情