Przejdź do treści

Instalacja

Powłoka
composer require storh/storh

Wymagania

  • PHP 8.2 lub nowsze
  • ext-json
  • lokalny lub zamontowany system plików obsługujący semantykę atomowej zmiany nazwy w obrębie katalogu (wystarczy dowolny standardowy dysk lokalny)

storh nie ma zależności środowiska uruchomieniowego Composer. Dwa rozszerzenia odblokowują opcjonalne funkcje, jeśli są dostępne: ext-pdo lub ext-mysqli w przypadku lustrzanych kopii SQL oraz ext-apcu w przypadku współdzielonego backendu Cache::apcu(), który nie przechowuje niczego w pamięci podręcznej, gdy APCu jest niedostępne.

Wybór katalogu głównego magazynu

Użyj katalogu, w którym proces PHP może tworzyć pliki, odczytywać je, zapisywać, zmieniać ich nazwy i usuwać je:

PHP
use Storh\StorageRoot;

$root = StorageRoot::resolve(__DIR__ . '/var/storage', 'app');

StorageRoot jedynie normalizuje podaną ścieżkę i przekształca przestrzeń nazw w bezpieczną nazwę katalogu. Nie sprawdza aplikacji hosta, nie odczytuje stałych globalnych ani nie wymaga adaptera frameworka. Przy pierwszym użyciu silniki tworzą katalogi kolekcji w katalogu głównym.

Sprawdź, czy działa

PHP
$docs = new Storh\DocStore($root, 'smoke');
$record = $docs->put(['ok' => true]);

var_dump($docs->get($record->id())?->data()); // ['ok' => true]

Przejdź do Szybkiego startu lub wybierz silnik w Wyborze silnika.