Download the PHP package andrey-tech/data-storage-php without Composer
On this page you can find all versions of the php package andrey-tech/data-storage-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download andrey-tech/data-storage-php
More information about andrey-tech/data-storage-php
Files in andrey-tech/data-storage-php
Package data-storage-php
Short Description Простое хранилище данных в виде ключ-значение в JSON-файлах с разделяемой блокировкой на чтение и эксклюзивной блокировкой на запись
License MIT
Homepage https://github.com/andrey-tech/data-storage-php
Informations about the package data-storage-php
Data Storage PHP
Простое хранилище данных в виде ключ-значение в JSON-файлах с разделяемой блокировкой на чтение и эксклюзивной блокировкой на запись.
Содержание
- Требования
- Установка
- Класс
FileStorage
- Примеры
- Автор
- Лицензия
Требования
- PHP >= 7.0.
- Трейт
\App\Utils\JsonUtils
, содержащий методы для работы c данными в формате JSON. - Произвольный автозагрузчик классов, реализующий стандарт PSR-4.
Установка
Установка через composer:
или добавить
в секцию require файла composer.json.
Класс FileStorage
Работа с хранилищами производится с помощью класса \App\DataStorage\FileStorage
.
При возникновении ошибок выбрасывается исключение с объектом класса \App\DataStorage\FileStorageException
.
Класс \App\DataStorage\FileStorage
имеет следующие публичные методы:
__construct(string $storageName = 'storage', string $storageDir = 'storage/')
Конструктор класса-хранилища.$storageName
- имя хранилища. Должно удовлетворять регулярному выражению'/^[\w\.-]+$/i
;$storageDir
- каталог, в котором будут располагаться JSON-файлы хранилища.
set(array $set) :void
Устанавливает в хранилище значения по ключам.$set
- ассоциативный массив ключей и значений:[ 'key1' => 'value1', 'key2' => 'value2',... ]
.
get(array|string $keys)
Возвращает из хранилища значение по ключу или значения по ключам.$keys
- ключ или массив ключей.
delete(array|string $keys) :void
Удаляет из хранилища пару(ы) ключ-значение по ключу(ам).$keys
- ключ или массив ключей.
load() :array
Загружает и возвращает все данные из хранилища в виде массива.update(array $set = [], array $delete = []) :void
Обновляет и/или удаляет значения по ключам в хранилище.$set
- ассоциативный массив ключей и значений:[ 'key1' => 'value1', 'key2' => 'value2',... ]
;$delete
- массив удаляемых ключей.
hasKey(string $key) :bool
Проверяет наличие пары ключ-значение в хранилище.$key
- имя ключа.
getStorageFileName() :string
Возвращает абсолютное имя JSON-файла хранилища.
Примеры
Автор
© 2020 andrey-tech
Лицензия
Данный код распространяется на условиях лицензии MIT.
All versions of data-storage-php with dependencies
ext-json Version *