pozitronik/yii2-users-options

Server-side personal user options

Installs: 3 350

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:yii2-extension

2.0.2 2022-01-12 09:01 UTC

README

Хранение настроек пользователя на сервере (a-la server-side cookies)

Установка

Предпочтительный вариант установки расширения через composer.

Выполните

php composer.phar require pozitronik/yii2-users-options "dev-master"

или добавьте

"pozitronik/yii2-users-options": "dev-master"

В секцию require файла composer.json в вашем проекте.

Описание

Модель UsersOptions умеет хранить набор произвольных key-value параметров, привязанных к любому объекту (подразумевается, что таким объектом выступает пользователь системы, но, при желании, модель может быть использована и для других объектов). Данные хранятся в таблице со структурой user_id|option_name|option_value, и модель всего лишь предоставляет интерфейсы для удобного доступа к хранилищу. Типы данных хранимых значений ограничиваются только используемым методом сериализации. По умолчанию обеспечивается типобезопасное хранение скалярных данных, массивов и объектов без реккурентных ссылок.

Использование

Расширению необходима таблица для хранения данных. Её можно создать, выполнив команду:

yii migrate --migrationPath=@vendor/pozitronik/yii2-users-options/migrations

В этом случае будет создана таблица users_options, и никакой дополнительной настройки более не потребуется.

При необходимости можно переопределить имя используемой таблицы. Для этого нужно подключить в конфигурационном файле вашего приложения модуль UsersOptionsModule с именем usersoptions, и в его конфигурации указать имя используемой таблицы в параметре tableName.

Модель может использовать промежуточное кеширование (при наличии кеша в Yii), это регулируется параметром cacheEnabled Пример конфигурации:

'modules' => [
		'usersoptions' => [
			'class' => UsersOptionsModule::class,
			'params' => [
				'tableName' => 'auth_users_options',//используемое имя таблицы, по умолчанию 'users_options'
				'cacheEnabled' => true//использование кеша Yii, по умолчанию false
		],
		...
]

Публичные параметры класса:

  • null|int $user_id = null -- идентификатор пользователя. Если не установлен, используется идентификатор текущего пользователя.
  • Connection|array|string $db = 'db' -- идентификатор имеющегося соединения с базой данных или конфигурация нового соединения.
  • null|array $serializer = null -- методы, используемые для сериализации хранимых данных. Если параметр не установлен, то используются стандартные функции serialize()/unserialize(). Для их переопределения следует задать параметр с помощью замыканий, например:
$options->serializer = [
	0 => function($value) {//функция для сериализации
		return json_encode($value);
	},
	1 => function(string $value) {//функция для десериализации
		return json_decode($value);
	},
];
  • bool $cacheEnabled = false -- включает использование промежуточного кеша. Если параметр не установлен напрямую, используется значение параметра cacheEnabled конфигурации модуля.
  • string $tableName -- название таблицы, используемое модулем (read-only).

Публичные методы класса:

  • get(string $option) - возвращает значение параметра $option для установленного пользователя.
  • set(string $option, $value):bool - присваивает параметру $option значение $value. Возвращает успех сохранения параметра.

а также статические методы

  • getStatic(int $user_id, string $option)
  • setStatic(int $user_id, string $option, $value):bool

Аналогичные вызовам get/set.

В случае, если модель пользователя расширяет класс ActiveRecord и имеет целочисленный идентификатор $id, то проще всего использовать трейт pozitronik\users_options\traits\UsersOptionsTrait.php. В нём описано свойство $options, возвращающее объект UsersOptions. Просто используйте трейт в модели пользователя, например так:

<?php
declare(strict_types = 1);

namespace app\models;

use pozitronik\users_options\traits\UsersOptionsTrait;

/**
 * @property int $id
 * ...
 */
class AuthUsers extends ActiveRecord {
    use UsersOptionsTrait;

    /*...*/
}

После этого обращаться к параметрам текущего пользователя станет возможно через вызовы

$value = AuthUsers::findOne($id)->options->get($option);
AuthUsers::findOne($id)->options->set($option, $value);

В иных случаях описывайте атрибут $options в модели самостоятельно, либо используйте статические методы UsersOptions::getStatic()/UsersOptions::getStatic()

Для сохранения настроек с помощью AJAX, подключите в нужном view-файле ассет pozitronik\users_options\assets\UsersOptionsAsset.php и используйте js-вызов set_option(key, value). Подразумевается, что он должен обратиться к экшену actionUserSetOption() реализованному в контроллере pozitronik\users_options\controllers\AjaxController, либо контроллеру, содержащему реализацию такого метода (либо наследующегося от контроллера расширения). Приведённую реализацию следует считать примером, т.к. конкретный подход может различаться в каждом отдельном случае.

Лицензия

GNU GPL v3.0