Download the PHP package pozitronik/yii2-options without Composer
On this page you can find all versions of the php package pozitronik/yii2-options. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pozitronik/yii2-options
More information about pozitronik/yii2-options
Files in pozitronik/yii2-options
Package yii2-options
Short Description Server-side options storage
License GPL-3.0
Informations about the package yii2-options
yii2-options
Хранение системных настроек на сервере.
Установка
Предпочтительный вариант установки расширения через composer.
Выполните
или добавьте
В секцию require файла composer.json
в вашем проекте.
Описание
Модель SysOptions умеет хранить набор произвольных key-value параметров, привязанных к любому объекту (подразумевается, что таким объектом выступает пользователь системы, но, при желании, модель может быть использована и для других объектов).
Данные хранятся в таблице со структурой id|option_name|option_value,
и модель всего лишь предоставляет интерфейсы для удобного доступа к хранилищу.
Типы данных хранимых значений ограничиваются только используемым методом сериализации. По умолчанию обеспечивается типобезопасное хранение скалярных данных, массивов и объектов без реккурентных ссылок.
Использование
Расширению необходима таблица для хранения данных. Её можно создать, выполнив команду:
yii migrate --migrationPath=@vendor/pozitronik/yii2-options/migrations
В этом случае будет создана таблица sys_options
, и никакой дополнительной настройки более не потребуется.
При необходимости можно переопределить имя используемой таблицы. Для этого нужно подключить в конфигурационном файле вашего приложения модуль UsersOptionsModule с именем usersoptions
, и в его конфигурации указать имя используемой таблицы в параметре tableName
.
Модель может использовать промежуточное кеширование (при наличии кеша в Yii), это регулируется параметром cacheEnabled
Пример конфигурации:
Публичные параметры класса:
Connection|array|string $db = 'db'
-- идентификатор имеющегося соединения с базой данных или конфигурация нового соединения.-
null|array $serializer = null
-- методы, используемые для сериализации хранимых данных. Если параметр не установлен, то используются стандартные функцииserialize()
/unserialize()
. Для их переопределения следует задать параметр с помощью замыканий, например: bool $cacheEnabled = false
-- включает использование промежуточного кеша. Если параметр не установлен напрямую, используется значение параметраcacheEnabled
конфигурации модуля.string $tableName
-- название таблицы, используемое модулем (read-only).
Публичные методы класса:
get(string $option):mixed
- возвращает значение параметра$option
.set(string $option, $value):bool
- присваивает параметру$option
значение$value
. Возвращает успех сохранения параметра.drop(string $option):bool
- удаляет параметр$option
. Возвращает успех удаления параметра.
а также статические методы
getStatic(string $option):mixed
setStatic(string $option, $value):bool
dropStatic(string $option):bool
Аналогичные вызовам get()
/set()
/drop()
.
Лицензия
GNU GPL v3.0