infrajs/mark

There is no license information available for the latest version (v1.0.6) of this package.

v1.0.6 2020-08-18 08:03 UTC

This package is auto-updated.

Last update: 2024-10-24 16:10:00 UTC


README

Установка через composer

{
	"require":{
		"infrajs/mark":"~1"
	}
}

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

$mark = new Mark('~auto/.mymarks/');

$mark->add('name',$fndef, $fncheck)

$mark->setVal('ds'); //Попытка восстановить данные по метке. в папке mymarks будет искатсья файл ds.json

$mark->getData(); //Если файл указанной метки не найден, то вернутся данные по умолчанию определённые с помощью $fndef;

$mark->setData($data); //Данные можно установить вручную. Для ключи будут проверены с помощью $fncheck и если проверка не пройдена будет установлено значение от функции $fndef;

$mark->getVal(); //Получить текущую метку. В этот момент метка будет сгенерирована и сохранена в папке автоматически.

Изменение данных

Имя метки может содержать и указания по изменению данных, которые по этой метки будут восстановлены.

Изменения указываются после двоеточия ключ и значения разделяются знаком =. Изменения может быть несколько, отделённые друг от друга двоеточием.

mark = 'xxx:keya=vala:keyb=valb:keyc=valc'

Применятся или нет изменения зависит от установленного для параметров check-функций, таким образом можно дать возможность пользователю устанавливать значения и гарантировать их корректность к моменту, где их нужно использовать.

Разберём указанный пример. Допустим по метке xxx были восстановлены данные

{
	"keya":123,
	"keyd":"opa",
}

После применения указанных в метке изменнеий получатся данные

{
	"keya":"vala",
	"keyb":"valb",
	"keyc":"valc",
	"keyd":"opa",
}

Но параметр keyc никак не зарегистрирован черзе функцию add и будет удалён. А новое значение параметра keya не пройдёт проверку и будет сброшено на значение по умолчанию 0. В итоге получится:

{
	"keya":"0",
	"keyb":"valb",
	"keyd":"opa"
}

В коде это будет записано следующем образом:

	$mark = new Mark('~auto/.test/');

	$mark->add('keya', function(){
		return '0';
	}, function($newval){
		if (!preg_match("/^\d+$")) return false;
		return true;
	});
	$mark->add('keyb', function(){
		return 'bla';
	}, function($newval){
		return true;
	});
	$mark->add('keyd', function(){
		return 'bla';
	}, function($newval){
		return true;
	});
	$mark->setVal('xxx:keya=vala:keyb=valb'); //Метка ~auto/.test/xxx.json уже должна существовать
	$data = $mark->getData(); //Новые данные с изменениям и удовлетворяющие проверкам

	$str = $mark->getVal(); //Будет сгенерировано новая метка для данных и сохранена в папке.